安装

通过下载并执行提供的脚本，可以为 Orchestrator 实例安装高可用性加载项 (HAA)。

在继续安装 HAA 之前，请确保您符合硬件和软件要求。

备注：

HAA 需要来自 Orchestrator 的单独许可证。有关详细信息，请联系 UiPath。
主动/主动灾难恢复部署模型需要两个 HAA 许可证。

注意：我们支持与 Orchestrator 的向后兼容性，但建议更新到最新的 HAA 版本。

安装

先决条件

在开始 HAA 安装之前，请确保您：

是根用户或对根用户具有访问 sudo 的权限。
具有用户创建权限。
确保您拥有有效的 SSL/TLS 证书。有关如何更新证书的说明，请参阅 Redis 文档。
已启用防火墙服务。

备注：
根权限仅对安装和升级是必需的，HAA 管理员用户不需要升级权限来管理集群服务。

在 HAA 管理员用户运行的以下守护程序上，已将功能位设置为允许可执行文件具有执行所需的最小权限：

/opt/redislabs/bin/dmcproxy = cap_sys_resource+ep

/opt/redislabs/bin/redis-server-4.0 = cap_sys_resource+ep

/opt/redislabs/bin/redis-server-4.0-big = cap_sys_resource+ep

/opt/redislabs/bin/redis-server-5.0 = cap_sys_resource+ep

/opt/redislabs/bin/redis-server-5.0-big = cap_sys_resource+ep

/opt/redislabs/bin/sentinel_service = cap_sys_resource+ep

/opt/redislabs/sbin/pdns_server = cap_net_bind_service+ep

/opt/redislabs/sbin/smaps = cap_sys_ptrace+ep

这些允许 HAA 管理员用户以特权运行这些服务，而无需用户具有分配的权限。
禁用交换：

使用以下命令禁用 swap ： sudo swapoff -a。
要在重新启动后保留此更改，请运行以下命令来注释 etc/fstab 文件中的 swap 条目： sudo sed -i.bak '/ swap / s/^(.*)$/#1/g' /etc/fstab。
通过运行 yum install wget 命令来安装用于下载 RS 安装文件的 wget 包。
在要安装 HAA 的所有节点上重复此过程。

此外，根据您的语言和字符集（编码），您可能会在运行安装脚本时遇到问题。建议首先检查英语是否添加到语言列表中：

查看当前所用的已安装 locale 的信息：运行 locale -a 或 localectl。
将当前会话所用的语言和编码设置为英语：运行 $ export LANG="en_US.utf8"。

主节点

通过运行 wget https://raw.githubusercontent.com/UiPath/Infrastructure/main/Setup/get-haa.sh下载安装脚本。
通过运行 chmod a+x get-haa.sh使脚本可执行。
使用以下命令安装主节点：sudo ./get-haa.sh -u <email> -p <password>。
为帐户管理员提供电子邮件地址和所需密码，并提供安装目录。
重要提示：
- 若要在自定义位置中安装 HAA，请运行 install.sh 脚本进行高级配置（这不会创建任何集群），请记住所有位置必须不同。例如：
sudo ./install.sh --install-dir /opt/haa-uipath --config-dir /etc/opt/haa-uipath --var-dir /var/opt/haa-uipath。
- 仔细检查选定的安装路径。不支持将安装从一个位置移动到另一个安装后位置。

辅助节点

安装主（主）节点后，从每个其他节点：

创建要下载和提取 HAA 的目录，例如： mkdir haa。
使用以下命令切换到新创建的目录： cd /<path-to>/haa/。
通过运行 wget https://raw.githubusercontent.com/UiPath/Infrastructure/main/Setup/get-haa.sh下载安装脚本。
通过运行 chmod a+x get-haa.sh使脚本可执行。
使用以下命令安装节点：sudo ./get-haa.sh -u <email> -p <password> -j <IP_address_of_the_master_node>。

提供创建主节点时设置的电子邮件和密码以及主节点的 IP 地址。

脚本参数

运行 HAA 安装脚本时，以下参数可用：

参数	说明
`-u`	HAA 集群管理员的用户名。例如 `-u documentation@uipath.com`。
`-p`	安装主节点时设置的管理用户密码。例如 `-p SuperSecret_Password`。
`-j`	主节点的 IP 地址。如果提供，则会安装辅助（从）节点。例如 `-j 10.10.22.10`。
`--install-dir`	指示 HAA 安装目录的路径（仅在运行 `install.sh` 脚本进行高级安装时）。注意：仔细检查选定的安装路径。不支持将安装从一个位置移动到另一个安装后位置。
`--config-dir`	指示 HAA 配置目录的路径（仅在运行 `install.sh` 脚本进行高级安装时）。
`--var-dir`	指示 HAA 变量目录的路径（仅在运行 `install.sh` 脚本进行高级安装时）。
`-h`	用于显示安装帮助指南。
`-l`	HAA 集群的许可证代码。

UiPath.Orchestrator.dll.config Configuration

您必须将 Orchestrator 配置为使用 HAA，并使用 LoadBalancer.UseRedis 和 LoadBalancer.Redis.ConnectionString 参数将所有 HAA 节点添加到 Orchestrator UiPath.Orchestrator.dll.config 文件中。例如：

<add key="LoadBalancer.UseRedis" value="true" />
<add key="LoadBalancer.Redis.ConnectionString" value="10.10.20.184:10000,10.10.24.148:10000,10.10.22.114:10000,password=SuperSecret_Password" /><add key="LoadBalancer.UseRedis" value="true" />
<add key="LoadBalancer.Redis.ConnectionString" value="10.10.20.184:10000,10.10.24.148:10000,10.10.22.114:10000,password=SuperSecret_Password" />

验证集群安装

安装 HAA 集群的所有节点后，确认配置成功，如下所示：

将浏览器导航到端口 8443上任何 HAA 节点的 IP 地址。例如： https://10.10.20.196:8443/。系统将显示 HAA 登录页面。
输入安装期间提供的用户名和密码进行登录。
选择节点选项卡，并验证所有已安装的节点是否都显示在此处，并且状态为确定。
选择“ 数据库 ” 选项卡，并确认 uipath-orchestrator 数据库显示在此处，状态为“ 确定”。
如果在多个节点上进行部署，请确保已在数据库设置中启用“复制”，并且两个节点显示的分片计数为 1。这可确保在两个节点上复制数据库。

注意：默认情况下，使用安装时提供的密码在端口 10000 上创建该数据库。