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