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 :

• rapide : en téléchargeant et en exécutant un script fourni ; utilisé lorsque vous souhaitez configurer HAA dans un centre de données unique. Pour de plus amples informations, consultez la section Installation rapide.
• avancée : en effectuant certaines opérations complexes, y compris la configuration DNS du cluster, ainsi que la création et la configuration du cluster ; utilisé lorsque vous souhaitez configurer HAA dans plusieurs centres de données. Pour de plus amples informations, consultez la section Installation de la reprise après sinistre active/active

Avant de procéder à l'installation de votre HAA (High Availability Add-on), vérifiez que vous répondez aux exigences matérielles et logicielles.

Remarque :

HAA nécessite une licence distincte d'Orchestrator.

Le modèle de déploiement Récupération d'urgence actif/actif (Active/Active Disaster Recovery) nécessite deux licences HAA. Contactez UiPath pour plus de détails.

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.
• assurez-vous que vous disposez d'un certificat SSL/TLS valide. Reportez-vous à la documentation Redis pour savoir comment mettre à jour vos certificats ;
• service de pare-feu activé.

Remarque :

Les autorisations root ne sont requises que pour l'installation et la mise à niveau, et l'utilisateur admin HAA n'a pas besoin d'autorisations progressives pour administrer les services du cluster. Sur les démons suivants exécutés par l'utilisateur admin HAA, des bits de capacité ont été définis pour accorder à l'exécutable les privilèges minimaux requis pour fonctionner :

• /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. Répétez ce processus sur tous les nœuds sur lesquels vous installez HAA. vérifiez si le français est ajouté à la liste des langues. Selon votre langue et votre jeu de caractères (encodage), vous pouvez rencontrer des problèmes lors de l'exécution du script d'installation. Il est recommandé de vérifier d'abord si le français est ajouté à la liste des langues, comme suit :

   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"
      

Installation rapide

Important :

Avant de procéder à l'installation rapide de HAA, assurez-vous que tous vos nœuds répondent aux prérequis.

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 :

   Reportez-vous à la section Paramètres des scripts pour de plus amples informations.

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 :

   Pour saisir votre système d’exploitation au format correct lorsque vous exécutez la commande d’installation, commencez par exécuter le suivant et notez la valeur du système d’exploitation dans le menu d’aide :

   get-haa.sh -h
   

   Pour obtenir la liste des SE pris en charge, reportez-vous à Exigences logicielles.

   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 :

   Reportez-vous à la section Paramètres des scripts pour de plus amples informations.

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

   chmod a+x get-haa.sh
   

6. Installez le nœud secondaire :

   Remarque :

   Pour saisir votre système d’exploitation au format correct lorsque vous exécutez la commande d’installation, commencez par exécuter le suivant et notez la valeur du système d’exploitation dans le menu d’aide :

   get-haa.sh -h
   

   Pour obtenir la liste des SE pris en charge, reportez-vous à Exigences logicielles.

   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). Assurez-vous de revérifier 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.
--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 :

Vous pouvez utiliser des adresses IP ou des enregistrements DNS pour les nœuds du cluster Redis dans le paramètre LoadBalancer.Redis.ConnectionString .

Cependant, pour les environnements de production, l’utilisation d’enregistrements DNS est plus évolutive et recommandée.

Pour plus d’informations, consultez la section Configuration des DNS du cluster.

Configuration de cluster_config.json

Important :

Cette étape est requise uniquement si vous utilisez HAA pour Automation Suite.

Pour utiliser HAA, vous devez configurer Automation Suite en mettant à jour la section fabric.redis du fichier cluster_config.json. Pour de plus amples informations, consultez Configuration de High Availability Add-on.

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. Sélectionnez l'onglet Nodes (Nœuds) et vérifiez que tous les nœuds installés possèdent le statut OK.

   

4. Sélectionnez l'onglet Databases et confirmez que le statut de la base de données uipath-orchestrator indiqué est 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. À l'aide de votre navigateur, accédez à l'adresse IP de n'importe quel nœud HAA 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. Sélectionnez Settings (Paramètres) > Onglet General (Général).

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

5. Sélectionnez Enregistrer.

Votre cluster HAA est maintenant prêt et vous pouvez procéder à l'installation d'Orchestrator, comme décrit dans le programme d'installation Windows Installer.