Atualizar o AI Center

Para atualizar o AI Center™ de uma versão secundária para outra (por exemplo, de 2021.10.1 para 2021.10.2), use os procedimentos desta página.

Observação: certifique-se de que não haja novas implantações durante a atualização.

Importante:

Se você atualizar do AI Center 2021.10.3 ou 2021.10.4 para uma versão mais recente, um downgrade do Ceph 16.2.6 para 15.2.9 será necessário para evitar corrupção de dados.

Para obter mais informações, verifique a página Downgrade do Ceph da 16.2.6 para a 15.2.9.

Modo de implantação	Instruções de atualização
Avaliação online de nó único	Modo online de avaliação de nó único
Avaliação off-line de nó único	Modo offline de avaliação de nó único
Produção online pronta para alta disponibilidade de vários nós	Modo de produção online pronto para alta disponibilidade de vários nós
Produção off-line pronta para alta disponibilidade de vários nós	Modo de produção offline pronto para alta disponibilidade

Modo online de avaliação de nó único

Preparação

1. Certifique-se de que haja espaço em disco suficiente no nó.
2. Baixe e descompacte o novo instalador (installer.zip) no servidor.
3. Disponibilize o cluster_config.jsonarquivo original no servidor.
4. Gere o novo cluster_config.jsonarquivo como descrito a seguir:

• Se você tem o antigo 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_config.jsonarquivo antigo, execute o seguinte comando:

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

Observação: para obter detalhes sobre como configurar os parâmetros cluster_config.json, consulte Como usar o arquivo de configuração.

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 ao nó 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. Coloque o cluster no modo de manutenção da seguinte forma:
5. Execute o seguinte comando:

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

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

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

7. Faça backup de um banco de dados SQL.

Atualize a infraestrutura e serviços em servidores

1. Conecte-se ao servidor via SSH.
2. Torne-se root executando sudo su -.
3. Remova a seção redis no arquivo json do patch.
   Devido a um problema conhecido no upgrade, precisamos editar manualmente o arquivo /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json. Isso foi corrigido na versão 2022.4.
   Para fazer isso, abra o arquivo usando um editor de texto e remova as linhas 22 a 25 e o final , na linha 21:

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   Após as alterações, os arquivos devem ficar como abaixo:

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. Atualize a infraestrutura e os servidores executando o seguinte comando:

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

5. Faça o upgrade da fabric executando o seguinte comando:

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

6. Execute o instalador do software usando o comando abaixo.

   Primeiro, você precisa se conectar ao Identity Server e recuperar um token de instalação. Em seguida, copie este token e cole-o no espaço reservado do arquivo cluster_config.json.

   Depois que o token estiver lá, você poderá executar a instalação do AI Center.

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -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. O comando também cria um backup do estado do cluster e pausa todos os outros backups agendados.
7. 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 pacotes mais antigos e execute as seguintes operações dentro dessa pasta.
2. Baixe e descompacte o instalador da versão mais antiga (installer.zip) no nó.
   Observação: dê permissões adequadas para a pasta executando sudo chmod 755 -R <installer-folder>.
3. Crie um 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 obter mais detalhes, consulte a seção Como desinstalar o cluster na página Solução de problemas.
2. Restaure todos os bancos de dados UiPath para o backup criado antes da atualização.

Restaure a infra em nós de servidor

1. Conecte-se ao servidor via SSH.
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

Restaure os dados de volumes

1. Conecte-se ao servidor via SSH.
2. Acesse a nova pasta do instalador.
   Observação: os comandos anteriores de restauração de infraestrutura 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. Restaure volumes executando o seguinte comando do pacote de instalação mais recente:

   /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

Modo offline de avaliação de nó único

Preparação

1. Certifique-se de que haja espaço em disco suficiente no nó.
2. Baixe o pacote offline completo (sf.tar.gz) no servidor escolhido.
3. Baixe e descompacte o novo instalador (installer.zip) no servidor primário.
   Observação: dê permissões adequadas para a pasta executando sudo chmod 755 -R <installer-folder>.
4. Disponibilize o cluster_config.jsonarquivo original no servidor.
5. Gere o novo cluster_config.jsonarquivo como descrito a seguir:
   • Se você tem o antigo 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: consulte Como usar o arquivo de configuração para preencher os parâmetros restantes.

Execução

Manutenção e backup

1. Certifique-se de que você habilitou o backup no cluster.
2. Conecte-se ao nó do servidor via SSH.
3. Verifique se todos os volumes 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. Coloque o cluster no modo de manutenção da seguinte forma:
5. Execute o seguinte comando:

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

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

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

7. Crie o backup do banco de dados SQL.

Atualize a infraestrutura e serviços em servidores

1. Conecte-se ao servidor via SSH.
2. Torne-se root executando sudo su -.
3. Remova a seção redis no arquivo json do patch.
   Devido a um problema conhecido no upgrade, precisamos editar manualmente o arquivo /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json. Isso foi corrigido na versão 2022.4.
   Para fazer isso, abra o arquivo usando um editor de texto e remova as linhas 22 a 25 e o final , na linha 21:

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   Após as alterações, os arquivos devem ficar como abaixo:

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. Atualize a infraestrutura executando o seguinte comando:

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

5. Faça o upgrade da fabric executando o seguinte comando:

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

6. Execute o instalador do software usando o comando abaixo.

   Primeiro, você precisa se conectar ao Identity Server e recuperar um token de instalação. Em seguida, copie este token e cole-o no espaço reservado do arquivo cluster_config.json.

   Depois que o token estiver lá, você poderá executar a instalação do AI Center.

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -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. Note que este comando também cria um backup do estado do cluster e pausa todos os outros backups agendados.

7. 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 pacotes antigos e execute as seguintes operações dentro dessa pasta.
2. Baixe o pacote off-line somente infra ( sf-infra-bundle.tar.gz) correspondente à versão antiga em todos os nós.
3. Baixe e descompacte o instalador da versão antiga ( installer.zip) em todos os nós.
   Observação: dê permissões adequadas para a pasta executando sudo chmod 755 -R <installer-folder>.
4. Crie um arquivo restore.json e copie-o para todos os nós. Para detalhes, consulte Backup e restauração do cluster.
5. 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ó. Para obter mais detalhes, consulte a seção Como desinstalar o cluster na página Solução de problemas.
2. Restaure todos os bancos de dados UiPath para o backup mais antigo criado antes da atualização.

Restaure a infra em nós de servidor

1. Conecte-se ao nó do servidor.
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 --offline-bundle "/path/to/older-version/sf-infra-bundle.tar.gz" --offline-tmp-folder /uipath --install-offline-prereqs --accept-license-agreement --install-type offline

Restaure os dados de volumes

1. Conecte-se ao servidor via SSH.
2. Acesse a nova pasta do instalador.
   Observação: os comandos anteriores de restauração de infraestrutura 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. Restaure 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 offline

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 neste nó. Para habilitá-los novamente, execute o seguinte comando:

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

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:

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

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

5. Copie este 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.
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 novamente o backup dos volumes.
4. Coloque o cluster no modo de manutenção da seguinte forma:
5. Execute o seguinte comando:

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

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

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

7. 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 --install-standalone-aicenter -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: esse 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 --install-standalone-aicenter -k -i /path/to/cluster_config.json --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. Remova a seção redis no arquivo json do patch.
   Devido a um problema conhecido no upgrade, precisamos editar manualmente o arquivo /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json. Isso foi corrigido na versão 2022.4.
   Para fazer isso, abra o arquivo usando um editor de texto e remova as linhas 22 a 25 e o final , na linha 21:

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   Após as alterações, os arquivos devem ficar como abaixo:

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. Faça o upgrade da fabric executando o seguinte comando:

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

5. Execute o instalador do software usando o comando abaixo.

   Primeiro, você precisa se conectar ao Identity Server e recuperar um token de instalação. Em seguida, copie este token e cole-o no espaço reservado do arquivo cluster_config.json.

   Depois que o token estiver lá, você poderá executar a instalação do AI Center.

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -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.
6. 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 o instalador da versão antiga ( 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.
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;
5. 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 obter mais detalhes, consulte a seção Como desinstalar o cluster na página 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. 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

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. Vá para a pasta do instalador mais recente.
   Observação: os comandos anteriores de restauração de infraestrutura 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

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:

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

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

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.
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. Coloque o cluster no modo de manutenção da seguinte forma:
5. Execute o seguinte comando:

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

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

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

7. 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 nós do servidor:

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

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 --install-standalone-aicenter -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. Remova a seção redis no arquivo json do patch.
   Devido a um problema conhecido no upgrade, precisamos editar manualmente o arquivo /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json. Isso foi corrigido na versão 2022.4.
   Para fazer isso, abra o arquivo usando um editor de texto e remova as linhas 22 a 25 e o final , na linha 21:

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   Após as alterações, os arquivos devem ficar como abaixo:

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. Faça o upgrade da fabric executando o seguinte comando:

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

5. Execute o instalador do software usando o comando abaixo.

   Primeiro, você precisa se conectar ao Identity Server e recuperar um token de instalação. Em seguida, copie este token e cole-o no espaço reservado do arquivo cluster_config.json.

   Depois que o token estiver lá, você poderá executar a instalação do AI Center.

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -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.
6. 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.
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 obter mais detalhes, consulte a seção Como desinstalar o cluster na página 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

Fazendo downgrade do Ceph de 16.2.6 para 15.2.9

Para obter mais informações sobre o downgrade do Ceph, consulte o tópico Fazer downgrade do Ceph da versão 16.2.6 para a 15.2.9 no guia do Automation Suite .