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.