automation-suite

2022.10

false

Important :

Veuillez noter que ce contenu a été localisé en partie à l’aide de la traduction automatique.

Guide d'installation d'Automation Suite

Last updated 20 sept. 2024

Installation d'évaluation à nœud unique hors ligne

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 .

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

Étape	Description
Étape 1 : Téléchargez les packages d'installation	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 machine
Étape 2 : Configuration de l'installation	L'assistant d'installation interactif rassemble des entrées pour les options d'installation les plus courantes et génère une configuration que vous pouvez utiliser lors de l'installation. Étape 2.1 : Configuration de l'installation : configuration de base 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.2 : (Facultatif) Configuration de l'installation : configuration avancée (facultatif)
Étape 3 : Lancer l'installation	Exécutez l'installation. Une fois l'installation terminée, vous pouvez commencer à utiliser le cluster. Étape 3 : Lancer l'installation
Étape 4 : Terminer l'installation	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 4 : 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-libsdnf install -y kernel kernel-tools kernel-tools-libs

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

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

Vous devez effectuer cette étape sur une machine Linux ou Windows avec accès à Internet et à la machine de l'environnement hors ligne sur lequel vous prévoyez d'installer Automation Suite.

Les commandes sur cette page 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.

Important : Vous devez installer les packages RPM requis avant de lancer le programme d'installation d'Automation Suite. Pour plus de détails, consultez la section Exigences du package RPM.

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.

Connectez-vous à une machine avec un accès à Internet et exécutez la commande suivante pour obtenir le fichier de l'assistant interactif :
```
ssh <user>@<dns_of_vm>ssh <user>@<dns_of_vm>
```

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

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

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 – 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 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.

Étape 1.2 : Obtenir tous les fichiers téléchargés sur la 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 LA MACHINE PRINCIPALE DU CLUSTER

Créez le dossier d'installation en exécutant la commande suivante :

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

Remarque : 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 l'un des nœuds :

À 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 <username>@<node dns>:/uipath/tmp 
scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/scp ~/installUiPathAS.sh ~/sf-installer.zip <username>@<node dns>:/uipath/tmp 
scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/

Si vous prévoyez de joindre des nœuds supplémentaires, tels que Task Mining ou GPU, exécutez plutôt la commande suivante :

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

(Facultatif) Pour utiliser Document Understanding, copiez le bundle suivant dans le dossier /uipath/tmp.
```
scp ~/du-ondemand.tar.gz <username>@<node dns>:/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.
(Facultatif) Pour utiliser Computer Vision, copiez le bundle suivant dans le dossier /uipath/tmp.
```
scp ~/cv-ondemand.tar.gz <username>@<node dns>:/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

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 /opt/UiPathAutomationSuite
cd /opt/UiPathAutomationSuite
unzip ./sf-installer.zip -d .
chmod +x ./bin/jq
export PATH=${PATH}:/opt/UiPathAutomationSuite/binmv /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

Si vous prévoyez de joindre des nœuds supplémentaires, tels que Task Mining ou GPU, exécutez plutôt la commande suivante :

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/binmv /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

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/UiPathAutomationSuitechmod -R 755 /opt/UiPathAutomationSuite
```
Exécutez le programme d'installation interactif pour configurer les options d'installation.
Important :
Le programme d'installation interactif essaye de télécharger sf-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/sf-installer.zip"export BUNDLE_FILE="/opt/UiPathAutomationSuite/sf-installer.zip"
Pour démarrer le programme d'installation interactif, exécutez la commande suivante :
```
chmod +x ./installUiPathAS.sh 
./installUiPathAS.shchmod +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 de l'assistant interactif en mode hors ligne à nœud unique

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. Le module HAA n'est pas pris en charge en mode d'évaluation à nœud unique.

Pour installer Automation Suite, procédez comme suit :

Démarrez le programme d'installation interactif.
Acceptez le contrat de licence pour poursuivre l'installation.
Dans le menu principal, sélectionnez votre mode de déploiement. Choisissez Déploiement à nœud unique (recommandé à des fins de démonstration/évaluation) et confirmez votre sélection.
Dans Configuration du déploiement (Deployment configuration), sélectionnez votre type d'environnement. Choisissez Physiquement isolé (Air-gaped).
Choisissez votre sélection de produits. Vos options sont les suivantes :
- Complet (Tous les produits)
- Sélectionner des produits
Remarque :
Pour plus de détails sur les options de sélection de produits, consultez la section Configuration matérielle et logicielle requise.
Si vous avez choisi Sélectionner les produits (Select products) à l'étape précédente, indiquez les produits que vous souhaitez installer. Vos options sont les suivantes :
- Action Center
- AI Center
- Apps
- Automation Hub
- Automation Ops
- Robots Automation Suite
- Data Service
- Document Understanding
- Insights
- Orchestrator
- Process Mining
- Task Mining
- Test Manager
Important :
Certains produits Automation Suite ont des dépendances supplémentaires les uns par rapport aux autres. Lors de la sélection des produits que vous souhaitez installer, veillez à prendre en compte les dépendances entre produits. Essayer d'installer un produit sans ses dépendances générerait une erreur.

Certains produits Automation Suite, tels que Task Mining et Document Understanding, nécessitent un nœud d'agent dédié. Avant de continuer, assurez-vous de répondre à la configuration matérielle requise.
Pour installer AI Center, vous devez suivre des étapes supplémentaires :
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. Copiez le certificat Orchestrator vers la machine virtuelle. Pour plus d'informations à ce sujet, consultez la page Copier le certificat Orchestrator.
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.
  
  Important : dans les installations hors ligne, vous n'avez pas besoin de spécifier la clé API de comptage. Pour terminer l'installation d'AI Center, suivez l'étape de la section Finalisation de l'installation.
Confirmez votre sélection de produits pour déterminer la configuration matérielle et logicielle minimale requise.
Saisissez le nom de domaine complet d'Automation Suite.
Indiquez si vous souhaitez apporter votre propre magasin d'objets pour les produits sélectionnés. Si vous sélectionnez Non (No), vous optez pour le magasin par défaut. Si vous sélectionnez Oui (Yes), choisissez l'une des options suivantes :
- 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 :
  - Si Oui, indiquez le nom du compte de stockage Azure et le suffixe du point de terminaison, ainsi que votre ID client ;
  - Si Non (No), indiquez le nom du compte de stockage Azure et le suffixe du point de terminaison, ainsi que votre clé de compte Azure.
- AWS S3 : Fournissez le préfixe et le suffixe des noms de compartiments, la région AWS où les compartiments sont hébergés, la clé d'accès et la clé secrète du compte S3, et spécifiez si vous souhaitez que les compartiments soient automatiquement enregistrés pour tous les produits sélectionnés.
- Autre stockage compatible S3 (Other S3 Compatible storage) : spécifiez le préfixe et le suffixe des noms de compartiment, le nom de domaine complet du serveur S3, le port S3, la clé d'accès et la clé secrète du compte S3, et spécifiez si vous souhaitez que les compartiments soient automatiquement enregistrés pour tous les produits sélectionnés.
  Important : 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.
Spécifiez si vous souhaitez utiliser Kerberos Authentication pour les connexions SQL.
Entrez l'URL du serveur SQL. Suivez l'invite pour saisir le port de connexion, le nom d'utilisateur et le mot de passe.

Important : si vous installez Process Mining, un deuxième serveur SQL est recommandé. Assurez-vous de fournir l'URL du serveur SQL de l'entrepôt, l'invite de connexion, le nom d'utilisateur et le mot de passe.
Pour plus de détails sur la configuration matérielle requise que le deuxième serveur SQL doit respecter, consultez la section Exigences SQL pour Process Mining.
Indiquez si vous souhaitez que le programme d'installation crée automatiquement les bases de données nécessaires.
Fournissez des certificats CA pour tout logiciel 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.

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

Important : après avoir généré le fichier de configuration et le dossier, vous pouvez quitter le programme d'installation et poursuivre les étapes restantes ci-dessous pour terminer l'installation.

À 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 trouver le fichier cluster_config.json dans le dossier UiPathAutomationSuite. Vous pouvez utiliser ce fichier pour 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. Vous pouvez également activer les paramètres de proxy si vous utilisez un proxy pour la connexion Internet.

Pour une installation en mode d'évaluation à nœud unique, notez que vous ne pouvez pas activer la haute disponibilité.

Pour une configuration avancée, consultez Expérience d'installation avancée.

Remarque :

Vous pouvez relancer l'assistant une fois l'installation complétée.

Étape 3 : Lancer l'installation

Assurez-vous d'avoir copié les fichiers téléchargés sur la machine principale hors ligne sur laquelle vous avez effectué la configuration, dans le dossier d'installation créé par l'assistant d'installation.

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.

Exécution du programme d'installation

Exécutez la commande d'installation pour exécuter le bundle hors ligne (durée estimée : 2h30min - 3h30min) :

./install-uipath.sh -i ./cluster_config.json -o ./output.json -a --offline-bundle /uipath/tmp/sf.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement./install-uipath.sh -i ./cluster_config.json -o ./output.json -a --offline-bundle /uipath/tmp/sf.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement

Pour obtenir de l'aide, vous pouvez exécuter ./install-uipath.sh -h --accept-license-agreement.

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"./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"./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"

Ce document se concentre sur l'argument de commande -a car il répond au besoin d'installer tous les composants requis.

Installation de Task Mining

Si vous installez Task Mining en mode d'évaluation à nœud unique, vous devez exécuter un ensemble d'étapes supplémentaires. Suivez le guide d'installation de Task Mining pour suivre les étapes de Task Mining.

Étape 4 : 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

Attention :

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.

Finalisation de l'installation d'AI Center

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>./configureUiPathAS.sh aicenter configure --installation-token <identity token>

Pour plus d'informations sur la configuration d'Orchestrator pour AI Center, consultez la page Configuration d'Orchestrator du guide AI Center.