Installation

L'installation du module complémentaire haute disponibilité (HAA) pour votre instance d'Orchestrator est effectuée en téléchargeant et en exécutant un script fourni.

Avant de procéder à votre installation de HAA, veillez à respecter la Configuration matérielle et logicielle requises.

Remarque :

Le HAA exige une licence distincte d'Orchestrator. Contactez UiPath pour en savoir plus.
Les modèles de déploiement Récupération d'urgence actif/actif (Active/Active Disaster Recovery) nécessitent deux licences HAA.

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.

Installation

Prérequis

Avant de commencer l'installation du HAA, assurez-vous que :

vous êtes l'utilisateur racine ou que vous avez accès à sudo à l'utilisateur racine.
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 de racine 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."
désactivez Swap :

Désactivez swap à l'aide de la commande sudo swapoff -a.
Pour conserver cette modification via les redémarrages, commentez l'entrée swap dans le fichier etc/fstab en exécutant : sudo sed -i.bak '/ swap / s/^(.*)$/#1/g' /etc/fstab.
Installez le paquet wget utilisé pour télécharger le fichier d'installation RS en exécutant la commande yum install wget.
Répétez ce processus sur tous les nœuds sur lesquels vous installez HAA.

En outre, 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 a été ajouté à la liste des langues :

Afficher les informations sur les locale installées actuellement utilisées : exécutez locale -a ou localectl.
Définissez le français comme langue et encodage pour la session en cours en exécutant :$ export LANG="en_US.utf8".

Nœud maître

Téléchargez le script d'installation en exécutant wget https://raw.githubusercontent.com/UiPath/Infrastructure/main/Setup/get-haa.sh.
Rendez le script exécutable en exécutant chmod a+x get-haa.sh.
Installez le ou les nœuds secondaires à l'aide de la commande suivante :
sudo ./get-haa.sh -u <email> -p <password>.
Fournissez l'adresse e-mail ainsi que le mot de passe souhaité pour l’administrateur de compte et les répertoires d’installation.
Important :
- Pour installer HAA dans un emplacement personnalisé, exécutez le script install.sh en configuration avancée (cela ne crée aucune grappe), en gardant à l'esprit que tous les emplacements doivent être différents. Par exemple :
sudo ./install.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.

Nœuds secondaires

Après avoir installé le nœud principal (maître), à partir de chaque nœud supplémentaire :

Créez le répertoire dans lequel HAA doit être téléchargé et extrait, par exemple : mkdir haa.
Passez au répertoire que vous venez de créer à l'aide de la commande : cd /<path-to>/haa/.
Téléchargez le script d'installation en exécutant wget https://raw.githubusercontent.com/UiPath/Infrastructure/main/Setup/get-haa.sh.
Rendez le script exécutable en exécutant chmod a+x get-haa.sh.
Installez le nœud à l'aide de la commande suivante : sudo ./get-haa.sh -u <email> -p <password> -j <IP_address_of_the_master_node>.

Fournissez l'adresse e-mail et le mot de passe définis lors de la création du nœud maître, ainsi que l'adresse IP du nœud primaire.

Paramètres de script

Les paramètres suivants sont disponibles lors de l'exécution du script d'installation HAA :

Paramètre	Description
`-u`	Nom d'utilisateur de l'administrateur de cluster HAA. Par exemple `-u documentation@uipath.com`.
`-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.sh` dans le cadre des installations avancées). Remarque : 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.
`--config-dir`	Indiquez le chemin d’accès au répertoire de configuration HAA (uniquement lors de l’exécution du script `install.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.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.

UiPath.Orchestrator.dll.config Configuration

Vous devez configurer Orchestrator pour utiliser HAA et ajouter tous les nœuds HAA au fichier d'Orchestrator UiPath.Orchestrator.dll.config à 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" /><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" />

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 :

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.
Entrez le nom d'utilisateur et le mot de passe fournis lors de l'installation pour vous connecter.
Sélectionnez l'onglet Nœuds (Nodes) et vérifiez que tous les nœuds installés s'affichent ici avec un statut OK (OK).
Sélectionnez l'onglet Bases de données (Databases) et confirmez que la base de données uipath-orchestrator s'affiche ici avec le statut OK (OK).
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.

Licences HAA

Pour ajouter ou mettre à jour votre licence de complément haute disponibilité, procédez comme suit :

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.
Entrez le nom d'utilisateur et le mot de passe fournis lors de l'installation pour vous connecter.
Sélectionnez les onglets Paramètres > Général.
Dans le champ Clé de cluster, entrez votre clé de licence.
Cliquez sur Enregistrer (Save).