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

Visão geral

Importante:

Você deve atender aos pré-requisitos de hardware e software antes de dar continuidade à instalação. Consulte Requisitos de hardware e software.

Você pode usar um script dedicado para validar os pré-requisitos de instalação e a prontidão da infraestrutura. Consulte Validação dos pré-requisitos.

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
Etapa 3: Copiar os arquivos de instalação em todas as máquinas	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
Etapa 4: Executar a instalação	Crie o cluster e junte todas as máquinasInstale o resto do conjunto da primeira máquina. Etapa 4: executar a instalação
Etapa 5: Concluir a instalação	Etapa 5: Você concluiu a instalação com sucesso e pode passar para as etapas pós-instalação. 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 – Obrigatório. Consulte installUiPathAS.sh para instruções de download.
   • as-installer.zip – Obrigatório. Consulte as-installer.zip para instruções de download.
   • as.tar.gz – Opcional. Necessário apenas no nó do servidor ao usar o registro interno do Docker. Consulte as.tar.gz para obter instruções de download.
   • as-infra.tar.gz - Obrigatório. Consulte as-infra.tar.gz para 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 essa 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 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. 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 ~/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/

   Atenção: não seguir esta etapa opcional impede o acesso aos serviços do Document Understanding.
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/

   Atenção: não seguir esta 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. No Menu Principal, selecione seu modo de implantação. Escolha a implantação de vários nós (recomendado para uso em produção) e confirme sua seleção.
   
4. Em Configuração de implantação, selecione seu tipo de ambiente. Escolha Air-gapped.
5. Escolha sua seleção de produtos. Suas opções são:
   • Completo (todos os produtos)
   • Selecione os produtos

   Para obter detalhes sobre as opções de seleção de produtos, consulte Requisitos de hardware e software.

6. Se você escolheu Selecionar produtos na etapa anterior, indique os produtos que deseja instalar. Suas opções são:
   • 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:

   Alguns produtos do Automation Suite têm dependências adicionais entre eles. Ao selecionar os produtos que deseja instalar, certifique-se de considerar as dependências entre produtos. Tentar instalar um produto sem suas dependências resultaria em erro.

   Além disso, alguns produtos do Automation Suite exigem um nó de agente dedicado. Antes de continuar, certifique-se de atender aos requisitos de hardware.

7. Para instalar o AI Center, você deve seguir etapas adicionais:
   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. Copie o certificado do Orchestrator para a máquina virtual. Para obter mais informações sobre isso, consulte a página Copiar o certificado do Orchestrator .
   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.
   Observação: em instalações offline, você não precisa especificar a chave da API de medição. Para concluir a instalação do AI Center, siga a etapa da seção Como concluir a instalação do AI Center.
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. Especifique se você gostaria de trazer sua própria loja de objetos para os produtos selecionados. Se selecionar Não, você opta pelo armazenamento de objeto padrão. Se você selecionar Sim, escolha uma das seguintes opções:
    • Conta de armazenamento do Azure – indique se deseja usar identidade gerenciada com base em sua conta de armazenamento do Azure, forneça os seguintes detalhes correspondentes à sua escolha e especifique se deseja que os contêineres sejam provisionados automaticamente para todos os produtos selecionados:
      • Se Sim, forneça o nome da conta de armazenamento do Azure e o sufixo do ponto de extremidade e sua ID de cliente;
      • Se No, forneça o nome da conta de armazenamento do Azure e o sufixo do ponto de extremidade e sua chave de conta do Azure;
    • AWS S3 – Forneça o prefixo e o sufixo para os nomes dos buckets, a região da AWS onde os buckets estão hospedados, a chave de acesso e a chave secreta da conta S3 e especifique se deseja que os buckets sejam provisionados automaticamente para todos os produtos selecionados.
    • Outro armazenamento compatível com S3 – Especifique o prefixo e o sufixo para os nomes dos buckets, o FQDN do servidor S3, a porta S3, a chave de acesso e a chave secreta para a conta S3 e especifique se deseja que os buckets sejam provisionados automaticamente para todos os produtos selecionados.

    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.

    Para obter detalhes sobre os requisitos de hardware que o segundo SQL Server deve atender, consulte Requisitos de SQL para o 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. Instale e configure o cluster primário. Para obter detalhes, consulte Experiência de instalação avançada.

    2. Instale e configure o cluster primário. Para obter detalhes, consulte Disaster Recovery - Instalando o cluster secundário.

    3. Retome a instalação seguindo as instruções nesta página.

Observação: ao 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.

Para a configuração avançada, você pode seguir as seguintes instruções: Experiência de instalação avançada.

Observação: se você sair do instalador interativo e realizar configuração avançada, será necessário executar novamente o instalador interativo para concluir o processo.

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: como você está em um ambiente isolado, talvez 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.

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

Antes de executar a instalação, certifique-se de ler o Contrato de Licença.

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

• Opção 1 (variável de ambiente) - Defina a variável de ambiente LICENSE_AGREEMENT para aceitar executando o seguinte comando: 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

Etapa 4.3: finalizar a instalação do suíte

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"

Concluindo uma instalação do AI Center

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>

Para obter mais informações sobre como configurar o Orchestrator for AI Center, consulte a página Configurando o Orchestrator no guia do AI Center.

Etapa 5: conclusão da instalação

Observação: você concluiu a instalação com sucesso e agora pode passar para as etapas 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.

Para obter instruções, consulte Gerenciamento de certificados.

Acessando o Automation Suite

Para acessar o cluster e o pacote recém-criados, consulte Acesso ao Automation Suite.