Validation des prérequis dans une configuration d'évaluation à nœud unique

Vue d'ensemble (Overview)

Avant d'installer Automation Suite, il est recommandé de valider les conditions préalables à l'installation et la préparation de l'infrastructure. Vous pouvez utiliser le script validateUiPathASReadiness.sh pour évaluer votre environnement et générer un résumé avant d'effectuer l'installation.

Validation	Description
Prérequis matériels	Valide que chaque machine du cluster répond à la configuration matérielle requise. Le contrôle prend en compte les aspects suivants : serveur, agent ou nœud rejeté ; système en ligne ou hors ligne ; profil d'évaluation à nœud unique ou profil de production multi-nœuds compatible haute disponibilité.
Partitionnement et configuration du disque	Vérifie que vous avez correctement partitionné et configuré le disque. La vérification prend en compte les aspects suivants : nœud de serveur ou d'agent ; système en ligne ou hors ligne ;
Connectivité SQL Server	Valide la connectivité au serveur SQL et à la base de données configurés. Le contrôle prend en compte les aspects suivants : connectivité avec l'hôte du serveur SQL (point de terminaison) au niveau d'un point de terminaison donné ; connectivité à la base de données principale si create_db est défini sur true ; autorisations de création de base de données (dbcreator) si create_db est défini sur true ; autorisations de création de schéma (db_ddladmin), de lecture (db_datareader) et d'écriture (db_datawriter) ; connectivité à la base de données lorsque l'élément create_db est défini sur false ; exigences particulières pour chaque service. Par exemple, pour Insights, le script vérifie l'index columnstore, la prise en charge des fichiers json et si le niveau de compatibilité SQL Server est >= 130 ; connectivité à la base de données et à SQL Server avec authentification intégrée.
Certificat de serveur	Vérifie que le certificat de serveur que vous avez fourni est valide. Le contrôle prend en compte les aspects suivants : le format du fichier de certificat est .pem, autrement dit, un certificat DER encodé en Base64 ; la longueur de la clé privée est d'au moins 2 048 ; Utilisation étendue de la clé : authentification du serveur Web TLS ; requis pour accéder à Automation Suite sur les appareils iOS ; le nom alternatif du sujet pour toutes les entrées DNS requises ; la correspondance entre le certificat du serveur et la clé privée ; le bundle CA que vous avez fourni est en réalité l'émetteur du certificat de serveur ; la validité du certificat est supérieure à 30 jours.
Certificat de signature de jeton	Vérifie que le certificat de signature de jetons que vous avez fourni est valide. Le contrôle prend en compte les aspects suivants : le certificat est au format pfx ; le mot de passe de déchiffrement du certificat est valide ; la validité du certificat est supérieure à 30 jours.
Proxy	Vérifie que vous avez correctement configuré le proxy. Le contrôle prend en compte les aspects suivants : https_proxy http_proxy et no_proxy sont définis en tant que variables d'environnement sur la machine ; le serveur proxy est accessible.
Connectivité	Valide que toutes les machines peuvent se connecter les unes aux autres, que toutes les URL requises se trouvent sur la liste d'autorisation du pare-feu, et plus encore. Le contrôle prend en compte les aspects suivants : le nom de domaine complet d'Automation Suite et le nom de domaine complet de tous les autres sous-domaines peuvent être résolus à partir de la machine ; dans une configuration en ligne, toutes les URL externes sont accessibles depuis la machine ; tous les serveurs, agents et nœuds contaminés peuvent se connecter les uns aux autres sur les ports requis ; les connexions sortantes (URL) peuvent être résolues via tous les serveurs de noms présents dans /etc/resolve.conf ; si l'une des URL ne peut pas être résolue via tous les serveurs de noms, alors au moins un serveur de noms peut résoudre toutes les URL ; le protocole TCP ou UDP est autorisé ; fixed_rke_address est défini sur les ports 9345 et 6443 ; une réponse est émise lorsqu'un appel est passé au nom de domaine complet (FQDN) sur le port 443.
Services système	Vérifie que les services système sont correctement configurés. Le contrôle prend en compte les aspects suivants : nm-cloud-setup.service, nm-cloud-setup.timer et firewalld sont désactivés ; iscsi-initiator-utils est installé et activé ; auditd est correctement configuré pour --backlog_wait_time défini sur 1 ; logrotate est correctement configuré ; net.ipv4.conf.all.rp_filter est désactivé (défini sur 0).
Prérequis logiciels	Valide que tous les logiciels requis sont installés. Si certains logiciels ne sont pas installés, le programme d'installation install-uipath.sh tente de les installer.

Utilisation du script pour valider les prérequis d'installation

Téléchargement du script

Remarque : Pour les installations hors ligne, vous devez effectuer cette étape sur une machine ayant accès à Internet et aux machines isolées sur lesquelles Automation Suite est déployée. Copiez les fichiers de la machine en ligne vers la première machine cible.

Le script prérequis est empaqueté avec le programme d'installation dans une archive appelée sf-installer.zip , et les outils de prise en charge sont regroupés en tant que sf-infra.tar.gz pour le mode hors connexion uniquement. Vous avez besoin de ces fichiers pour générer un rapport sur toutes les machines sur lesquelles vous prévoyez d'installer Automation Suite.

Type d'installation	Fichiers à télécharger
En ligne	sf-installer.zip – Obligatoire. Pour obtenir des instructions de téléchargement, consultez sf-installer.zip.
Hors ligne	sf-installer.zip – Obligatoire. Pour obtenir des instructions de téléchargement, consultez sf-installer.zip. sf-infra.tar.gz – Obligatoire. Pour obtenir des instructions de téléchargement, consultez la section sf-infra.tar.gz.

Préparation à l'utilisation du script

1. Devenez root en exécutant la commande suivante :

   sudo su -

2. Copiez les fichiers dans le dossier /opt/UiPathAutomationSuite/{version} en exécutant la commande suivante :

   VERSION="" #add the version number you are trying to install. Ex: for 2022.4.0 Set VERSION="2022.4.0"
   mkdir -p /opt/UiPathAutomationSuite/${VERSION}
   # For below command replace the /path/to where actually the files are present.
   cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/${VERSION}
   # Additionally for offline, copy sf-infra.tar.gz as well to /opt/UiPathAutomationSuite/{VERSION} folder
   cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/${VERSION}
   cd /opt/UiPathAutomationSuite/${VERSION}

3. Décompressez le package en exécutant la commande suivante :

   unzip sf-installer.zip -d installer

4. Attribuez les autorisations nécessaires et accédez au dossier de script en exécutant la commande suivante :

   chmod -R 755 installer
   cd installer

Paramètres de script

Pour afficher la section d'aide et les indicateurs pris en charge, exécutez la commande suivante :

./validateUiPathASReadiness.sh --help

Sortie :

***************************************************************************************
validateUiPathASReadiness.sh Runs pre-install validation checks
Usage:
  validateUiPathASReadiness.sh [command]
  validateUiPathASReadiness.sh [flags]
Available Commands:
  validate-packages                                     Validate that required packages are installed
  install-packages                                      Install required packages. If --install-type offline, this will also install offline required packages
Arguments:
 -i|--input                                             Specify cluster config json file. Defaults to /opt/UiPathAutomationSuite/cluster_config.json
 -d|--debug                                             Debug mode to get additional details helpful for debugging
 -m|--machines                                          Comma separated IP address / hostnames of all the machines
 -n|--node-type                                         Possible values [server|agent|taskmining|asrobots|gpu]. Defaults to server
 --install-type                                         Possible values [online|offline]. Defaults to online
 --prereq-bundle </uipath/offline_bundle.tar.gz>        Specify the path to the prereq bundle
 --prereq-tmp-folder </uipath>                          Specify parent directory for the temporary install folder
 --kubeconfig                                           Specify path to the kubeconfig file
 -h|--help                                              Display help
***************************************************************************************

Le tableau suivant décrit les paramètres que vous pouvez utiliser lors de l'exécution du script :

Paramètre	Description
-i|--input	Accepte le fichier cluster_config.json comme entrée. Ce fichier définit les paramètres et préférences appliqués aux services UiPath déployés via Automation Suite. Pour plus de détails, voir Expérience d'installation avancée ( Advanced Installation Experience) . Si vous ne fournissez pas ce fichier, le script déclenchera l'expérience interactive pour collecter ces entrées. Le fichier sera ensuite généré en votre nom.
-d|--debug	Mode débogage pour obtenir des détails supplémentaires utiles pour le débogage.
-m|--machines	Accepte les adresses IP/noms d'hôte séparés par des virgules de toutes les machines. Cela est nécessaire pour vérifier la connectivité entre tous les nœuds sur le port requis. Le paramètre est obligatoire pour les installations de production multi-nœuds compatibles haute disponibilité. De plus, le paramètre est également requis si vous prévoyez d'ajouter un nœud Task Mining, GPU ou d'Automation Suite Robots dans un cluster d'évaluation à nœud unique.
-n|--node-type	Accepte le type du nœud actuel. Les valeurs possibles sont : server , agent , task-mining , gpu ou asrobots . La valeur par défaut est server.
--install-type	Accepte la méthode d'installation : online ou offline . La valeur par défaut est online.
--prereq-bundle	Accepte le chemin d'accès absolu où se trouve sf-infra.tar.gz .
--prereq-tmp-folder	Accepte le chemin d'accès absolu où le bundle sf-infra.tar.gz sera temporairement extrait. Si ce chemin n'est pas fourni, le programme d'installation sélectionnera le dossier /tmp .
--kubeconfig	Spécifiez le chemin d'accès au fichier kubeconfig.
validate-packages	Valide les packages RPM requis.
install-packages	Installe les packages RPM requis pour l'installation en ligne.
install-packages --install-type offline	Installe les packages RPM requis pour une installation hors ligne.

Validation d'une configuration d'évaluation à nœud unique

En ligne

Pour valider une machine d'évaluation à nœud unique, exécutez la commande suivante :

./validateUiPathASReadiness.sh \ --node-type server \ # replace server with task-mining, gpu if you wish to install. --install-type online

Hors ligne

Pour valider une machine à nœud unique, exécutez la commande suivante :

./validateUiPathASReadiness.sh \ --node-type server \ --install-type offline \ --prereq-bundle ../sf-infra.tar.gz \ --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp

Pour valider un nœud d'agent spécialisé utilisé pour les robots Task Mining, GPU ou Automation Suite, procédez comme suit :

1. Copiez le fichier cluster_config.json généré sur la machine serveur sur toutes les machines agent :

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

   Remarque :

   Si vous ne parvenez pas à copier le fichier dans le dossier /opt/UiPathAutomationSuite en raison d'une erreur d'autorisation, vous pouvez le copier temporairement dans /var/tmp sur les nouvelles machines, puis le déplacer vers /opt/UiPathAutomationSuite .

   Vous pouvez également fournir des autorisations d'accès complètes ( 777 ) au dossier /opt/UiPathAutomationSuite sur les nouvelles machines, en exécutant la commande suivante : chmod -R 777 /opt/UiPathAutomationSuite .

2. Pour valider l'environnement, exécutez la commande suivante sur les machines agent :

   Remarque :

   Assurez-vous d'utiliser le paramètre approprié pour identifier votre nœud d'agent spécialisé :

   • pour les machines Task Mining, utilisez --node-type task-mining
   • pour les machines GPU, utilisez --node-type gpu
   • Pour les machines Robots Automation Suite, utilisez --node-type asrobots

En ligne

./validateUiPathASReadiness.sh \ --input /opt/UiPathAutomationSuite/cluster_config.json \ --node-type task-mining \ #replace with gpu for GPU node or asrobots for Automation Suite Robots node --install-type online \ #replace with offline for airgap --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IP of all the nodes in cluster

Hors ligne

./validateUiPathASReadiness.sh \ --input /opt/UiPathAutomationSuite/cluster_config.json \ --node-type task-mining \ #replace with gpu for GPU node or asrobots for Automation Suite Robots node --install-type offline --prereq-bundle ../sf-infra.tar.gz \ --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp \ --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IP of all the nodes in cluster