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 :

• la version précédente a été configurée à l'aide de Windows Installer  ;
• votre instance d'Orchestrator se trouve dans un environnement à nœuds multiples.
  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.

  • Avant la mise à niveau, veuillez visiter les pages Prérequis matériels (Hardware Requirements), Prérequis logiciels (Software Requirements) et prérequis (prerequisites), pour la version vers laquelle vous effectuez la mise à niveau, car elles ont peut-être changé. Vous devez vous assurer de répondre à toutes les exigences avant la mise à niveau.
  • 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é.
  • À partir de la version v2020.4, le certificat SSL d'Orchestrator est soumis à des exigences supplémentaires. Assurez-vous de remplir toutes les conditions préalables. Pour savoir comment modifier votre certificat, consultez la section Utiliser un certificat avec le protocole HTTPS
  • 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. 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.
3. 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

4. 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 administrateur au niveau de l'hôte et du locataire par défaut, ils ne sont pas pris en compte. Utilisez vos anciens mots de passe 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

Poursuivez l'installation comme expliqué ici.

Attention : 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 ]

Attention : 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.