- Introdução
- Requisitos de rede
- Requisitos e instalação de um nó
- Requisitos e instalação de vários nós
- Pós-instalação
- Acesso ao AI Center
- Provisionamento de um tenant do AI Center
- Atualização dos certificados do Orchestrator e do Identity Server
- Redimensionamento de PVC
- Adição de um novo nó ao cluster
- Instalação offline de pacotes de ML
- Configuração do cluster
- Configuração da pós-instalação do FQDN
- Backup e restauração do cluster
- Uso da pilha de monitoramento
- Configuração de uma autenticação do Kerberos
- Provisionamento de uma GPU
- Uso do arquivo de configuração
- Agendamento de nós
- Migração e atualização
- Migração para o ambiente autônomo ou do Automation Suite
- Atualizar o AI Center
- Guia básico de solução de problemas
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.
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 |
- Certifique-se de que haja espaço em disco suficiente no nó.
- Baixe e descompacte o novo instalador (
installer.zip
) no servidor. - Disponibilize o
cluster_config.json
arquivo original no servidor. - Gere o novo
cluster_config.json
arquivo 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.json
arquivo antigo, execute o seguinte comando:
cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json
cluster_config.json
, consulte Como usar o arquivo de configuração.
Manutenção e backup
- Certifique-se de que você habilitou o backup no cluster. Para detalhes, consulte Backup e restauração do cluster.
- Conecte-se ao nó do servidor via SSH.
- Verifique se todos os volumes desejados têm backups no cluster executando o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh verify-volumes-backup
/path/to/new-installer/configureUiPathAS.sh verify-volumes-backupObservação: o backup pode levar algum tempo, portanto, aguarde aproximadamente 15 a 20 minutos e verifique novamente o backup dos volumes. - Coloque o cluster no modo de manutenção da seguinte forma:
- Execute o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode
- Verifique se o cluster está no modo de manutenção executando o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled
- Faça backup de um banco de dados SQL.
Atualize a infraestrutura e serviços em servidores
- Conecte-se ao servidor via SSH.
- Torne-se root executando
sudo su -
. - 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.
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": [] }
{ "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": [] } - 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
/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 - 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
/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 - 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
/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.jsonObservaçã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. - 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
/path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups
Preparação
- Crie uma pasta separada para armazenar pacotes mais antigos e execute as seguintes operações dentro dessa pasta.
- Baixe e descompacte o instalador da versão mais antiga (
installer.zip
) no nó.Observação: dê permissões adequadas para a pasta executandosudo chmod 755 -R <installer-folder>
. - Crie um arquivo
restore.json
e copie-o para todos os nós. Para detalhes, consulte Backup e restauração do cluster. - 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 embackup.json
enquanto habilita o backupnode-name
;node-name
- o nome do host da VM do servidor primário.
Limpeza de cluster
- 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.
- Restaure todos os bancos de dados UiPath para o backup criado antes da atualização.
Restaure a infra em nós de servidor
- Conecte-se ao servidor via SSH.
- 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
/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
- Conecte-se ao servidor via SSH.
- 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.
- Desative o modo de manutenção no cluster executando o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode
/path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode - Verifique se o modo de manutenção está desabilitado executando o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled
/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled - Copie o arquivo
restore.json
que foi usado no estágio de restauração de infra para a nova pasta do pacote do instalador. - 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
/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 - Quando a restauração estiver concluída, verifique se tudo está restaurado e funcionando corretamente.
- 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
/path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups
- Certifique-se de que haja espaço em disco suficiente no nó.
- Baixe o pacote offline completo (
sf.tar.gz
) no servidor escolhido. - Baixe e descompacte o novo instalador (
installer.zip
) no servidor primário.Observação: dê permissões adequadas para a pasta executandosudo chmod 755 -R <installer-folder>
. - Disponibilize o
cluster_config.json
arquivo original no servidor. - Gere o novo
cluster_config.json
arquivo 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.
- Se você tem o antigo
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
Manutenção e backup
- Certifique-se de que você habilitou o backup no cluster.
- Conecte-se ao nó do servidor via SSH.
- Verifique se todos os volumes têm backups no cluster executando o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh verify-volumes-backup
/path/to/new-installer/configureUiPathAS.sh verify-volumes-backupObservação: o backup pode levar algum tempo, portanto, aguarde aproximadamente 15 a 20 minutos e verifique novamente o backup dos volumes. - Coloque o cluster no modo de manutenção da seguinte forma:
- Execute o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode
- Verifique se o cluster está no modo de manutenção executando o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled
- Crie o backup do banco de dados SQL.
Atualize a infraestrutura e serviços em servidores
- Conecte-se ao servidor via SSH.
- Torne-se root executando
sudo su -
. - 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.
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": [] }
{ "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": [] } - 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
/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 - 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
/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 - 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
/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.jsonObservaçã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. -
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
/path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups
Preparação
- Crie uma pasta separada para armazenar pacotes antigos e execute as seguintes operações dentro dessa pasta.
- Baixe o pacote off-line somente infra (
sf-infra-bundle.tar.gz
) correspondente à versão antiga em todos os nós. - 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 executandosudo chmod 755 -R <installer-folder>
. - Crie um arquivo
restore.json
e copie-o para todos os nós. Para detalhes, consulte Backup e restauração do cluster. - 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 embackup.json
enquanto habilita o backupnode-name
;node-name
- o nome do host da VM do servidor primário.
Limpeza de cluster
- 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.
- 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
- Conecte-se ao nó do servidor.
- 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
/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
- Conecte-se ao servidor via SSH.
- 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.
- Desative o modo de manutenção no cluster executando o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode
/path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode - Verifique se o modo de manutenção está desabilitado executando o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled
/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled - Copie o arquivo
restore.json
que foi usado no estágio de restauração de infra para a nova pasta do pacote do instalador. - 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
/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 - Quando a restauração estiver concluída, verifique se tudo está restaurado e funcionando corretamente.
- 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
/path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups
- 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>
<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> - Baixe e descompacte o novo instalador (
installer.zip
) em todos os nós.Observação: dê permissões adequadas para a pasta executandosudo chmod 755 -R <installer-folder>
. - Disponibilize o arquivo
cluster_config.json
original no servidor primário. - Gere o novo
cluster_config.json
arquivo 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:
- Se você tem o antigo arquivo
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
cluster_config.json
para a pasta do instalador em todos os nós.
Manutenção e backup
- Certifique-se de que você habilitou o backup no cluster.
- Conecte-se a um dos nós do servidor via SSH.
- 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. - Coloque o cluster no modo de manutenção da seguinte forma:
- Execute o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode
- Verifique se o cluster está no modo de manutenção executando o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled
- Crie o backup do banco de dados SQL.
Atualize a infraestrutura nos servidores
- Conecte-se a cada servidor via SSH.
- Torne-se root executando
sudo su -
. - 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
/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.
Atualize a infraestrutura nos agentes
- Conecte-se a cada servidor via SSH.
- Torne-se root executando
sudo su -
. - 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
/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
- Conecte-se ao servidor primário via SSH.
- Torne-se root executando
sudo su -
. - 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.
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": [] }
{ "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": [] } - 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
/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 - 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
/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.jsonObservaçã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. - 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
/path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups
Preparação
- Crie uma pasta separada para armazenar os pacotes antigos e execute as seguintes operações dentro dessa pasta.
- 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 executandosudo chmod 755 -R <installer-folder>
. - Crie o arquivo
restore.json
e copie-o para todos os nós. - 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 embackup.json
enquanto habilita o backupnode-name
;
node-name
- o nome do host da VM do servidor primário.
Limpeza de cluster
- 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.
- 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
- Conecte-se ao servidor primário. Este deve ser o mesmo nó do servidor que você selecionou durante a atualização.
- 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
/path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r --accept-license-agreement --install-type online - Conecte-se ao restante dos nós do servidor, um por um, via SSH.
- 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
/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
- Conecte-se a cada VM de agente via SSH.
- 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
/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
- Conecte-se ao servidor primário via SSH.
- 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.
- Desative o modo de manutenção no cluster executando o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode
/path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode - Verifique se o modo de manutenção está desabilitado executando o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled
/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled - Copie o arquivo
restore.json
que foi usado no estágio de restauração de infra para a nova pasta do pacote do instalador. - 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
/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 - Quando a restauração estiver concluída, verifique se tudo está restaurado e funcionando corretamente.
- 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
/path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups
- 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>
<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> - Baixe o pacote offline completo (
sf.tar.gz
) no servidor selecionado. - Baixe o pacote off-line somente infra (
sf-infra.tar.gz
) em todos os outros nós. - Baixe e descompacte o novo instalador (
installer.zip
) em todos os nós.Observação: dê permissões adequadas para a pasta executandosudo chmod 755 -R <installer-folder>
. - Disponibilize o
cluster_config.json
original no servidor primário. - Gere o novo
cluster_config.json
arquivo 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 config
arquivo antigo, execute o seguinte comando:cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json
- Se você tiver o antigo arquivo ``cluster_config.json`, use o seguinte comando para gerar o arquivo de configuração do cluster:
- Copie
cluster_config.json
para a pasta do instalador em todos os nós.
Manutenção e backup
- Certifique-se de que você habilitou o backup no cluster.
- Conecte-se a um dos nós do servidor via SSH.
- Verifique se todos os volumes desejados têm backups no cluster executando o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh verify-volumes-backup
/path/to/new-installer/configureUiPathAS.sh verify-volumes-backupObservação: o backup pode levar algum tempo, portanto, aguarde aproximadamente 15 a 20 minutos e verifique novamente o backup dos volumes. - Coloque o cluster no modo de manutenção da seguinte forma:
- Execute o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode
- Verifique se o cluster está no modo de manutenção executando o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled
- Crie o backup do banco de dados SQL.
Atualize a infraestrutura nos servidores
- Conecte-se a cada servidor via SSH.
- Torne-se root executando
sudo su -
. - 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
/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.jsonObservação: esse comando também cria um backup do estado do cluster e pausa todos os outros backups agendados.
Atualize a infraestrutura nos agentes
- Conecte-se a cada servidor via SSH.
- Torne-se root executando
sudo su -
. - 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
/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
- Conecte-se ao servidor primário via SSH.
- Torne-se root executando
sudo su -
. - 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.
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": [] }
{ "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": [] } - 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
/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 - 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
/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.jsonObservaçã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. - 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
/path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups
Preparação
- Crie uma pasta separada para armazenar os pacotes antigos e execute as seguintes operações dentro dessa pasta.
- 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 executandosudo chmod 755 -R <installer-folder>
. - Crie o arquivo
restore.json
e copie-o para todos os nós. - 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 embackup.json
enquanto habilita o backupnode-name
;node-name
- o nome do host da VM do servidor primário.
Limpeza de cluster
- 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.
- 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
- Conecte-se ao servidor primário (que é o mesmo escolhido durante a atualização).
- 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
/path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r --accept-license-agreement --install-type online - Conecte-se ao restante dos nós do servidor, um por um, via SSH.
- 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
/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 onlineObservaçã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
- Conecte-se a cada VM de agente via SSH.
- 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
/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
- Conecte-se ao servidor primário via SSH.
- 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.
- Desative o modo de manutenção no cluster executando o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode
/path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode - Verifique se o modo de manutenção está desabilitado executando o seguinte comando:
/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled
/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled - Copie o
restore.jsonfile
que foi usado no estágio de restauração de infra para a nova pasta do pacote do instalador. - 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
/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 - Quando a restauração estiver concluída, verifique se tudo está restaurado e funcionando corretamente.
- 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
/path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups
Para obter mais informações sobre como fazer downgrade do Ceph, consulte Downgrade Ceph de 16.2.6 para 15.2.9 no guia Automation Suite .
- Modo online de avaliação de nó único
- Preparação
- Execução
- Reverter erro
- Modo offline de avaliação de nó único
- Preparação
- Execução
- Reverter erro
- Modo de produção online pronto para alta disponibilidade de vários nós
- Preparação
- Execução
- Reverter erro
- Modo de produção offline pronto para alta disponibilidade de vários nós
- Preparação
- Execução
- Reverter erro
- Fazendo downgrade do Ceph de 16.2.6 para 15.2.9