- Vue d'ensemble (Overview)
- Prérequis
- Recommandé : modèles de déploiement
- Manuel : Préparation de l'installation
- Manuel : Préparation de l'installation
- Étape 1 : Configuration du registre compatible OCI pour les installations hors ligne
- Étape 2 : configuration du magasin d'objets externe
- Étape 3 : Configuration du module complémentaire High Availability Add-on
- Étape 4 : configurer Microsoft SQL Server
- Étape 5 : configurer l’équilibreur de charge
- Étape 6 : configurer le DNS
- Step 7: Configuring kernel and OS level settings
- Step 8: Configuring the disks
- Step 9: Configuring the node ports
- Step 10: Applying miscellaneous settings
- Étape 12 : Validation et installation des packages RPM requis
- Step 13: Generating cluster_config.json
- Configuration du certificat
- Configuration de la base de données
- Configuration du magasin d'objets externe
- Configuration d'URL pré-signée
- Configuration du registre externe compatible OCI
- Disaster Recovery : configurations Active/Passive et Active/Active
- Configuration du module complémentaire High Availability Add-on
- Configuration spécifique à Orchestrator
- Configuration spécifique à Insights
- Configuration spécifique à Process Mining
- Configuration spécifique à Document Understanding
- Configuration spécifique à Automation Suite Robots
- Configuration de la surveillance
- Facultatif : configuration du serveur proxy
- Facultatif : Activation de la résilience aux échecs locaux dans un cluster en mode production multi-nœuds compatible haute disponibilité
- Facultatif : Transmettre le fichier personnalisé resolv.conf
- Facultatif : augmentation de la tolérance aux pannes
- install-uipath.sh parameters
- Ajout d'un nœud d'agent dédié avec prise en charge GPU
- Ajout d'un nœud d'agent dédié pour Task Mining
- Connexion de l'application Task Mining
- Ajout d'un nœud d'agent dédié pour les Automation Suite Robots
- Step 15: Configuring the temporary Docker registry for offline installations
- Step 16: Validating the prerequisites for the installation
- Manuel : Exécution de l'installation
- Post-installation
- Administration du cluster
- Gestion des produits
- Premiers pas avec le portail d'administration du cluster
- Migration d'un magasin d'objets d'un volume persistant vers des disques bruts
- Migration du module complémentaire High Availability Add-on externe vers un module complémentaire High Availability Add-on externe
- Migration des données entre les librairies
- Migration d'un magasin d'objets intégré au cluster vers un magasin d'objets externe
- Basculer manuellement vers le cluster secondaire dans une configuration active/passive
- Disaster Recovery : exécution d'opérations post-installation
- Conversion d'une installation existante en configuration multi-sites
- Guidelines on upgrading an Active/Passive or Active/Active deployment
- Guidelines on backing up and restoring an Active/Passive or Active/Active deployment
- Redirecting traffic for the unsupported services to the primary cluster
- Surveillance et alerte
- Migration et mise à niveau
- Étape 1 : Déplacement des données d'organisation Identity d'installation autonome vers Automation Suite
- Étape 2 : Restauration de la base de données de produits autonome
- Étape 3 : Sauvegarder la base de données de la plate-forme dans Automation Suite
- Étape 4 : Fusion des organisations dans Automation Suite
- Étape 5 : Mise à jour des chaînes de connexion du produit migré
- Étape 6 : migration de la version autonome d'Orchestrator
- Étape 7 : Migration d'Insights autonome
- Step 8: Deleting the default tenant
- B) Migration à locataire unique
- Migration d'Automation Suite sur Linux vers Automation Suite sur EKS/AKS
- Mettre à niveau Automation Suite
- Téléchargement des packages d'installation et obtention de l'ensemble des fichiers sur le premier nœud de serveur
- Récupération de la dernière configuration appliquée à partir du cluster
- Mise à jour de la configuration du cluster
- Configuration du registre compatible OCI pour les installations hors ligne
- Migration vers un registre externe compatible OCI
- Exécution de la mise à niveau
- Exécution d'opérations post-mise à niveau
- Configuration spécifique au produit
- Utilisation de l'outil Orchestrator Configurator
- Configuration des paramètres d'Orchestrator
- Paramètres de l'application Orchestrator
- Configuration des paramètres d'application
- Configuration de la taille maximale de la requête
- Remplacement de la configuration du stockage au niveau du cluster
- Configuration des magasins d'informations d'identification
- Configuration de la clé de chiffrement par locataire
- Bonnes pratiques et maintenance
- Résolution des problèmes
- Comment résoudre les problèmes des services lors de l'installation
- Comment désinstaller le cluster
- Comment nettoyer les artefacts hors ligne pour améliorer l'espace disque
- Comment effacer les données Redis
- Comment activer la journalisation Istio
- Comment nettoyer manuellement les journaux
- Comment nettoyer les anciens journaux stockés dans le bundle sf-logs
- Comment désactiver les journaux de diffusion pour AI Center
- Comment déboguer les installations d'Automation Suite ayant échoué
- Comment supprimer des images de l’ancien programme d’installation après la mise à niveau
- Comment désactiver le déchargement de la somme de contrôle de la carte réseau
- Comment mettre à niveau Automation Suite 2022.10.10 et 2022.4.11 vers 2023.10.2
- Comment définir manuellement le niveau de journal ArgoCD sur Info
- Impossible d'exécuter une installation hors ligne sur le système d'exploitation RHEL 8.4
- Erreur lors du téléchargement du bundle
- L'installation hors ligne échoue en raison d'un fichier binaire manquant
- Problème de certificat dans l'installation hors ligne
- La première installation échoue lors de la configuration de Longhorn
- Erreur de validation de la chaîne de connexion SQL
- Échec de la vérification des prérequis pour le module selinux iscsid
- Disque Azure non marqué comme SSD
- Échec après la mise à jour du certificat
- L'antivirus provoque des problèmes d'installation
- Automation Suite ne fonctionne pas après la mise à niveau du système d'exploitation
- Automation Suite requiert que backlog_wait_time soit défini sur 0
- Volume impossible à monter car il n'est pas prêt pour les charges de travail
- Cluster défectueux après la mise à niveau automatisée à partir de la version 2021.10
- Échec de la mise à niveau en raison d’un Ceph défectueux
- RKE2 ne démarre pas en raison d'un problème d'espace
- Le volume ne peut pas être monté et reste à l'état de boucle d'attachement/détachement
- La mise à niveau échoue en raison d’objets classiques dans la base de données Orchestrator
- Cluster Ceph trouvé dans un état dégradé après une mise à niveau côte à côte
- Un composant Insights défectueux entraîne l’échec de la migration
- La mise à niveau du service échoue pour Apps
- Délais d'attente de mise à niveau sur place
- Migration du registre Docker bloquée lors de la suppression du PVC
- Échec de l'enregistrement d'AI Center après la mise à niveau vers 2023.10
- La mise à niveau échoue dans les environnements hors ligne
- Échec du chargement ou du téléchargement des données dans l'objectstore
- Le redimensionnement de la PVC ne répare pas Ceph
- Échec du redimensionnement du PVC objectstore
- Rook Ceph ou pod Looker bloqué dans l'état Init
- Erreur de pièce jointe du volume Ensembles d'états.
- Échec de la création de volumes persistants
- Définition d'un délai d'expiration pour les portails de gestion
- L'authentification ne fonctionne pas après la migration
- Kinit : Impossible de trouver le KDC pour le domaine <AD Domain> lors de l'obtention des informations d'identification initiales
- Kinit : Keytab ne contient aucune clé appropriée pour *** lors de l'obtention des informations d'identification initiales
- L'opération GSSAPI a échoué en raison d'un code de statut non valide
- Alarme reçue pour l'échec de la tâche Kerberos-tgt-update
- Fournisseur SSPI : serveur introuvable dans la base de données Kerberos
- La connexion a échoué pour l'utilisateur AD en raison d'un compte désactivé
- Échec de connexion à ArgoCD
- Mettre à jour les connexions du répertoire sous-jacent
- Impossible d'obtenir l'image du bac à sable
- Les pods ne s'affichent pas dans l'interface utilisateur ArgoCD
- Échec de la sonde Redis
- Le serveur RKE2 ne démarre pas
- Secret introuvable dans l'espace de noms UiPath
- ArgoCD passe à l'état Progression (Progressing) après la première installation
- Pods MongoDB en mode CrashLoopBackOff ou enregistrement PVC en attente après suppression
- Services défectueux après la restauration ou l'annulation du cluster
- Pods bloqués dans Init:0/X
- Métriques Ceph-rook manquants dans les tableaux de bord de surveillance
- Document Understanding n'est pas affiché sur la barre de gauche d'Automation Suite
- État Échec (Failed) lors de la création d'une session de labellisation des données
- État Échec (Failed) lors de la tentative de déploiement d'une compétence ML
- La tâche de migration échoue dans ArgoCD
- La reconnaissance de l'écriture manuscrite avec l'Extracteur de formulaires intelligents (Intelligent Form Extractor) ne fonctionne pas
- Exécution de l'outil de diagnostic
- Utilisation de l'outil Automation Suite Support Bundle
- Explorer les journaux
Configuration du registre compatible OCI pour les installations hors ligne
Dans les installations hors ligne, vous avez besoin d'un registre compatible OCI (Open Container Initiative) pour stocker les images de conteneur et les graphiques Helm de déploiement. Si vous effectuez une installation en ligne, ignorez cette étape.
Nous vous recommandons fortement d'apporter votre propre registre. Si vous n'en avez pas de disponible, vous pouvez installer temporairement un registre compatible OCI sur l'une des machines serveur.
Il existe deux manières de télécharger les artefacts Automation Suite vers le registre compatible OCI externe :
- Option A: By mirroring your OCI-compliant registry with the UiPath® registry;
- Option B : Hydrater votre registre compatible OCI avec le bundle hors ligne.
Le tableau suivant compare les deux options de téléchargement des artefacts dans le registre afin que vous puissiez choisir celle qui convient le mieux à vos besoins :
Option A : Mettre en miroir le registre |
Option B : hydrater le registre |
---|---|
Copies the artifacts from the UiPath® registry to any target registry. |
Utilise tarball hors ligne pour décompresser et télécharger les artefacts dans le registre cible. |
Nécessite les outils Docker et Helm. |
Nécessite les outils Podman et Helm. |
Requires internet access while copying the artifacts from the UiPath® registry to the target registry. |
Nécessite un accès à Internet uniquement pour télécharger tarball hors ligne sur Jump Server. Le téléchargement de tarball ne nécessite pas d’accès à Internet. |
Nécessite un espace temporaire pour mettre les images en cache pendant la méthode de copie. Cet espace est généralement configuré lors de l'installation de Docker. Le dossier par défaut est
/var/lib/docker .
|
Nécessite un espace temporaire pour extraire tarball et un espace temporaire pour Podman afin de charger les images. L'emplacement d'extraction de tarball doit être fourni lors de l'étape d'hydratation. L'emplacement Podman peut être
/var/tmp , qui doit disposer d'un stockage adéquat.
|
La capacité de stockage requise pour
/var/lib/docker est d’environ 128 Go.
|
La capacité de stockage requise pour l'extraction est d'environ 200 Gio, et
/var/tmp doit être de 256 Gio.
|
Cette méthode nécessite un accès Internet sur la machine intermédiaire à partir de laquelle vous téléchargez les artefacts Automation Suite dans votre registre compatible OCI.
Prerequisites for mirroring the UiPath® registry
To mirror the UiPath® registry, you need the following:
-
une machine virtuelle exécutant une distribution Linux (recommandé) ou un ordinateur portable (non recommandé) ;
-
un client Docker authentifié avec le registre privé ;
-
Helm 3.8 ou une version plus récente authentifié avec le registre privé ;
-
as-images.txt
; -
as-helm-charts.txt
; -
mirror-registry.sh
; -
connectivité sortante vers
registry.uipath.com
; -
128 Go d'espace disque libre pour Docker sous la partition
/var/lib/docker
, sur la machine à partir de laquelle vous téléchargez les images et les graphiques du conteneur.
Installation de Docker et Helm
Docker et Helm doivent être installés et authentifiés sur la machine à partir de laquelle vous prévoyez de télécharger les images de conteneur Automation Suite et les graphiques dans votre registre.
-
Pour télécharger les fichiers binaires Docker, consultez la documentation officielle.
-
Pour authentifier le registre Docker, consultez la documentation officielle. Vous pouvez également utiliser la commande suivante en remplaçant les exemples d'informations d'identification par vos informations d'identification de registre réelles :
docker login my.registry.io:443 --username "admin" --password "secret"
docker login my.registry.io:443 --username "admin" --password "secret" -
Pour télécharger les fichiers binaires Helm, consultez la documentation officielle.
-
Pour authentifier le registre Helm, consultez la documentation officielle. Vous pouvez également utiliser la commande suivante en remplaçant les exemples d'informations d'identification par vos informations d'identification de registre réelles :
helm registry login my.registry.io:443 --username "admin" --password "secret"
helm registry login my.registry.io:443 --username "admin" --password "secret"
Téléchargement du fichier as-images.txt
as-images.txt
, voir Téléchargement des bundles d'installation.
Téléchargement du fichier as-helm-charts.txt
as-helm-charts.txt
, voir Téléchargement des bundles d'installation.
Téléchargement des bundles Document Understanding facultatifs
Pour télécharger des bundles Document Understanding facultatifs, consultez la documentation Document Understanding.
Téléchargement de miroir-registre.sh
mirror-registry.sh
, consultez la section Téléchargement des packages d'installation.
Téléchargement des images Automation Suite dans votre registre
mirror-registry.sh
nécessite une connectivité sortante vers les registres source (registry.uipath.com
par défaut) et cible.
mirror-registry.sh
n'authentifie pas le registre. Il suppose que vous vous êtes déjà authentifié auprès du registre.
Drapeau |
Variable d'environnement |
Description |
---|---|---|
|
|
Obligatoire. Chemin d'accès au fichier manifeste de l'image. |
|
|
Obligatoire. Chemin d'accès au fichier manifeste du graphique Helm. |
|
|
Obligatoire. Transmettez l'URL du registre cible. |
|
|
Facultatif. Transmettez l'URL du registre source ; la valeur par défaut est
registry.uipath.com .
|
-
Assurez-vous que nous disposons des autorisations nécessaires pour exécuter le script Shell, en exécutant la commande suivante :
chmod +x mirror-registry.sh
chmod +x mirror-registry.sh -
Pour télécharger les images Automation Suite dans votre registre, exécutez la commande suivante :
./mirror-registry.sh --target-registry-url my.registry.io:443 --source-registry-url registry.uipath.com --images-manifest /home/myuser/as-images.txt --helm-charts-manifest /home/myuser/as-helm-charts.txt
./mirror-registry.sh --target-registry-url my.registry.io:443 --source-registry-url registry.uipath.com --images-manifest /home/myuser/as-images.txt --helm-charts-manifest /home/myuser/as-helm-charts.txt
Cette méthode nécessite uniquement un accès Internet sur la machine intermédiaire pour télécharger le bundle hors ligne. Une fois le bundle disponible, vous pouvez le télécharger vers votre registre compatible OCI sans connexion Internet.
Cette méthode peut également nécessiter un espace supplémentaire sur la machine pour le décompresser et télécharger dans votre registre. Quoi qu'il en soit, cette méthode peut prendre plus de temps que l'approche de mise en miroir.
Prérequis pour hydrater le registre
Pour hydrater le registre, vous avez besoin des éléments suivants :
- une machine virtuelle exécutant une distribution Linux est préférable à l'exécution du script sur un ordinateur portable ;
- possibilité de télécharger et de copier ou de propager d'une manière ou d'une autre manière le bundle hors ligne vers la machine virtuelle ;
- Helm 3.8 ou une version plus récente authentifié avec le registre privé ;
- Podman installé, configuré et authentifié avec le registre privé ;
- 150 Gio d'espace disque libre pour Podman sous
/var/lib/containers
pour charger les conteneurs localement avant de les transmettre au registre distant. Vous pouvez modifier le chemin par défaut en mettant à jour l'emplacement du chemin graphRoot dans la sortie de la commandepodman-info
. - Définissez la variable d'environnement
TMP_DIR
comme décrit dans la documentation officielle de Podman. as.tar.gz
Installation de Podman et Helm
Vous devez vous assurer que Podman et Helm sont installés et authentifiés sur la machine à partir de laquelle vous prévoyez de télécharger les images de conteneur Automation Suite et les graphiques dans votre registre.
- Pour télécharger les fichiers binaires Podman, consultez la documentation officielle.
- Pour vous authentifier auprès du registre Podman, consultez la documentation officielle. Vous pouvez également utiliser la commande suivante en remplaçant les exemples d'informations d'identification par vos informations d'identification de registre réelles :
podman login my.registry.io:443 --username "admin" --password "secret"
podman login my.registry.io:443 --username "admin" --password "secret" - Pour télécharger les fichiers binaires Helm, consultez la documentation officielle.
- Pour authentifier le registre Helm, consultez la documentation officielle. Vous pouvez également utiliser la commande suivante en remplaçant les exemples d'informations d'identification par vos informations d'identification de registre réelles :
helm registry login my.registry.io:443 --username "admin" --password "secret"
helm registry login my.registry.io:443 --username "admin" --password "secret"
Téléchargement de as.tar.gz
as.tar.gz
, voir Téléchargement des bundles d'installation.
Téléchargement des bundles Document Understanding facultatifs
Pour télécharger des bundles Document Understanding facultatifs, consultez la documentation Document Understanding.
Téléchargement de hydrate-registry.sh
hydrate-registry.sh
, consultez la section Téléchargement des packages d'installation.
Téléchargement des images Automation Suite dans le registre
hydrate-registry.sh
.
hydrate-registry.sh
ne nécessite pas de connectivité sortante, sauf avec les registres cibles.
hydrate-registry.sh
n'authentifie pas le registre. Il suppose que vous vous êtes déjà authentifié auprès du registre.
Drapeau |
Description |
---|---|
|
Obligatoire. Chemin d'accès au bundle hors ligne. |
|
Obligatoire. Transmettez l'URL du registre cible. |
|
Emplacement à utiliser pour décompresser le bundle hors ligne. Il peut s'agir d'un emplacement
/var/lib/containers ou d'un emplacement personnalisé. Assurez-vous d'avoir un minimum de 100 Gio de stockage. Il est recommandé d'avoir 256 Gio de stockage.
|
./hydrate-registry.sh --target-registry-url registry.azurecr.io --offline-bundle-path ./as.tar.gz --extract-path /extract/to/path
./hydrate-registry.sh --target-registry-url registry.azurecr.io --offline-bundle-path ./as.tar.gz --extract-path /extract/to/path
Pour configurer correctement votre registre externe compatible OCI, vous devez mettre à jour le magasin approuvé de toutes les machines sur lesquelles vous prévoyez d'installer Automation Suite. Pour obtenir des instructions sur la façon d'effectuer cette étape après l'installation, consultez Gestion des certificats.
Pour ce faire, procédez comme suit :
- Ajoutez le fichier CA à l'emplacement
/etc/pki/ca-trust/source/anchors/
. - Exécutez
update-ca-trust
pour mettre à jour le magasin approuvé du système d'exploitation. Une fois le magasin d'approbations mis à jour, le fichier de certificat extrait est fusionné dans/etc/pki/ca-trust/extracted/ca-bundle.trust.crt
.
registry_ca_cert
paramètre cluster_config.json
. Pour plus de détails, consultez la section Configuration du registre compatible OCI externe.
Cette étape est nécessaire uniquement pour les installations hors ligne qui utilisent un registre de cluster. Vous pouvez ignorer cette étape si vous effectuez une installation hors ligne qui utilise un registre externe compatible OCI ou une installation en ligne.
/uipath
.
Le registre Docker temporaire n'est requis que lors de l'installation ou de la mise à niveau. Une fois l'installation ou la mise à niveau réussie, le registre temporaire n'est plus nécessaire et doit être désinstallé.
Pour configurer le registre temporaire, vous avez besoin des éléments suivants :
-
as-fs.tar.gz
: pour le télécharger, consultez la section Téléchargement des packages d'installation.
Pour installer le registre Docker temporaire sur l'un des nœuds, exécutez la commande suivante :
./configureUiPathAS.sh registry install-temp-registry -i cluster_config.json
./configureUiPathAS.sh registry install-temp-registry -i cluster_config.json
Drapeau |
Description |
---|---|
|
Facultatif. Accepte le chemin d'accès au fichier
cluster_config.json . Il n'est requis que lors de la modification du port de registre par défaut et du chemin d'accès au fichier.
|
30070
et utilise le chemin d'accès au fichier /uipath/data/registry
. Vous devez ouvrir le port 30070
sur l'équilibreur de charge et le nœud sur lequel vous installez le registre Docker temporaire.
Le pool principal de l’équilibreur de charge doit cibler exclusivement les nœuds hébergeant le registre docker temporaire.
cluster_config.json
comme indiqué dans l'exemple suivant :
{
"infra": {
"tmp_docker_registry": {
"node_port": "<new port number>",
"file_path": "/uipath/data/registry"
}
}
}
{
"infra": {
"tmp_docker_registry": {
"node_port": "<new port number>",
"file_path": "/uipath/data/registry"
}
}
}
Après avoir installé le registre temporaire, procédez comme suit :
-
Hydratez le registre temporaire avec les images de conteneur et les graphiques Helm en exécutant la commande suivante :
./configureUiPathAS.sh registry hydrate-temp-registry --offline-bundle /uipath/tmp/as-fs.tar.gz -i cluster_config.json
./configureUiPathAS.sh registry hydrate-temp-registry --offline-bundle /uipath/tmp/as-fs.tar.gz -i cluster_config.json - Référencez le registre interne à partir du registre temporaire en exécutant la commande suivante :
./configureUiPathAS.sh registry seed-internal-registry -i cluster_config.json
./configureUiPathAS.sh registry seed-internal-registry -i cluster_config.json
Drapeau |
Description |
---|---|
|
Chemin d'accès au fichier contenant l'emplacement de
as-fs.tar.gz sur votre nœud de serveur.
|
|
Facultatif. Accepte le chemin d'accès au fichier
cluster_config.json . Il n'est requis que lors de la modification du port du registre Docker et du chemin d'accès par défaut.
|
- Téléchargement des artefacts Automation Suite vers le registre externe compatible OCI
- Option A: Mirroring the UiPath® registry to your registry
- Option B : hydrater le registre avec le bundle hors ligne
- Configuration du certificat pour le registre externe compatible OCI
- Configuration du registre Docker temporaire
- Prérequis pour la configuration du registre temporaire
- Installation du registre temporaire
- Hydratation du registre temporaire