Validando os pré-requisitos em uma configuração de produção pronta para HA de vários nós

Antes de instalar o Automation Suite, é uma boa prática validar os pré-requisitos de instalação e a prontidão da infraestrutura. Você pode usar o script dedicado para avaliar seu ambiente e gerar um resumo antes de realizar a instalação.

Using the script to validate installation prerequisites

Como baixar o script

Observação: para instalações offline, você deve realizar essa etapa em uma máquina com acesso à internet e às máquinas isoladas nas quais o Automation Suite está implantado. Copie o arquivo da máquina online para a primeira máquina de destino.

O script de pré-requisito é empacotado junto com o instalador em um arquivo chamado sf-installer.zip, e as ferramentas de suporte são agrupadas como sf-infra.tar.gz apenas para offline. Você precisa desses arquivos para gerar um relatório em todas as máquinas nas quais planeja instalar o Automation Suite.

Tipo de Instalação	Arquivos para baixar
Online	sf-installer.zip – Obrigatório. Para fazer o download das instruções, consulte sf-installer.zip.
Offline	sf-installer.zip – Obrigatório. Para fazer o download das instruções, consulte sf-installer.zip. sf-infra.tar.gz – Obrigatório. Para baixar instruções, consulte sf-infra.tar.gz.

Preparando-se para usar o script

1. Torne-se root executando o seguinte comando:

   sudo su -

2. Copie os arquivos para a pasta /opt/UiPathAutomationSuite/{version} executando o seguinte comando:

   VERSION="" #add the version number you are trying to install. Ex: for 2022.4.0 Set VERSION="2022.4.0"
   mkdir -p /opt/UiPathAutomationSuite/${VERSION}
   # For below command replace the /path/to where actually the files are present.
   cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/${VERSION}
   # Additionally for offline, copy sf-infra.tar.gz as well to /opt/UiPathAutomationSuite/{VERSION} folder
   cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/${VERSION}
   cd /opt/UiPathAutomationSuite/${VERSION}

3. Descompacte o pacote executando o seguinte comando:

   unzip sf-installer.zip -d installer

4. Atribua as permissões necessárias e navegue até a pasta do script executando o seguinte comando:

   chmod -R 755 installer
   cd installer

Parâmetros do script

Para visualizar a seção de ajuda e os sinalizadores suportados, execute o seguinte comando:

./validateUiPathASReadiness.sh --help

Saída:

***************************************************************************************
validateUiPathASReadiness.sh Runs pre-install validation checks
Arguments:
 -i|--input                                             Specify cluster config json file
 -m|--machines                                          Comma separated IP address / hostnames of all the machines
 -n|--node-type                                         Possible values [server|agent|task-mining|gpu]. Defaults to server
 --install-type                                         Possible values [online|offline]. Defaults to online
 --install-standalone-aicenter                          Run checks for standalone aicenter service only
 --prereq-bundle </uipath/sf-infra.tar.gz>   Specify the path to the prereq bundle, only for offline installation
 --prereq-tmp-folder </uipath>                          Specify parent directory for the temporary install folder, only for offline installation
 -h|--help                                              Display help
***************************************************************************************

A tabela a seguir descreve os parâmetros que você pode usar ao executar o script:

Parâmetro	Description
-i|--input	Aceita o arquivo cluster_config.json como entrada. Esse arquivo define os parâmetros, as configurações e as preferências aplicadas aos serviços da UiPath implantados por meio do Automation Suite. Para mais detalhes, consulte Experiência de instalação avançada. Se você não fornecer esse arquivo, o script acionará a experiência interativa para coletar essas entradas. O arquivo será gerado em seu nome.
-m|--machines	Aceita endereços IP/nomes de host separados por vírgulas de todas as máquinas. Isso é necessário para verificar a conectividade entre todos os nós na porta necessária. O parâmetro é obrigatório para instalações de produção prontas para HA de vários nós. Além disso, o parâmetro também é necessário se você planeja adicionar um nó de Task Mining ou GPU em um cluster de avaliação de nó único.
-n|--node-type	Aceita o tipo do nó atual. Os valores possíveis são: server, agent, task-mininge gpu. O valor padrão é server.
--install-type	Aceita o método de instalação: online ou offline. O valor padrão é online.
--install-standalone-aicenter	Este é um sinalizador booleano. Passe-o se você planeja instalar o AI Center independente.
--prereq-bundle	Aceita o caminho absoluto onde o sf-infra.tar.gz está localizado.
--prereq-tmp-folder	Aceita o caminho absoluto onde o pacote sf-infra.tar.gz será extraído temporariamente. Se este caminho não for fornecido, o instalador selecionará a pasta /tmp .

Validating a multi-node HA-ready production setup

Na primeira máquina servidora

1. Para validar a primeira máquina servidora, execute o seguinte comando:

Online

./validateUiPathASReadiness.sh \
  --node-type server \ 
  --install-type online \
  --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IPs of all the nodes in cluster

Offline

./validateUiPathASReadiness.sh \
  --node-type server \ 
  --install-type offline \
  --prereq-bundle ../sf-infra.tar.gz \
  --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp \
  --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IPs of all the nodes in cluster

Depois que esse script é executado, ele gera um arquivo cluster_config.json na pasta /opt/UiPathAutomationSuite . Este arquivo é necessário em todas as outras máquinas.

2. Para copiar o arquivo cluster_config.json nas outras máquinas, execute o seguinte comando:

scp /opt/UiPathAutomationSuite/cluster_config.json <username>@<node dns>:/opt/UiPathAutomationSuite

Observação:

Se não for possível copiar o arquivo na pasta /opt/UiPathAutomationSuite devido a erros de permissão, você pode copiá-lo temporariamente para /var/tmp nas novas máquinas e depois movê-lo para /opt/UiPathAutomationSuite.

Como alternativa, você também pode fornecer permissões de acesso total (777) à pasta /opt/UiPathAutomationSuite nas novas máquinas, executando o seguinte comando: chmod -R 777 /opt/UiPathAutomationSuite.

Nas outras máquinas servidoras

Para validar as outras máquinas do servidor, execute o comando a seguir:

Online

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type server \
  --install-type online \
  --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IP of all the nodes in cluster

Offline

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type server \
  --install-type offline \
  --prereq-bundle ../sf-infra.tar.gz \
  --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp \
  --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IP of all the nodes in cluster

Em máquinas de agente

Para validar as máquinas do agente, execute o comando a seguir:

Online

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type agent \
  --install-type online \
  --machines "10.0.1.8, 10.0.1.9" # replace with actual machine IP of all the nodes in cluster

Offline

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type agent \
  --install-type offline \ #replace with offline for airgap
  --prereq-bundle ../sf-infra.tar.gz \
  --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp \
  --machines "10.0.1.8, 10.0.1.9" # replace with actual machine IP of all the nodes in cluster

Em máquinas de Task Mining e máquinas de GPU

Para validar as máquinas Task Mining & GPU, execute o seguinte comando:

Observação: para nós de Task Mining e de GPU, use --node-type task-mining e --node-type gpu, respectivamente, nos comandos a seguir.

Online

./validateUiPathASReadiness.sh \)\)
  --input /opt/UiPathAutomationSuite/cluster_config.json \)\)
  --node-type task-mining \)\) #replace with GPU for GPU node
  --install-type online \)\)
  --machines "10.0.1.8, 10.0.1.9" # replace with actual machine IP of all the nodes in cluster

Offline

./validateUiPathASReadiness.sh \)\)
  --input /opt/UiPathAutomationSuite/cluster_config.json \)\)
  --node-type task-mining \)\) #replace with GPU for GPU node
  --install-type offline \)\) 
  --prereq-bundle ../sf-infra.tar.gz \)\) 
  --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp \)\)
  --machines "10.0.1.8, 10.0.1.9" # replace with actual machine IP of all the nodes in cluster