使用 Windows 安装程序更新

警告： 请记住，这些信息与您要升级到的目标版本有关，与升级前的版本无关。因此，在继续之前，请确保阅读正确的详细信息。

概述

更新流程可能会有所不同，具体取决于是否：

• 以前的版本是使用 Windows Installer 设置的；
• 您的 Orchestrator 实例位于多节点环境中。
  重要提示：

  • 如果您使用 Active Directory (AD) 并计划升级到 2023.4.0，我们强烈建议您直接跳到 2023.4.3 版本，因为 2023.4.0、2023.4.1 和 2023.4.2 会受到 AD 问题的影响。

  • 升级前，请访问目标升级版本的硬件要求、软件要求和先决条件页面，因为相关内容可能已发生变化。您需要确保在升级前满足所有要求。
  • 升级后，我们建议您重新启动所有机器人，以便其应用新设置。
  • 如果您的包（活动和/或工作流）存储在共享文件夹中，请注意 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，请执行以下操作：

1. 备份自动化包、web.config 和 UiPath.Orchestrator.dll.config 文件，以及数据库。
2. 运行 UiPathOrchestrator.msi 安装程序。Orchestrator 将以 UiPathOrchestrator 名称安装，同时系统会更新数据库，并迁移所有数据。在此阶段，您还可以更新 Identity Server 和更新服务器的设置。
3. 如果您使用 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 flushall

4. 如果您使用 Insights，请确保在升级 Orchestrator 之前备份 Insights 数据库。

多节点环境

在多节点环境中，在主节点和辅助节点上进行升级的方式不同。需要执行以下步骤来更新所有节点。

注意：此外，尽管您在主机级别和默认租户级别提供管理员密码，但系统不会考虑这些密码。请使用以前的密码登录。

备份文件

备份自动化包、web.config 和 UiPath.Orchestrator.dll.config 文件，以及数据库。

主节点安装

对于有人值守的安装：从管理员命令提示符运行以下命令：

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

按照此处所述，进行安装。

重要提示： 不要忘记备份安装过程中生成 upgradeParams.json 配置文件。这将用于后续的辅助节点安装流程。

辅助节点安装

建议使用主节点上生成的 upgradeParams.json 配置文件运行无人值守安装程序。从“管理员命令提示符”运行以下命令：

UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=c:\temp\upgradeParams.json /lvx* upgrade.log CONFIRM_BLOCK_CLASSIC_EXECUTIONS=1 /Q

平键

如果您使用 HAA 管理缓存，请使用以下命令从主动-主动数据库中刷新所有 HAA 缓存密钥：

crdb-cli crdb flush --crdb-guid <guid> [ --no-wait ]

重要提示：如果要使用 Concurrent Runtime 许可证类型，请注意，从 v2020.4 之前的版本更新时，如果设置了高密度机器人，则系统会自动将每台计算机的运行时数量设置为 1，而非该计算机上的机器人总数。