Azure スクリプトを使用して更新する

警告: この情報は、アップグレード元のバージョンではなく、アップグレード先のバージョンに関するものですのでご注意ください。そのため、作業を続行する前に必ず正しい詳細情報をお読みください。

重要:

Active Directory (AD) を使用していて、v2023.4.0 へのアップグレードを計画している場合は、v2023.4.0、v2023.4.1、v2023.4.2 が AD の問題の影響を受けているため、スキップして v2023.4.3 にアップグレードすることを強くお勧めします。
これまでこの操作を行ったことのない場合 (例: v2019.10 からのアップグレード)、次のアプリケーションサービスを作成してあることを確認してください。
- Identity Server
- Webhook サービス
- リソースカタログサービス
Publish-Orchestrator.ps1 スクリプトを実行する前に、AzureRM PowerShell モジュールが削除されていることを確認してください。代わりに Az を使用することをお勧めします。AzureRM モジュールと Az モジュールの両方が同時にインストールされた状態はサポートされません。
スクリプトの実行時に、必要な Az バージョンが検出されず、AzureRM が存在する場合、無人インストールであっても、AzureRM の削除を確認するメッセージが表示されます。
以前のバージョンの Az モジュールが使用されている状態で Az v6.0.0 にアップグレードしようとすると、WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications. (警告: バージョン 'x.x.x' のモジュール 'Az.<Name>' が現在使用されています。アプリケーションを閉じてから操作をもう一度お試しください。) というメッセージが表示されます。この問題を解決するには、新しい PowerShell セッションで Publish-Orchestrator.ps1 を実行してください。

入手可能な最新の UiPathOrchestrator.zip アーカイブをダウンロードします。
PowerShell コマンド Unblock-File を使用して UiPathOrchestrator.zip ファイルのブロックを解除します。たとえば、Unblock-File .\UiPathOrchestrator.zip となります。
UiPathOrchestrator.zip のアーカイブを解除します。
以下に示すように、PowerShell の Publish-Orchestrator.ps1 スクリプトを、更新する Orchestrator インスタンスに対して実行します。UiPath.Orchestrator.dll.config (以前の web.cofig) の設定は、スクリプトのパラメーターとして明示的に指定しない限り、保持されることに注意してください。
以下に示すように、Identity Server インスタンス上の PowerShell で Publish-IdentityServer.ps1 スクリプトを実行します。
以下に示すように、Webhook サービスインスタンス上の PowerShell で Publish-Webhooks.ps1 スクリプトを実行します。
以下に示すように、リソースカタログサービスインスタンス上の PowerShell で Publish-ResourceCatalog.ps1 スクリプトを実行します。
こちらに記載されたパラメーターを使用して、Powershell で MigrateTo-ResourceCatalog.ps1 スクリプトを実行します。
マルチノードの Orchestrator インスタンスを更新する場合は、FLUSHALL または FLUSHDB コマンドを使用して、すべての Redis キャッシュキーをフラッシュします。詳細については、こちらおよびこちらをご覧ください。
Azure Portal で Web アプリを開き、[設定] > [全般設定] に移動して、以下を確認します。
- Stack が .NET Core に設定されていること。
- Platform が 64 Bit に設定されていること。
- Azure SignalR Service を使用していない場合、Web sockets を On に設定する必要があります。
Orchestrator アプリケーションサービスを開始します。Azure Portal で Orchestrator を使用してください。
Orchestrator に接続したすべてのロボット端末で UiPath Robot サービスを再起動します。

Publish-Orchestrator.ps1 の更新

最新の Publish-Orchestrator.ps1 スクリプトをローカルマシンにダウンロードしたら、以下のスクリプトを実行し、Orchestrator を更新します。

.\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

Test Automation、Insights、および更新サーバーのモジュールを含めるには、以下のスクリプトを実行します。

.\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

Publish-IdentityServer.ps1 の更新

重要: これまでこの操作を行ったことのない場合 (例: v2019.10 からのアップグレード)、Identity Server のアプリケーションサービスを作成していることを確認してください。Publish-IdentityServer.ps1 スクリプトのターゲットに Identity Server のアプリケーションサービスが指定されていることを確認します。

最新の Publish-IdentityServer.ps1 スクリプトをローカルマシンにダウンロードしたら、以下のスクリプトを実行し、Identity Server Azure Web アプリを更新します。

.\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

Publish-Webhooks.ps1 の更新

重要: これまでこの操作を行ったことのない場合 (例: v2019.10 からのアップグレード)、Webhook サービスのアプリケーションサービスを作成していることを確認してください。Publish-Webhooks.ps1 スクリプトのターゲットに Webhook のアプリケーションサービスが指定されていることを確認します。

最新の UiPath.WebhookService.Web.zip アーカイブをローカルマシンにダウンロードして展開したら、以下の Publish-Webhooks.ps1 スクリプトを実行し、Webhook サービス Azure Web アプリを更新します。

.\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 の更新

最新の Publish-ResourceCatalog.ps1 スクリプトをローカルマシンにダウンロードしたら、以下のスクリプトを実行し、リソースカタログサービスを更新します。

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