Offline upgrade

Preparação

Aviso: certifique-se de ter 10GiB 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 para 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. Identifique o nó servidor (não agente) que tem o disco UiPath bundle adicional conectado no ponto de montagem /uipath. Esse nó é chamado de nó servidor primário em todo o documento. No caso do perfil de avaliação de nó único, no qual existe apenas um nó servidor, faça login nesse nó.
   Observação: execute as seguintes etapas em todos os nós no cluster. Comece com os nós servidores e continue com os nós agentes.
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. Baixe sf-installer.zip e copie para /opt/UiPathAutomationSuite/{version}/installer.

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

6. Baixe sf-infra.tar.gz e copie para /opt/UiPathAutomationSuite/{version}.

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

7. (Apenas no nó servidor primário). Baixe sf.tar.gz e copie para /uipath/{version}.

   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. Gere o último cluster_config.json no primeiro nó de servidor e copie-o para o restante dos nós.

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

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