Execução da atualização

Importante:

Para executar uma atualização do Automation Suite, você deve colocar o cluster no modo de manutenção. O modo de manutenção causa tempo de inatividade durante todo o processo de atualização, e a automação empresarial está suspensa durante esse tempo.

É altamente recomendável criar um backup do cluster e do banco de dados SQL antes da atualização. Isso é para garantir que você possa restaurar o cluster se algo der errado durante a operação de atualização.

O backup dos dados do cluster é feito no servidor NFS. Certifique-se de configurar o servidor NFS antes de prosseguir.

Você deve configurar o backup após desabilitar o modo de manutenção para garantir que todas as transações sejam concluídas.

Putting the cluster in maintenance mode

Colocar o cluster no modo de manutenção encerra o controlador de ingresso e todos os serviços da UiPath®, bloqueando todo o tráfego de entrada para o cluster do Automation Suite.

1. Para colocar o cluster no modo de manutenção, execute:

   ./configureUiPathAS.sh enable-maintenance-mode

2. Para verificar se o cluster está no modo de manutenção, execute:

   ./configureUiPathAS.sh is-maintenance-enabled

Configuring the backup

Para configurar o backup, execute as seguintes etapas:

1. Certifique-se de que você habilitou o backup no cluster. Você deve criar o backup usando a mesma versão do instalador usada para a implantação atual. Para obter instruções, consulte a documentação de backup e restauração correspondente à versão do Automation Suite que você planeja atualizar. Por exemplo, para atualizar o Automation Suite 2023.4, siga as instruções no guia 2023.4.
2. Conecte-se a um dos nós do servidor via SSH.
3. Verifique se todos os volumes desejados têm backups no cluster:

   • Se você atualizar a partir da 2022.4 ou mais antiga, execute o seguinte comando:

     /path/to/old-installer/configureUiPathAS.sh verify-volumes-backup

   • Se você atualizar a partir da 2022.10 ou mais recente, execute o seguinte comando:

     ./configureUiPathAS.sh snapshot list

   Observação: o backup pode levar algum tempo, portanto, aguarde aproximadamente 15 a 20 minutos e verifique novamente o backup dos volumes.

Após a criação do backup, continue com as próximas etapas.

Updating Kubernetes and other infrastructure components

Para atualizar o Kubernetes e os outros componentes de infraestrutura, execute o seguinte comando no nó do servidor primário:

Importante:

Certifique-se de atualizar o arquivo cluster_config.json gerado conforme descrito em Atualização da configuração do cluster.

cd /opt/UiPathAutomationSuite/latest/installer

./install-uipath.sh --upgrade -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k --accept-license-agreement

Observação:

• Executar o comando anterior no nó do servidor primário copia o instalador e cluster_config.json para o local padrão /opt/UiPathAutomationSuite/<version>/installer e atualiza a infraestrutura em todas as máquinas.
• O local padrão /opt/UiPathAutomationSuite/<version> deve ter pelo menos 5 GiB disponíveis em todos os nós.

• Para alterar o local padrão, atualize a seguinte variável de ambiente com o local desejado. Certifique-se de que o local esteja disponível em todos os nós e tenha as permissões necessárias para executar a atualização.

  export INSTALLER_DIRECTORY=/path/to/copy/installer

• Após executar o comando anterior e executar a atualização, o instalador é copiado para o local /path/to/copy/installer/<version>/installer. version é substituído pela versão do instalador que você executar.

Solução de problemas

• Os logs de atualização no servidor primário estão disponíveis no local padrão /opt/UiPathAutomationSuite/latest/installer/upgrade-logs, a menos que você use explicitamente um local personalizado para o instalador.
• Em todos os outros nós, os logs estão disponíveis no local padrão /opt/UiPathAutomationSuite/<version>/installer/upgrade-logs, a menos que você tenha alterado explicitamente esse local por meio da variável INSTALLER_DIRECTORY.

Atualizar os componentes compartilhados e os serviços de produtos UiPath®

1. Para atualizar os componentes compartilhados e os serviços de produtos da UiPath®, execute o seguinte comando no nó do servidor primário:

   ./install-uipath.sh --upgrade -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -f -s --accept-license-agreement

   Importante:

   Após concluir a atualização, o modo de manutenção será desabilitado automaticamente.

2. Para verificar se o Automation Suite está íntegro, execute um dos seguintes comandos:

   cd /opt/UiPathAutomationSuite/latest/installer/bin
   ./uipathctl health check

   cd /opt/UiPathAutomationSuite/latest/installer/bin
   ./uipathctl health test --versions versions.json

   Observação:

   Para baixar versions.json, consulte Download dos pacotes de instalação.

Depois de concluir a atualização, execute a atividade de limpeza e migração aplicável a você.