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.

Policy configuration levels

Auto-update policies are configured in Orchestrator at three levels: user, user group, and machine. Each level controls what version is deployed to the target scope.

Important :

Auto-update is controlled entirely through Orchestrator policies. Installation settings during setup do not determine whether or how auto-update operates. If you want to prevent auto-update, you must configure the policy in Orchestrator (not through the installer).

Configure auto-update for users

Configuring update policies for a specific user allows you to control the Studio, Robot, and Assistant versions for that individual.

1. Navigate to Tenant > Manage Access > Access Rules tab.
2. Select the Users tab.
3. Select Assign user. The Assign access rules page is displayed.
4. Search for and select the desired user. The Summary card appears on the right showing the user's current permissions.
5. Select Edit to modify access rules.
6. Under Settings, locate Client binaries (Robot, Assistant and Studio) auto-update policy.
7. Choose the auto-update policy for that user:
   • None: no policy is applied.
   • Latest patch: installs the latest patch available for each supported version (for example, latest 2022.10 patch, latest 2023.4 patch).
   • Latest version: installs the latest available version from the update server.
   • Specific version: installs a specific version from the list available on the update server.
8. Select Update to save your changes.

Important :

For users that have an Express User license (previously Autopilot Express; Automation Express in legacy assignments), the update policy cannot be edited and is set to deliver the latest enterprise version. For the current license capabilities, check Express User license.

Configure auto-update for user groups

Configuring update policies for a user group allows you to apply the same policy to all group members without configuring each user individually. This is the recommended approach for attended use cases.

1. Navigate to Tenant > Manage Access > Access Rules tab.
2. Sélectionnez l'onglet Groupes (Groups).
3. Select Assign group. The Assign access rules page is displayed.
4. Search for and select the desired group. The Summary card appears on the right showing the group's current settings.
5. Select Edit to modify access rules.
6. Under Settings, locate Client binaries (Robot, Assistant and Studio) auto-update policy.
7. Choose the auto-update policy for that group:
   • None: no policy is applied.
   • Latest patch: installs the latest patch available for each supported version (for example, latest 2022.10 patch, latest 2023.4 patch).
   • Latest version: installs the latest available version from the update server.
   • Specific version: installs a specific version from the list available on the update server.
8. Select Update to save your changes.

Remarque :

Under the union of privileges model, users inherit settings from their groups, but if a user has an explicit policy configured, it takes precedence over the group policy. To prevent a user in a policy group from receiving updates, either remove them from the group or configure an explicit policy for that user set to their current installed version.

Configure auto-update for machines

Configuring update policies for machines allows you to manage versions across your unattended or attended fleet based on machine identity rather than user identity. This is the recommended approach for unattended use cases.

1. Navigate to Tenant > Machines. The Machines window is displayed.
2. Locate and select the desired machine object, then select Edit. The Edit Machine window is displayed.
3. Select the Maintenance tab. The Auto Update configuration menu is displayed.
4. Choose the auto-update policy for that machine:
   • None — No policy is applied.
   • Latest patch — Installs the latest patch available for each supported version.
   • Latest version — Installs the latest available version from the update server.
   • Specific version — Installs a specific version from the list available on the update server.
5. Sélectionnez Enregistrer.

Auto-update scheduling

From the Maintenance tab, you can also schedule when updates start to align with your maintenance windows.

1. In the Auto Update configuration menu, specify a start time and date.
2. Optionally set the duration of the maintenance window.
3. Sélectionnez Enregistrer.

If the maintenance window elapses before the update completes, it is rescheduled during the next available window.

Remarque :

For machines using the same machine key, the policy applies to all machines connected with that key.

Understanding policy priority

When multiple policies target the same Robot, they don't all apply equally. Orchestrator resolves conflicts using a strict priority order.

Priority order (highest to lowest):

1. User-level policy
2. Group-level policy
3. Machine-level policy

The priority order applies when comparing policies at different levels. Between user-level and group-level policies, the newer version takes precedence regardless of priority order. When either user or group policies are set (and differ from machine-level policies), they override the machine-level policy.

Examples of policy conflicts

Example 1: User policy overrides machine policy

A machine has Robot 2023.4.0 installed. The machine-level policy is set to 2023.4.12, but the user logging into that machine has a user-level policy set to 2024.10.1. The Robot updates to 2024.10.1 (user policy wins).

Example 2: Group policy applies when user has no policy

A user has no individual policy (set to None), but belongs to a group with Latest Patch policy. The user's Robot updates to the latest patch available for their installed major version (group policy applies).

Example 3: Newer version wins between user and group

A machine has Robot 2023.4.0 installed. The user has a policy set to 2023.4.12, and their group has a policy set to 2024.10.1. The Robot updates to 2024.10.1 because it is the newer version (even though the user-level policy technically has higher priority, the group's newer version is selected).

Remarque :

When using Robot Accounts (unattended robots), the machine-level policy is used to handle updates, not the user policy.

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.

Collecting error logs

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.