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

Visão geral

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 validateUiPathASReadiness.sh para avaliar seu ambiente e gerar um resumo antes de executar a instalação.

Validação	Description
Requisitos de Hardware	Valida se cada máquina no cluster atende aos requisitos de hardware. A verificação leva em consideração os seguintes aspectos: servidor, agente ou nó contaminado; sistema online ou offline; perfil de avaliação de nó único ou perfil de produção pronto para HA de vários nós.
Particionamento e configuração de disco	Valida se você particionou e configurou o disco corretamente. A verificação leva em consideração os seguintes aspectos: servidor ou nó de agente; sistema online ou offline; nó de servidor primário ou secundário.
Conectividade do SQL Server	Valida a conectividade com o SQL Server e o banco de dados configurados. A verificação leva em consideração os seguintes aspectos: conectividade com o host do SQL Server (endpoint) em um determinado endpoint; conectividade com o banco de dados principal se create_db estiver definido como true; criar permissões de banco de dados (dbcreator) se create_db estiver definido como true; criar esquema (db_ddladmin), ler (db_datareader) e gravar (db_datawriter) permissões; conectividade com o banco de dados quando create_db é definido como false; requisitos especiais para cada serviço. Por exemplo, para Insights, o script verifica o índice columnstore, o suporte json e se o nível de compatibilidade do SQL Server é >= 130; conectividade ao banco de dados e SQL Server com autenticação integrada.
certificado do servidor	Verifica se o certificado do servidor fornecido é válido. A verificação leva em consideração os seguintes aspectos: o formato do arquivo do certificado é .pem, ou seja Certificado DER codificado em Base64; o comprimento da chave privada é de pelo menos 2048; Uso estendido de chave e autenticação TLS de servidor da web; necessário para acessar o Automation Suite em dispositivos iOS; Nome alternativo do assunto para todas as entradas de DNS necessárias; certificado de servidor e correspondência de chave privada; o pacote CA que você forneceu é, na verdade, o emissor do certificado do servidor; a validade do certificado é superior a 30 dias.
Certificados de assinatura do token	Verifica se o certificado de assinatura de token fornecido é válido. A verificação leva em consideração os seguintes aspectos: o certificado está no formato pfx ; a senha para descriptografar o certificado é válida; a validade do certificado é superior a 30 dias.
Proxy	Valida se você configurou corretamente o proxy. A verificação leva em consideração os seguintes aspectos: https_proxy, http_proxye no_proxy são definidos como variáveis de ambiente na máquina; o servidor proxy está acessível.
Conectividade	Valida se todas as máquinas podem se conectar umas às outras, se todas as URLs necessárias estão na lista de permissões do firewall e muito mais. A verificação leva em consideração os seguintes aspectos: o FQDN do Automation Suite e o FQDN de todos os outros subdomínios podem ser resolvidos a partir da máquina; em uma configuração online, todos os URLs externos são acessíveis a partir da máquina; todos os servidores, agentes e nós contaminados podem se conectar uns aos outros nas portas necessárias; as conexões de saída (URLs) podem ser resolvidas por meio de todos os servidores de nomes presentes em /etc/resolve.conf; se algum dos URLs não puder ser resolvido por meio de todos os servidores de nomes, pelo menos um servidor de nomes poderá resolver todos os URLs; o protocolo TCP ou UDP é permitido; fixed_rke_address está definido para a porta 9345 e 6443; uma resposta é emitida quando uma chamada é feita para o FQDN na porta 443.
serviços do sistema	Valida se os serviços do sistema estão configurados corretamente. A verificação leva em consideração os seguintes aspectos: nm-cloud-setup.service, nm-cloud-setup.timer, firewalld estão desativados; iscsi-initiator-utils está instalado e ativado; auditd está configurado corretamente para --backlog_wait_time definido como 1; logrotate está configurado corretamente; net.ipv4.conf.all.rp_filter está desabilitado (definido como 0).
Requisitos de software	Valida se todo o software necessário está instalado. Se algum software não estiver instalado, o instalador install-uipath.sh tentará instalá-lo.

Using the script to validate installation prerequisites

Como baixar o script

Observação:

Para instalações offline, você deve realizar esta 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 – Mandatory. For download instructions, see sf-installer.zip.
Offline	sf-installer.zip – Mandatory. For download instructions, see sf-installer.zip. sf-infra.tar.gz – Mandatory. For download instructions, see 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
   

Script Parameters

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
Usage:
  validateUiPathASReadiness.sh [command]
  validateUiPathASReadiness.sh [flags]
Available Commands:
  validate-packages                                     Validate that required packages are installed
  install-packages                                      Install required packages. If --install-type offline, this will also install offline required packages
Arguments:
 -i|--input                                             Specify cluster config json file. Defaults to /opt/UiPathAutomationSuite/cluster_config.json
 -d|--debug                                             Debug mode to get additional details helpful for debugging
 -m|--machines                                          Comma separated IP address / hostnames of all the machines
 -n|--node-type                                         Possible values [server|agent|taskmining|asrobots|gpu]. Defaults to server
 --install-type                                         Possible values [online|offline]. Defaults to online
 --prereq-bundle </uipath/offline_bundle.tar.gz>        Specify the path to the prereq bundle
 --prereq-tmp-folder </uipath>                          Specify parent directory for the temporary install folder
 --kubeconfig                                           Specify path to the kubeconfig file
 -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	Accepts the cluster_config.json file as input. This file defines the parameters, settings, and preferences applied to the UiPath services deployed via Automation Suite. For details, see Advanced Installation Experience. 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.
-d|--debug	Modo de depuração para obter detalhes adicionais úteis para depuração.
-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ó Task Mining, GPU ou Automation Suite Robots 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-mining, gpue asrobots. O valor padrão é server.
--install-type	Aceita o método de instalação: online ou offline. O valor padrão é online.
--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 .
--kubeconfig	Especifique o caminho para o arquivo kubeconfig.
validate-packages	Valida os pacotes RPM necessários.
install-packages	Instala os pacotes RPM necessários para instalação online.
install-packages --install-type offline	Instala os pacotes RPM necessários para instalação off-line.

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. To copy the cluster_config.json file on the other machines, run the following command:

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 agentes especializados

Para validar as máquinas Task Mining, GPU ou Automation Suite Robots, execute o seguinte comando:

Observação:

Certifique-se de usar o parâmetro adequado para identificar seu nó de agente especializado:

• para máquinas do Task Mining, use --node-type task-mining
• para máquinas GPU, use --node-type gpu
• Para máquinas do Automation Suite Robots, use --node-type asrobots

Online

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type task-mining \ #replace with gpu for GPU node or asrobots for Automation Suite Robots 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 or asrobots for Automation Suite Robots 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