Étape 13 : génération du fichier cluster_config.json

Génération du fichier cluster_config.json sur la première machine

Le fichier cluster_config.json définit les paramètres et préférences appliqués aux produits UiPath® déployés via Automation Suite. Vous pouvez soit créer le fichier cluster_config.json manuellement, soit utiliser le programme d’installation interactif, qui pose plusieurs questions obligatoires et génère le fichier pour vous. Vous pouvez toujours modifier le fichier généré pour mettre à jour la configuration.

Exécution du programme d'installation interactif pour générer le fichier cluster_config.json

Pour générer le fichier cluster_config.json, accédez au dossier du programme d'installation et exécutez la commande suivante :

cd /opt/UiPathAutomationSuite/<version>/installer

./installUiPathAS.sh

La commande susmentionnée démarre le flux interactif, qui vous pose une série de questions nécessaires à la configuration d'Automation Suite.

Pour générer le fichier de configuration, procédez comme suit :

1. Acceptez le contrat de licence pour commencer à configurer Automation Suite.

2. Dans le menu principal, sélectionnez votre mode de déploiement. Vos options sont les suivantes :

   • Déploiement à nœud unique : recommandé à des fins de démonstration et d’évaluation ;
   • Déploiement multi-nœuds : recommandé pour une utilisation en production.

   

3. Dans Configuration du déploiement (Deployment configuration), sélectionnez votre type d'environnement. Vos options sont les suivantes :

   • En ligne : nécessite un accès à Internet ;
   • Physiquement isolé : également appelé hors ligne ; ne nécessite pas d’accès à Internet.

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

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

   Pour plus de détails sur les options de sélection de produits, consultez la section Configuration matérielle et logicielle requise.

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

   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 . Essayer d'installer un produit sans ses dépendances générerait une erreur.
   De plus, certains produits Automation Suite nécessitent un nœud d'agent dédié. Avant de continuer, assurez-vous de répondre à la configuration matérielle requise.
   Si vous optez pour une configuration actif/passif ou actif/actif, vérifiez que les produits que vous activez sont pris en charge. Pour plus de détails, consulter Disaster Recovery – actif/passif et actif/actif.

6. Pour installer AI Center, vous devez effectuer les étapes supplémentaires suivantes :

   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 7.
      • Si AI Center nécessite une installation Orchestrator externe, passez à l'étape 6.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.
   7. Dans les installations en ligne, indiquez la clé API de comptage.
      Remarque :

      metering_api_key est la clé API de Document Understanding du compte cloud AI Center.

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

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

9. Indiquez si vous souhaitez apporter votre propre magasin d'objets pour les produits sélectionnés. Il est fortement recommandé d'utiliser un magasin d'objets externe. 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 :
     • 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 : 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 : 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.
   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.

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

11. Indiquez si vous souhaitez utiliser votre propre High Availability Add-on externe.

    • Si vous sélectionnez Non, vous optez pour la version de HAA par défaut dans le cluster.
    • Si vous sélectionnez Oui (configuration par défaut), vous optez pour le module HAA installé sur des machines externes et devez fournir les détails suivants sur votre module HAA externe : nom de domaine complet, mot de passe, port et configuration TLS.

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 nécessite un deuxième serveur SQL. Si vous installez Process Mining, assurez-vous de fournir l'URL du serveur SQL de l'entrepôt, le nom de la base de données, 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. Pour plus d'informations sur la configuration des bases de données SQL pour Process Mining, consultez Configuration spécifique à Process Mining.

    Important :

    Pour Process Mining sur Automation Suite 2023.10.9 ou version ultérieure, l'utilisation de PostgreSQL pour la base de données Airflow est l'option recommandée. Si vous choisissez d'utiliser une base de données PostgreSQL, vous devez ajouter manuellement la chaîne de connexion airflow.metadata_db_connection_str pour la base de données AutomationSuite_Airflow dans le cluster_config.json.
    Reportez-vous aux Exigences SQL pour Process Mining et la configuration spécifique à Process Mining pour de plus amples informations.

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

15. Fournissez les 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. Pour un déploiement Disaster Recovery - Actif/Passif, vous devez suivre les étapes suivantes :

    1. Installer et configurer le cluster principal. Pour plus de détails, voir Expérience d'installation avancée.
    2. Installer et configurer le cluster secondaire. Pour plus de détails, consulter Disaster Recovery - Installation du cluster secondaire.
    3. Reprenez l'installation en suivant les instructions de cette page.

Remarque :

À la fin du processus de configuration, le fichier cluster_config.json est généré à l'emplacement /opt/UiPathAutomationSuite/cluster_config.json . Notez que toutes nos instructions d'installation supposent que vous stockez le cluster_config.json dans ce dossier.

Copie du fichier cluster_config.json sur toutes les autres machines

Pour installer Automation Suite, le fichier cluster_config.json doit être disponible sur toutes les machines. Après avoir généré le fichier de configuration sur la première machine, vous devez le copier sur les autres machines au lieu de le générer de nouveau. La nouvelle génération du fichier de configuration peut causer des divergences qui peuvent entraîner l’échec de l’installation.

Pour copier le fichier de configuration de la première machine vers les autres machines, exécutez la commande suivante. Assurez-vous de remplacer les valeurs username et node_dns par les valeurs correspondant à la machine cible.

scp /opt/UiPathAutomationSuite/cluster_config.json <username>@<node_dns>:/opt/UiPathAutomationSuite

Si vous ne bénéficiez pas d'un accès direct pour copier les fichiers vers le dossier /opt/UiPathAutomationSuite, vous pouvez les transférer vers votre répertoire personnel, puis les déplacer vers l'emplacement souhaité.