Procedimiento

Paso 1: Descarga el script de instalación en la primera máquina

1.1 Descarga los paquetes de instalación.

This step needs to be run on a machine with internet access and access to the machines in the air-gapped environment where UiPath AI Center will be installed.

Nota:

Esta máquina puede ser Linux o Windows. Los pasos indicados para ejecutarse en esta máquina. En este documento, hay ejemplos destinados para el sistema operativo basado en RHEL. Para las versiones de Windows u otros sistemas operativos, realiza ajustes para los pasos equivalentes específicos de esos entornos.

Follow the steps below on the separate machine with internet access to get the required files to start the installation process:

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 installUiPath.as for download instructions.

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

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

   • sf-infra.tar.gz - Optional. Only needd if you want to join additional nodes, including Task Mining and GPU. 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úrate de descargar el paquete adecuado para tu versión de AI Center y sistema operativo.

1.2 Obtén todos los archivos descargados en la primera máquina

Asegúrese de seguir los siguientes pasos:

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

Create the installation folder on the main machine of the cluster by running the following command:

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

On the separate machine with internet access, copy the files to the first node:

• Desde la máquina con acceso a Internet, copie los archivos a la carpeta de instalación en la máquina de destino, y el/los paquete(s) sin conexión a la carpeta /uipath/tmp.

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

• (Opcional) Para utilizar Document Understanding, copie los siguientes paquetes en la carpeta /uipath/tmp.

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

  Nota:

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

• (Opcional) Para utilizar Computer Vision, copie el siguiente paquete en la carpeta /uipath/tmp.

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

  Nota:

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

Paso 2: Copia el certificado de Orchestrator en máquina virtual

Nota:

In case of chain certificates, check the Chain certificates section on how to correctly provide certificates.

Descarga y guarda el certificado de Orchestrator en tu máquina local. Puedes hacerlo utilizando un navegador o pidiendo a tu departamento de TI que te proporcione el certificado. Los certificados deben estar en base64 y en formato .cer" id="1"/>. Copia el certificado en la máquina virtual utilizando el siguiente comando.

Comprueba que /opt/UiPathAutomationSuite" id="1"/> tenga el permiso adecuado para que los archivos se copien en scp, o que copie el archivo en tu directorio de inicio y luego muéstralo a /opt/UiPathAutomationSuite" id="2"/>.

scp /path/to/orch.cer <username>@<node dns>:/opt/UiPathAutomationSuite

Si Identity Server es diferente a Orchestrator repite también los pasos de identityserver.cer" id="1"/>.

Certificados de cadena

Cuando utilices un certificado emitido por el dominio, asegúrate de exportar el certificado raíz de la siguiente manera:

1. Abre el certificado, ve a la pestaña Ruta de certificación y selecciona el primer certificado. Haz clic en Ver certificado.

   

2. Una vez que se muestra el certificado raíz, ve a la pestaña Detalles y haz clic en Copiar a archivo.

   

3. Asegúrate de seleccionar el formato cer" id="1"/> de archivo base64.

4. Guárdalo con el nombre que prefieras y luego envíalo a la máquina de AI Center.

El archivo resultante debería ser similar al del siguiente ejemplo.

-----BEGIN CERTIFICATE-----
certificate
base64
encoded
-----END CERTIFICATE-----

Paso 3: Configura la instalación

Configuración básica

The following prerequisites are applicable for the main machine of the cluster.

1. Añade los siguientes requisitos previos a la RUTA actual:

   El instalador interactivo requiere jq" id="1"/> y nuestros paquetes sin conexión ya lo incluyen. Ejecuta los siguientes comandos para añadirlo a PATH: (comprueba que aún estas en la raíz)

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

2. Proporciona permisos para 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.

   Ejecuta el siguiente comando para otorgar los permisos:

   chmod -R 755 /opt/UiPathAutomationSuite
   

3. Ejecuta el asistente de instalación interactivo para configurar las opciones de instalación:

   El asistente interactivo hará de guía a través de los pasos de configuración y generará el archivo de configuración que puede personalizarse y utilizarse luego en los pasos de instalación restantes.

4. Ejecuta el script para iniciar el asistente interactivo ejecutando el siguiente comando:

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

5. Sigue los pasos en el asistente a continuación.

3.1 Utiliza el asistente interactivo para crear el archivo de configuración base.

Nota:

Make sure to not start the install from the script and exit it when config file is generated, it will try to install full Automation suite otherwise. This script is primarily used for Automation Suite and the displayed information (products, requirements) is relative to Automation Suite. The config file will be adapted to our needs in the next steps of the procedure.

Al iniciar el asistente de instalación, se muestra el menú principal. En este menú, tendrás que elegir el modo de implementación deseado: multinodo o nodo único. Se te pedirá detalles sobre cada modo cuando se realice una elección. A continuación, tienes la posibilidad de continuar con la elección actual o volver al menú principal.

Sigue los pasos de configuración de implementación:

1. Accept the license agreement.

2. Selecciona el modo de implementación: selecciona la opción de Implementación multinodo.

   

3. Selecciona Continuar.

4. Selecciona Instalación aislada.

5. Selecciona Completar instalación.

6. Introduzca el nombre de host de DNS.

7. Especifique si desea utilizar la autenticación de Kerberos para conexiones SQL.

8. Introduzca la URL de SQL Server. Siga las instrucciones para introducir el puerto de conexión, el nombre de usuario y la contraseña.

9. Especifica si quieres que el instalador cree automáticamente las bases de datos necesarias.

   

El archivo de configuración del clúster se generará con una carpeta como se muestra en la siguiente imagen.

Nota:

Tan pronto como genere el archivo de configuración y la carpeta, puede salir del asistente y proceder con los pasos restantes para completar la instalación. Puedes ignorar lista de productos, ya que la actualizaremos en los siguientes pasos.

Se genera una primera versión del archivo cluster_config.json" id="1"/>. Actualizaremos este archivo para la instalación de AI Center.

3.2 Añadir configuración específica de AI Center

Abre el archivo con tu editor (por ejemplo, vi):

vi /opt/UiPathAutomationSuite/cluster_config.json

Sustituye el siguiente bloque:

"aicenter": {
  "enabled": "false"
},

Nota:

Document Understanding is enabled by default if AI Center is enabled.

Con la información siguiente (sustituyendo la información entre <>" id="1"/> con tus valores):

"aicenter": {
  "enabled": "true",
  "orchestrator_url":"<https://orchestrator-url.com>",
  "identity_server_url": "<https://orchestrator-url.com/identity>",
  "orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
  "identity_cert_file_path":  "</opt/UiPathAutomationSuite/orch.cer or custom path>",
  "identity_access_token": "<placeholder will be replaced later>"
},

3.3 (Opcional) Configuración avanzada

Puedes encontrar el archivo cluster_config.json" id="1"/> en la carpeta UiPathAutomationSuite" id="2"/>. Puedes utilizar este archivo para configurar tu DBs SQL y sus correspondientes strings de conexión y certificados. También puedes habilitar la configuración del proxy en el caso de que utilices uno para la conexión a Internet.

For advanced configuration, see Using the configuration file.

Paso 4: copiar los archivos de instalación en todas las demás máquinas del clúster

From the first machine in the cluster, where the configuration was performed, copy the entire install folder to all other machines:

1. Copia la carpeta ~/UiPathAutomationSuite" id="1"/> en el resto de nodos ejecutando:

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

   Nota:

   Since we 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.

Nota:

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 5: Ejecuta la instalación

1. Ejecuta el instalador de la infraestructura en todos los nodos:

   1. Configura el equipo principal ejecutando los siguientes comandos en el servidor principal:

      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 --install-standalone-aicenter
      

   2. Une el resto de los servidores al clúster ejecutando los siguientes comandos en el resto de los nodos de servidor:

      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 /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicenter
      

   3. Une al resto de agentes al clúster ejecutando los siguientes comandos en el resto de nodos agente:

      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 /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicenter
      

2. Ejecuta el instalador de Fabric en el nodo primario

   cd /opt/UiPathAutomationSuite
   export TMPDIR="/uipath/lib/containers/tmp"
   mkdir -p "/uipath/lib/containers/tmp"
   ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f --offline-bundle /uipath/tmp/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement --install-standalone-aicenter
   

3. Run the software installer on primary node First you need to connect to identity server and retrieve an installation token. Then copy this token and paste it in placeholder we had in step 3.2. (in the cluster_config.json file). Once the token is there, you can run the AI Center install.

   ./install-uipath.sh -i cluster_config.json -o output.json --install-type offline --accept-license-agreement --install-standalone-aicenter -s
   

4. Carga los comandos de paquetes de Document Understanding opcionales. Para cargar los paquetes opcionales, ejecuta el siguiente comando. Comprueba que utilizas el nombre del paquete que necesitas cargar.

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

5. Carga el comando del paquete opcional de Computer Vision. 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"