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 https://downloads.alteryx.com e execute-o.
Aceite o EULA. Selecione Próximo.
Para alterar o local de instalação, clique em Alterar. Ou clique em 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 da mesma máquina 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, clique em Compartilhar.
Etapa 3: atualize para o Server 2023.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 2023.1.
Para obter mais informações sobre a atualização, acesse Instalar ou Atualizar o Server.
Baixe o Server 2023.1 em downloads.alteryx.com.
Execute o instalador. Clique em 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, clique em Próximo.
Selecione Instalar para iniciar a instalação (atualização).
Quando a instalação estiver concluída, clique em Configurar o Server agora e, em seguida, em Concluir.
Após a conclusão da instalação do Server 2023.1, selecione a opção Iniciar backup e migração.
Após a migração bem-sucedida, clique em OK.
Observação: após a 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, clique em Finish e em 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.1 (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.