Instalación de producción multinodo preparada para alta disponibilidad sin conexión

Información general

Importante:

Debe cumplir los requisitos previos de hardware y software antes de continuar con la instalación. Consulta Requisitos de hardware y software.

Puedes utilizar un script dedicado para validar los requisitos previos de la instalación y la disponibilidad de la infraestructura. Consulta Validar los requisitos previos.

Para que la experiencia de instalación sea satisfactoria, asegúrate de seguir nuestras mejores prácticas. Consulta .

El proceso de instalación consta de los siguientes pasos generales:

Paso	Descripción
Paso 1: descargar el paquete de instalación	Debe realizar este paso desde una máquina con Linux o Windows con acceso a Internet y desde las máquinas fuera de línea donde planea implementar Automation Suite. Mientras los paquetes de instalación terminan de descargarse, puede continuar con algunos de los siguientes pasos. Paso 1.1: descargar el paquete de instalación Paso 1.2: Obtener todos los archivos descargados en la primera máquina
Paso 2: configurar la instalación	Ejecute el instalador interactivo para configurar las opciones de instalación. La herramienta recopila entradas para las opciones de instalación más comunes y genera un archivo de configuración que puede usar durante la instalación. (Opcional) Configura las opciones de instalación avanzadas. El instalador interactivo ofrece una experiencia predeterminada con un número limitado de opciones de configuración. Para personalizar los productos instalados, configure servidores SQL separados para productos específicos y más, edite el archivo de configuración. Paso 2.1: Configuración predeterminada Paso 2.2: (opcional) configuración avanzada
Paso 3: Copiar los archivos de instalación en todas las máquinas	En la primera máquina, copie los archivos descargados en la carpeta de instalación creada por el instalador interactivo en el paso 2. En las otras máquinas del clúster, copie la carpeta de instalación completa de la primera máquina a la misma ruta de la carpeta en cada máquina. Paso 3: Copiar los archivos de instalación en todas las máquinas
Paso 4: Ejecutar la instalación	Crear el clúster y unir todas las máquinas Instale el resto de la suite desde la primera máquina. Paso 4: Ejecutar la instalación
Paso 5: Completar la instalación	Paso 5: Has completado correctamente la instalación, puedes continuar con los siguientes pasos. Ahora puee acceder al clúster y a la suite recién creados, actualizar certificados, redimensionar el PVC y muchas cosas más. Paso 5: Completar la instalación

Importante:

La versión del kernel RHEL kernel-4.18.0-477.10.1.el8_8 está afectada por una incidencia que interrumpe la instalación o gestión del clúster de Automation Suite. Asegúrate de que ninguno de los nodos de Automation Suite utiliza esta versión del kernel, ya sea antes o después de la instalación. Puedes actualizar la versión del kernel ejecutando el siguiente comando:

dnf install -y kernel kernel-tools kernel-tools-libs

Paso 1: Descargar los paquetes de instalación e incorporar todos los archivos en la primera máquina

Paso 1.1: Descargar los paquetes de instalación

Debe realizar este paso en una máquina con acceso a Internet y en la máquina del entorno sin conexión en la que va a instalar Automation Suite.

Nota:

Esta máquina puede ser Linux o Windows. Los comandos de esta guía son para sistemas operativos basados en SO. En el caso de Windows u otros sistemas operativos, ajuste los comandos equivalentes específicos para esos entornos.

El instalador de Automation Suite es un conjunto de varios paquetes que también instala algunas dependencias utilizando Red Hat Package Manager (RPM). Proporciona una experiencia interactiva que le ayuda a configurar recursos externos, como SQL y otras opciones de instalación.

EN LA MÁQUINA SEPARADA CON ACCESO A INTERNET

En esta sección se explica cómo obtener los archivos necesarios para iniciar el proceso de instalación.

1. Conéctese a una máquina con acceso a Internet y ejecute el siguiente comando para obtener el archivo del asistente interactivo:

   ssh <user>@<dns_of_vm>

2. Si utilizaste una clave SSH, ejecuta el siguiente comando:

   ssh -i <path/to/Key.pem> <user>@<dns_of_vm>

3. Descargue los siguientes paquetes:
   • installUiPathAS.sh : obligatorio. Consulte installUiPathAS.sh para obtener instrucciones de descarga.
   • sf-instalador.zip : obligatorio. Consulte sf-instalador.zip para obtener instrucciones de descarga.
   • sf.tar.gz: Opcional. Solo es necesario en el nodo del servidor cuando se utiliza el registro interno de Docker. Consulte sf.tar.gz para obtener las instrucciones de descarga.
   • sf-infra.tar.gz : obligatorio. Consulte sf-infra.tar.gz para obtener instrucciones de descarga.
   • du-ondemand.tar.gz : opcional. Solo necesario para Document Understanding. Consulte du-ondemand.tar.gz para obtener instrucciones de descarga.
     Nota:

     Si no se siguen estos pasos opcionales se limitan las funciones de los servicios de Document Understanding.

   • cv-ondemand.tar.gz : opcional. Solo necesario para Computer Vision. Consulte du-ondemand.tar.gz para obtener instrucciones de descarga.
     Nota:

     Si no sigues este paso opcional, no podrás acceder a los servicios de Computer Vision.

   Asegúrese de descargar el paquete adecuado para su versión de Automation Suite y su sistema operativo.

Paso 1.2: Obtener todos los archivos descargados en la primera máquina

Asegúrese de seguir los siguientes pasos:

• Compruebe que todos los archivos han terminado de descargarse en la máquina con acceso a Internet;
• Cree la carpeta de destino en la máquina;
• Copie los archivos de la máquina en línea a la máquina de destino.

EN TODAS LAS MÁQUINAS DEL CLÚSTER

Cree las carpetas de instalación ejecutando el siguiente comando:

sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 777 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp

Importante: no es necesario ejecutar mkdir -p /opt/UiPathAutomationSuite/ si utilizas el script configureUiPathDisks.sh .

EN LA MÁQUINA SEPARADA CON ACCESO A INTERNET

Copie los archivos en el primer nodo realizando los siguientes pasos:

1. From the machine with internet access, copy the files to the installation folder on the target machine, and the offline bundle(s) to the /uipath/tmp folder:

   scp ~/installUiPathAS.sh ~/sf-installer.zip ~/sf-infra.tar.gz <username>@<node dns>:/uipath/tmp
   scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/

2. (Opcional) Para hacer uso de Document Understanding, copia el siguiente paquete en la carpeta /uipath/tmp:

   scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/

   Advertencia: Si no sigues este paso opcional, no podrás acceder a los servicios de Document Understanding.
3. (Opcional) Para utilizar Computer Vision, copia el siguiente paquete en la carpeta /uipath/tmp:

   scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/

   Advertencia: Si no sigues este paso opcional, no podrás acceder a los servicios de Computer Vision.

Paso 2: configurar la instalación

Paso 2.1: Configuración predeterminada

EN LA MÁQUINA PRINCIPAL DEL CLÚSTER

1. Añade la carpeta de requisitos previos a la ruta actual.
   El instalador interactivo requiere jq, y los paquetes sin conexión de Automation Suite lo incluyen. Ejecute los siguientes comandos para añadirlo a la ruta y asegúrese de seguir teniendo acceso a la raíz:

   mv /uipath/tmp/installUiPathAS.sh /uipath/tmp/sf-installer.zip /uipath/tmp/sf-infra.tar.gz  /opt/UiPathAutomationSuite
   cd /opt/UiPathAutomationSuite
   unzip ./sf-installer.zip -d .
   chmod +x ./bin/jq
   export PATH=${PATH}:/opt/UiPathAutomationSuite/bin

2. Proporcione permisos a la carpeta del instalador.
   Es necesario otorgar permisos adecuados a la carpeta /opt/UiPathAutomationSuite en la que se ubican los scripts de instalación y donde se van a ejecutar. El instalador también creará algunos archivos (output.json) después de la ejecución de cada etapa. Para proporcionar los permisos necesarios, ejecute el siguiente comando:

   chmod -R 755 /opt/UiPathAutomationSuite

3. Ejecute el instalador interactivo para configurar las opciones de instalación.
   Importante:

   El instalador interactivo intenta descargar sf-installer.zip y falla en entornos sin conexión. Para evitar el paso de descarga y prevenir cualquier problema de instalación, ejecuta el siguiente comando:

   export BUNDLE_FILE="/opt/UiPathAutomationSuite/sf-installer.zip"

   Para iniciar el instalador interactivo, ejecuta el siguiente comando:

   chmod +x ./installUiPathAS.sh
   ./installUiPathAS.sh

   El instalador interactivo te guía por los pasos de configuración y genera la configuración que puedes personalizar mediante los pasos restantes.

Ejecutar el asistente interactivo multinodo en el modo sin conexión

Ejecute el instalador interactivo para configurar las opciones de instalación. La herramienta reúne entradas para las opciones de instalación más comunes y genera un archivo de configuración. La alta disponibilidad está habilitada de manera predeterminada, pero puede deshabilitarla mediante la configuración avanzada.

Para instalar Automation Suite, siga los siguientes pasos:

1. Inicia el instalador interactivo.
2. Acepte el acuerdo de licencia para continuar la instalación.
3. En el menú principal, seleccione su modo de implementación. Elija Implementación de varios nodos (recomendada para uso en producción) y confirme su selección.
   
4. En Configuración de implementación, selecciona tu tipo de entorno. Elige Espacio vacío.
5. Elija su selección de productos. Las opciones son:
   • Completo (todos los productos)
   • Seleccionar productos

   Para obtener más información sobre las opciones de selección de productos, consulta Requisitos de hardware y software.

6. Si eliges Seleccionar productos en el paso anterior, indica los productos que quieres instalar. Sus opciones son:
   • Action Center
   • AI Center
   • Apps
   • Automation Hub
   • Automation Ops
   • Automation Suite Robots
   • Data Service
   • Document Understanding
   • Insights
   • Orchestrator
   • Process Mining
   • Task Mining
   • Test Manager

   Nota:

   Algunos productos de Automation Suite tienen dependencias adicionales entre sí. Al seleccionar los productos que desea instalar, asegúrese de tener en cuenta las dependencias entre productos. Si intenta instalar un producto sin sus dependencias, se producirá un error.

   Además, algunos productos de Automation Suite requieren un nodo agente dedicado. Antes de continuar, asegúrese de cumplir los requisitos de hardware.

7. Para instalar AI Center, debe seguir pasos adicionales:
   1. Especifica si AI Center requiere un Orchestrator externo.
      • Si AI Center no requiere un Orchestrator externo, continúa con el paso 8.
      • Si AI Center requiere un Orchestrator externo, continúe con el paso 7.b.
   2. Copie el certificado de Orchestrator en la máquina virtual. Para obtener más información al respecto, consulta la página Copiar certificado de Orchestrator .
   3. Especifique la URL de Orchestrator para AI Center. Ejemplo: https://orchestrator.example.com.
   4. Especifica la URL de identidad para AI Center. Ejemplo: https://orchestrator.example.com/identity.
   5. Especifique la ruta al archivo del certificado de Orchestrator. Ejemplo: /opt/UiPathAutomationSuite/UiPath_Installer/orch.cer.
   6. Especifique la ruta al archivo del certificado de identidad. Ejemplo: /opt/UiPathAutomationSuite/UiPath_Installer/identity.cer.
   Nota: en las instalaciones sin conexión, no es necesario especificar la clave API de medición. Para completar la instalación del AI Center, sigue los pasos de la sección Finalización de la instalación del AI Center.
8. Confirma tu selección de productos para determinar los requisitos mínimos de hardware y software.
9. Introduce el FQDN de Automation Suite.
10. Especifique si desea crear su propio almacén de objetos para los productos seleccionados. Si selecciona No, opta por el almacén de objetos predeterminado. Si seleccionas Sí, elige una de las siguientes opciones:
    • Cuenta de Azure Storage : indica si quieres usar administrado basado en identidad con tu cuenta de Azure Storage, proporciona los siguientes detalles correspondientes a tu elección y luego especifica si quieres que los contenedores se aprovisionen automáticamente para todos los productos seleccionados:
      • En caso afirmativo, proporciona el nombre de la cuenta de Azure Storage y el sufijo del punto de conexión, y su ID de cliente;
      • En caso negativo, proporcione el nombre de la cuenta de almacenamiento de Azure y el sufijo del punto de conexión, y la clave de su cuenta de Azure;
    • AWS S3 : proporciona el prefijo y el sufijo para los nombres de los depósitos, la región de AWS donde se alojan los depósitos, la clave de acceso y la clave secreta de la cuenta de S3, y especifica si quieres que los depósitos se aprovisionen automáticamente para todos los productos seleccionados.
    • Otro almacenamiento compatible con S3 : especifica el prefijo y sufijo de los nombres de los depósitos, el FQDN del servidor de S3, el puerto de S3, la clave de acceso y la clave secreta de la cuenta de S3, y especifica si quieres que los depósitos se aprovisionen automáticamente para todos los productos seleccionados.

    Nota:

    Muchos almacenes de objetos de S3 requieren el conjunto de CORS para todo el tráfico del clúster de Automation Suite. Debe configurar la política CORS en el nivel de almacén de objetos para permitir el FQDN del clúster.

11. Especifique si desea utilizar la autenticación Kerberos para conexiones SQL.
12. Introduzca el FQDN de SQL Server. Siga las instrucciones para introducir el puerto de conexión, el nombre de usuario y la contraseña.
    Nota:

    Process Mining requires a second SQL Server. If you install Process Mining, make sure to provide the warehouse SQL Server URL, connection prompt, username, and password.

    Para obtener más información sobre los requisitos de hardware que debe cumplir el segundo SQL Server, consulta los Requisitos de SQL para Process Mining.

13. Especifica si quieres que el instalador cree automáticamente las bases de datos necesarias.
14. Proporcione certificados de CA para cualquier software de servidor externo que requiera una comunicación TLS segura; de lo contrario, la instalación fallará. Si no habilitó la comunicación TLS, puede configurar los certificados después de la instalación.
    Nota:

    El instalador acepta solo certificados DER codificados en Base64 en formato PEM . Si los servidores externos tienen diferentes CA, puede concatenar todos los certificados públicos en un solo archivo.
15. Después de definir los parámetros de configuración, el instalador genera automáticamente la configuración. Puede editar los parámetros de configuración directamente en el terminal.
    Nota:

    You can now directly edit the cluster_config.json for advanced configuration settings in the UiPathAutomationSuite folder. After you edit the configuration file, you need to re-run the interactive installer to complete the installation or complete it manually.

Nota: Al final del proceso de instalación, se le solicita un resumen de implementación que le brinda acceso al portal de administración de clústeres, el portal de host, la interfaz de administración de la organización, Rancher, ArgoCD y más.

Paso 2.2: (opcional) configuración avanzada

Este paso es opcional.

Puede configurar el archivo para las configuraciones más avanzadas. Puede habilitar productos adicionales, deshabilitar cualquiera de los productos predeterminados, configurar sus bases de datos SQL y sus respectivas cadenas de conexión, así como los certificados. Para el modo de producción multinodo preparada para alta disponibilidad, habilitamos la alta disponibilidad de manera predeterminada, pero puede deshabilitarla si es necesario.

Para una configuración avanzada, puede seguir las siguientes instrucciones: Experiencia de instalación avanzada.

Nota: si sales del instalador interactivo y realizas una configuración avanzada, deberás volver a ejecutar el instalador interactivo para completar el proceso.

Paso 3: Copiar los archivos de instalación en todas las máquinas del clúster

Desde la primera máquina del clúster, donde se realizó la configuración, copia el instalador, los certificados y cluster_config.json en todas las demás máquinas.

EN LA PRIMERA MÁQUINA DEL CLÚSTER

1. Copie la carpeta /opt/UiPathAutomationSuite en todos los demás nodos ejecutando el siguiente comando:

   scp -r /opt/UiPathAutomationSuite <username>@<node dns>:/opt

   Importante: Como estás en un entorno aislado, puede que tengas que utilizar la IP privada del nodo de destino.
2. Añada -i <cert.pem> si está usando un certificado para iniciar sesión. Si copia los contenidos de .pem en un archivo local, el nuevo archivo deberá tener los permisos correctos. Puede hacer chmod 400 <cert.pem> para concederlos.

El paso anterior garantiza la replicación de la misma configuración en todas las máquinas junto a todos los paquetes descargados para el paquete de instalación.

Paso 4: Ejecutar la instalación

Existen dos tipos de máquinas: servidor y agente.

• Servidor: máquinas en las que las que se ejecuta la infraestructura de Kubernetes (es decir, apiserver, etc.). Estos componentes gestionan todo el clúster.
• Agente: versión estándar de la máquina que se usa para ejecutar cargas de trabajo

El modo de producción multinodo preparada para alta disponibilidad requiere un mínimo de 3 máquinas de servidor. La instalación de Task Mining requiere añadir una máquina adicional que se utiliza como agente.

Nota:

• Para una instalación de producción multinodo preparada para alta disponibilidad, necesitas un equilibrador de carga. Asegúrese de crear uno y distribuir el tráfico entre los nodos. El nombre de dominio del equilibrador de carga debe utilizarse en el archivo cluster_config.json.
• Debe tener al menos un nodo de servidor y para alta disponibilidad necesita como mínimo tres nodos de servidor. Se requiere un número de nodos de servidor impar.

Paso 4.1: Aceptar el acuerdo de licencia

Antes de ejecutar la instalación, lea el Acuerdo de licencia.

Para aceptar el acuerdo de licencia, elija uno de los siguientes métodos:

• Opción 1 (Entorno variable) - Configura la variable de entorno LICENSE_AGREEMENT para aceptar ejecutando el siguiente comando: export LICENSE_AGREEMENT=accept
• Opción 2 (Parámetro en línea): como alternativa, anexa --accept-license-agreement a cada ejecución de install-uipath.sh.

Paso 4.2: Crear y unir todas las máquinas al clúster

1. Configure la primera máquina.
   Ejecuta los siguientes comandos en el primer servidor:

   cd /opt/UiPathAutomationSuite
   ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement

2. una el resto de los servidores al clúster.
   Ejecuta los siguientes comandos en el resto de nodos servidores en secuencia:

   cd /opt/UiPathAutomationSuite
   sudo chmod -R 755 /opt/UiPathAutomationSuite
   sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j server --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement

3. una el resto de los agentes al clúster.
   Ejecuta los siguientes comandos en el resto de nodos agente en secuencia:

   cd /opt/UiPathAutomationSuite
   sudo chmod -R 755 /opt/UiPathAutomationSuite
   sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j agent --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement

Paso 4.3: Finalizar la instalación de la suite

Cargar los paquetes sin conexión cuando se utiliza un registro de Docker interno

Una vez que se unan todos los nodos, si utilizas un registro de Docker interno, carga tus paquetes sin conexión ejecutando el siguiente comando en el primer nodo:

./configureUiPathAS.sh registry upload --offline-bundle /opt/UiPathAutomationSuite/sf.tar.gz --offline-tmp-folder /uipath/tmp

Finalizar la instalación en el primer nodo

Cuando se unan todos los nodos, cambia al primer servidor para finalizar Automation Suite

1. Compruebe si los nodos se añadieron correctamente ejecutando el siguiente comando:

   sudo su 
   export KUBECONFIG=/etc/rancher/rke2/rke2.yaml PATH=$PATH:/var/lib/rancher/rke2/bin 
   kubectl get nodes

2. Debe ver más de un nodo en lista si todo ha ido bien.

3. Finalice la instalación ejecutando el siguiente comando:

   ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f -s --install-type offline --offline-bundle /opt/UiPathAutomationSuite/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement

ADVERTENCIA:

Esta es la operación que más tiempo consume. Puede tardar aproximadamente 2 horas.

Cargando los paquetes opcionales

• Para cargar el paquete opcional Document Understanding, ejecuta el siguiente comando:

  ./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"

• Para cargar el paquete opcional de Computer Vision, ejecute el siguiente comando:

  ./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"

Completar una instalación de AI Center

Si AI Center requiere un Orchestrator externo, ejecuta el siguiente comando para completar la instalación:

./configureUiPathAS.sh aicenter configure --installation-token <identity token>

Para obtener más información sobre cómo configurar Orchestrator para AI Center, consulta la página Configurar Orchestrator en la guía de AI Center.

Paso 5: Completar la instalación

Nota: Has completado correctamente la instalación y puedes seguir con los siguientes pasos.

Actualizar certificados

Importante:

El proceso de instalación genera certificados autofirmados en su nombre. No obstante, la plantilla de implementación de Azure también ofrece la opción de proporcionar un certificado de servidor emitido por una autoridad de certificación en el momento de la instalación en lugar de utilizar un certificado autofirmado de manera automática.

Estos certificados autofirmados caducarán en 90 días, y deberá sustituirlos por certificados firmados por una autoridad de certificación de confianza en cuanto finalice la instalación. Si no actualiza los certificados, la instalación dejará de funcionar transcurridos 90 días.

Para obtener instrucciones, consulta Gestión de certificados.

Acceder a Automation Suite

Para acceder al clúster y a la suite recién creados, consulta Cómo acceder a Automation Suite.

Cambiar el tamaño de PVC

Para cambiar el tamaño del PVC, consulta Cambiar el tamaño de PVC.