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 2022.3.
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
You can only perform a pre-flight check on Server instances using a 64-character Controller Token.
If your Server is on version 2021.3 or earlier, you need to first upgrade to version 2022.1 before proceeding with the next steps.
Check the length of your Controller Token in Alteryx System Settings > Controller > General > Token > View.
If your token is 40 characters long, select Regenerate to create a new token. Then select OK to restart the AlteryxService and create the new token.
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.