Migração de dados para o novo cluster

Migre dados para um novo cluster do Automation Suite como parte do processo de atualização.

Apenas offline

1. Hidrate o registro do Docker em execução no cluster de origem com o pacote correspondente à versão para a qual você planeja atualizar. Certifique-se de baixar as.tar.gz na máquina do servidor do cluster de origem onde você anexou o disco do pacote da UiPath® no ponto de montagem /uipath . O local preferido é /uipath/<new_version>/as.tar.gz.

2. Crie um local temporário para descompactar o pacote.

   mkdir -p /uipath/tmp
   

3. Hidrate o registro do Docker do cluster de origem com o pacote offline mais recente.

   ./bin/uipathctl registry upload --offline-bundle /uipath/<new_version>/as.tar.gz --offline-tmp-folder /uipath/tmp
   

Observação:

Você pode executar o script de migração de dados antes de colocar o cluster no modo de manutenção para reduzir o tempo de migração durante o período de inatividade.

Clonagem de seus bancos de dados do cluster de origem

Importante:

• Você pode permitir que o instalador crie os novos bancos de dados com os nomes padrão durante a instalação de componentes e serviços compartilhados. Para obter detalhes, consulte Configuração do Microsoft SQL Server.
• Se os nomes dos seus bancos de dados forem diferentes, você deverá excluir os bancos de dados criados pelo instalador, copiar os bancos de dados do SQL Server de origem para o novo SQL Server e manter os nomes dos bancos de dados.
• Se você optar por alterar o nome do banco de dados no novo SQL Server, deverá editar cuidadosamente o arquivo cluster_config.json para cada produto instalado.

1. Certifique-se de obter o novo instalador em seu cluster de origem para migrar os dados para o novo cluster de destino.

   Siga as etapas em Baixar os pacotes de instalação e obtê-los nas máquinas em um dos nós do servidor do cluster de origem de onde você planeja disparar a migração.

2. Coloque o cluster de origem no modo de manutenção:

   ./bin/uipathctl cluster maintenance enable
   

   Importante:

   O tempo de inatividade começa agora.

3. Copie seus bancos de dados para o cluster de destino usando seu método preferido. Por exemplo, você pode usar o Assistente para Copiar Banco de Dados.

Clonagem de seus dados do cluster de origem

1. Obtenha o arquivo target_kubeconfig do cluster de destino para realizar a migração de dados, executando o seguinte comando:

   ./bin/uipathctl config kubeconfig get --migration
   

   Observação:

   O arquivo target_kubeconfig é necessário para buscar as informações do Objectstore no cluster de destino e executar a cópia de dados necessária para a versão de destino.

2. Copie o arquivo gerado no cluster de origem. Você precisará usar esse arquivo durante a migração de dados. Você deve substituir <target_kubeconfig> por este caminho de arquivo nas etapas a seguir.

3. Copie os dados do cluster de origem para o cluster de destino executando o script de migração de dados no cluster de origem.

   cd /opt/UiPathAutomationSuite/<new_version>/installer
   ./bin/uipathctl cluster migration run cluster_config.json --target-kubeconfig <target_kubeconfig> --versions versions/helm-charts.json
   

   Observação:

   • O comando de migração anterior é idempotent. Se o comando falhar no meio devido à conectividade de rede, você pode reexecutá-lo, e o processo de migração continuará de onde parou.
   • Opcionalmente, você pode realizar uma sincronização diferenciado da migração de dados executando o comando de migração novamente.
   Importante:

   Se o cluster estiver usando o objectstore no cluster (Ceph) e se você tiver optado pela atualização lado a lado (início de nó único), o comando de migração poderá falhar na verificação de pré-requisitos CEPH_SPACE_VALIDATION . Isso acontece porque o cluster de origem tem três réplicas de dados e o cluster de destino não é HA com nó único. Você pode ignorar a verificação de pré-requisito neste caso:

   ./bin/uipathctl cluster migration run cluster_config.json --target-kubeconfig
           <target_kubeconfig> --versions versions/helm-chart.json
     --skip-pre-reqs
   

4. Se você usar um objectstore externo no cluster de origem, clone os buckets do objectstore.