Procedimento

Etapa 1: baixar o script de instalação na primeira máquina

1.1 Baixe os pacotes de instalação

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:

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

2. Se você usou uma chave ssh, execute o seguinte comando:

   ssh -i <path/to/Key.pem> <user>@<dns_of_vm>

3. 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.
4. Vá para a primeira máquina de destino para instalação:
   1. Execute o seguinte comando:

      ssh <user>@<dns_of_vm>

   2. Se você usou uma chave ssh, execute o seguinte comando:

      ssh -i <path/to/Key.pem> <user>@<dns_of_vm>

Certifique-se de baixar o pacote adequado para sua versão do AI Center e seu sistema operacional.

1.2 Obtenha todos os arquivos baixados na primeira máquina

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

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 ./sf-infra.tar.gz <username>@<node dns>:/uipath/tmp/
  scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/
  scp ~/sf-infra.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/

  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/

  Observação: não seguir esta etapa opcional impede o acesso aos serviços do Computer Vision.

Etapa 2: copiar o certificado do Orchestrator para a máquina virtual

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.

Certifique-se de que /opt/UiPathAutomationSuite tenha a permissão correta para que os arquivos sejam copiados sobre scp ou copie o arquivo para o seu diretório inicial e depois mova-o para /opt/UiPathAutomationSuite.

scp /path/to/orch.cer <username>@<node dns>:/opt/UiPathAutomationSuite

Se o Identity Server for diferente do Orchestrator, repita as etapas para identityserver.cer também.

Certificados em cadeia

Ao usar um certificado emitido pelo domínio, certifique-se de exportar o certificado raiz da seguinte maneira:

1. Abra o certificado, acesse a aba Caminho de certificação e selecione o primeiro certificado. Clique em Exibir certificado.
   
   

   

   
   
2. Depois que o certificado raiz for exibido, acesse a aba Detalhes e clique em Copiar para arquivo.
   
   

   

   
   
3. Certifique-se de selecionar o formato do arquivo base64 cer.
4. 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-----

Etapa 3: configurar a instalação

Pré-requisitos

Os pré-requisitos a seguir são aplicáveis à máquina principal do cluster.

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

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

3. 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.
4. Execute o script para iniciar o assistente interativo executando o comando a seguir:

   chmod +x ./installUiPathAS.sh
   ./installUiPathAS.sh

5. Siga as etapas no assistente

3.1 Use o assistente interativo para criar o arquivo base de configuração

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.

Após iniciar o assistente de instalação, o menu principal é exibido. A partir desse menu, você precisa escolher o modo de implantação desejado: nó único ou vários nós. Você receberá detalhes sobre cada modo depois que fizer uma escolha. Depois disso, você tem a opção de continuar com a escolha atual ou voltar ao menu principal.

Siga as etapas de configuração de implantação:

1. Aceite o contrato de licença.
2. Selecione o modo de implantação: selecione a opção de Implantação de vários nós.
   
   

   

   
   
3. Selecione continuar.
4. Selecione a instalação isolada.
5. Selecione Instalação completa.
6. Insira o nome de host do DNS.
7. Especifique se você deseja usar a autenticação do Kerberos para conexões SQL.
8. Insira o URL do SQL Server. Siga o prompt para inserir a porta de conexão, nome de usuário e senha.
9. 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.

3.2 Adicionar configuração específica do AI Center

Abra o arquivo com seu editor (por exemplo, vi):

vi /opt/UiPathAutomationSuite/cluster_config.json

Substitua o seguinte bloco:

"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":"<https://orchestrator-url.com>",
  "identity_server_url": "<https://orchestrator-url.com/identity>",
  "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>"
},

3.3 (Opcional) Configuração avançada

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 configuração avançada, consulte Como usar o arquivo de configuração.

Etapa 4: copiar os arquivos de instalação em todas as outras máquinas do cluster

A partir da primeira máquina no cluster, onde a configuração foi realizada, copie toda a pasta de instalação para todas as outras máquinas:

1. Copie a pasta ~/UiPathAutomationSuite para todos os outros nós executando:

   scp -r ~/UiPathAutomationSuite <username>@<node dns>:/opt

   Observação: como estamos em um ambiente isolado, talvez você precise usar o IP privado do nó de destino.
2. Adicione -i <cert.pem> se estiver usando um certificado para fazer login. Se você copiar o conteúdo de .pem para um arquivo local, o novo arquivo precisará ter as permissões corretas. Você pode fazer chmod 400 <cert.pem> para concedê-las.

Observação: a etapa acima garante que a mesma configuração seja replicada em todas as máquinas, juntamente com todos os pacotes baixados para o conjunto de instalação.

Etapa 5: execução da instalação

1. Execute o instalador de infraestrutura em todos os nós:
   1. Configure a máquina primária executando os comandos a seguir no servidor primário:

      cd /opt/UiPathAutomationSuite
      ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicenter

   2. Conecte o resto dos servidores ao cluster executando os seguintes comandos nos nós servidores remanescentes:

      mv /uipath/tmp/UiPathAutomationSuite /opt
      cd /opt/UiPathAutomationSuite
      sudo chmod -R 755 /opt/UiPathAutomationSuite
      sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j server --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicenter

   3. Junte o restante dos agentes ao cluster executando os seguintes comandos no restante dos nós do agente:

      mv /uipath/tmp/UiPathAutomationSuite /opt
      cd /opt/UiPathAutomationSuite
      sudo chmod -R 755 /opt/UiPathAutomationSuite
      sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j agent --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicenter

2. Execute o instalador de base no nó primário

   cd /opt/UiPathAutomationSuite
   export TMPDIR="/uipath/lib/containers/tmp"
   mkdir -p "/uipath/lib/containers/tmp"
   ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f --offline-bundle /uipath/tmp/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement --install-standalone-aicenter

3. Execute o instalador de software no nó primário. Primeiro, você precisa se conectar ao Identity Server e recuperar um token de instação. Em seguida, copie e cole esse token 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

4. Carregue os comandos opcionais dos pacotes do Document Understanding. Para carregar os pacotes opcionais, 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 --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" --accept-license-agreement

5. Carregue o comando opcional do pacote do Computer Vision. Para carregar o pacote opcional do Computer Vision, execute o seguinte comando:

   ./install-uipath.sh -i ./cluster_config.json -o ./output.json --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" --accept-license-agreement