Modo de produção online 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 online.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 e descompacte o novo instalador (installer.zip) em todos os nós.

   Observação:

   Dê as permissões adequadas para a pasta executando sudo chmod 755 -R <installer-folder>.

3. Disponibilize o arquivo cluster_config.json original no servidor primário.

4. Gere o novo cluster_config.jsonarquivo como descrito a seguir:

   • Se você tem 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 tiver o arquivo de configuração antigo, execute o seguinte comando:

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

     Observação:

     See Advanced installation experience to fill up the remaining parameters.

5. Copie cluster_config.json para a pasta do instalador em todos os nós.

Execução

Manutenção e backup

1. Make sure you have enabled the backup on the cluster. For details, see Enabling the cluster backup.

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/new-installer/configureUiPathAS.sh verify-volumes-backup.

   Observação:

   O backup pode levar algum tempo, portanto, aguarde aproximadamente 15 a 20 minutos e verifique o backup dos volumes novamente.

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

1. Conecte-se a cada servidor via SSH.

2. Torne-se root executando sudo su -.

3. Execute o seguinte comando em todos os servidores:

   /path/to/new-installer/install-uipath.sh --upgrade -k -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json
   

Como parte desse comando, também fazemos o backup do estado do cluster e pausamos todos os outros backups agendados.

Observação:

Este comando também cria um backup do estado do cluster e pausa todos os outros backups agendados.

Atualize a infraestrutura nos agentes

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 --accept-license-agreement -o /path/to/output.json
   

Execute Rest of the Upgrade on the Primary Server

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

Rollback on Error

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 o instalador da versão antiga ( installer.zip) em todos os nós.

   Observação:

   Dê as permissões adequadas para a pasta executando sudo chmod 755 -R <installer-folder>.

3. Create the restore.json file and copy it to all the nodes. For details, see Backing up and restoring the cluster.

4. Verifique se os dados de backup do etcd estão presentes no nó 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. Copy and run the dedicated script to uninstall everything from that node. Do this for all the nodes. For details, see Troubleshooting.
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. Este deve ser o mesmo nó do servidor que você selecionou 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 comando a seguir nos nós do servidor, um por um. A execução em paralelo não é suportada.

   /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
   

Restore Infra on Agent Nodes

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
   

Restore Volumes Data

1. Conecte-se ao servidor primário via SSH.

2. Vá para a pasta do instalador mais recente.

   Observação:

   Os comandos anteriores de restauração de infra foram executados usando o instalador antigo e os comandos a seguir são executados usando o novo pacote do instalador.

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 arquivo restore.json que foi usado no estágio de restauração de infra para a nova pasta do pacote do instalador.

6. Execute a restauração de volumes do 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