安装注意事项

This article identifies the main affected areas you should be aware of in a new Orchestrator deployment. Some of the items addressed in this article must be taken care of prior to an upgrade/installation. Several of them are validated by the installer or by the Platform Configuration Tool if you choose to use it. We highly recommend that you download and use the Platform Configuration Tool to validate your environment prior to an upgrade.

.NET Core 3.1

目标框架

若要维护凭据存储插件和 NLog 扩展功能，必须将 TargetFramework 从先前的 .NET Framework 4.7.2 升级到受支持的目标框架。凭据存储和 NLog 扩展的目标框架都由 UiPathOrchestrator.msi 安装程序进行检查。

此限制也适用于插件或 NLog 扩展程序可能具有的所有引用。

支持的目标框架	支持的版本
.NET 标准	1.0 - 1.6
.NET 标准	2.0（推荐）
.NET	8.0

提示：

您可能需要重新编译内部开发的所有凭据存储插件和 NLog 扩展。

You may need to identify and copy to the Orchestrator directory other .dll files targeting specified target frameworks. Most NLog targets support the specified target frameworks; however, you must ensure you copy the right .dll. For example, if you use NLog.Targets.Splunk, you need to download the .nupkg file, open it as a .zip, navigate to the folder lib\) etstandard2.0 and use the .dll file from there.

凭据存储插件 - CyberArk

在较旧版本的 Orchestrator 中，CyberArk 凭据存储插件使用的库与 .NET Core 不兼容。Orchestrator 现在使用 CyberArk AIM 附带的 CLIPasswordSDK64.exe 工具。

提示：

The plugin searches for CLIPasswordSDK64.exe in the default CyberArk AIM installation path, namely C:\Program Files(x86)\CyberArk\ApplicationPasswordSdk\CLIPasswordSDK64.exe. If CyberArk AIM was not installed at the default path, a configuration entry must be added in UiPath.Orchestrator.dll.config, pointing to the actual path. The path can be specified in the appSettings section in web.config prior to the installation or in the UiPath.Orchestrator.dll.config after the installation.

示例：

<add key="Plugins.SecureStores.CyberArk.CLIPasswordSDKExePath" value="D:\CustomFolder\CLIPasswordSDK64.exe" />

代理配置

在 .NET Core 中，有两种用于指定代理的机制：

使用环境变量

可以使用以下语法在 web.config 中设置环境变量：<environmentVariable name="[insert_variable_here]" value="[insert_address_here]" />，例如 <environmentVariable name="HTTP_PROXY" value="http://127.0.0.1:8080" />。

变量	描述
HTTP_PROXY	在 HTTP 请求中使用的代理服务器。
HTTPS_PROXY	在 HTTP 请求中使用的代理服务器。
ALL_PROXY	在未定义 HTTP_PROXY 或 HTTPS_PROXY 的情况下，用于 HTTP 和/或 HTTPS 请求的代理服务器。
NO_PROXY	以逗号分隔的应排除在代理外的主机名称列表。

示例:

• 未经身份验证：ALL_PROXY=http://localhost:8888
• 使用身份验证：ALL_PROXY=http://user:password@localhost:8888

如果未设置环境变量，则使用默认代理系统（IE 设置或 Windows 代理设置）

请参阅此处的Microsoft 官方文档。

不再使用 <defaultProxy> 标签在 web.config 中配置代理配置。不再支持的配置示例：

<system.net>
    <defaultProxy>
      <proxy usesystemdefault="True" proxyaddress="http://<ip>:<port>" bypassonlocal="True"  />
    </defaultProxy>
  </system.net>

配置文件

web.config

Orchestrator 的大多数配置设置已从 web.config 移至 UiPath.Orchestrator.dll.config。新文件保留与旧文件 web.config 相同的结构，并且位于同一目录中。请记住，更改 UiPath.Orchestrator.dll.config 文件不会重新启动 IIS。以下部分已移动：

• 连接字符串
• 应用程序设置
• NLog 配置
• Quartz 配置
• 加密密钥

web.config 已重新调整用途，即仅包含 IIS 使用的配置。升级后，安装程序将自动将上述部分移至新的配置文件。它将转换 web.config 中的剩余配置，以匹配 Orchestrator 最新版本所需的配置。客户自定义配置将保留，包括禁用的动词、启用/禁用的模块、自定义的重写规则。

Check web.config docs.

Check UiPath.Orchestrator.dll.config docs.

IIS 管理器

连接字符串和应用程序设置在 IIS 管理器中不再可见。不支持使用 IIS 管理器编辑 Orchestrator 连接字符串或应用程序设置。

提示：

您需要直接编辑配置文件。

NLog 目标

对于类型为“数据库”的 NLog 目标，connectionStringName 属性已由 connectionString 替换。其值必须使用以下语法：connectionString="${ui-connection-strings:item=Default}"，其中 Default 是您要在 <connectionStrings> 部分中使用的连接字符串的名称。

请参阅Orchestrator 执行日志目标的相关文档。

提示：

如果您正在使用类型为 Database 的自定义 NLog 目标，则在升级过程中，属性 connectionStringName 将自动更改为 connectionString。如果在安装/升级后手动将目标插入配置文件中，请使用使用正确值的新属性。

SignalR 协议

带 WebSocket 的 SignalR

我们已将 SignalR 库更新为较新的版本，该版本与较旧的机器人客户端不兼容。为在有作业可执行时不间断地通知无人值守机器人，我们已实施一种通过长轮询来模拟旧 SignalR 协议的兼容机制。2020.10 之前版本的机器人仅通过长轮询与 Orchestrator 建立连接。

提示：

我们建议您将机器人升级至 2020.10 以使用 WebSockets，这特别有助于提高大型机器人部署的成本效益。

SignalR 横向扩展粘滞会话

SignalR 横向扩展需要除 WebSocket 以外所有协议的粘滞会话（即 SSE 和长轮询）。

默认情况下，仅默认启用 WebSocket 传输，因为 Orchestrator 会假定客户的负载均衡器未启用粘滞会话。

Figure 1. Scalability settings

提示：

在 UiPath.Orchestrator.dll.config 中添加 <add key="Scalability.SignalR.RequireStickySessions" value="true" /> 密钥以启用粘滞会话。如果设为 true，则启用所有传输，并且 Orchestrator 假定负载均衡器已启用粘性会话。在 UiPath.Orchestrator.dll.config 中启用粘滞会话但不在负载均衡器上启用将导致 SignalR 连接失败。

SignalR SQL Server 横向扩展

在安装过程中，横向扩展机制从 SQL Server 切换到 Redis。不再支持禁用机器人/活动的 SignalR 身份验证。为此，Scalability.SignalR.AuthenticationEnabled 参数已弃用。

等待队列项目活动

如果使用早于 2020.10 的“等待队列项目”活动，则可能会遇到长达 30 秒的延迟情况。

提示：

升级到最新的活动版本以避免出现此类问题。

NuGet 基础架构

我们将内部 NuGet 订阅源的协议从 v2 更新到了 v3。

传统版本存储库

Legacy 不再是受支持的 NuGet 存储库类型。升级后，所有类型为 Legacy 的存储库都将迁移至 Composite。

新包的位置取决于您使用先前的 Orchestrator 版本时在 web.config 中配置 NuGet.Packages.Path 和 NuGet.Activities.Path 参数的方式。

• 如果您将包存储在默认位置（~/NuGetPackages 和 ~/NuGetPackages/Activities），则包的新位置将变为 RootPath=.\Storage。
• 如果您将包存储在自定义位置，则系统在安装过程中会要求您选择新的存储位置。对于静默安装，除非您在升级前已在 web.config 指定参数，否则必须使用 STORAGE_TYPE 和 STORAGE_LOCATION 参数。

In v2020.10+, package location is configured using the Storage.Type and Storage.Location parameters in UiPath.Orchestrator.dll.config. After the upgrade, all Legacy-related app settings become deprecated and no longer have an effect.

• NuGet.Packages.Path
• NuGet.Activities.Path
• Nuget.EnableRedisNodeCoordination
• Nuget.EnableNugetServerLogging
• NuGet.EnableFileSystemMonitoring
• NuGet.Repository.Type

重要提示：

Composite存储库不支持在专用的包文件夹中使用复制粘贴命令。

Swagger 库

我们对描述了 Orchestrator API 的 swagger.json 文件的生成方式进行了重大更改。如果您依赖使用 Swagger 文件中的 API 描述的客户端库生成器（例如：AutoRest、Swagger Codegen），则生成的代码将有很大的不同。

提示：

您可能需要更新使用自动生成的客户端的任何其他自定义工具。

API 更改

具有表单 POST 参数的 API

无法再使用表单数据对象中的参数发出 POST 请求。

提示：

向 Orchestrator 发出 POST 请求的唯一受支持的机制是在请求正文中提供 JSON 格式的请求参数。