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.

Les données du cluster sont sauvegardées sur le serveur NFS. Assurez-vous de configurer le serveur NFS avant de continuer.

Vous devez configurer la sauvegarde après avoir désactivé le mode de maintenance pour vous assurer que toutes les transactions sont effectuées.

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 :

   ./configureUiPathAS.sh enable-maintenance-mode

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

   ./configureUiPathAS.sh is-maintenance-enabled

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

   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.

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

./install-uipath.sh --upgrade -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k --accept-license-agreement

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 Gio 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.

Mise à jour des composants partagés et des services produit UiPath®

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

   ./install-uipath.sh --upgrade -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -f -s --accept-license-agreement

   Important :

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

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

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

   cd /opt/UiPathAutomationSuite/latest/installer/bin
   ./uipathctl health test --versions versions.json

   Remarque :

   Pour télécharger le fichier 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.