orchestrator
2025.10
true
- 入门指南
- 要求
- 最佳实践
- 安装
- 正在更新
- 身份服务器
- 对启动错误进行故障排除
重要 :
新发布内容的本地化可能需要 1-2 周的时间才能完成。

Orchestrator 安装指南
上次更新日期 2026年3月24日
使用 Windows 安装程序更新
警告:
请记住,这些信息与您要升级到的目标版本有关,与升级前的版本无关。因此,在继续之前,请确保阅读正确的详细信息。
概述
更新流程可能会有所不同,具体取决于是否:
- 以前的版本是使用 Windows Installer 设置的;
- 您的 Orchestrator 实例位于多节点环境中。
重要提示:
- 升级前,请访问目标升级版本的硬件要求、软件要求和先决条件页面,因为相关内容可能已发生变化。您需要确保在升级前满足所有要求。
- 升级后,我们建议您重新启动所有机器人,以便其应用新设置。
- 如果您的包(活动和/或工作流)存储在共享文件夹中,请注意
UiPathOrchestrator.msi安装程序需要获取上述目录的写入访问权限。 - 从 v2020.4 开始Orchestrator 的 SSL 证书要求将会增多。请确保满足所有先决条件。有关如何更改现有证书,请参阅使用 HTTPS 协议的证书
- 仔细检查选定的安装路径。不支持将安装从一个位置移动到另一个安装后位置。
- 建议同时为 Identity Server 和 Webhook 保留以前的 Orchestrator 应用程序池身份类型。否则,访问 SQL Server 时可能会发生问题。
- 如果您正在考虑安装 Insights,请确保按照要求在配置 Insights SQL Server 时选择
db_owner角色。 - 如果您从低于 2021.10 且已选择 Windows 身份验证选项的版本进行升级,请确保以 AD 用户身份运行安装程序。
使用 Windows 安装程序安装的以前版本
要从之前使用 Windows 安装程序安装的版本更新 Orchestrator,请执行以下操作:
- 备份自动化包、
web.config和UiPath.Orchestrator.dll.config文件,以及数据库。 - 从Customer Portal下载
UiPathOrchestrator.msi文件,选择您的版本。 - 运行
UiPathOrchestrator.msi安装程序。Orchestrator 将以UiPathOrchestrator名称安装,同时系统会更新数据库,并迁移所有数据。在此阶段,您还可以更新 Identity Server 和更新服务器的设置。 - 如果您使用 HAA 管理缓存,请使用以下命令刷新所有 HAA 缓存键:
redis-cli -h <hostname> -p <portnumber> -a <password> flushall。请注意,默认情况下,HAA 使用端口10000。例如:redis-cli -h redis-12345.c24.us-east-mz-1.ec2.cloud.redislabs.com -p 10000 -a xyz flushallredis-cli -h redis-12345.c24.us-east-mz-1.ec2.cloud.redislabs.com -p 10000 -a xyz flushall - 如果您使用 Insights,请确保在升级 Orchestrator 之前备份 Insights 数据库。
多节点环境
在多节点环境中,在主节点和辅助节点上进行升级的方式不同。需要执行以下步骤来更新所有节点。
备注:
Although you provide the admin passwords at host and default tenant level, they are not taken into account. Use your previous passwords to log in.
备份文件
备份自动化包、web.config 和 UiPath.Orchestrator.dll.config 文件,以及数据库。
主节点安装
对于有人值守的安装:从管理员命令提示符运行以下命令:
UiPathOrchestrator.msi OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log
UiPathOrchestrator.msi OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log
对于无人值守的安装:从管理员命令提示符运行以下命令:
UiPathOrchestrator.msi PUBLIC_URL=https://hostname.local APPPOOL_USER_NAME=serviceAccount APPPOOL_PASSWORD=pass OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log /Q
UiPathOrchestrator.msi PUBLIC_URL=https://hostname.local APPPOOL_USER_NAME=serviceAccount APPPOOL_PASSWORD=pass OUTPUT_PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log /Q
按照此处所述,进行安装。
重要提示:
不要忘记备份安装产生的 upgradeParams.json 配置文件。这将用于后续的辅助节点安装流程。
辅助节点安装
建议使用主节点上生成的 upgradeParams.json 配置文件运行无人值守安装程序。从“管理员命令提示符”运行以下命令:
UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log /Q
UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log /Q
平键
如果您使用 HAA 管理缓存,请使用以下命令从主动-主动数据库中刷新所有 HAA 缓存密钥:
crdb-cli crdb flush --crdb-guid <guid> [ --no-wait ]
crdb-cli crdb flush --crdb-guid <guid> [ --no-wait ]
重要提示:
如果要使用并发运行时许可证类型,请注意,从 v2020.4 之前的版本更新时,如果设置了高密度机器人,则系统会自动将每台计算机的运行时数量设置为 1,而非该计算机上的机器人总数。