- 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 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
- Ejemplo de Clúster_config.json
- Configuración general
- Configuración del perfil
- 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 ArgoCD
- 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
- Inclusión de un nodo agente dedicado compatible con GPU
- 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
- Ejecutar uipathctl
- 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
- Migración de Redis desde un clúster a un High Availability Add-on externo
- Migrating data between objectstores
- Migrating in-cluster objectstore to external objectstore
- 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
- Escalar una implementación de nodo único (evaluación) a una implementación multinodo (HA)
- Supervisión y alertas
- Migración y actualización
- Migrar entre clústeres de Automation Suite
- 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
- Configuración avanzada de Orchestrator
- Configurar parámetros 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 NLog
- Guardar los registros del robot en Elasticsearch
- Configurar almacenes de credenciales
- Configurar clave de cifrado por tenant
- Limpiar la base de datos de Orchestrator
- Omitir la instalación de la biblioteca de host
- Buenas prácticas y mantenimiento
- Solución de problemas
- Cómo solucionar los problemas de los servicios durante la instalación
- Cómo reducir los permisos para un directorio de copia de seguridad NFS
- 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
- Cómo limpiar manualmente los registros
- 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 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 comprobar la versión de TLS
- Cómo trabajar con certificados
- Cómo programar la copia de seguridad y la restauración de datos de Ceph
- 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
- Cómo implementar Insights en un clúster habilitado para FIPS
- Cómo migrar a cgroup v2
- Cómo recuperar la autenticación Kerberos después de reiniciar una máquina virtual
- Cómo enviar una imagen de Docker local al registro en el clúster
- Cómo excluir depósitos de la copia de seguridad
- Error al descargar el paquete
- La instalación sin conexión falla porque falta un binario
- Azure disk not marked as SSD
- Fallo tras la actualización del certificado
- Errores de validación del certificado TLS
- 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
- La instalación del registro temporal falla en RHEL 8.9
- Problema de reinicio frecuente en las implementaciones del espacio de nombres de uipath durante las instalaciones sin conexión
- Configuración de DNS no respetada por CoreDNS
- La propagación del registro en el clúster falla debido a la memoria insuficiente
- Las comprobaciones de requisitos previos fallan cuando los proyectos modernos de Document Understanding están habilitados y AI Center está deshabilitado
- Upgrade fails due to unhealthy Ceph
- 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.
- La actualización del servicio falla para Apps
- Tiempos de actualización in situ
- La actualización falla en entornos sin conexión
- pod de snapshot-controller-crds en estado CrashLoopBackOff después de la actualización
- La actualización falla debido a los tamaños de PVC de Insights anulados
- Error de actualización debido a un nombre de host en mayúsculas
- 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
- Pod del servidor de repositorio de ArgoCD en CrashLoopBackOff
- Mitigación manual de Política de red de ArgoCD (GHSA-47m3-95c7-g2g8)
- Faltan métricas de Ceph-rook en los paneles de supervisión
- Falta de coincidencia en los errores informados durante las comprobaciones de estado de diagnóstico
- Configurar solicitudes de recursos y límites para cargas de trabajo creadas por uipathctl
- No hay problema ascendente en buen estado
- Inicio de Redis bloqueado por antivirus
- Los pods de AI Center y Document Understanding no se inician con la verificación del certificado TLS habilitada
- Fluentd no exporta registros en entornos IPv6
- Studio Desktop no puede cargar conectores y actividades de Integration Service
- 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
- Ejecutar alta disponibilidad con Process Mining
- La ingestión de Process Mining falló al iniciar sesión con Kerberos
- 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
- Process Mining fails to load after disabling and re-enabling it
- Ejecutar la herramienta de diagnóstico
- Uso del paquete de soporte de Automation Suite
- Explorar registros
Valida todos los requisitos previos antes de iniciar la instalación de Automation Suite utilizando el instalador de uipathctl.
Antes de iniciar la validación de requisitos previos, asegúrate de haber descargado el instalador uipathctl en la carpeta /opt/UiPathAutomationSuite/<version> en todas las máquinas, generado el archivo cluster_config.json y copiado el archivo de configuración en todas las máquinas. Para obtener instrucciones, consulta Descargar los paquetes de instalación y Generar cluster_config.json.
Información general
Antes de instalar Automation Suite, es una buena práctica validar los requisitos previos de instalación y la preparación de la infraestructura. Puedes utilizar uipathctl para evaluar tu entorno y generar un resumen antes de realizar la instalación. Puedes utilizar el --verbose si quieres acceder a la salida detallada de la comprobación de requisitos previos o puedes omitir este marcador para obtener un resultado más conciso y simplificado.
La validación de los requisitos previos para instalar Automation Suite implica dos pasos:
- El primer paso utiliza
uipathctlpara evaluar los requisitos previos de instalación de Kubernetes en tu entorno. - El segundo paso implica una comprobación detallada de los requisitos previos necesarios para la instalación de componentes compartidos.
La siguiente tabla enumera todas las comprobaciones de requisitos previos necesarias para la instalación de Kubernetes.
| 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:
|
| Partición y configuración del disco | Valida que particionó y configuró correctamente el disco. El control tiene en cuenta los siguientes aspectos:
|
| 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:
|
| Certificado de servidor | Comprueba que el certificado del servidor que proporcionó es válido. El control tiene en cuenta los siguientes aspectos:
|
| 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:
|
| Proxy | Valida que haya configurado correctamente el proxy. La comprobación tiene en cuenta los siguientes aspectos:
|
| 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:
|
| Servicios del sistema | Valida que los servicios del sistema estén configurados correctamente. La comprobación tiene en cuenta los siguientes aspectos:
|
| 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. |
| Actualizar | Valida si la ruta de actualización en las versiones de Automation Suite es correcta. |
Además de las comprobaciones de requisitos previos necesarias para la instalación de Kubernetes, la instalación de componentes compartidos requiere comprobaciones de requisitos previos específicas, como se indica en la siguiente tabla:
| Comprobar | Descripción |
|---|---|
| Conexión SQL | Valida que Automation Suite puede conectarse correctamente al servidor SQL para los productos y servicios compartidos de UiPath® (como Identity, Portal, Org Management, etc.) utilizando las cadenas de conexión SQL proporcionadas en cluster_config.json. Esto es obligatorio para una instalación correcta. |
| Roles de SQL DB | Valida los roles y permisos necesarios para los productos de UiPath®. Esto es obligatorio para una instalación correcta. |
| Compatibilidad SQL DB | Valida los requisitos de compatibilidad de SQL DB. |
| Resolución FQDN | Valida que el FQDN y los subdominios se puedan resolver correctamente. |
| API de almacenamiento de objetos | Valida que las API de almacén de objetos sean accesibles en función de la información de acceso proporcionada en cluster_config.json. Esto es obligatorio para una instalación correcta de los servicios de UiPath®. |
| Caché / Redis | Valida la conexión a Cloud Redis o ElastiCache. Esto es obligatorio para una instalación correcta. |
| Capacidad | Valida que tenga la capacidad mínima de CPU y RAM de los nodos trabajadores en función de los productos habilitados en cluster_config.json. |
| ClaseDeAlmacenamiento | Valida que las clases de almacenamiento para el almacenamiento de archivos estén configuradas según sea necesario para los Robots de Automation Suite. |
| Componentes opcionales | Valida que su clúster tenga componentes que eligió excluir de la instalación de Automation Suite . |
| Ingress | Valida que la entrada del clúster esté configurada correctamente y que las solicitudes de URL FQDN puedan llegar a los productos de UiPath®. |
| Políticas de red | Comprueba si las políticas de red configuradas en Automation Suite son compatibles con el clúster. |
| Registro | Valida que Automation Suite pueda acceder al registro de UiPath® docker. Esto es obligatorio para una instalación correcta. |
| Conectividad de clúster | Valida si la comunicación del clúster está configurada correctamente:
|
Validar las máquinas para la instalación
Para validar tus máquinas, sigue estos pasos:
-
Asegúrate de que los paquetes RPM están instalados y validados. Para obtener más información, consulta Validar e instalar los paquetes RPM necesarios.
-
Para validar las comprobaciones de requisitos previos para la instalación de Kubernetes, ejecuta el siguiente comando desde la carpeta de tu instalador (como
/opt/UiPathAutomationSuite/<version>/installer) en cada nodo:./bin/uipathctl rke2 prereq run cluster_config.json --node-type server \ #replace with the agent while validating the agent machine. --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IPs of all the nodes in the cluster --versions versions/helm-charts.json./bin/uipathctl rke2 prereq run cluster_config.json --node-type server \ #replace with the agent while validating the agent machine. --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IPs of all the nodes in the cluster --versions versions/helm-charts.jsonNota:- Para validar los requisitos para las máquinas de agente, GPU o Robots de Automation Suite, cambia el valor del marcador
--node-typedeserveraagent,gpuoasrobots, respectivamente. - Si realizas una instalación de nodo único en una sola máquina, elimina la marca
--machines. Si realizas la instalación en varias máquinas, proporciona la dirección IP de todas las máquinas para validar la conectividad entre ellas. - Si implementas Process Mining y utilizas Microsoft SQL Server para la base de datos
AutomationSuite_Airflow, asegúrate de que la zona horaria de la máquina de SQL Server esté establecida en UTC.
- Para validar los requisitos para las máquinas de agente, GPU o Robots de Automation Suite, cambia el valor del marcador