Automation Suite
2022.4
falso
Manual: atualização offline - Automation Suite 2022.4
Imagem de fundo do banner
Logotipo
Guia de instalação do Automation Suite
Última atualização 12 de fev 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 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}/installercp /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}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}cp /path/to/sf.tar.gz /uipath/{version}
  8. Descompacte sf-installer.zip:
    cd /opt/UiPathAutomationSuite/{version}/installer
    unzip sf-installer.zip -d .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}/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

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.

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.

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[[ $(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 ../sf-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 ../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
    cd /opt/UiPathAutomationSuite/{version}/installer
    /install-uipath.sh --upgrade -f -s -i ./cluster_config.json -o ./output.json --install-type offline --install-offline-prereqs --accept-license-agreement# replace {version} with the version you are upgrading to
    cd /opt/UiPathAutomationSuite/{version}/installer
    /install-uipath.sh --upgrade -f -s -i ./cluster_config.json -o ./output.json --install-type offline --install-offline-prereqs --accept-license-agreement
    Importante:

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

    Após atualizar manualmente do Automation Suite 2021.10 para 2022.4, 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
  • 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, 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# replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer

./configureUiPathAS.sh resume-scheduled-backups
Ícone de suporte e serviços
Obtenha a ajuda que você precisa
Ícone do UiPath Academy
Aprendendo RPA - Cursos de automação
Ícone do Fórum do UiPath
Fórum da comunidade da Uipath
Logotipo branco da Uipath
Confiança e segurança
© 2005-2024 UiPath. All rights reserved.