- Erste Schritte
- Einleitung
- Benutzeroptionen
- Anmelden beim Orchestrator
- Zurücksetzen Ihres Kennworts
- Mein Profil
- Automatische Aktualisierung von Clientkomponenten
- Checkliste für die Orchestrator-Konfiguration
- Best Practices
- Mandant
- Ordnerkontext
- Automatisierungen
- Prozesse
- Jobs
- Auslöser
- Protokolle
- Überwachung
- Warteschlangen
- Assets
- Speicher-Buckets
- Test Suite - Orchestrator
- Sonstige Konfigurationen
- Integrationen
- Klassische Roboter
- Hostverwaltung
- Über die Hostebene
- Verwalten von Systemadministratoren
- Verwalten von Mandanten
- Konfigurieren von System-E-Mail-Benachrichtigungen
- Prüfungsprotokolle für das Hostportal
- Wartungsmodus
- Organisationsadministration
- Fehlersuche und ‑behebung
Automatische Aktualisierung von Clientkomponenten
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. Dadurch wird die aufgewendete Zeit der Interaktion für Benutzer verringert und der Aktualisierungsprozess optimiert.
- Orchestrator, Studio und Robot 2021.10 oder höher.
- Studio und/oder Robot 2021.10 oder höher auf der Clientmaschine installiert und mit dem Orchestrator verbunden.
Client-Seite
-
Client-Apps:
- Roboter
- 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)
- Aktualisierungsdienst – ein Windows-Dienst oder -Prozess (bei Verwendung der Schnellinstallation ), der für die Kommunikation zwischen der Clientmaschine und dem Aktualisierungsserver 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.
- Aktualisierungsserver: ein zentraler Dienst, der für die Verwaltung der Richtlinien für automatische Aktualisierungen und die Aufrechterhaltung der Kommunikation mit den Clientmaschinen über den Aktualisierungsdienst verantwortlich ist.
UiPath.UpdateService.Worker.exe
und UiPath.UpdateService.Agent.exe
.
Je nach Typ der Studio-/Robot-Installation werden sie auf unterschiedliche Weise installiert und ausgeführt:
- Unattended-Roboter:
UiPath.UpdateService.Worker.exe
wird als Windows-Dienst installiert undUiPath.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
undUiPath.UpdateService.Agent.exe
werden als LogOn-Tasks im Taskplaner installiert.Wichtig: Wenn Sie Studio und Robot pro 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.
Der Aktualisierungsdienst auf der Maschine kommuniziert während der regelmäßigen Abfragen mit dem Aktualisierungsserver. Wenn er eine Änderung in der Richtlinie findet, überprüft er mit den Client-Apps, ob sie bereit sind, den Aktualisierungsprozess zu starten.
Damit ein Produkt ein Update erhält, muss es sich 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 Update Service gesendet und der Aktualisierungsprozess wird gestartet.
Wenn seit der ersten Benachrichtigung innerhalb von 24 Stunden keine Antwort zurückgegeben wird, dann 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.
Wenn auf der Maschine Prozesse ausgeführt werden, wird der Benutzer aufgefordert, entweder den Prozess anzuhalten oder zu warten, bis dieser fertig ist, um dann mit der Aktualisierung fortzufahren. Wenn eine Studiositzung geöffnet ist, wird der Benutzer aufgefordert, den Fortschritt zu speichern.
Wenn der Benutzer nicht reagiert, wird Studio geschlossen, der Prozess wird im gegenwärtigen Zustand gespeichert und kann nach Abschluss des Updates wiederhergestellt werden. Währenddessen wartet der Roboter auf den Abschluss eines Prozesses und startet anschließend den Aktualisierungsprozess.
Prozessschritte aktualisieren
Der Aktualisierungsprozess ist in sieben Phasen unterteilt:
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.
%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 Aktualisierungsserver wartet seit dem Start 72 Stunden auf den Abschluss der Aktualisierung. Wenn die neue Version nach Ablauf dieses Intervalls nicht installiert wird, wird den Protokollen ein detaillierter Fehler hinzugefügt. Die Aktualisierung wird beim nächsten Empfang einer Anforderung erneut versucht.
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.
Benutzermodus
In Benutzermodus-Bereitstellungen wird der UiPath-Roboterdienst in der Benutzersitzung ausgeführt und der Update Service wird in der lokalen Systemkontositzung ausgeführt.
Richtlinien können für Benutzer, Benutzergruppen (empfohlen für Attended-Anwendungsfälle) oder Maschinen (empfohlen für Unattended-Anwendungsfälle) festgelegt werden.
Durch das Konfigurieren von Aktualisierungsrichtlinien für Benutzer oder Benutzergruppen können Administratoren die Studio-, Roboter- und UiPath Assistant-Version für einen bestimmten Benutzer oder eine bestimmte Benutzergruppe steuern.
- Bestimmter Benutzer – Um Komponenten, die an einen bestimmten Benutzer gebunden sind, im Detail zu aktualisieren.
- Benutzergruppe – Um den Zugriff auf alle Gruppenmitglieder zu aktualisieren, ohne die Zugriffsebene für jeden Benutzer einzeln festlegen zu müssen.
Richtlinien werden durch Bearbeiten eines bestimmten Benutzers oder einer Gruppe auf der Registerkarte Zugriff verwalten im Orchestrator konfiguriert.
- Navigieren Sie zu Mandant > Zugriff verwalten. Das Fenster Benutzer wird angezeigt.
- Klicken Sie für den gewünschten Benutzer/die gewünschte Benutzergruppe auf Bearbeiten. Das Fenster Benutzer bearbeiten wird angezeigt.
- Ändern Sie im Abschnitt Einstellungen zu Aktualisierungsrichtlinien die Richtlinie für die automatische Aktualisierung in einen der folgenden Werte:
Pro Benutzer
Pro Gruppe
None
festgelegt ist, aber dieser auch Teil einer Gruppe ist, die über einen bestimmten Richtliniensatz verfügt (z. B. Letzter Patch), dann gilt die Gruppenrichtlinie. Wenn Sie möchten, dass die Komponenten für diesen spezifischen Benutzer nicht aktualisiert werden, müssen Sie sie entweder aus der Gruppe entfernen, in der die Richtlinie vorhanden ist, oder die Aktualisierungsrichtlinie so einstellen, dass sie bei der aktuellen Version ist, die installiert ist.
Wenn der Benutzer über eine Richtlinie zum Pushen einer bestimmten Version verfügt und auch Teil einer Gruppe ist, die über eine andere Richtlinie verfügt, dann hat die Richtlinie auf Benutzerebene Vorrang.
Das Konfigurieren einer Aktualisierungsrichtlinie für Maschinenobjekte ermöglicht es Administratoren, die Roboterversionen auf allen Maschinen zu aktualisieren, die mit diesem Maschinenschlüssel mit dem Orchestrator verbunden sind. Die Konfiguration erfolgt auf Maschinenobjektebene:
Für den Fall, dass eine Richtlinie auf Benutzerebene, eine Richtlinie auf Gruppenebene und eine Richtlinie auf Maschinenebene für denselben Roboter gelten, hat die Richtlinie auf Benutzerebene Vorrang.
Beispiel
- Auf machine_1 wurde eine Robot- und Studio-Version 2021.10 installiert.
- Auf machine_1 ist der Roboter über die interaktive Anmeldung mit dem Benutzer John.Doe@domain.com mit dem Orchestrator verbunden.
- Eine Aktualisierungsrichtlinie gilt für john.doe@domain.com, die die Version 2021.10.2 pushen soll.
- John.doe@domain.com ist auch Teil von group_1.
- Eine Aktualisierungsrichtlinie gilt für group_1, die die Version 2021.10.3 pushen soll.
-
Eine Aktualisierungsrichtlinie gilt für machine_1, die die Version 2022.4 pushen soll.
Ergebnis: Wenn die Aktualisierungsrichtlinien ausgelöst werden, werden die Komponenten auf dieser Maschine auf Version 2021.10.2 aktualisiert.
Versionsverfügbarkeit in Richtlinien
Beim Erstellen einer Aktualisierungsrichtlinie können Sie eine der folgenden Optionen auswählen:
Neueste Hauptversion |
Letzter Patch |
Bestimmter Patch |
---|---|---|
Installiert die neueste verfügbare Version, die auf dem Aktualisierungsserver gefunden wurde. |
Installiert den neuesten Patch, der für jede der unterstützten Versionen verfügbar ist. (z. B. Letzter Patch 2021.10, Letzter Patch 2022.4). |
Installiert einen bestimmten Patch aus der Liste der Patches, die auf dem Aktualisierungsserver verfügbar sind. |
%localappdata%/Uipath/UpdateService/logs
.
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.
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.
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.
N/A
mit dem Tooltip „Automatische Aktualisierung ist für diesen Maschinentyp nicht zutreffend“ angezeigt.
Ausschließen von inaktiven Maschinen
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, greifen Sie im Mandantenkontext auf den Abschnitt Allgemein des Menüs Einstellungen zu, aktivieren Sie das Kontrollkästchen Client-Binärdateien und legen Sie das bevorzugte Inaktivitätsintervall fest. Dadurch werden inaktive Maschinen vom Aktualisierungsprozess ausgeschlossen und nicht mehr berücksichtigt, wenn der Aktualisierungsstatus gemeldet wird.
Wenn Ihre Orchestrator-Instanz über einen Internetzugang verfügt, erfolgt die Versionsverwaltung standardmäßig durch UiPath und die Liste der verfügbaren Versionen in den Richtlinien wird automatisch aufgefüllt. Wenn Sie die Versionen manuell verwalten möchten, wechseln Sie auf Hostebene zu den Einstellungen, wählen Sie dann Allgemein aus und deaktivieren Sie dann das Kontrollkästchen Verfügbare Produktversionen automatisch ausfüllen.
Wenn Sie sich gegen die Versionsverwaltung durch UiPath entscheiden oder Ihre Orchestrator-Instanz keinen Internetzugang hat, müssen Sie die Installationsprogramme der Client-Komponenten manuell von der Seite UiPath Customer Portal – Produkt-Downloads herunterladen und auf den Update Server hochladen, indem Sie die Schritte unten:
Verfügbare Versionen abrufen
.\Product-Versions.ps1 get -ApiBaseUri "<ORCHESTRATOR_URL>" -IdentityUri "<IDENTITY_URL>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"
.\Product-Versions.ps1 get -ApiBaseUri "<ORCHESTRATOR_URL>" -IdentityUri "<IDENTITY_URL>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"
Eine neue Version auf dem Update Server veröffentlichen
.\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"
.\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"
Eine bestimmte Version vom Update Server löschen
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>"
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>"
Eine neue Version auf der Clientmaschine veröffentlichen
.\Provision-IdentityClient.ps1 -IdentityUri "<IDENTITY_URL>" -InstallationToken "<INSTALLATION_TOKEN>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"
.\Provision-IdentityClient.ps1 -IdentityUri "<IDENTITY_URL>" -InstallationToken "<INSTALLATION_TOKEN>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"
Basierend auf den Anforderungen können die folgenden Produkt-IDs in den Skripten verwendet werden:
ProduktID | Produkt |
---|---|
FD97813F-44F7-45A0-BB55-0DAF0088F568 | UiPath Assistant für Mac (x64) |
46C978F2-A5FE-4F71-AD88-D6A07118F790 | UiPath Assistant für Mac (arm64) |
B69FDACF-6DD0-46FB-88C7-AF2D87CAF5AA | UiPath-Automatisierungspaket (UiPathStudio.msi) |
In Szenarien, in denen sich die Roboter hinter einem Proxy befinden, ist möglicherweise eine zusätzliche Konfiguration erforderlich, damit die automatische Aktualisierungsfunktion funktioniert. Basierend auf dem Installationstyp können Proxykonfigurationen entweder von den Proxyeinstellungen auf Benutzerebene geerbt oder manuell durch Bearbeiten der Konfigurationsdateifestgelegt werden.
Installationstyp |
Roboterbereitstellung |
Aktualisierungsdienst |
Agent aktualisieren |
Proxy-Einstellungen |
---|---|---|---|---|
Unattended-Roboter |
Windows-Dienst |
Windows-Dienst |
Nicht zutreffend
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.
Wenn ein Update fehlschlägt, können Sie das Diagnosetool verwenden, um Protokolle zu sammeln, die an unser Support-Team gesendet werden können, die zur weiteren Untersuchung des jeweiligen Fehlers verwendet werden.
- Über
- Voraussetzungen
- Komponenten, die am Aktualisierungsprozess beteiligt sind
- So funktioniert es:
- Roboterbereitstellungen im Dienstmodus vs. Benutzermodus
- Konfigurieren von Richtlinien
- Konfigurieren von Richtlinien für Benutzer/Benutzergruppen
- Konfigurieren von Richtlinien für Maschinenobjekte
- Richtlinienpriorität
- Protokolle aktualisieren
- Versionsstatus
- Versionsstatus für Maschinen
- Versionsstatus für Benutzer
- Verwalten von Aktualisierungsversionen
- Proxykonfiguration
- Sammeln von Fehlerprotokollen
- Fehlermeldung
- Diagnosetool-Setup