Validar los requisitos previos en una configuración de producción preparada para alta disponibilidad multinodo

Información general

Antes de instalar Automation Suite, se recomienda validar los requisitos previos de la instalación y la disponibilidad de la infraestructura. Puede utilizar el script validateUiPathASReadiness.sh para evaluar su entorno y generar un resumen antes de realizar la instalación.

Validación	Descripción
Requisitos de hardware	Valida que cada máquina del clúster cumpla con los requisitos de hardware. La comprobación tiene en cuenta los siguientes aspectos: servidor, agente o nodo corrupto; sistema en línea o sin conexión; perfil de evaluación de nodo único o perfil de producción multinodo listo para alta disponibilidad.
Partición y configuración del disco	Valida que particionó y configuró correctamente el disco. El control tiene en cuenta los siguientes aspectos: nodo servidor o agente; sistema en línea o sin conexión; nodo del servidor principal o secundario.
Conectividad de SQL Server	Valida la conectividad al SQL Server y la base de datos configurados. La comprobación tiene en cuenta los siguientes aspectos: conectividad al host de SQL Server (punto final) en un punto final determinado; conectividad a la base de datos principal si create_db está establecido en true; crear permisos de la base de datos (dbcreator) si create_db está establecido en true; crear permisos de esquema (db_ddladmin), leer (db_datareader) y escribir (db_datawriter); conectividad a la base de datos cuando create_db está establecido en false; requisitos especiales para cada servicio. Por ejemplo, para Insights, el script comprueba el índice de almacén de columnas, la compatibilidad con json y si el nivel de compatibilidad de SQL Server es> = 130; Conectividad a la base de datos y SQL Server con autenticación integrada.
Certificado de servidor	Comprueba que el certificado del servidor que proporcionó es válido. El control tiene en cuenta los siguientes aspectos: el formato del archivo del certificado es .pem, es decir Certificado DER codificado en Base64; la longitud de la clave privada es de al menos 2048; Uso de clave extendido: TLS Web Server Authentication; obligatorio para acceder a Automation Suite en dispositivos iOS; Nombre alternativo del sujeto para todas las entradas DNS necesarias; el certificado del servidor y la clave privada coinciden; el paquete de CA que proporcionó es en realidad el emisor del certificado de servidor; la validez del certificado es de más de 30 días.
Certificados de firma de tokens	Comprueba que el certificado de firma de tokens que proporcionó es válido. La comprobación tiene en cuenta los siguientes aspectos: el certificado está en formato pfx ; la contraseña para descifrar el certificado es válida; la validez del certificado es de más de 30 días.
Proxy	Valida que haya configurado correctamente el proxy. La comprobación tiene en cuenta los siguientes aspectos: https_proxy, http_proxyy no_proxy se establecen como variables de entorno en la máquina; el servidor proxy es accesible.
Conectividad	Valida que todas las máquinas puedan conectarse entre sí, que todas las URL requeridas estén en la lista de permitidos del firewall, etc. La comprobación tiene en cuenta los siguientes aspectos: el FQDN de Automation Suite y el FQDN de todos los demás subdominios se pueden resolver desde la máquina; en una configuración en línea, todas las URL externas son accesibles desde la máquina; todos los servidores, agentes y nodos contaminados pueden conectarse entre sí en los puertos necesarios; las conexiones salientes (URL) se pueden resolver a través de todos los servidores de nombres presentes en /etc/resolve.conf; si alguna de las URL no se puede resolver a través de todos los servidores de nombres, al menos un servidor de nombres puede resolver todas las URL; se permite el protocolo TCP o UDP; fixed_rke_address está configurado en el puerto 9345 y 6443; se emite una respuesta cuando se realiza una llamada al FQDN en el puerto 443.
Servicios del sistema	Valida que los servicios del sistema estén configurados correctamente. La comprobación tiene en cuenta los siguientes aspectos: nm-cloud-setup.service, nm-cloud-setup.timer, firewalld están deshabilitados; iscsi-initiator-utils está instalado y habilitado; auditd está configurado correctamente para --backlog_wait_time establecido como 1; logrotate está configurado correctamente; net.ipv4.conf.all.rp_filter está deshabilitado (establecido en 0).
Requisitos de software	Valida que esté instalado todo el software necesario. Si algún software no está instalado, el instalador de install-uipath.sh intenta instalarlo.

Using the script to validate installation prerequisites

Descargar el script

Nota: Para las instalaciones sin conexión, debes realizar este paso en una máquina con acceso a Internet y a máquinas aisladas en las que se haya implementado Automation Suite. Copie el archivo de la máquina en línea a la primera máquina de destino.

El script de requisito previo se empaqueta junto con el instalador en un archivo llamado sf-installer.zip, y las herramientas de soporte se incluyen como sf-infra.tar.gz solo para sin conexión. Necesita estos archivos para generar un informe en todas las máquinas en las que planea instalar Automation Suite.

Tipo de instalación	Archivos para descargar
En línea	sf-installer.zip : obligatorio. Para obtener instrucciones de descarga, consulta sf-installer.zip.
Sin conexión	sf-installer.zip : obligatorio. Para obtener instrucciones de descarga, consulta sf-installer.zip. sf-infra.tar.gz : obligatorio. Para obtener instrucciones de descarga, consulta sf-infra.tar.gz.

Preparación para usar el script

1. Conviértase en raíz ejecutando el siguiente comando:

   sudo su -

2. Copia los archivos en la carpeta /opt/UiPathAutomationSuite/{version} ejecutando el siguiente 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. Descomprime el paquete ejecutando el siguiente comando:

   unzip sf-installer.zip -d installer

4. Asigne los permisos necesarios y navegue a la carpeta del script ejecutando el siguiente comando:

   chmod -R 755 installer
   cd installer

Parámetros de los scripts

Para ver la sección de ayuda y los indicadores compatibles, ejecuta el siguiente comando:

./validateUiPathASReadiness.sh --help

Salida:

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

La siguiente tabla describe los parámetros que puede utilizar al ejecutar el script:

Parámetro	Descripción
-i|--input	Acepta el archivo cluster_config.json como entrada. Este archivo define los parámetros, la configuración y las preferencias que se aplican a los servicios de UiPath implementados a través de Automation Suite. Para obtener más información, consulta Experiencia de instalación avanzada. Si no proporcionas este archivo, el script desencadenará la experiencia interactiva para recopilar estas entradas. El archivo se generará en su nombre.
-d|--debug	Modo de depuración para obtener detalles adicionales útiles para la depuración.
-m|--machines	Acepta direcciones IP / nombres de host separados por comas de todas las máquinas. Esto es necesario para verificar la conectividad entre todos los nodos en el puerto requerido. El parámetro es obligatorio para instalaciones de producción multinodo preparadas para alta disponibilidad. Además de eso, el parámetro también es necesario si planeas añadir un nodo de Task Mining, GPU o Automation Suite Robots en un clúster de evaluación de un solo nodo.
-n|--node-type	Acepta el tipo del nodo actual. Los valores posibles son: server, agent, task-mining, gpuy asrobots. El valor predeterminado es server.
--install-type	Acepta el método de instalación: online o offline. El valor predeterminado es online.
--prereq-bundle	Acepta la ruta absoluta en la que se encuentra sf-infra.tar.gz .
--prereq-tmp-folder	Acepta la ruta absoluta donde se extraerá temporalmente el paquete sf-infra.tar.gz . Si no se proporciona esta ruta, el instalador seleccionará la carpeta /tmp .
--kubeconfig	Especifique la ruta del archivo kubeconfig.
validate-packages	Valida los paquetes RPM necesarios.
install-packages	Instala los paquetes RPM necesarios para la instalación en línea.
install-packages --install-type offline	Instala los paquetes necesarios de RPM para la instalación sin conexión.

Validating a multi-node HA-ready production setup

En la primera máquina servidor

1. Para validar la primera máquina del servidor, ejecute el siguiente comando:

En línea

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

Sin conexión

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

Una vez que se ejecuta este script, genera un archivo cluster_config.json en la carpeta /opt/UiPathAutomationSuite . Este archivo es necesario en todas las demás máquinas.

2. Para copiar el archivo cluster_config.json en las otras máquinas, ejecute el siguiente comando:

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

Nota:

Si no puedes copiar el archivo en la carpeta /opt/UiPathAutomationSuite debido a errores de permisos, puedes copiarlo temporalmente en /var/tmp en las máquinas nuevas y, a continuación, moverlo a /opt/UiPathAutomationSuite.

También puedes proporcionar permisos de acceso completo (777) a la carpeta /opt/UiPathAutomationSuite en las máquinas nuevas, ejecutando el siguiente comando: chmod -R 777 /opt/UiPathAutomationSuite.

En otras máquinas del servidor

Para validar las otras máquinas del servidor, ejecuta el siguiente comando:

En línea

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

Sin conexión

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

En máquinas con agente

Para validar las máquinas agente, ejecuta el siguiente comando:

En línea

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

Sin conexión

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

En máquinas con agentes especializados

Para validar las máquinas de Task Mining, GPU o Automation Suite Robots, ejecuta el siguiente comando:

Nota:

Asegúrate de utilizar el parámetro adecuado para identificar tu nodo de agente especializado:

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

En línea

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

Sin conexión

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