Automatische Aktualisierung von Clientkomponenten

Aktualisieren Sie Robot-, Studio- und UiPath Assistant-Clients von einer zentralen Orchestrator- Stelle aus auf neuere Versionen.

Über

Mit dieser Funktion können Administratoren Roboter-, Studio- und UiPath® Assistant-Clients vom Orchestrator aus auf neuere Versionen aktualisieren. Dies bietet eine einfache Möglichkeit, ein Versionsupdate von einer zentralen Stelle aus auf eine große Anzahl von Maschinen zu übertragen, um den Benutzern Zeit zu sparen und den Aktualisierungsprozess zu optimieren.

Hinweis:

Die Funktion „Automatische Aktualisierung von Clientkomponenten“ funktioniert nur zur Aktualisierung bereits installierter Produkte wie Robot, Studio und UiPath Assistant auf eine neuere Version. Wenn ein Versions-Downgrade erforderlich ist, muss der Downgrade-Prozess manuell oder unter Verwendung von Tools durchgeführt werden, die von UiPath unabhängig sind.

Voraussetzungen

1. Orchestrator, Studio und Robot 2021.10 oder höher.
2. Studio und/oder Robot 2021.10 oder höher auf der Clientmaschine installiert und mit dem Orchestrator verbunden.
   Hinweis:

   Um die Funktion zur automatischen Aktualisierung von Clientkomponenten für Roboter zu aktivieren, müssen Sie die Roboteranwendung entweder mithilfe des Installationsprogramms UiPathStudio.msi oder des Installationsprogramms UiPathRobot.msi in der Version von 2024.10 oder höher installieren. Das Installationsprogramm UiPathRobot.msi in einer Version vor 2024.10 unterstützen keine automatische Aktualisierung von Clientkomponenten. Wenn Sie Roboter mithilfe eines Installationsprogramms UiPathRobot.msi in einer Version vor 2024.10 installiert haben, können Sie die Roboteranwendung manuell mithilfe einer Version 2024.10 oder höher des Installationsprogramms UiPathRobot.msi aktualisieren.

Komponenten, die am Aktualisierungsprozess beteiligt sind

Client-Seite

• Client-Apps:
  • Robot
  • Assistant
  • Studio
• UiPath-Roboterdienst
• Update Agent – ein Windows-Prozess, der für die Kommunikation zwischen dem Benutzer und dem Updatedienst verantwortlich ist. (nur im Benutzermodus und der Attended-Roboter-Installation vorhanden)
• Update Service – Ein Windows-Dienst, der für die Kommunikation zwischen der Clientmaschine und dem Update Server verantwortlich ist.

Server-Seite

• Orchestrator: Bietet die Benutzeroberfläche für Administratoren, um Richtlinien für automatische Updates festzulegen und den Versionsstatus für Client-Apps anzuzeigen.
• Update Server: Ein zentraler Dienst, der für die Verwaltung der Richtlinien für die automatische Aktualisierung und die Instandhaltung der Kommunikation mit den Clientmaschinen über den Update Service verantwortlich ist.

So funktioniert es:

Als Administrator können Sie genau die Version auswählen, die auf einer bestimmten Maschine bereitgestellt werden soll.

Bei der Installation von Studio und Robot werden daher auch zwei ausführbare Dateien auf der Maschine hinzugefügt: UiPath.UpdateService.Worker.exe und UiPath.UpdateService.Agent.exe.

Je nach Typ der Studio-/Robot-Installation werden sie auf unterschiedliche Weise installiert:

• Unattended-Roboter: UiPath.UpdateService.Worker.exe wird als Windows-Dienst installiert und UiPath.UpdateService.Agent.exe wird nicht installiert.
• Attended-Roboter: UiPath.UpdateService.Worker.exe wird als Windows-Dienst installiert; UiPath.UpdateService.Agent.exe wird als LogOn-Task im Taskplaner installiert.
• Schnellinstallation (Benutzermodus): UiPath.UpdateService.Worker.exe und UiPath.UpdateService.Agent.exe werden als LogOn-Tasks im Taskplaner installiert.
  Wichtig:

  Wenn Sie UiPath Studio und Robot auf der Maschine im Attended-Benutzermodus installieren, stellen Sie sicher, dass Sie die Orchestrator-URL während des Setups hinzufügen, damit der Aktualisierungsdienst eine Verbindung mit dem Aktualisierungsserver herstellen kann. Wenn die Orchestrator-URL während der Installation nicht hinzugefügt wird, muss sich ein Benutzer mit Administratorrechten auf der Maschine bei der Maschine anmelden und den Roboter mit Orchestrator verbinden.

Wenn eine neue Richtlinie definiert oder geändert wird, dann sendet der Update Server einen Befehl an den Update Service auf der Clientmaschine, die die Client-Apps fragt, ob sie bereit sind, den Aktualisierungsprozess zu starten.

Um bereit für ein Update zu sein, muss sich ein Produkt in einem neutralen Zustand befinden:

• Studio – Keine laufenden Prozesse oder aktiven Sitzungen.
• Robot – Keine laufenden Aufträge oder Prozesse.
• UiPath Assistant – Keine laufenden Prozesse oder ausstehenden Aktivitäten (Installieren oder Herunterladen von Prozessen).
  Hinweis:

  Während des Aktualisierungsprozesses startet der Roboter erst dann Aufträge, wenn das Update abgeschlossen ist.

Im Attended-Szenario wird eine Aktualisierungsaufforderung mit zwei Optionen für den Benutzer angezeigt:

• Update Now – Stoppt alle ausgeführten Aufträge, schließt alle Studio-Instanzen auf dieser Maschine und fährt dann mit der Aktualisierung fort.
• Later – Schaltet die Benachrichtigung aus und der Aktualisierungsprozess kann fortgesetzt werden, indem Sie im System-Tray zum UI-Symbol gehen und auf Auf Aktualisierungen prüfen klicken.

Wenn der Benutzer die Eingabeaufforderung akzeptiert, wird die Bestätigung an den Aktualisierungsdienst gesendet und der Aktualisierungsprozess beginnt. Wenn innerhalb von 24 Stunden seit der ersten Benachrichtigung keine Antwort erfolgt, wird das Update automatisch installiert.

Im Unattended-Szenario bestätigt der Update Service, dass sich die Client-App in einem neutralen Zustand befindet (wie oben beschrieben), bevor die Bestätigung zurück an den Update Server gesendet wird.

Hinweis:

• Wenn auf der Maschine Prozesse ausgeführt werden, wird der Roboterbenutzer zur Eingabeaufforderung gebeten, den Prozess entweder zu stoppen oder dessen Abschluss abzuwarten, bevor die Aktualisierung fortgesetzt werden kann. Wenn eine Studio-Sitzung geöffnet ist, wird der Roboterbenutzer aufgefordert, den Fortschritt zu speichern.
• Wenn der Roboterbenutzer nicht rechtzeitig reagiert, wird Studio geschlossen und der Prozess wird im gegenwärtigen Zustand gespeichert. Der Prozess kann nach Abschluss des Updates wiederhergestellt werden.
• Alle Roboter, die zum Zeitpunkt der Aktualisierung aktiv sind, werden in den Wartungsmodus versetzt, um sicherzustellen, dass sie keine neuen Aufträge annehmen, bevor die Aktualisierung abgeschlossen ist.
• Für Benutzermodus-Roboter gilt eine maximale Wartezeit von 1.440 Minuten.

Prozessschritte aktualisieren

Der Aktualisierungsprozess ist in sieben Phasen unterteilt:

1. Wird heruntergeladen…
   • Der Aktualisierungsdienst überprüft den Aktualisierungsserver alle drei Stunden auf eine Aktualisierungsanforderung. Wenn die Aktualisierungsanforderung empfangen wird, startet der Aktualisierungsprozess den Downloadprozess. Wenn der Downloadprozess erfolgreich gestartet wurde, wird die Aktualisierungsanforderung mit dem Status Downloading zur Aktualisierungsserverdatenbank hinzugefügt.
2. heruntergeladen
   • Der Status Downloaded fungiert als Markierung, sodass der Update Service die Nachverarbeitungsphase starten kann. Dieser Status gibt zu erkennen, dass die Aktualisierungsdatei erfolgreich heruntergeladen wurde.
3. Verarbeitung
   • Dieser Schritt behandelt die Nachverarbeitung der heruntergeladenen Datei. In diesem Schritt wird die Datei überprüft, und wenn keine Fehler auftreten, wird der Installationsvorgang gestartet.
4. Bereit für die Installation
   • Der Update-Agent informiert den Benutzer darüber, dass ein Update auf die Installation wartet, und bittet um Genehmigung oder überprüft, ob die Client-Apps für den Empfang des Updates bereit sind.
5. Installation genehmigt
   • Sobald die Genehmigung vom Update Service empfangen wurde, wird die eigentliche Installation gestartet.
6. Installieren
   • Die neue Version wird auf der Maschine installiert und behält die gleichen Einstellungen wie die vorherige Version bei.
7. Erfolgreich/fehlgeschlagen

Basierend auf dem Installationsergebnis wird der Aktualisierungsstatus an den Update Server zurück gemeldet.

Hinweis:

Wenn die Chrome-Erweiterung bereits auf der Robotermaschine installiert war, wird sie auch von der automatischen Update-Funktion aktualisiert. Andernfalls muss die Erweiterung manuell installiert werden.

Wiederholungsmechanismus

Wenn die Datei während des Aktualisierungsprozesses nicht im ersten Download abgerufen werden kann, wiederholt der Update Service dies drei weitere Male. Die Wiederholungsintervalle sind: Eine Stunde nach dem ersten Versuch, dann zwei Stunden nach der ersten Wiederholung und vier Stunden nach der letzten Wiederholung. Vor jeder Wiederholung wird der Benutzer über das Benachrichtigungssystem informiert.

Für jeden Downloadversuch werden die Protokolle zu den Orchestrator-Aktualisierungsprotokollen und lokal auf der Maschine in der Datei %localappdata%/Uipath/UpdateService/logs hinzugefügt.

Der Prozess ist bei der Installation ähnlich, d. h., wenn die erste Installation fehlschlägt, versucht es der Update Service dreimal mit der gleichen Häufigkeit erneut (eine Stunde nach dem ersten Versuch, dann zwei nach der ersten Wiederholung und vier Stunden nach der letzten Wiederholung).

Der Update Server wartet 72 Stunden, bis das Update abgeschlossen ist, nachdem es gestartet wurde. Wenn die neue Version nach Ablauf dieses Intervalls nicht installiert wurde, wird den Protokollen ein Fehler mit weiteren Details hinzugefügt. Bei der nächsten Anforderung wird die Aktualisierung wiederholt.

Wenn die automatische Aktualisierung fehlgeschlagen ist, können Sie die Aktualisierung auch manuell über die Schaltfläche wiederholen.

Roboterbereitstellungen im Dienstmodus vs. Benutzermodus

Die technischen Aspekte auf Serverseite sind sowohl für Bereitstellungen im Dienstmodus als auch im Benutzermodus identisch, da sie den gleichen Verbindungstyp zwischen dem Update Server und dem Update Service verwenden. Der Unterschied besteht darin, wie der UiPath-Roboterdienst mit dem Update Service auf der Clientmaschine kommuniziert. Dies wird unten erläutert.

Dienstmodus

In Bereitstellungen im Dienstmodus werden der UiPath-Roboterdienst und der Update Service beide in der lokalen Systemkontositzung ausgeführt.

Abbildung 1. Diagramm der Bereitstellungen im Servicemodus

Benutzermodus

In Benutzermodus-Bereitstellungen wird der UiPath-Roboterdienst in der Benutzersitzung ausgeführt und der Update Service wird in der lokalen Systemkontositzung ausgeführt.

Wichtig:

Wenn Robot und Studio im Benutzermodus bereitgestellt werden, wirkt sich das Senden des Aktualisierungsbefehls an einen Roboter auf der Maschine auf alle Benutzer auf dieser spezifischen Maschine aus.

Abbildung 2. Diagramm der Bereitstellungen im Benutzermodus

Warnung:

Nachdem der Aktualisierungsprozess abgeschlossen ist, müssen Studio und Robot manuell gestartet werden.

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.

Wichtig:

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.

Wichtig:

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. Wählen Sie die Registerkarte Gruppen aus.
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.

Hinweis:

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. Wählen Sie Speichern.

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. Wählen Sie Speichern.

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

Hinweis:

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

Hinweis:

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

Protokolle aktualisieren

Auf der Benutzeroberfläche von Orchestrator stehen die Aktualisierungsprotokolle nur für fehlgeschlagene Aktualisierungen zur Verfügung.

Um die Aktualisierungsprotokolle für eine Maschine zu sehen, gehen Sie in der Mandantenansicht zu Maschinen und wählen Sie dann Weitere Aktionen für die gewünschte Maschine. Wählen Sie im Menü Weitere Aktionen die Option Installierte Versionen und Protokolle anzeigen. Wählen Sie in der Tabelle Installierte Versionen & Protokolle für den gewünschten Eintrag die Option Protokolle zum Autoupdate anzeigen.

Vollständige Protokolle für die Aktualisierung sind auch auf der Maschine an folgender Stelle verfügbar:

• Im Servicemodus: %ProgramData%\UiPath\UpdateService\Logs
• Im Benutzermodus: %LocalAppData%\UiPath\UpdateService\Logs
  Warnung:

  Wenn Roboter in virtuellen Umgebungen bereitgestellt werden, in denen die Maschinen geklont werden, dann sind der Maschinenname, die GUID, die Drive-ID und die Mac-Adresse identisch. Dies kann Konflikte verursachen, da der Orchestrator unterschiedliche Aktualisierungsstatus von mehreren Maschinen mit denselben Bezeichnern erhält. In diesem Szenario wird der Aktualisierungsstatus im Orchestrator basierend auf der zuletzt verbundenen Maschine angezeigt. Dies kann sich auch auf Orchestrator-Protokolle auswirken, da mehrere Maschinen dieselben Bezeichner haben und doppelte Protokolle auftreten können.

Versionsstatus

In der Spalte Versionsstatus können Sie den Status der Roboterversion für Ihre Maschinen anhand der zugehörigen Richtlinie überprüfen.

Die folgenden Werte sind verfügbar:

• Keine Richtlinie (No policy) – Es ist keine Richtlinie definiert
• Aktualisierung in Bearbeitung (Update in progress) – Dieser Status wird angezeigt, wenn der Aktualisierungsprozess aktuell auf der Maschine läuft
• Kompatibel – Die Roboterversion auf der Maschine stimmt mit der Aktualisierungsrichtlinie überein.
• Nicht konform (Non compliant) – Die Roboterversion auf der Maschine unterscheidet sich von der in der Richtlinie eingerichteten. (z. B. ist die Roboterversion 2021.10.3, aber die Richtlinie ist als 2021.10.1 eingerichtet)
• Aktualisierung fehlgeschlagen (Update failed) – Dieser Status zeigt an, wenn der Aktualisierungsprozess fehlgeschlagen ist. Weitere Details finden Sie in den Aktualisierungsprotokollen.
• Nicht zutreffend – Dieser Status wird angezeigt, wenn die Einstellung zum Ausschließen inaktiver Maschinen aktiviert ist und der Roboter für eine Weile nicht verbunden war oder wenn der Maschinentyp nicht mit dem automatischen Aktualisierungsprozess kompatibel ist.

Versionsstatus für Maschinen

In der Spalte „Versionsstatus“ auf der Registerkarte „Orchestrator-Maschinen“ können Sie den Status der Roboterversion Ihrer Maschinen anhand der zugehörigen Richtlinie überprüfen.

Wichtig:

Linux-Roboter sind nicht mit der automatischen Update-Funktion kompatibel. Bei diesen wird der Versionsstatus als N/A mit der QuickInfo „Ein automatisches Update ist bei diesem Maschinentyp nicht möglich“ angezeigt.

Ausschließen von inaktiven Maschinen

Wenn mehrere Maschinen mit demselben Schlüssel mit dem Orchestrator verbunden sind und eine von ihnen inaktiv ist, wird der Versionsstatus der Maschinenvorlage Non compliant. Dies geschieht, da die Maschinenvorlage mit dem Update Server mit demselben Maschinenschlüssel kommuniziert und wenn eine der verbundenen Maschinen kein Update erhalten kann, dann betrifft dies den Gesamtstatus der Maschinenvorlage.

Um dies zu vermeiden, gehen Sie in der Mandantenansicht zum Abschnitt Allgemein des Menüs Einstellungen, markieren das Kontrollkästchen neben Binärdateien des Clients und legen Sie die bevorzugte Dauer der Inaktivität fest. Dadurch werden inaktive Maschinen vom Aktualisierungsprozess ausgeschlossen und bei Meldung des Aktualisierungsstatus nicht mehr berücksichtigt.

Versionsstatus für Benutzer

In der Spalte Versionsstatus auf der Registerkarte Benutzersitzungen des Fensters Überwachung können Sie den Status der Clientkomponentenversion für Ihre Benutzer anhand der zugehörigen Richtlinie überprüfen.

Proxykonfiguration

Bei Szenarien, in denen die Roboter mit einem Proxy verwendet werden, ist möglicherweise eine zusätzliche Konfiguration erforderlich, damit die automatische Update-Funktion funktioniert. Basierend auf dem Installationstyp können Proxykonfigurationen entweder von den Proxyeinstellungen auf Benutzerebene geerbt oder manuell durch Bearbeiten der Konfigurationsdatei festgelegt werden.

Installationstyp	Roboterbereitstellung	Aktualisierungsdienst	Agent aktualisieren	Proxy-Einstellungen
Unattended-Roboter	Windows-Dienst	Windows-Dienst	Keine Angabe 1	Aus der uipath.config -Datei.
Beaufsichtigter Roboter (Attended Robot)	Ausführbare Datei auf Benutzerebene	Windows-Dienst	Ausführbare Datei auf Benutzerebene	Aus der uipath.config -Datei.
Schnellinstallation	Ausführbare Datei auf Benutzerebene	Ausführbare Datei auf Benutzerebene	Ausführbare Datei auf Benutzerebene	Aus den Proxyeinstellungen auf Benutzerebene.

1 Wenn der Roboter im Unattended-Modus installiert ist, wird der Update-Agent nicht zur Maschine hinzugefügt.

Collecting error logs

Schlägt eine Aktualisierung fehl, können Sie mithilfe des Diagnosetools Protokolle sammeln, die Sie zur Untersuchung des spezifischen Fehlers an unser Supportteam senden können.