Manual: atualização offline

Preparação

Importante:

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

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

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 baixar as instruções, 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 mais detalhes sobre como configurar os parâmetros cluster_config.json, consulte Experiência de instalação avançada.
    • 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

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

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

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.

Hidratação Docker-registry e Containerd

Para minimizar o tempo de inatividade necessário, hidrate docker-registry e containerd com imagens de contêiner para a nova versão de produtos antes da atualização, seguindo os seguintes passos.

Importante:

• Certifique-se de não hidratar imagens de contêiner e/ou outras imagens infra mais que 10 horas antes da atualização.

• Se você atualizar o Document Understanding e o Computer Vision, você deve baixar as imagens de base que correspondem à sua versão do Automation Suite atualizada (utilize a imagem de base que corresponde à sua versão do Pacote de ML) e hidratá-las no seu registro do docker antes da atualização para evitar interrupções nas suas habilidades de DU em execução.Para baixar os pacotes de instalação do Document Understanding e do Computer Vision, consulte Download dos pacotes de instalação.

1. Para hidratar docker-registry, execute o seguinte comando no primeiro nó do servidor:

   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./configureUiPathAS.sh registry upload --offline-bundle /uipath/{version}/sf.tar.gz --offline-tmp-folder /uipath/tmp

2. Observação:

   Certifique-se de que zstd esteja instalado. Para instalar zstd, execute o seguinte comando: dnf install zstd.
   Para hidratar containerd, execute o seguinte comando em todos os nós:

   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./configureUiPathAS.sh containerd --offline-bundle ../sf-infra.tar.gz --offline-tmp-folder ../../tmp

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. Verifique se todos os volumes desejados têm backups no cluster executando:

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

Como atualizar o Kubernetes e outros componentes de infraestrutura

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 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:
   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 --offline-bundle ../sf-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --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

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 ao nó do servidor primário.
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
   ./install-uipath.sh --upgrade -f -s -i ./cluster_config.json -o ./output.json --install-type offline --accept-license-agreement

   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

Importante:

Make sure Automation Suite 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, siga as instruções descritas na documentação Backup e restauração do cluster.