Skip to main content

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 pode verificar o espaço disponível.

Etapa 1: instale a ferramenta de preparo para migração

Siga estas etapas para instalar a ferramenta de preparo para migração.

#

Etapa

1.1

Baixe o instalador em https://downloads.alteryx.com e execute-o.

Run the installer of the Migration Prep Tool.

1.2

Aceite o EULA.

Accept the EULA.

1.3

Escolha o caminho de instalação ou aceite o caminho padrão.

Choose the installation path or accept the default path. 

1.4

Siga as instruções para concluir a instalação.

Follow the prompts to complete the installation.
Follow the prompts to complete the installation.

Etapa 2: inicie a ferramenta de preparo para migração

Siga estas etapas para iniciar a 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: C:\Program Files\Alteryx Migration Tool\ ).

2.3

Execute um desses 3 comandos para executar a ferramenta de preparo para migração. Observação: se você usar o PowerShell, adicione .\ ao início de cada comando.

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:

AlteryxServiceMigrator22_2.exe -p -c "mongodb://{user}:{password}@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}"

Isso pode parecer com o exemplo a seguir. Observe que " NON_ADMIN_MONGO_PASSWORD " e " localhost " devem ser alterados com base na sua configuração atual.

AlteryxServiceMigrator22_2.exe -p -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService"

#Exemplo para uso com conjuntos de réplicas do MongoDB:

AlteryxServiceMigrator22_2.exe -p -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}"

#Exemplo para uso com o MongoDB Atlas:

AlteryxServiceMigrator22_2.exe -p -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority"

  • Substitua essas variáveis na cadeia de conexão pelos valores apropriados para o seu ambiente. Essas são as mesmas credenciais usadas para configurar o banco de dados do Server e podem ser encontradas em Configurações do sistema Alteryx :

    • {authenticationDB} = o banco de dados que autenticará a credencial de usuário especificada.

      • Se o Server estiver configurado para usar o MongoDB incorporado, você precisará usar a senha MongoDB de não administrador. Na cadeia de conexão, seu authSource deve ser "AlteryxService".

      • Se você estiver usando um MongoDB gerenciado pelo usuário, entre em contato com o administrador do MongoDB para confirmar as credenciais do usuário e o authSource.

    • {port} = a porta de serviço que o MongoDB usa para fornecer acesso ao banco de dados.

    • {host.domain.tld} = o nome de domínio totalmente qualificado de seu servidor MongoDB.

    • {password} = credencial para o usuário.

    • {user} = nome de usuário para acessar o banco de dados.

    • {atlasCluster.cloudProvider.mongodb.net} = o endereço do cluster do MongoDB Atlas.

  • Parâmetros de comando:

    • -h [ --help ] exibir informações de ajuda

    • -q [ --quiet ] enviar mensagens de log para a linha de comando (as mensagens de progresso ignoram esse sinalizador)

    • -s [ --severity ] arg (=7) nível de gravidade do registro em log do console (os relatórios de progresso de migração são enviados no nível 5)

    • -p [ --perform ] executar a migração

    • -u [ --forcenoprogressupdates ] desabilitar a gravação das mensagens de atualização de progresso no console (elas ainda são gravadas no arquivo de log)

    • -c [ --connection ] arg cadeia de conexão (o banco de dados do AlteryxService deve ser especificado)

    • -l [ --loggingpath ] arg (=C:\ProgramData\Alteryx) caminho do arquivo de log, deve conter um %N para fins de rotação de log

    • --loggingmaxfilesize arg (=64) tamanho máximo em MB para um arquivo de log antes da rotação

    • -r [ --runtimesettings ] arg caminho do arquivo de configurações de tempo de execução

    • -d [ --stagingdirectory ] arg diretório onde os fluxos de trabalho descriptografados serão armazenados temporariamente antes de serem criptografados novamente

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:

When the migration starts it will it will prompt you to confirm you have made a backup of the database and your runtime settings file.

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.

Once you confirm the backups, the utility will check current space usage .

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.

After confirming sufficient free space is available, the utility will begin migrating the the workflow data in preparation for the upgrade to 2022.3.

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:

  1. Faça uma captura de tela do prompt de comando.

  2. Oculte ou remova os dados confidenciais.

  3. Capture o log (consulte as etapas de validação para localização e nomeação).

  4. Execute a migração novamente.

  5. 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 2023.2

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 2023.2.

  • Para obter mais informações sobre a atualização, acesse Instalar ou Atualizar o Server .

#

Etapa

3.1

Baixe o instalador 2023.2 e execute-o.

Run the installer.

3.2

Aceite o contrato de licença.

Accept the license agreement.

3.3

Escolha o caminho de instalação ou aceite o caminho padrão.

Choose your installation path or accept the default.

3.4

Inicie a instalação.

Start the installation.

3.5

Permita que a instalação seja concluída.

Allow the installation to complete.

3.6

Após a conclusão da instalação, escolha a opção Configurar o Server agora .

Upon completion of the installation choose the ‘Configure Server Now’ option.

Nota

Após a conclusão da instalação do Server 2023.2, 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:

  1. 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).

  2. 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

  1. Navegue até C:\ProgramData\Alteryx\Service\ .

  2. Abra AlteryxServiceMigrator_#.log .

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

  1. Navegue até a pasta de registro em log definida por Configurações do sistema > Controlador > Geral > Registrar em log do Alteryx.

  2. Abra AlteryxServiceMigrator_#.log .

  3. 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 2023.2 (após a migração final)

  1. Faça login no Server por meio do URI da Web.

  2. 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.