安装

通过下载并执行提供的脚本，可以为 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 管理员用户以特权运行这些服务，而无需用户具有分配的权限。

• 禁用交换：

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

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

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

主节点

1. 通过运行 wget https://raw.githubusercontent.com/UiPath/Infrastructure/main/Setup/get-haa.sh下载安装脚本。
2. 通过运行 chmod a+x get-haa.sh使脚本可执行。
3. 使用以下命令安装主节点：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。

   • 仔细检查选定的安装路径。不支持将安装从一个位置移动到另一个安装后位置。

辅助节点

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

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

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

脚本参数

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

参数	说明
-u	HAA 集群管理员的用户名。 例如 -u [e-mail]。
-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" />

验证集群安装

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

1. 将浏览器导航到端口 8443上任何 HAA 节点的 IP 地址。 例如： https://10.10.20.196:8443/。 系统将显示 HAA 登录页面。
   
   

   

   
   
2. 输入安装期间提供的用户名和密码进行登录。
3. 选择节点选项卡，并验证所有已安装的节点是否都显示在此处，并且状态为确定。
   
   

   

   
   
4. 选择“ 数据库 ” 选项卡，并确认 uipath-orchestrator 数据库显示在此处，状态为“ 确定”。
5. 如果在多个节点上进行部署，请确保已在数据库设置中启用“复制”，并且两个节点显示的分片计数为 1。这可确保在两个节点上复制数据库。
   注意：默认情况下，使用安装时提供的密码在端口 10000 上创建该数据库。

HAA 许可

要添加或更新高可用性插件许可证，请按照以下步骤操作：

1. 将浏览器导航到端口 8443上任何 HAA 节点的 IP 地址。 例如： https://10.10.20.196:8443/。 系统将显示 HAA 登录页面。
2. 输入安装期间提供的用户名和密码进行登录。
3. 选择“设置”>“常规”选项卡。
4. 在“集群密钥”字段中输入许可证密钥。
5. 单击“保存”。

您的 HAA 集群现已准备就绪，您可以继续安装 Orchestrator，正如此处所述。