- Información general
- Requisitos
- Plantillas de implementación
- Manual: preparar la instalación
- Manual: preparar la instalación
- Paso 2: configurar el registro compatible con OCI para las instalaciones sin conexión
- Paso 3: configurar el almacén de objetos externo
- Paso 4: configurar High Availability Add-on
- Paso 5: configurar las bases de datos SQL
- Paso 6: configurar el equilibrador de carga
- Paso 7: configurar el DNS
- Paso 8: configurar los discos
- Paso 9: configurar los ajustes a nivel de kernel y sistema operativo
- Paso 10: configurar los puertos de nodo
- Paso 11: aplicar ajustes varios
- Paso 12: Validar e instalar los paquetes RPM necesarios
- Paso 13: Generar cluster_config.json
- Configuración de certificados
- Configuración de la base de datos
- Configuración del almacén de objetos externo
- Configuración de URL prefirmada
- Configuración de la autenticación Kerberos
- Configuración de registro externo compatible con OCI
- Disaster recovery: configuraciones activas/pasivas y activas/activas
- Configuración de High Availability Add-on
- Configuración específica de Orchestrator
- Configuración específica de Insights
- Process Mining-specific configuration
- Configuración específica de Document Understanding
- Automation Suite Robots-specific configuration
- Configuración de la supervisión
- Opcional: configurar el servidor proxy
- Opcional: habilitación de la resistencia a fallos de zona en un clúster multinodo de producción preparada para alta disponibilidad
- Opcional: pasar resolv.conf personalizado
- Optional: Increasing fault tolerance
- parámetros de install-uipath.sh
- Inclusión de un nodo agente dedicado compatible con GPU
- Añadir un nodo agente dedicado a Task Mining
- Conexión de la aplicación Task Mining
- Añadir un nodo agente dedicado a Automation Suite Robots
- Paso 15: configurar el registro temporal de Docker para las instalaciones sin conexión
- Paso 16: validar los requisitos previos para la instalación
- Manual: realizar la instalación
- Después de la instalación
- Administración de clústeres
- Gestionar los productos
- Primeros pasos con el Portal de administración del clúster
- Migrar del en el clúster a High Availability Add-on externo
- Migrar del registro en clúster a un registro externo compatible con OCI
- Cambiar manualmente al clúster secundario en una configuración activa/pasiva
- Disaster Recovery: realizar operaciones posteriores a la instalación
- Convertir una instalación existente en una configuración en varios sitios
- Directrices sobre la actualización de una implementación activa/pasiva o activa/activa
- Directrices sobre la copia de seguridad y restauración de una implementación activa/pasiva o activa/activa
- Redireccionando el tráfico de los servicios no compatibles al clúster principal
- Escalar una implementación de nodo único (evaluación) a una implementación multinodo (HA)
- Supervisión y alertas
- Migración y actualización
- Paso 1: Mover los datos de la organización de identidad de independiente a Automation Suite
- Paso 2: restaurar la base de datos del producto independiente
- Paso 3: Realizar una copia de seguridad de la base de datos de la plataforma en Automation Suite
- Paso 4: Fusionar organizaciones en Automation Suite
- Paso 5: actualizar las cadenas de conexión de los productos migrados
- Paso 6: migrar el Orchestrator independiente
- Paso 7: migrar Insights independiente
- Paso 8: Migrar Test Manager independiente
- Paso 9: eliminar el tenant predeterminado
- Realizar una migración de un solo tenant
- Migrar de Automation Suite en Linux a Automation Suite en EKS / AKS
- Actualizar Automation Suite
- Descargar los paquetes de instalación y obtener todos los archivos del primer nodo del servidor
- Recuperar la última configuración aplicada del clúster
- Actualizar la configuración del clúster
- Configurar el registro compatible con OCI para las instalaciones sin conexión
- Ejecutar la actualización
- Realizar operaciones posteriores a la actualización
- Configuración específica del producto
- Uso de la herramienta de configuración de Orchestrator
- Configurar parámetros de Orchestrator
- Configuración de Orchestrator
- Configurar AppSettings
- Configurar el tamaño máximo de la solicitud
- Anular la configuración de almacenamiento a nivel de clúster
- Configurar almacenes de credenciales
- Configurar clave de cifrado por tenant
- Limpiar la base de datos de Orchestrator
- Buenas prácticas y mantenimiento
- Solución de problemas
- Cómo solucionar los problemas de los servicios durante la instalación
- Cómo desinstalar el clúster
- Cómo limpiar los artefactos sin conexión para mejorar el espacio en disco
- Cómo borrar datos de Redis
- Cómo habilitar el registro de Istio
- Sacar a Ceph del modo solo lectura
- Cómo limpiar los registros antiguos almacenados en el depósito sf-logs
- Cómo deshabilitar los registros de transmisión para AI Center
- Cómo depurar instalaciones de Automation Suite fallidas
- Cómo eliminar imágenes del instalador antiguo después de la actualización
- Cómo deshabilitar la descarga de la suma de comprobación TX
- Cómo actualizar desde Automation Suite 2022.10.10 y 2022.4.11 a 2023.10.2
- Cómo establecer manualmente el nivel de registro de ArgoCD en Info
- Cómo expandir el almacenamiento de AI Center
- Cómo generar el pull_secret_value codificado para registros externos
- Cómo abordar los cifrados débiles en TLS 1.2
- Cómo trabajar con certificados
- Cómo reenviar registros de aplicaciones a Splunk
- Cómo limpiar las imágenes de Docker no utilizadas de los pods de registro
- Cómo recopilar datos de uso de DU con el almacén de objetos en el clúster (Ceph)
- Cómo instalar RKE2 SELinux en entornos aislados
- Cómo limpiar copias de seguridad diferenciales antiguas en un servidor NFS
- No se puede ejecutar una instalación sin conexión en el sistema operativo RHEL 8.4
- Error al descargar el paquete
- La instalación sin conexión falla porque falta un binario
- Error en la comprobación de requisitos previos para el módulo iscsid de selinux
- Azure disk not marked as SSD
- Fallo tras la actualización del certificado
- El antivirus causa problemas de instalación
- Automation Suite not working after OS upgrade
- Automation Suite requiere que backlog_wait_time se establezca en 0
- El volumen no se puede montar porque no está listo para las cargas de trabajo
- Error de recopilación de registros del paquete de soporte
- Se ignora la cadena de conexión SQL de la automatización de pruebas
- Configuración de DNS no respetada por CoreDNS
- Pérdida de datos al reinstalar o actualizar Insights tras la actualización de Automation Suite
- La actualización de nodo único falla en la etapa de tejido
- Upgrade fails due to unhealthy Ceph
- El volumen no se puede montar y permanece en estado de bucle de conexión/desconexión
- La actualización falla debido a objetos clásicos en la base de datos de Orchestrator
- El clúster de Ceph se encuentra en un estado degradado tras una actualización en paralelo.
- Un componente Insights en mal estado provoca el fallo de la migración
- La actualización del servicio falla para Apps
- Tiempos de actualización in situ
- La migración del registro de Docker se atasca en la fase de eliminación de PVC
- Error de aprovisionamiento de AI Center después de actualizar a 2023.10 o posterior
- La actualización falla en entornos sin conexión
- La validación SQL falla durante la actualización
- pod de snapshot-controller-crds en estado CrashLoopBackOff después de la actualización
- Error de actualización/reinstalación del punto final de la API REST de Longhorn
- La actualización falla debido a los tamaños de PVC de Insights anulados
- La actualización del servicio falla durante la ejecución del script previo al servicio
- Fallo al cargar o descargar datos en el almacén de objetos
- PVC resize does not heal Ceph
- Fallo en el redimensionamiento de PVC de objectstore
- Error de archivo adjunto de volumen de StatefulSet
- Rook Ceph o Looker pod atascados en estado Init
- Error al compactar las métricas debido a bloques corruptos en Thanos
- Establecer un intervalo de tiempo de espera para los portales de gestión
- La autenticación no funciona tras la migración
- kinit: no se puede encontrar la KDC para el territorio <AD Domain> mientras se obtienen las credenciales iniciales
- kinit: keytab no contiene claves adecuadas para *** mientras se obtienen las credenciales iniciales
- Error en la operación GSSAPI debido a un código de estado no válido
- Alarma recibida por un error en el trabajo de Kerberos-tgt-update
- Proveedor de SSPI: servidor no encontrado en la base de datos de Kerberos
- Error en inicio de sesión de un usuario AD debido a una cuenta deshabilitada
- ArgoCD login failed
- Fallo en la obtención de la imagen de Sandbox
- Los pods no se muestran en la interfaz de usuario de ArgoCD
- Fallo de la sonda Redis
- El servidor RKE2 no se inicia
- ArgoCD entra en estado de progreso tras la primera instalación
- Mitigación manual de Política de red de ArgoCD (GHSA-47m3-95c7-g2g8)
- Unhealthy services after cluster restore or rollback
- Faltan métricas de Ceph-rook en los paneles de supervisión
- Los pods no pueden comunicarse con FQDN en un entorno de proxy
- Error al configurar las alertas de correo electrónico después de la actualización
- No hay problema ascendente en buen estado
- Error al añadir nodos agente en entornos sin conexión
- El acceso a FQDN devuelve RBAC: error de acceso denegado
- Document Understanding no se encuentra en la barra izquierda de Automation Suite
- Estado fallido al crear una sesión de etiquetado de datos
- Estado fallido al intentar implementar una habilidad ML
- El trabajo de migración falla en ArgoCD
- El reconocimiento de la escritura manual con el extractor de formularios inteligente no funciona
- Error en la implementación de la habilidad ML debido a la caducidad del token
- Ejecutar alta disponibilidad con Process Mining
- La ingestión de Process Mining falló al iniciar sesión con Kerberos
- Después de Disaster Recovery, Dapr no funciona correctamente para Process Mining
- Configurar Dapr con Redis en modo clúster
- No se puede conectar a la base de datos AutomationSuite_ProcessMining_Warehouse utilizando una cadena de conexión en formato pyodbc
- La instalación de Airflow falla con sqlalchemy.exc.ArgumentError: no se pudo analizar la URL rfc1738 de la cadena ''
- Cómo añadir una regla de tabla de IP para utilizar el puerto 1433 de SQL Server
- El certificado de Automation Suite no es de confianza desde el servidor donde se ejecuta CData Sync
- Ejecutar la herramienta de diagnóstico
- Uso del paquete de soporte de Automation Suite
- Explorar registros
Paso 8: configurar los discos
Se requiere una referencia para la partición del disco y la configuración de LVM antes de instalar Automation Suite en máquinas RHEL.
Antes de realizar una instalación de Automation Suite, debes particionar y configurar el disco mediante LSM, de modo que puedas modificar su tamaño fácilmente y sin migración o pérdida de datos.
Particionar los discos
La estructura de particiones predeterminada en las máquinas RHEL no es adecuada para instalar Kubernetes. Esto se debe a que la infraestructura de Kubernetes generalmente se instala bajo la partición /var, a la que solo se le asignan 8 GB de espacio de forma predeterminada.
- El formato compatible con los discos es
ext4oxfs. - Debes crear todas las particiones utilizando LVM para asegurarte de que los datos del clúster puedan residir en un disco diferente pero aún se puedan ver de manera coherente. Esto también ayuda a ampliar el tamaño de la partición en el 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 configurarlogrotatepara rotar los registros en un intervalo que va de diario a semanal.
Los requisitos de disco para las instalaciones en línea y sin conexión son los mismos, excepto por el espacio adicional necesario para descomprimir el paquete de UiPath® sin conexión.
Para el sistema operativo RHEL, asegúrate de tener los siguientes tamaños mínimos de puntos de montaje en la máquina.
| Etiqueta de disco | Servidor | Agente | Partición | Tamaño | Propósito |
|---|---|---|---|---|---|
| Disco del clúster | ✅ | ✅ |
| 190 GB | Almacena las imágenes y las capas del contenedor. |
|
| 56 GB | Almacena configuraciones de Kubernetes en el runtime, como secretos, mapas de configuración y directorio vacío. | |||
|
| 10 GB | Almacena el binario del instalador. | |||
| Disco etcd | ✅ | ❌ |
| 16 GB | Almacena la base de datos distribuida para Kubernetes |
| Bloquear almacenamiento | ✅ | ❌ |
| 15 GB | Obligatorio para Insights. |
|
| 50 GB | Obligatorio para las herramientas de supervisión. | |||
/datadisk/registry 1 | 200 GB | Obligatorio para el registro de Docker. | |||
/datadisk/objectstore 2 | 10 GB | Obligatorio para ceph-mon. | |||
| Almacén de objetos 2 | ✅ | ❌ | N/D | 512 GB | Obligatorio para el almacén de objetos in-clúster. |
| AI Center3 | ✅ | ✅ | N/D | 51 GB mínimo y 105 GB recomendados para 1 proceso de entrenamiento. | Solo es necesario si instalas AI Center. |
| Disco de paquete de UiPath® | ✅ | ❌ | /uipath | 512 GB | Solo es necesario para que las instalaciones sin conexión almacenen el paquete sin conexión |
1 Esto se refiere al registro de Docker en el clúster y no se aplica si usas un registro externo.
2 Esto se refiere al almacén de objetos en el clúster y no es aplicable si utiliza un almacén de objetos externo.
3 Esto se refiere al almacenamiento requerido por el proceso de entrenamiento de AI Center. El disco solo es necesario en las máquinas en las que planeas ejecutar el proceso de entrenamiento de AI Center y en el nodo de Task Mining dedicado. Recomendamos adjuntar este disco en las máquinas del agente.
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.
Uso del script para configurar los discos
Descargar el script
Puedes utilizar el script configureUiPathDisks.sh para configurar y particionar los discos.
La última versión del script funciona con todas las versiones 2023.10.x de Automation Suite. Si deseas descargar una versión de parche específica, reemplaza el número de versión en la URL.
-
Linux:
Para descargar
configureUiPathDisks.shen una máquina Linux, ejecute el siguiente comando desde el terminal:wget -O configureUiPathDisks.sh https://download.uipath.com/automation-suite/2023.10.12/configureUiPathDisks.shwget -O configureUiPathDisks.sh https://download.uipath.com/automation-suite/2023.10.12/configureUiPathDisks.sh -
Windows:
Para descargar
configureUiPathDisks.shen una máquina Windows, accede a la siguiente URL:https://download.uipath.com/automation-suite/2023.10.12/configureUiPathDisks.sh
Ejecutar el script
El script configureUiPathDisks.sh puede utilizarse para los siguientes fines:
- Configurar los discos y los puntos de montaje para la instalación de un nuevo clúster de Automation Suite;
- Cambia el tamaño del disco de datos después de la instalación.
Para hacer que el script sea ejecutable, ejecuta el siguiente comando:
chmod +x ./configureUiPathDisks.sh
chmod +x ./configureUiPathDisks.sh
Para obtener información más detallada sobre el uso del script, ejecute el siguiente comando:
sudo ./configureUiPathDisks.sh --help
sudo ./configureUiPathDisks.sh --help
Configurar el disco del clúster en todas las máquinas
Para identificar el disco correcto, ejecuta lsblk para enumerar todos los dispositivos de bloque y sus tamaños, luego compara la salida con los tamaños de disco del clúster en la tabla de requisitos de hardware. El disco debe ser lo suficientemente grande como para acomodar los tres puntos de montaje enumerados en la tabla.
Para configurar el disco del clúster, ejecuta el siguiente comando en todas las máquinas:
./configureUiPathDisks.sh --cluster-disk-name <name_of_cluster_disk>
./configureUiPathDisks.sh --cluster-disk-name <name_of_cluster_disk>
Configurar el disco etcd en todas las máquinas del servidor
Para configurar el disco etcd, ejecuta el siguiente comando en todas las máquinas del servidor:
./configureUiPathDisks.sh --etcd-disk-name name_of_etcd_disk
./configureUiPathDisks.sh --etcd-disk-name name_of_etcd_disk
La configuración del disco etcd debe realizarse solo después de completar la configuración del disco del clúster.
El orden de configuración debe conservarse, porque el disco etcd está montado dentro del disco del clúster.
Si este paso se ejecuta antes de configurar el disco del clúster, puede provocar la pérdida de datos después de reiniciar la máquina, ya que el núcleo monta automáticamente los discos en secuencia, primero el disco del clúster y luego el disco etcd.
Configurar el disco de datos en todas las máquinas del servidor
Para configurar el disco de datos, debes identificar el disco específico que se utilizará. Ejecuta el comando lsblk para enumerar todos los dispositivos de bloque, sus tamaños y puntos de montaje. Utiliza el tamaño del disco para identificar el disco relevante (para el marcador --volume , se debe utilizar el disco de datos de 512 GB).
Ejecuta el siguiente comando en todas las máquinas del servidor y proporciona los indicadores necesarios en función de tus requisitos:
./configureUiPathDisks.sh --volume name_of_data_disk
./configureUiPathDisks.sh --volume name_of_data_disk
| Marca | Valor |
|---|---|
-v | --volume |
--docker-registry | Opcional. Solo es necesario si el registro externo no está disponible. |
--monitoring | Opcional.Si el marcador no se pasa durante la primera ejecución de ejecución, crea automáticamente la partición para la supervisión (almacenamiento de Prometheus). Sin embargo, el marcador es obligatorio en la ejecución posterior, durante el cambio de tamaño de la partición de supervisión junto con el indicador --resize. |
--objectstore | Opcional. Solo es necesario si el almacén de objetos externo no está disponible. |
--insights | Opcional. Si el marcador no se pasa durante la primera ejecución, crea automáticamente la partición para Insights. Sin embargo, es necesario en la ejecución posterior, durante el cambio de tamaño de la partición de Insights junto con el indicador --resize. |
--resize <int> | Opcional. Si se proporciona un valor entero, el componente seleccionado cambia de tamaño, siempre que haya suficiente espacio disponible. De lo contrario, se consumirá todo el disco para expandir la partición seleccionada. Es obligatorio indicar con precisión una partición cuyo tamaño se debe cambiar. |
--robot-package-cache | Ruta a la ubicación en el nodo Robots de Automation Suite para descargar el paquete para el almacenamiento en caché. Esto debe realizarse solo en el nodo Robots de Automation Suite. |
También puedes utilizar el comando para cambiar el tamaño de la partición seleccionada con la ayuda del --resize , como se muestra en el siguiente ejemplo:
./configureUiPathDisks.sh --volume /dev/sde --docker-registry --resize 300
./configureUiPathDisks.sh --volume /dev/sde --docker-registry --resize 300
El ejemplo muestra cómo adjuntar el disco /dev/sde al disco de datos existente y cómo cambiar el tamaño de la partición de registro de Docker a 300 GB.
Configurar el disco del almacén de objetos en todas las máquinas del servidor
Este paso solo es necesario si el almacén de objetos externo no está disponible.
Puedes añadir o expandir tu tamaño de almacenamiento para el almacén de objetos en el clúster ejecutando el siguiente script en todos los nodos del servidor:
./configureUiPathDisks.sh --ceph-raw-disk-name name_ceph_raw_disk
./configureUiPathDisks.sh --ceph-raw-disk-name name_ceph_raw_disk
- 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 Objectstore, sigue las instrucciones en Resolución de problemas.
- No se admite el escalado vertical de los discos existentes. Para aumentar el tamaño de tu almacenamiento en el clúster después de la instalación, añade nuevos discos sin formato.
Configurar el disco de AI Center en las máquinas seleccionadas
Para configurar el disco de AI Center, ejecuta el siguiente comando en las máquinas en las que planes ejecutar los procesos de entrenamiento:
./configureUiPathDisks.sh --aicenter-disk-name name_of_aicenter_disk_to_partition
./configureUiPathDisks.sh --aicenter-disk-name name_of_aicenter_disk_to_partition
Para ampliar el almacenamiento de AI Center:
- Si quieres añadir un nuevo disco de AI Center, ejecuta el siguiente comando en la máquina en la que planeas añadir el disco:
./configureUiPathDisks.sh --aicenter-storage-extend name_of_new_aicenter_disk_to_attach./configureUiPathDisks.sh --aicenter-storage-extend name_of_new_aicenter_disk_to_attach - Si has expandido el disco de AI Center existente, ejecuta el siguiente comando en la máquina donde se expande el disco de AI Center subyacente:
./configureUiPathDisks.sh --aicenter-storage-extend./configureUiPathDisks.sh --aicenter-storage-extend
Configurar el disco de alojamiento para la caché del paquete de Automation Suite Robot
Este paso es necesario para las configuraciones de nodo único sin un agente de Automation Suite Robot dedicado.
Para alojar la caché del paquete de Automation Suite Robot en el nodo del servidor, debes crear un disco de al menos 10 GB:
./configureUiPathDisks.sh --volume name_of_data_disk --robot-package-cache
./configureUiPathDisks.sh --volume name_of_data_disk --robot-package-cache
Se recomienda realizar una copia de seguridad del disco mediante LVM.
Configuración del disco del paquete en el primer nodo del servidor para el registro dentro del clúster
Este paso es necesario en los siguientes escenarios:
- Al realizar una instalación sin conexión (con espacios abiertos);
- Cuando un registro externo no está disponible.
Para configurar el disco del paquete, ejecuta el siguiente comando solo en el primer nodo del servidor:
./configureUiPathDisks.sh --bundle-disk-name name_of_bundle_disk
./configureUiPathDisks.sh --bundle-disk-name name_of_bundle_disk
Validar instalaciones de disco
Asegúrate de añadir todos los puntos de montaje al archivo fstab y de incluir la opción nofail en esas entradas fstab para que no afecte al arranque de la VM en caso de fallo.
Para validar que /etc/fstab está configurado correctamente y puede manejar un reinicio del sistema, sigue los siguientes pasos y ejecuta el siguiente comando:
mount -afv
mount -afv
Deberías obtener el siguiente resultado:
# Servers
/datadisk/monitoring : already mounted
/datadisk/insights : already mounted
/var/lib/rancher/rke2/server/db : already mounted
# Servers or agents
/opt/UiPathAutomationSuite : already mounted
/var/lib/rancher : already mounted
/var/lib/kubelet : already mounted
# In case of an offline environment, only on the primary server node
/uipath : already mounted
# Additional mount point is require if customer is installing offline with internal registry
/datadisk/registry : already mounted
# Additional mount point is require if customer is using in-cluster objectstore
/datadisk/objectstore : already mounted
# Servers
/datadisk/monitoring : already mounted
/datadisk/insights : already mounted
/var/lib/rancher/rke2/server/db : already mounted
# Servers or agents
/opt/UiPathAutomationSuite : already mounted
/var/lib/rancher : already mounted
/var/lib/kubelet : already mounted
# In case of an offline environment, only on the primary server node
/uipath : already mounted
# Additional mount point is require if customer is installing offline with internal registry
/datadisk/registry : already mounted
# Additional mount point is require if customer is using in-cluster objectstore
/datadisk/objectstore : already mounted
- Particionar los discos
- Uso del script para configurar los discos
- Descargar el script
- Ejecutar el script
- Configurar el disco del clúster en todas las máquinas
- Configurar el disco etcd en todas las máquinas del servidor
- Configurar el disco de datos en todas las máquinas del servidor
- Configurar el disco del almacén de objetos en todas las máquinas del servidor
- Configurar el disco de AI Center en las máquinas seleccionadas
- Configurar el disco de alojamiento para la caché del paquete de Automation Suite Robot
- Configuración del disco del paquete en el primer nodo del servidor para el registro dentro del clúster
- Validar instalaciones de disco