Offline upgrade

Preparação

AVISO:

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. Identify the server (not agent) node that has additional UiPath bundle disk attached at /uipath mount point. This node is referred to as primary server node throughout the document. In the case of a single-node evaluation profile, where you have only one server node, you must log into that node.

   Observação:

   Perform the following steps on all the nodes in the cluster. Start with the server nodes and continue with the agent nodes.

2. Conecte-se a um nó usando SSH.

3. Torne-se o usuário raiz:

   sudo su -
   

4. 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>
   

5. Download sf-installer.zip and copy it to /opt/UiPathAutomationSuite/{version}/installer. For download instructions, see sf-installer.zip.

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

6. Download sf-infra.tar.gz and copy it to /opt/UiPathAutomationSuite/{version}. For download instructions, see sf-infra.tar.gz:

   cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/{version}
   

7. (Only on the primary server node). Download sf.tar.gz and copy it to /uipath/{version}. For download instructions, see sf.tar.gz:

   cp /path/to/sf.tar.gz /uipath/{version}
   

8. Descompacte sf-installer.zip:

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

9. Forneça as permissões necessárias ao instalador:

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

10. Generate the latest cluster_config.json on the first server node and copy it to the rest of the nodes. For details on how to configure the cluster_config.json parameters, see Using the configuration file.

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

  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 uma 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:

   Document Understanding is enabled by default if AI Center is enabled.

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>",
   },
   

Execução

AVISO:

If any errors or issues occur during or following the upgrade, you can rollback to the previous version, provided that you previously configured a backup. For instructions, see Rollback on error.

Configuring the backup

Para configurar o backup, execute as seguintes etapas:

1. Make sure you have enabled the backup on the cluster. You must create the backup using the same version of the installer as the one you used for the current deployment. For instructions, see the backup and restore documentation corresponding to the UiPath AI Center version from which you plan to upgrade.

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 o backup dos volumes novamente.

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:

This operation will cause downtime, and your business automation will be suspended during the entire upgrade process.

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:

   Create a backup of your SQL Server after enabling maintenance mode so that no further transactions are recorded in your SQL database.

Updating Kubernetes and other infrastructure components

AVISO:

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 nós de servidor

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

   • Para os nós agentes:

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

4. Para iniciar a atualização, execute o comando a seguir:

   AVISO:

   Make sure you have updated cluster_config.json generated as described in the Preparation steps.

   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 --offline-bundle "/path/to/sf-infra.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json
   

   Importante:

   If you get an error, follow the instructions in Downgrading Ceph from 16.2.6 to 15.2.9.

Updating shared components and UiPath product services

Esta etapa atualiza os componentes de malha e serviço em execução com o cluster. É necessário seguir essas etapas apenas no nó servidor primário.

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 in both the commands
   cd /opt/UiPathAutomationSuite/{version}/installer
   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -f -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --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 --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json
   

   AVISO:

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

Enabling the backup post-upgrade

AVISO:

Make sure AI Center is up and running and your automation continues as expected before proceeding with the next steps.

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