Instalação offline de produção pronta para alta disponibilidade de vários nós

Visão geral

Importante:

You must meet the hardware and software prerequisites before proceeding with the installation. See Hardware and software requirements.

You can use a dedicated script to validate the installation prerequisites and infrastructure readiness. See Validating the prerequisites.

Para uma experiência de instalação tranquila, certifique-se de seguir nossas boas práticas. Veja .

O processo de instalação tem as seguintes etapas gerais:

Etapa	Description
Etapa 1: baixe os pacotes de instalação	Você deve executar esta etapa em uma máquina Linux ou Windows com acesso à Internet e às máquinas off-line nas quais planeja implantar o Automation Suite. Enquanto o download dos pacotes de instalação termina, você pode prosseguir para algumas das próximas etapas. Etapa 1.1: download do pacote de instalação Etapa 1.2: obter todos os arquivos baixados na primeira máquina
Etapa 2: configurar a instalação	Execute o instalador interativo para configurar as opções de instalação. A ferramenta reúne entradas para as opções de instalação mais comuns e gera um arquivo de configuração que você pode usar durante a instalação. (Opcional) Configure opções avançadas de instalação. O instalador interativo oferece uma experiência padrão com um número limitado de opções de configuração. Para personalizar os produtos instalados, configure servidores SQL separados para produtos específicos e mais, edite o arquivo de configuração. Etapa 2.1: configuração padrão Etapa 2.2: (opcional) configuração avançada
Step 3: Copy the installation files on all the machines	Na primeira máquina, copie os arquivos baixados na pasta de instalação criada pelo instalador interativo na etapa 2. Nas outras máquina do cluster, copie toda a pasta de instalação da primeira máquina para o mesmo caminho de pasta em cada máquina. Etapa 3: copiar os arquivos de instalação em todas as máquinas
Step 4: Run the installation	Crie o cluster e junte todas as máquinasInstale o resto do conjunto da primeira máquina. Etapa 4: executar a instalação
Step 5: Complete the installation	Step 5: You have completed the installation successfully and can move to post-installation steps. Agora você pode acessar o cluster e o suíte recém-criados, atualizar certificados, redimensionar o PVC e muito mais. Etapa 5: conclusão da instalação

Importante:

Versão do kernel do RHEL kernel-4.18.0-477.10.1.el8_8 é afetada por um problema que interrompe a instalação ou o gerenciamento do cluster do Automation Suite. Certifique-se de que nenhum dos nós do Automation Suite utilize essa versão do kernel, quer seja pré ou pós-instalação. Você pode atualizar a versão do kernel executando o seguinte comando:

dnf install -y kernel kernel-tools kernel-tools-libs

Etapa 1: Download do pacote de instalação e obtenção de todos os arquivos na primeira máquina

Etapa 1.1: Download dos pacotes de instalação

Você deve executar essa etapa em uma máquina com acesso à internet e à máquina no ambiente offline na qual o Automation Suite será instalado.

Observação:

Essa máquina pode ser Linux ou Windows. Os comandos neste guia são para o sistema operacional baseado em RHEL. Para Windows ou outros sistemas operacionais, ajuste para comandos equivalentes específicos desses ambientes.

O instalador do Automation Suite é um wrapper de vários pacotes que também instala algumas dependências usando o Red Hat Package Manager (RPM). Ele fornece uma experiência interativa que ajuda você a configurar recursos externos, como SQL e outras opções de instalação.

NA MÁQUINA SEPARADA COM ACESSO À INTERNET

Esta seção explica como 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 – Mandatory. See installUiPathAS.sh for download instructions.

   • as-installer.zip – Mandatory. See as-installer.zip for download instructions.

   • as.tar.gz – Optional. Required only on server node when using internal Docker registry. See as.tar.gz for download instructions.

   • as-infra.tar.gz - Mandatory. See as-infra.tar.gz for download instructions.

   • du-ondemand.tar.gz – Optional. Needed only for Document Understanding. See du-ondemand.tar.gz for download instructions.

     Observação:

     Não seguir essa etapa opcional limita a funcionalidade dos serviços do Document Understanding.

   • cv-ondemand.tar.gz – Optional. Needed only for Computer Vision. See cv-ondemand.tar.gz for download instructions.

     Observação:

     Não seguir essa 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.

Etapa 1.2: obter todos os arquivos baixados na primeira máquina

Certifique-se de executar as seguintes etapas:

• Verifique se todos os arquivos concluíram o download 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.

EM TODAS AS MÁQUINAS NO CLUSTER

Crie as pastas de instalação executando o seguinte comando:

sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 777 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp

Importante:

A execução de mkdir -p /opt/UiPathAutomationSuite/ não é necessária se você usar o script configureUiPathDisks.sh.

NA MÁQUINA SEPARADA COM ACESSO À INTERNET

Copie os arquivos para o primeiro nó executando as seguintes etapas:

1. From the machine with internet access, copy the files to the installation folder on the target machine, and the offline bundle(s) to the /uipath/tmp folder:

   scp ~/installUiPathAS.sh ~/as-installer.zip ~/as-infra.tar.gz <username>@<node dns>:/uipath/tmp
   scp ~/as.tar.gz <username>@<node dns>:/uipath/tmp/
   

2. (Opcional) Para usar o Document Understanding, copie o seguinte pacote para a pasta /uipath/tmp:

   scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
   

   AVISO:

   Not following this optional step prevents access to the Document Understanding services.

3. (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/
   

   AVISO:

   Não seguir essa etapa opcional impede o acesso aos serviços do Computer Vision.

Etapa 2: configurar a instalação

Etapa 2.1: configuração padrão

NA MÁQUINA PRINCIPAL DO CLUSTER

1. Adicione a pasta de pré-requisitos ao PATH atual.

   O instalador interativo requer jq e os pacotes offline do Automation Suite já o incluem. Execute os seguintes comandos para adicioná-lo ao PATH e verifique se você ainda é root:

   mv /uipath/tmp/installUiPathAS.sh /uipath/tmp/as-installer.zip /uipath/tmp/as-infra.tar.gz  /opt/UiPathAutomationSuite
   cd /opt/UiPathAutomationSuite
   unzip ./as-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 conceder 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 estágio. Para fornecer as permissões necessárias, execute o seguinte comando:

   chmod -R 755 /opt/UiPathAutomationSuite
   

3. Execute o instalador interativo para configurar as opções de instalação.

   Importante:

   O instalador interativo tenta baixar as-installer.zip e falha em ambientes offline. Para ignorar a etapa de download e evitar quaisquer problemas de instalação, execute o seguinte comando:

   export BUNDLE_FILE="/opt/UiPathAutomationSuite/as-installer.zip"
   

   Para iniciar o instalador interativo, execute o seguinte script:

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

   O instalador interativo guia você pelas etapas de configuração e gera a configuração que você pode então personalizar nas etapas de instalação restantes.

Executando o instalador interativo no modo offline de vários nós

Execute o instalador interativo para configurar as opções de instalação. A ferramenta reúne entradas para as opções de instalação mais comuns e gera um arquivo de configuração. A alta disponibilidade é ativada por padrão, mas você pode desativá-la usando a configuração avançada.

Importante:

Ao executar uma instalação interativa do Automation Suite 2023.4.0, a mensagem que solicita a execução do próximo comando em nós secundários contém um token vazio. Para continuar a instalação, você deve gerar um novo token executando kubectl create token default e, só então, executar o comando para os nós secundários.

Para instalar o Automation Suite, execute as seguintes etapas:

1. Inicie o instalador interativo.

2. Aceite o contrato de licença para continuar a instalação.

3. In Main Menu, select your deployment mode. Choose Multi-node deployment (recommended for production use) and confirm your selection.

   

4. In Deployment configuration, select your environment type. Choose Air-gapped.

5. Escolha sua seleção de produtos. Suas opções são:

   • Completo (todos os produtos)
   • Selecione os produtos

   For details on the product selection options, see Hardware and software requirements.

6. If you chose Select products in the previous step, indicate the products you want to install. Your options are:

   • Action Center
   • AI Center
   • Apps
   • Automation Hub
   • Automation Ops
   • Automation Suite Robots
   • Data Service
   • Document Understanding
   • Insights
   • Orchestrator
   • Process Mining
   • Task Mining
   • Test Manager
   Observação:

   Some Automation Suite products have additional dependencies on each other. When selecting the products you want to install, make sure you consider Cross-products dependencies. Trying to install a product without its dependencies would result in an error.

   In addition to that, some Automation Suite products require a dedicated agent node. Before continuing, make sure you meet the hardware requirements.

7. To install AI Center, you must follow additional steps:

   Observação:

   In offline installations, you do not need to specify the metering API key. To complete the AI Center installation, follow the step from the Completing AI Center installation section.

   1. Especifique se o AI Center requer um Orchestrator externo.

      • Se o AI Center não exigir um Orchestrator externo, continue na Etapa 8.
      • Se o AI Center exigir um Orchestrator externo, continue na Etapa 7.b.

   2. Copy the Orchestrator certificate to the virtual machine. For more information on this, check the Copy the Orchestrator certificate page.

   3. Especifique o URL do Orchestrator para o AI Center. Exemplo: https://orchestrator.example.com.

   4. Especifique o URL de identidade do AI Center. Exemplo: https://orchestrator.example.com/identity.

   5. Especifique o caminho para o arquivo de certificado do Orchestrator. Exemplo: /opt/UiPathAutomationSuite/UiPath_Installer/orch.cer.

   6. Especifique o caminho para o arquivo de certificado de identidade. Exemplo: /opt/UiPathAutomationSuite/UiPath_Installer/identity.cer.

8. Confirme sua seleção de produto para determinar os requisitos mínimos de hardware e software.

9. Insira o FQDN do conjunto de automação.

10. Specify whether you would like to bring your own object store for the selected products. If you select No, you opt for the default object store. If you select Yes, choose one of the following options:

    • Azure Storage Account – Indicate if you want to use managed identity-based with your Azure storage account, provide the following details corresponding to your choice, then specify if you want the containers to be automatically provisioned for all the selected products:
      • If Yes, provide the Azure storage account name and endpoint suffix, and your client ID;
      • If No, provide the Azure storage account name and endpoint suffix, and your Azure account key;
    • AWS S3 – Provide the prefix and suffix for the bucket names, the AWS region where buckets are hosted, the access key and the secret key for the S3 account, and specify if you want the buckets to be automatically provisioned for all the selected products.
    • Other S3 Compatible storage – Specify the prefix and suffix for the bucket names, the S3 server FQDN, the S3 port, the access key and the secret key for the S3 account, and specify if you want the buckets to be automatically provisioned for all the selected products.
    Observação:

    Muitos objetos S3 requerem o CORS definido para todo o tráfego do cluster do Automation Suite. Você deve configurar a política CORS no nível do objectstore para permitir o FQDN do cluster.

11. Especifique se deseja trazer seu próprio registro do Docker externo compatível com OCI.

    • Ao selecionar Não, você opta pelo registro interno padrão do Docker.
    • Ao selecionar Sim, você deve fornecer os seguintes detalhes sobre o registro que deseja usar: URL do registro com porta, nome de usuário, senha e senha de extração.

12. Especifique se você deseja usar a autenticação do Kerberos para conexões SQL.

13. Insira o FQDN do SQL Server. Siga o prompt para inserir a porta de conexão, nome de usuário e senha.

    Observação:

    Process Mining requires a second SQL Server. If you install Process Mining, make sure to provide the warehouse SQL Server URL, connection prompt, username, and password.

    For details on the hardware requirements the second SQL Server must meet, see SQL requirements for Process Mining.

14. Especifique se você deseja que o instalador crie automaticamente os bancos de dados necessários.

15. Forneça certificados CA para qualquer software de servidor externo que exija uma comunicação TLS segura, caso contrário, a instalação falhará. Se você não habilitou a comunicação TLS, pode configurar a pós-instalação dos certificados.

    Observação:

    O instalador aceita apenas certificados DER codificados em Base64 no formato PEM . Se os servidores externos tiverem CAs diferentes, você pode concatenar todos os certificados públicos em um único arquivo.

16. Após definir os parâmetros de configuração, o instalador gera automaticamente a configuração. Você pode editar os parâmetros de configuração diretamente no terminal.

    Observação:

    Agora você pode editar diretamente ocluster_config.json para configurações avançadas na pasta UiPathAutomationSuite.

    Depois de editar o arquivo de configuração, você deve executar novamente o instalador interativo para concluir a instalação ou concluí-la manualmente.

    Para uma implantação Disaster recovery - Ativa/Passiva, agora você deve executar as seguintes etapas:

    1. Install and configure the primary cluster. For details, see Advanced installation experience.
    2. Install and configure the secondary cluster. For details, see Disaster recovery - Installing the secondary cluster.
    3. Retome a instalação seguindo as instruções nesta página.

Observação:

No final do processo de instalação, você receberá um resumo da implantação que lhe dará acesso ao portal de administração do cluster, portal do host, interface de administração da organização, Rancher, ArgoCD e muito mais.

Etapa 2.2: (opcional) configuração avançada

Essa etapa é opcional.

Você pode alterar o arquivo para ter acesso a configurações mais avançadas. Você pode habilitar produtos adicionais, desabilitar qualquer um dos produtos padrão, configurar seus bancos de dados do SQL e suas respectivas strings de conexão, e definir certificados. Para o modo de produção pronto para alta disponibilidade de vários nós, habilitamos a Alta Disponibilidade por padrão, mas você pode desabilitá-la se necessário.

For advanced configuration, you can follow the following instructions: Advanced installation experience.

Observação:

If you exit the interactive installer and perform advanced configuration, you need to re-run the interactive installer to complete the process.

Etapa 3: 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 o instalador, os certificados e cluster_config.json para todas as outras máquinas.

NA PRIMEIRA MÁQUINA NO CLUSTER

1. Copie a pasta /opt/UiPathAutomationSuite para todos os outros nós executando o seguinte comando:

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

   Importante:

   Since you are in an air-gapped environment, you might need to use the private IP of the target node.

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.

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

Etapa 4: executar a instalação

Há dois tipos de máquinas: servidor e agente.

• Servidor — máquinas nas quais a infraestrutura do Kubernetes (por exemplo, apiserver, etcd) é executada. Esses componentes gerenciam todo o cluster.
• Agente — versão básica da máquina que é usada para executar cargas de trabalho

O modo de produção pronto para alta disponibilidade de vários nós requer um mínimo de 3 máquinas de servidor. A instalação do Task Mining requer uma máquina adicional usada como agente.

Observação:

• Para uma instalação de produção pronta para alta disponibilidade de vários nós, você precisa de um balanceador de carga. Certifique-se de que um tenha sido criado e o tráfego seja distribuído entre os nós. O nome de domínio do balanceador de carga precisa ser usado no arquivo cluster_config.json.
• Você precisa ter pelo menos um nó de servidor e, para a alta disponibilidade, precisa de pelo menos três nós de servidor. É necessário um número ímpar de nós de servidor.

Etapa 4.1: aceitar o contrato de licença

Before running the installation, make sure to read the License Agreement.

Para aceitar o contrato de licença, escolha um dos seguintes métodos:

• Option 1 (Environment Variable) - Set the LICENSE_AGREEMENT environment variable to accept by executing the following command: export LICENSE_AGREEMENT=accept
• Opção 2 (parâmetro incorporado) - Ou então, acrescente --accept-license-agreement a cada execução de install-uipath.sh.

Etapa 4.2: criar e associar todas as máquinas ao cluster

1. Configure a primeira máquina.

   Execute os seguintes comandos no primeiro servidor:

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

2. Associe o restante dos servidores ao cluster.

   Execute os seguintes comandos no restante dos nós do servidor em sequência:

   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 ./as-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement
   

3. Associe o restante dos agentes ao cluster.

   Execute os seguintes comandos no restante dos nós do agente em sequência:

   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 ./as-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement
   

Step 4.3: Finishing installing the suite

Finalizando a instalação no primeiro nó

Após todos os nós estarem unidos, passe para o primeiro servidor para concluir a instalação do Automation Suite:

1. Verifique se os nós foram adicionados corretamente executando o seguinte comando:

   sudo su
   export KUBECONFIG=/etc/rancher/rke2/rke2.yaml PATH=$PATH:/var/lib/rancher/rke2/bin
   kubectl get nodes
   

2. Você deve ver mais de um nó na lista se tudo correu bem.

3. Finalize a instalação executando o seguinte comando:

   cd /opt/UiPathAutomationSuite
   ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f -s --offline-bundle /uipath/tmp/as.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement
   

AVISO:

Essa é a operação mais demorada. Ela deve levar aproximadamente duas horas.

Carregando os pacotes opcionais

Observação:

Esta etapa é necessária apenas se você não optou pelo registro externo do Docker.

• Para carregar o pacote opcional do Document Understanding, execute o seguinte comando:

  ./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"
  

• Para carregar o pacote opcional do Computer Vision, execute o seguinte comando:

  ./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"
  

Completing an AI Center installation

Se o AI Center exigir um Orchestrator externo, execute o seguinte comando para concluir a instalação:

./configureUiPathAS.sh aicenter configure --installation-token <identity token>

For more information on how to configure Orchestrator for AI Center, check the Configuring Orchestrator page from the AI Center guide.

Etapa 5: conclusão da instalação

Observação:

Você concluiu a instalação com sucesso e agora pode passar para as etapas de pós-instalação.

Atualização de certificados

O processo de instalação gera certificados autoassinados em seu nome. Esses certificados são compatíveis com FIPS 140-2. O modelo de implantação do Azure também oferece a opção de fornecer um certificado de servidor emitido pela CA no momento da instalação, em vez de usar um certificado autoassinado gerado automaticamente.

Certificados autoassinados expirarão em 90 dias e você deverá substituí-los por certificados assinados por uma CA confiável assim que a instalação for concluída. Se você não atualizar os certificados, a instalação deixará de funcionar após 90 dias.

Se você instalou o Automation Suite em um host habilitado para FIPS 140-2 e deseja atualizar os certificados, verifique se são compatíveis com FIPS 140-2.

For instructions, see Managing certificates.

Acessando o Automation Suite

To access the newly created cluster and suite, see Accessing Automation Suite.