Mise à jour automatique des composants clients

Mettez à jour les clients Robot, Studio et UiPath Assistant vers des versions plus récentes à partir d'un emplacement Orchestrator centralisé.

À 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 du client ne fonctionne que pour la mise à jour des produits Robot, Studio et Assistant UiPath 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.
   Remarque :

   Pour activer la fonctionnalité de mise à jour automatique des composants du client pour Robot, vous devez installer l'application Robot en utilisant soit la version 2021.10 du programme d'installation UiPathStudio.msi ou une version ultérieure, soit la version 2024.10 du programme d'installation UiPathRobot.msi ou une version ultérieure. Les versions du programme d’installation UiPathRobot.msi antérieures à 2024.10 ne prennent pas en charge la mise à jour automatique des composants du client. Si vous avez installé Robot à l'aide du programme d'installation UiPathRobot.msi d'une version antérieure à 2024.10, vous pouvez mettre à jour manuellement l'application Robot à l'aide de la version 2024.10 du programme d'installation UiPathRobot.msi ou une version ultérieure.

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 utilisateur assisté, pour que le service de mise à jour se connecte au serveur de mise à jour, assurez-vous d'ajouter l'URL 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 se connecter à la machine 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 à temps, 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.
• Tous les Robots actifs au moment de la mise à jour sont mis en mode de maintenance, afin de s’assurer qu’ils n’effectueront aucune nouvelle tâche avant la fin de la mise à jour.
• Pour les Robots en mode utilisateur, un délai d’attente maximum de 1440 minutes est appliqué.

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

Figure 1. Diagramme des déploiements en mode service

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.

Figure 2. Diagramme des déploiements en mode utilisateur

Avertissement :

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

Niveaux de configuration de la politique

Les politiques de mise à jour automatique sont configurées dans Orchestrator à trois niveaux: utilisateur, groupe d'utilisateurs et machine. Chaque niveau contrôle la version qui est déployée dans l'étendue cible.

Important :

La mise à jour automatique est entièrement contrôlée via les politiques Orchestrator. Les paramètres d’installation lors de la configuration ne déterminent pas si ou comment fonctionne la mise à jour automatique. Si vous souhaitez empêcher la mise à jour automatique, vous devez configurer la stratégie dans Orchestrator (pas via le programme d'installation).

Configurer la mise à jour automatique pour les utilisateurs

La configuration des politiques de mise à jour pour un utilisateur spécifique vous permet de contrôler les versions de Studio, Robot et Assistant pour cette personne.

1. Accédez à l'onglet Locataire > Gérer l'accès > Règles d'accès .
2. Sélectionnez l’onglet Utilisateurs .
3. Sélectionnez Attribuer un utilisateur. La page Attribuer des règles d’accès s’affiche.
4. Recherchez et sélectionnez l'utilisateur souhaité. La carte de résumé s’affiche à droite, indiquant les autorisations actuelles de l’utilisateur.
5. Sélectionnez Modifier pour modifier les règles d’accès.
6. Sous Paramètres, localisez Politique de mise à jour automatique des fichiers binaires clients (Robot, Assistant et Studio).
7. Choisissez la politique de mise à jour automatique pour cet utilisateur:
   • None (Aucun) : aucune politique n'est appliquée.
   • Latest patch (Dernier correctif): installe le dernier correctif disponible de chaque version prise en charge (par exemple, le dernier correctif 2022.10, le dernier correctif 2023.4, correctif).
   • Dernière version: installe la dernière version disponible à partir du serveur de mise à jour.
   • Specific version (Version spécifique) : installe une version spécifique de la liste disponible sur le serveur de mise à jour.
8. Sélectionnez Mettre à jour pour enregistrer vos modifications.

Important :

Pour les utilisateurs disposant d'une licence Express User (anciennement Autopilot Express; Automation Express dans les attributions héritées), la stratégie de mise à jour ne peut pas être modifiée et est définie pour fournir la dernière version Enterprise. Pour connaître les fonctionnalités actuelles des licences, consultez la section Licence Express User.

Configurer la mise à jour automatique pour les groupes d'utilisateurs

La configuration des politiques de mise à jour pour un groupe d'utilisateurs vous permet d'appliquer la même politique à tous les membres du groupe sans configurer chaque utilisateur individuellement. Il s'agit de l'approche recommandée pour les cas d'utilisation Attended.

1. Accédez à l'onglet Locataire > Gérer l'accès > Règles d'accès .
2. Sélectionnez l'onglet Groupes (Groups).
3. Sélectionnez Attribuer un groupe. La page Attribuer des règles d’accès s’affiche.
4. Recherchez et sélectionnez le groupe souhaité. La carte de résumé s'affiche à droite, indiquant les paramètres actuels du groupe.
5. Sélectionnez Modifier pour modifier les règles d’accès.
6. Sous Paramètres, localisez Politique de mise à jour automatique des fichiers binaires clients (Robot, Assistant et Studio).
7. Choisissez la stratégie de mise à jour automatique pour ce groupe:
   • None (Aucun) : aucune politique n'est appliquée.
   • Latest patch (Dernier correctif): installe le dernier correctif disponible de chaque version prise en charge (par exemple, le dernier correctif 2022.10, le dernier correctif 2023.4, correctif).
   • Dernière version: installe la dernière version disponible à partir du serveur de mise à jour.
   • Specific version (Version spécifique) : installe une version spécifique de la liste disponible sur le serveur de mise à jour.
8. Sélectionnez Mettre à jour pour enregistrer vos modifications.

Remarque :

Sous le modèle d'union des privilèges, les utilisateurs héritent des paramètres de leurs groupes, mais si un utilisateur a une politique explicite configurée, elle a priorité sur la politique de groupe. Pour empêcher un utilisateur d'un groupe de stratégie de recevoir des mises à jour, supprimez-le du groupe ou configurez une stratégie explicite pour cet utilisateur défini sur sa version actuellement installée.

Configurer la mise à jour automatique pour les machines

La configuration des politiques de mise à jour des machines vous permet de gérer les versions de votre parc Unattended ou Attended en fonction de l’identité de la machine plutôt que de l’identité de l’utilisateur. Il s'agit de l'approche recommandée pour les cas d'utilisation Unattended.

1. Accédez à Locataire > Machines. La fenêtre Machines s'affiche.
2. Localisez et sélectionnez l'objet machine souhaité, puis sélectionnez Modifier. La fenêtre Modifier la machine s'affiche.
3. Sélectionnez l'onglet Maintenance . Le menu de configuration Mise à jour automatique s'affiche.
4. Choisissez la politique de mise à jour automatique pour cette machine:
   • None (Aucun) — Aucune politique n'est appliquée.
   • Latest patch (Dernier correctif) : installe le dernier correctif disponible de chaque version prise en charge.
   • Dernière version — Installe la dernière version disponible à partir du serveur de mise à jour.
   • Version spécifique — Installe une version spécifique de la liste disponible sur le serveur de mise à jour.
5. Sélectionnez Enregistrer.

Planification de la mise à jour automatique

Dans l'onglet Maintenance , vous pouvez également planifier le début des mises à jour pour l'aligner sur vos fenêtres de maintenance.

1. Dans le menu de configuration Mise à jour automatique , spécifiez une heure et une date de début.
2. Définissez éventuellement la durée de la fenêtre de maintenance.
3. Sélectionnez Enregistrer.

Si la fenêtre de maintenance s’étend avant la fin de la mise à jour, celle-ci est replanifiée à la prochaine fenêtre disponible.

Remarque :

Pour les machines utilisant la même clé de machine, la politique s'applique à toutes les machines connectées à cette clé.

Compréhension de la priorité de la politique

Lorsque plusieurs stratégies ciblent le même Robot, elles ne s’appliquent pas toutes de la même manière. Orchestrator résout les conflits en utilisant un ordre de priorité strict.

Ordre de priorité (de la plus élevée à la plus faible):

1. Politique au niveau de l’utilisateur
2. Politique au niveau du groupe
3. Politique au niveau de la machine

L'ordre de priorité s'applique lors de la comparaison de stratégies à différents niveaux. Entre les stratégies de niveau utilisateur et de niveau groupe, la version la plus récente a priorité, quel que soit l'ordre de priorité. Lorsque les politiques d’utilisateur ou de groupe sont définies (et diffèrent des politiques de niveau machine), elles remplacent la politique de niveau machine.

Exemples de conflit de politique

Exemple 1: la politique de l'utilisateur remplace la politique de la machine

Robot 2023.4.0 est installé sur une machine. La politique de niveau machine est définie sur 2023.4.12, mais l'utilisateur se connectant à cette machine a une politique de niveau utilisateur définie sur 2024.10.1. Le Robot est mis à jour vers la version 2024.10.1 (Politique utilisateur gagnée).

Exemple 2: la politique de groupe s'applique lorsque l'utilisateur n'a pas de politique

Un utilisateur n’a pas de politique individuelle (définie sur Aucun), mais appartient à un groupe avec la politique Dernier correctif . Le Robot de l’utilisateur est mis à jour vers le dernier correctif disponible pour sa version majeure installée (la politique de groupe s’applique).

Exemple 3: une version plus récente l'emporte entre l'utilisateur et le groupe

Robot 2023.4.0 est installé sur une machine. L’utilisateur a une politique définie sur la version 2023.4.12 et son groupe a une politique définie sur la version 2024.10.1. Le Robot est mis à jour vers la version 2024.10.1, car il s'agit de la version la plus récente (même si la politique au niveau de l'utilisateur a techniquement une priorité plus élevée, la version la plus récente du groupe est sélectionnée).

Remarque :

Lorsque vous utilisez des comptes Robot (robots non assistés), la politique au niveau de la machine est utilisée pour gérer les mises à jour, et non la politique utilisateur.

Journaux de mise à jour

Dans l'interface utilisateur d'Orchestrator, les journaux de mise à jour sont disponibles pour les réussites et les échecs de mise à jour.

Pour afficher les journaux de mise à jour d'une machine, dans le contexte du locataire, accédez à Machines, puis sélectionnez More Actions (Autres actions) pour la machine souhaitée. Dans le menu More Actions (Autres actions), sélectionnez View Installed Versions & Logs (Afficher les versions installées et les journaux). Dans la grille Installed Versions & Logs (Versions installées et journaux), sélectionnez View Auto-Update Logs (Afficher les journaux des mises à jour automatiques) pour l'entrée souhaitée.

Les journaux complets de la mise à jour sont également disponibles sur la machine à l'emplacement suivant :

• En mode service : %ProgramData%\UiPath\UpdateService\Logs
• En mode utilisateur : %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 possèdent 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 ces dernières, le statut de la version s’affiche sous la forme N/A avec l’info-bulle « La mise à jour automatique n’est pas applicable pour 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 General (Général) du menu Settings (Paramètres) dans le contexte du client, sélectionnez la case à cocher Client Binaries (Fichiers binaires clients) et définissez la durée d'inactivité préférée. Cela exclut les machines inactives du processus de mise à jour et ne les prend plus en compte lors du rapport sur l'état des mises à jour.

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.

Configuration du proxy

Pour les scénarios dans lesquels les Robots se trouvent 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 les journaux que vous pouvez envoyer à notre équipe d'assistance afin qu'elle puisse examiner plus en détail l'erreur spécifique.