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.

Cette étape doit être exécutée sur une machine disposant d'un accès Internet et d'un accès aux machines dans l'environnement isolé où UiPath AI Center sera installé.

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.

Suivez les étapes ci-dessous sur la machine distincte avec accès Internet pour obtenir les fichiers requis pour 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. Voir sf-installer.zip pour les instructions de téléchargement.
   • sf.tar.gz - Obligatoire. Voir sf.tar.gz pour les instructions de téléchargement.
   • sf-infra.tar.gz : Facultatif. Uniquement nécessaire si vous souhaitez joindre des nœuds supplémentaires, y compris Task Mining et le GPU. 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 cv-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.
4. Accédez à la première machine cible pour l'installation
   1. Exécutez la commande suivante :

      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>

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.

Créez le dossier d'installation sur la machine principale du cluster en exécutant la commande suivante :

sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 755 /opt/UiPathAutomationSuite

Sur la machine séparée avec accès Internet, copiez les fichiers sur le premier nœud :

• À 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 : Ne pas suivre cette étape facultative empêche l'accès aux services Document Understanding.
• (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 : en cas de certificats de chaîne, consultez la section Certificats de chaîne pour savoir comment fournir correctement les certificats.

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

Prérequis

Les conditions préalables suivantes s'appliquent à la machine principale du 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 : assurez-vous de ne pas démarrer l'installation à partir du script et de le quitter lorsque le fichier de configuration est généré ; sinon il essaiera d'installer l'intégralité d'Automation Suite. Ce script est principalement utilisé pour Automation Suite et les informations affichées (produits, exigences) sont relatives à Automation Suite. Le fichier de configuration sera adapté à nos besoins dans les prochaines étapes de la procédure.

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. Acceptez le contrat de licence.
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 est activé par défaut si AI Center est activé.

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

"aicenter": {
  "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.

Pour une configuration avancée, consultez Utilisation du fichier de configuration.

Étape 4 : Copier les 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 l'intégralité du dossier d'installation sur toutes les autres machines.

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

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

   Remarque : 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.

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 :

      mv /uipath/tmp/UiPathAutomationSuite /opt
      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 :

      mv /uipath/tmp/UiPathAutomationSuite /opt
      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. Vous devez d'abord vous connecter à Identity Server et récupérer un jeton d'installation. Copiez ensuite ce jeton et collez-le dans l'espace réservé mentionné à l'étape 3.2. (dans le fichier cluster_config.json). Une fois le jeton disponible, vous pouvez exécuter l'installation d'AI Center.

   ./install-uipath.sh -i cluster_config.json -o output.json --offline-bundle /uipath/tmp/sf.tar.gz --accept-license-agreement --install-standalone-aicenter --offline-tmp-folder /uipath/tmp -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.

   ./install-uipath.sh -i ./cluster_config.json -o ./output.json --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" --accept-license-agreement

5. Chargez le bundle Computer Vision facultatif. Pour charger le bundle Computer Vision facultatif, exécutez la commande suivante :

   ./install-uipath.sh -i ./cluster_config.json -o ./output.json --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" --accept-license-agreement