Manual: atualização online

Preparação

Importante:

Execute as seguintes etapas no primeiro nó do servidor e depois em todos os outros nós (tanto do servidor como do agente) no cluster.

Certifique-se de ter 10 GiB de espaço livre na pasta /opt/UiPathAutomationSuite em todos os nós. Se não tiver espaço suficiente, você pode aumentar a capacidade dessa pasta ou remover todos os arquivos de instalador anteriores, exceto por cluster_config.json. Sempre é possível baixar o instalador anterior novamente.

Para verificar o espaço disponível, execute o comando a seguir: df -h /opt/UiPathAutomationSuite.

Para se preparar para a atualização, siga as seguintes etapas:

1. Faça login em qualquer máquina de servidor usando SSH. No caso do perfil de avaliação de nó único, no qual existe apenas um nó servidor, faça login nesse nó.
2. Torne-se o usuário raiz:

   sudo su -

3. Crie uma pasta de instalação no diretório /opt/UiPathAutomationSuite:

   # Please replace {version} with installer version
   mkdir -p /opt/UiPathAutomationSuite/{version}/installer

4. Baixe sf-installer.zip e copie para /opt/UiPathAutomationSuite/{version}/installer. Para fazer o download das instruções, consulte sf-installer.zip.

   cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer

5. Descompacte sf-installer.zip:

   cd /opt/UiPathAutomationSuite/{version}/installer
   unzip sf-installer.zip -d .

6. Forneça permissão para o instalador:

   chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer

7. Gere o arquivo mais recente cluster_config.json no primeiro nó servidor e o copie para os outros nós.
   Observação: para mais detalhes sobre como configurar os parâmetros cluster_config.json , consulte Experiência de instalação avançada.

   • Se você tiver o cluster_config.json antigo, gere o arquivo de configuração a partir do cluster:

     cd /opt/UiPathAutomationSuite/{version}/installer
     
     ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json

   • Se você não tiver o arquivo cluster_config.json antigo, gere qualquer substituição de algum valor padrão, que você pode ter feito no momento da instalação da versão anterior:

     cd /opt/UiPathAutomationSuite/{version}/installer
     
     ./configureUiPathAS.sh config get -o ./cluster_config.json

   • Se você estiver atualizando de uma versão anterior do AI CenterTM independente e sua versão 2022.10 do AI Center precisar ser conectada a um Orchestrator externo, copie o certificado do Orchestrator para a máquina virtual. Depois de copiar o certificado, os seguintes detalhes de configuração são necessários em cluster_config.json:

     "aicenter": {
         "enabled": true,
         "orchestrator_url": "https://orchestrator.example.com", //Specify the Orchestrator URL for AI Center
         "identity_server_url": "https://orchestrator.example.com/identity", //Specify the Identiy URL for AI Center
         "orchestrator_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer", //Specify the path to the Orchestrator certificate
         "identity_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer", //Specify the path to Identity certificate file
         "metering_api_key": "test" //Specify the metering API key
       }

     Observação: se o AI Center exigir um Orchestrator externo, adicione sql_connection_string_template e sql_connection_string_template_odbc no arquivo cluster_config.json .

     Após atualizar o AI Center para a versão 2022.10 e migrar para um armazenamento externo, criar uma habilidade feita na versão pública 2022.4 falhará. Para corrigir isso, execute o script encontrado aqui.

   • Se você estiver atualizando o Automation Suite de uma versão anterior e agora ativar o Process Mining também, deverá atualizar o sql_connection_string_template_sqlalchemy_pyodbc. Abaixo está um exemplo.

     "sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://[e-mail]:[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

     Consulte também Manual: experiência de instalação avançada.

8. (Opcional) Se você ainda usa um certificado autoassinado gerado pelo instalador, execute o seguinte comando. Esta etapa é necessária no primeiro nó do servidor, onde você realizará a atualização dos produtos UiPath.

   ### Please replace /path/to/cert with path to location where you want to store certificates.
   ./configureUiPathAS.sh tls-cert get --outpath /path/to/cert
   
   ### Now copy the ca.crt file generated in above location to trust store location
   sudo cp --remove-destination /part/to/cert/ca.crt /etc/pki/ca-trust/source/anchors/
   
   ### Update the trust store
   sudo update-ca-trust

Execução

Importante: se algum erro ou problema ocorrer durante ou após a atualização, você pode reverter para a versão anterior, contanto que tenha configurado um backup anteriormente. Para instruções sobre isso, consulte Reverter erro.

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 2021.10, siga as instruções no guia 2021.10.
2. Conecte-se a um dos nós do servidor via SSH.
3. Para verificar se todos os volumes desejados têm backups no cluster, execute:

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

   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.

Putting the cluster in maintenance mode

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

Importante: Essa operação causará tempo de inatividade, e a automação de negócios será suspensa durante todo o processo de atualização.

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

   cd /opt/UiPathAutomationSuite/{version}/installer
   ./configureUiPathAS.sh enable-maintenance-mode

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

   ./configureUiPathAS.sh is-maintenance-enabled

   Importante: Crie um backup do seu Servidor SQL após ativar o modo de manutenção para que transações adicionais não sejam registradas no seu banco de dados SQL.

Updating Kubernetes and other infrastructure components

Importante:

Você deve executar a atualização de infraestrutura em todos nós do cluster.

Você não pode executar essa etapa em vários nós ao mesmo tempo; é necessário aguardar o término da atualização em cada nó antes de passar para o próximo.

1. Faça login em cada nó em que queira realizar a atualização de infraestrutura.
2. Torne-se root executando sudo su -.
3. Certifique-se de que rke service está habilitado nos nós servidores e agentes.

   Se o serviço estiver desativado, habilite ele com o comando a seguir:

   • Para um nó servidor:

     [[ $(systemctl is-enabled rke2-server.service) != "enabled" ]] && systemctl enable rke2-server.service

   • Para um nó agente:

     [[ $(systemctl is-enabled rke2-agent.service) != "enabled" ]] && systemctl enable rke2-agent.service

4. Para iniciar a atualização, execute o comando a seguir:
   Importante: não esqueça de atualizar o cluster_config.json gerado conforme descrito nas etapas de preparação.

   # replace {version} with the version you are upgrading to
   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./install-uipath.sh --upgrade -k -i ./cluster_config.json -o ./output.json --accept-license-agreement

   Importante:

   Se você receber o seguinte erro, siga as instruções em Downgrade do Ceph da versão 16.2.6 para a 15.2.9.

   Ceph cluster is running on version: 16.2.6 with known bug(https://docs.ceph.com/en/quincy/releases/pacific/#v16-2-6-pacific). Please provide temporary backup directory (via environment variable 'TMP_CEPH_BACKUP_PATH') to downgrade ceph

Como atualizar componentes compartilhados e serviços de produtos UiPath

Importante: se você implantou anteriormente sua instalação de nó único usando qualquer versão de modelo do Azure anterior a 2022.10.3 e agora deseja atualizar para uma versão mais recente do Automation Suite, defina o sinalizador zone_resilience como false no cluster_config.json arquivo em /opt/UiPathAutomationSuite/Installer.

Esta etapa atualiza os componentes de base e serviço em execução com o cluster. Você deve seguir essas etapas apenas uma vez de qualquer um dos nós de servidor.

1. Conecte-se a qualquer nó de servidor.
2. Torne-se root executando sudo su -.
3. Execute o seguinte comando:

   # replace {version} with the version you are upgrading to
   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./install-uipath.sh --upgrade -f -s -i ./cluster_config.json --accept-license-agreement -o ./output.json

   Importante:

   Depois de atualizado, o modo de manutenção será desabilitado automaticamente.

   Após atualizar manualmente do Automation Suite 2021.10, você também deve migrar para o Cilium CNI. Para obter instruções, consulte Migrando do Canal para o Cilium CNI.

Após realizar a atualização, você pode seguir as seguintes etapas adicionais:

• Para verificar se o Automation Suite está íntegro, execute:

  kubectl get applications -n argocd

• Se você tiver problemas com vulnerabilidades de imagem ou consumo de armazenamento após realizar uma atualização, exclua as imagens do instalador antigo. Para obter detalhes, consulte a seção Solução de problemas.

Enabling the backup post-upgrade

Você deve retomar o backup após atualizar e executar as operações de limpeza e migração.

Importante:

Certifique-se de que o Automation Suite esteja funcionando e que sua automação corresponda às expectativas antes de prosseguir para as etapas seguintes.

Para habilitar o backup, siga as instruções descritas na documentação Backup e restauração do cluster.

Concluindo uma atualização com um modelo de implantação

Após executar uma atualização de cluster do Automation Suite, as implantações de modelo do Azure e do AWS exigem algumas alterações para garantir que um novo nó ingresse corretamente no cluster por meio de operações de dimensionamento. Para automatizar as alterações, recomendamos usar os scripts dedicados. Para obter instruções, consulte os documentos do modelo de implantação do Azure e os documentos do modelo de implantação da AWS.

Considerações especiais

Ao executar uma atualização para um cluster implantado com modelos do Azure, pode ocorrer um erro semelhante ao mostrado na imagem a seguir:

Isso ocorre devido à maneira como o balanceador de carga do Azure funciona. Para corrigir o problema, modifique o campo fixed_rke_address no arquivo cluster_config.json . Você deve alterar o valor desse campo para o endereço IP da primeira instância do servidor antes de executar o comando upgrade. O cluster_config.json carregado no cofre de chaves deve continuar a ter o endereço IP do ILB, pois o nó não está íntegro e o tráfego não será balanceado para ele.