Atualização offline

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. Para fazer o download das instruções, consulte sf-installer.zip.

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

6. Baixe sf-infra.tar.gz e copie para /opt/UiPathAutomationSuite/{version}. Para obter instruções de download, consulte sf-infra.tar.gz:

   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}. Para obter instruções de download, consulte 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. Gere o último cluster_config.json no primeiro nó de servidor e copie-o para o restante dos nós. Para obter detalhes sobre como configurar os parâmetros cluster_config.json , consulte Como usar o arquivo de configuração.

• 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

Adição de configuração específica do AI Center

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.

Configuração do 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.

Como colocar o cluster no modo de manutenção

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 AI Center™.

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.

Como atualizar o Kubernetes e outros componentes de infraestrutura

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.

Como atualizar componentes compartilhados e serviços de produtos UiPath

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.

Ativação do backup após a atualização

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