Orchestrator 用户指南

关于​

先决条件​

1. Orchestrator、Studio 和 Robot 2021.10 或更高版本。
2. 客户端计算机上安装了 Studio 和/或 Robot 2021.10 或更高版本，并且已连接到 Orchestrator。
   备注：

   要启用 Robot 的“自动更新客户端组件”功能，您必须使用版本为 2021.10 或以上的UiPathStudio.msi安装程序或版本为 2024.10 或以上的UiPathRobot.msi安装程序安装 Robot 应用程序。2024.10 之前的UiPathRobot.msi安装程序版本不支持自动更新客户端组件。如果已使用 2024.10 之前的UiPathRobot.msi安装程序版本安装了 Robot，则可以使用 2024.10 或更高版本的UiPathRobot.msi安装程序手动更新 Robot 应用程序。

更新过程中涉及的组件​

客户端​

• 客户端应用程序：
  • Robot (机器人)
  • Assistant
  • Studio
• 机器人服务
• 更新代理 - 一个 Windows 进程，负责用户和更新服务之间的通信。 （仅在用户模式和有人值守的机器人安装中存在）
• 更新服务 - 负责客户端计算机和更新服务器之间的通信的 Windows 服务。

服务器端​

• Orchestrator：为管理员提供用户界面，以设置自动更新策略并查看客户端应用程序的版本状态。
• 更新服务器：一个集中式服务，用于管理自动更新策略并通过更新服务维护与客户端计算机的通信。

工作原理​

• 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 在任务计划程序中作为登录任务安装。
  重要提示：

  在计算机上以有人值守的用户模式安装 UiPath Studio 和机器人时，为了使更新服务连接到更新服务器，请确保在安装过程中添加 Orchestrator URL。 如果在安装期间未添加 Orchestrator URL，则在计算机上具有管理员权限的用户必须登录计算机并将机器人连接到 Orchestrator。

• Studio - 无正在运行的流程或活动会话。
• Robot - 无正在运行的作业或流程。
• Assistant - 无正在运行的流程或待处理活动（正在安装或下载流程）。
  备注：

  在更新过程中，在更新完成之前，机器人不会启动任何作业。

• Update Now- 停止所有正在运行的作业并关闭该计算机上的所有 Studio 实例，然后继续更新。
• Later- 使通知静音，可以通过转到系统托盘中的用户界面图标并单击“检查更新”来继续更新过程。

更新过程步骤​

1. 正在下载
   • 更新服务每三个小时检查一次更新服务器是否有更新请求。 如果收到更新请求，则更新流程将启动下载流程。 如果下载过程已成功启动，则更新请求将添加到更新服务器数据库中，状态为Downloading 。
2. 已下载
   • Downloaded状态充当标记，以便更新服务可以启动后处理阶段。此状态表示已成功下载更新文件。
3. 正在处理
   • 此步骤将对下载的文件进行后处理。在此步骤中，将检查文件，如果没有出现错误，则安装过程将启动。
4. 准备安装
   • 更新代理会通知用户正在等待安装更新，并请求批准或检查客户端应用程序是否已准备好接收更新。
5. 已批准安装
   • 一旦更新服务收到批准，便开始实际安装。
6. 正在安装
   • 新版本将安装到计算机上，并保持与先前版本相同的设置。
7. 成功/错误

服务模式与用户模式机器人部署​

服务模式​

用户模式​

配置策略​

配置用户/用户组的策略​

• 特定用户 - 精细更新与特定用户相关联的组件。
• 用户组 - 更新所有组成员的访问权限，而无需单独设置每个用户的访问权限级别。
  重要提示：

  对于已分配 Autopilot Express 许可证的用户，无法编辑更新策略，并且设置为提供最新的企业版本。

1. 导航到“租户”>“管理访问权限”。系统将显示“用户”窗口。
2. 对于所需的用户/用户组，单击“编辑”。系统将显示“编辑用户”窗口。
3. 在“更新策略设置”部分中，将自动更新策略更改为以下值之一：
   • 无：不应用任何策略。
   • 最新补丁：安装每个受支持版本可用的最新补丁。（例如最新 2022.10 补丁、最新 2023.4补丁）。
   • 最新版本：安装更新服务器上可用的最新版本。
   • 特定版本：从更新服务器上的可用列表中安装特定版本。

每台计算机对象​

1. 导航到“租户”>“计算机”。系统将显示“计算机”窗口。
2. 对于所需的计算机对象，单击“编辑”。系统将显示“编辑计算机”窗口。
3. 访问“维护”选项卡。系统将显示“自动更新”配置菜单。
4. 配置更新策略。

策略优先级​

• 计算机 1 已安装 Robot 和 Studio 版本 2021.10。
• 在计算机 1 上，机器人以[email protected]用户身份通过交互式登录连接到 Orchestrator。
• 更新策略将应用于[email protected] ，该策略设置为推送版本 2021.10.2。
• [email protected]也属于组 1。
• 更新策略适用于设置为推送 2021.10.3 版本的 group_1。
• 更新策略将应用于计算机 1，该策略设置为推送版本 2022.4版本。结果：触发更新策略时，该计算机上的组件将更新到版本 2021.10.2。
  备注：

  请注意，使用机器人帐户时，将使用计算机级别策略来处理更新。

策略中的版本可用性​

更新日志​

版本状态​

• “无策略”- 未定义策略
• “正在进行更新”- 计算机上正在进行更新过程时，将显示此状态
• 合规 – 计算机上的机器人版本与更新策略匹配。
• “不合规”- 计算机上的 Robot 版本不同于策略中设置的版本。（例如，Robot 版本为 2021.10.3，而策略设置为 2021.10.1）
• “更新失败”- 更新过程失败时，将显示此状态。有关更多详细信息，请参阅更新日志。
• 不适用 - 当启用了排除不活动计算机的设置并且有一段时间未连接机器人时，或者当计算机类型与自动更新流程不兼容时，会显示此状态。

计算机的版本状态​

排除非活动的计算机​

用户的版本状态​

管理更新版本​

1. 在您以主机管理员身份登录到主机租户/组织，打开一个新选项卡并转到 https://baseURL/identity_/api/Account/ClientAccessToken 后，将获得安装令牌。
2. 要设置 ClientId 和 ClientSecret 的值，请运行以下脚本：
   备注：

   可以从 Customer Portal 的“产品下载”部分下载 UiPath 更新服务器脚本， 以检索以下命令所需的脚本。要在脚本中使用的受支持的产品版本可在“产品生命周期文档”页面中找到。对于更新脚本，将使用版本的缩写格式（例如22.4.3 而不是 2022.4.3）。

   assignment

   .\Provision-IdentityClient.ps1 -IdentityUri "<IDENTITY_URL>" -InstallationToken "<INSTALLATION_TOKEN>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"
   .\Provision-IdentityClient.ps1 -IdentityUri "<IDENTITY_URL>" -InstallationToken "<INSTALLATION_TOKEN>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"
   

.\Product-Versions.ps1 get -ApiBaseUri "<ORCHESTRATOR_URL>" -IdentityUri "<IDENTITY_URL>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"
.\Product-Versions.ps1 get -ApiBaseUri "<ORCHESTRATOR_URL>" -IdentityUri "<IDENTITY_URL>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"

.\Product-Versions.ps1 register -ApiBaseUri "<ORCHESTRATOR_URL>" -IdentityUri "<IDENTITY_URL>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>" -ProductId "b69fdacf-6dd0-46fb-88c7-af2d87caf5aa" -Version "<NEW_VERSION>" -DownloadUri "<DOWNLOAD_URL>".\Product-Versions.ps1 register -ApiBaseUri "https://intranet/orchestrator_" -IdentityUri "https://intranet/identity_" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>" -ProductId "b69fdacf-6dd0-46fb-88c7-af2d87caf5aa" -Version "22.4.3" -DownloadUri "https://download.uipath.com/versions/22.10.3/UiPathStudio.msi"
.\Product-Versions.ps1 register -ApiBaseUri "<ORCHESTRATOR_URL>" -IdentityUri "<IDENTITY_URL>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>" -ProductId "b69fdacf-6dd0-46fb-88c7-af2d87caf5aa" -Version "<NEW_VERSION>" -DownloadUri "<DOWNLOAD_URL>".\Product-Versions.ps1 register -ApiBaseUri "https://intranet/orchestrator_" -IdentityUri "https://intranet/identity_" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>" -ProductId "b69fdacf-6dd0-46fb-88c7-af2d87caf5aa" -Version "22.4.3" -DownloadUri "https://download.uipath.com/versions/22.10.3/UiPathStudio.msi"

DELETE
.\Product-Versions.ps1 delete -ApiBaseUri "<ORCHESTRATOR_URL>" -IdentityUri "<IDENTITY_URL>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>" -ProductId "b69fdacf-6dd0-46fb-88c7-af2d87caf5aa" -Version "<NEW_VERSION>"
DELETE
.\Product-Versions.ps1 delete -ApiBaseUri "<ORCHESTRATOR_URL>" -IdentityUri "<IDENTITY_URL>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>" -ProductId "b69fdacf-6dd0-46fb-88c7-af2d87caf5aa" -Version "<NEW_VERSION>"

.\Provision-IdentityClient.ps1 -IdentityUri "<IDENTITY_URL>" -InstallationToken "<INSTALLATION_TOKEN>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"
.\Provision-IdentityClient.ps1 -IdentityUri "<IDENTITY_URL>" -InstallationToken "<INSTALLATION_TOKEN>" -ClientId "<CLIENT_ID>" -ClientSecret "<CLIENT_SECRET>"

代理配置​

收集错误日志​