Step 13: Generating cluster_config.json

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

The cluster_config.json file defines the parameters, settings, and preferences applied to the UiPath® products deployed via Automation Suite. You can either create cluster_config.json manually or use the interactive installer, which asks several mandatory questions and generates the file for you. You can always edit the generated file to update the 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 (Online) : nécessite un accès à Internet ;

   • Physiquement isolé (Air-gapped) : é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. 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

   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 les dépendances entre produits. 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, assurez-vous que les produits que vous activez sont pris en charge. Pour en savoir plus, consultez Récupération d'urgence (Disaster Recovery) - Active/Passive et Active/Active.

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

   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 et mot de passe.

11. Indiquez si vous souhaitez apporter votre propre module complémentaire haute disponibilité (HAA) externe.

    • If you select No, you opt for the default in-cluster HAA.

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

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 fichier 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é.