Guide d'installation d'Orchestrator

PRODUIT :

Automation Cloud Automation Cloud Public Sector Automation Suite Standalone

Dernière mise à jour 4 déc. 2024

Installation

En savoir plus sur l’installation du module complémentaire haute disponibilité (HAA).

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 seul centre de données.

Pour en savoir plus, consultez Installation rapide (Quick installation).
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 en savoir plus, consultez Installation de récupération d'urgence actif/actif (Active/Active Disaster Recovery Installation).

Avant de procéder à votre installation de HAA, veillez à respecter les prérequis matériels et logiciels.

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 -asudo 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 wgetyum 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 -alocalectllocale -alocalectl
    localectllocalectl
  2. Définissez le français comme langue et encodage pour la session en cours en exécutant :
    $ export LANG="en_US.utf8"$ export LANG="en_US.utf8"

Installation rapide

Attention : 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 :

SSH le nœud principal avec des autorisations root.
Créez le répertoire dans lequel HAA doit être téléchargé et extrait, par exemple :
```
mkdir haamkdir haa
```
Téléchargez le script d'installation get-haa.sh :
```
wget https://download.uipath.com/haa/get-haa.shwget https://download.uipath.com/haa/get-haa.sh
```
Remarque : Voir la section Paramètres de script (Script parameters) pour plus de détails.
Rendre le script get-haa.sh exécutable :
```
chmod a+x get-haa.shchmod a+x get-haa.sh
```
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 get-haa.sh -h et notez la valeur du système d’exploitation dans le menu d’aide.
Les valeurs de système d’exploitation possibles sont actuellement Rhel8, Rhel9 et 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
```

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 :

Connectez-vous en SSH au nœud secondaire avec les autorisations root.
Créez le répertoire dans lequel HAA doit être téléchargé et extrait, par exemple :
```
mkdir haamkdir haa
```
Accéder au répertoire nouvellement créé :
```
cd /<path-to>/haa/cd /<path-to>/haa/
```
Téléchargez le script d'installation get-haa.sh :
```
wget https://download.uipath.com/haa/get-haa.shwget https://download.uipath.com/haa/get-haa.sh
```
Remarque : Voir la section Paramètres de script (Script parameters) pour plus de détails.
Rendre le script get-haa.sh exécutable :
```
chmod a+x get-haa.shchmod a+x get-haa.sh
```
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 get-haa.sh -h et notez la valeur du système d’exploitation dans le menu d’aide.
Les valeurs de système d’exploitation possibles sont actuellement Rhel8, Rhel9 et 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
```
Attention : 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

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-haa.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-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 Orchestrator pour utiliser HAA et ajouter tous les nœuds HAA au fichier de configuration 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.

Licence HAA

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

À 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.
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, saisissez votre clé de licence.
Cliquez sur Enregistrer (Save).