Skip to main content

Guia de recuperação do host do Server

Este guia destina-se a ajudar um administrador do servidor a recuperar uma instância do servidor em caso de falha de um host ou hosts originais, ao mudar para um novo servidor atualizado, passando de um servidor local para um servidor na nuvem e em outros casos em que sua infraestrutura é alterada.

Uma recuperação de servidor permite que você obtenha um novo servidor em execução com seus usuários originais, fluxos de trabalho, agendas, etc., com base em ter o seguinte do seu servidor original:

  • Token do controlador

  • RuntimeSettings.xml do nó do controlador

  • Backups do MongoDB

Abaixo estão os detalhes para cada etapa do processo:

1 - Preparar

2 - Recuperar RuntimeSettings.xml

3 - Recuperar MongoDB

4 - Restaurar outros arquivos e configurações

5 - Inicie o Alteryx Server

6 - Teste

Dentro do escopo

  • Recuperação de falha em uma instalação única e padrão do Server usando o MongoDB incorporado .

  • Backup disponível com as informações necessárias intactas.

  • A máquina ou máquinas de destino podem ser substituídas.

Fora do escopo

  • Ambiente do Server com múltiplos nós ou MongoDB gerenciado pelo usuário. Entre em contato com o Suporte ao Cliente para obter ajuda.

  • Combinação de bancos de dados de arquivos de conexão.

  • Backup ou restauração de drivers ODBC.

  • Backup ou restauração de DSNs de usuário ou sistema.

  • Backup ou restauração de outros aliases armazenados no Windows existentes fora do Alteryx.

Pré-requisitos

  • Instale todos os drivers de bancos de dados e softwares necessários para a operação dos fluxos de trabalho antes de concluir as etapas descritas neste guia para garantir o menor tempo de inatividade possível.

  • Direitos de administrador no servidor de destino.

  • Acesso a todas as credenciais usadas para representação, incluindo a conta de serviço (se não for o sistema local), o usuário run-as e quaisquer credenciais de fluxo de trabalho definidas/utilizadas.

  • Token do controlador do Server original.

  • O arquivo RuntimeSettings.xml do Server original pode ser encontrado em:  %PROGRAMDATA%\Alteryx\RuntimeSettings.xml .

  • Backup do MongoDB do Server original. Aprenda como fazer um backup.

    • Para obter mais informações sobre backup e recuperação do Server, acesse o artigo "Práticas recomendadas para recuperação e backup do Server": Parte 1 e Parte 2 .

  • Verifique se o servidor de destino está definido para o mesmo fuso horário que o servidor original nas configurações de fuso horário do Windows. Se não estiver definido para o mesmo fuso horário, poderão ocorrer erros nas exibições de agendamento.

Opcional

Os itens a seguir podem não ter sido utilizados no Server original. Verifique se a funcionalidade foi usada e conclua as etapas correspondentes marcadas como (Opcional) neste guia.

  • Utilizador de registo de serviço, se utilizado.

  • Detalhes de usuário run-as para configuração do trabalhador:

    • Domínio

    • Nome de usuário

    • Senha

  • Nome de usuário e senha do servidor SMTP para a configuração do Server.

  • Conetores de %ProgramData%/Alteryx ools\T .

  • Aliases do Alteryx baseados no sistema e em conexões in-DB do Server original.

    • Para conexões de dados in-DB do sistema, consulte %PROGRAMDATA%\Alteryx\Engine\SystemConnections.xml

    • Para conexões de dados do sistema, consulte %PROGRAMDATA%\Alteryx\Engine\SystemAlias.xml

  • Aliases do Alteryx baseados no usuário e em conexões in-DB do Server original – as opções abaixo podem ser relevantes para cada conta de usuário de credenciais de fluxo de trabalho ou run-as

    • Conexões de dados do usuário Consulte C:\Uservidores[nome de usuário]/AppData oaming\R/Alternyx\UEngine serConnections.xml

    • Conexões de dados no banco de dados do usuário Consulte C:\Uservidores[username]/AppData oaming\R/Alteryx\UserAlias.xml

Etapa 1: Preparar

#

Etapa

Detalhes

1.1

Defina o fuso horário da máquina

O fuso horário do Windows da nova máquina deve ser definido para corresponder à máquina original.

1.2

Assegure o acesso ao Alteryx

Certifique-se de que o computador possa acessar o domínio da Web  whitelist.alteryx.com utilizado pelo sistema de licenciamento da Alteryx.

1.3

Instale a mesma versão do Servidor

Execute uma instalação limpa da mesma versão Server que gerou o backup do Mongo.

Use a versão de manutenção mais recente para o trimestre, por exemplo, se o backup for da versão 2022.4. 2 e a versão de manutenção 2022.4. 5 estiver disponível, use esta versão. Se a sua versão ainda não estiver disponível em http://downloads.alteryx.com , entre em contato com fulfillment@alteryx.com .

Instalar ou atualizar o Server

Teste A interface do usuário do servidor aparece em um navegador, você não precisa fazer login.

1.4

Solução de problemas

Erro de chave de licença "em uso"

Se a sua chave de licença ainda estiver ligada ao seu servidor antigo, terá de a desativar nessa máquina. Se essa máquina estiver inacessível, contacte o Administrador de Licença para liberar a licença.

Passo 2: Recuperar RuntimeSettings.xml

#

Etapa

Detalhes

2.1

Abra o prompt de comando 1 na pasta bin

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

C: cd Arquivos de programas/Alteryx

2.2

Pare o Serviço

Introduza o comando

Comando: net stop alteryxservice

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

2.3

Backup existente RuntimeSettings.xml

Introduza o comando

C: cd ProgramData/Alteryx em RuntimeSettings.xml RuntimeSettings_BACKUP.xml

2.4

Restaurar RuntimeSettings.xml

Copie o arquivo RuntimeSettings.xml do servidor original para o diretório %ProgramData%/Alteryx atual .

2.5

Token de controlador ausente

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

64ae505fe2c2c.png

Salve e feche o arquivo.

2.6

Token de controlador ausente

Digite o comando usando o seu servidor original Controller Token

AlteryxService.exe setserversecret_CONTROLLER_token_from_original_SERVER

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.

2.7

Restaurar chaves de encriptação

O valor <StorageKeysEncrypted> pode ter sido alterado quando o token do controlador foi redefinido na etapa 2.6. Em caso afirmativo, ele deve ser substituído pelo valor do arquivo RuntimeSettings.xml original. É 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 3 .

Step 2.7 Restore Encryption Keys

2.8

Usuário run-as (executar como)

Se você tivesse um usuário run-as no servidor original, digite o seguinte comando, caso contrário, pule esta etapa. AlteryxService.exe setexecuteuser nome, DOMÍNIO, SENHA

2.9

Restaurar palavra-passe SMTP

Se tiver preenchido as Definições do Sistema Alteryx > UI do Servidor > SMTP > Palavra-passe (mesmo que a caixa de verificação SMTP esteja desmarcada), introduza o seguinte comando; caso contrário, ignore esta etapa. AlteryxService.exe setsmtppassword

2.10

Economize RuntimeSettings.xml

Salve o arquivo RuntimeSettings.xml.

2.11

Chave de criptografia

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

  • 2021.4.2 patch 11 e mais recentes

  • 2022.1 patch 9 e mais recentes

  • 2022.3 patch 6 e mais recentes

  • 2023.1 patch 2 e mais recentes

  • 2023.2 de disponibilidade geral e mais recentes

Importante

Observe que isso requer que o AlteryxService esteja sendo executado no nó do controlador do Server original e que seu novo Server consiga acessá-lo pela rede.

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

2.12

Permaneça na Linha de Comando

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

Etapa 3: Recuperar MongoDB

#

Etapa

3.1

Obtenha o backup do MongoDB

Copie o backup do Mongo do servidor original para uma PASTA MONGO_ backup no seu novo servidor.

3.2

Restaurar para uma nova pasta

Restaure o banco de dados do Mongo da pasta de backup para uma nova pasta de restauração. O parâmetro final, ,10 , garante menor uso de memória pelo MongoDB durante a restauração. Isso reduz a chance de erros de memória insuficiente, mas pode aumentar o tempo da restauração. Não colocar o ,10 pode levar a restaurações mais rápidas. Em ambos os casos, revise o mongoRestore.log conforme descrito abaixo para garantir que a restauração foi bem-sucedida.

AlteryxService.exe emongorestore="PASTA_BACKUP_MONGO","PASTA_RESTAURAÇÃO_MONGO",10

Exemplo:

AlteryxService.exe emongorestore="D:\db_bkp","%ProgramData%\Alteryx\Service\Persistence\Mongo_Restore",10

3.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:

  • Confirme se ele relata a mensagem #### document(s) restored successfully, 0 document(s) failed to restore (#### documentos restaurados com êxito, 0 documentos com falha ao restaurar) na última linha.

  • Procure pelas palavras error , critical , fatal e failed . Se estiver procurando por failed , verifique se o resultado difere da frase no ponto anterior, que contém 0 document(s) failed  (0 documentos com falha).

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

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

3.4

Defina o caminho Mongo em RuntimeSettings.xml

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

Exemplo:

Set Mongo path in RuntimeSettings.XML

Salve e feche o editor de texto.

3.5

Inicie o MongoDB

Introduza o comando

Mongod ––dbpath "MONGO_RESTORE_FOLDER" ––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 3.5, nenhuma das etapas seguintes funcionará.

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

3.6

Abra o segundo prompt de comando na pasta bin

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

C: cd Arquivos de programas/Alteryx

3.7

Obtenha a palavra-passe do Mongo não administrador

Digite o comando e copie sua SENHA Non_ADMIN_MONGO_PASSWORD para o Bloco de Notas

AlteryxService.exe getemongopassword

3.8

Inicie a Linha de Comando Mongo

Introduza o comando

mongo mongodb://server:PORT/AlteryxGallery -u user -p Non_ADMIN_MONGO_PASSWORD

Exemplo

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

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

3.9

Eliminar bloqueios definidos pelo servidor original

Digite o comando Mongo

db.locks.remove({})

Em caso de sucesso, você deve ver: " WriteResult ("nRemoved" : N ) ", onde N é um número entre 0 e 3.

3.10

Saia da Linha de Comando Mongo e do Prompt de Comando 2

Introduza o comando

Sair

Feche Command_Prompt_2

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

3.11

Pare o 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 os dois prompts de comando.

Passo 4: Restaurar outros arquivos e configurações

#

Etapa

Detalhes

4.1

Você tem um usuário de logon de serviço no servidor original?

Defina o Service Log On User no novo servidor.

Aplicação Windows Services > Clique com o botão direito do rato AlteryxService > Propriedades > Iniciar sessão

4.2

Adicione drivers de dados e DSNs do sistema.

Adicione drivers da mesma versão e DSNs do sistema de mesmo nome para corresponder ao Servidor Original, https://downloads.alteryx.com/ .

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

4.3

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

Certifique-se de que todas as credenciais utilizadas para executar fluxos de trabalho (Executar como, Iniciar sessão de serviço ou conjunto de credenciais ao guardar o fluxo de trabalho) têm acesso suficiente adequado, configure as permissões de utilizador de execução necessárias .

4.4

Restaure aliases de conexão baseados no sistema e no banco de dados

Não há conexões de dados.

%ProgramData%\Alteryx\Engine\SystemAlias.xml

Conexões de dados in-DB do sistema:

%ProgramData%\Alteryx\Engine\SystemConnections.xml

4.5

Restaurar aliases de Ligação In-DB e Baseados no Utilizador

Não há conexões de dados.

C:\Uservidores[username] e AppData oaming\R/Alteryx\UEngine serConnections.xml

Conexões de dados na base de dados do usuário:

C:\Uservidores[username] e AppData oaming\R/Alteryx\UEngine serAlias.xml

4.6

Os fluxos de trabalho usam conetores?

Copie as pastas do conetor do servidor original para

\ProgramData\Alteryx\Tools

Contacte o Suporte ao Cliente para ativar os conetores no seu novo Servidor.

4.7

Os fluxos de trabalho usam o ferramenta Python?

Reinstale quaisquer pacotes Python que os fluxos de trabalho tinham instalado. Consulte Server Upgrade Python Tool Environment Checklist.

4.8

Os fluxos de trabalho usam o ferramenta R?

Em breve...

4.9

Você tem um ambiente multi-node ou mongo gerenciado pelo usuário?

(Brevemente) Contacte o seu Executivo de Conta ou Apoio ao Cliente.

4.10

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 servidor, restabeleça seu SSL:

Configurar SSL/TLS no Server

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

Passo 5: Inicie o Alteryx Server

#

Etapa

Detalhes

5.1

Reveja as definições do sistema Alteryx, suspenda as programações, se desejar.

Execute as Configurações do Sistema do Alteryx e passe por cada página confirmando as configurações (como o Token do Controlador) contêm os valores que você espera.

Se você não quiser que as programações sejam executadas quando o serviço for iniciado, desmarque:

Trabalhador > Geral > Permitir que a máquina execute fluxos de trabalho Alteryx programados

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

Importante

Preste atenção extra às configurações de Configuração da IU do servidor , pois um novo servidor pode ter um URL diferente ou pode não ter um certificado SSL.

System Settings, the Server UI configuration section.

Passo 6: Teste

#

Etapa

Detalhes

6.1

Testes básicos

O AlteryxService está em execução?

Você pode:

  • Acessar o URL da interface do usuário do servidor?

  • Mover-se em torno de páginas de administração e visualizar usuários, coleções, etc.?

  • Publicar um fluxo de trabalho do Designer para o servidor?

  • Execute o fluxo de trabalho:

  • Se a configuração permitir, salve e execute um fluxo de trabalho especificando suas credenciais.

6.2

Testes específicos do fluxo de trabalho

É possível executar fluxos de trabalho que contenham extensões ou conexões externas, como

  • Entrada/saída para um caminho UNC de rede

  • Conexões de bases de dados

  • Ferramenta conectora

  • Location & Business Insights - Visão Geral

  • Ferramenta Python

  • Ferramenta R