Preparação para recuperação de desastres

1.1

Você pode atualizar ou instalar a versão e patch mais recentes do Alteryx Server em seus hosts original e de destino?

SIM: atualize ou instale a versão e o patch mais recentes do Alteryx Server em seus hosts original e de destino. Configure o seu host original normalmente.

Vá para a etapa 2.1.

NÃO: vá para a etapa 1.2.

1.2

Você pode atualizar seus hosts original e de destino para o patch mais recente da respectiva versão?

SIM: aplique um patch no seu host original usando o patch mais recente para a respectiva versão principal e instale a versão e o patch mais recentes correspondentes em seu host de destino. Por exemplo, se você estiver no patch 3 da versão 2022.3, instale o patch mais recente disponível para a versão 2022.3. 

Vá para a etapa 2.1.

NÃO: vá para a etapa 1.3.

1.3

A versão do Alteryx Server em seu host original está listada em Hosts de destino compatíveis na seção Pré-requisitos?

SIM: instale ou atualize o host de destino para a mesma versão principal e de patch que existe no host original. Use o arquivo de instalação completo em oposição à instalação do patch.

Se necessário, entre em contato com fulfillment@alteryx.com para solicitar o arquivo de instalação necessário.

Vá para a etapa 2.1.

NÃO: vá para a etapa 1.4

1.4

Instale a versão de patch mais recente do Alteryx Server no host de destino.

Instale ou atualize o host de destino para o patch mais recente disponível para a versão principal do host original (por exemplo, se o host original estiver no patch 3 da versão 2022.3, instale o patch mais recente da versão 2022.3 no host de destino).

Vá para a etapa 2.1.

2.1

Encontre o comprimento do token do controlador no host original.

Em Configurações de sistema do Alteryx > Controller > General, clique em View. Registre o comprimento do token do controlador.

2.2

O seu token do controlador tem 40 caracteres?

SIM: vá para Configurações de sistema do Alteryx > Controller > General > e clique em Regenerate.

NÃO: vá para a etapa 2.5.

2.3

Reinicie o AlteryxService.

Navegue pelo restante das Configurações de sistema do Alteryx e clique em Finish. Isso reiniciará o AlteryxService.

2.4

Reconecte os nós adicionais (se aplicável).

Se você tiver uma configuração de múltiplos nós, use o token do controlador recém-regenerado para reconectar todos os nós ao nó do controlador.

2.5

Salve e copie o Token do controlador do host original.

Para o token do controlador, vá para Configurações de sistema do Alteryx > Controller > General > Token > View.

Copie e salve o token do controlador em um documento de texto. Em seguida, copie o documento de texto para um local de sua escolha no host de destino.

2.6

Copie RuntimeSettings.xml do host original.

Copie o arquivo RuntimeSettings.xml de %ProgramData%\Alteryx em seu host original para um local de sua escolha em seu host de destino.

3.1

Abra o prompt de comando para a pasta "bin" no host de destino.

Abra um prompt de comando como administrador e navegue até a pasta de instalação Alteryx\bin. Todos os comandos nesta seção devem ser executados a partir dessa pasta.

3.2

Pare o AlteryxService.

Insira o comando:

net stop alteryxservice

Se o serviço AlteryxService estava em execução, em caso de sucesso você verá "The AlteryxService service was stopped successfully".

Se o serviço AlteryxService estava parado, você verá "The AlteryxService service is not started".

Deixe essa janela aberta.

3.3

Faça backup do RuntimeSettings.xml existente no host de destino.

Renomeie o host de destino de %ProgramData%\Alteryx\RuntimeSettings.xml para RuntimeSettings_BACKUP.xml como um backup.  

Se o "RuntimeSettings.xml" não existir, vá para a etapa 3.4.

3.4

Restaure o RuntimeSettings.xml.

Copie/cole o arquivo RuntimeSettings.xml copiado do seu host original na etapa 2.6 em %ProgramData%\Alteryx no seu host de destino.

3.5

Limpe o Token do controlador.

Edite %ProgramData%\Alteryx\RuntimeSettings.xml no seu host de destino.

Exclua tudo entre as tags <ServerSecretEncrypted>, deixando apenas as tags como mostrado abaixo:

3.6

Salve o RuntimeSettings.xml.

Salve o RuntimeSettings.xml em seu host de destino.

3.7

Restaure o Token do controlador.

De volta ao prompt de comando aberto na etapa 3.1, digite o seguinte comando usando o token do controlador de seu host original obtido na etapa 2.5:

AlteryxService.exe setserversecret=TOKEN_DO_CONTROLADOR_DO_SERVER_ORIGINAL

Solução de problemas: a versão 2021.3 e versões posteriores podem indicar erro nesta etapa com a mensagem: "Set server secret failed: Error in CryptImportKey(3): Bad Data. (-2146893819)". Para corrigir isso, consulte as etapas 3.5 – 3.6 para garantir que você removeu o valor entre as tags.

3.8

Limpe as Chaves de armazenamento.

Edite %ProgramData%\Alteryx\RuntimeSettings.xml localizado no seu host de destino novamente.

Exclua tudo entre as tags <StorageKeysEncrypted>, deixando apenas as tags como mostrado abaixo:

3.9

Restaure as Chaves de armazenamento.

Copie o valor <StorageKeysEncrypted> do RuntimeSettings.xml da etapa 2.6 e cole-o entre as tags <StorageKeysEncrypted> no RuntimeSettings.xml em seu host de destino. O comprimento desse valor varia de acordo com a versão. Veja exemplos abaixo:

3.10

Salve o RuntimeSettings.xml.

Salve o RuntimeSettings.xml em seu host de destino.

3.11

Restaure o Usuário run-as.

Se você tinha um usuário run-as no Server original, insira o seguinte comando; caso contrário, ignore esta etapa:

AlteryxService.exe setexecuteuser=NOME,DOMÍNIO,SENHA

3.12

Restaure a Senha SMTP.

Se você havia preenchido Configurações de sistema do Alteryx > Server UI > SMTP > Password (mesmo que a caixa de seleção para SMTP esteja desmarcada), insira o seguinte comando; caso contrário, ignore esta etapa:

AlteryxService.exe setsmtppassword=SENHA

3.13

Restaure as Chaves de criptografia.

As etapas em Processo de transferência de chaves de criptografia permitirão que você transfira a chave de criptografia do seu host original para o host de destino. Observe que a última etapa do Processo de transferência de chaves de criptografia exige que você reinicie o serviço, o que não é possível em alguns casos em que o host de destino não está licenciado.