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

Información general

Importante:

You must meet the hardware and software prerequisites before proceeding with the installation. See Hardware and software requirements.

You can use a dedicated script to validate the installation prerequisites and infrastructure readiness. See Validating the prerequisites.

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
Step 3: Copy the installation files on all the machines	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
Step 4: Run the installation	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
Step 5: Complete the installation	Step 5: You have completed the installation successfully and can move to post-installation steps. 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 – Mandatory. See installUiPathAS.sh for download instructions.

   • sf-installer.zip – Mandatory. See sf-installer.zip for download instructions.

   • sf.tar.gz – Optional. Required only on server node when using internal Docker registry. See sf.tar.gz for download instructions.

   • sf-infra.tar.gz - Mandatory. See sf-infra.tar.gz for download instructions.

   • du-ondemand.tar.gz – Optional. Needed only for Document Understanding. See du-ondemand.tar.gz for download instructions.

     Nota:

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

   • cv-ondemand.tar.gz – Optional. Needed only for Computer Vision. See cv-ondemand.tar.gz for download instructions.

     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:

   Not following this optional step prevents access to the Document Understanding services.

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. In Main Menu, select your deployment mode. Choose Multi-node deployment (recommended for production use) and confirm your selection.

   

4. In Deployment configuration, select your environment type. Choose Air-gapped.

5. Elija su selección de productos. Las opciones son:

   • Completo (todos los productos)
   • Seleccionar productos

   For details on the product selection options, see Hardware and software requirements.

6. If you chose Select products in the previous step, indicate the products you want to install. Your options are:

   • 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:

   Some Automation Suite products have additional dependencies on each other. When selecting the products you want to install, make sure you consider Cross-products dependencies. Trying to install a product without its dependencies would result in an error.

   In addition to that, some Automation Suite products require a dedicated agent node. Before continuing, make sure you meet the hardware requirements.

7. To install AI Center, you must follow additional steps:

   Nota:

   In offline installations, you do not need to specify the metering API key. To complete the AI Center installation, follow the step from the Completing AI Center installation section.

   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. Copy the Orchestrator certificate to the virtual machine. For more information on this, check the Copy the Orchestrator certificate page.

   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.

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. Specify whether you would like to bring your own object store for the selected products. If you select No, you opt for the default object store. If you select Yes, choose one of the following options:

    • Azure Storage Account – Indicate if you want to use managed identity-based with your Azure storage account, provide the following details corresponding to your choice, then specify if you want the containers to be automatically provisioned for all the selected products:
      • If Yes, provide the Azure storage account name and endpoint suffix, and your client ID;
      • If No, provide the Azure storage account name and endpoint suffix, and your Azure account key;
    • AWS S3 – Provide the prefix and suffix for the bucket names, the AWS region where buckets are hosted, the access key and the secret key for the S3 account, and specify if you want the buckets to be automatically provisioned for all the selected products.
    • Other S3 Compatible storage – Specify the prefix and suffix for the bucket names, the S3 server FQDN, the S3 port, the access key and the secret key for the S3 account, and specify if you want the buckets to be automatically provisioned for all the selected products.
    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.

    For details on the hardware requirements the second SQL Server must meet, see SQL requirements for 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 te mostrará un resumen de implementación que te da acceso al portal de administración del clúster, el portal del 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.

For advanced configuration, you can follow the following instructions: Advanced installation experience.

Nota:

If you exit the interactive installer and perform advanced configuration, you need to re-run the interactive installer to complete the process.

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:

   Since you are in an air-gapped environment, you might need to use the private IP of the target node.

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

Before running the installation, make sure to read the License Agreement.

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

• Option 1 (Environment Variable) - Set the LICENSE_AGREEMENT environment variable to accept by executing the following command: 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
   

Step 4.3: Finishing installing the 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"
  

Completing an AI Center installation

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

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

For more information on how to configure Orchestrator for AI Center, check the Configuring Orchestrator page from the AI Center guide.

Paso 5: Completar la instalación

Nota:

Ha completado correctamente la instalación y ahora puede seguir los pasos posteriores a la instalación.

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.

For instructions, see Managing certificates.

Acceder a Automation Suite

To access the newly created cluster and suite, see Accessing Automation Suite.

Cambiar el tamaño de PVC

To resize the PVC, see Resizing PVC.