Installation de production hors ligne multi-nœuds compatible haute disponibilité

Cette page explique comment effectuer une installation hors ligne d'Automation Suite avec une configuration en mode production multi-nœuds compatible haute disponibilité.

Vue d'ensemble (Overview)

Important :

Vous devez remplir les prérequis matériels et logiciels avant de procéder à l'installation. Voir Prérequis logiciels et matériels.

Vous pouvez utiliser un script dédié pour valider les prérequis de l'installation et l'état de préparation de l'infrastructure. Voir Validation des prérequis.

Pour une expérience d'installation fluide, assurez-vous de suivre nos meilleures pratiques. Consultez .

Utilisez les étapes d'installation hors ligne de ce document lors du déploiement de la suite UiPath Automation dans un environnement isolé sans accès à Internet.

Le processus d'installation comporte les étapes générales suivantes :

Étape	Description
Étape 1 : Téléchargez les packages d'installation	Cette étape doit être effectuée à partir d'une machine ayant accès à Internet et aux machines isolées sur lesquelles Automation Suite sera déployée. En attendant la fin du téléchargement, vous pouvez effectuer certaines des étapes suivantes. Cela peut être fait à partir d'une machine Linux ou Windows. Étape 1.1 : Téléchargement du package d'installation Étape 1.2 : Obtenir tous les fichiers téléchargés sur la première machine
Étape 2 : Configuration de l'installation	Exécutez l'assistant d'installation interactif pour configurer les options d'installation L'outil rassemble les entrées pour les options d'installation les plus courantes et génère un fichier de configuration qui peut être utilisé lors de l'installation. Configurez les options d'installation avancées (facultatif) La configuration d'installation par défaut inclut les produits utilisés dans l'automatisation principale et un serveur SQL partagé pouvant être utilisé par tous les produits. Pour personnaliser les produits installés ou utiliser des serveurs SQL distincts pour des produits spécifiques, vous pouvez modifier le fichier de configuration. Étape 2.1 : Configuration de base Étape 2.2 : (Facultatif) Configuration avancée
Étape 3 : Copiez les fichiers d'installation sur toutes les machines	Sur la première machine, copiez les fichiers téléchargés dans le dossier d'installation créé par l'assistant d'installation à l'étape 2. Sur les autres machines du cluster, copiez l'intégralité du dossier d'installation de la première machine vers le même chemin de dossier sur chaque machine. Étape 3 : Copiez les fichiers d'installation sur toutes les machines
Étape 4 : Lancer l'installation	Créez le cluster et joignez toutes les machines À partir de la première machine, installez le reste de la suite. Étape 4 : Lancer l'installation
Étape 5 : Terminer l'installation	Étape 5 : Vous avez terminé l'installation avec succès et pouvez passer aux étapes post-installation. Vous pouvez désormais accéder au cluster et à la suite nouvellement créés, mettre à jour les certificats, redimensionner le PVC, etc. Étape 5 : Finalisation de l'installation

Important :

La version du noyau RHEL kernel-4.18.0-477.10.1.el8_8 est affectée par un problème qui interrompt l'installation ou la gestion du cluster Automation Suite. Assurez-vous qu'aucun des nœuds Automation Suite n'utilise cette version du noyau, que ce soit avant ou après l'installation. Vous pouvez mettre à jour la version du noyau en exécutant la commande suivante :

dnf install -y kernel kernel-tools kernel-tools-libs

Étape 1 : Téléchargement du package d'installation et obtention de l'ensemble des fichiers sur la première machine

Étape 1.1 : Téléchargement du package d'installation

Vous devez effectuer cette étape sur une machine disposant d'un accès Internet d'un accès à la machine dans l'environnement hors ligne où Automation Suite sera installée.

Remarque :

Cette machine peut être sous Linux ou Windows. Les commandes de ce guide sont destinées aux systèmes d'exploitation basés sur RHEL. Pour Windows ou d'autres systèmes d'exploitation, ajustez les commandes équivalentes spécifiques à ces environnements.

Le programme d'installation d'Automation Suite est un wrapper de plusieurs packages qui installe également certaines dépendances à l'aide du gestionnaire de packages Red Hat Package Manager (RPM). Il propose une expérience interactive pour vous aider à configurer des ressources externes telles que SQL, ainsi que d'autres options d'installation.

SUR LA MACHINE SÉPARÉE AVEC ACCÈS À INTERNET

Cette section explique comment obtenir les fichiers requis afin de démarrer le processus d'installation.

1. Connectez-vous à une machine avec accès à Internet et exécutez la commande suivante pour obtenir le fichier de l'assistant interactif :

   ssh <user>@<dns_of_vm>

2. Si vous avez utilisé une clé SSH, exécutez la commande suivante :

   ssh -i <path/to/Key.pem> <user>@<dns_of_vm>

3. Téléchargez les packages suivants :
   • installUiPathAS.sh – Obligatoire. Voir installUiPathAS.sh pour les instructions de téléchargement.
   • sf-installer.zip – Obligatoire ( Mandatory). Voir sf-installer.zip pour les instructions de téléchargement.
   • sf.tar.gz – Facultatif. Requis uniquement sur le nœud du serveur lors de l'utilisation du registre Docker interne. Voir sf.tar.gz pour les instructions de téléchargement.
   • sf-infra.tar.gz - Obligatoire. Voir sf-infra.tar.gz pour les instructions de téléchargement.
   • du-ondemand.tar.gz – Facultatif. Nécessaire uniquement pour Document Understanding. Voir du-ondemand.tar.gz pour les instructions de téléchargement.
     Remarque :

     Ne pas suivre cette étape facultative limite la fonctionnalité des services Document Understanding.

   • cv-ondemand.tar.gz – Facultatif. Nécessaire uniquement pour Computer Vision. Voir du-ondemand.tar.gz pour les instructions de téléchargement.
     Remarque :

     Ne pas suivre cette étape facultative empêche l'accès aux services Computer Vision.

   Assurez-vous de télécharger le package adapté à votre version d'Automation Suite et à votre système d'exploitation.

Étape 1.2 : Obtenir tous les fichiers téléchargés sur la première machine

Assurez-vous de suivre les étapes suivantes :

• Vérifiez que tous les fichiers ont été téléchargés sur la machine avec accès à Internet ;
• Créez le dossier cible sur la machine ;
• Copiez les fichiers de la machine en ligne vers la machine cible.

SUR TOUTES LES MACHINES DU CLUSTER

Créez les dossiers d'installation en exécutant la commande suivante :

sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 777 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp

Important : l'exécution de mkdir -p /opt/UiPathAutomationSuite/ n'est pas requise si vous utilisez le script configureUiPathDisks.sh .

SUR LA MACHINE SÉPARÉE AVEC ACCÈS À INTERNET

Copiez les fichiers sur le premier nœud en procédant comme suit :

1. From the machine with internet access, copy the files to the installation folder on the target machine, and the offline bundle(s) to the /uipath/tmp folder:

   scp ~/installUiPathAS.sh ~/sf-installer.zip ~/sf-infra.tar.gz <username>@<node dns>:/uipath/tmp
   scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/

2. (Facultatif) Pour utiliser Document Understanding, copiez le bundle suivant dans le dossier /uipath/tmp :

   scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/

   Avertissement : : Ne pas suivre cette étape facultative empêche l'accès aux services Document Understanding.
3. (Facultatif) Pour utiliser Computer Vision, copiez le bundle suivant dans le dossier /uipath/tmp :

   scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/

   Avertissement : Ne pas suivre cette étape facultative empêche l'accès aux services Computer Vision.

Étape 2 : Configuration de l'installation

Étape 2.1 : Configuration de base

SUR LA MACHINE PRINCIPALE DU CLUSTER

1. Ajoutez le dossier des prérequis au PATH (chemin) actuel.
   Le programme d'installation interactif nécessite jq, que les bundles Automation Suite hors ligne incluent déjà. Exécutez les commandes suivantes pour l'ajouter à PATH, et assurez-vous que vous êtes toujours en mode root

   mv /uipath/tmp/installUiPathAS.sh /uipath/tmp/sf-installer.zip /uipath/tmp/sf-infra.tar.gz  /opt/UiPathAutomationSuite
   cd /opt/UiPathAutomationSuite
   unzip ./sf-installer.zip -d .
   chmod +x ./bin/jq
   export PATH=${PATH}:/opt/UiPathAutomationSuite/bin

2. Accorder des autorisations au dossier d'installation.
   Il est nécessaire de donner les autorisations adéquates au dossier /opt/UiPathAutomationSuite où les scripts d'installation sont placés et seront exécutés. Le programme d'installation créera également des fichiers (output.json) après l'exécution de chaque étape. Pour fournir les autorisations requises, exécutez la commande suivante :

   chmod -R 755 /opt/UiPathAutomationSuite

3. Exécutez le programme d'installation interactif pour configurer les options d'installation.
   Si sf-installer.zip n'est pas présent dans /opt/UiPathAutomationSuite/, le programme d'installation essaie de le télécharger et échoue car il s'agit d'une installation hors ligne.

   L'assistant interactif vous guidera à travers les étapes de configuration et générera la configuration qui pourra ensuite être personnalisée et utilisée tout au long des étapes d'installation restantes.

4. Pour démarrer le programme d'installation interactif, exécutez le script suivant :
   Exécutez la commande suivante

   chmod +x ./installUiPathAS.sh
   ./installUiPathAS.sh

Exécution de l'assistant interactif en mode hors ligne multi-nœuds

1. Saisissez l'option pour le mode de production multi-nœuds compatible haute disponibilité.
   
2. Entrez l'option pour l'installation physiquement isolée :
   
3. Spécifiez l'URL du cluster (nom d'hôte DNS/URL de l'équilibreur de charge en mode de production multi-nœuds haute disponibilité) et les informations SQL Server comme indiqué ci-dessous :
   
4. La configuration sera générée avec un dossier comme indiqué dans l'image suivante.
   

Dès que vous générez le fichier de configuration et le dossier, vous pouvez quitter l'assistant et poursuivre les étapes restantes ci-dessous pour terminer l'installation.

Étape 2.2 : (Facultatif) Configuration avancée

Cette étape est facultative.

En exécutant l'installation à l'aide de la configuration par défaut, vous choisissez d'exécuter notre sélection de produits de base. Vous installerez notre plate-forme principale : Orchestrator, Insights, Test Manager, Action Center, Automation Ops, Automation Hub et Data Service.

Vous pouvez configurer le fichier pour des configurations plus avancées. Vous pouvez activer des produits supplémentaires, désactiver l'un des produits par défaut, configurer vos bases de données SQL et leurs chaînes de connexion et certificats respectifs. Pour le mode de production multi-nœuds compatible haute disponibilité, la haute disponibilité est activée par défaut, mais vous pouvez la désactiver si nécessaire.

Pour une configuration avancée, vous pouvez suivre les instructions suivantes : Expérience d'installation avancée.

Remarque : si vous quittez le programme d'installation interactif et effectuez une configuration avancée, vous devez réexécuter le programme d'installation interactif pour que l'installation soit terminée.

Étape 3 : copie des fichiers d'installation sur toutes les autres machines du cluster

À partir de la première machine du cluster, sur laquelle la configuration a été effectuée, copiez le programme d'installation, les certificats et cluster_config.json sur toutes les autres machines.

SUR LA PREMIÈRE MACHINE DU CLUSTER

1. Copiez le dossier /opt/UiPathAutomationSuite sur tous les autres nœuds en exécutant la commande suivante :

   scp -r /opt/UiPathAutomationSuite <username>@<node dns>:/opt

   Attention : Puisque vous êtes dans un environnement isolé, vous devrez peut-être utiliser l'adresse IP privée du nœud cible.
2. Ajoutez -i <cert.pem> si vous utilisez un certificat pour vous connecter. Si vous copiez le contenu de .pem dans un fichier local, le nouveau fichier devra disposer des autorisations correctes. Vous pouvez utiliser chmod 400 <cert.pem> pour les accorder.

L'étape ci-dessus garantit que la même configuration est répliquée sur toutes les machines avec tous les packages téléchargés pour le bundle d'installation.

Étape 4 : Lancer l'installation

Il existe deux types de machines : serveur et agent.

• Serveur (Server) - Machines sur lesquelles l'infrastructure Kubernetes (c'est-à-dire apiserver, etcd) s'exécute. Ces composants gèrent l'ensemble du cluster.
• Agent - version standard de la machine utilisée pour exécuter les charges de travail

Le mode de production multi-nœuds compatible haute disponibilité nécessite un minimum de 3 machines serveurs. L'installation de Task Mining nécessite l'ajout d'une machine supplémentaire qui sera utilisée comme agent.

Remarque :

• Pour une installation de production multi-nœuds compatible haute disponibilité, vous avez besoin d'un équilibreur de charge. Assurez-vous qu'il a été créé et que le trafic est réparti entre les nœuds. Le nom de domaine de l'équilibreur de charge doit être utilisé dans le fichier cluster_config.json.
• Vous devez avoir au moins un nœud de serveur et pour la haute disponibilité, vous avez besoin d'au moins trois nœuds de serveur. Un nombre impair de nœuds de serveur est requis.

Étape 4.1 : Accepter le contrat de licence

Avant de lancer l'installation, veillez à lire le contrat de licence (License Agreement).

Pour accepter le contrat de licence, choisissez l'une des méthodes suivantes :

• Option 1 (variable d'environnement) - Définissez la variable d'environnement LICENSE_AGREEMENT pour qu'elle accepte en exécutant la commande suivante : export LICENSE_AGREEMENT=accept
• Option 2 (paramètre en ligne) : Vous pouvez également ajouter --accept-license-agreement à chaque exécution de install-uipath.sh.

Étape 4.2 : Créer et joindre toutes les machines au cluster

1. Configurez la première machine.
   Exécutez les commandes suivantes sur le premier serveur :

   cd /opt/UiPathAutomationSuite
   ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement

2. Reliez le reste des serveurs au cluster.
   Exécutez les commandes suivantes sur le reste des nœuds de serveur dans l'ordre :

   cd /opt/UiPathAutomationSuite
   sudo chmod -R 755 /opt/UiPathAutomationSuite
   sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j server --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement

3. Reliez le reste des agents au cluster.
   Exécutez les commandes suivantes sur le reste des nœuds d'agent dans l'ordre :

   cd /opt/UiPathAutomationSuite
   sudo chmod -R 755 /opt/UiPathAutomationSuite
   sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j agent --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement

Étape 4.3 : Terminer l'installation de la suite

Fin de l'installation sur le premier nœud

Une fois tous les nœuds joints, basculez vers le premier serveur pour terminer l'installation d'Automation Suite :

1. Vérifiez si les nœuds ont été correctement ajoutés en exécutant la commande suivante :

   sudo su
   export KUBECONFIG=/etc/rancher/rke2/rke2.yaml PATH=$PATH:/var/lib/rancher/rke2/bin
   kubectl get nodes

2. Vous devriez voir plus d'un nœud dans la liste si le processus s'est correctement déroulé.

3. Terminez l'installation en exécutant la commande suivante :

   cd /opt/UiPathAutomationSuite
   ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f -s --offline-bundle /opt/UiPathAutomationSuite/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement

Avertissement :

C'est l'opération la plus longue. Attendez-vous à ce que cela prenne environ 2 heures.

Chargement des bundles facultatifs

• Pour charger les bundles Document Understanding facultatifs, exécutez les commandes suivantes :

  ./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"

• Pour charger le bundle Computer Vision facultatif, exécutez la commande suivante :

  ./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"

Étape 5 : Finalisation de l'installation

Remarque : Vous avez terminé l'installation avec succès et pouvez à présent passer aux étapes post-installation.

Mise à jour des certificats

Important :

Le processus d'installation génère des certificats auto-signés en votre nom. Toutefois, le modèle de déploiement Azure vous donne également la possibilité de fournir un certificat de serveur émis par une autorité de certification au moment de l'installation au lieu d'utiliser un certificat auto-signé généré automatiquement.

Ces certificats expireront sous 90 jours et vous devrez les remplacer par des certificats signés par une autorité de certification (CA) approuvée dès que l'installation sera terminée. Si vous ne mettez pas à jour les certificats, l'installation cessera d'être opérationnelle après 90 jours.

Pour obtenir des instructions, consultez la Gestion des certificats.

Accéder à Automation Suite

Pour accéder au cluster et à la suite nouvellement créés, voir Accéder à Automation Suite.

Redimensionner le PVC

Pour redimensionner le PVC, voir Redimensionner le PVC.

Si vous avez uniquement installé AI Center, nous vous recommandons de redimensionner le PVC sur 200 immédiatement après l'installation pour éviter les temps d'arrêt. Pour plus d'informations à ce sujet, consultez Redimensionner le PVC pour AI Center.

Ajout du rancher/pause : 3.5

Si vous avez installé AI CenterTM, vous devez importer et exporter l'image Rancher. Pour plus d'informations à ce sujet, consultez Adding rancher/pause:3.5 to offline registry.