automation-suite
2023.4
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo.
Guia de instalação do Automation Suite no Linux
Last updated 1 de nov de 2024

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 -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# Please replace {version} with installer version
    mkdir -p /opt/UiPathAutomationSuite/{version}/installer
  5. Baixe as-installer.zip e copie para /opt/UiPathAutomationSuite/{version}/installer. Para fazer o download das instruções, consulte as-installer.zip.
    cp /path/to/as-installer.zip /opt/UiPathAutomationSuite/{version}/installercp /path/to/as-installer.zip /opt/UiPathAutomationSuite/{version}/installer
  6. Baixe as-infra.tar.gz e copie para /opt/UiPathAutomationSuite/{version}. Para obter instruções de download, consulte as-infra.tar.gz.
    cp /path/to/as-infra.tar.gz /opt/UiPathAutomationSuite/{version}cp /path/to/as-infra.tar.gz /opt/UiPathAutomationSuite/{version}
  7. (Apenas no nó servidor primário). Baixe as.tar.gz e copie para /uipath/{version}. Para obter instruções de download, consulte as.tar.gz:
    cp /path/to/as.tar.gz /uipath/{version}cp /path/to/as.tar.gz /uipath/{version}
  8. Descompacte as-installer.zip:
    cd /opt/UiPathAutomationSuite/{version}/installer
    unzip as-installer.zip -d .cd /opt/UiPathAutomationSuite/{version}/installer
    unzip as-installer.zip -d .
  9. Forneça as permissões necessárias ao instalador:
    chmod 755 -R /opt/UiPathAutomationSuite/{version}/installerchmod 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.jsoncd /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.jsoncd /opt/UiPathAutomationSuite/{version}/installer
      
      ./configureUiPathAS.sh config get -o ./cluster_config.json
    • Ao atualizar o Automation Suite 2022.10 para o Automation Suite 2023.4 ou posterior com o Orchestrator ativado em ambas as versões, é necessário definir o sinalizador orchestrator.block_classic_executions como true no arquivo cluster_config.json. O sinalizador tem o objetivo de expor seu consentimento com o bloqueio de execuções de pastas clássicas. Ignorar o sinalizador gera uma falha na operação de atualização. Para visualizar um exemplo de configuração, consulte Configuração específica do Orchestrator.
    • Se você estiver usando o AI CenterTM conectado a um Orchestrator externo, certifique-se de ter o certificado do Orchestrator no arquivo cluster_config.json . Se você atualizar de uma versão mais antiga do que 2022.10, copiar 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
        }"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 .
    • Ao atualizar o Automation Suite de uma versão anterior e, em conjunto, habilitar o Process Mining, será necessário atualizar sql_connection_string_template_sqlalchemy_pyodbc. Veja um exemplo abaixo.
      "sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://testadmin@sfmfup20211043125452-8926d153-sql.database.windows.net:sgTQrg%40R%40dvoYddYBoKn045ncoC9WhWU@sfmfup20211043125452-8926d153-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server""sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://testadmin@sfmfup20211043125452-8926d153-sql.database.windows.net:sgTQrg%40R%40dvoYddYBoKn045ncoC9WhWU@sfmfup20211043125452-8926d153-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"
    • Se você atualizar o Automation Suite de uma versão anterior à 2023.4 e tiver o Apps habilitado, você deve criar o banco de dados SQL para o Apps e, em seguida, atualizar o arquivo cluster_config.json com a seguinte configuração:
      "apps": {
      "enabled": "true" // This will already be true in existing cluster_config.json if apps is enabled
      "sql_connection_str": "" // Provide ODBC database connection string if apps is enabled
      }"apps": {
      "enabled": "true" // This will already be true in existing cluster_config.json if apps is enabled
      "sql_connection_str": "" // Provide ODBC database connection string if apps is enabled
      }
      Observação:

      Use o arquivo cluster_config.json atualizado nas próximas etapas de atualização.

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 do registro do Docker e do contêiner

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}/as.tar.gz --offline-tmp-folder /uipath/tmpcd /opt/UiPathAutomationSuite/{version}/installer
    
    ./configureUiPathAS.sh registry upload --offline-bundle /uipath/{version}/as.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 ../as-infra.tar.gz --offline-tmp-folder ../../tmpcd /opt/UiPathAutomationSuite/{version}/installer
    
    ./configureUiPathAS.sh containerd --offline-bundle ../as-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/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-modecd /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./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.

Updating Kubernetes and other infrastructure components

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[[ $(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[[ $(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 ../as-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement# 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 ../as-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

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 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# 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 argocdkubectl get applications -n argocd
  • Ao atualizar de uma versão do Automation Suite anterior a 2023.4.0, verifique se o Apps está em execução e remova o MongoDB:

    ./configureUiPathAS.sh mongodb uninstall --force./configureUiPathAS.sh mongodb uninstall --force
  • Se você encontrar um erro ao remover o MongoDB com o comando ./configureUiPathAS.sh mongodb uninstall --force, tente executar o seguinte comando
    kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": false }}}}'
    
    ./configureUiPathAS.sh mongodb uninstall --force
    
    kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": true }}}}'kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": false }}}}'
    
    ./configureUiPathAS.sh mongodb uninstall --force
    
    kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": true }}}}'
  • 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.

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.