orchestrator
2024.10
true
- 入门指南
- 要求
- 最佳实践
- 安装
- 正在更新
- 身份服务器
- High Availability Add-On
- 对启动错误进行故障排除
使用 Azure 脚本进行更新
Orchestrator 安装指南
Last updated 2024年12月4日
使用 Azure 脚本进行更新
警告: 请记住,这些信息与您要升级到的目标版本有关,与升级前的版本无关。因此,在继续之前,请确保阅读正确的详细信息。
重要提示:
- 如果您以前没有这样做过(例如,从
v2019.10
升级),请确保已为以下项目创建了应用程序服务:- 身份服务器
- Webhook 服务
- 资源目录服务
- 在运行
Publish-Orchestrator.ps1
脚本之前,请确保卸载 AzureRM PowerShell 模块。我们建议使用 Az 模块作为替代方案。不支持同时安装 AzureRM 和 Az 模块。 - 如果未检测到所需的 Az 版本,并且在运行脚本时存在 AzureRM,则即使在无人值守的安装上,系统也会提示您确认是否删除 AzureRM。
- 如果在使用任何先前版本的模块时升级到 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.
。为了解决此问题,请确保在新的 PowerShell 会话中执行Publish-Orchestrator.ps1
。
-
Download the latest available
UiPathOrchestrator.zip
archive. -
Unblock the
UiPathOrchestrator.zip
file using the PowerShell commandUnblock-File
. For example,Unblock-File .\UiPathOrchestrator.zip
. -
Unarchive
UiPathOrchestrator.zip
. -
在要更新的 Orchestrator 实例上的 PowerShell 中运行
Publish-Orchestrator.ps1
脚本。考虑到,如果 UiPath.Orchestrator.dll.config(先前为 web.config)设置未显式指定为脚本参数,则会将其保留。 -
如下所示,在 PowerShell 中的 Identity Server 实例上运行
Publish-IdentityServer.ps1
。 -
如下所示,在 PowerShell 中的 Webhooks 服务实例上运行
Publish-Webhooks.ps1
。 -
如下所示,在 PowerShell 中的源目录服务实例上运行
Publish-ResourceCatalog.ps1
。 -
使用此处描述的参数,在 PowerShell 中运行
MigrateTo-ResourceCatalog.ps1
脚本。 -
在 Azure 门户中打开网页应用程序,然后导航到配置 > 常规设置并检查以下设置:
-
Stack
应该设置为.NET Core
。 -
Platform
应该设置为64 Bit
。 -
如果您不使用 Azure SignalR 服务,则应将
Web sockets
设置为On
-
-
Start the Orchestrator app service. Enjoy using Orchestrator on your Azure Portal.
-
在已连接到 Orchestrator 的所有机器人计算机上重新启动 UiPath 机器人服务。
将最新的
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
要包括“测试自动化”、“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
脚本下载到本地计算机后,请按下方所示运行脚本以更新身份服务器 Azure 网页应用程序:
.\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
升级),请确保已为 Webhooks 服务创建应用程序服务。 确保 Publish-Webhooks.ps1
脚本以 Webhooks 应用程序服务为目标。
将最新的
UiPath.WebhookService.Web.zip
存档下载并提取至本地计算机后,请按下方所示运行 Publish-Webhooks.ps1
脚本以更新身份服务器 Azure 网页应用程序:
.\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
脚本。