Mise à jour à l'aide de Windows Installer

Avertissement :

Veuillez garder à l’esprit que ces informations concernent la version vers laquelle vous effectuez la mise à niveau, et non la version à partir de laquelle vous effectuez la mise à niveau. Veillez donc à prendre connaissance des informations adéquates avant de continuer.

Vue d'ensemble (Overview)

Le processus de mise à jour varie selon les cas suivants :

• the previous version was set up with the Windows installer;

• your Orchestrator instance is in a multi-node environment.

  Important :

  • 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.
  • Before upgrading, please visit the Hardware Reqirements, Software Reqirements and prerequisites pages, for the version you are upgrading to, as they may have changed. You need to ensure you meet all requirements prior to upgrade.
  • Après la mise à niveau, nous vous recommandons de redémarrer tous vos robots afin qu'ils appliquent les nouveaux paramètres.
  • Si vos paquets (activités et/ou workflows) sont stockés dans un dossier partagé, notez que le programme d'installation UiPathOrchestrator.msi requiert l'accès en écriture au répertoire susmentionné.
  • Starting with v2020.4, there are more requirements for the SSL certificate of Orchestrator. Make sure you meet all prerequisites. For how to change your existing certificate, see Using a Certificate for the HTTPS Protocol
  • Vérifiez à nouveau le chemin d’installation sélectionné. Le déplacement d’une installation vers un autre emplacement après l’installation n’est pas pris en charge.
  • Il est recommandé de conserver également le type d'identité précédent du pool d'applications Orchestrator pour Identity Server et les webhooks. Sinon, des problèmes pourraient survenir lors de l'accès au serveur SQL.
  • Si vous envisagez d'installer Insights, assurez-vous de sélectionner le rôle db_owner car cela est requis lorsque vous configurez la configuration Insights SQL Server.
  • Si vous effectuez une mise à niveau à partir d'une version antérieure à 2021.10 pour laquelle l'option Authentification Windows est sélectionnée, assurez-vous d'exécuter le programme d'installation en tant qu'utilisateur AD.

Version précédente installée avec Windows Installer

Pour mettre à jour Orchestrator à partir d'une version auparavant installée à l'aide de Windows Installer, effectuez les actions suivantes :

1. Sauvegardez vos packages d'automatisation, web.config et les fichier UiPath.Orchestrator.dll.config, et la base de données.

2. Téléchargez le fichier UiPathOrchestrator.msi depuis Customer Portal en sélectionnant votre version.

3. Exécutez le programme d'installation UiPathOrchestrator.msi. Orchestrator est installé avec le nom UiPathOrchestrator, la base de données est mise à jour et toutes vos données sont migrées. Vous pouvez également mettre à jour les paramètres d'Identity Server et du serveur de mise à jour à ce stade.

4. Si vous utilisez HAA pour la gestion du cache, videz toutes les clés du cache HAA à l'aide de la commande suivante : redis-cli -h <hostname> -p <portnumber> -a <password> flushall. Notez que HAA utilise par défaut le port 10000. Par exemple :

   redis-cli -h redis-12345.c24.us-east-mz-1.ec2.cloud.redislabs.com -p 10000 -a xyz flushall
   

5. Si vous utilisez Insights, assurez-vous de sauvegarder la base de données Insights avant la mise à niveau d’Orchestrator .

Environnement à plusieurs nœuds

Dans les environnements multi-nœuds, la mise à niveau s'effectue différemment sur les nœuds primaire et secondaire. Les étapes ci-dessous doivent être suivies pour mettre tous vos nœuds à jour.

Remarque :

Bien que vous fournissiez les mots de passe d'administrateur au niveau du locataire par défaut et de l'hôte, ils ne sont pas pris en compte. Utilisez vos mots de passe précédents pour vous connecter.

Fichiers de sauvegarde

Sauvegardez vos packages d'automatisation, web.config et les fichier UiPath.Orchestrator.dll.config, et la base de données.

Installation du nœud principal

Concernant l'installation assistée : s'exécute à partir de l'invite de commande d'administration à l'aide de la commande suivante :

UiPathOrchestrator.msi OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log

Concernant l'installation non assistée : s'exécute à partir de l'invite de commande d'administration à l'aide de la commande suivante :

UiPathOrchestrator.msi PUBLIC_URL=https://hostname.local APPPOOL_USER_NAME=serviceAccount APPPOOL_PASSWORD=pass OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log /Q

Follow through with the installation as described here.

Important :

N'oubliez pas de sauvegarder le fichier de configuration upgradeParams.json généré par l'installation. Il doit être utilisé pour les installations ultérieures de nœuds secondaires.

Installation des nœuds secondaires

Il est recommandé d'exécuter l'installation sans surveillance à l'aide du fichier de configuration upgradeParams.json produit sur le nœud principal. Exécutez la commande suivante depuis l'invite de commande d'administration :

UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log CONFIRM_BLOCK_CLASSIC_EXECUTIONS=1 /Q

Clés de nettoyage

Si vous utilisez HAA pour la gestion du cache, videz toutes les clés du cache HAA dans la base de données Active-Active à l’aide de la commande suivante :

crdb-cli crdb flush --crdb-guid <guid> [ --no-wait ]

Important :

Si vous souhaitez utiliser le type de licence Concurrent Runtime, veuillez noter que lors de la mise à jour à partir d'une version antérieure à v2020.4, si des robots haute densité sont configurés, le nombre de runtimes par machine est automatiquement configuré sur 1 et non sur le nombre total de robots présents sur cette machine.