- Vue d'ensemble (Overview)
- Prérequis
- Installation
- Questions et réponses : modèles de déploiement
- Configuration des machines
- Configuration du magasin d'objets externe
- Configuration d'un registre Docker externe
- Configurer l'équilibreur de charge
- Configuration du DNS
- Configuration de Microsoft SQL Server
- Configuration des certificats
- Installation de production en ligne multi-nœuds compatible haute disponibilité
- Installation de production hors ligne multi-nœuds compatible haute disponibilité
- Disaster Recovery - Installation du cluster secondaire
- Téléchargement des packages d'installation
- install-uipath.sh parameters
- Activation du module complémentaire Redis High Availability Add-on pour le cluster
- Fichier de configuration de Document Understanding
- 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
- 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 des données entre les librairies
- Migration d'un magasin d'objets intégré au cluster vers un magasin d'objets externe
- Basculer vers le cluster secondaire
- Disaster Recovery : exécution d'opérations post-installation
- Conversion d'une installation existante en configuration multi-sites
- Directives sur la mise à niveau d'un déploiement actif/passif
- Directives pour la sauvegarde et la restauration d'un déploiement actif/passif
- Surveillance et alerte
- Migration et mise à niveau
- Chemins de mise à niveau Automation Suite
- Automatisée : mise à niveau en ligne
- Automatisée : mise à niveau hors ligne
- Manuel : mise à niveau en ligne
- Manuel : mise à niveau hors ligne
- Annulation en cas d'erreur
- Migration d'un disque physique Longhorn vers LVM
- Migration de Canal vers Cilium CNI
- Rétrogradation de Ceph de la version 16.2.6 à la version 15.2.9
- Options de migration :
- É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 du produit 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’Insights
- Étape 7 : suppression du locataire par défaut
- B) Migration à locataire unique
- Configuration spécifique au produit
- Rotation des informations d’identification de stockage d’objets blob
- Désactivation de l'utilisation d'URL pré-signées lors du téléchargement de données vers le stockage Amazon S3
- Configuration de la sécurité de l'application de processus
- Configurer une authentification Kerberos avec l’authentification MSSQL de base pour Process Mining
- 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 nettoyer automatiquement les instantanés Longhorn
- Comment désactiver le déchargement de la somme de contrôle txt
- Comment définir manuellement le niveau de journalisation d’ArgoCD sur Info
- Comment générer la valeur pull_secret_value encodée pour les registres externes
- Comment résoudre les chiffrements faibles dans TLS 1.2
- 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
- Nœud GPU affecté par l'indisponibilité des ressources
- Volume impossible à monter car il n'est pas prêt pour les charges de travail
- Échec de la mise à niveau du nœud unique à l’étape Fabric
- 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
- Échec de la validation SQL lors de la mise à niveau
- É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
- É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
- Correctif de récupération du stockage
- La sauvegarde a échoué en raison de l’erreur TropInstantanés (TooManySnapshots)
- Toutes les répliques Longhorn sont défaillantes
- Définition d'un délai d'expiration pour les portails de gestion
- Mettre à jour les connexions du répertoire sous-jacent
- 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
- 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
- Problèmes d'accès au compte ArgoCD en lecture seule
- 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
- Prometheus en état CrashloopBackoff avec erreur de mémoire insuffisante (OOM)
- Métriques Ceph-rook manquantes 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 la haute disponibilité avec Process Mining
- Échec de l’ingestion de Process Mining lors de la connexion à l’aide de Kerberos
- Impossible de se connecter à la base de données AutomationSuite_ProcessMining_Authentication à l'aide d'une chaîne de connexion au format pyodbc
- L'installation d'airflow échoue avec sqlalchemy.exc.ArgumentError: impossible d'analyser l'URL rfc1738 de la chaîne ''
- Comment ajouter une règle de table d'adresse IP pour utiliser le port SQL Server 1433
- Utilisation de l'outil de diagnostic d'Automation Suite
- Utilisation de l'outil Automation Suite Support Bundle
- Explorer les journaux
Automatisée : mise à niveau hors ligne
Ansible est utilisé pour automatiser la mise à niveau de l'ensemble du cluster Automation Suite, en effectuant certaines opérations sur une machine du cluster.
Dans l'illustration suivante, le nœud du serveur 1 (ou le nœud hôte Ansible) utilise Ansible pour orchestrer la mise à niveau de l'ensemble du cluster Automation Suite.
uipathctl.sh
. Pour plus de détails, consultez Utilisation de uipathctl.sh.
/opt/UiPathAutomationSuite
sur tous les nœuds. Si vous ne disposez pas de suffisamment d'espace, vous pouvez augmenter la capacité de ce dossier ou supprimer tous les fichiers du programme d'installation précédents, à l'exception de cluster_config.json
. Vous pouvez toujours télécharger à nouveau le programme d'installation précédent.
df -h /opt/UiPathAutomationSuite
.
Pour préparer la mise à niveau, procédez comme suit :
Si des erreurs ou des problèmes se produisent pendant ou après la mise à niveau, vous pouvez revenir à la version précédente, à condition d'avoir préalablement configuré une sauvegarde.
Pour obtenir des instructions, consultez la section Annulation en cas d'erreur.
docker-registry
avec des images de conteneur pour la nouvelle version des produits avant la mise à niveau.
- Assurez-vous de ne pas hydrater avec des images conteneur et/ou d'autres images d'infrastructure plus de 10 heures avant la mise à niveau.
- Si vous mettez à niveau Document Understanding et Computer Vision, vous devez télécharger les images de base qui correspondent à votre version mise à niveau d'Automation Suite (utilisez l'image de base qui correspond à la version de votre paquet ML) et les intégrer dans votre registre Docker avant la mise à niveau pour éviter d'interrompre l'exécution de vos compétences DU. Pour télécharger les packages d'installation de Document Understanding et Computer Vision, consultez Téléchargement des packages d'installation.
docker-registry
, exécutez la commande suivante sur le premier nœud du serveur :cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh registry upload --offline-bundle /uipath/{version}/as.tar.gz --offline-tmp-folder /uipath/tmp
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh registry upload --offline-bundle /uipath/{version}/as.tar.gz --offline-tmp-folder /uipath/tmp
Pour configurer la sauvegarde, procédez comme suit :
Une fois la sauvegarde créée, passez aux étapes suivantes.
Mettre le cluster en mode maintenance arrêtera le contrôleur d'entrée et tous les services UiPath, bloquant ainsi tout le trafic entrant vers le cluster Automation Suite.
Pour mettre à niveau le cluster Automation Suite, procédez comme suit :
Paramètres de base
Paramètre |
Valeur (Value) |
---|---|
|
Valeurs possibles :
online et offline .
Étant donné que cette page fournit des instructions pour un environnement hors ligne, choisissez la valeur
offline .
|
|
Les valeurs possibles sont :
all , infra , fabric et services .
Indique chaque étape du processus d'installation et de mise à niveau.
Important : vous devez télécharger et gérer le registre Docker en même temps que la mise à niveau de Kubernetes et des composants d'infrastructure. Pour exécuter les deux étapes simultanément, exécutez
--steps bundles infra .
N’exécutez pas
--steps bundles seul, car cela endommagerait le cluster.
Si une erreur se produit pendant la mise à niveau, vous pouvez utiliser ces points de contrôle pour reprendre l'opération de mise à niveau au lieu de réessayer depuis le début. |
|
Chemin d'accès au bundle hors ligne
as.tar.gz , contenant les images de conteneur de fabric et de services. Il est recommandé de le stocker dans /uipath/{version}/as.tar.gz |
|
Chemin d'accès au bundle hors ligne
as-infra.tar.gz , contenant Kubernetes et les bundles d'infrastructure.
|
|
cluster_config.json , qui définit les paramètres, les paramètres et les préférences appliqués aux services UiPath déployés via Automation Suite.
|
Paramètres avancés
Paramètre |
Valeur (Value) |
---|---|
|
Spécifiez le nom d'utilisateur à utiliser pour les connexions SSH à tous les nœuds. La valeur par défaut est l'utilisateur actuel. Si vous utilisez un nom d'utilisateur différent pour tous les nœuds, au lieu d'utiliser ce paramètre, définissez le nom d'utilisateur pour tous les nœuds dans
inventory.ini et transmettez-le au script.
Exemple : Lors de l'exécution du script, vous êtes connecté sous le nom d'utilisateur
myadminuser . Cependant, si vous souhaitez utiliser le nom d'utilisateur testadmin pour vous connecter via SSH, vous devez fournir testadmin à ce paramètre.
|
|
Spécifiez un fichier d'inventaire Ansible existant. S'il n'est pas spécifié, un sera généré automatiquement à partir du cluster existant avec la configuration de base. Dans certains scénarios où vous souhaitez avoir un contrôle plus précis, vous souhaiterez peut-être fournir votre propre fichier d'inventaire. Par exemple, si vous souhaitez utiliser un nom d'utilisateur SSH ou une clé SSH différent pour tous les nœuds du cluster. Pour plus de détails, voir Génération du fichier Inventory.ini Ansible. |
./uipathctl.sh upgrade --install-type offline --steps {fabric | services}
.
Une fois la mise à niveau terminée, le mode maintenance sera automatiquement désactivé.
Une fois la mise à niveau effectuée, vous pouvez effectuer les étapes supplémentaires suivantes :
-
Pour vérifier si Automation Suite est sain, exécutez :
kubectl get applications -n argocd
kubectl get applications -n argocd -
Lors de la mise à niveau à partir d'une version d'Automation Suite antérieure à 2023.4.0, vérifiez si Apps est en cours d'exécution, puis supprimez MongoDB :
./configureUiPathAS.sh mongodb uninstall --force
./configureUiPathAS.sh mongodb uninstall --force -
Si vous rencontrez une erreur lors de la suppression de MongoDB avec la commande
./configureUiPathAS.sh mongodb uninstall --force
, exécutez la commande suivante :kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": false }}}}' ./configureUiPathAS.sh mongodb uninstall --force kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": true }}}}'
kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": false }}}}' ./configureUiPathAS.sh mongodb uninstall --force kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": true }}}}' -
Si vous rencontrez des problèmes de vulnérabilité d’image ou de consommation de stockage après avoir effectué une mise à niveau, supprimez les images de l’ancien programme d’installation. Pour plus de détails, consultez la section Résolution des problèmes (Troubleshooting).
-
Après la mise à niveau vers Automation Suite 2023.4.8 ou une version plus récente, vous pouvez nettoyer les images de la version précédente après la mise à niveau à partir du registre Docker intégré au cluster. Pour obtenir des instructions, consultez la section Comment supprimer des images de l’ancien programme d’installation après la mise à niveau.
Avant de commencer à mettre à niveau le cluster, le script de mise à niveau crée automatiquement une sauvegarde du cluster, puis la désactive temporairement. Vous souhaiterez peut-être activer la sauvegarde manuellement une fois la mise à niveau terminée.
Pour activer la sauvegarde, suivez les instructions décrites dans la documentation Sauvegarder et restaurer le cluster.