Procédure

Étape 1 : Télécharger le script d'installation sur la première machine

1.1 Téléchargez le package d'installation.

This step needs to be run on a machine with internet access and access to the machines in the air-gapped environment where UiPath AI Center will be installed.

Remarque :

Cette machine peut être sous Linux ou Windows. Les étapes prévues devant être exécutées sur cette machine. Tout au long de ce document, vous trouverez des exemples destinés aux systèmes d'exploitation basés sur RHEL. Pour Windows ou d'autres versions de systèmes d'exploitation, ajustez les étapes équivalentes spécifiques à ces environnements.

Follow the steps below on the separate machine with internet access to get the required files to start the installation process:

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 installUiPath.as for download instructions.

   • sf-installer.zip - Mandatory. See sf-installer.zip for download instructions.

   • sf.tar.gz - Mandatory. See sf.tar.gz for download instructions.

   • sf-infra.tar.gz - Optional. Only needd if you want to join additional nodes, including Task Mining and GPU. See sf-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'AI Center et à votre système d'exploitation.

1.2 Obtenez 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 ayant accès à Internet.
• Créez le dossier cible sur la machine.
• Copiez les fichiers de la machine en ligne vers la machine cible.

Create the installation folder on the main machine of the cluster by running the following command:

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

On the separate machine with internet access, copy the files to the first node:

• À partir de la machine avec accès à Internet, copiez les fichiers dans le dossier d'installation sur la machine cible et le(s) bundle(s) hors ligne dans le dossier /uipath/tmp.

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

• (Facultatif) Pour utiliser Document Understanding, copiez les bundles suivants dans le dossier /uipath/tmp.

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

  Remarque :

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

• (Facultatif) Pour utiliser Computer Vision, copiez le bundle suivant dans le dossier /uipath/tmp.

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

  Remarque :

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

Étape 2 : Copiez le certificat Orchestrator sur la machine virtuelle

Remarque :

In case of chain certificates, check the Chain certificates section on how to correctly provide certificates.

Téléchargez et enregistrez le certificat Orchestrator sur votre machine locale. Vous pouvez le faire en utilisant un navigateur ou vous pouvez demander à votre service informatique de fournir le certificat. Les certificats doivent être au format base64 et .cer. Copiez le certificat sur la machine virtuelle à l'aide de la commande ci-dessous.

Assurez-vous que /opt/UiPathAutomationSuite a la bonne autorisation pour que les fichiers soient copiés via scp, ou copiez le fichier dans votre répertoire personnel, puis déplacez-le vers /opt/UiPathAutomationSuite.

scp /path/to/orch.cer <username>@<node dns>:/opt/UiPathAutomationSuite

Si Identity Server est différent d'Orchestrator, répétez également les étapes pour identityserver.cer.

Certificats de chaîne

Lorsque vous utilisez un certificat émis par un domaine, assurez-vous d'exporter le certificat racine comme suit :

1. Ouvrez le certificat, accédez à l'onglet Chemin de certification (Certification Path) et sélectionnez le premier certificat. Cliquez sur Afficher le certificat (View certificate).

   

2. Une fois le certificat racine affiché, allez dans l'onglet Détails (Details) et cliquez sur Copier dans le fichier (Copy to file).

   

3. Assurez-vous de sélectionner le format de fichier base64 cer.

4. Enregistrez-le sous le nom de votre choix, puis envoyez-le vers la machine AI Center.

Le fichier résultant doit être similaire à l'exemple ci-dessous :

-----BEGIN CERTIFICATE-----
certificate
base64
encoded
-----END CERTIFICATE-----

Étape 3 : Configuration de l'installation

Configuration de base

The following prerequisites are applicable for the main machine of the cluster.

1. Ajoutez les prérequis suivants au PATH actuel :

   Le programme d'installation interactif nécessite jq, que nos bundles hors ligne incluent déjà. Exécutez les commandes suivantes pour l'ajouter à PATH : (assurez-vous que vous êtes toujours en mode root)

   mv /uipath/tmp/installUiPathAS.sh /uipath/tmp/sf-installer.zip /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 vont être exécutés. Le programme d'installation créera également des fichiers (output.json) après l'exécution de chaque étape.

   Exécutez la commande suivante pour fournir les autorisations :

   chmod -R 755 /opt/UiPathAutomationSuite
   

3. Exécutez l'assistant d'installation interactif pour configurer les options d'installation.

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

4. Exécutez le script pour démarrer l'assistant interactif en exécutant la commande suivante :

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

5. Suivez les étapes de l'assistant

3.1. Utilisez l'assistant interactif pour créer le fichier de configuration de base.

Remarque :

Make sure to not start the install from the script and exit it when config file is generated, it will try to install full Automation suite otherwise. This script is primarily used for Automation Suite and the displayed information (products, requirements) is relative to Automation Suite. The config file will be adapted to our needs in the next steps of the procedure.

Au démarrage de l'assistant d'installation, le menu principal s'affiche. Dans ce menu, vous devez choisir le mode de déploiement souhaité : nœud unique (single-node) ou multi-nœuds (multi-node). Vous êtes invité à fournir des détails sur chaque mode une fois votre choix fait. Après cela, vous avez la possibilité de continuer avec le choix actuel ou de revenir au menu principal.

Suivez les étapes de configuration du déploiement :

1. Accept the license agreement.

2. Sélectionnez le mode de déploiement : sélectionnez l'option Déploiement multi-nœuds (Multi-node deployment).

   

3. Sélectionnez continuer (continue).

4. Sélectionnez l'installation physiquement isolée.

5. Sélectionnez Installation complète (Terminer l'installation).

6. Entrez le nom d'hôte DNS.

7. Spécifiez si vous souhaitez utiliser Kerberos Auth pour les connexions SQL.

8. Entrez l'URL du serveur SQL. Suivez l'invite pour saisir le port de connexion, le nom d'utilisateur et le mot de passe.

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

   

Le fichier de configuration du cluster sera généré avec un dossier comme illustré dans l'image suivante.

Remarque :

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. Vous pouvez ignorer la liste des produits car nous la mettrons à jour dans les étapes suivantes.

Une première version du fichier cluster_config.json est maintenant générée. Nous mettrons à jour ce fichier dans le but de l'installation d'AI Center.

3.2. Ajoutez une configuration spécifique à AI Center.

Ouvrez le fichier avec votre éditeur (exemple : vi) :

vi /opt/UiPathAutomationSuite/cluster_config.json

Remplacez le bloc suivant :

"aicenter": {
  "enabled": "false"
},

Remarque :

Document Understanding is enabled by default if AI Center is enabled.

Avec les informations suivantes (en remplaçant les informations entre <> par vos valeurs) :

"aicenter": {
  "enabled": "true",
  "orchestrator_url":"<https://orchestrator-url.com>",
  "identity_server_url": "<https://orchestrator-url.com/identity>",
  "orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
  "identity_cert_file_path":  "</opt/UiPathAutomationSuite/orch.cer or custom path>",
  "identity_access_token": "<placeholder will be replaced later>"
},

3.3. (Facultatif) Configuration avancée

Vous pouvez trouver le fichier cluster_config.json dans le dossier UiPathAutomationSuite. Vous pouvez utiliser ce fichier pour configurer vos bases de données SQL et leurs chaînes de connexion et certificats respectifs. Vous pouvez également activer les paramètres de proxy si vous utilisez un proxy pour la connexion Internet.

For advanced configuration, see Using the configuration file.

Étape 4 : Copier les fichiers d'installation sur toutes les autres machines du cluster

From the first machine in the cluster, where the configuration was performed, copy the entire install folder to all other machines:

1. Copiez le dossier ~/UiPathAutomationSuite sur tous les autres nœuds en exécutant :

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

   Remarque :

   Since we 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.

Remarque :

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 5 : Lancer l'installation

1. Exécutez le programme d'installation de l'infrastructure sur tous les nœuds

   1. Configurez la machine principale en exécutant les commandes suivantes sur le serveur principal :

      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 --install-standalone-aicenter
      

   2. Joignez le reste des agents au cluster en exécutant les commandes suivantes sur le reste des nœuds d'agent :

      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 /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicenter
      

   3. Joignez le reste des agents au cluster en exécutant les commandes suivantes sur le reste des nœuds d'agent :

      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 /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicenter
      

2. Exécuter le programme d'installation de la structure sur le nœud principal

   cd /opt/UiPathAutomationSuite
   export TMPDIR="/uipath/lib/containers/tmp"
   mkdir -p "/uipath/lib/containers/tmp"
   ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f --offline-bundle /uipath/tmp/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement --install-standalone-aicenter
   

3. Run the software installer on primary node First you need to connect to identity server and retrieve an installation token. Then copy this token and paste it in placeholder we had in step 3.2. (in the cluster_config.json file). Once the token is there, you can run the AI Center install.

   ./install-uipath.sh -i cluster_config.json -o output.json --install-type offline --accept-license-agreement --install-standalone-aicenter -s
   

4. Chargez les bundles de commandes Document Understanding facultatifs. Pour charger les bundles facultatifs, exécutez la commande suivante. Assurez-vous d'utiliser le nom du bundle que vous devez charger.

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

5. Chargez le bundle Computer Vision facultatif. 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"