Exécution de la mise à niveau

Important :

Pour effectuer une mise à niveau d'Automation Suite, vous devez mettre le cluster en mode de maintenance. Le mode de maintenance entraîne des temps d'arrêt pendant tout le processus de mise à niveau, et votre automatisation métier est suspendue pendant ce temps.

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

Pour exécuter la mise à niveau, vous devez procéder comme suit :

1. Exécutez les vérifications des prérequis.
2. Configurez la sauvegarde.
3. Désactive la sauvegarde.
4. Mettez le cluster en mode maintenance.
5. Migrez les charges de travail Longhorn, les données MongoDB et Ceph vers un déploiement basé sur Helm.
6. Mettez à jour Kubernetes et d'autres composants d'infrastructure.
7. Installez les composants partagés et les services UiPath®.

Exécuter les vérifications des prérequis

Vous devez vérifier que toutes les exigences de mise à niveau sont remplies avant de mettre le cluster en mode de maintenance.

1. Exécutez les vérifications des prérequis de l'infrastructure à l'aide de la commande suivante :

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl rke2 prereq run cluster_config.json --versions versions/helm-charts.json

2. Exécutez les vérifications des prérequis des composants et des services partagés à l'aide de la commande suivante :

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl prereq run cluster_config.json --versions versions/helm-charts.json

Configuration de la sauvegarde

Pour configurer la sauvegarde, procédez comme suit :

1. Assurez-vous d'avoir activé la sauvegarde sur le cluster. Vous devez créer la sauvegarde à l'aide de la même version du programme d'installation que celle que vous avez utilisée pour le déploiement actuel. Pour obtenir des instructions, consultez la documentation de sauvegarde et de restauration correspondant à la version d'Automation Suite à partir de laquelle vous prévoyez d'effectuer la mise à niveau. Par exemple, si vous prévoyez d'effectuer une mise à niveau à partir d'Automation Suite 2023.4, suivez les instructions du guide 2023.4.
2. Connectez-vous à un des nœuds du serveur via SSH.
3. Vérifiez que tous les volumes souhaités ont des sauvegardes dans le cluster :

   • Si vous effectuez une mise à niveau à partir de la version 2022.4 ou d'une version antérieure, exécutez la commande suivante :

     /path/to/old-installer/configureUiPathAS.sh verify-volumes-backup

   • Si vous effectuez une mise à niveau depuis la version 2022.10 ou une version plus récente, exécutez la commande suivante :

     ./configureUiPathAS.sh snapshot list

   • Si vous effectuez une mise à niveau depuis la version 2024.10 ou une version plus récente, exécutez la commande suivante :

     ./bin/uipathctl snapshot list

   Remarque : la sauvegarde peut prendre un certain temps, attendez environ 15 à 20 minutes, puis vérifiez à nouveau la sauvegarde des volumes.

Une fois la sauvegarde créée, passez aux étapes suivantes.

Remarque :

Veillez à bien utiliser la commande uipathctl à partir du répertoire de la version cible lorsque vous effectuez une mise à niveau à partir de la version 23.10.0 ou de versions ultérieures.

Désactiver la sauvegarde

Avant de placer le cluster en mode maintenance, vous devez désactiver la sauvegarde pour éviter de sauvegarder le cluster dans un état sous-optimal. Pour plus de détails, consultez la section Désactivation de la sauvegarde d’instantané.

Mettre le cluster en mode maintenance

Mettre le cluster en mode maintenance arrête le contrôleur d’entrée et tous les services UiPath®, bloquant ainsi tout le trafic entrant vers le cluster Automation Suite.

1. Pour mettre le cluster en mode maintenance, exécutez :

   ./bin/uipathctl cluster maintenance enable

2. Pour vérifier que le cluster est en mode maintenance, exécutez :

   ./bin/uipathctl cluster maintenance is-enabled

Migration des charges de travail Longhorn, des données MongoDB et de Ceph vers un déploiement basé sur Helm

Exécutez la commande de pré-mise à niveau obligatoire suivante :

./bin/uipathctl cluster pre-upgrade cluster_config.json --versions-dir ./versions

Cette commande migre de manière sélective les charges de travail Longhorn vers un PV local, les données MongoDB vers SQL et migre le déploiement Ceph depuis ArgoCD vers un déploiement basé sur Helm.

Mise à jour de Kubernetes et d'autres composants d'infrastructure

Pour mettre à niveau Kubernetes et les autres composants de l'infrastructure, exécutez la commande suivante sur le nœud du serveur principal :

Important :

Assurez-vous d'avoir mis à jour le fichier cluster_config.json généré tel que décrit dans Mise à jour de la configuration du cluster.

cd /opt/UiPathAutomationSuite/latest/installer

./bin/uipathctl rke2 upgrade cluster_config.json --versions versions/helm-charts.json

Remarque :

• L'exécution de la commande précédente sur le nœud du serveur principal copie le programme d'installation et cluster_config.json dans l'emplacement par défaut /opt/UiPathAutomationSuite/<version>/installer et met à niveau l'infrastructure sur toutes les machines.
• L'emplacement /opt/UiPathAutomationSuite/<version> par défaut doit avoir au moins 5 Go de disponibles sur tous les nœuds.

• Pour modifier l'emplacement par défaut, mettez à jour la variable d'environnement suivante avec l'emplacement souhaité. Assurez-vous que l'emplacement est disponible sur tous les nœuds et dispose des autorisations requises pour exécuter la mise à niveau.

  export INSTALLER_DIRECTORY=/path/to/copy/installer

• Après avoir exécuté la commande précédente et exécuté la mise à niveau, le programme d'installation est copié à l'emplacement /path/to/copy/installer/<version>/installer. version est remplacé par la version du programme d'installation que vous exécutez.

Résolution des problèmes

• Les journaux de mise à niveau sur le serveur principal sont disponibles à l'emplacement par défaut /opt/UiPathAutomationSuite/latest/installer/upgrade-logs, sauf si vous avez explicitement utilisé un emplacement personnalisé pour le programme d'installation.
• Sur tous les autres nœuds, les journaux sont disponibles à l'emplacement par défaut /opt/UiPathAutomationSuite/<version>/installer/upgrade-logs, sauf si vous avez explicitement modifié cet emplacement à l'aide de la variable INSTALLER_DIRECTORY.

Installation des composants partagés et des services UiPath®

1. Si Insights est activé, vous devez exécuter la commande suivante pour vous assurer que les données Insights sont conservées après la mise à niveau :

   kubectl -n uipath create cm migration-lock --from-literal=migration=pending --dry-run=client -o yaml | kubectl apply -f -

   Remarque :

   L'exécution de cette commande n'aura aucun impact négatif si Insights n'est pas activé.

2. Pour installer les composants partagés et les services de produits UiPath®, exécutez la commande suivante sur le nœud du serveur principal :

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl manifest apply cluster_config.json --versions versions/helm-charts.json

   Important :

   Une fois la mise à niveau terminée, le mode de maintenance est automatiquement désactivé.

3. Pour vérifier si Automation Suite est sain, exécutez l'une des commandes suivantes :

   cd /opt/UiPathAutomationSuite/latest/installer
   ./bin/uipathctl health check

   Remarque :

   Si vous ne trouvez pas helm-charts.json, vous pouvez également utiliser versions.json. Pour télécharger versions.json, consultez Téléchargement des packages d'installation.

Une fois la mise à niveau effectuée, effectuez l'activité de nettoyage et de migration qui vous est applicable.