automation-suite
2023.4
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo.
Guia de instalação do Automation Suite no Linux
Last updated 4 de nov de 2024

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

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 alta disponibilidade de vários nós;
  • a memória de troca está desabilitada.

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;

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.
AtualizaçãoValida se o caminho de atualização em todas as versões do Automation Suite está correto.

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 as-installer.zip, e as ferramentas de suporte são agrupadas como as-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

as-installer.zipObrigatório. Para fazer o download das instruções, consulte as-installer.zip.

Offline

as-installer.zipObrigatório. Para fazer o download das instruções, consulte as-installer.zip.
as-infra.tar.gzObrigatório. Para obter instruções de download, consulte as-infra.tar.gz.

Preparing to use the script

  1. Torne-se root executando o seguinte comando:

    sudo su -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/as-installer.zip /opt/UiPathAutomationSuite/${VERSION}
    # Additionally for offline, copy as-infra.tar.gz as well to /opt/UiPathAutomationSuite/{VERSION} folder
    cp /path/to/as-infra.tar.gz /opt/UiPathAutomationSuite/${VERSION}
    cd /opt/UiPathAutomationSuite/${VERSION}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/as-installer.zip /opt/UiPathAutomationSuite/${VERSION}
    # Additionally for offline, copy as-infra.tar.gz as well to /opt/UiPathAutomationSuite/{VERSION} folder
    cp /path/to/as-infra.tar.gz /opt/UiPathAutomationSuite/${VERSION}
    cd /opt/UiPathAutomationSuite/${VERSION}
  3. Descompacte o pacote executando o seguinte comando:

    unzip as-installer.zip -d installerunzip as-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 installerchmod -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./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
******************************************************************************************************************************************************************************
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, gpuou 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 as-infra.tar.gz está localizado.

--prereq-tmp-folder

Aceita o caminho absoluto onde o pacote as-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 single-node evaluation setup

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./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 ../as-infra.tar.gz \ 
  --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp./validateUiPathASReadiness.sh \
  --node-type server \
  --install-type offline \
  --prereq-bundle ../as-infra.tar.gz \ 
  --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp

Para validar um nó de agente especializado usado para Task Mining, GPU ou Automation Suite Robots, execute as seguintes etapas:

  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/UiPathAutomationSuitescp /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:

    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 \ #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./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 \ #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 task-mining \ #replace with gpu for GPU node or asrobots for Automation Suite Robots node
  --install-type offline 
  --prereq-bundle ../as-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./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 ../as-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

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.