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 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 Sie Publish-Orchestrator.ps1 in einer neuen PowerShell-Sitzung ausführen.

1. Laden Sie das neueste verfügbare Archiv UiPathOrchestrator.zip herunter.
2. Heben Sie die Blockierung der Datei UiPathOrchestrator.zip mithilfe des PowerShell-Befehls Unblock-Fileauf. Zum Beispiel: Unblock-File .\UiPathOrchestrator.zip.
3. UiPathOrchestrator.zip entarchivieren.
4. 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.
5. Führen Sie das Skript Publish-IdentityServer.ps1 in PowerShell in Ihrer Identity Server-Instanz aus, wie unten gezeigt.
6. Führen Sie das Skript Publish-Webhooks.ps1 in PowerShell in Ihrer Webhooks-Dienstinstanz aus, wie unten gezeigt.
7. Führen Sie das Publish-ResourceCatalog.ps1-Skript in PowerShell auf Ihrer Instanz des Ressourcenkatalogdiensts aus, wie unten gezeigt.
8. Run the MigrateTo-ResourceCatalog.ps1 script, in PowerShell, using the parameters described here.
9. Wenn Sie eine Orchestrator-Instanz mit mehreren Knoten aktualisieren, löschen Sie alle Redis-Cache-Schlüssel mit dem Befehl FLUSHALL oder FLUSHDB. Ausführliche Informationen darüber finden Sie hier oder hier.
10. Ö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 auf 64 Bit festgelegt sein.
    • Web sockets sollte auf On festgelegt werden, wenn Sie den Azure SignalR-Dienst nicht verwenden
11. Starten Sie den Orchestrator-App-Dienst. Genießen Sie die Verwendung von Orchestrator auf Ihrem Azure-Portal.
12. Starten Sie den UiPath-Roboter-Dienst auf allen Robotermaschinen, die Sie mit Orchestrator verbunden haben, wieder neu.

Publish-Orchestrator.ps1 – Aktualisierung

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>" -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-IdentityServer.ps1-Update

Wichtig:

If you have not previously done so (e.g. upgrading from v2019.10), ensure that you have created the app service for Identity Server. Make sure the Publish-IdentityServer.ps1 script targets the Identity Server app service.

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-Webhooks.ps1 Update

Wichtig:

Wenn Sie dies noch nicht getan haben (z. B Aktualisieren von v2019.10), stellen Sie sicher, dass Sie den App-Dienst für den Webhooks-Dienst erstellt 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-ResourceCatalog.ps1 – Aktualisierung

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>"

Wichtig:

Das Skript MigrateTo-ResourceCatalog.ps1 muss ausgeführt werden, wenn der Ressourcenkatalogdienst aktualisiert wird.