Modo de produção offline pronto para alta disponibilidade de vários nós

Preparação

1. Identifique qualquer servidor (não agente) que atende aos requisitos de disco para uma instalação offline. Referido como servidor principal ao longo deste documento.

   Se você estiver usando um certificado autoassinado, execute o seguinte comando:

   ### Please replace /path/to/cert with path to location where you want to store certificates.
   sudo ./configureUiPathAS.sh tls-cert get --outpath /path/to/cert
   
   ### Now copy the ca.crt file generated in above location to trust store location
   sudo cp --remove-destination /part/to/cert/ca.crt /etc/pki/ca-trust/source/anchors/
   
   ### Update the trust store
   sudo update-ca-trust

2. Baixe o pacote offline completo ( sf.tar.gz) no servidor selecionado.
3. Baixe o pacote off-line somente infra ( sf-infra.tar.gz) em todos os outros nós.
4. Baixe e descompacte o novo instalador (installer.zip) em todos os nós.
   Observação: dê permissões adequadas para a pasta executando sudo chmod 755 -R <installer-folder>.
5. Disponibilize o cluster_config.jsonoriginal no servidor primário.
6. Gere o novo cluster_config.jsonarquivo como descrito a seguir:

   • Se você tiver o antigo arquivo ``cluster_config.json`, use o seguinte comando para gerar o arquivo de configuração do cluster:

     cd /path/to/new-installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o /path/to/store/generated/cluster_config.json

   • Se você não tem o cluster configarquivo antigo, execute o seguinte comando:

     cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json

     Observação: Consulte Experiência de instalação avançada para preencher os parâmetros restantes.
7. Copie cluster_config.json para a pasta do instalador em todos os nós.

Execução

Manutenção e backup

1. Certifique-se de que você habilitou o backup no cluster. Para detalhes, consulte Backup e restauração do cluster.
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 o seguinte comando:

   /path/to/new-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.
4. Para verificar se o Automation Suite está íntegro, execute:

   kubectl get applications -n argocd

5. Coloque o cluster no modo de manutenção da seguinte forma:
   1. Execute o seguinte comando:

      /path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode

   2. Verifique se o cluster está no modo de manutenção executando o seguinte comando:

      /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

6. Crie o backup do banco de dados SQL.

Atualize a infraestrutura nos servidores

Observação: a atualização da infraestrutura em servidores e agentes simultaneamente não é suportada e resultará em um erro. Certifique-se de realizar essas etapas sucessivamente.

1. Conecte-se a cada servidor via SSH.
2. Torne-se root executando sudo su -.
3. Execute o seguinte comando em todos os nós do servidor:

   /path/to/new-installer/install-uipath.sh --upgrade -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

   Observação: esse comando também cria um backup do estado do cluster e pausa todos os outros backups agendados.

Atualize a infraestrutura nos agentes

Observação: a atualização da infraestrutura em servidores e agentes simultaneamente não é suportada e resultará em um erro. Certifique-se de realizar essas etapas sucessivamente.

1. Conecte-se a cada servidor via SSH.
2. Torne-se root executando sudo su -.
3. Execute o seguinte comando:

   /path/to/new-installer/install-uipath.sh --upgrade -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

Execute o restante da atualização no servidor primário

1. Conecte-se ao servidor primário via SSH.
2. Torne-se root executando sudo su -.
3. Execute o seguinte comando:

   /path/to/new-installer/install-uipath.sh --upgrade -f -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

   Observação: este comando desabilita o modo de manutenção que você habilitou antes da atualização porque todos os serviços precisam estar ativos durante a atualização.
4. Após a atualização e verificação bem-sucedidas, retome o agendamento de backup no nó executando o seguinte comando:

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

Reverter erro

Preparação

1. Crie uma pasta separada para armazenar os pacotes antigos e execute as seguintes operações dentro dessa pasta.
2. Baixe e descompacte a versão mais antiga do instalador ( installer.zip) em todos os nós.
   Observação: dê permissões adequadas para a pasta executando sudo chmod 755 -R <installer-folder>.
3. Crie o arquivo restore.json e copie-o para todos os nós. Para detalhes, consulte Backup e restauração do cluster.
4. Verifique se os dados de backup do etcd estão presentes no servidor primário no seguinte local: /mnt/backup/backup/<etcdBackupPath>/<node-name>/snapshots
   • etcdBackupPath - este é o mesmo que o especificado em backup.json enquanto habilita o backup node-name;
   • node-name- o nome do host da VM do servidor primário.

Limpeza de cluster

1. Copie e execute o script dedicado para desinstalar tudo desse nó. Faça isso para todos os nós. Para mais detalhes, consulte Solução de problemas.
2. Restaure todos os bancos de dados UiPath para o backup mais antigo que foi criado antes da atualização.

Restaure a infra em nós de servidor

1. Conecte-se ao servidor primário (que é o mesmo escolhido durante a atualização).
2. Restaure a infra executando o seguinte comando:

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r --accept-license-agreement --install-type online

3. Conecte-se ao restante dos nós do servidor, um por um, via SSH.
4. Restaure a infra nesses nós executando o seguinte comando:

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r -j server --accept-license-agreement --install-type online

   Observação: execute este comando nos nós do servidor, um por um. A execução em paralelo não é suportada.

Restaurar infra em nós de agente

1. Conecte-se a cada VM de agente via SSH.
2. Restaure a infra nesses nós executando o seguinte comando:

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r -j agent --accept-license-agreement --install-type online

Restaure os dados de volumes

1. Conecte-se ao servidor primário via SSH.
2. Acesse a nova pasta do instalador.
   Observação: os comandos anteriores de restauração de infraestrutura foram executados usando o instalador mais antigo e os comandos a seguir são executados usando o pacote do instalador mais recente.
3. Desative o modo de manutenção no cluster executando o seguinte comando:

   /path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode

4. Verifique se o modo de manutenção está desabilitado executando o seguinte comando:

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

5. Copie o restore.jsonfileque foi usado no estágio de restauração de infra para a nova pasta do pacote do instalador.
6. Restaure volumes do mais novo pacote do instalador executando o seguinte comando:

   /path/to/new-installer/install-uipath.sh -i /path/to/new-installer/restore.json -o /path/to/new-installer/output.json -r --volume-restore --accept-license-agreement --install-type online

7. Quando a restauração estiver concluída, verifique se tudo está restaurado e funcionando corretamente.
8. Durante a atualização, os backups agendados foram desabilitados no nó primário. Para habilitá-los novamente, execute o seguinte comando:

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups