Instalación

High Availability Add-on (HAA) para tu instancia de Orchestrator se realiza descargando y ejecutando un script proporcionado.

Before proceeding with your HAA installation be sure that you meet the Hardware and Software Requirements.

Nota:

• HAA requiere una licencia independiente de Orchestrator. Contacta con UiPath para más información.
• Active/Active Disaster Recovery deployment models require two HAA licenses.

Nota:

Orchestrator es compatible con versiones anteriores, pero recomendamos actualizar a la versión más reciente de HAA.

Instalación

Requisitos previos

Antes de iniciar la instalación de HAA, asegúrate de que:

• eres el usuario raíz o tienes acceso a sudo del usuario raíz.

• tienes derechos de creación de usuarios.

• ensure that you have a valid SSL/TLS certificate. Refer to Redis documentation for instructions on how to update your certificates.

• servicio de firewall habilitado.

  Nota:

  Los permisos de raíz se necesitan solo para la instalación y actualización. El usuario administrador de HAA no necesita permisos escalados para administrar los servicios del clúster.

  En los siguientes daemons ejecutados por el usuario administrador de HAA, se han establecido bits de capacidad para permitir al ejecutable los privilegios mínimos necesarios para operar:

  /opt/redislabs/bin/dmcproxy = cap_sys_resource+ep

  /opt/redislabs/bin/redis-server-4.0 = cap_sys_resource+ep

  /opt/redislabs/bin/redis-server-4.0-big = cap_sys_resource+ep

  /opt/redislabs/bin/redis-server-5.0 = cap_sys_resource+ep

  /opt/redislabs/bin/redis-server-5.0-big = cap_sys_resource+ep

  /opt/redislabs/bin/sentinel_service = cap_sys_resource+ep

  /opt/redislabs/sbin/pdns_server = cap_net_bind_service+ep

  /opt/redislabs/sbin/smaps = cap_sys_ptrace+ep

  Estos permiten al usuario administrador de HAA ejecutar estos servicios con privilegio sin necesidad de que el usuario tenga asignados los privilegios".

• deshabilitas Swap:

1. Deshabilita swap con el comando: sudo swapoff -a.
2. Para que este cambio persista en los reinicios, comenta la entrada swap en el archivo etc/fstab ejecutando: sudo sed -i.bak '/ swap / s/^(.*)$/#1/g' /etc/fstab.
3. Instala el paquete wget, que se utiliza para descargar el archivo de instalación RS, ejecutando el comando yum install wget.
4. Repite este proceso en todos los nodos en los que instalas HAA.

Además, dependiendo de tu idioma y conjunto de caracteres (codificación), puedes tener problemas al ejecutar el script de instalación. Se recomienda comprobar primero si el inglés se ha añadido a la lista de idiomas:

1. Para ver información sobre la locale en uso actualmente instalada: ejecuta locale -a o localectl.
2. Establece el inglés como idioma y la codificación para la sesión actual, ejecutando: $ export LANG="en_US.utf8".

Nodo maestro

1. Descarga el script de instalación ejecutando wget https://raw.githubusercontent.com/UiPath/Infrastructure/main/Setup/get-haa.sh.

2. Haz que el script sea ejecutable ejecutando chmod a+x get-haa.sh.

3. Instala el nodo maestro con el siguiente comando: sudo ./get-haa.sh -u <email> -p <password>.

   Proporciona el correo electrónico y la contraseña deseada para el administrador de la cuenta, y los directorios de instalación.

   Importante:

   • Para instalar HAA en una ubicación personalizada, ejecuta el script install.sh para la configuración avanzada (no crea ningún clúster), teniendo en cuenta que todas las ubicaciones deben ser diferentes. Por ejemplo:

   sudo ./install.sh --install-dir /opt/haa-uipath --config-dir /etc/opt/haa-uipath --var-dir /var/opt/haa-uipath.

   • Vuelve a comprobar la ruta de instalación seleccionada. No es posible mover una instalación desde una ubicación a otra después de la instalación.

Nodos secundarios

Después de instalar el nodo principal (maestro), desde cada nodo adicional:

1. Crea el directorio en el que se descarga y extrae HAA, por ejemplo: mkdir haa.

2. Cambia al directorio creado recientemente con el comando: cd /<path-to>/haa/.

3. Descarga el script de instalación ejecutando wget https://raw.githubusercontent.com/UiPath/Infrastructure/main/Setup/get-haa.sh.

4. Haz que el script sea ejecutable ejecutando chmod a+x get-haa.sh.

5. Instala el nodo con el siguiente comando: sudo ./get-haa.sh -u <email> -p <password> -j <IP_address_of_the_master_node>.

   Proporciona el correo electrónico y la contraseña establecidos al crear el nodo maestro, y la dirección IP del nodo principal.

Parámetros de los scripts

Los siguientes parámetros están disponibles al ejecutar el script de instalación de HAA:

Parámetro	Descripción
-u	El nombre de usuario del administrador del clúster HAA. Por ejemplo -u [e-mail].
-p	La contraseña del usuario de administración, establecida al instalar el nodo principal. Por ejemplo -p SuperSecret_Password.
-j	La dirección IP del nodo principal. Cuando se proporciona, se instala un nodo secundario (esclavo). Por ejemplo -j 10.10.22.10.
--install-dir	Indica la ruta al directorio de instalación de HAA (solo cuando ejecutes el script install.sh para la instalación avanzada). Vuelve a comprobar la ruta de instalación seleccionada. No es posible mover una instalación desde una ubicación a otra después de la instalación.
--config-dir	Indica la ruta al directorio de configuración de HAA (solo cuando ejecutes el script install.sh para la instalación avanzada).
--var-dir	Indica la ruta al directorio de variables de HAA (solo cuando ejecutes el script install.sh para la instalación avanzada).
-h	Se utiliza para mostrar la guía de instalación.
-l	El código de licencia de tu clúster de HAA.

UiPath.Orchestrator.dll.config Configuration

You must configure Orchestrator to use HAA and add all HAA nodes to the Orchestrator UiPath.Orchestrator.dll.config file using the LoadBalancer.UseRedis and LoadBalancer.Redis.ConnectionString parameters. For example:

<add key="LoadBalancer.UseRedis" value="true" />
<add key="LoadBalancer.Redis.ConnectionString" value="10.10.20.184:10000,10.10.24.148:10000,10.10.22.114:10000,password=SuperSecret_Password" />

Verificar la instalación del clúster

Después de instalar todos los nodos de tu clúster de HAA, confirma la configuración con éxito de la siguiente manera:

1. Dirige tu navegador a la dirección IP de cualquier nodo HAA en el puerto 8443. Por ejemplo: https://10.10.20.196:8443/. Se muestra la página de inicio de sesión HAA.

   

2. Introduce el nombre de usuario y la contraseña que se proporcionan durante la instalación para iniciar sesión.

3. Selecciona la pestaña de nodos y comprueba que todos los nodos instalados aparezcan aquí con el estado OK.

   

4. Selecciona la pestaña de bases de datos y confirma que la base de datos uipath-orchestrator aparece aquí con el estado OK.

5. Si se implementa en más de un nodo, asegúrate de que la Replicación esté habilitada en la configuración de la base de datos y de que dos nodos muestren un recuento de fragmentos de 1. Esto garantiza que la base de datos se ha replicado en dos nodos.

   Nota:

   Por defecto, esta base de datos se crea en el puerto 10000 con la contraseña que se proporciona en la instalación.

Licencias de HAA

Para añadir o actualizar la licencia de tu complemento de alta disponibilidad, sigue los siguientes pasos:

1. Dirige tu navegador a la dirección IP de cualquier nodo HAA en el puerto 8443. Por ejemplo: https://10.10.20.196:8443/. Se muestra la página de inicio de sesión HAA.
2. Introduce el nombre de usuario y la contraseña que se proporcionan durante la instalación para iniciar sesión.
3. Selecciona la configuración > pestaña general.
4. En el campo Clave del grupo introduce la clave de tu licencia.
5. Haz clic en Guardar.

Your HAA cluster is now ready, and you can proceed with the Orchestrator installation, as described here.