- Erste Schritte
- Anforderungen
- Best Practices
- Installation
- Wird aktualisiert
- Identity Server
- Fehlerbehebung bei Startfehlern

Installationsanleitung für den Orchestrator
Orchestrator-Skripte
Auf dem Orchestrator veröffentlichen
In der folgenden Tabelle sind alle Parameter beschrieben, die mit Publish-Orchestrator.ps1 verwendet werden können.
| Parameter | Beschreibung |
|---|---|
|
| Obligatorisch. Gibt den Typ des Szenarios an, das Sie starten möchten. Die folgenden Optionen sind verfügbar:
|
|
| Obligatorisch. Die ID des Azure-Dienstprinzipals. Bitte beachten Sie, dass dem verwendeten Dienstprinzipal die Rolle Mitwirkender für den App-Dienst im Abonnementbereich zugewiesen werden muss. |
|
| Obligatorisch. Das Azure-Tokenkennwort für die Dienstprinzipal-ID. |
|
| Obligatorisch. Die Azure-Abonnement-ID für den App Service, der Orchestrator hostet. |
|
| Obligatorisch. Die Azure-Mandanten-ID. |
|
| Obligatorisch. Der Name der Azure-Ressourcengruppe, die den Orchestrator-App-Dienst enthält. |
|
| Obligatorisch. Der Name des Azure App Service für Orchestrator. |
|
| Obligatorisch. Geben Sie den vollständigen Pfad zum Archiv UiPath.Orchestrator.Web.zip an. |
|
| Optional. Geben Sie den vollständigen Pfad des Archivs UiPathActivities.zip an, das ab v2018.4.4 standardmäßig in UiPathOrchestrator.zip enthalten ist. Auf diese Weise können Sie den lokalen Aktivitätsfeed in Azure zur Installationszeit installieren. Bitte beachten Sie, dass dieser Parameter nur mit dem Repository-Typ Legacy verwendet werden kann. Andernfalls muss er manuell eingerichtet werden. |
|
| Optional. Dieser Parameter aktiviert das Modul „Testautomatisierung“ für Testdatenwarteschlangen, Testausführung und Terminplanung. Sie können diese Funktion basierend auf einem der folgenden Szenarien aktivieren: Mit einer Orchestrator-Neuinstallation starten Publish-Orchestrator.ps1 mit dem Parameter -testAutomationFeatureEnabled ausführen:
Deployment slot setting, insbesondere, wenn Sie Hotswap-Slots verwenden. Aktivieren der Testautomatisierung nach der Orchestrator-Installation Wenn Sie Orchestrator bereits bereitgestellt haben, ohne das Modul „Testautomatisierung“ zu aktivieren, Publish-Orchestrator.ps1 mit den gleichen Parametern wie bei einem Upgrade aus, und fügen Sie den Parameter -testAutomationFeatureEnabled hinzu. Upgrade von Orchestrator -testAutomationFeatureEnabled zum Skript Publish-Orchestrator.ps1 hinzu, bevor Sie es ausführen. Weitere Informationen zum Upgraden des Orchestrators finden Sie unter Publish-Orchestrator.ps1 – Aktualisierung. |
|
| Optional. Dieser Parameter aktiviert das Insights-Modul und die Funktion. Sie können diese Funktion in einem der folgenden Szenarien aktivieren: Starten Sie mit einer Neuinstallation des Orchestrators erneut Publish-Orchestrator.ps1 mit dem Parameter -insightsFeatureEnabled ausführen:
Insights nach der Orchestrator-Installation aktivieren Publish-Orchestrator.ps1 mit denselben Parametern wie für ein Upgrade aus und fügen Sie den Parameter –insightsFeatureEnabled hinzu. Upgrade von Orchestrator -insightsFeatureEnabled zum Skript Publish-Orchestrator.ps1 hinzu, bevor Sie es ausführen. Weitere Informationen zum Upgraden des Orchestrators finden Sie unter Publish-Orchestrator.ps1 – Aktualisierung. |
|
| Optional. Mit diesem Parameter wird das Modul für die Aktualisierung des Servers aktiviert. Sie können diese Funktion in einem der folgenden Szenarien aktivieren: Starten Sie mit einer Neuinstallation des Orchestrators erneut Publish-Orchestrator.ps1 mit dem Parameter -updateServerFeatureEnabled ausführen:
Aktivieren Sie die „Aktualisierung des Servers“ nach der Orchestrator-Installation Wenn Sie den Orchestrator bereits bereitgestellt haben, ohne das Modul zur Aktualisierung des Servers zu aktivieren, Publish-Orchestrator.ps1 mit den gleichen Parametern wie bei einem Upgrade aus, und fügen Sie den Parameter -updateServerFeatureEnabled hinzu. Upgrade von Orchestrator -updateServerFeatureEnabled zum Skript Publish-Orchestrator.ps1 hinzu, bevor Sie es ausführen. Weitere Informationen zum Upgraden des Orchestrators finden Sie unter Publish-Orchestrator.ps1 – Aktualisierung. |
|
| Optional. Dies sollte nur verwendet werden, wenn Sie Elasticsearch für die Protokollierung verwenden möchten. Geben Sie die Elasticsearch-URL als Wert an, z. B. "http://elasticserver:9200". Wenn Ihre Orchestrator-Instanz eine Authentifizierung erfordert, geben Sie die Parameter ElasticSearchUsername, ElasticSearchPassword, elasticSearchDiagnosticsUsername und elasticSearchDiagnosticsPassword an. |
|
| Optional. Dieser Parameter ermöglicht Ihnen, Robot-Protokolle nur zu dem konfigurierten Elasticsearch-Server zu senden. Geben Sie die URL von Elasticsearch als Wert an wie zum Beispiel "http://elasticserver:9200". Bitte beachten Sie, dass dieser Wert nur in Verbindung mit dem Parameter -robotsElasticSearchUrl verwendet werden kann. Wenn Sie diesen Parameter nicht angeben, werden Robot-Protokolle sowohl zu der konfigurierten SQL-Datenbank als auch zu Elasticsearch gesendet. |
|
| Optional. Dieser Parameter ermöglicht Ihnen, den Benutzernamen für Ihre Elasticsearch-Instanz anzugeben, wenn deren Authentifizierung aktiviert ist. |
|
| Optional. Dieser Parameter ermöglicht Ihnen, das Passwort für Ihre Elasticsearch-Instanz anzugeben, wenn deren Authentifizierung aktiviert ist. |
|
| Optional. Dieser Parameter ermöglicht Ihnen, den Benutzernamen für Ihre Elasticsearch-Instanz anzugeben, wenn deren Authentifizierung aktiviert ist. Dieser Parameter ist zusammen mit elasticSearchDiagnosticsPassword "Password" für interne Orchestrator-Protokolle erforderlich. |
|
| Optional. Dieser Parameter ermöglicht Ihnen, das Passwort für Ihre Elasticsearch-Instanz anzugeben, wenn deren Authentifizierung aktiviert ist. Dieser Parameter ist zusammen mit elasticSearchDiagnosticsUsername "Username" für interne Orchestrator-Protokolle erforderlich. |
|
| Optional. Verwenden Sie Redis als Datenbank, um Nachrichten und Cache an und von allen Maschinen zu verteilen, die über Ihren Lastenausgleich verbunden sind. Wenn -redisConnectionString angegeben ist, wird die Option automatisch auf true festgelegt, andernfalls wird sie auf false festgelegt. |
|
| Optional. Kann nur verwendet werden, wenn loadBalancerUseRedis auf true festgelegt ist. Ein Verbindungsstring, der Ihnen ermöglicht, Ihren Redis-Server einzurichten, der die URL des Servers, dass Passwort und den mit Redis verwendeten Port enthält. Überdies besteht die Möglichkeit, mit SSL verschlüsselte Verbindungen zwischen den Orchestratorknoten und dem Redis-Dienst zu aktivieren. Weitere Informationen finden Sie hier. Beispiele:
|
|
| Optional. Hilft Ihnen dabei, Azure SignalR Service zu aktivieren, wodurch eine direkte Kommunikation zwischen Ihrer Roboterflotte und SignalR Service ermöglicht wird – Orchestrator ist nicht mehr zwischengeschaltet. Bitte beachten Sie, dass bei Aktivierung dieser Option Roboter mit einer niedrigeren Version als 2019.2 für die Kommunikation mit Orchestrator nur das Heartbeat-Protokoll verwenden, d. h. dass ein von Orchestrator gegebener Befehl nur alle 30 Sekunden von einem Roboter aufgenommen wird. Beispiel: -azureSignalRConnectionString "Endpoint=https://doctest.signalr.net;AccessKey=M1ug+sBu07hyyi12AgyJ52SEd4OgC2Mm6BvllVHCC9c=;Version=1.0;" |
|
| Optional. Definiert das Ziel, in dem Ausführungsmedien und Pakete gespeichert werden sollen. Es kann mit den folgenden Zielen ausgefüllt werden:
UiPath.Orchestrator.dll.config Storage.Type im Abschnitt Konfiguration von Azure App Service überschrieben haben, müssen Sie diesen Wert beim Aktualisieren als Skriptparameter an Publish-Orchestrator.ps1 übergeben. |
|
| Optional. Gibt den tatsächlichen Speicherort an, an dem die Ausführungsmedien und -pakete abgelegt werden sollen. Besonderheiten:
Weitere Informationen zu diesen Bereitstellungstypen finden Sie hier. UiPath.Orchestrator.dll.config Storage.Location im Abschnitt Konfiguration von Azure App Service überschrieben haben, müssen Sie diesen Wert beim Aktualisieren als Skriptparameter an Publish-Orchestrator.ps1 übergeben. |
|
| Optional. Kann nur in Upgrade-Szenarien verwendet werden. Wenn angegeben, stellt das Skript Orchestrator im angegebenen App-Service-Slot anstelle des Produktions-Slots bereit. Zusätzlich wird ein Swap-Slot mit dem Produktions-Slot ohne Ausfallzeit ausgeführt. Voraussetzungen:
|
|
| Optional. Kann nur verwendet werden, wenn sich der Bereitstellungs-Slot des App Service für Orchestrator von dem durch Azure festgelegten Standard-Produktionsslot von App-Service unterscheidet. |
|
| Optional. Schlüsselwertpaare von Anwendungseinstellungen, die nach der Bereitstellung per Push in den Abschnitt der Azure App-Dienstkonfiguration übertragen werden. Beachten Sie, dass dies nur für Einstellungen aus dem Abschnitt App-Einstellungen der Datei UiPath.Orchestrator.dll.config gilt. Sie können diesen Parameter verwenden, um bestimmte Einstellungen zu ändern, die nicht über das Publish-Orchestrator.ps1 -Skript verfügbar gemacht werden. Für den Rest verwenden Sie bitte ihren dedizierten Parameter bei der Bereitstellung des Skripts. Bitte beachten Sie, dass vorhandene Einstellungen mit neuen Einstellungen zusammengeführt werden. |
|
| Optional. Wenn vorhanden, wird die Anwendung vor der Bereitstellung angehalten und nach Abschluss der Bereitstellung gestartet. |
|
| Optional. Wenn vorhanden, wird die Bereitstellung ohne Benutzerbestätigung fortgesetzt. |
|
| Optional. Ein String, der eine durch Kommas getrennte Liste von Bucket-Anbietern enthält, die Sie aktivieren möchten. Wenn nicht genauer angegeben, wird standardmäßig Orchestrator,Amazon,Azure,Minio eingestellt. Sie haben auch die Möglichkeit, den FileSystem-Anbieter zu aktivieren, indem Sie ihn dieser Liste hinzufügen. Achtung : Wenn Sie den FileSystem-Anbieter verwenden und auf 20.10.7 oder höher aktualisieren, müssen Sie einen Wert übergeben, der FileSystem für diesen Parameter enthält. Andernfalls ist dieser Anbieter deaktiviert und Sie können diese Buckets nicht mehr verwenden. |
|
| Nur obligatorisch, wenn FileSystem als Bucket-Anbieter ausgewählt wird. Die Liste der Speicherorte, an denen Sie die Erstellung von Buckets für den FileSystem-Anbieter zulassen möchten. Wenn Sie den FileSystem-Anbieter aktivieren, müssen Sie für diesen Parameter auch einen Wert übergeben. Werte sind eine Liste von UNC-Pfaden, die durch einen senkrechten Strich | getrennt sind (z. B. \mysharedstorage\mybyckets\myotherserver\myotherbuckets). |
|
| Optional. Ermöglicht Ihnen die Veröffentlichung im Azure App-Dienst, indem Sie sich auf Ihre eigene Benutzeridentität verlassen, ohne einen Dienstprinzipal erstellen zu müssen. Wenn dieser Parameter verwendet wird, ist der Parametersatz UseServicePrincipal (der Elemente wie die Azure Anwendungs-ID, das Kennwort, die Abonnement-ID und die Mandanten-ID enthält) nicht mehr erforderlich. |
|
| Optional. Allows you to include the external URL of the Orchestrator app service in cases where a custom URL is used. If this parameter is not populated, the app service default URL is used instead. |
-azureUSGovernmentLogin | Optional. Dieser Parameter wird nur für Bereitstellungen der US-Regierung verwendet. |
Parameter bei der Aktualisierung beibehalten
Die folgenden UiPath.Orchestrator.dll.config-Parameterwerte werden beim Durchführen einer Aktualisierung automatisch migriert und beibehalten. Um sie zu ändern, geben Sie beim Aufrufen des Skripts Publish-Orchestrator.ps1 neue Werte an.
-NuGet.Packages.ApiKey
-NuGet.Activities.ApiKey
-NuGet.Packages.Path
-NuGet.Activities.Path
-machineKey/@decryption
-machineKey/@decryptionKey
-machineKey/@validationKey
-EncryptionKey
-NuGet.Repository.Type
-Storage.Type
-Storage.Location
-LoadBalancer.Redis.ConnectionString
-LoadBalancer.UseRedis
-Scalability.AzureSignalR.ConnectionString
-nlog/targets/target/@name=robotElasticBuffer/@name=RobotElastic/@uri
-nlog/targets/target/@name=robotElasticBuffer/@name=RobotElastic/@username
-nlog/targets/target/@name=robotElasticBuffer/@name=RobotElastic/@password
-nlog/rules/logger/@name=Robot.*/@writeTo
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@uri
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@username
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@password
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@index
-nlog/rules/logger/@name=*/@writeTo
-NuGet.Packages.ApiKey
-NuGet.Activities.ApiKey
-NuGet.Packages.Path
-NuGet.Activities.Path
-machineKey/@decryption
-machineKey/@decryptionKey
-machineKey/@validationKey
-EncryptionKey
-NuGet.Repository.Type
-Storage.Type
-Storage.Location
-LoadBalancer.Redis.ConnectionString
-LoadBalancer.UseRedis
-Scalability.AzureSignalR.ConnectionString
-nlog/targets/target/@name=robotElasticBuffer/@name=RobotElastic/@uri
-nlog/targets/target/@name=robotElasticBuffer/@name=RobotElastic/@username
-nlog/targets/target/@name=robotElasticBuffer/@name=RobotElastic/@password
-nlog/rules/logger/@name=Robot.*/@writeTo
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@uri
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@username
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@password
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@index
-nlog/rules/logger/@name=*/@writeTo
Beispiele
Einzelknoten-Installation
Im folgenden Beispiel können Sie eine Neuinstallation von Orchestrator auf einem Knoten durchführen, Elasticsearch für die Protokollierung verwenden und Pakete im Azure-Blobspeicher und deren Metadaten in der SQL-Datenbank speichern. Die Prozedur erfolgt -unattended und protokolliert ihre Schritte auf -verbose-Ebene.
.\Publish-Orchestrator.ps1 `
-action "Deploy" `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-testAutomationFeatureEnabled
-updateServerFeatureEnabled
-storageType "Azure" `
-storageLocation "DefaultEndpointsProtocol=https;AccountName=usr;AccountKey=...;EndpointSuffix=core.windows.net" `
-robotsElasticSearchUrl "http://docelasticserver:9200" `
-verbose
.\Publish-Orchestrator.ps1 `
-action "Deploy" `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-testAutomationFeatureEnabled
-updateServerFeatureEnabled
-storageType "Azure" `
-storageLocation "DefaultEndpointsProtocol=https;AccountName=usr;AccountKey=...;EndpointSuffix=core.windows.net" `
-robotsElasticSearchUrl "http://docelasticserver:9200" `
-verbose
Mehrfach-Knoten-Installation
Im folgenden Beispiel können Sie eine Neuinstallation von Orchestrator auf mehreren Knoten durchführen und Elasticsearch für die Protokollierung und Redis für die Zwischenspeicherung und Nachrichtenverteilung verwenden. Pakete werden im Azure-Blobspeicher und deren Metadaten in der SQL-Datenbank gespeichert. Die Prozedur erfolgt -unattended und protokolliert ihre Schritte auf -verbose-Ebene.
.\Publish-Orchestrator.ps1 `
-action "Deploy" `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-redisConnectionString "docs123.redis.cache.windows.net:6380,passwprd=******,ssl=True" `
-azureSignalRConnectionString "Endpoint=https://doctest.signalr.net;AccessKey=*****;Version=1.0;" `
-robotsElasticSearchUrl "http://docelasticserver:9200" `
-storageType "Azure" `
-storageLocation "DefaultEndpointsProtocol=https;AccountName=usr;AccountKey=...;EndpointSuffix=core.windows.net" `
-verbose
.\Publish-Orchestrator.ps1 `
-action "Deploy" `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-redisConnectionString "docs123.redis.cache.windows.net:6380,passwprd=******,ssl=True" `
-azureSignalRConnectionString "Endpoint=https://doctest.signalr.net;AccessKey=*****;Version=1.0;" `
-robotsElasticSearchUrl "http://docelasticserver:9200" `
-storageType "Azure" `
-storageLocation "DefaultEndpointsProtocol=https;AccountName=usr;AccountKey=...;EndpointSuffix=core.windows.net" `
-verbose
Aktualisierung mehrerer Knoten
Im folgenden Beispiel können Sie einen vorhandenen Orchestrator mit mehreren Knoten auf die neueste verfügbare Version aktualisieren, ohne dass bereits vorhandene Einstellungen geändert werden müssen. Die Prozedur erfolgt -unattended und protokolliert ihre Schritte auf -verbose-Ebene.
Publish-Orchestrator.ps1 `
-action Update `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-verbose
Publish-Orchestrator.ps1 `
-action Update `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-verbose
Im folgenden Beispiel können Sie einen vorhandenen Orchestrator mit mehreren Knoten auf die neueste verfügbare Version aktualisieren, während nur der Wert der Parameter Webhooks.Enabled und Telemetry.Enabled in false geändert wird. Die Prozedur erfolgt -unattended und protokolliert ihre Schritte auf -verbose-Ebene.
Publish-Orchestrator.ps1 `
-action Update `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-appSettings @{"Webhooks.Enabled"="false"; "Telemetry.Enabled"="false"} `
-verbose
Publish-Orchestrator.ps1 `
-action Update `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-appSettings @{"Webhooks.Enabled"="false"; "Telemetry.Enabled"="false"} `
-verbose