Mettre à niveau Automation Suite

Vue d’ensemble du processus de mise à niveau d’Automation Suite, des prérequis et des considérations de compatibilité.

Important :

• Si vos nœuds de machine virtuelle hôte utilisent cgroup v1, vous devez migrer vers cgroup v2 avant la mise à niveau vers Automation Suite 2.2510.2. Pour plus de détails, consultez Matrice de compatibilité RHEL et Comment migrer vers Cgroup v2.

• les sauvegardes basées sur un serveur NFS ne sont pas prises en charge si vous utilisez un magasin d'objets externe. Vos sauvegardes sont stockées directement dans le magasin d'objets externe. Si vous mettez à niveau vers 2.2510, vous devez basculer vers le magasin d'objets externe pour les sauvegardes.

  Pour obtenir davantage d'informations, consultez la section Configuration du magasin d'objets externe ou contactez l'assistance.

• Task Mining n'est plus disponible dans Automation Suite 2.2510 (Notes de publication 2.2510.0). Si Task Mining a été installé dans une version précédente d'Automation Suite, il ne sera plus visible après la mise à niveau vers la version 2.2510.

  • En interne, Task Mining dépendait du service Dapr, qui a également été supprimé. Après la mise à niveau ou la migration réussie d'une version d'Automation Suite sur laquelle Task Mining était activé, assurez-vous de supprimer le nœud, la base de données et le stockage Task Mining, ou d'ajuster les nœuds pour les cas d'utilisation internes en mettant à jour les rejets et les tolérances si nécessaire.

• Les versions d’Automation Suite 2023.4.5 et 2023.10.2 incluent une mise à niveau vers Kubernetes 1.26.11. Ainsi, lors de la mise à niveau d’Automation Suite, vous devez veiller à ne pas rétrograder Kubernetes. Pour ce faire, lors du passage d’Automation Suite 2023.4.5 ou d’une version secondaire ultérieure vers la prochaine version majeure, vous devrez effectuer a minima une mise à niveau vers 2023.10.2.

• Pour connaître les parcours de mise à niveau disponibles, consultez la section Parcours de mise à niveau Automation Suite.

• Si vous prévoyez d’effectuer une mise à niveau à partir d’Automation Suite 2022.10 ou d’une version antérieure, et que Process Mining est activé, vous devez migrer les applications de processus vers la nouvelle disposition du graphique de processus avant de démarrer la mise à niveau.

• Si vous effectuez une mise à niveau à partir d'une version d'Automation Suite installée sur une machine sur laquelle FIPS 140-2 est désactivé, vous pouvez activer FIPS 140-2 en suivant les instructions à la page Sécurité et conformité.

• Vous ne pouvez activer ou désactiver aucun produit lors d'une mise à niveau d'Automation Suite.

• Si vous effectuez une mise à niveau vers Automation Suite 2.2510 et que vous souhaitez utiliser des projets modernes Document Understanding, vous devez répondre à la configuration matérielle supplémentaire requise que nous spécifions dans la section Recommandations supplémentaires Document Understanding.

Astuce :

Mettez à niveau votre UiPath Automation Suite au moins une fois par an. Cela vous permet de disposer des dernières versions de Kubernetes prises en charge, d’éviter la nécessité de mises à niveau intermédiaires multi-sauts et de passer directement et en toute fluidité à de nouvelles versions cibles.

Prérequis

• Assurez-vous de répondre à la configuration matérielle et logicielle requise pour la nouvelle version d’Automation Suite. Si AI Center est activé, veillez à bien respecter les exigences CUDA.
• Assurez-vous de suivre les meilleures pratiques de mise à niveau d'Automation Suite et d'effectuer le processus de mise à niveau qui répond le mieux à vos besoins.

Processus de mise à niveau

Automation Suite prend en charge deux processus de mise à niveau :

• Mise à niveau sur place
• Mise à niveau côte à côte

Processus de mise à niveau sur place

Le processus de mise à niveau sur place d'Automation Suite vous permet de passer à une nouvelle version d'Automation Suite tout en conservant vos paramètres et données intacts sur le même matériel.

• Dans le processus de mise à niveau sur place, commencez par mettre à niveau Kubernetes et les autres composants de l'infrastructure de manière séquentielle vers la version cible.
• Après les mises à niveau de Kubernetes et d’autres mises à niveau des composants de l’infrastructure, vous devez désinstaller la version actuelle et installer la version cible des composants partagés et des produits UiPath®.
• En cas de défaillance matérielle au-delà de la récupération pendant le processus de mise à niveau, vous devez revenir à la version précédente à l'aide de la capacité de sauvegarde et de restauration.

Mise à niveau côte à côte

La mise à niveau côte à côte d'Automation Suite repose sur une expérience de mise à niveau d'entreprise généralement appelée bleu-vert et qui est un processus standard dans le secteur.

• La mise à niveau côte à côte vous permet d'effectuer une mise à niveau en toute sécurité à l'aide d'un environnement parallèle au lieu de la mise à niveau sur place.
• Cette méthode permet aux administrateurs de transférer le trafic de l'ancien cluster Automation Suite (c'est-à-dire le déploiement bleu) vers le nouveau cluster Automation Suite (c'est-à-dire le déploiement vert) après avoir vérifié le nouveau déploiement. Si vous détectez un problème, vous pouvez rapidement revenir à l'ancien déploiement.

Mécanisme et capacités de mise à niveau

Capacité	Mécanisme de mise à niveau
	Mise à niveau sur place	Mise à niveau côte à côte
Mettre à niveau vers une nouvelle version LTS	✅	✅
Mise à niveau à partir de n'importe quelle version prise en charge	1	✅  2
Migration des données haute fidélité	✅	❌  3
Pas de temps d'arrêt pendant la mise à niveau	❌	❌
Restauration instantanée	❌	✅
Aucune configuration matérielle supplémentaire requise	✅	❌  4

¹ Vous pouvez effectuer une mise à niveau à partir de n'importe quelle version d'Automation Suite, mais une mise à niveau intermédiaire entre vos versions initiales et ciblées peut être nécessaire. Pour de plus amples informations, consultez la section Chemins de mise à niveau sur place.

² Vous pouvez effectuer une mise à niveau à partir de n’importe quelle version d’Automation Suite, à l’exception de la version 2021.10. Pour de plus amples informations, consultez la section Chemins de mise à niveau côte à côte.

³ Pour en savoir plus, consultez la section Migration des données et responsabilités.

⁴ Les mises à niveau côte à côte nécessitent du matériel supplémentaire. Vous pouvez soit apporter un environnement parallèle avec les mêmes spécifications que le cluster source, soit commencer par le matériel requis pour un cluster à nœud unique et le faire évoluer.

Chemins de mise à niveau sur place

La matrice suivante montre les chemins de mise à niveau sur place disponibles pour les versions d'Automation Suite:

• ✅ - un chemin de mise à niveau sur place direct entre les versions majeures est disponible ;

• - une mise à niveau sur place intermédiaire entre vos versions majeures initiale et ciblée est nécessaire.

  Remarque :

  Si vous devez effectuer une mise à niveau vers une version intermédiaire, vous pouvez utiliser la version intermédiaire comme version de base pour poursuivre la mise à niveau via le chemin de mise à niveau.

Les chemins de mise à niveau sur place sont spécifiques à Automation Suite sur Linux. Pour Automation Suite sur EKS/AKS, vous devez d’une part maintenir la compatibilité de Kubernetes. Pour Automation Suite sur OpenShift, en revanche, vous devez maintenir la compatibilité OpenShift.

Remarque :

Nous vous conseillons fortement de passer à la version secondaire la plus récente d’Automation Suite. Cela vous permettra de profiter des dernières améliorations et garantira un fonctionnement fluide pour tous les composants internes.

Version initiale	Automation Suite sur la version ciblée de Linux
	2022.10.x	2023.4.x	2023.10.x	2024.10.x	2.2510.x
2021.10.x	✅ 2021.10.x → 2022.10.9 → 2022.10.10 → 2022.10.12 → 2022.10.15 ou version ultérieure	2021.10.x → 2022.10.9 → 2023.4.5 → 2023.4.7 → 2023.4.10 → 2023.4.13	2021.10.x → 2022.10.9 → 2023.10.2 → 2023.10.4 → 2023.10.7 → 2023.10.9 → 2023.10.10 → 2023.10.12	2021.10.x → 2022.10.9 → 2023.10.2 → 2024.10.3 → 2024.10.8 → 2024.10.9	2021.10.x → 2022.10.9 → 2023.10.2 → 2024.10.3 → 2.2510.2 → 2.2510.3
2022.4.x	✅ (2022.4.0 - 2022.4.6) → 2022.10.9 → 2022.10.10 → 2022.10.12 → 2022.10.15 (2022.4.7 - 2022.4.11) → 2022.10.10 → 2022.10.12 → 2022.10.15 (2022.4.12 - 2022.4.13) → 22.10.13 → 22.10.15 (2022.4.14 - 2022.4.15) → 2022.10.13 → 2022.10.15	(2022.4.0 - 2022.4.6) → 2022.10.9 → 2023.4.5 → 2023.4.7 → 2023.4.10 → 2023.4.13 (2022.4.7 - 2022.4.11) → 2022.10.10 → 2023.4.7 → 2023.4.10 → 2023.4.13 (2022.4.12 - 2022.4.13) → 2022.10.13 → (2023.4.8 - 2023.4.10) → 2023.4.13 2022.4.15 → 2022.10.13 → 2023.4.10 → 2023.4.13	✅ Nécessite la version 2022.4.7 minimum de Ceph sur les appareils et la finalisation de la migration de Cilium avant de lancer la mise à niveau. (2022.4.7 - 2022.4.11) → 2023.10.3 → 2023.10.5 → 2023.10.7 → 2023.10.9 → 2023.10.10 → 2023.10.12 (2022.4.12 - 2022.4.13) → 2023.10.5 → 2023.10.7 → 2023.10.9 → 2023.10.10 → 2023.10.12 (2022.4.14 - 2022.4.15) → 2023.10.5 → 2023.10.7 → 2023.10.9 → 2023.10.10 → 2023.10.12	Nécessite la version 2022.4.7 minimum de Ceph sur les appareils et la finalisation de la migration de Cilium avant de lancer la mise à niveau. (2022.4.7 - 2022.4.10) → 2023.10.3 → 2024.10.3 → 2024.10.8 → 2024.10.9 (2022.4.11 - 2022.4.15) → 2024.10.3 → 2024.10.8 → 2024.10.9	Nécessite la version 2022.4.7 minimum de Ceph sur les appareils et la finalisation de la migration de Cilium avant de lancer la mise à niveau. (2022.4.7 - 2022.4.10) → 2023.10.3 → 2024.10.3 → 2.2510.2 → 2.2510.3 (2022.4.11 - 2022.4.15) → 2024.10.3 → 2.2510.2 → 2.2510.3
2022.10.x	✅ (2022.10.0 - 2022.10.9) → 2022.10.10 (2022.10.10 - 2022.10.11) → 2022.10.13 → 2022.10.15 (2022.10.12 - 2022.10.13) → 2022.10.15	✅ (2022.10.0 - 2022.10.9) → 2023.4.5 → 2023.4.7 → 2023.4.10 → 2023.4.13 (2022.10.10 - 2022.10.11) → 2023.4.7 → 2023.4.10 → 2023.4.13 (2022.10.12 - 2022.10.13) → 2023.4.10 → 2023.4.13 2022.10.14 → 2023.4.13	✅ (2022.10.0 - 2022.10.9) → 2023.10.2 → (2023.10.4 - 2023.10.5) → 2023.10.7 → 2023.10.9 → 2023.10.10 → 2023.10.12 (2022.10.10 - 2022.10.11) → 2023.10.5 → 2023.10.7 → 2023.10.9 → 2023.10.10 → 2023.10.12 (2022.10.12 - 2022.10.13) → 2023.10.7 → 2023.10.9 → 2023.10.10 → 2023.10.12 2022.10.14 → 2023.10.9 → 2023.10.10 → 2023.10.12	(2022.10.0 - 2022.10.9) → 2023.10.2 → 2024.10.3 → 2024.10.8 → 2024.10.9 (2022.10.10 - 2022.10.11) → 2024.10.3 → 2024.10.8 → 2024.10.9 (2022.10.12 - 2022.10.13) → 2024.10.6 → 2024.10.9 (2022.10.14 - 2022.10.15) → 2024.10.7 → 2024.10.9	(2022.10.0 - 2022.10.9) → 2023.10.2 → 2024.10.3 → 2.2510.2 → 2.2510.3 (2022.10.10 - 2022.10.11) → 2024.10.3 → 2.2510.2 → 2.2510.3 (2022.10.12 - 2022.10.13) → 2024.10.6 → 2.2510.3 (2022.10.14 - 2022.10.15) → 2.2510.1 → 2.2510.3
2023.4.x	S/O	✅ (2023.4.0 - 2023.4.4) → 2023.4.5 (2023.4.5 - 2023.4.6) → (2023.4.7 - 2023.4.8) → (2023.4.9 - 2023.4.10) → 2023.4.13 2023.4.11 → 2023.4.13	✅ (2023.4.0-2023.4.4) → 2023.10.2 → (2023.10.4 - 2023.10.5) → 2023.10.7 → 2023.10.9 → 2023.10.10 → 2023.10.12 (2023.4.5 - 2023.4.6) → (2023.10.4 - 2023.10.5) → 2023.10.7 → 2023.10.9 → 2023.10.10 → 2023.10.12 (2023.4.7 - 2023.4.8) → 2023.10.7 → 2023.10.9 → 2023.10.10 → 2023.10.12 (2023.4.9 - 2023.4.10) → 2023.10.7 → 2023.10.9 → 2023.10.10 → 2023.10.12 (2023.4.11 - 2023.4.13) → 2023.10.10 → 2023.10.12	(2023.4.0-2023.4.4) → 2023.10.2 → 2024.10.3 → 2024.10.8 → 2024.10.9 (2023.4.5 - 2023.4.6) → 2024.10.3 → 2024.10.8 → 2024.10.9 (2023.4.7 - 2023.4.8) → 2024.10.6 → 2024.10.9 (2023.4.9 - 2023.4.10) → 2024.10.7 → 2024.10.9 (2023.4.11 - 2023.4.13) → 2024.10.8 → 2024.10.9	(2023.4.0-2023.4.4) → 2023.10.2 → 2024.10.3 → 2.2510.2 → 2.2510.3 (2023.4.5-2023.4.6) → 2024.10.3 → 2.2510.2 → 2.2510.3 (2023.4.7-2023.4.8) → 2024.10.6 → 2.2510.3 (2023.4.9 - 2023.4.10) → 2.2510.1 → 2.2510.3 (2023.4.11 - 2023.4.13) → 2.2510.2 → 2.2510.3
2023.10.x	S/O	S/O	✅ (2023.10.0 - 2023.10.3) → (2023.10.4 - 2023.10.5) → (2023.10.6 - 2023.10.7) → (2023.10.8 - 2023.10.9) → 2023.10.10 → 2023.10.12	✅ (2023.10.0 - 2023.10.1) → (2023.10.2 - 2023.10.3) → 2024.10.3 → 2024.10.8 → 2024.10.9 (2023.10.4 - 2023.10.5) → 2024.10.6 → 2024.10.9 (2023.10.6 - 2023.10.7) → 2024.10.7 → 2024.10.9 (2023.10.8 - 2023.10.9) → 2024.10.8 → 2024.10.9 (2023.10.10 - 2023.10.12) → 2024.10.9	(2023.10.0 - 2023.10.1) → (2023.10.2 - 2023.10.3) → 2024.10.3 → 2.2510.2 → 2.2510.3 (2023.10.4 - 2023.10.5) → 2024.10.6 → 2.2510.3 (2023.10.6 - 2023.10.7) → 2.2510.1 → 2.2510.3 (2023.10.8 - 2023.10.9) → 2.2510.2 → 2.2510.3 (2023.10.10 - 2023.10.12) → 2.2510.3
2024.10.x	S/O	S/O	S/O	✅ (2024.10.0 - 2024.10.3) → 2024.10.8 → 2024.10.9 (2024.10.4 - 2024.10.8) → 2024.10.9	✅ (2024.10.0 - 2024.10.3) → 2024.10.4 → 2.2510.3 (2024.10.4 - 2024.10.9) → 2.2510.3
2.2510.x	S/O	S/O	S/O	S/O	✅ Toute mise à niveau ultérieure est prise en charge.

Remarque :

• Dans certains cas, la mise à niveau d’Automation Suite nécessite de passer par une version intermédiaire ou d’ignorer complètement certaines versions, afin d’assurer le bon fonctionnement des composants internes. Le non-respect des instructions de mise à niveau présentées dans le tableau précédent peut entraîner une rétrogradation d’un composant interne ou une mise à niveau infructueuse de ces composants, ce qui conduira à un échec de la mise à niveau d’Automation Suite.
• Si vous prévoyez d’effectuer une mise à niveau à partir d’Automation Suite 2022.10 ou d’une version antérieure, et que Process Mining est activé, vous devez migrer les applications de processus vers la nouvelle disposition du graphique de processus avant de démarrer la mise à niveau.
• Si vous utilisez Active Directory (AD) et que vous prévoyez d’effectuer la mise à niveau vers 2023.4.0, nous vous recommandons fortement de passer directement à la version 2023.4.3, car les versions 2023.4.0, 2023.4.1 et 2023.4.2 sont affectées par un problème au niveau d’AD.
• Seules les mises à niveau vers Automation Suite 2023.10 et versions ultérieures exploitent le processus de mise à niveau simplifié.

Chemins de mise à niveau côte à côte

La matrice suivante montre les chemins de mise à niveau côte à côte disponibles pour les versions d'Automation Suite :

• ✅ : un chemin de mise à niveau côte à côte direct entre les versions est disponible ;
• ❌ : une mise à niveau côte à côte entre vos versions initiales et ciblées est impossible.
  Remarque :

  Nous vous conseillons fortement de passer à la version secondaire la plus récente d’Automation Suite. Cela vous permettra de profiter des dernières améliorations et garantira un fonctionnement fluide pour tous les composants internes.

Version initiale	Version ciblée
	2021.10.x	2022.4.x	2022.10.x	2023.4.x	2023.10.x	2024.10.x	2.2510.x
2021.10.x	❌	❌	❌	❌	❌	❌	❌
2022.4.x	S/O	❌	❌	❌	✅	✅	❌
2022.10.x	S/O	S/O	❌	❌	✅	✅	✅
2023.4.x	S/O	S/O	S/O	❌	✅	✅	✅
2023.10.x	S/O	S/O	S/O	S/O	✅	✅	✅
2024.10.x	S/O	S/O	S/O	S/O	S/O	✅	✅
2.2510.x	S/O	S/O	S/O	S/O	S/O	S/O	✅

Mettre à niveau les meilleures pratiques

Si vous pouvez apporter un environnement supplémentaire pour effectuer la mise à niveau, nous vous recommandons de choisir le chemin de mise à niveau côte à côte car il offre une approche de mise à niveau plus sécurisée et une restauration instantanée.

Si vous ne pouvez pas apporter d'environnement supplémentaire pour effectuer la mise à niveau, vous pouvez opter pour la mise à niveau sur place. Assurez-vous de suivre les meilleures pratiques de validation de mise à niveau.

Mettre à niveau les meilleures pratiques de validation

Environnements (Environments)

Nous recommandons de préparer deux environnements Automation Suite similaires, que vous souhaitiez utiliser la mise à niveau sur place ou côte à côte :

• Cluster multi-nœuds Automation Suite pour le développement ou l'AQ

  Remarque :

  L’environnement de développement/AQ n’a pas besoin d’être en ligne tout le temps s’il n’est pas utilisé pour autre chose que la validation de la mise à niveau.

• Cluster multi-nœuds Automation Suite pour la production

Sauvegarde

Il est fortement recommandé de créer une sauvegarde du cluster et de la base de données SQL avant de mettre à niveau Automation Suite. Cela permet de garantir que vous pouvez restaurer le cluster en cas de problème lors de l'opération de mise à niveau.

Les données du cluster sont sauvegardées sur le serveur NFS. Assurez-vous d'avoir configuré le serveur NFS avant de continuer.

Important :

Les tables de base de données Automation Suite très volumineuses peuvent entraîner beaucoup plus de temps ou ne pas se terminer lors de la mise à niveau. Le fait de bien gérer les tables de base de données réduit ce risque.

Nous vous recommandons d’archiver ou de supprimer les données qui ne sont plus nécessaires dans les tables à volume élevé avant de démarrer la mise à niveau; pour de plus amples informations, consultez la section Effectuer la maintenance de la base de données.

Authentification

Assurez-vous de copier la valeur de global.userInputs.identity.krb5KeytabSecret dans global.kerberosAuthConfig.userKeytab si vous remplissez simultanément les conditions suivantes :

• Vous avez configuré l'intégration d'Active Directory à l'aide d'un nom d'utilisateur et d'un mot de passe ;
• L'authentification Windows est activée ;
• Vous n'utilisez pas l'authentification intégrée SQL.

Meilleures pratiques de validation d'automatisation

Pour valider les automatisations que vous avez générées, créez des organisations ou des locataires distincts directement dans votre environnement de production Automation Suite, car il s'agit de la solution la plus rentable. Pour plus de bonnes pratiques, reportez-vous à Orchestrator - Meilleures pratiques d'automatisation.

Validation de version

Pour valider vos automatisations dans différents environnements et versions, exploitez votre deuxième cluster Automation Suite après avoir installé le nouveau cluster Automation Suite, mais avant de basculer le trafic vers le nouveau cluster en production.

Licences

La mise à niveau vers une nouvelle version d'Automation Suite ne nécessite pas de licence supplémentaire, quel que soit le chemin de mise à niveau que vous choisissez. Cependant, si vous suivez nos meilleures pratiques et utilisez deux clusters Automation Suite (un pour QA/dev et un autre pour production), vous avez besoin d'une licence par cluster.