Validando os pré-requisitos em uma configuração de avaliação de nó único

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 .

Validando uma configuração de avaliação de nó único

Online

Para validar uma máquina de avaliação de nó único, execute o seguinte comando:

./validateUiPathASReadiness.sh \
  --node-type server \ # replace server with task-mining, gpu if you wish to install.
  --install-type online

Offline

Para validar uma máquina de um único nó, execute o o comando a seguir:

./validateUiPathASReadiness.sh \
  --node-type server \
  --install-type offline \
  --prereq-bundle ../sf-infra.tar.gz \ 
  --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp

Para validar um Task Mining ou um nó de GPU, siga os seguintes passos:

1. Copie o arquivo cluster_config.json gerado na máquina do servidor para todas as máquinas do agente:

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

   Observação:

   Se você não conseguir copiar o arquivo para a pasta /opt/UiPathAutomationSuite devido a um erro de permissão, poderá copiá-lo temporariamente para /var/tmp nas novas máquinas e 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.

2. Para validar o ambiente, execute o seguinte comando nas máquinas do agente:

   Observação: se você executar o comando em um nó de Task Mining ou GPU, substitua --node-type agent por --node-type task-mining ou --node-type gpu, respectivamente.

Online

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type agent \ # replace agent with task-mining, gpu if you wish to install.
  --install-type online \ #replace with offline for airgap
  --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 \ # replace agent with task-mining, gpu if you wish to install.
  --install-type online \ #replace with offline for airgap
  --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IP of all the nodes in cluster