ai-center
2022.4
true
- 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
Procedimento
Guia de instalação do AI Center
Última atualização 6 de jun de 2024
Procedimento
Esta etapa precisa ser executada em uma máquina com acesso à internet e acesso às máquinas no ambiente isolado, onde o UiPath AI Center será instalado.
Observação: esta máquina pode ser Linux ou Windows. As etapas fornecidas para serem executadas nesta máquina. Em todo este documento, existem exemplos destinados ao sistema operacional baseado em RHEL. Para Windows ou outras versões do sistema operacional, ajuste para etapas equivalentes específicas desses ambientes.
Siga as etapas abaixo na máquina separada com acesso à Internet para obter os arquivos necessários para iniciar o processo de instalação:
- Conecte-se a uma máquina com acesso à Internet e execute o seguinte comando para obter o arquivo do assistente interativo:
ssh <user>@<dns_of_vm>
ssh <user>@<dns_of_vm> - Se você usou uma chave ssh, execute o seguinte comando:
ssh -i <path/to/Key.pem> <user>@<dns_of_vm>
ssh -i <path/to/Key.pem> <user>@<dns_of_vm> - Baixe os seguintes pacotes:
installUiPathAS.sh
— obrigatório. Consulte installUiPath.as para obter instruções de download.sf-installer.zip
— obrigatório. Consulte sf-installer.zip para obter instruções de download.sf.tar.gz
— obrigatório. Consulte sf-infra.tar.gz para obter instruções de download.sf-infra.tar.gz
- Opcional. Necessário apenas se você deseja ingressar nós adicionais, incluindo Task Mining e GPU. Consulte sf-infra.tar.gz para obter instruções de download.du-ondemand.tar.gz
- Opcional. Necessário apenas para Document Understanding.Consulte du-ondemand.tar.gz para obter instruções de download.Observação: não seguir esta etapa opcional limita a funcionalidade dos serviços do Document Understanding.cv-ondemand.tar.gz
– Opcional. Necessário apenas para o Computer Vision. Consulte cv-ondemand.tar.gz para obter instruções de download.Observação: não seguir esta etapa opcional impede o acesso aos serviços do Computer Vision.
Certifique-se de baixar o pacote adequado para sua versão do Automation Suite e seu sistema operacional.
Certifique-se de executar as seguintes etapas:
- Verifique se todos os arquivos foram baixados na máquina com acesso à internet.
- Crie a pasta de destino na máquina.
- Copie os arquivos da máquina online para a máquina de destino.
Crie a pasta de instalação na máquina principal do cluster executando o seguinte comando:
sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 755 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp
sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 755 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp
Na máquina separada com acesso à Internet, copie os arquivos para o primeiro nó:
- Na máquina com acesso à internet, copie os arquivos para a pasta de instalação na máquina de destino e o(s) pacote(s) offline para a pasta
/uipath/tmp
.scp ~/installUiPathAS.sh ~/sf-installer.zip <username>@<node dns>:/uipath/tmp scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/
scp ~/installUiPathAS.sh ~/sf-installer.zip <username>@<node dns>:/uipath/tmp scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/ - (Opcional) Para usar o Document Understanding, copie os seguintes pacotes para a pasta
/uipath/tmp
.scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/Observação: não seguir esta etapa opcional impede o acesso aos serviços do Document Understanding. - (Opcional) Para usar o Computer Vision, copie o seguinte pacote para a pasta
/uipath/tmp
.scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/Observação: não seguir esta etapa opcional impede o acesso aos serviços do Computer Vision.
Observação: no caso de certificados em cadeia, verifique a seção Certificados em cadeia sobre como fornecer certificados corretamente.
Baixe e salve certificado do Orchestrator na sua máquina local. Você pode fazer isso usando um navegador ou pode pedir ao seu departamento de TI para fornecer o certificado. Os certificados devem ter o formato base64 e
.cer
. Copie o certificado para a máquina virtual usando o comando abaixo.
scp /path/to/orch.cer <username>@<node dns>:/opt/UiPathAutomationSuite
scp /path/to/orch.cer <username>@<node dns>:/opt/UiPathAutomationSuite
Ao usar um certificado emitido pelo domínio, certifique-se de exportar o certificado raiz da seguinte maneira:
- Abra o certificado, acesse a aba Caminho de certificação e selecione o primeiro certificado. Clique em Exibir certificado.
- Depois que o certificado raiz for exibido, acesse a aba Detalhes e clique em Copiar para arquivo.
- Certifique-se de selecionar o formato do arquivo base64
cer
. - Salve-o com o nome de sua escolha e depois envie-o para a máquina do AI Center.
O arquivo resultante deve ser semelhante ao exemplo abaixo.
-----BEGIN CERTIFICATE-----
certificate
base64
encoded
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
certificate
base64
encoded
-----END CERTIFICATE-----
- Adicione os seguintes pré-requisitos ao PATH atual:
- O instalador interativo requer
jq
e nossos pacotes off-line já o incluem. Execute os seguintes comandos para adicioná-lo ao CAMINHO: (certifique-se de que você ainda seja raiz)mv /uipath/tmp/installUiPathAS.sh /uipath/tmp/sf-installer.zip /opt/UiPathAutomationSuite cd /opt/UiPathAutomationSuite unzip ./sf-installer.zip -d . chmod +x ./bin/jq export PATH=${PATH}:/opt/UiPathAutomationSuite/bin
mv /uipath/tmp/installUiPathAS.sh /uipath/tmp/sf-installer.zip /opt/UiPathAutomationSuite cd /opt/UiPathAutomationSuite unzip ./sf-installer.zip -d . chmod +x ./bin/jq export PATH=${PATH}:/opt/UiPathAutomationSuite/bin
- O instalador interativo requer
- Forneça permissões para a pasta do instalador:
- É necessário fornecer as permissões adequadas à pasta
/opt/UiPathAutomationSuite
, na qual os scripts de instalação são colocados e serão executados. O instalador também criará alguns arquivos (output.json
) após a execução de cada etapa.Execute o seguinte comando para fornecer as permissões:
chmod -R 755 /opt/UiPathAutomationSuite
chmod -R 755 /opt/UiPathAutomationSuite
- É necessário fornecer as permissões adequadas à pasta
- Execute o assistente interativo para configurar as opções de instalação:
- O assistente interativo orientará as etapas de configuração e gerará o arquivo de configuração que pode ser personalizado e usado nas etapas de instalação restantes.
- Execute o script para iniciar o assistente interativo executando o comando a seguir:
chmod +x ./installUiPathAS.sh ./installUiPathAS.sh
chmod +x ./installUiPathAS.sh ./installUiPathAS.sh - Siga as etapas no assistente
Observação: certifique-se de não iniciar a instalação a partir do script e de sair dele quando o arquivo de configuração for gerado; caso contrário, ele tentará instalar o Automation Suite completo. Esse script é usado principalmente para o Automation Suite, e as informações exibidas (produtos, requisitos) são relativas ao Automation Suite. O arquivo de configuração será adaptado às nossas necessidades nas próximas etapas do procedimento.
Siga as etapas de configuração de implantação:
- Aceite o contrato de licença.
- Selecione o modo de implantação: selecione a opção de Implantação de nó único.
- Selecione continuar.
- Selecione a instalação isolada.
- Insira o nome de host do DNS.
- Especifique se você deseja usar a autenticação do Kerberos para conexões SQL.
- Insira o URL do SQL Server. Siga o prompt para inserir a porta de conexão, nome de usuário e senha.
- Especifique se você deseja que o instalador crie automaticamente os bancos de dados necessários.
O arquivo de configuração do cluster será gerado com uma pasta, conforme mostrado na imagem a seguir.
Observação: assim que você gerar o arquivo de configuração e a pasta, você poderá sair do assistente e prosseguir com as etapas restantes abaixo para concluir a instalação. Você pode ignorar a lista de produtos porque a atualizaremos nas etapas seguintes.
Uma primeira versão do arquivo
cluster_config.json
é gerada. Atualizaremos esse arquivo com a finalidade de instalação do AI Center.
Abra o arquivo com seu editor (por exemplo, vi):
vi /opt/UiPathAutomationSuite/cluster_config.json
vi /opt/UiPathAutomationSuite/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": {
"enabled": "true",
"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": {
"enabled": "true",
"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>"
},
Você pode encontrar o arquivo
cluster_config.json
na pasta UiPathAutomationSuite
. Você pode usar esse arquivo para configurar seus bancos de dados SQL e suas respectivas strings de conexão e certificados. Você também pode habilitar as configurações de proxy se usar um proxy para conexão com a internet.
Para instalação de nó único, observe que você não pode habilitar a alta disponibilidade.
Para configuração avançada, consulte Como usar o arquivo de configuração.
- Execute o instalador da infraestrutura.
Acesse a pasta
UiPath_Installer
e execute o instalador de infraestrutura com a flag do AI Center independente./opt/UiPathAutomationSuite ./install-uipath.sh -i cluster_config.json -o output.json --offline-bundle "/uipath/tmp/sf.tar.gz" --offline-tmp-folder /uipath/tmp --accept-license-agreement --install-offline-prereqs --install-standalone-aicenter -k
/opt/UiPathAutomationSuite ./install-uipath.sh -i cluster_config.json -o output.json --offline-bundle "/uipath/tmp/sf.tar.gz" --offline-tmp-folder /uipath/tmp --accept-license-agreement --install-offline-prereqs --install-standalone-aicenter -k - Instale o fabric (componentes de software).
Execute o instalador com a sinalização independente do AI Center.
./install-uipath.sh -i cluster_config.json -o output.json --offline-bundle "/uipath/tmp/sf.tar.gz" --offline-tmp-folder /uipath/tmp --accept-license-agreement --install-offline-prereqs --install-standalone-aicenter -f
./install-uipath.sh -i cluster_config.json -o output.json --offline-bundle "/uipath/tmp/sf.tar.gz" --offline-tmp-folder /uipath/tmp --accept-license-agreement --install-offline-prereqs --install-standalone-aicenter -f - Execute o instalador do software.
Primeiro, você precisa se conectar ao Identity Server e recuperar um token de instalação. Em seguida, copie esse token e cole-o no espaço reservado que tínhamos na etapa 3.2. (no arquivo cluster_config.json). Depois que o token estiver lá, você poderá executar a instalação do AI Center.
./install-uipath.sh -i cluster_config.json -o output.json --offline-bundle /uipath/tmp/sf.tar.gz --accept-license-agreement --install-standalone-aicenter --offline-tmp-folder /uipath/tmp -s
./install-uipath.sh -i cluster_config.json -o output.json --offline-bundle /uipath/tmp/sf.tar.gz --accept-license-agreement --install-standalone-aicenter --offline-tmp-folder /uipath/tmp -s - Carregue os comandos opcionais de pacotes do Document Understanding.
Para carregar os pacotes opcionais do Document Understanding, execute o seguinte comando. Certifique-se de usar o nome do pacote que você precisa carregar.
./install-uipath.sh -i ./cluster_config.json -o ./output.json /configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" --accept-license-agreement
./install-uipath.sh -i ./cluster_config.json -o ./output.json /configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" --accept-license-agreement - Carregue os comandos de pacotes do Computer Vision opcionais.
Para carregar o pacote opcional do Computer Vision, execute o seguinte comando:
./install-uipath.sh -i ./cluster_config.json -o ./output.json /configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" --accept-license-agreement
./install-uipath.sh -i ./cluster_config.json -o ./output.json /configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" --accept-license-agreement
- Etapa 1: baixar o script de instalação
- 1.1 Baixe o pacote de instalação
- 1.2 Obtenha todos os arquivos baixados na máquina
- Etapa 2: copiar o certificado do Orchestrator para a máquina virtual
- Certificados em cadeia
- Etapa 3: configurar a instalação
- 3.1 Use o assistente interativo para criar o arquivo base de configuração
- 3.2 Adicionar configuração específica do AI Center
- 3.3 (Opcional) Configuração avançada
- Etapa 4: executar a instalação