Guia de recuperação do host do Server

1.1

Definir o fuso horário do host

O fuso horário do Windows do host de destino deve ser definido para corresponder ao host original.

1.2

Garantir o acesso ao Alteryx

Certifique-se de que o host possa acessar whitelist.alteryx.com utilizado pelo sistema de licenciamento da Alteryx.

3.1

Abrir o prompt de comando 1 na pasta bin

Abra um prompt de comando como administrador, navegue até a pasta Alteryx\bin e insira os comandos abaixo (ajuste com base no local de instalação).

c:

cd \Program Files\Alteryx\bin

3.2

Parar o Serviço

Insira o comando

net stop alteryxservice

Em caso de sucesso, você verá "The Alteryx Service service was stopped successfully".

3.3

Fazer backup do RuntimeSettings.xml existente

Insira o comando

c:

cd \ProgramData\Alteryx ren RuntimeSettings.xml RuntimeSettings_BACKUP.xml

3.4

Você tem um RuntimeSettings.xml preparado previamente em seu host de destino a partir de uma Preparação para recuperação de desastres?

SIM: o seu RuntimeSettings.xml do Processo de recuperação de desastres já deve estar localizado no diretório %ProgramData%\Alteryx\ do seu host de destino. Caso contrário, copie o RuntimeSettings.xml preparado para %ProgramData%\Alteryx\.

Vá para a etapa 3.13.

NÃO: copie o arquivo RuntimeSettings.xml do host original para o diretório %ProgramData%\Alteryx\ do host de destino atual.

Continue para a etapa 3.5.

3.5

Limpar o Token do controlador

Edite o RuntimeSettings.xml que você acabou de copiar e exclua tudo entre as tags <ServerSecretEncrypted>, deixando apenas as tags conforme mostrado abaixo:

Salve e feche o arquivo.

3.6

Restaurar o Token do controlador

Insira o comando usando o token do controlador do Server original

AlteryxService.exe setserversecret=TOKEN_DO_CONTROLADOR_DO_SERVER_ORIGINAL

Solução de problemas:

A versão 2021.3 e mais recentes podem indicar erro nesta etapa com a mensagem: "Set server secret failed: Error in CryptImportKey(3): Bad Data. (-2146893819)". Para corrigir isso, consulte a etapa anterior para garantir que o valor entre as tags foi removido.

3.7

Restaurar as Chaves de armazenamento criptografadas

O valor <StorageKeysEncrypted> pode ter sido alterado quando o token do controlador foi redefinido na etapa 3.6. Em caso afirmativo, ele deve ser substituído pelo valor correspondente do arquivo RuntimeSettings.xml original. Esse é o arquivo de origem RuntimeSettings.xml que foi copiado na etapa 3.4. É mais fácil copiar as tags também para garantir que todo o valor entre elas seja copiado do arquivo RuntimeSettings.xml original. Você pode deixar o RuntimeSettings.xml aberto em um editor de texto à medida que faz outras alterações na etapa 4.

3.8

Restaurar o Usuário run-as

Se você tinha um Usuário executar como no host original, insira o seguinte comando; caso contrário, ignore esta etapa.AlteryxService.exe setexecuteuser=NOME,DOMÍNIO,SENHA

3.9

Restaurar 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.10

Salvar RuntimeSettings.xml

Salve o arquivo RuntimeSettings.xml.

3.11

A versão do Alteryx Server no seu host original é alguma das seguintes?

SIM: vá para a etapa 3.13.

NÃO: vá para a etapa 3.12.

3.12

Transferir a Chave de criptografia

Esta funcionalidade só está disponível nas seguintes versões:

Importante: observe que isso requer que o AlteryxService esteja sendo executado no seu host original e que o seu host de destino consiga acessá-lo pela rede.

As etapas em Processo de transferência de chaves de criptografia permitirão que você transfira a chave de criptografia do seu controlador existente para o novo.

3.13

Permanecer na linha de comando

A etapa 4 assume que você está em uma linha de comando como administrador na pasta \Alteryx\bin.

4.1

Obter o backup do MongoDB

Copie o backup do Mongo do host original para uma pasta MONGO_BACKUP no seu novo host.

4.2

Restaurar para uma nova pasta

Restaure o banco de dados do Mongo da pasta de backup para uma nova pasta de restauração. Revise o mongoRestore.log conforme descrito abaixo para garantir que a restauração foi bem-sucedida.

Consulte a seção Restaurar a partir de um backup do MongoDB no documento Backups do MongoDB para encontrar o comando de restauração apropriado para a sua versão do Server.

4.3

Confirmar se a restauração foi bem-sucedida

Confirme se a restauração foi bem-sucedida.

Cuidado

Esse é um passo necessário, pois uma falha da restauração não será relatada no passo anterior e pode levar a dados faltantes no Server. Para fazer isso, revise o arquivo mongoRestore.log na pasta do MongoDB onde os dados foram restaurados. Abra o mongoRestore.log e siga estas etapas:

Se a recuperação falhou, ou se você encontrar algum resultado ao pesquisar as palavras-chave listadas acima, entre em contato com o Suporte ao Cliente com todas as informações que você juntou.

Não prossiga caso a restauração do MongoDB tenha falhado.

4.4

Definir o caminho Mongo em RuntimeSettings.xml

Edite o RuntimeSettings.xml e digite o caminho para a PASTA_RESTAURAÇÃO_MONGO na tag <EmbeddedMongoDBRootPath>.

Exemplo:

Salve e feche o editor de texto.

4.5

Iniciar o MongoDB

Insira o comando

mongod ––dbpath "PASTA_RESTAURAÇÃO_MONGO" ––auth ––port 27018

Exemplo

mongod ––dbpath "%ProgramData%\Alteryx\Service\Persistence\Mongo_Restore" ––auth ––port 27018

Não feche a janela do prompt de comando.

Se fechar a janela a partir da etapa 4.5, nenhuma das etapas seguintes funcionará.

<< Iniciar a segunda seção do prompt de comando >>

4.6

Abrir o segundo prompt de comando na pasta bin

Abra um SEGUNDO prompt de comando como administrador, navegue até a pasta Alteryx\bin e insira os comandos abaixo (ajuste com base no local de instalação).

c:

cd \Program Files\Alteryx\bin

4.7

Obter senha de não administrador do Mongo

Insira o comando e copie sua SENHA_NÃO_ADMINISTRADOR_MONGO no bloco de notas

AlteryxService.exe getemongopassword

4.8

Iniciar a linha de comando do Mongo

Insira o comando

mongosh mongodb://SERVER:PORT/AlteryxGallery -u user -p SENHA_NÃO_ADMINISTRADOR_MONGO

Exemplo

mongosh mongodb://localhost:27018/AlteryxGallery -u user -p CCEC***33C0

Em caso de sucesso, você deve ver um prompt ">".

4.9

Excluir bloqueios do AlteryxGallery definidos pelo Server original

Insira o comando do Mongo

db.locks.remove({})

Em caso de sucesso, você verá: "writeResult({ “nRemoved” : N })", onde N é um número entre 0 e 3.

4.10

Mude para o banco de dados do AlteryxService

Insira o comando do Mongo

use AlteryxService

4.11

Exclua os bloqueios do AlteryxService definidos pelo Server original

Insira o comando do Mongo

db.locks.remove({})

Em caso de sucesso, você verá: "writeResult({ “nRemoved” : N })", onde N é um número entre 0 e 3.

4.12

Sair da linha de comando do Mongo e do prompt de comando 2

Insira o comando

exit

Feche Command_Prompt_2

<< Encerrar a segunda seção do prompt de comando >>

4.13

Parar banco de dados do Mongo

No prompt de comando original, digite o comando do teclado

ctrl-c

uma ou mais vezes até sair do MongoDB e retornar a um prompt de comando normal.

Feche o prompt de comando.

5.1

Você tinha um Usuário de logon de serviço no Server original?

Defina um Usuário de logon de serviço no novo Server.

No aplicativo Serviços do Windows, clique com o botão direito do mouse em AlteryxService > Propriedades > Logon

5.2

Adicione drivers de dados e DSNs do sistema.

Adicione drivers com a mesma versão e DSNs do sistema com o mesmo nome para corresponder ao Server Original; https://downloads.alteryx.com/.

Problemas avançados que podem não se aplicar à sua recuperação:

5.3

Em ambientes mais seguros, configure as permissões de usuário run-as necessárias.

Certifique-se de que todas as credenciais utilizadas para executar fluxos de trabalho (run-as, logon de serviço ou credencial definida ao salvar o fluxo de trabalho) tenham acesso suficiente e adequado; configure as permissões de usuário de execução necessárias.Configurar as permissões necessárias para usuários run-as

5.4

Restaurar aliases de conexão in-DB e com base no sistema

Conexões de dados do sistema:

%ProgramData%\Alteryx\Engine\SystemAlias.xml

Conexões de dados in-DB do sistema:

%ProgramData%\Alteryx\Engine\SystemConnections.xml

5.5

Restaurar aliases de conexão In-DB e com base no usuário

Conexões de dados do usuário:

C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserConnections.xml

Conexões de dados in-DB do usuário:

C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserAlias.xml

5.6

Os fluxos de trabalho usam conectores?

Copie as pastas de conectores do Server original para

%ProgramData%\Alteryx\Tools

Entre em contato com o Suporte ao Cliente para habilitar conectores no seu novo Server.

5.7

Os fluxos de trabalho usam a ferramenta Python?

Reinstale quaisquer pacotes Python que os fluxos de trabalho tinham instalado. Consulte Ambiente da ferramenta Python em atualizações do Server.

5.8

Você usa SSL?

Se você estiver realizando a recuperação para um Server de sandbox para fins de teste, use HTTP para teste.

Se você estiver migrando para um novo Server, restabeleça seu SSL:

Configurar SSL/TLS no Server

Configurar o Alteryx Server para SSL: obtenção e instalação de certificados

6.1

Reveja as configurações de sistema do Alteryx e suspenda os agendamentos, se desejar.

Execute as Configurações de sistema do Alteryx e passe por cada página para confirmar que as definições (como o token do controlador) contêm os valores que você espera.

Se você não quiser que os agendamentos sejam executados quando o serviço for iniciado, desmarque:

Worker > General > Allow machine to run scheduled Alteryx workflows

Quando você selecionar Finish, o Alteryx Service deve ser iniciado e o Server deve ficar disponível em um navegador.

7.1

Testes básicos

O AlteryxService está em execução?

Você pode:

7.2

Testes específicos de fluxos de trabalho

É possível executar fluxos de trabalho que contenham extensões ou conexões externas? Exemplos: