orchestrator
2023.10
false
- Erste Schritte
- Anforderungen
- Best Practices
- Installation
- Wird aktualisiert
- Identity Server
- Fehlerbehebung bei Startfehlern
Aktualisierung mihilfe des Azure-Skripts
Installationsanleitung für den Orchestrator
Last updated 3. Okt. 2024
Aktualisierung mihilfe des Azure-Skripts
Warnung: 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.
Wichtig:
- 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.
Nachdem Sie das neueste
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>" -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>" -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>" -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>" -testAutomationFeatureEnabled -insightsFeatureEnabled -updateServerFeatureEnabled -Verbose
Wichtig: Wenn Sie dies noch nicht getan haben (z. B. Aktualisieren von
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.
Nachdem Sie das neueste
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
Wichtig: Wenn Sie dies noch nicht getan haben (z. B. Upgrade von
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.
Nachdem Sie das neueste
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
Nachdem Sie das neueste
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>"
Wichtig: Das Skript
MigrateTo-ResourceCatalog.ps1
muss ausgeführt werden, wenn der Ressourcenkatalogdienst aktualisiert wird.