Mettre à niveau Automation Suite

Mettez à niveau Automation Suite vers des versions plus récentes sur le cluster OpenShift.

Automation Suite consists of multiple components. Both you as a customer and UiPath® share responsibility of these components. For details, refer to Responsibility matrix.

Vous êtes responsable de la mise à niveau :

• Infrastructure Kubernetes dans laquelle Automation Suite est déployée (OpenShift)
• Les composants que vous choisissez d'apporter dans le cadre d'Automation Suite (par ex., Gatekeeper, FluentD, etc.)

UiPath® est responsable de la mise à niveau des éléments suivants :

• Services UiPath® (Orchestrator, par exemple)
• Composants déployés dans le cadre d' Automation Suite (par exemple, ArgoCD)

Mise à niveau des services et des composants UiPath®

Préparation

Remarque :

• If you upgrade to Automation Suite 2.2510, you need to bring a PostgreSQL database for AutomationSuite_Airflow and configure the connection string for it in input.json. For details, refer to Process Mining-specific configuration.
• Si vous effectuez une mise à niveau à partir de versions antérieures à la version 2.2510.0 en utilisant Studio Web, assurez-vous d'utiliser le même nom de classe de stockage que celui spécifié dans storage_class_single_replica, pour prendre en charge le mode d'accès RWX.

For details, refer to Configuring input.json.

En outre, consultez les conseils de maintenance de la base de données suivants avant de lancer la mise à niveau.

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.

We recommend archiving or purging data that is no longer needed from high-volume tables before starting the upgrade; for details, refer to Performing database maintenance.

Pour préparer la mise à niveau, procédez comme suit :

1. Check the compatibility matrix to determine the supported versions for each available upgrade scenario. If you brought your own components, make sure the versions of your components are compatible with the version you plan to upgrade to. For details, refer to Compatibility matrix.
2. Download versions.json and uipathctl for the version you want to upgrade to, on your management machine. For download instructions, refer to Downloading the installation packages.
3. Générez le dernier fichier input.json comme suit :
   • Option A : pour obtenir la dernière révision de votre fichier input.json , exécutez la commande suivante :

     uipathctl manifest get-revision --namespace <uipath>
     

   • Option B : pour répertorier tous les fichiers input.json précédents et déterminer celui que vous souhaitez choisir, exécutez la commande suivante :

     uipathctl manifest list-revisions --namespace <uipath>
     

4. If you are using an offline setup with an external OCI-compliant registry, you must hydrate the registry with container images and Helm charts before upgrade. For details, refer to Hydrating the registry with the offline bundle.
5. Si Process Mining est installé et que vous souhaitez utiliser la dernière version de Airflow qui a besoin de PostgreSQL, vous devez ajouter ou mettre à jour le modèle de chaîne de connexion sqlalchemy applicable pour PostgreSQL dans le fichier input.json avant la mise à niveau : postgresql_connection_string_template_sqlalchemy_pyodbc.

   postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/<airflow db name>
   

6. If you upgrade to Automation Suite 2.2510.0 or later from previous Automation Suite 2024.10 versions and have Studio Web enabled, you must also enable Solutions. For details, refer to Enabling or disabling Solutions. Make sure you also review the additional hardware requirements for Solutions. For details, refer to Capacity Planning.

Exécution

Pour effectuer une mise à niveau des services et des composants UiPath®, procédez comme suit :

1. Confirmez que votre cluster est sain :

   uipathctl health check --namespace <uipath> --versions versions.json
   

2. Mettez le cluster en mode maintenance pour garantir une sauvegarde cohérente :

   uipathctl cluster maintenance enable --namespace <uipath>
   

   Important :

   Cette opération entraîne des temps d'arrêt et l'automatisation de votre entreprise est suspendue lorsque le mode de maintenance est activé.

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

   uipathctl cluster maintenance is-enabled --namespace <uipath>
   

4. Sauvegardez le cluster et la base de données SQL, puis vérifiez que la sauvegarde s’est terminée correctement. Créez également une sauvegarde avant de mettre à niveau votre infrastructure Kubernetes.

   Si vous remplissez simultanément les exigences suivantes, assurez-vous de copier la valeur de global.userInputs.identity.krb5KeytabSecret dans global.kerberosAuthConfig.userKeytab:

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

5. Désactivez le mode maintenance :

   uipathctl cluster maintenance disable
   

   Remarque :

   Vous devez désactiver le mode de maintenance avant la mise à niveau. Le processus de mise à niveau d'Automation Suite ne prend pas en charge l'activation du mode de maintenance.

6. Effectuez la mise à niveau des services et composants UiPath® :

   uipathctl cluster upgrade input.json --versions versions.json
   

   Important :

   Cette opération entraîne des temps d'arrêt et l'automatisation de votre entreprise est suspendue pendant le processus de mise à niveau. Il est important que vous effectuiez la mise à niveau uniquement pendant votre période de maintenance.

7. Vérifiez que le cluster est sain après la mise à niveau :

   uipathctl health check --namespace <uipath> --versions versions.json
   

   Remarque :

   Si vous avez effectué une mise à niveau vers Automation Suite 2.2510 ou une version ultérieure, vous pouvez désinstaller Dapr et Cert Manager, si vous avez précédemment installé ces modules complémentaires pour Process Mining ou Task Mining. Pour de plus amples informations, reportez-vous aux sections et.

Mise à niveau de l'infrastructure Kubernetes

Remarque :

Automation Suite supports upstream N-1 to N-3 versions of Kubernetes irrespective of the cloud provider. For instance, if upstream is 1.27, we support versions 1.26, 1.25, and 1.24. For supported versions, refer to the Compatibility matrix.

Vous êtes responsable de la mise à niveau de l’infrastructure Kubernetes hébergeant Automation Suite. Vous devez suivre les pratiques standard de votre entreprise pour mettre à niveau l’infrastructure Kubernetes.

Exécution d'opérations post-mise à niveau

Les scénarios suivants décrivent les opérations post-mise à niveau requises pour votre environnement:

• Si vous avez effectué une mise à niveau vers Automation Suite 2.2510.0 ou une version plus récente, vous devez immédiatement réactiver vos licences existantes pour chaque organisation et hôte:

  • Activation en ligne : réactivez directement après la mise à niveau.
  • Activation hors ligne : générez un nouveau fichier de charge utile d'activation à partir de l'instance Automation Suite, puis téléchargez-le dans Activation.

  La réutilisation des anciens fichiers d’activation n’est pas autorisée et entraînera une licence non valide. La réactivation de la licence doit être effectuée à l'aide du bouton Mettre à jour la licence . Ne désactivez pas, puis réactivez manuellement la licence, car cela désactivera les services.