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

Vue d'ensemble (Overview)

Important :

You must meet the hardware and software prerequisites before proceeding with the installation. See Hardware and software requirements.

You can use a dedicated script to validate the installation prerequisites and infrastructure readiness. See Validating the prerequisites.

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

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

Étape	Description
Étape 1 : Téléchargez les packages d'installation	Vous devez effectuer cette étape à partir d'une machine Linux ou Windows avec accès à Internet et aux machines hors ligne sur lesquelles vous prévoyez de déployer Automation Suite. Pendant que le téléchargement des packages d'installation se termine, vous pouvez passer aux étapes suivantes. É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 le programme 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 que vous pouvez utiliser lors de l'installation. (Facultatif) Configurez les options d'installation avancées. Le programme d'installation interactif offre une expérience par défaut avec un nombre limité d'options de configuration. Pour personnaliser les produits installés, configurer des serveurs SQL distincts pour des produits spécifiques, et plus encore, modifiez le fichier de configuration. Étape 2.1 : configuration par défaut Étape 2.2 : (Facultatif) Configuration avancée
Step 3: Copy the installation files on all the machines	Sur la première machine, copiez les fichiers téléchargés dans le dossier d'installation créé par le programme d'installation interactif à 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
Step 4: Run the installation	Créez le cluster et joignez toutes les machines. Installez le reste de la suite à partir de la première machine. Étape 4 : Lancer l'installation
Step 5: Complete the installation	Step 5: You have completed the installation successfully and can move to post-installation steps. 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 – Mandatory. See installUiPathAS.sh for download instructions.

   • as-installer.zip – Mandatory. See as-installer.zip for download instructions.

   • as.tar.gz – Optional. Required only on server node when using internal Docker registry. See as.tar.gz for download instructions.

   • as-infra.tar.gz - Mandatory. See as-infra.tar.gz for download instructions.

   • du-ondemand.tar.gz – Optional. Needed only for Document Understanding. See du-ondemand.tar.gz for download instructions.

     Remarque :

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

   • cv-ondemand.tar.gz – Optional. Needed only for Computer Vision. See cv-ondemand.tar.gz for download instructions.

     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 nécessaire 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 ~/as-installer.zip ~/as-infra.tar.gz <username>@<node dns>:/uipath/tmp
   scp ~/as.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 :

   Not following this optional step prevents access to the Document Understanding services.

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 par défaut

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/as-installer.zip /uipath/tmp/as-infra.tar.gz  /opt/UiPathAutomationSuite
   cd /opt/UiPathAutomationSuite
   unzip ./as-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.

   Important :

   Le programme d'installation interactif essaye de télécharger as-installer.zip et échoue dans les environnements hors ligne. Pour contourner l'étape de téléchargement et éviter tout problème d'installation, exécutez la commande suivante :

   export BUNDLE_FILE="/opt/UiPathAutomationSuite/as-installer.zip"
   

   Pour démarrer le programme d'installation interactif, exécutez le script suivant :

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

   Le programme d'installation interactif vous guide tout au long des étapes de configuration et génère la configuration que vous pourrez ensuite personnaliser en suivant les étapes d'installation restantes.

Exécution du programme d'installation interactif en mode hors ligne multi-nœuds

Exécutez le programme d'installation interactif pour configurer les options d'installation. L'outil rassemble les entrées des options d'installation les plus courantes et génère un fichier de configuration. La haute disponibilité est activée par défaut, mais vous pouvez la désactiver à l'aide de la configuration avancée.

Important :

Lors de l'exécution d'une installation interactive d'Automation Suite 2023.4.0, le message vous demandant d'exécuter la commande suivante sur les nœuds secondaires contient un jeton vide. Pour poursuivre l'installation, vous devez générer un nouveau jeton en exécutant kubectl create token default, puis exécuter uniquement la commande sur les nœuds secondaires.

Pour installer Automation Suite, procédez comme suit :

1. Démarrez le programme d'installation interactif.

2. Acceptez le contrat de licence pour poursuivre l'installation.

3. In Main Menu, select your deployment mode. Choose Multi-node deployment (recommended for production use) and confirm your selection.

   

4. In Deployment configuration, select your environment type. Choose Air-gapped.

5. Choisissez votre sélection de produits. Vos options sont les suivantes :

   • Complet (Tous les produits)
   • Sélectionner des produits

   For details on the product selection options, see Hardware and software requirements.

6. If you chose Select products in the previous step, indicate the products you want to install. Your options are:

   • Action Center
   • AI Center
   • Apps
   • Automation Hub
   • Automation Ops
   • Robots Automation Suite
   • Data Service
   • Document Understanding
   • Insights
   • Orchestrator
   • Process Mining
   • Task Mining
   • Test Manager
   Remarque :

   Some Automation Suite products have additional dependencies on each other. When selecting the products you want to install, make sure you consider Cross-products dependencies. Trying to install a product without its dependencies would result in an error.

   In addition to that, some Automation Suite products require a dedicated agent node. Before continuing, make sure you meet the hardware requirements.

7. Pour installer AI Center , vous devez suivre les étapes supplémentaires :

   Remarque :

   In offline installations, you do not need to specify the metering API key. To complete the AI Center installation, follow the step from the Completing AI Center installation section.

   1. Indiquez si AI Center nécessite une installation Orchestrator externe.

      • Si AI Center ne nécessite pas d'installation Orchestrator externe, passez à l'étape 8.
      • Si AI Center nécessite un Orchestrator externe, passez à l'Étape 7.b.

   2. Copy the Orchestrator certificate to the virtual machine. For more information on this, check the Copy the Orchestrator certificate page.

   3. Spécifiez l'URL Orchestrator pour AI Center. Exemple : https://orchestrator.example.com.

   4. Spécifiez l'URL Identity pour AI Center. Exemple : https://orchestrator.example.com/identity.

   5. Indiquez le chemin d'accès au fichier de certificat Orchestrator. Exemple : /opt/UiPathAutomationSuite/UiPath_Installer/orch.cer.

   6. Spécifiez le chemin d'accès au fichier de certificat Identity. Exemple : /opt/UiPathAutomationSuite/UiPath_Installer/identity.cer.

8. Confirmez votre sélection de produits pour déterminer la configuration matérielle et logicielle minimale requise.

9. Saisissez le nom de domaine complet d'Automation Suite.

10. Specify whether you would like to bring your own object store for the selected products. If you select No, you opt for the default object store. If you select Yes, choose one of the following options:

    • Compte de stockage Azure : indiquez si vous souhaitez utiliser une gestion basée sur l'identité avec votre compte de stockage Azure, fournissez les détails suivants correspondant à votre choix, puis spécifiez si vous souhaitez que les conteneurs soient automatiquement enregistrés pour tous les produits sélectionnés :
      • If Yes, provide the Azure storage account name and endpoint suffix, and your client ID;
      • Si Non , indiquez le nom du compte de stockage Azure et le suffixe du point de terminaison, ainsi que votre clé de compte Azure ;
    • AWS S3 – Provide the prefix and suffix for the bucket names, the AWS region where buckets are hosted, the access key and the secret key for the S3 account, and specify if you want the buckets to be automatically provisioned for all the selected products.
    • Other S3 Compatible storage – Specify the prefix and suffix for the bucket names, the S3 server FQDN, the S3 port, the access key and the secret key for the S3 account, and specify if you want the buckets to be automatically provisioned for all the selected products.
    Remarque :

    De nombreux magasins d'objets S3 nécessitent que CORS soit défini sur l'ensemble du trafic provenant du cluster Automation Suite. Vous devez configurer la stratégie CORS au niveau du magasin d'objets pour autoriser le nom de domaine complet du cluster.

11. Indiquez si vous souhaitez apporter votre propre registre Docker externe compatible OCI.

    • Si vous sélectionnez Non (No), vous optez pour le registre Docker interne par défaut.
    • Si vous sélectionnez Oui (Yes), vous devez fournir les détails suivants sur le registre que vous souhaitez utiliser : URL de registre avec port, nom d'utilisateur, mot de passe et clé secrète d'extraction.

12. Spécifiez si vous souhaitez utiliser Kerberos Authentication pour les connexions SQL.

13. Entrez le nom de domaine complet SQL Server. Suivez l’invite pour saisir le port de connexion, le nom d’utilisateur et le mot de passe.

    Remarque :

    Process Mining requires a second SQL Server. If you install Process Mining, make sure to provide the warehouse SQL Server URL, connection prompt, username, and password.

    For details on the hardware requirements the second SQL Server must meet, see SQL requirements for Process Mining.

14. Indiquez si vous souhaitez que le programme d'installation crée automatiquement les bases de données nécessaires.

15. Fournissez des certificats CA pour tout logiciel de serveur externe nécessitant une communication TLS sécurisée, sinon l'installation échouera. Si vous n'avez pas activé la communication TLS, vous pouvez configurer les certificats après l'installation.

    Remarque :

    Le programme d'installation accepte uniquement les certificats DER encodés en Base64 au format PEM. Si les serveurs externes ont des certificats CA différents, vous pouvez concaténer tous les certificats publics dans un seul fichier.

16. Après avoir défini les paramètres de configuration, le programme d'installation génère automatiquement le fichier de configuration. Vous pouvez modifier les paramètres de configuration directement dans le terminal.

    Remarque :

    Vous pouvez maintenant modifier directement le fichier cluster_config.json pour les paramètres de configuration avancés dans le dossier UiPathAutomationSuite.

    Après avoir modifié le fichier de configuration, vous devez réexécuter le programme d'installation interactif pour terminer l'installation, ou la terminer manuellement.

    Pour un déploiement Disaster Recovery - Actif/Passif, vous devez suivre les étapes suivantes :

    1. Install and configure the primary cluster. For details, see Advanced installation experience.
    2. Install and configure the secondary cluster. For details, see Disaster recovery - Installing the secondary cluster.
    3. Reprenez l'installation en suivant les instructions de cette page.

Remarque :

À la fin du processus d'installation, vous recevez un résumé du déploiement qui vous donne accès au portail d'administration du cluster, au portail hôte, à l'interface d'administration de l'organisation, à Rancher, à ArgoCD, et bien plus encore.

Étape 2.2 : (Facultatif) Configuration avancée

Cette étape est facultative.

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.

For advanced configuration, you can follow the following instructions: Advanced installation experience.

Remarque :

If you exit the interactive installer and perform advanced configuration, you need to re-run the interactive installer to complete the process.

É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
   

   Important :

   Since you are in an air-gapped environment, you might need to use the private IP of the target node.

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

Before running the installation, make sure to read the License Agreement.

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

• Option 1 (Environment Variable) - Set the LICENSE_AGREEMENT environment variable to accept by executing the following command: 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 ./as-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 ./as-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 ./as-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement
   

Step 4.3: Finishing installing the 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 /uipath/tmp/as.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

Remarque :

Cette étape n'est requise que si vous n'avez pas opté pour le registre Docker externe.

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

Completing an AI Center installation

Si AI Center nécessite une installation Orchestrator externe, exécutez la commande suivante pour terminer l'installation :

./configureUiPathAS.sh aicenter configure --installation-token <identity token>

For more information on how to configure Orchestrator for AI Center, check the Configuring Orchestrator page from the AI Center guide.

É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

Le processus d'installation génère des certificats auto-signés en votre nom. Ces certificats sont conformes à la norme FIPS 140-2. 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.

Si vous avez installé Automation Suite sur un hôte compatible FIPS 140-2 et que vous souhaitez mettre à jour les certificats, assurez-vous qu'ils sont compatibles avec FIPS 140-2.

For instructions, see Managing certificates.

Accéder à Automation Suite

To access the newly created cluster and suite, see Accessing Automation Suite.