- 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
- Guia básico de solução de problemas
Offline upgrade
/opt/UiPathAutomationSuite
em todos os nós. Se não tiver espaço suficiente, você pode aumentar a capacidade dessa pasta ou remover todos os arquivos de instalador anteriores, exceto para cluster_config.json
. Sempre é possível baixar o instalador anterior novamente.
df -h /opt/UiPathAutomationSuite
.
Para se preparar para a atualização, siga as seguintes etapas:
- Identifique o nó servidor (não agente) que tem o disco
UiPath bundle
adicional conectado no ponto de montagem/uipath
. Esse nó é chamado de nó servidor primário em todo o documento. No caso do perfil de avaliação de nó único, no qual existe apenas um nó servidor, faça login nesse nó.Observação: execute as seguintes etapas em todos os nós no cluster. Comece com os nós servidores e continue com os nós agentes. - Conecte-se a um nó usando SSH.
- Torne-se o usuário raiz:
sudo su -
sudo su - - Crie uma pasta de instalação no diretório
/opt/UiPathAutomationSuite
:<h1>Please replace {version} with installer version mkdir -p /opt/UiPathAutomationSuite/{version}/installer</h1>
<h1>Please replace {version} with installer version mkdir -p /opt/UiPathAutomationSuite/{version}/installer</h1> - Baixe
sf-installer.zip
e copie-o para/opt/UiPathAutomationSuite/{version}/installer
. Para obter instruções de download, consulte o sf-installer.zip.cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer
cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer - Baixe
sf-infra.tar.gz
e copie-o para/opt/UiPathAutomationSuite/{version}
. Para obter instruções de download, consulte sf-infra.tar.gz:cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/{version}
cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/{version} - (Apenas no nó servidor primário).
Baixe
sf.tar.gz
e copie para/uipath/{version}
. Para baixar instruções, consulte sf.tar.gz:cp /path/to/sf.tar.gz /uipath/{version}
cp /path/to/sf.tar.gz /uipath/{version} - Descompacte
sf-installer.zip
:cd /opt/UiPathAutomationSuite/{version}/installer unzip sf-installer.zip -d .
cd /opt/UiPathAutomationSuite/{version}/installer unzip sf-installer.zip -d . - Forneça as permissões necessárias ao instalador:
chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer
chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer - Gere o último
cluster_config.json
no primeiro nó de servidor e copie-o para o restante dos nós. Para obter detalhes sobre como configurar os parâmetroscluster_config.json
, consulte Como usar o arquivo de configuração.
- Se você tiver o antigo
cluster_config.json
, gere o arquivo de configuração do cluster executando:cd /opt/UiPathAutomationSuite/{version}/installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json
cd /opt/UiPathAutomationSuite/{version}/installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json - Se você não tiver o arquivo
cluster_config.json
antigo, gere uma substituição de algum valor padrão que você pode ter feito no momento da instalação da versão anterior:cd /opt/UiPathAutomationSuite/{version}/installer ./configureUiPathAS.sh config get -o ./cluster_config.json
cd /opt/UiPathAutomationSuite/{version}/installer ./configureUiPathAS.sh config get -o ./cluster_config.json
- Open the
cluster_config.json
with your editor (for example, vi).vi /opt/UiPathAutomationSuite/{version}/installer/cluster_config.json
vi /opt/UiPathAutomationSuite/{version}/installer/cluster_config.json - Substitua o seguinte bloco:
"aicenter": { "enabled": "false" },
"aicenter": { "enabled": "false" },Observação: o Document Understanding é habilitado por padrão se o AI Center estiver habilitado. - Com as informações a seguir (substitua as informações entre
<>
pelos seus valores):"aicenter": { "orchestrator_url":"<a href="https://orchestrator-url.com">https://orchestrator-url.com</a>", "identity_server_url": "<a href="https://orchestrator-url.com/identity">https://orchestrator-url.com/identity</a>", "orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>", "identity_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>", "identity_access_token": "<placeholder will be replaced later>", },
"aicenter": { "orchestrator_url":"<a href="https://orchestrator-url.com">https://orchestrator-url.com</a>", "identity_server_url": "<a href="https://orchestrator-url.com/identity">https://orchestrator-url.com/identity</a>", "orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>", "identity_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>", "identity_access_token": "<placeholder will be replaced later>", },
Para configurar o backup, execute as seguintes etapas:
- Certifique-se de que você habilitou o backup no cluster. Você deve criar o backup usando a mesma versão do instalador usada para a implantação atual. Para obter instruções, consulte a documentação de backup e restauração correspondente à versão do UiPath AI Center da qual planeja atualizar.
- Conecte-se a um dos nós do servidor via SSH.
- Para verificar se todos os volumes desejados têm backups no cluster, execute:
/path/to/old-installer/configureUiPathAS.sh verify-volumes-backup
/path/to/old-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.
Após a criação do backup, continue com as próximas etapas.
Putting the cluster in maintenance mode will shut down the ingress controller and all the UiPath services, blocking all the incoming traffic to the AI Center cluster.
- Para colocar o cluster no modo de manutenção, execute:
cd /opt/UiPathAutomationSuite/{version}/installer ./configureUiPathAS.sh enable-maintenance-mode
cd /opt/UiPathAutomationSuite/{version}/installer ./configureUiPathAS.sh enable-maintenance-mode - Para verificar se o cluster está no modo de manutenção, execute:
./configureUiPathAS.sh is-maintenance-enabled
./configureUiPathAS.sh is-maintenance-enabledAviso: crie um backup do seu SQL Server após habilitar o modo de manutenção para que nenhuma transação adicional seja registrada no seu banco de dados do SQL.
Você não pode executar essa etapa em vários nós ao mesmo tempo; é necessário aguardar o término da atualização em cada nó antes de passar para o próximo.
- Faça login em cada nó em que queira realizar a atualização de infraestrutura.
- Torne-se root executando
sudo su -
. - Certifique-se de que
rke service
está habilitado nos nós servidores e agentes.Se o serviço estiver desativado, habilite ele com o comando a seguir:
- Para nós de servidor
[[ $(systemctl is-enabled rke2-server.service) != "enabled" ]] && systemctl enable rke2-server.service
[[ $(systemctl is-enabled rke2-server.service) != "enabled" ]] && systemctl enable rke2-server.service - Para os nós agentes:
[[ $(systemctl is-enabled rke2-agent.service) != "enabled" ]] && systemctl enable rke2-agent.service
[[ $(systemctl is-enabled rke2-agent.service) != "enabled" ]] && systemctl enable rke2-agent.service
- Para nós de servidor
- Para iniciar a atualização, execute o comando a seguir:
Aviso: certifique-se de ter atualizado o
cluster_config.json
gerado conforme descrito nas etapas de preparação.replace {version} with the version you are upgrading to cd /opt/UiPathAutomationSuite/{version}/installer /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
replace {version} with the version you are upgrading to cd /opt/UiPathAutomationSuite/{version}/installer /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.jsonImportante: se encontrar um erro, siga as instruções em Downgrade do Ceph da versão 16.2.6 para a 15.2.9.
Esta etapa atualiza os componentes de malha e serviço em execução com o cluster. É necessário seguir essas etapas apenas no nó servidor primário.
- Conecte-se a qualquer nó de servidor.
- Torne-se root executando
sudo su -
. - Execute o seguinte comando:
replace {version} with the version you are upgrading to in both the commands cd /opt/UiPathAutomationSuite/{version}/installer /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
replace {version} with the version you are upgrading to in both the commands cd /opt/UiPathAutomationSuite/{version}/installer /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.jsonAviso: após o término da atualização, o modo de manutenção será desativado automaticamente.
Antes de iniciar a atualização do cluster, o script de atualização cria automaticamente um backup do cluster e o desabilita temporariamente. Pode ser do seu interesse habilitar o backup manualmente após o término da atualização.
replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh resume-scheduled-backups
replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh resume-scheduled-backups