Skip to main content

Ferramenta de preparo para migração

A ferramenta de preparo para migração para o Server é um utilitário que permite uma pré-migração de um grande banco de dados de fluxos de trabalho e aplicativos a serem migrados mais rapidamente para o novo padrão AES256.

Esta ferramenta de preparo para migração e um utilitário de linha de comando separado são opcionais. Você só precisa executá-la uma vez antes de atualizar o Server 2022.1 (ou versões anteriores) para o 2022.3.x ou mais recente.

Importante

  • Se você estiver atualizando da versão 2022.1 ou anterior, execute a ferramenta de preparo para migração antes de atualizar para a versão 2022.3+.

  • Se você estiver atualizando da versão 2022.3+, seu banco de dados já migrou a criptografia e você não precisa executar a ferramenta de preparo para migração.

Nota

Por que criamos esta ferramenta?

O Server está atualizando sua criptografia para usar AES256 para dados em repouso. Todos os dados armazenados criptograficamente existentes precisam migrar de seu método de criptografia atual para o novo. Alguns desses dados podem ser migrados antes do upgrade para o 2022.3 enquanto o Server estiver em produção.

Os dados mais demorados que precisam migrar são os aplicativos e o fluxos de trabalho armazenados no Server. Esses dados podem ser migrados antecipadamente para economizar tempo ao realizar a atualização para o Server 2022.3.

A Alteryx criou a ferramenta de preparo para migração para ajudar você a migrar esses dados antes da atualização.

Quando usar a ferramenta de preparo para migração

Recomendamos que você execute a ferramenta de preparo para migração nestes casos:

  • Se a instalação do Server que você estiver atualizando for um sistema de produção ou um sistema de desenvolvimento que não pode ficar inativo por mais de algumas horas, e

  • Se você tiver mais de algumas centenas de fluxos de trabalho, e

  • Você está executando o MongoDB Atlas ou o MongoDB gerenciado pelo usuário.

Mesmo que esses casos não se apliquem a você, a prática recomendada é executar a ferramenta de preparo para migração antes de tentar uma atualização para garantir o sucesso.

Além disso, você também pode considerar o tamanho de db.AS_App_Chunks.dataSize() e AS_PackageDefinitions. Não temos recomendações relacionadas ao tamanho do banco de dados para quando você deve executar a ferramenta de preparo para migração no modo de preparo.

Se tiver apenas alguns fluxos de trabalho ou não se importar se o Server demorar horas/dias para atualizar, pode ignorar a utilização da ferramenta de preparo para migração e executar o instalador padrão do Server e atualizar para 2022.3. O tempo de inatividade será maior do que o normal, pois a migração de criptografia fará parte da atualização.

Nota

Caso você escolha não executar a ferramenta de preparo para migração antes da atualização, ela será instalada e executada automaticamente durante a instalação da atualização 2024.1.

Checklist

Para avaliar problemas antecipados que você possa precisar resolver antes de atualizar para a versão 2022.3 ou posterior, execute o checklist como parte da ferramenta de preparo para migração.

Importante

Você somente poderá executar um checklist nas instâncias do Server com um token do controlador de 64 caracteres.

  • Se a versão do seu Server for 2021.3 ou anterior, você precisará atualizar para a versão 2022.1 antes de prosseguir com as próximas etapas.

  • Verifique o comprimento do token do controlador em Configurações de sistema do Alteryx > Controlador > Geral > Token > Exibir.

    Se seu token tiver 40 caracteres, selecione Regenerar para criar um novo token. Em seguida, selecione OK para reiniciar o AlteryxService e criar o token novo.

Durante o processo de pré-migração ou migração completa, você poderá ver os logs de erros que permitem que você resolva os problemas por conta própria. Isso permite a você tomar as medidas recomendadas para garantir que a migração completa seja concluída com sucesso, apesar de quaisquer erros.

Adicionamos três novas opções de execução ao executar a ferramenta de preparo para migração:

  • Padrão: executar a pré-migração e a verificação da pré-migração simultaneamente (-p)

  • Executar apenas a pré-migração (aplicativos) (--appsonly)

  • Executar apenas a etapa da validação de credenciais (--credonly)

Ao executar a ferramenta de preparo para migração, você deve fornecer o token do controlador (-t) e o nome de host/endereço IP (-i) do controlador. Isso também significa que agora você pode executar a ferramenta de preparo para migração em uma configuração de múltiplos nós fornecendo o nome do host/endereço IP e o token do controlador.

Observe que duas instâncias da ferramenta de preparo para migração não podem ser executadas simultaneamente para o mesmo controlador.