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

Esta página explica como você pode executar uma instalação offline do Automation Suite com uma configuração 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 .

Use as etapas de instalação offline neste documento ao implantar o UiPath Automation Suite em um ambiente isolado sem acesso à internet.

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

Etapa	Description
Etapa 1: baixe os pacotes de instalação	Esta etapa precisa ser executada em uma máquina com acesso à internet e às máquinas isoladas nas quais o Automation Suite será implantado. Enquanto estiver terminando de baixar, você pode continuar em algumas das próximas etapas. Isso pode ser feito em uma máquina Linux ou Windows. 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 assistente interativo para configurar as opções de instalação A ferramenta reunirá entradas para as opções de instalação mais comuns e gerará um arquivo de configuração que será usado durante a instalação. Configure opções avançadas de instalação (opcional) A configuração de instalação padrão inclui os produtos usados na automação principal e um SQL Server compartilhado a serem usados por todos os produtos. Para personalizar os produtos instalados ou ter SQL Servers separados usados para produtos específicos, você pode fazê-lo editando o arquivo de configuração. Etapa 2.1: configuração básica 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 assistente de instalação 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áquinas Da primeira máquina, instale o restante do conjunto. 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.
   • sf-installer.zip – Obrigatório. Consulte sf-installer.zip para instruções de download.
   • sf.tar.gz – Opcional. Necessário apenas no nó do servidor ao usar o registro interno do Docker. Veja sf.tar.gz para instruções de download.
   • sf-infra.tar.gz — obrigatório. Veja sf-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 ~/sf-installer.zip ~/sf-infra.tar.gz <username>@<node dns>:/uipath/tmp
   scp ~/sf.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 básica

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/sf-installer.zip /uipath/tmp/sf-infra.tar.gz  /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 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.
   Se sf-installer.zip não estiver presente em /opt/UiPathAutomationSuite/, o instalador tentará baixá-lo e falhará, pois esta é uma instalação offline.

   O instalador interativo guiará você pelas etapas de configuração e gerará a configuração que você pode, então, personalizar e usar nas etapas de instalação restantes.

4. Para iniciar o instalador interativo, execute o seguinte script:
   Execute o seguinte comando:

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

Execução do assistente interativo no modo offline de vários nós

1. Insira a opção para o modo de produção pronto para alta disponibilidade de vários nós.
   
2. Insira a opção para isolado:
   
3. Especifique o URL para o cluster (URL do nome de host do DNS ou do balanceador de carga no modo de produção pronto para alta disponibilidade de vários nós) e as informações do SQL Server conforme mostrado abaixo:
   
4. A configuração será gerada com uma pasta, conforme mostrado na imagem a seguir.
   

Assim que 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.

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

Essa etapa é opcional.

Ao executar a instalação usando a configuração padrão, você estará optando por executar nossa seleção básica de produtos. Você vai instalar nossa plataforma principal, o Orchestrator, Insights, Action Center, Test Manager, Automation Ops, Automation Hub e Data Service.

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.

Nota: Se você sair do instalador interativo e executar a configuração avançada, será necessário executar novamente o instalador interativo para que a instalação seja concluída.

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 ./sf-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 ./sf-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 ./sf-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 /opt/UiPathAutomationSuite/sf.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

• 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"

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

Importante:

O processo de instalação gera certificados autoassinados em seu nome. No entanto, 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.

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.

Redimensionamento de PVC

Para redimensionar o PVC, consulte Redimensionamento do PVC.

Se você instalou o AI Center, recomendamos redimensionar o PVC para 200 imediatamente após a instalação para evitar tempos de inatividade. Para obter mais informações sobre isso, verifique Redimensionamento do PVC para o AI Center.

Adição do rancher/pause:3.5

Se você instalou o AI CenterTM, precisará importar e exportar a imagem do Rancher. Para obter mais informações sobre isso, consulte Adicionando rancher/pause:3.5 ao registro offline.