Configurar las máquinas

Configurar el disco

Importante:

• Para evitar la pérdida de datos, asegúrese de que la infraestructura que utiliza no elimina automáticamente los discos del clúster al reiniciarlo o apagarlo. Si esta función está activada, asegúrese de desactivarla.
• To ensure a smooth and uninterrupted SSH session, we strongly recommend that you follow the steps in Installation best practices before configuring the disks and installing Automation Suite.

Puedes configurar y particionar los discos utilizando el script configureUiPathDisks.sh . Para obtener más información, consulta las siguientes secciones.

Requisitos del disco

Antes de proceder a la instalación, hay que realizar una partición del disco y configurarlo mediante LVM, de modo que su tamaño pueda modificarse fácilmente y sin que se produzcan migraciones o pérdidas de datos.

Realizar partición del disco

La estructura de partición predeterminada en las máquinas RHEL no es adecuada para la instalación de Kubernetes. Esto se debe a que la infraestructura de Kubernetes suele instalarse en la partición /var. De manera predeterminada, a la partición var solo se le asignan 8 GB de espacio.

Nota:

• El formato admitido para el disco es ext4 o xfs.
• Todas las particiones deben crearse con LVM. Esto tiene la finalidad de garantizar que los datos del clúster puedan residir en un disco diferente y puedan verse correctamente. También permite ampliar el tamaño de la partición en un futuro sin riesgo de migración o pérdida de datos.
• Todos los registros de pods y aplicaciones se almacenan en el directorio /var/log/pods . Asegúrate de que la capacidad de este directorio es de al menos 8 GB. También recomendamos configurar logrotate para rotar los registros en un intervalo que va de diario a semanal.

Para el sistema operativo RHEL, asegúrate de disponer de los siguientes tamaños mínimos de puntos de instalación en la máquina.

En línea

Etiqueta de disco	Partición	Tamaño	Propósito
Disco del clúster	/var/lib/rancher	190 GB	La carpeta Rancher almacena imágenes y capas
	/var/lib/kubelet	56 GB	La carpeta Kubernetes almacena las configuraciones de tiempo de ejecución de Kubernetes, como secrets, configmaps y emptyDir
	/opt/UiPathAutomationSuite	10 GB	Instalador binario
Disco etcd	/var/lib/rancher/rke2/server/db	16 GB	Base de datos distribuida para Kubernetes
Bloquear almacenamiento	/datadisk	512 GB	Abstracción del almacenamiento en bloque
Objectstore1	N/D	512 GB	Almacén de objetos en el clúster

¹ This refers to the in-cluster objectstore and is not applicable if you use external objectstore.

Nota:

Te recomendamos no utilizar el disco del sistema operativo para ninguno de los anteriores fines, para garantizar que los procesos reciban la cantidad justa de recursos.

Sin conexión

Nota:

Los requisitos para el modo sin conexión son los mismos que para el modo en línea, excepto para la primera máquina en la que se ejecuta la instalación, la cual necesita los siguientes requisitos.

Es necesario disponer de espacio adicional para extraer el paquete sin conexión.

Etiqueta de disco	Partición	Tamaño	Propósito
Disco del clúster	/var/lib/rancher	190 GB	La carpeta Rancher almacena imágenes y capas
	/var/lib/kubelet	56 GB	La carpeta Kubernetes almacena las configuraciones de tiempo de ejecución de Kubernetes, como secrets, configmaps y emptyDir
	/opt/UiPathAutomationSuite	10 GB	Instalador binario
Disco etcd	/var/lib/rancher/rke2/server/db	16 GB	Base de datos distribuida para Kubernetes
Bloquear almacenamiento	/datadisk	512 GB	Abstracción del almacenamiento en bloque
Objectstore1	N/D	512 GB	Almacén de objetos en el clúster
Disco de paquete de UiPath	/uipath	512 GB	Paquete aislado

¹ This refers to the in-cluster objectstore and is not applicable if you use external objectstore.

Nota:

Te recomendamos no utilizar el disco del sistema operativo para ninguno de los anteriores fines, para garantizar que los procesos reciban la cantidad justa de recursos.

Nota:

Los discos de datos y etcd deben ser discos físicos independientes. De esta manera, los datos y el disco etcd están físicamente aislados de otras cargas de trabajo y actividades del clúster, a la vez que se mejoran el rendimiento y la estabilidad del clúster.

Consulte la siguiente sección para obtener detalles sobre cómo utilizar el script de ejemplo para realizar una partición del disco y configurarlo antes de la instalación.

Utilizar el script para configurar el disco

Descargar el script

Nota:

Para las instalaciones sin conexión, debe 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 máquina de destino.

Puedes utilizar el script configureUiPathDisks.sh para configurar y realizar una partición del disco.

For download instructions, see configureUiPathDisks.sh.

Ejecutar el script

El script configureUiPathDisks.sh puede utilizarse para los siguientes fines:

• configurar los discos y puntos de instalación para una nueva instalación de clúster de Automation Suite;
• cambiar el tamaño del disco de datos después de la instalación.

Para hacer que el script sea ejecutable, ejecute:

chmod +x ./configureUiPathDisks.sh

Para obtener más detalles sobre el uso del script, ejecute:

sudo ./configureUiPathDisks.sh --help

***************************************************************************************

Utility to configure the disk for UiPath Automation Suite Installation.
Run this script to configure the disks on new machine or to extend the size of datadisk

Arguments
  -n|--node-type                  NodeType, Possible values: agent, server. Default to server.
  -i|--install-type               Installation mode, Possible values: online, offline. Default to online.
  -c|--cluster-disk-name          Device to host rancher and  kubelet. Ex: /dev/sdb.
  -e|--etcd-disk-name             Device to host etcd, Not required for agent node. Ex: /dev/sdb.
  -R|--ceph-raw-disk-name         Device to host ceph OSD, Not required for agent node. Ex: /dev/sdm
  -l|--data-disk-name             Device to host datadisk, Not required for agent node. Ex: /dev/sdc.
  -b|--bundle-disk-name           Device to host the uipath bundle.
                                    Only required for offline installation on 1st server node.
  -k|--robot-package-disk-name    Device to host robot package cache folder
                                    Only required for Automation Suite Robots dedicated node when 'packagecaching' is enabled
  -P|--robot-package-path         Path to robot package cache folder
                                    (defaults to '/uipath_asrobots_package_cache' if not set)
  -f|--complete-suite             Installing complete product suite or any of these products:
                                    aicenter, apps, taskmining, documentunderstanding.
                                    This will configure the datadisk volume to be 2TiB instead of 512Gi.
  -p|--primary-server             Is this machine is first server machine? Applicable only for airgap install.
                                    This is the machine on which UiPath AutomationSuite bundle will be installed.
                                    Default to false.
  -x|--extend-data-disk           Extend the datadisk. Either attach new disk or resize the exiting datadisk.
  -r|--resize                     Used in conjunction of with --extend-data-disk to resize the exiting volume,
                                    instead of adding new volume.
  -d|--debug                      Run in debug.
  -h|--help                       Display help.

ExampleUsage:

  configureUiPathDisks.sh --node-type server --install-type online \
    --cluster-disk-name /dev/sdb --etcd-disk-name /dev/sdc \
    --data-disk-name /dev/sdd

  configureUiPathDisks.sh --data-disk-name /dev/sdh \
    --extend-data-disk

***************************************************************************************

Configurar el disco para una instalación de evaluación de nodo único

En línea

Para configurar el disco en una configuración de evaluación de nodo único en línea, ejecute el siguiente comando en la máquina:

./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk \
  --etcd-disk-name name_of_etcd_disk \
  --data-disk-name name_of_data_disk

Sin conexión

En una instalación sin conexión, deberá cargar las imágenes del producto en el registro de Docker. Por consiguiente, se requiere almacenamiento adicional en forma de disco independiente para alojar el paquete de productos UiPath.

Para configurar el disco en una configuración de evaluación de nodo único sin conexión, ejecute el siguiente comando en la máquina:

./configureUiPathDisks.sh --cluster-disk-name name_of_cluster_disk \
  --etcd-disk-name name_of_etcd_disk \
  --data-disk-name name_of_data_disk \
  --bundle-disk-name name_of_uipath_bundle_disk \
  --primary-server \
  --install-type offline

Nota:

Si tiene un nodo agente adicional para Task Mining o una GPU, solo se requiere un disco de clúster en ese nodo. Puede ejecutar el script proporcionando el nombre del disco del clúster y especificando el tipo de nodo como agente.

Configuración del disco del almacén de objetos

Nota:

Un problema conocido de Azure marca incorrectamente el disco de Azure como no SSD. Si Azure es tu proveedor de la nube y quieres configurar el disco de Objectstore, sigue las instrucciones en Resolución de problemas.

Puedes expandir el tamaño de tu almacenamiento para el objectstore en el clúster ejecutando el siguiente script:

./configureUiPathDisks.sh --ceph-raw-disk-name name_ceph_raw_disk

Para aumentar el tamaño de tu almacenamiento en el clúster después de la instalación, vuelve a ejecutar el mismo comando.

Ampliar el disco de datos tras la instalación

Para ampliar el disco de datos, puede asociar el nuevo disco físico o cambiar el tamaño del disco existente.

Añadir un disco nuevo

Para ampliar el disco de datos utilizando el disco recién asociado, ejecute el siguiente comando en la máquina del servidor:

./configureUiPathDisks.sh --data-disk-name name_of_data_disk \
  --extend-data-disk

Cambiar tamaño del disco existente

Para ampliar el disco de datos cambiando el tamaño de un disco existente, ejecute el siguiente comando en la máquina del servidor:

./configureUiPathDisks.sh --extend-data-disk --resize

Validar instalaciones de disco

1. Realice los pasos siguientes para validar que /etc/fstab está correctamente configurado para gestionar el reinicio del sistema.

   Nota:

   Asegúrese de que los puntos de instalación de etcd y datadisk se añaden al archivo fstab.

   Si tiene una partición de disco independiente para /var/lib/rancher y /var/lib/kubelet, entonces también fstab debe contener estas dos carpetas. Asegúrese también de incluir la opción nofail en esas entradas de fstab para que no afecte al arranque de la máquina virtual en caso de fallos.

2. Valide que los discos están correctamente instalados ejecutando el siguiente comando:

   mount -afv
   

3. Debe obtener la siguiente respuesta:

   /datadisk                              : already mounted
   /var/lib/rancher/rke2/server/db        : already mounted
   /var/lib/rancher                       : already mounted
   /var/lib/kubelet                       : already mounted
   

Configuring kernel and OS level settings

La siguiente página ayuda a los administradores de Linux a gestionar la configuración del sistema operativo y el kernel antes de realizar una instalación de Automation Suite.

Normalmente, esta configuración se gestiona a través de una herramienta de configuración de gestión dedicada, como Puppet. Asegúrate de que los cambios que realices sean según el proceso de control de tu entorno para fines de coherencia y documentación.

Importante:

Asegúrate de completar los siguientes pasos antes de iniciar la instalación, ya que una mala configuración a nivel del sistema operativo y del núcleo puede provocar errores no intuitivos. Comprobar esta configuración específica a menudo puede evitar tales errores.

Deshabilitar la memoria de intercambio

Debes deshabilitar el intercambio de memoria antes de instalar Automation Suite. Se sabe que la memoria de intercambio causa problemas con las cargas de trabajo del contenedor. Además, las cargas de trabajo de Automation Suite no se benefician de utilizar la memoria de intercambio y Kubernetes ya optimiza el uso de la memoria.

Configuración de sysctl

Se requiere la siguiente configuración sysctl en la máquina:

• HabilitarTransmisiónDeLaIP
• deshabilitar el filtrado de ruta inversa

Puedes hacerlo ejecutando el siguiente comando:

cat <<EOF >>"/etc/sysctl.d/99-sysctl.conf"
net.bridge.bridge-nf-call-iptables = 1
net.ipv4.ip_forward = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.ipv4.conf.all.rp_filter=0
EOF

Nota:

nf-call-iptables es necesario para la mayoría de las implementaciones de Kubernetes. Kubernetes crea redes virtuales internas al clúster. Esto permite que cada pod tenga su propia dirección IP, que se utiliza junto con los servicios de nombres internos para facilitar la comunicación entre servicios. El clúster no funciona si nf-call-iptables no está habilitado. Para obtener más información, consulta la documentación de Kubernetes oficial.

Para aplicar la configuración, ejecuta el siguiente comando:

sysctl --system

Configuración de fapolicy

Importante:

Este paso es opcional y solo se aplica si utilizas fapolicy. En este caso, se requiere una política específica de RKE2.

Para generar la política RKE2, utiliza el siguiente comando:

cat <<-EOF >>"/etc/fapolicyd/rules.d/69-rke2.rules"
allow perm=any all : dir=/var/lib/rancher/
allow perm=any all : dir=/opt/cni/
allow perm=any all : dir=/run/k3s/
allow perm=any all : dir=/var/lib/kubelet/
allow perm=any all : dir=/root/.local/share/helm
EOF

Nota:

Asegúrate de que el cambio se comunique a tu equipo de Linux y pase por los procesos de gestión de la configuración adecuados.

Configuración de noexec y nosuid

Los discos utilizados para el montaje /var no deben tener noexec o nosuid. La herramienta de disco crea automáticamente estos montajes sin estas propiedades.

Importante:

Si un administrador de Linux establece manualmente estas propiedades, la instancia se convierte en no funcional.

For more details on disk configuration, see Disk requirements.

Habilitar puertos

Asegúrese de tener habilitados los siguientes puertos en su firewall para cada origen.

Puerto	Protocolo	Origen	Propósito	Requisitos
22	TCP	Servidor de salto o máquina cliente	Para SSH (instalación, depuración de la gestión del clúster)	No abra este puerto a Internet. Permitir el acceso a la máquina cliente o al servidor de salto
80	TCP		Solo instalación sin conexión: necesaria para el envío de notificaciones del sistema por correo electrónico.
443	TCP	Todos los nodos de un clúster y el equilibrador de carga	Para HTTPS (acceso a Automation Suite)	Este puerto debe tener conectividad de entrada y salida desde todos los nodos del clúster y el equilibrador de carga.
587	TCP		Solo instalación sin conexión: necesaria para el envío de notificaciones del sistema por correo electrónico.
9090	TCP	Todos los nodos en un clúster	Utilizado por Cilium para supervisar y gestionar fallos de pod.	Este puerto debe tener conectividad entrante y saliente de todos los nodos del clúster.

Si habilitó Task Mining y proporcionó un nodo dedicado de Task Mining y/o aprovisionó un nodo dedicado compatible con GPU, asegúrese de que, además de lo anterior, tiene habilitados los siguientes puertos en su firewall:

Puerto	Protocolo	Origen	Propósito	Requisitos
2379	TCP	Todos los nodos de un clúster	Puerto cliente etcd	No debe exponerse a Internet. El acceso entre nodos debe ser suficiente a través de una dirección IP privada.
2380	TCP	Todos los nodos de un clúster	Puerto de pares etcd	No debe exponerse a Internet. El acceso entre nodos debe ser suficiente a través de una dirección IP privada.
6443	TCP	Todos los nodos de un clúster	Se requiere para acceder a la API de Kubernetes mediante HTTPS y para la unión de nodos	Este puerto debe tener conectividad entrante y saliente de todos los nodos del clúster.
8472	UDP	Todos los nodos de un clúster	Obligatorio para Cilium.	No debe exponerse a Internet. El acceso entre nodos debe ser suficiente a través de una dirección IP privada.
9345	TCP	Todos los nodos de un clúster y el equilibrador de carga	Se requiere para acceder a la API de Kubernetes mediante HTTPS, para la unión de nodos	Este puerto debe tener conectividad de entrada y salida desde todos los nodos del clúster y el equilibrador de carga.
10250	TCP	Todos los nodos de un clúster	Kubelet o servidor de métricas	No debe exponerse a Internet. El acceso entre nodos debe ser suficiente a través de una dirección IP privada.
30071	TCP	Todos los nodos de un clúster	Puerto NodePort para la comunicación interna entre los nodos de un clúster	No debe exponerse a Internet. El acceso entre nodos debe ser suficiente a través de una dirección IP privada.

Importante:

Exponer el puerto 6443fuera del límite del clúster es obligatorio si hay una conexión directa a la API de Kerberos.

Los nodos utilizan el puerto 9345 para descubrir nodos existentes y unirse al clúster en la implementación multinodo. Para mantener en funcionamiento los mecanismos de descubrimiento de alta disponibilidad, recomendamos exponerlo a través del equilibrador de carga con la comprobación de estado.

Asegúrese también de tener conectividad desde todos los nodos al servidor SQL.

No expongas el servidor SQL en uno de los puertos reservados de Istio, ya que puede provocar fallos de conexión.

Si tiene un firewall configurado en la red, asegúrese de que estos puertos están abiertos y se permite el tráfico de acuerdo con los requisitos mencionados anteriormente.

Installing the required RPM packages

Para instalar y validar los paquetes RPM necesarios, puede utilizar cualquiera de las siguientes herramientas

• the install-uipath.sh manual installer. In online environments, it installs and validates all RPM packages by default.
• el instalador interactivo installUiPathAS.sh . Valida todos los paquetes RPM a través del instalador install-uipath.sh .
• the validateUiPathASReadiness.sh script:
  • para validar los paquetes RPM, ejecute: validateUiPathASReadiness.sh validate-packages;
  • para instalar los paquetes RPM en una instalación en línea, ejecute: validateUiPathASReadiness.sh install-packages;
  • para instalar los paquetes RPM en una instalación fuera de línea, ejecute: validateUiPathASReadiness.sh install-packages --install-type offline.

For a list of RPM package requirements, see Hardware and software requirements.

Opcional: habilitar FIPS 140-2

En esta sección se explica cómo habilitar FIPS 140-2 en tus máquinas.

Puedes habilitar FIPS en tus máquinas virtuales basadas en Red Hat Linux. Para hacerlo, sigue los siguientes pasos:

1. Habilita FIPS ejecutando el siguiente comando en todas tus máquinas antes de iniciar la instalación:

   fips-mode-setup --enable
   

2. Reinicia tus máquinas y comprueba si has habilitado FIPS correctamente ejecutando el siguiente comando:

   fips-mode-setup --check
   

Importante:

Insights no es compatible actualmente con máquinas habilitadas para FIPS 140-2. Asegúrate de deshabilitar Insights al instalar Automation Suite en máquinas habilitadas para FIPS 140-2.

For details on the additional steps you must take to start using Automation Suite on FIPS 140-2 machines, see Security best practices.

Opcional: configurar el servidor proxy

Para configurar un proxy, es necesario realizar pasos de configuración adicionales durante la configuración de su entorno con los requisitos previos y en la fase de configuración avanzada.

Los pasos siguientes son obligatorios para la configuración del entorno.

Actualmente no se admite proxy HTTPS con certificados autofirmados. Asegúrese de utilizar un certificado público de confianza si va a configurar el proxy.

Paso 1: habilitar puertos en la red virtual

Asegúrese de que las siguientes reglas están habilitadas en su grupo de seguridad de red para la red virtual específica.

Origen	Destination	Redireccionamiento a través de proxy	Puerto	Descripción
Red virtual	Sql	No	Puerto del servidor SQL	Necesario para el servidor SQL.
Red virtual	Load balancer	No	9345 6443	Se requiere para añadir nuevos nodos al clúster.
Red virtual	Clúster (subred)	No	Todos los puertos	Se requiere para la comunicación a través de un rango de IP privado.
Red virtual	alm.<fqdn>	No	443	Se requiere para iniciar sesión y utilizar el cliente ArgoCD durante la implementación.
Red virtual	Servidor Proxy	Sí	Todos los puertos	Se requiere para redirigir el tráfico al servidor proxy.
Red virtual	Servidor de nombres	No	Todos los puertos	La mayoría de los servicios en la nube, como Azure y AWS, lo utilizan para obtener los metadatos de la máquina virtual y lo consideran una IP privada.
Red virtual	Servidor de metadatos	No	Todos los puertos	La mayoría de los servicios en la nube, como Azure y AWS, utilizan la dirección IP 169.254.169.254 para obtener los metadatos de las máquinas.

Paso 2: añadir la configuración del proxy a cada nodo

Al configurar los nodos, es necesario añadir la configuración del proxy a cada nodo que forma parte del clúster. Este paso es necesario para redireccionar el tráfico saliente del nodo a través del servidor proxy.

1. Añada la siguiente configuración en /etc/environment:

   http_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT>
   https_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT>
   no_proxy=alm.<fqdn>,<fixed_rke2_address>,<named server address>,<metadata server address>,<private_subnet_ip>,localhost,<Comma separated list of ips that should not got though proxy server>
   

2. Añada la siguiente configuración en /etc/wgetrc:

   http_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT>
   https_proxy=http://<PROXY-SERVER-IP>:<PROXY-PORT>
   no_proxy=alm.<fqdn>,<fixed_rke2_address>,<named server address>,<metadata server address>,<private_subnet_ip>,localhost,<Comma separated list of ips that should not got though proxy server>
   

   Parámetros obligatorios	Descripción
   http_proxy	Se utiliza para redirigir las peticiones salientes HTTP del nodo. Debe ser el FQDN y el puerto del servidor proxy.
   https_proxy	Se utiliza para redirigir las peticiones salientes HTTPS del nodo. Debe ser el FQDN y el puerto del servidor proxy.
   no_proxy	Lista separada por comas de hosts, direcciones IP que no desea enrutar a través del servidor proxy. Debe ser una subred privada, un host de servidor SQL, una dirección de servidor con nombre, una dirección de servidor de metadatos: alm.<fqdn>,<fixed_rke2_address>,<named server address>,<metadata server address> named server address – La mayoría de los servicios en la nube, como Azure y AWS, lo utilizan para resolver consultas de DNS. metadata server address – La mayoría de los servicios en la nube, como Azure y AWS, utilizan la dirección IP 169.254.169.254 para obtener los metadatos de la máquina. Si utilizas AI Center con un Orchestrator externo, debes añadir el dominio de Orchestrator externo a la lista no_proxy.

3. Verifique si la configuración del proxy es correcta ejecutando el siguiente comando:

   curl -v $HTTP_PROXY
   curl -v <fixed_rke_address>:9345
   

   Importante:

   Una vez que se cumplan los requisitos del servidor proxy, asegúrese de continuar con la configuración del proxy durante la instalación. Siga los pasos de Opcional: configurar el servidor proxy para asegurarse de que el servidor proxy está configurado correctamente.