Installer High Availability Add-on

Vue d'ensemble de l'installation

Remarque :

Nous prenons en charge la rétrocompatibilité avec Orchestrator, mais nous vous recommandons d'effectuer la mise à jour vers la dernière version HAA.

Il existe deux manières d'installer le module complémentaire High Availability Add-on (HAA) pour votre instance 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.

Remarque :

HAA requires a separate license from Orchestrator.

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

Prérequis

Les prérequis suivants sont identiques aux méthodes d'installation rapide et avancée. Avant de commencer l'installation du HAA, assurez-vous que :

• vous êtes l'utilisateur root ou que vous avez accès à sudo à l'utilisateur root.
• disposez de droits de création d’utilisateurs.
• ensure that you have a valid SSL/TLS certificate. Refer to Redis documentation for instructions on how to update your certificates;
• service de pare-feu activé.

Remarque :

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

Ceux-ci permettent à l'utilisateur administrateur HAA d'exécuter ces services avec des privilèges sans qu'il soit nécessaire de les lui attribuer.

1. Désactiver swap :

   sudo swapoff -a
   

2. Pour conserver cette modification lors des redémarrages, supprimez la partition swap dans le fichier etc/fstab.

3. Installez le package wget. Assurez-vous d'utiliser une commande de téléchargement prise en charge par votre distribution Linux. Par exemple, si vous utilisez CentOS, exécutez :

   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. Affichez les informations sur le locale actuellement installé en exécutant l'une ou l'autre des commandes suivantes :

      locale -alocalectl
      

      localectl
      

   2. Définissez le français comme langue et encodage pour la session en cours en exécutant :

      $ export LANG="en_US.utf8"
      

Quick installation

Important :

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

Installation du nœud principal

Pour installer HAA sur le nœud principal, procédez comme suit :

1. SSH le nœud principal avec des autorisations root.

2. Créez le répertoire dans lequel HAA doit être téléchargé et extrait, par exemple :

   mkdir haa
   

3. Téléchargez le script d'installation get-haa.sh :

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

   Remarque :

   Refer to the Script parameters section for more details.

4. Rendre le script get-haa.sh exécutable :

   chmod a+x get-haa.sh
   

5. Installez le nœud principal. Assurez-vous de saisir une adresse e-mail et un mot de passe pour le compte administrateur. Vous pouvez utiliser une adresse e-mail temporaire. Vous devez également indiquer le système d’exploitation exécuté sur le nœud.

   Remarque :

   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
   

Important :

Pour installer HAA dans un emplacement personnalisé, exécutez le script install-haa.sh en configuration avancée (cela ne crée aucun cluster), en gardant à l'esprit que tous les emplacements doivent être différents. Par exemple :

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

Vérifiez à nouveau le chemin d’installation sélectionné. Le déplacement d’une installation vers un autre emplacement après l’installation n’est pas pris en charge.

Installation des nœuds secondaires

Après avoir installé le nœud principal, procédez comme suit sur chaque nœud secondaire :

1. Connectez-vous en SSH au nœud secondaire avec les autorisations root.

2. Créez le répertoire dans lequel HAA doit être téléchargé et extrait, par exemple :

   mkdir haa
   

3. Accéder au répertoire nouvellement créé :

   cd /<path-to>/haa/
   

4. Téléchargez le script d'installation get-haa.sh :

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

   Remarque :

   Refer to the Script parameters section for more details.

5. Rendre le script get-haa.sh exécutable :

   chmod a+x get-haa.sh
   

6. Installez le nœud secondaire :

   Remarque :

   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
   

   Important :

   Saisissez l'adresse e-mail, le mot de passe et l'adresse IP définis lors de la création du nœud principal.

Script parameters

Le tableau suivant décrit les paramètres disponibles lors de l'exécution du script d'installation High Availability Add-on (HAA) :

Paramètre	Description
-u	Nom d'utilisateur de l'administrateur de cluster HAA. Par exemple -u [e-mail].
-p	Mot de passe de l'utilisateur d'administration, défini lors de l'installation du nœud principal. Par exemple -p SuperSecret_Password.
-j	Adresse IP du nœud principal. Lorsqu'il est fourni, un nœud secondaire (esclave) est installé. Par exemple -j 10.10.22.10.
--install-dir	Indiquez le chemin d’accès au répertoire d’installation HAA (uniquement lors de l’exécution du script install-haa.sh dans le cadre des installations avancées). Make sure to double-check the selected installation path. Moving an installation from one location to another post-install is not supported.
--config-dir	Indiquez le chemin d’accès au répertoire de configuration HAA (uniquement lors de l’exécution du script install-haa.sh dans le cadre des installations avancées).
--var-dir	Indiquez le chemin d’accès au répertoire des variables HAA (uniquement lors de l’exécution du script install-haa.sh dans le cadre des installations avancées).
-h	Utilisé pour afficher le guide d'aide à l'installation.
-l	Code de licence pour votre cluster HAA. Veuillez entrer la licence sans les --- LICENSE START --- ou --- LICENSE END --- de début et de fin et sans aucun caractère new line.
--accept-license-agreement	Accepte le contrat de licence UiPath
--offline	Pour une installation hors ligne. Il suppose que le package se trouve dans le dossier actuel, comme le script d'installation. Le lien du package se trouve dans le script get-haa.sh.

Configuration de UiPath.Orchestrator.dll.config

Important :

Cette étape est requise uniquement si vous utilisez HAA pour l’installation autonome d’Orchestrator.

Vous devez configurer la version autonome d'Orchestrator pour utiliser HAA et ajouter tous les nœuds HAA au fichier de configuration d’Orchestrator à l’aide des paramètres LoadBalancer.UseRedis et LoadBalancer.Redis.ConnectionString. Par exemple :

<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" />

Remarque :

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.

Configuration de cluster_config.json

Important :

Cette étape est requise uniquement si vous utilisez HAA pour 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.

Vérification de l'installation du cluster

Après avoir installé tous les nœuds de votre cluster HAA, confirmez la configuration réussie, comme suit :

1. Accédez à l'adresse IP de n'importe quel nœud HAA via votre navigateur sur le port 8443. Par exemple : https://10.10.20.196:8443/. La page de connexion HAA s'affiche.

   

2. Entrez le nom d'utilisateur et le mot de passe fournis lors de l'installation pour vous connecter.

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. S’il est déployé sur plus d’un nœud, assurez-vous que la réplication est activée dans les paramètres de base de données et que deux nœuds affichent un nombre de partitions de 1. Cela garantit que la base de données est répliquée sur deux nœuds.

   Remarque :

   Par défaut, cette base de données est créée sur le port 10000 avec le mot de passe fourni lors de l'installation.

Licence HAA

Pour ajouter ou mettre à jour votre licence du module complémentaire High Availability Add-on, procédez comme suit :

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. Entrez le nom d'utilisateur et le mot de passe fournis lors de l'installation pour vous connecter.

3. Select Settings > General tab.

4. Dans le champ Clé de cluster, saisissez votre clé de licence.

5. Sélectionnez Enregistrer.

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