Mise à jour automatique des composants clients

À propos

Cette fonctionnalité permet aux administrateurs de mettre à jour les clients Robot, Studio et UiPath® Assistant vers des versions plus récentes à partir d’Orchestrator. Cela offre un moyen simple de permettre la mise à jour de version d’un nombre important de machines à partir d’un emplacement centralisé, aidant à éliminer les frictions des utilisateurs et à simplifier le processus de mise à jour.

Remarque : la fonctionnalité de mise à jour automatique des composants clients ne fonctionne que pour la mise à jour des produits Robot, Studio et UiPath Assistant déjà installés vers une version plus récente. Si une rétrogradation de version est nécessaire, le processus de rétrogradation doit être effectué manuellement ou à l'aide d'outils indépendants d'UiPath.

Prérequis

1. Orchestrator, Studio et Robot 2021.10 ou version ultérieure.
2. Studio et/ou Robot 2021.10 ou version ultérieure installés sur la machine cliente et connectés à Orchestrator.

Composants qui participent au processus de mise à jour

Côté client

• Applications clientes :

  • Robot
  • Assistant
  • Studio
• Service de robots
• Agent de mise à jour : un processus Windows responsable de la communication entre l'utilisateur et le service de mise à jour. (présent uniquement dans le mode utilisateur et l'installation du robot assisté)
• Service de mise à jour - un service Windows responsable de la communication entre la machine du client et le serveur de mise à jour.

Côté serveur

• Orchestrator : fournit l'interface utilisateur permettant aux administrateurs de définir des politiques de mise à jour automatique et d'afficher l'état de la version des applications clientes.
• Serveur de mise à jour : un service centralisé chargé de gérer les politiques de mise à jour automatique et de maintenir la communication avec les machines clientes via le service de mise à jour.

Mode de fonctionnement

En tant qu'administrateur, vous pouvez choisir la version spécifique à déployer sur une machine spécifique.

Pour que cela se produise, lorsque Studio et le Robot sont installés, deux exécutables sont également ajoutés à la machine : UiPath.UpdateService.Worker.exe et UiPath.UpdateService.Agent.exe.

Selon le type d’installation de Studio/du Robot, ils sont exécutés de manière différente :

• Unattended Robot : UiPath.UpdateService.Worker.exe est installé en tant que service Windows, tandis que UiPath.UpdateService.Agent.exe n’est pas installé.
• Attended Robot : UiPath.UpdateService.Worker.exe est installé en tant que service Windows, tandis que UiPath.UpdateService.Agent.exe est installé en tant que tâche de connexion dans le planificateur de tâches.
• Installation rapide (mode utilisateur) : UiPath.UpdateService.Worker.exe et UiPath.UpdateService.Agent.exe sont installés en tant que tâches de connexion dans le planificateur de tâches.
  Important : lors de l'installation d'UiPath Studio et du Robot sur la machine en mode Attended User, pour que le service de mise à jour se connecte au serveur de mise à jour, assurez-vous d'ajouter l'URL d'Orchestrator lors de l'installation. Si l'URL d'Orchestrator n'est pas ajoutée lors de l'installation, un utilisateur disposant de droits d'administrateur sur la machine doit s'y connecter et connecter le Robot à Orchestrator.

Lorsqu'une nouvelle politique est définie ou modifiée, le serveur de mise à jour envoie une commande au service de mise à jour sur la machine cliente, qui demande aux applications clientes si elles sont prêtes à démarrer le processus de mise à jour.

Pour être prêt à recevoir une mise à jour, un produit doit être dans un état neutre :

• Studio - pas de processus en cours ni de sessions actives.
• Robot - pas de tâches ou de processus en cours d'exécution.
• Assistant - pas de processus en cours d'exécution ni d'activités en attente (processus d'installation ou de téléchargement).
  Remarque : Pendant le processus de mise à jour, le Robot ne démarre aucune tâche tant que la mise à jour n'est pas terminée.

Dans le scénario Attended, une invite de mise à jour s'affiche, proposant à l'utilisateur deux options :

• Update Now : arrête toutes les tâches en cours d'exécution et ferme toutes les instances Studio sur cette machine, puis procède à la mise à jour.
• Later - coupe le son de la notification et le processus de mise à jour peut être repris en accédant à l'icône de l'interface utilisateur dans la barre d'état système et en cliquant sur vérifier les mises à jour (check for updates).

  Lorsque l'utilisateur accepte l'invite, la confirmation est envoyée au service de mise à jour et le processus de mise à jour démarre. Si aucune réponse n'est fournie dans les 24 heures suivant la première notification, la mise à jour est installée automatiquement.

Dans le scénario Unattended, le service de mise à jour confirme que l'application cliente est dans un état neutre (comme décrit ci-dessus) avant de renvoyer la confirmation au serveur de mise à jour.

Remarque :

• Si des processus sont en cours d’exécution sur la machine, l’utilisateur Robot est invité soit à arrêter le processus, soit à attendre qu’il se termine avant que la mise à jour puisse continuer. Si une session Studio est ouverte, l’utilisateur Robot est invité à enregistrer sa progression.
• Si l’utilisateur Robot ne réagit pas, Studio se ferme et enregistre le processus tel quel à ce moment-là. Le processus peut être récupéré une fois la mise à jour terminée.
• Si une certaine limite de temps est atteinte, le Robot en mode Service force une mise à jour même si une tâche est toujours en cours d’exécution. En raison de ce comportement, la tâche peut échouer. Le temps d’attente par défaut est de :
  • 10 minutes pour les Robots en mode Service.
  • 1 440 minutes pour les Robots en mode Service.

Étapes du processus de mise à jour

Le processus de mise à jour est divisé en sept étapes :

1. Téléchargement
   • Le service de mise à jour vérifie le serveur de mise à jour toutes les trois heures pour une demande de mise à jour. Si la demande de mise à jour est reçue, le processus de mise à jour démarre le processus de téléchargement. Si le processus de téléchargement a démarré avec succès, la demande de mise à jour est ajoutée à la base de données du serveur de mise à jour avec le statut Downloading .
2. téléchargé
   • L'état Downloaded agit comme un marqueur, afin que le service de mise à jour puisse démarrer la phase de post-traitement. Cet état marque le fait que le fichier de mise à jour a été téléchargé avec succès.
3. Traitement
   • Cette étape gère le post-traitement du fichier téléchargé. Dans cette étape, le fichier est vérifié et si aucune erreur n'apparaît, le processus d'installation démarre.
4. Prêt à installer
   • L'agent de mise à jour informe l'utilisateur qu'une mise à jour est en attente d'installation et demande l'approbation ou vérifie si les applications clientes sont prêtes à recevoir la mise à jour.
5. Installation approuvée
   • Une fois l'approbation reçue par le service de mise à jour, l'installation proprement dite démarre.
6. Installation en cours
   • La nouvelle version est installée sur la machine en conservant les mêmes paramètres que la version précédente.
7. Succès / Erreur
   En fonction du résultat de l'installation, l'état de la mise à jour est renvoyé au serveur de mise à jour.

   Remarque : si l' extension Chrome était déjà installée sur la machine robot, la fonctionnalité de mise à jour automatique la met également à jour. Sinon, l'extension doit être installée manuellement.

Mécanisme de nouvelle tentative

Pendant le processus de mise à jour, si le fichier ne peut pas être récupéré lors du premier téléchargement, le service de mise à jour réessaye trois fois. Les intervalles entre les tentatives sont les suivants : une heure après la tentative d'origine, puis deux heures après la première nouvelle tentative, et quatre heures après la dernière tentative. Avant chaque nouvelle tentative, l'utilisateur est informé via le système de notification.

Pour chaque tentative de téléchargement, les journaux sont ajoutés aux journaux de mise à jour d'Orchestrator, et localement sur la machine dans le fichier %localappdata%/Uipath/UpdateService/logs.

Le processus est similaire pour l'installation, ce qui signifie que si la première installation échoue, le service de mise à jour réessaye trois fois avec la même fréquence (une heure après la tentative initiale, puis deux heures après la première nouvelle tentative et quatre heures après la dernière tentative).

Le serveur de mise à jour attend 72 heures que la mise à jour se termine à partir de son démarrage. Si la nouvelle version n'est pas installée après l'expiration de cet intervalle, une erreur détaillée est ajoutée aux journaux. La mise à jour est réessayée la prochaine fois qu'une demande est reçue.

Vous pouvez également réessayer manuellement la mise à jour à l'aide du bouton si la mise à jour automatique a échoué.

Déploiements de robots en mode service ou en mode utilisateur

Les aspects techniques côté serveur sont identiques pour les déploiements en mode service et en mode utilisateur, car ils utilisent le même type de connexion entre le serveur de mise à jour et le service de mise à jour. La différence réside dans la façon dont le service de Robot communique avec le service de mise à jour sur la machine client, comme expliqué ci-dessous.

Mode de service

Dans les déploiements en mode service, le service de robot et le service de mise à jour s'exécutent tous deux dans la session de compte du système local.

Mode utilisateur

Dans les déploiements en mode utilisateur, le service de robot s'exécute dans la session utilisateur et le service de mise à jour s'exécute dans la session du compte du système local.

Important : Lorsque Robot et Studio sont déployés en mode utilisateur, l'envoi de la commande de mise à jour à un Robot sur la machine affecte tous les utilisateurs sur cette machine spécifique.

Avertissement : Une fois le processus de mise à jour terminé, Studio et Robot doivent être démarrés manuellement.

Configuration des politiques

Des politiques peuvent être définies pour des utilisateurs, des groupes d'utilisateurs (recommandé pour les cas d'utilisation Attended) ou des machines (recommandé pour les cas d'utilisation Unattended).

Configuration des politiques pour les utilisateurs/groupes d'utilisateurs

La configuration des politiques de mise à jour pour les utilisateurs ou les groupes d'utilisateurs permet aux administrateurs de contrôler la version Studio, Robot et Assistant pour un utilisateur ou un groupe d'utilisateurs spécifique.

• Utilisateur spécifique - pour mettre à jour de manière précise les composants liés à un utilisateur spécifique.

• Groupe d'utilisateurs - pour mettre à jour l'accès à tous les membres du groupe sans avoir besoin de définir le niveau d'accès pour chaque utilisateur individuellement.

  Important : pour les utilisateurs auxquels la licence Automation Express a été attribuée, la stratégie de mise à jour ne peut pas être modifiée et est définie pour fournir la dernière version Enterprise.

Les politiques sont configurées en modifiant un utilisateur ou un groupe spécifique à partir de l'onglet Gérer l'accès (Manage Access) dans Orchestrator.

1. Accédez à Locataire (Tenant) > Gérer l'accès (Manage Access). La fenêtre Utilisateurs (Users) s'affiche.
2. Pour l'utilisateur/groupe d'utilisateurs souhaité, cliquez sur Modifier (Edit). La fenêtre Modifier un utilisateur (Edit User) s'affiche.
3. Dans la section Paramètres de politique de mise à jour (Update policy settings), remplacez la politique de mise à jour automatique par l'une des valeurs suivantes :

Par utilisateur

Par groupe

Remarque :

Si la politique appliquée à l'utilisateur est définie sur None, mais qu'elle fait également partie d'un groupe doté d'un ensemble de politiques spécifique (par exemple Dernier correctif), la politique de groupe s'applique. Si vous souhaitez que les composants de cet utilisateur spécifique ne soient pas mis à jour, vous devez soit les supprimer du groupe qui possède la politique, soit définir la politique de mise à jour pour qu'elle corresponde à la version actuelle installée.

Si l'utilisateur a une politique définie pour transmettre une version spécifique et qu'il fait également partie d'un groupe qui a une politique différente, la politique au niveau de l'utilisateur est prioritaire.

Objets par machine

La configuration d'une politique de mise à jour pour les objets machine permet aux Administrators de mettre à jour les versions du Robot sur toutes les machines connectées à Orchestrator à l'aide d'une clé de machine spécifique.

Pour configurer les politiques de mise à jour des objets machine, suivez les étapes ci-dessous :

1. Accédez à Locataire (Tenant) > Machines. La fenêtre Machines s'affiche
2. Pour l'objet machine souhaité, cliquez sur Modifier (Edit). La fenêtre Modifier la machine (Edit Machine) s'affiche.
3. Accédez à l'onglet Maintenance. Le menu de configuration Mise à jour automatique (Auto Update) s'affiche.
4. Configurez la stratégie de mise à jour.
   

Remarque : Erratum - 28 avril 2023

Pour activer cette fonctionnalité, vous devez ajouter le paramètre Features.MachineMaintenanceSchedule.Enabled au fichier UiPath.Orchestrator.dll.config et le définir sur true.

Planification de la mise à jour automatique

À partir de l'onglet Maintenance, vous pouvez également planifier la mise à jour de sorte qu'elle démarre à une certaine heure et date pour correspondre aux autres fenêtres de maintenance de votre entreprise. Vous pouvez également définir la durée de la fenêtre de maintenance. Si le délai défini pour la fenêtre de maintenance s'est écoulé et que la mise à jour n'a pas démarré, celle-ci est planifiée au cours du prochain intervalle disponible.

Priorité de la politique

Dans le cas où une politique au niveau de l'utilisateur, une politique au niveau du groupe et une politique au niveau de la machine s'appliquent au même Robot, la politique au niveau de l'utilisateur prévaut.

Exemple :

• Machine_1 a une version 2021.10 de Robot et Studio installée.
• Sur machine_1, le robot est connecté à Orchestrator via la connexion interactive avec l'utilisateur [e-mail].
• Une politique de mise à jour s'applique à [e-mail], qui est configurée afin de lui transmettre la version 2021.10.2.
• [e-mail] fait également partie de group_1.
• Une politique de mise à jour s'applique à group_1, qui est configuré pour transférer la version 2021.10.3.

• Une politique de mise à jour s'applique à machine_1 qui est configurée pour transmettre la version 2022.4 .

  Résultat : lorsque les politiques de mise à jour se déclenchent, les composants de cette machine sont mis à jour vers la version 2021.10.2.

  Remarque : Lorsque vous utilisez des comptes Robot, veuillez noter que la politique au niveau de la machine est utilisée pour gérer la mise à jour.

Disponibilité des versions dans les politiques

Lors de la création d'une politique de mise à jour, vous pouvez choisir l'une des options suivantes :

Dernière version majeure	Dernier correctif	Patch spécifique
Installe la dernière version disponible trouvée sur le serveur de mise à jour.	Installe le dernier correctif disponible pour chacune des versions prises en charge. (par exemple, Dernier correctif 2021.10, Dernier correctif 2022.4).	Installe un correctif spécifique à partir de la liste de ceux disponibles dans le serveur de mise à jour.

Journaux de mise à jour

Dans l'interface utilisateur d'Orchestrator, les journaux de mise à jour sont disponibles pour les mises à jour ayant échoué et réussies. Les journaux complets de la mise à jour se trouvent sur la machine dans le fichier %localappdata%/Uipath/UpdateService/logs .

Avertissement :

Lorsque les robots sont déployés sur des environnements virtuels où les machines sont clonées, le nom de la machine, le guid, l'ID de lecteur et l'adresse mac sont les mêmes. Cela peut provoquer des conflits car Orchestrator reçoit des statuts de mise à jour différents de plusieurs machines avec les mêmes identifiants.

Dans ce scénario, le statut de mise à jour dans Orchestrator est affiché en fonction de la dernière machine qui s'est connectée.

Cela peut également avoir un impact sur les journaux d'Orchestrator, car si plusieurs machines ont les mêmes identifiants, des journaux peuvent apparaître en double.

Statuts des versions

La colonne Statut de version (Version status) vous permet de vérifier l'état de la version du Robot pour vos machines par rapport à la politique associée.

Les valeurs suivantes sont disponibles :

• Aucune politique - aucune politique n'est définie
• Mise à jour en cours (Update in progress) : Ce statut est présenté lorsque le processus de mise à jour est en cours sur la machine
• Conforme : la version du robot sur la machine correspond à la politique de mise à jour.
• Non conforme (Non compliant) - la version du robot sur la machine est différente de celle qui a été configurée dans la stratégie. (par exemple, la version du robot est 2021.10.3, la politique est configurée comme 2021.10.1)
• Échec de la mise à jour (Update failed) - ce statut s'affiche lorsque le processus de mise à jour a échoué. Vous trouverez plus de détails dans les journaux de mise à jour.
• N/A : ce statut s'affiche lorsque le paramètre permettant d'exclure les machines inactives est activé et que le robot n'a pas été connecté depuis un certain temps, ou lorsque le type de machine n'est pas compatible avec le processus de mise à jour automatique.

Statut de la version pour les machines

La colonne Statut de version (Version status) de l'onglet Machines d'Orchestrator (Orchestrator Machines) vous permet de vérifier le statut de la version du Robot pour vos machines par rapport à la politique associée.

Important : Les Robots Linux ne sont pas compatibles avec la fonctionnalité de mise à jour automatique. Pour ceux-ci, le statut de la version affiche N/A avec l’info-bulle « La mise à jour automatique ne s’applique pas à ce type de machine ».

Exclusion des machines inactives

Si plusieurs machines sont connectées à Orchestrator à l'aide de la même clé et que l'une d'entre elles est inactive, le statut de la version du modèle de machine devient Non compliant. Cela se produit lorsque le modèle de machine communique avec le serveur de mise à jour à l'aide de la même clé de machine, et si l'une des machines connectées ne peut pas recevoir de mise à jour, le statut général du modèle de machine est affecté.

Pour éviter cela, accédez à la section Général (General) du menu Paramètres (Settings) dans le contexte du locataire, cochez la case Binaires client (Client Binaries) et définissez l'intervalle d'inactivité de votre choix. Cela exclut les machines inactives du processus de mise à jour et ne les prend plus en compte lorsque le statut de mise à jour est signalé.

Statut de la version pour les utilisateurs

La colonne Statut de versions de l’onglet Sessions utilisateur dans la fenêtre Surveillance vous permet de vérifier le statut de la version du composant client pour vos utilisateurs par rapport à la politique associée.

Gestion des versions de mise à jour

Si votre instance Orchestrator dispose d’un accès Internet, par défaut, la gestion des versions est effectuée par UiPath et la liste des versions disponibles dans les stratégies est automatiquement renseignée. Si vous souhaitez gérer manuellement les versions, accédez à Paramètres (Settings) au niveau de l’hôte, sélectionnez Général (General) et décochez la case Remplissage automatique des versions de produit disponibles (Auto-fill available product versions).

Si vous choisissez de ne pas confier la gestion des versions à UiPath, ou si votre instance d'Orchestrator n'a pas accès à Internet, vous devez télécharger manuellement les programmes d'installation des composants clients depuis le UiPath Customer Portal – page Téléchargements de produits (Product Downloads) et les charger sur le serveur de mise à jour à l'aide de étapes ci-dessous :

1. Obtenez le -InstallationToken à partir d'Identity Server en suivant les étapes décrites dans Jeton d'accès de l'installation (Installation Access Token).
2. Pour définir les valeurs de ClientId et ClientSecret, exécutez le script ci-dessous :
   Remarque :

   Les scripts nécessaires pour les commandes ci-dessous se trouvent dans le dossier d'installation (le chemin par défaut est C:\Program Files (x86)\UiPath\Orchestrator\Tools\UpdateServerScripts) sur la machine Orchestrator.

   Les versions de produits prises en charge à utiliser dans les scripts sont disponibles sur la page de documentation Cycle de vie du produit . Pour les scripts de mise à jour, le format court de la version est utilisé (par ex. 22.4.3 au lieu de 2022.4.3).

   .\Provision-IdentityClient.ps1 -IdentityUri "<IDENTITY_URL>" -InstallationToken "<INSTALLATION_TOKEN>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"

   Les valeurs définies pour ClientId et ClientSecret seront utilisées ultérieurement lors de l’appel du script Product-Versions.ps1

Obtenir les versions disponibles

.\Product-Versions.ps1 get -ApiBaseUri "<ORCHESTRATOR_URL>" -IdentityUri "<IDENTITY_URL>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"

Publier une nouvelle version sur le serveur de mise à jour

.\Product-Versions.ps1 register -ApiBaseUri "<ORCHESTRATOR_URL>" -IdentityUri "<IDENTITY_URL>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>" -ProductId "b69fdacf-6dd0-46fb-88c7-af2d87caf5aa" -Version "<NEW_VERSION>" -DownloadUri "<DOWNLOAD_URL>".\Product-Versions.ps1 register -ApiBaseUri "https://intranet/orchestrator_" -IdentityUri "https://intranet/identity_" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>" -ProductId "b69fdacf-6dd0-46fb-88c7-af2d87caf5aa" -Version "22.4.3" -DownloadUri "https://download.uipath.com/versions/22.10.3/UiPathStudio.msi"

Supprimer une version spécifique du serveur de mise à jour

DELETE
.\Product-Versions.ps1 delete -ApiBaseUri "<ORCHESTRATOR_URL>" -IdentityUri "<IDENTITY_URL>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>" -ProductId "b69fdacf-6dd0-46fb-88c7-af2d87caf5aa" -Version "<NEW_VERSION>"

Publier une nouvelle version sur la machine cliente

.\Provision-IdentityClient.ps1 -IdentityUri "<IDENTITY_URL>" -InstallationToken "<INSTALLATION_TOKEN>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"

En fonction des exigences, les ID de produit suivants peuvent être utilisés dans les scripts :

IDProduit	Produit
FD97813F-44F7-45A0-BB55-0DAF0088F568	Assistant UiPath pour Mac (x64)
46C978F2-A5FE-4F71-AD88-D6A07118F790	Assistant UiPath pour Mac (arm64)
B69FDACF-6DD0-46FB-88C7-AF2D87CAF5AA	Bundle d'automatisation UiPath (UiPathStudio.msi)

Configuration du proxy

Pour les scénarios dans lesquels les robots sont assis derrière un proxy, pour que la fonctionnalité de mise à jour automatique fonctionne, une configuration supplémentaire peut être nécessaire. En fonction du type d'installation, les configurations de proxy peuvent être héritées des paramètres de proxy au niveau de l'utilisateur ou définies manuellement en modifiant le fichier de configuration.

Type d'installation	Déploiement du Robot	Service de mise à jour	Agent de mise à jour	Paramètres du proxy
Unattended Robot	Service Windows	Service Windows	S/O 1	À partir du fichier uipath.config .
Robot assisté (Attended Robot)	Exécutable au niveau utilisateur	Service Windows	Exécutable au niveau utilisateur	À partir du fichier uipath.config .
Installation rapide	Exécutable au niveau utilisateur	Exécutable au niveau utilisateur	Exécutable au niveau utilisateur	À partir des paramètres de proxy au niveau de l'utilisateur.

1 lorsque le Robot est installé en mode Unattended, l'agent de mise à jour n'est pas ajouté à la machine.

Collecte des journaux d'erreurs

Lorsqu'une mise à jour échoue, vous pouvez utiliser l' outil de diagnostic pour collecter des journaux qui peuvent être envoyés à notre équipe d'assistance et utilisés pour une enquête plus approfondie sur l'erreur spécifique.

Message d'erreur

Configuration de l'outil de diagnostic