orchestrator
2024.10
true
- 基本情報
- 要件
- ベスト プラクティス
- インストール
- 更新
- Identity Server
- High Availability Add-on
- 起動エラーのトラブルシューティング
Azure スクリプトを使用して更新する
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。
Orchestrator インストール ガイド
Last updated 2024年12月4日
Azure スクリプトを使用して更新する
警告: この情報は、アップグレード元のバージョンではなく、アップグレード先のバージョンに関するものですのでご注意ください。そのため、作業を続行する前に必ず正しい詳細情報をお読みください。
重要:
- これまでこの操作を行ったことのない場合 (例:
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
スクリプトを実行します。 -
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
スクリプトをローカル マシンにダウンロードしたら、以下のスクリプトを実行し、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>" -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
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>" -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
重要: これまでこの操作を行ったことのない場合 (例:
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
重要: これまでこの操作を行ったことのない場合 (例:
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 -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
スクリプトを実行する必要があります。