- Erste Schritte
- Anforderungen
- Best Practices
- Installation
- Wird aktualisiert
- Identity Server
- Fehlerbehebung bei Startfehlern
Installationsanleitung für den Orchestrator
Aktualisierung mihilfe des Azure-Skripts
-
Wenn Sie Active Directory (AD) verwenden und ein Upgrade auf 2023.4.0 planen, empfehlen wir dringend, direkt zur Version 2023.4.3 zu springen, da 2023.4.0, 2023.4.1 und 2023.4.2 von einem AD-Problem betroffen sind.
- Wenn Sie dies noch nicht getan haben (z. B. beim Upgrade von
v2019.10
), stellen Sie sicher, dass Sie die App-Dienste für folgende Themen erstellt haben:- Identity Server
- Webhooks-Dienst
- Ressourcenkatalogdienst
- Stellen Sie vor dem Ausführen des
Publish-Orchestrator.ps1
-Skripts sicher, dass Sie das AzureRM PowerShell-Modul deinstalliert haben. Wir empfehlen Az als Alternative. Die gleichzeitige Installation von AzureRM- und Az-Modulen wird nicht unterstützt. - Wenn die gewünschte Az-Version nicht erkannt wird und AzureRM beim Ausführen des Skripts vorhanden ist, müssen Sie das Entfernen von AzureRM auch bei unbeaufsichtigten Installationen bestätigen.
- Bei einem Upgrade auf Az v6.0.0 wenn bei Verwendung einer früheren Version des Moduls folgende Meldung eingeblendet:
WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications.
(„WARNUNG: Die Version „x.x.x“ des Moduls „Az“ wird aktuell verwendet. Schließen Sie die Anwendungen und versuchen Sie es erneut“). Um dieses Problem zu lösen, stellen Sie sicher, dass SiePublish-Orchestrator.ps1
in einer neuen PowerShell-Sitzung ausführen.
-
Laden Sie das neueste verfügbare Archiv
UiPathOrchestrator.zip
herunter. -
Heben Sie die Blockierung der Datei
UiPathOrchestrator.zip
mithilfe des PowerShell-BefehlsUnblock-File
auf. Zum Beispiel:Unblock-File .\UiPathOrchestrator.zip
. -
UiPathOrchestrator.zip
entarchivieren. -
Führen Sie das
Publish-Orchestrator.ps1
-Skript in PowerShell für die Orchestrator-Instanz aus, die Sie aktualisieren möchten, wie unten gezeigt. Berücksichtigen Sie, dass Ihre UiPath.Orchestrator.dll.config-Einstellungen (früher web.config) beibehalten werden, wenn sie nicht explizit als Skriptparameter angegeben sind. -
Führen Sie das Skript
Publish-IdentityServer.ps1
in PowerShell in Ihrer Identity Server-Instanz aus, wie unten gezeigt. -
Führen Sie das Skript
Publish-Webhooks.ps1
in PowerShell in Ihrer Webhooks-Dienstinstanz aus, wie unten gezeigt. -
Führen Sie das
Publish-ResourceCatalog.ps1
-Skript in PowerShell auf Ihrer Instanz des Ressourcenkatalogdiensts aus, wie unten gezeigt. -
Führen Sie das
MigrateTo-ResourceCatalog.ps1
-Skript in PowerShell mit den hier beschriebenen Parametern aus. -
Öffnen Sie die Web-App im Azure-Portal, navigieren Sie dann zu Konfiguration > Allgemeine Einstellungen, und überprüfen Sie die folgenden Einstellungen:
-
Stack
muss auf.NET Core
festgelegt sein. -
Platform
muss auf64 Bit
festgelegt sein. -
Web sockets
sollte aufOn
festgelegt werden, wenn Sie den Azure SignalR-Dienst nicht verwenden
-
-
Starten Sie den Orchestrator-App-Dienst. Genießen Sie die Verwendung von Orchestrator auf Ihrem Azure-Portal.
-
Starten Sie den UiPath-Roboter-Dienst auf allen Robotermaschinen, die Sie mit Orchestrator verbunden haben, wieder neu.
Publish-Orchestrator.ps1
-Skript auf Ihre lokale Maschine heruntergeladen haben, führen Sie das Skript wie folgt aus, um den Orchestrator zu aktualisieren:
.\Publish-Orchestrator.ps1 -action Update -package .\UiPath.Orchestrator.Web.zip -stopApplicationBeforePublish -azureSubscriptionId "<azure_subscription_id>" -azureAccountTenantId "<azure_account_tenant_id>" -azureAccountApplicationId "<azure_application_id>" -azureAccountPassword "<azure_account_password>" -resourceGroupName "<resourcegroup_name>" -appServiceName "<app_service_name>" -confirmBlockClassicExecutions -Verbose
.\Publish-Orchestrator.ps1 -action Update -package .\UiPath.Orchestrator.Web.zip -stopApplicationBeforePublish -azureSubscriptionId "<azure_subscription_id>" -azureAccountTenantId "<azure_account_tenant_id>" -azureAccountApplicationId "<azure_application_id>" -azureAccountPassword "<azure_account_password>" -resourceGroupName "<resourcegroup_name>" -appServiceName "<app_service_name>" -confirmBlockClassicExecutions -Verbose
Um die Module für Testautomatisierung, Insights und Update Server einzuschließen, führen Sie das Skript wie folgt aus:
.\Publish-Orchestrator.ps1 -action Update -package .\UiPath.Orchestrator.Web.zip -stopApplicationBeforePublish -azureSubscriptionId "<azure_subscription_id>" -azureAccountTenantId "<azure_account_tenant_id>" -azureAccountApplicationId "<azure_application_id>" -azureAccountPassword "<azure_account_password>" -resourceGroupName "<resourcegroup_name>" -appServiceName "<app_service_name>" -confirmBlockClassicExecutions -testAutomationFeatureEnabled -insightsFeatureEnabled -updateServerFeatureEnabled -Verbose
.\Publish-Orchestrator.ps1 -action Update -package .\UiPath.Orchestrator.Web.zip -stopApplicationBeforePublish -azureSubscriptionId "<azure_subscription_id>" -azureAccountTenantId "<azure_account_tenant_id>" -azureAccountApplicationId "<azure_application_id>" -azureAccountPassword "<azure_account_password>" -resourceGroupName "<resourcegroup_name>" -appServiceName "<app_service_name>" -confirmBlockClassicExecutions -testAutomationFeatureEnabled -insightsFeatureEnabled -updateServerFeatureEnabled -Verbose
v2019.10
), stellen Sie sicher, dass Sie den App-Dienst für Identity Server erstellt haben. Stellen Sie sicher, dass das Skript Publish-IdentityServer.ps1
auf den Identity Server-App-Dienst ausgerichtet ist.
Publish-IdentityServer.ps1
-Skript auf Ihre lokale Maschine heruntergeladen haben, führen Sie das Skript wie folgt aus, um die Identity Server Azure-Web-App zu aktualisieren:
.\Publish-IdentityServer.ps1 ` -action Update ` -azureSubscriptionId "<azure_subscription_id>" ` -azureAccountTenantId "<azure_tenant_id>" ` -azureAccountApplicationId "<azure_application_id>" ` -azureAccountPassword "<azure_account_password>" ` -orchestratorURL "https://<orchestratorURL>" ` -identityServerUrl "https://<IdentityServerURL>/identity" ` -orchDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>"; targetSlot = "Production" } ` -identityServerDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>"; targetSlot = "Production" } ` -package "UiPath.IdentityServer.Web.zip" ` -cliPackage "UiPath.IdentityServer.Migrator.Cli.zip" ` -resourceCatalogUrl "<resource_catalog_url>" ` -stopApplicationBeforePublish ` -unattended
.\Publish-IdentityServer.ps1 ` -action Update ` -azureSubscriptionId "<azure_subscription_id>" ` -azureAccountTenantId "<azure_tenant_id>" ` -azureAccountApplicationId "<azure_application_id>" ` -azureAccountPassword "<azure_account_password>" ` -orchestratorURL "https://<orchestratorURL>" ` -identityServerUrl "https://<IdentityServerURL>/identity" ` -orchDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>"; targetSlot = "Production" } ` -identityServerDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>"; targetSlot = "Production" } ` -package "UiPath.IdentityServer.Web.zip" ` -cliPackage "UiPath.IdentityServer.Migrator.Cli.zip" ` -resourceCatalogUrl "<resource_catalog_url>" ` -stopApplicationBeforePublish ` -unattended
v2019.10
), stellen Sie sicher, dass Sie den App-Dienst für den Webhooks-Diensterstellt haben. Stellen Sie sicher, dass das Publish-Webhooks.ps1
-Skript auf den Webhooks-App-Dienst ausgerichtet ist.
UiPath.WebhookService.Web.zip
-Skript auf Ihre lokale Maschine heruntergeladen haben, führen Sie das Publish-Webhooks.ps1
-Skript wie folgt aus, um die Identity Server Azure-Web-App zu aktualisieren:
.\Publish-Webhooks.ps1 ` -action Update ` -package "UiPath.WebhookService.Web.zip" ` -azureAccountApplicationId "<azure_application_id>" ` -azureAccountPassword "<azure_account_password>" ` -azureSubscriptionId "<subscription_id>" ` -azureAccountTenantId "<azure_tenant_id>" ` -resourceGroupName "<resourcegroup_name>" ` -appServiceName "<appservice_name>" ` -stopApplicationBeforePublish
.\Publish-Webhooks.ps1 ` -action Update ` -package "UiPath.WebhookService.Web.zip" ` -azureAccountApplicationId "<azure_application_id>" ` -azureAccountPassword "<azure_account_password>" ` -azureSubscriptionId "<subscription_id>" ` -azureAccountTenantId "<azure_tenant_id>" ` -resourceGroupName "<resourcegroup_name>" ` -appServiceName "<appservice_name>" ` -stopApplicationBeforePublish
Publish-ResourceCatalog.ps1
-Skript auf Ihre lokale Maschine heruntergeladen haben, führen Sie das Skript wie folgt aus, um den Ressourcenkatalogdienst zu aktualisieren:
.\Publish-ResourceCatalog.ps1 -action update -package "UiPath.ResourceCatalogService-Win64.zip" -azureSubscriptionId "<azure_subscription_id>" -azureAccountTenantId "<azure_account_tenant_id>" -azureAccountApplicationId "<azure_application_id>" -azureAccountPassword "<azure_account_password>" -resourceGroupName "<resourcegroup_name>" -appServiceName "<appservice_name>"
.\Publish-ResourceCatalog.ps1 -action update -package "UiPath.ResourceCatalogService-Win64.zip" -azureSubscriptionId "<azure_subscription_id>" -azureAccountTenantId "<azure_account_tenant_id>" -azureAccountApplicationId "<azure_application_id>" -azureAccountPassword "<azure_account_password>" -resourceGroupName "<resourcegroup_name>" -appServiceName "<appservice_name>"
MigrateTo-ResourceCatalog.ps1
muss ausgeführt werden, wenn der Ressourcenkatalogdienst aktualisiert wird.