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 を実行してください。

1. 入手可能な最新の UiPathOrchestrator.zip アーカイブをダウンロードします。
2. PowerShell コマンド Unblock-File を使用して UiPathOrchestrator.zip ファイルのブロックを解除します。たとえば、Unblock-File .\UiPathOrchestrator.zip となります。
3. UiPathOrchestrator.zip のアーカイブを解除します。
4. 以下に示すように、PowerShell の Publish-Orchestrator.ps1 スクリプトを、更新する Orchestrator インスタンスに対して実行します。UiPath.Orchestrator.dll.config (以前の web.cofig) の設定は、スクリプトのパラメーターとして明示的に指定しない限り、保持されることに注意してください。
5. 以下に示すように、Identity Server インスタンス上の PowerShell で Publish-IdentityServer.ps1 スクリプトを実行します。
6. 以下に示すように、Webhook サービス インスタンス上の PowerShell で Publish-Webhooks.ps1 スクリプトを実行します。
7. 以下に示すように、リソース カタログ サービス インスタンス上の PowerShell で Publish-ResourceCatalog.ps1 スクリプトを実行します。
8. こちらに記載されたパラメーターを使用して、Powershell で MigrateTo-ResourceCatalog.ps1 スクリプトを実行します。
9. マルチノードの Orchestrator インスタンスを更新する場合は、FLUSHALL または FLUSHDB コマンドを使用して、すべての Redis キャッシュ キーをフラッシュします。詳細については、こちらおよびこちらをご覧ください。

10. Azure Portal で Web アプリを開き、[設定] > [全般設定] に移動して、以下を確認します。

    • Stack が .NET Core に設定されていること。
    • Platform が 64 Bit に設定されていること。
    • Azure SignalR Service を使用していない場合、Web sockets を On に設定する必要があります。

11. Orchestrator アプリケーション サービスを開始します。Azure Portal で Orchestrator を使用してください。

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

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

重要: リソース カタログ サービスをアップグレードするときには、MigrateTo-ResourceCatalog.ps1 スクリプトを実行する必要があります。