- Erste Schritte
- Anforderungen
- Best Practices
- Installation
- Wird aktualisiert
- Vor dem Upgrade
- Aktualisierung mithilfe von Windows Installer
- Aktualisierung mihilfe des Azure-Skripts
- Identity Server
- Fehlerbehebung bei Startfehlern

Installationsanleitung für den Orchestrator
Aktualisierung mithilfe von Windows Installer
Bitte beachten Sie, dass sich diese Informationen auf die Version beziehen, auf die Sie aktualisieren, NICHT auf die Version, von der Sie aktualisieren. Stellen Sie daher sicher, dass Sie die richtigen Details lesen, bevor Sie fortfahren.
Überblick
Der Aktualisierungsprozess kann unterschiedlich sein, je nachdem, ob:
- Die Vorversion mit dem Windows-Installationsprogramm eingerichtet wurde;
- Ihre Orchestrator-Instanz in einer Umgebung mit mehreren Knoten läuft.
Wichtig:
- Besuchen Sie vor dem Upgrade die Seiten Hardwareanforderungen, Softwareanforderungen und Voraussetzungen für die Version, auf die Sie aktualisieren, da sie sich möglicherweise geändert haben. Sie müssen sicherstellen, dass Sie alle Anforderungen vor dem Upgrade erfüllen.
- Nach dem Upgrade empfehlen wir Ihnen, alle Ihre Roboter neu zu starten, damit sie die neuen Einstellungen anwenden können.
- Wenn Ihre Pakete (Aktivitäten und/oder Workflows) in einem freigegebenen Ordner gespeichert sind, beachten Sie bitte, dass das
UiPathOrchestrator.msi-Installationsprogramm Schreibzugriff auf das oben genannte Verzeichnis benötigt. - Ab v2020.4 gibt es weitere Anforderungen für das SSL-Zertifikat von Orchestrator. Stellen Sie sicher, dass Sie alle Voraussetzungen erfüllen . Informationen zum Ändern des vorhandenen Zertifikats finden Sie unter Verwenden eines Zertifikats für das HTTPS-Protokoll
- Überprüfen Sie den ausgewählten Installationspfad. Das Verschieben einer Installation von einem Speicherort an einen anderen wird nicht unterstützt.
- Es wird empfohlen, den vorherigen Typ der Orchestrator-Anwendungspoolidentität auch für Identity Server und Webhooks beizubehalten. Andernfalls können beim Zugriff auf den SQL-Server Probleme auftreten.
- Wenn Sie erwägen, Insights zu installieren, stellen Sie sicher, dass Sie die
db_ownerRolle auswählen, da dies beim Konfigurieren der Insights SQL Server-Konfiguration erforderlich ist. - Wenn Sie von einer älteren Version als 2021.10 aktualisieren, für die die Option Windows-Authentifizierung ausgewählt ist, stellen Sie sicher, dass Sie das Installationsprogramm als AD-Benutzer ausführen.
Vorhergehende mit Windows Installer installierte Version
Um Orchestrator von einer Version zu aktualisieren, die zuvor mithilfe des Windows-Installers installiert wurde, führen Sie die folgenden Aktionen aus:
- Sichern Sie Ihre Automatisierungspakete, die Dateien
web.configundUiPath.Orchestrator.dll.configund die Datenbank. - Laden Sie die Datei
UiPathOrchestrator.msiaus dem Customer Portal herunter und wählen Sie Ihre Version aus. - Führen Sie das
UiPathOrchestrator.msi-Installationsprogramm aus. Der Orchestrator wird mit dem NamenUiPathOrchestratorinstalliert, die Datenbank wird aktualisiert und alle Ihre Daten werden migriert. Sie können in diesem Stadium auch die Identity Server- und Update Server-Einstellungen ändern. - Wenn Sie HAA für die Cache-Verwaltung verwenden, löschen Sie alle HAA-Cache-Schlüssel mit folgendem Befehl:
redis-cli -h <hostname> -p <portnumber> -a <password> flushall. Beachten Sie, dass HAA standardmäßig Port10000verwendet. Zum Beispiel:redis-cli -h redis-12345.c24.us-east-mz-1.ec2.cloud.redislabs.com -p 10000 -a xyz flushallredis-cli -h redis-12345.c24.us-east-mz-1.ec2.cloud.redislabs.com -p 10000 -a xyz flushall - Wenn Sie Insights verwenden, stellen Sie sicher, dass Sie die Insights-Datenbank vor dem Orchestrator-Upgrade sichern.
Mehrfach-Knoten-Umgebung
In einer Umgebung mit mehreren Knoten wird das Upgrade auf primären und sekundären Knoten unterschiedlich durchgeführt. Die folgenden Schritte müssen durchgeführt werden, um alle Ihre Knoten zu aktualisieren.
Obwohl Sie die Administrator-Passwörter auf Host- und Standard-Mandantenebene angeben, werden diese nicht berücksichtigt. Verwenden Sie Ihre früheren Passwörter zum Anmelden.
Dateien sichern
Sichern Sie Ihre Automatisierungspakete, die Dateien web.config und UiPath.Orchestrator.dll.config und die Datenbank.
Primärknoten-Installation
Für die Attended-Installation: Führen Sie den folgenden Befehl in einer Administratoreingabeaufforderung aus:
UiPathOrchestrator.msi OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log
UiPathOrchestrator.msi OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log
Für die Unattended-Installation: Führen Sie den folgenden Befehl in einer Administratoreingabeaufforderung aus:
UiPathOrchestrator.msi PUBLIC_URL=https://hostname.local APPPOOL_USER_NAME=serviceAccount APPPOOL_PASSWORD=pass OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log /Q
UiPathOrchestrator.msi PUBLIC_URL=https://hostname.local APPPOOL_USER_NAME=serviceAccount APPPOOL_PASSWORD=pass OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log /Q
Führen Sie die Installation wie hier beschrieben durch.
Vergessen Sie nicht, die Konfigurationsdatei upgradeParams.json zu sichern, die von der Installation generiert wurde. Diese ist bei nachfolgenden Installationen sekundärer Knoten zu verwenden.
Sekundärknoten-Installation
Es wird empfohlen, die unbeaufsichtigte Installation unter Verwendung der upgradeParams.json-Konfigurationsdatei auszuführen, die auf dem primären Knoten erstellt wurde. Führen Sie über die Administrator-Eingabeaufforderung den folgenden Befehl aus:
UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log /Q
UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log /Q
Schlüssel leeren
Wenn Sie HAA für die Cache-Verwaltung verwenden, löschen Sie alle HAA-Cache-Schlüssel aus einer Aktiv/Aktiv-Datenbank mit dem folgenden Befehl:
crdb-cli crdb flush --crdb-guid <guid> [ --no-wait ]
crdb-cli crdb flush --crdb-guid <guid> [ --no-wait ]
Wenn Sie den Lizenztyp Concurrent Runtime verwenden möchten, beachten Sie bitte, dass beim Aktualisieren von einer älteren Version als v2020.4, wenn Sie High-Density-Roboter eingerichtet haben, die Anzahl der Laufzeiten pro Maschine automatisch auf 1 gesetzt wird und nicht auf die Gesamtzahl der Roboter auf dieser Maschine.