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
Baixe o instalador em downloads.alteryx.com e execute-o.
Aceite o EULA. Selecione Próximo.
Para alterar o local de instalação, selecione Alterar. Ou selecione Próximo para aceitar o local padrão.
Siga as instruções para concluir a instalação.
Etapa 2: inicie a ferramenta de preparo para migração
Abra um prompt de comando ou PowerShell.
Navegue até o caminho de instalação escolhido (padrão:
C:\Program Files\Alteryx Migration Tool\).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 "IP Address/Hostname", "Controller Token" 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", "CONTROLLER_TOKEN" 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 <Controller_Token> |
Somente 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 <Controller_Token> | |
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 <Controller_Token> | |
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> |
Somente 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 <Controller_Token> |
Somente 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 <Controller_Token> | |
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 <Controller_Token> | |
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 <Controller_Token> |
Somente 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 <Controller_Token> | |
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 <Controller_Token> |
-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
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:
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 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 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.
Baixe o Server 2023.2 em downloads.alteryx.com.
Execute o instalador. Selecione Sim para continuar a atualização.
Aceite o contrato de licença.
Escolha o caminho de instalação ou aceite o caminho padrão. Em seguida, selecione Próximo.
Selecione Instalar para iniciar a instalação (atualização).
Quando a instalação estiver concluída, selecione Configurar o Server agora e, em seguida, selecione Concluir.
Após a instalação do Server 2023.2 estar concluída, selecione a opção Iniciar backup e migração.
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.
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 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 ocorrerem erros de migração, tente reiniciar o AlteryxService. Isso pode resolver o problema, uma vez que irá tentar novamente quaisquer etapas de migração incompletas. 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
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 2023.2 (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.