Executar a ferramenta de preparo para migração
Antes de começar
A ferramenta de preparo para migração cria uma cópia em etapas dos dados de fluxo de trabalho armazenados em seu banco de dados. Durante esse processo, a ferramenta de preparo para migração fornecerá uma estimativa do espaço necessário para prosseguir. Não prossiga a menos que haja espaço suficiente disponível.
Atenção
Você deve verificar manualmente se há espaço suficiente disponível para concluir este processo. A ferramenta de preparo para migração não podeverificar o espaço disponível.
Etapa 1: instale a ferramenta de preparo para migração
Siga estas etapas para instalar a ferramenta Runner:
# | Etapa |
---|---|
1.1 | Baixe o instalador em https://downloads.alteryx.com e execute-o. |
1.2 | Aceite o EULA. |
1.3 | Escolha o caminho de instalação ou aceite o caminho padrão. |
1.4 | Siga as instruções para concluir a instalação. |
Etapa 2: inicie a ferramenta de preparo para migração
Siga estes passos para iniciar o ferramenta de preparo para migração.
# | Etapa |
---|---|
2.1 | Abra um prompt de comando ou PowerShell. |
2.2 | Navegue até o caminho de instalação escolhido (padrão:
|
2.3 | Execute um desses 3 comandos para executar a ferramenta de preparo para migração.
Observação:
Se você usar o PowerShell, adicione
Você pode executar esta operação em qualquer host que tenha acesso ao servidor MongoDB. Você pode executá-la com segurança várias vezes sem tempo de inatividade. #Exemplo para uso com o MongoDB integrado ou um único servidor MongoDB gerenciado pelo usuário:
Isso pode parecer com o exemplo a seguir. Por favor, note que '
#Exemplo para uso com conjuntos de réplicas do MongoDB:
#Exemplo para uso com o MongoDB Atlas:
|
2.4 | Quando a migração for iniciada, você receberá uma solicitação para confirmar que fez um backup do banco de dados e do arquivo de configurações de tempo de execução: |
2.5 | Depois que você confirmar os backups, o utilitário verifica o uso atual do espaço. Ele fornecerá uma estimativa do espaço adicional necessário para a migração. Você deve verificar seu sistema e continuar somente se tiver certeza de que tem espaço livre suficiente disponível para continuar. |
2.6 | Depois de confirmar que há espaço suficiente disponível, o utilitário começa a migrar os dados do fluxo de trabalho. Você verá mensagens do console indicando a hora de início e o tempo de conclusão com mensagens de progresso. |
Solução de problemas
Se ocorrer um erro durante a migração, ele será exibido no console e também será capturado no arquivo de log.
Se você encontrar um erro, siga estas etapas:
Faça uma captura de tela do prompt de comando.
Oculte ou remova os dados confidenciais.
Capture o log (consulte as etapas de validação para localização e nomeação).
Execute a migração novamente.
Se a migração não for bem-sucedida novamente, entre em contato com o Suporte e inclua a captura de tela e o arquivo de log em seu relatório.
Etapa 3: atualize para o Server 2022.3
Importante
Antes de atualizar, faça uma cópia de backup do seu banco de dados do Mongo e do RuntimeSettings.xml . A criptografia executada durante a janela de manutenção não é reversível. O backup protege sua instalação contra perda de dados ou tempo de inatividade adicional.
O progresso da migração não é visível durante a atualização 2022.3.
Para obter mais informações sobre a atualização, acesse Instalar ou Atualizar o Server .
# | Etapa |
---|---|
3.1 | Baixe o instalador 2022.3 e execute-o. |
3.2 | Aceite o contrato de licença. |
3.3 | Escolha o caminho de instalação ou aceite o caminho padrão. |
3.4 | Inicie a instalação. |
3.5 | Permita que a instalação seja concluída. |
3.6 | Após a conclusão da instalação, escolha a opção Configurar o Server agora . Nota Após a conclusão da instalação do Server 22.3, pode haver um atraso na inicialização do serviço. |
3.7 | As Configurações do sistema Alteryx são abertas. Navegue pelas Configurações do sistema para verificar se estão corretas. Em seguida, selecione Concluir e Concluído para iniciar o serviço. |
3.8 | Uma vez inicializado o serviço, o Server entra no modo de manutenção para migrar RuntimeSettings e os valores do banco de dados que não puderam ser migrados antecipadamente. Durante o modo de manutenção, sua instância do Server ficará indisponível. |
3.9 | A ferramenta de preparo para migração faz uma verificação final das alterações do banco de dados desde a última execução. Em seguida, ela executa a migração (incluindo quaisquer alterações recém-encontradas) e move a migração em fases para uso. |
3.10 | Essa migração final pode levar várias horas. O tempo depende do tamanho de sua configuração e se a ferramenta de preparo para migração foi executada antes do upgrade. Quando esse processo for concluído, o Server deverá sair do modo de manutenção e entrar em um estado funcional. |
Solução de problemas
Se o serviço for desligado após um período, verifique os seguintes registros de erros de migração:
LastStartupError.txt
AlteryxServiceMigrator_#.log foi criado pela ferramenta de preparo para migração
AlteryxServiceMigrator_#.log foi criado durante o início do serviço
Se forem encontrados erros de migração, tente reiniciar o AlteryxService. Depois de tentar reiniciar o AlteryxService, o problema pode ser resolvido. Se o problema persistir, colete os logs e entre em contato com o suporte ao cliente para obter assistência. Dependendo dos erros, tentar reiniciar o AlteryxService pode resolver o problema, pois ele tentará novamente qualquer etapa de migração incompleta.
O que pode causar uma falha na migração?
Há 2 casos de falha:
Não foi possível descriptografar o registro. Isso implica em um registro corrompido que o usuário precisa remover da tabela (depois de fazer backup, se apropriado).
Não foi possível criptografar o registro novamente. A solução é a mesma como no caso anterior.
Outros casos de falha geralmente são questões ambientais. Esses problemas são resolvidos pela correção do problema ambiental e, em seguida, executando o utilitário novamente. A conexão perdida com o MongoDB e o espaço em disco insuficiente são alguns exemplos.
Etapa 4: valide o sucesso da migração
Para validar se a ferramenta de preparo para migração foi concluída com êxito, siga qualquer uma das opções a seguir.
Validar o log da ferramenta de preparo para migração
Navegue até
C:\ProgramData\Alteryx\Service\
.Abra AlteryxServiceMigrator_#.log .
Analise o log para ver se há mensagens de erro ou falha. Procure o status 3 exibido como ' ;3; ' no log.
Validar o log de início do serviço
Navegue até a pasta de registro em log definida por Configurações do sistema > Controlador > Geral > Registrar em log do Alteryx.
Abra AlteryxServiceMigrator_#.log .
Analise o log para ver se há mensagens de erro ou falha. Procure o status 3 exibido como ' ;3; ' no log.
Validação pós-atualização para 2022.3 (após a migração final)
Faça login no Server por meio do URI da Web.
Verifique o seguinte:
Você pode executar manualmente os fluxos de trabalho e os aplicativos.
Os agendamentos estão ativos e em execução com os resultados esperados.
Você pode visualizar, editar, criar e usar credenciais do fluxo de trabalho.
Você pode visualizar, editar, criar e usar conexões de dados do Server.
Recupere um pacote de fluxo de trabalho da API, importe esse pacote para o Designer e execute o fluxo de trabalho no Designer.