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 suas máquinas original e de destino?

SIM : atualize ou instale a versão e o patch mais recentes do Alteryx Server em suas máquinas original e de destino. Configure a sua máquina original normalmente.

Vá para a etapa 2.1 .

NÃO : vá para a etapa 1.2 .

1.2

Você pode atualizar suas máquinas original e de destino para o patch mais recente da respectiva versão?

SIM : aplique um patch na sua máquina original usando o patch mais recente para a respectiva versão principal e instale a versão e o patch mais recentes correspondentes em sua máquina 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 sua máquina original está listada em Máquinas de destino compatíveis na seção Pré-requisitos ?

SIM : instale ou atualize a máquina de destino para a mesma versão principal e de patch que existe na máquina 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 na máquina de destino.

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

Vá para a etapa 2.1 .

2.1

Encontre o comprimento do token do controlador na máquina 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 da máquina 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 na máquina de destino.

2.6

Copie RuntimeSettings.xml da máquina original.

Copie o arquivo RuntimeSettings.xml de %ProgramData%\Alteryx em sua máquina original para um local de sua escolha em sua máquina de destino.

3.1

Abra o prompt de comando para a pasta "bin" na máquina 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 na máquina de destino.

Renomeie a máquina 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 da sua máquina original na etapa 2.6 em %ProgramData%\Alteryx na sua máquina de destino.

3.5

Limpe o Token do controlador .

Edite %ProgramData%\Alteryx\RuntimeSettings.xml na sua máquina 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 sua máquina 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 sua máquina 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 na sua máquina 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 sua máquina 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 sua máquina 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 da sua máquina original para a máquina 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 a máquina de destino não está licenciada.