Online upgrade

Preparação

Aviso: execute as seguintes etapas no primeiro nó servidor e, em seguida, em todos os outros nós (tanto servidor como 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:

   <h1>Please replace {version} with installer version
   mkdir -p /opt/UiPathAutomationSuite/{version}/installer</h1>

4. Baixe sf-installer.zip e copie-o para /opt/UiPathAutomationSuite/{version}/installer. Para obter instruções de download, consulte o 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 obter detalhes sobre como configurar os parâmetros cluster_config.json, consulte Como usar o arquivo de configuração.

• 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

Adding AI Center specific configuration

1. Open the cluster_config.json with your editor (for example, vi).

   vi /opt/UiPathAutomationSuite/{version}/installer/cluster_config.json

2. Substitua o seguinte bloco:

   "aicenter": {
     "enabled": "false"
   },

   Observação: o Document Understanding é habilitado por padrão se o AI Center estiver habilitado.
3. Com as informações a seguir (substitua as informações entre <> pelos seus valores):

   "aicenter": {
     "orchestrator_url":"<a href="https://orchestrator-url.com">https://orchestrator-url.com</a>",
     "identity_server_url": "<a href="https://orchestrator-url.com/identity">https://orchestrator-url.com/identity</a>",
     "orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
     "identity_cert_file_path":  "</opt/UiPathAutomationSuite/orch.cer or custom path>",
     "identity_access_token": "<placeholder will be replaced later>",
     "metering_api_key": "<placeholder will be replaced later>"
   },

   Observação: metering_api_key é a chave de API do Document Understanding da conta de nuvem do AI Center, conforme a captura de tela abaixo.
   
   

   

   
   

Execução

Aviso: 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 UiPath AI Center da qual planeja atualizar.
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

Putting the cluster in maintenance mode will shut down the ingress controller and all the UiPath services, blocking all the incoming traffic to the AI Center cluster.

Aviso: essa operação causará um tempo de inatividade, e sua automação empresarial ficará 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

   Aviso: crie um backup do seu SQL Server após habilitar o modo de manutenção para que nenhuma transação adicional seja registrada no seu banco de dados do SQL.

Updating Kubernetes and other infrastructure components

Aviso: você deve realizar a atualização de infraestrutura em todos os nós no 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:
   Aviso: certifique-se de ter atualizado 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
   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

   Importante: se encontrar um erro, siga as instruções em Downgrade do Ceph da versão 16.2.6 para a 15.2.9.

Updating shared components and UiPath product services

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
   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -f -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

4. Execute o instalador do software usando o comando abaixo.
   Primeiro, você precisa se conectar ao Identity Server e recuperar um token de instalação. Em seguida, copie este token e cole-o no espaço reservado do arquivo cluster_config.json.

   Depois que o token estiver lá, você poderá executar a instalação do AI Center.

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -s -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

   Aviso: após o término da atualização, o modo de manutenção será desativado automaticamente.

Enabling the backup post-upgrade

Aviso: certifique-se de que o AI Center esteja em funcionamento e que sua automação continue conforme o esperado antes de prosseguir para as próximas etapas.

Antes de iniciar a atualização do cluster, o script de atualização cria automaticamente um backup do cluster e o desabilita temporariamente. Pode ser do seu interesse habilitar o backup manualmente após o término da atualização.

Para habilitar o backup, execute o comando a seguir de qualquer nó de servidor:

replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh resume-scheduled-backups