Instalar High Availability Add-on

Información general de la instalación

Nota:

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

Hay dos maneras de instalar High Availability Add-on (HAA) para tu instancia de Orchestrator:

• rápido : descargando y ejecutando un script proporcionado; se utiliza cuando se desea configurar HAA dentro de un único centro de datos. Para obtener más información, consulta Instalación rápida.
• avanzado : realizando algunas operaciones complejas, incluida la configuración del DNS del clúster y la creación y configuración del clúster; se utiliza cuando se desea configurar HAA dentro de varios centros de datos. Para obtener más información, consulta Instalación de Active/Active Disaster Recovery.

Antes de proceder con tu instalación de HAA, asegúrate de que cumples los requisitos de hardware y software.

Nota:

HAA requiere una licencia independiente de Orchestrator.

El modelo de implementación Active/Active Disaster Recovery requiere dos licencias de HAA. Ponte en contacto con UiPath para obtener más información.

Requisitos previos

Los siguientes requisitos previos son idénticos a los métodos de instalación rápida y avanzada. Antes de iniciar la instalación de HAA, asegúrate de que:

• eres el usuario root o tienes acceso a sudo del usuario root;
• tienes derechos de creación de usuarios;
• asegúrate de tener un certificado SSL/TLS válido. Consulta el apartado de documentación de Redis para obtener instrucciones sobre cómo actualizar los certificados;
• servicio de firewall habilitado.

Nota:

Los permisos root solo son necesarios para la instalación y la actualización; el usuario administrador de HAA no necesita permisos de administrador para gestionar los servicios del grupo. 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.

1. Deshabilita swap:

   sudo swapoff -a
   

2. Para mantener este cambio en todos los reinicios, elimina la partición swap del archivo etc/fstab.

3. Instala el paquete wget. Asegúrate de usar un comando de descarga compatible con tu distribución Linux. Por ejemplo, si usas CentOS, ejecuta:

   yum install wget
   

4. Repite este proceso en todos los nodos en los que planeas instalar HAA. has comprobado que el inglés se ha añadido a la lista de idiomas. Dependiendo de tu idioma y conjunto de caracteres (codificación), puedes tener problemas al ejecutar el script de instalación. Se recomienda que compruebes primero si se añade el inglés a la lista de idiomas, de la siguiente manera:

   1. Ver información sobre el locale instalado actualmente ejecutando cualquiera de los siguientes comandos:

      locale -alocalectl
      

      localectl
      

   2. Establece el inglés como el idioma y codificación de la sesión actual ejecutando:

      $ export LANG="en_US.utf8"
      

Instalación rápida

Importante:

Antes de continuar con la instalación rápida de HAA, asegúrate de que todos los nodos cumplen los requisitos previos.

Instalación del nodo principal

Para instalar HAA en el nodo principal, realiza los siguientes pasos:

1. SSH en el nodo principal con permisos root.

2. Crea el directorio donde quieres descargar y extraer HAA, por ejemplo:

   mkdir haa
   

3. Descarga el script de instalación get-haa.sh:

   wget https://download.uipath.com/haa/get-haa.sh
   

   Nota:

   Consulta la sección Parámetros de script para obtener más información.

4. Convierte el script get-haa.sh en ejecutable:

   chmod a+x get-haa.sh
   

5. Instala el nodo principal. Asegúrate de proporcionar una dirección de correo electrónico y una contraseña para la cuenta de administrador. Puedes usar una dirección de correo electrónico temporal. También debes especificar el sistema operativo (SO) que se ejecuta en el nodo.

   Nota:

   Para introducir tu sistema operativo en el formato correcto al ejecutar el comando de instalación, ejecuta primero lo siguiente y anota el valor relevante del sistema operativo en el menú de ayuda:

   get-haa.sh -h
   

   Para obtener la lista de sistemas operativos compatibles, consulta Requisitos de software.

   sudo ./get-haa.sh -u <email> -p <password> -o <OS> --accept-license-agreement
   

Importante:

Para instalar HAA en una ubicación personalizada, ejecuta el script install-haa.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-haa.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.

Instalación del nodo secundario

Después de instalar el nodo principal, realiza los siguientes pasos en cada nodo secundario:

1. SSH el nodo secundario con permisos root.

2. Crea el directorio en el que planeas descargar y extraer HAA, por ejemplo:

   mkdir haa
   

3. Cambia al directorio recién creado:

   cd /<path-to>/haa/
   

4. Descarga el script de instalación get-haa.sh:

   wget https://download.uipath.com/haa/get-haa.sh
   

   Nota:

   Consulta la sección Parámetros de script para obtener más información.

5. Convierte el script get-haa.sh en ejecutable:

   chmod a+x get-haa.sh
   

6. Instala el nodo secundario:

   Nota:

   Para introducir tu sistema operativo en el formato correcto al ejecutar el comando de instalación, ejecuta primero lo siguiente y anota el valor relevante del sistema operativo en el menú de ayuda:

   get-haa.sh -h
   

   Para obtener la lista de sistemas operativos compatibles, consulta Requisitos de software.

   sudo ./get-haa.sh -u <email> -p <password> -o <OS> -j <IP_address_of_the_master_node> --accept-license-agreement
   

   Importante:

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

Script parameters

La siguiente tabla describe los parámetros que 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-haa.sh para la instalación avanzada). Asegúrate de comprobar la ruta de instalación seleccionada. No se admite el traslado de una instalación de 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-haa.sh para la instalación avanzada).
--var-dir	Indica la ruta al directorio de variables de HAA (solo cuando ejecutes el script install-haa.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. Por favor, introduce la licencia sin --- LICENSE START --- o --- LICENSE END --- al principio o al final y con ningún carácter new line.
--accept-license-agreement	Acepta el acuerdo de licencia de UiPath
--offline	Para instalaciones sin conexión. Da por hecho que el paquete se encuentra en la carpeta actual, al igual que el script de instalación. El enlace al paquete puede encontrarse en el script get-haa.sh.

Configuración de UiPath.Orchestrator.dll.config

Importante:

Este paso solo es necesario si utilizas HAA para Orchestrator independiente.

Debes configurar Orchestrator independiente para utilizar HAA y añadir todos los nodos HAA al archivo de configuración de Orchestrator mediante los parámetros LoadBalancer.UseRedis y LoadBalancer.Redis.ConnectionString. Por ejemplo:

<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,abortConnect=false" />

Nota:

Puedes utilizar direcciones IP o registros DNS para los nodos del clúster de Redis en el parámetro LoadBalancer.Redis.ConnectionString .

Sin embargo, para entornos de producción, se recomienda el uso de registros DNS, pues es más escalable.

Para obtener más detalles, consulta Configurar el DNS del clúster.

Configuring cluster_config.json

Importante:

Este paso solo es necesario si utilizas HAA para Automation Suite.

Debes configurar Automation Suite para utilizar HAA actualizando la sección fabric.redis en el archivo cluster_config.json. Para obtener más información, consulta Configuración de High Availability Add-on.

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 verifica que todos los nodos instalados se muestran con un estado de Aceptar.

   

4. Selecciona la pestaña de bases de datos y confirma que la base de datos uipath-orchestrator aparece 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.

Licencia de HAA

Para añadir o actualizar la licencia de High Availability Add-on realiza los siguientes pasos:

1. Usando el explorador, ve 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. Escribe el nombre de usuario y la contraseña proporcionados durante la instalación para iniciar sesión.

3. Selecciona Configuración > pestaña General.

4. En el campo Clave del clúster, escribe tu clave de licencia.

5. Selecciona Guardar.

Tu grupo HAA ya está listo. Puedes proceder con la instalación de Orchestrator, como se describe en el instalador de Windows.