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:

• quick – by downloading and executing a provided script; used when you want to set up HAA inside a single data center. For details, refer to Quick installation.
• advanced – by performing some complex operations, including cluster DNS configuration, and cluster creation and setup; used when you want to set up HAA inside multiple data centers. For details, refer to Active/Active Disaster Recovery Installation.

Before proceeding with your HAA installation, make sure that you meet the hardware and software requirements.

Nota:

HAA requires a separate license from Orchestrator.

Active/Active Disaster Recovery deployment model requires two HAA licenses. Contact UiPath for details.

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

Root permissions are required only for installation and upgrade; the HAA admin user does not need escalated permissions to administer the cluster services. On the following daemons run by the HAA admin user, capability bits have been set to allow the executable the minimal privileges required to operate:

• /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. Repeat this process on all nodes where you plan to install HAA. Check if English is added to the list of languages. Depending on your language and character set (encoding), you may experience issues while running the installation script. It is recommended that you first check if English is added to the list of languages, as follows:

   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"
      

Quick installation

Importante:

Before proceeding with the quick installation of HAA, make sure all your nodes meet the prerequisites.

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:

   Refer to the Script parameters section for more details.

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:

   To enter your OS in the correct format when running the installation command, run the following first and note the relevant OS value in the help menu:

   get-haa.sh -h
   

   For the list of suppoted OSs, refer to Software requirements.

   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:

   Refer to the Script parameters section for more details.

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

   chmod a+x get-haa.sh
   

6. Instala el nodo secundario:

   Nota:

   To enter your OS in the correct format when running the installation command, run the following first and note the relevant OS value in the help menu:

   get-haa.sh -h
   

   For the list of suppoted OSs, refer to Software requirements.

   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). Make sure to double-check the selected installation path. Moving an installation from one location to another post-install is not supported.
--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:

You can use either IP addresses or DNS records for the Redis cluster nodes in the LoadBalancer.Redis.ConnectionString parameter.

However, for production environments, using DNS records is more scalable and recommended.

For more details, refer to Configure cluster DNS.

Configuring cluster_config.json

Importante:

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

You must configure Automation Suite to use HAA by updating the fabric.redis section in the cluster_config.json file. For more details, refer to High Availability Add-on configuration.

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. Select the nodes tab and verify that all installed nodes are displayed with a status of OK.

   

4. Select the databases tab and confirm that the uipath-orchestrator database appears with a status of 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. Using your browser, navigate to the IP address of any HAA node on port 8443.

   For example: https://10.10.20.196:8443/. The HAA login page is displayed.

2. Escribe el nombre de usuario y la contraseña proporcionados durante la instalación para iniciar sesión.

3. Select Settings > General tab.

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

5. Selecciona Guardar.

Your HAA cluster is now ready, and you can proceed with the Orchestrator installation, as described in the The Windows Installer.