Skip to main content

Executar a ferramenta de preparo para migração

Importante

Use essa ferramenta apenas para migrar da versão 2022.2 ou anteriores do Server. O mecanismo de criptografia foi atualizado na versão 2022.3.

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

  1. Baixe o instalador em downloads.alteryx.com e execute-o.

  2. Aceite o EULA. Selecione Próximo.

  3. Para alterar o local de instalação, selecione Alterar. Ou selecione Próximo para aceitar o local padrão.

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

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

  1. Abra um prompt de comando ou PowerShell.

  2. Navegue até o caminho de instalação escolhido (padrão: C:\Program Files\Alteryx Migration Tool\).

  3. Execute um dos 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.

    Para a configuração de múltiplos nós, o endereço IP/nome do host, token do controlador e SENHA_NÃO_ADMINISTRADOR_MONGO devem ser aqueles do computador onde o nó do controlador está sendo executado de acordo com a configuração feita durante a configuração de múltiplos nós.

    Para um nó único, as informações devem ser do mesmo computador em que o Alteryx Server está instalado.

Como usar os exemplos:

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 integrado, use a senha MongoDB de não administrador. Na cadeia de conexão, seu authSource deve ser "AlteryxService".

    • No caso do 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.

Banco de dados

Exemplo

MongoDB integrado

Observação: "SENHA_NÃO_ADMINISTRADOR_MONGO", "TOKEN_DO_CONTROLADOR" e "localhost" devem ser alterados com base na sua configuração atual.

Migração de parte do aplicativo e de RunAS_Credentials

AlteryxServiceMigrator22_2.exe -p -c "mongodb://user:SENHA_NÃO_ADMINISTRADOR_MONGO@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Token_do_controlador>

Apenas migração de parte do aplicativo

AlteryxServiceMigrator22_2.exe --appsonly -c "mongodb://user:SENHA_NÃO_ADMINISTRADOR_MONGO@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Token_do_controlador>

Somente migração de RunAs_Credential

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://user:SENHA_NÃO_ADMINISTRADOR_MONGO@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Token_do_controlador>

MongoDB gerenciado pelo usuário

Observação: "password", "port", "host.domain.tld" e "authenticationDB" devem ser alterados com base na sua instância do MongoDB atual.

Migração de parte do aplicativo e de RunAS_Credentials

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

Apenas migração de parte do aplicativo

AlteryxServiceMigrator22_2.exe --appsonly -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

Somente migração de RunAs_Credential

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

Conjuntos de réplicas do MongoDB

Migração de parte do aplicativo e de RunAS_Credentials

AlteryxServiceMigrator22_2.exe -p -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Token_do_controlador>

Apenas migração de parte do aplicativo

AlteryxServiceMigrator22_2.exe –-appsonly -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Token_do_controlador>

Somente migração de RunAs_Credential

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Token_do_controlador>

MongoDB Atlas

Migração de parte do aplicativo e de RunAS_Credentials

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

Apenas migração de parte do aplicativo

AlteryxServiceMigrator22_2.exe –-appsonly -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Token_do_controlador>

Somente migração de RunAs_Credential

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Token_do_controlador>

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

  • --appsonly executar apenas migração em partes, sem verificação prévia

  • --credonly realizar a verificação prévia, sem migração em partes

  • -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)

  • -i [ --hostname ] arg   Nome do host|Endereço IP do controlador

  •  -t [ --controllertoken ] arg   Token do controlador para recuperar as chaves

  • -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

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

O que acontece depois?
  • 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. 

  • Depois que você confirmar os backups, o utilitário verifica o uso atual do espaço. Ele fornece 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.

  • 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:

  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 da Alteryx e inclua a captura de tela e o arquivo de log em seu relatório.

Nota

Se ocorrer o erro Erro durante a inicialização da chave <Erro ao importar chaves para o diretório Microsoft\Crypto\RSA\MachineKeys\ em ProgramData: o acesso foi negado. (5)> Falha na migração RunAS ao executar o comando de migração, navegue para C:\ProgramData\Microsoft\Crypto\RSA\MachineKeys. Em seguida, clique com o botão direito do mouse na pasta "MachineKeys" e selecione Mostrar mais opções > Dar acesso a > Pessoas específicas. Selecione Todos com acesso de Leitura/gravação. Em seguida, selecione Compartilhar.

Etapa 3: atualize para o Server 2024.1

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 para 2024.1.

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

  1. Baixe o Server 2024.1 em downloads.alteryx.com.

  2. Execute o instalador. Selecione Sim para continuar a atualização.

  3. Aceite o contrato de licença.

  4. Escolha o caminho de instalação ou aceite o caminho padrão. Em seguida, selecione Próximo.

  5. Selecione Instalar para iniciar a instalação (atualização).

  6. Quando a instalação estiver concluída, selecione Configurar o Server agora e, em seguida, selecione Concluir.

  7. Após a instalação do Server 2024.1 estar concluída, selecione a opção Iniciar backup e migração.

  8. Após a migração bem-sucedida, selecione OK.

Observação: após a conclusão da instalação, pode haver um atraso na inicialização do serviço.

Próximos passos após a instalação

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.

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.

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.

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 algum tempo, 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 ocorrerem erros de migração, tente reiniciar o AlteryxService. Isso pode resolver o problema, uma vez que irá tentar novamente quaisquer passos de migração incompletos. 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.

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 2024.1 (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.