- 入门指南
- 简介
- 自动更新客户端组件
- 生存期
- Orchestrator 出站 IP 地址
- 通知
- 最佳实践
- 租户
- Cloud Robots
- 文件夹上下文
- 自动化
- 流程
- 作业
- Apps
- 触发器
- 日志
- 监控
- 队列
- 资产
- 业务规则
- 存储桶
- 索引
- Orchestrator 测试
- 资源目录服务
- 集成
- 故障排除

Orchestrator 用户指南
自动更新客户端组件
此功能允许管理员从 Orchestrator 将 Robot、Studio 和 UiPath™ Assistant 客户端更新到较新版本。这提供了一种从集中位置向大量计算机交付版本更新的简单方法,从而帮助消除用户的烦恼并简化更新过程。
- Orchestrator、Studio 和 Robot 2021.10 或更高版本。
- 客户端计算机上安装了 Studio 和/或 Robot 2021.10 或更高版本,并且已连接到 Orchestrator。
UiPathStudio.msi
安装程序或版本为 2024.10 或以上的 UiPathRobot.msi
安装程序安装 Robot 应用程序。2024.10 之前的 UiPathRobot.msi
安装程序版本不支持自动更新客户端组件。
UiPathRobot.msi
安装程序版本安装了 Robot,则可以使用 2024.10 或更高版本的 UiPathRobot.msi
安装程序手动更新 Robot 应用程序。
客户端
-
客户端应用程序:
- 机器人
- Assistant
- Studio
- 机器人服务
- 更新代理 - 一个 Windows 进程,负责用户和更新服务之间的通信。 (仅在用户模式和有人值守的机器人安装中存在)
- 更新服务 - 负责客户端计算机和更新服务器之间的通信的 Windows 服务。
服务器端
- Orchestrator:为管理员提供用户界面,以设置自动更新策略并查看客户端应用程序的版本状态。
- 更新服务器:一个集中式服务,用于管理自动更新策略并通过更新服务维护与客户端计算机的通信。
作为管理员,您可以选择要在特定计算机上部署的特定版本。
UiPath.UpdateService.Worker.exe
和 UiPath.UpdateService.Agent.exe
。
根据 Studio/Robot 安装的类型,它们的安装方式不同:
- Unattended Robot:
UiPath.UpdateService.Worker.exe
已安装为 Windows 服务,但未安装UiPath.UpdateService.Agent.exe
。 - Attended Robot:
UiPath.UpdateService.Worker.exe
已安装为 Windows 服务,而UiPath.UpdateService.Agent.exe
在任务计划程序中作为登录任务安装。 - 快速安装(用户模式):
UiPath.UpdateService.Worker.exe
和UiPath.UpdateService.Agent.exe
在任务计划程序中作为登录任务安装。重要提示:在计算机上以 Attended User 模式安装 UiPath Studio 和机器人时,为了使更新服务连接到更新服务器,请确保在设置过程中添加 Orchestrator URL。如果在安装期间未添加 Orchestrator URL,则在计算机上具有管理员权限的用户必须登录到计算机并将机器人连接到 Orchestrator。
定义新策略或更改策略后,更新服务器会向客户端计算机上的更新服务发送一个命令,该命令会询问客户端应用程序是否准备好开始更新过程。
要准备好接收更新,产品必须处于中性状态:
- Studio - 无正在运行的流程或活动会话。
- Robot - 无正在运行的作业或流程。
- Assistant - 无正在运行的流程或待处理活动(正在安装或下载流程)。
注意:在更新过程中,在更新完成之前,机器人不会启动任何作业。
在有人值守场景中,系统会显示更新提示,为用户提供两个选项:
Update Now
- 停止所有正在运行的作业并关闭该计算机上的所有 Studio 实例,然后继续更新。-
Later
- 使通知静音,可以通过转到系统托盘中的用户界面图标并单击“检查更新”来继续更新过程。当用户接受提示时,系统会将确认消息发送到更新服务,并启动更新流程。 如果自首次通知后 24 小时内未提供响应,则系统将自动安装更新。
在无人值守场景中,更新服务会确认客户端应用程序是否处于中性状态(如上所述),然后再将确认发送回更新服务器。
- 如果计算机上正在运行任何流程,则系统会提示机器人用户停止该流程或等待该流程完成,然后再继续更新。如果 Studio 会话已打开,则系统会要求机器人用户保存进度。
- 如果机器人用户未及时响应,则 Studio 将关闭,并在此时按原样保存流程。该流程可以在更新完成后恢复。
- 更新时所有处于活动状态的机器人都将进入维护模式,以确保它们在更新完成之前不会执行任何新作业。
- 对于用户模式机器人,最长等待时间为 1,440 分钟。
更新过程步骤
更新过程分为七个阶段:
重试机制
在更新过程中,如果在首次下载中无法检索到文件,则更新服务将再重试三次。重试间隔为:首次尝试后一小时,然后在第一次重试后两个小时,以及最后一次重试后四个小时。在每次重试之前,都会通过通知系统通知用户。
%localappdata%/Uipath/UpdateService/logs
文件中。
该过程与安装类似,这意味着如果第一次安装失败,更新服务将以相同的频率(首次尝试后一小时,第一次重试后两小时,以及最后一次重试后四个小时)再尝试三次。
自启动后,更新服务器会等待 72 小时让更新完成。如果在此间隔后仍未安装新版本,则系统会将详细错误添加到日志中。下次收到请求时,将重试更新。
您也可以使用 按钮手动重试更新(如果自动更新失败)。
可以为用户、用户组(推荐用于有人值守用例)或计算机(推荐用于无人值守用例)设置策略。
通过为用户或用户组配置更新策略,管理员可以控制特定用户或用户组的 Studio、Robot 和 Assistant 版本。
- 特定用户 - 精细更新与特定用户相关联的组件。
-
用户组 - 更新所有组成员的访问权限,而无需单独设置每个用户的访问权限级别。
重要提示:对于已分配 Autopilot Express 许可证的用户,无法编辑更新策略,并且设置为提供最新的企业版本。
通过在 Orchestrator 的“管理访问权限”选项卡中编辑特定用户或组来配置策略。
None
,但用户所属的组也设置了特定策略(例如最新补丁),则应用组策略。如果不希望更新该特定用户的组件,则必须从具有该策略的组中删除该用户,或者将更新策略设置为已安装的当前版本。
如果用户设置了推送特定版本的策略,并且他们也属于具有不同策略的组,则以用户级别策略为准。
通过为计算机对象配置更新策略,管理员可以使用特定的计算机密钥更新连接到 Orchestrator 的所有计算机上的机器人版本。
要为计算机对象配置更新策略,请按照以下步骤操作:
- 导航到“租户”>“计算机”。系统将显示“计算机”窗口
- 对于所需的计算机对象,单击“编辑”。系统将显示“编辑计算机”窗口。
- 访问“维护”选项卡。系统将显示“自动更新”配置菜单。
- 配置更新策略。
如果用户级策略、组级策略和计算机级策略应用于同一个机器人,用户级和组级策略优先于计算机级策略。如果用户级策略与组级策略之间存在差异,则较新版本优先,如以下示例所示:
一台计算机安装了 Studio 和 Robot 2023.4.0。
- 如果用户级策略设置为推送 2024.10.1 版本,组级策略设置为推送 2023.4.12 版本,用户模式机器人将更新为 2024.10.1 版本。
- 如果用户级策略设置为推送 2023.4.12 版本,组级策略设置为推送 2024.10.1 版本,用户模式机器人将更新为 2024.10.1 版本。
在 Orchestrator 用户界面中,更新日志可用于失败和成功的更新。
要查看计算机的更新日志,请在租户上下文中导航到“计算机”,然后为所需计算机选择“更多操作”。在“更多操作”菜单中,选择“查看已安装版本和日志”。在“已安装版本和日志”网格中,选择“查看自动更新日志”以获取所需条目。
%localappdata%/Uipath/UpdateService/logs
文件中找到。
在克隆计算机的虚拟环境中部署机器人时,计算机名称、GUID、驱动器 ID 和 MAC 地址相同。这可能会导致冲突,因为 Orchestrator 会从多台具有相同标识符的计算机接收不同的更新状态。
在这种情况下,系统会根据连接的最后一台计算机显示 Orchestrator 中的更新状态。
这也可能会影响 Orchestrator 日志,因为多台计算机具有相同的标识符,因此可能会出现重复的日志。
在“版本状态”列中,您可以根据关联的策略检查计算机的 Robot 版本状态。
提供以下值:
“无策略”- 未定义策略
“正在进行更新”- 计算机上正在进行更新过程时,将显示此状态
合规 – 计算机上的机器人版本与更新策略匹配。
“不合规”- 计算机上的 Robot 版本不同于策略中设置的版本。(例如,Robot 版本为 2021.10.3,而策略设置为 2021.10.1)
“更新失败”- 更新过程失败时,将显示此状态。有关更多详细信息,请参阅更新日志。
- 不适用 - 当启用了排除不活动计算机的设置并且有一段时间未连接机器人时,或者当计算机类型与自动更新流程不兼容时,会显示此状态。
在 Orchestrator“计算机”选项卡上的“版本状态”列中,您可以根据关联的策略检查计算机的 Robot 版本状态。
排除非活动的计算机
Non compliant
。这是因为计算机模板使用同一个计算机密钥与更新服务器通信,如果连接的一台计算机无法接收更新,则计算机模板的整体状态会受到影响。
为了避免这种情况,请访问租户上下文中“设置”菜单的“常规”部分,选中“客户端二进制文件”复选框,并设置首选的非活动间隔。这会将非活动计算机排除在更新流程之外,在报告更新状态时不再考虑这些计算机。
对于机器人位于代理后面的场景,要使自动更新功能正常工作,可能需要进行其他配置。 根据安装类型,代理配置可以从用户级代理设置继承,也可以通过 编辑配置文件手动设置。
安装类型 |
机器人部署 |
更新服务 |
更新代理 |
代理设置 |
---|---|---|---|---|
无人值守的机器人 |
Windows 服务 |
Windows 服务 |
不适用
1 |
来自
uipath.config 文件。
|
有人值守的机器人 |
用户级可执行文件 |
Windows 服务 |
用户级可执行文件 |
来自
uipath.config 文件。
|
快速安装 |
用户级可执行文件 |
用户级可执行文件 |
用户级可执行文件 |
从用户级别代理设置。 |
1
当机器人以无人值守模式安装时,更新代理不会添加到计算机中。
更新失败时,您可以使用“诊断工具”收集日志并将其发送给我们的支持团队,以便进一步调查具体错误。