Instalação offline de avaliação de nó único

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	Execute 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: recebimento de todos os arquivos baixados na máquina
Etapa 2: configurar a instalação	O instalador interativo reúne entradas para as opções de instalação mais comuns e gera uma configuração que você pode usar durante a instalação. Etapa 2.1: Configurando a instalação: configuração padrã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.2: (opcional) configuração da instalação: configuração avançada (opcional)
Etapa 3: execute a instalação	Execute a instalação. Assim que a instalação for concluída, você poderá começar a usar o cluster. Etapa 3: execução da instalação
Etapa 4: concluir a instalação	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 4: 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 dos pacotes de instalação e obtenção dos arquivos na máquina

Etapa 1.1: Download dos pacotes de instalação

Você deve executar esta etapa em uma máquina Linux ou Windows com acesso à Internet e à máquina no ambiente off-line em que planeja instalar o Automation Suite.

Os comandos nesta página são para um sistema operacional baseado em RHEL. Para Windows ou outros sistemas operacionais, ajuste os comandos equivalentes específicos para esses ambientes.

Importante: Você deve instalar os pacotes RPM necessários antes de iniciar o instalador do Automation Suite. Para obter detalhes, consulte Requisitos de pacote RPM.

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 instalador 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 – Obrigatório. Veja sf.tar.gz para instruções de download.
   • sf-infra.tar.gz — opcional. Necessário apenas se você deseja ingressar em nós adicionais, incluindo Task Mining e GPU. 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 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 du-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.

Etapa 1.2: recebimento de todos os arquivos baixados na 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.

NA MÁQUINA PRINCIPAL DO CLUSTER

Crie a pasta de instalação executando o seguinte comando:

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

Observação: a execução 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 um dos nós:

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

   Se você planeja ingressar em nós adicionais, como Task Mining ou GPU, execute o seguinte comando:

   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 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/sf-installer.zip /opt/UiPathAutomationSuite
   cd /opt/UiPathAutomationSuite
   unzip ./sf-installer.zip -d .
   chmod +x ./bin/jq
   export PATH=${PATH}:/opt/UiPathAutomationSuite/bin

   Se você planeja ingressar em nós adicionais, como Task Mining ou GPU, execute o seguinte comando:

   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 dar permissões adequadas para a pasta /opt/UiPathAutomationSuite onde 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. 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 sf-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/sf-installer.zip"

   Para iniciar o instalador interativo, execute o seguinte comando:

   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 assistente interativo no modo offline de nó único

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. O HAA não é suportado no modo de avaliação de nó único.

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 implantação de nó único (recomendado para fins de demonstração/avaliaçã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

   Observação:

   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

   Importante:

   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.

   Alguns produtos do Automation Suite, como Task Mining e Document Understanding 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 7b.
   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.
      Importante: 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.
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.
      Importante: Muitos objetos S3 requerem o CORS configurado 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 você deseja usar a autenticação do Kerberos para conexões SQL.
12. Insira o URL do SQL Server. Siga o prompt para inserir a porta de conexão, nome de usuário e senha.
    Importante: Se você instalar o Process Mining, um segundo SQL Server é recomendado. Certifique-se de fornecer a URL do SQL Server do warehouse, o prompt de conexão, o nome de usuário e a senha.

    Para obter detalhes sobre os requisitos de hardware que o segundo SQL Server deve atender, consulte Requisitos de SQL para o Process Mining.
13. Especifique se você deseja que o instalador crie automaticamente os bancos de dados necessários.
14. Forneça certificados CA para qualquer software 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.
    Importante: 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.
15. 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.
    Importante: Após gerar o arquivo de configuração e a pasta, você pode sair do instalador e prosseguir com as etapas restantes a seguir para concluir a instalaçã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 encontrar o arquivo cluster_config.json na pasta UiPathAutomationSuite. Você pode usar esse arquivo para habilitar produtos adicionais, desabilitar qualquer um dos produtos padrão, configurar seus bancos de dados SQL e suas respectivas strings de conexão, e para certificados. Você também pode habilitar as configurações de proxy se usar um proxy para conexão com a internet.

Para a instalação de avaliação de nó único, observe que você não pode habilitar a Alta Disponibilidade.

Para configurações avançadas, consulte Experiência de instalação avançada.

Observação:

Você pode executar o assistente novamente após a instalação ser concluída.

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

Certifique-se de copiar os arquivos baixados na máquina offline principal, na qual você executou a configuração, na pasta de instalação criada pelo assistente de instalação.

Aceitando 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 embutido): como alternativa, anexe --accept-license-agreement a cada execução de install-uipath.sh.

Executando a instalação

Execute os comandos de instalação para executar o pacote offline (duração estimada: 2h30min a 3h30min):

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

Para obter ajuda, você pode executar ./install-uipath.sh -h --accept-license-agreement.

Carregando os pacotes opcionais

Para carregar os pacotes opcionais do Document Understanding, execute os seguintes comandos:

./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"

Este documento se concentra no argumento de comando -a, porque ele cuida da necessidade de instalar todos os componentes necessários.

Instalação do Task Mining

Se você instalar o Task Mining no modo de avaliação de nó único, será necessário executar um conjunto adicional de etapas. Siga o Guia de instalação do Task Mining para concluir as etapas do Task Mining.

Etapa 4: 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

Atenção:

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.

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 para o AI Center, consulte a página Configuração do Orchestrator no guia do AI Center.

Redimensionamento de PVC

Para redimensionar o PVC, consulte Redimensionamento do PVC.