Guía de instalación de Orchestrator

ENTREGA:

Automation Cloud Automation Cloud Public Sector Automation Suite Standalone

Última actualización 4 de dic. de 2024

Instalación

Más información sobre la instalación High Availability Add-On (HAA).

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; usado cuando quieres configurar HAA dentro de un único centro de datos.

Para más información, consulta Instalación rápida.
avanzado: realizando algunas operaciones complejas, incluyendo la configuración de DNS del clúster, y la creación y configuración del clúster, se usa cuando quieres configurar HAA dentro de varios centros de datos.

Para más información, consulta Instalación de Active/Active Disaster Recovery.

Antes de continuar con la instalación de HAA, asegúrate de cumplir 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 -asudo 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 wgetyum 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 -alocalectllocale -alocalectl
    localectllocalectl
  2. Establece el inglés como el idioma y codificación de la sesión actual ejecutando:
    $ export LANG="en_US.utf8"$ 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:

SSH en el nodo principal con permisos root.
Crea el directorio donde quieres descargar y extraer HAA, por ejemplo:
```
mkdir haamkdir haa
```
Descarga el script de instalación get-haa.sh:
```
wget https://download.uipath.com/haa/get-haa.shwget https://download.uipath.com/haa/get-haa.sh
```
Nota: consulta la sección Parámetros de script para obtener más información.
Convierte el script get-haa.sh en ejecutable:
```
chmod a+x get-haa.shchmod a+x get-haa.sh
```
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 get-haa.sh -h primero y nota el valor relevante del sistema operativo en el menú de ayuda.
Los valores posibles del sistema operativo son actualmente Rhel8, Rhel9 o UbuntuFocal.
```
sudo ./get-haa.sh -u <email> -p <password> -o <OS> --accept-license-agreementsudo ./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:

SSH el nodo secundario con permisos root.
Crea el directorio en el que planeas descargar y extraer HAA, por ejemplo:
```
mkdir haamkdir haa
```
Cambia al directorio recién creado:
```
cd /<path-to>/haa/cd /<path-to>/haa/
```
Descarga el script de instalación get-haa.sh:
```
wget https://download.uipath.com/haa/get-haa.shwget https://download.uipath.com/haa/get-haa.sh
```
Nota: consulta la sección Parámetros de script para obtener más información.
Convierte el script get-haa.sh en ejecutable:
```
chmod a+x get-haa.shchmod a+x get-haa.sh
```
Instala el nodo secundario:
Nota: para introducir tu sistema operativo en el formato correcto al ejecutar el comando de instalación, ejecuta get-haa.sh -h primero y nota el valor relevante del sistema operativo en el menú de ayuda.
Los valores posibles del sistema operativo son actualmente Rhel8, Rhel9 o UbuntuFocal.
```
sudo ./get-haa.sh -u <email> -p <password> -o <OS> -j <IP_address_of_the_master_node> --accept-license-agreementsudo ./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

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 documentation@uipath.com`.
`-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). Nota: verifica 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-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 UiPath.Orchestrator.dll.config de Orchestrator utilizando 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" /><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:

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.
Introduce el nombre de usuario y la contraseña que se proporcionan durante la instalación para iniciar sesión.
Selecciona la pestaña de nodos y comprueba que todos los nodos instalados aparezcan aquí con el estado OK.
Selecciona la pestaña de bases de datos y confirma que la base de datos uipath-orchestrator aparece aquí con el estado OK.
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 10000con 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:

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.
Escribe el nombre de usuario y la contraseña proporcionados durante la instalación para iniciar sesión.
Selecciona la configuración > pestaña general.
En el campo Clave del clúster, escribe tu clave de licencia.
Haz clic en Guardar.