安装 High Availability Add-on

安装概述

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

有两种方法可以为 Orchestrator 实例安装高可用性加载项 (HAA)：

• “快速”– 通过下载并执行提供的脚本；当您要在单个数据中心内设置 HAA 时使用。

  有关详细信息，请参阅快速安装。

• “高级”– 通过执行一些复杂的操作，包括集群 DNS 配置以及集群创建和设置；当您要在多个数据中心内设置 HAA 时使用。

  有关详细信息，请参阅主动/主动灾难恢复安装。

在继续安装 HAA 之前，请确保满足先决条件。

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

先决条件

以下先决条件与快速安装方法和高级安装方法相同。在开始 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 分区。
  3. 安装 wget 包。确保使用 Linux 发行版支持的下载命令。例如，如果您使用 CentOS，请运行：

     yum install wget

  4. 在计划安装 HAA 的所有节点上重复此流程。

     检查是否将英语添加到语言列表中。

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

     1. 通过运行以下任一命令，查看有关当前安装的 locale 的信息：

        locale -alocalectl

        localectl

     2. 将当前会话所用的语言和编码设置为英语，只需运行：

        $ export LANG="en_US.utf8"

快速安装

重要提示：在继续快速安装 HAA 之前，请确保所有节点都满足先决条件。

安装主节点

要在主节点上安装 HAA，请执行以下步骤：

1. 使用根权限对主节点进行 SSH 连接。
2. 创建要下载和提取 HAA 的目录，例如：

   mkdir haa

3. 下载 get-haa.sh 安装脚本：

   wget https://download.uipath.com/haa/get-haa.sh

   注意：有关更多详细信息，请参阅部分。
4. 使 get-haa.sh 脚本可执行：

   chmod a+x get-haa.sh

5. 安装主节点。请务必提供管理员帐户的电子邮件地址和密码。您可以使用临时电子邮件地址。您必须指定节点上运行的操作系统。
   注意：要在运行安装命令时以正确的格式输入操作系统，请先运行 get-haa.sh -h 并记下帮助菜单中的相关操作系统值。

   可能的操作系统值为 Rhel8、Rhel9 或 UbuntuFocal。

   sudo ./get-haa.sh -u <email> -p <password> -o <OS> --accept-license-agreement

重要提示：

若要在自定义位置中安装 HAA，请运行 install-haa.sh 脚本进行高级配置（这不会创建任何集群），请记住所有位置必须不同。例如：

sudo ./install-haa.sh --install-dir /opt/haa-uipath --config-dir /etc/opt/haa-uipath --var-dir /var/opt/haa-uipath。

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

安装辅助节点

安装主节点后，在每个辅助节点上执行以下步骤：

1. 使用根权限对辅助节点进行 SSH 连接。
2. 创建要下载和提取 HAA 的目录，例如：

   mkdir haa

3. 切换到新创建的目录：

   cd /<path-to>/haa/

4. 下载 get-haa.sh 安装脚本：

   wget https://download.uipath.com/haa/get-haa.sh

   注意：有关更多详细信息，请参阅部分。
5. 使 get-haa.sh 脚本可执行：

   chmod a+x get-haa.sh

6. 安装辅助节点：
   注意：要在运行安装命令时以正确的格式输入操作系统，请先运行 get-haa.sh -h 并记下帮助菜单中的相关操作系统值。

   可能的操作系统值为 Rhel8、Rhel9 或 UbuntuFocal。

   sudo ./get-haa.sh -u <email> -p <password> -o <OS> -j <IP_address_of_the_master_node> --accept-license-agreement

   重要提示：提供创建主节点时设置的电子邮件地址、密码和 IP 地址。

Script parameters

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

参数	说明
-u	HAA 集群管理员的用户名。 例如 -u [e-mail]。
-p	安装主节点时设置的管理用户密码。 例如 -p SuperSecret_Password。
-j	主节点的 IP 地址。 如果提供，则会安装辅助（从）节点。 例如 -j 10.10.22.10。
--install-dir	指示 HAA 安装目录的路径（仅在运行 install-haa.sh 脚本进行高级安装时）。 注意：仔细检查选定的安装路径。不支持将安装从一个位置移动到另一个安装后位置。
--config-dir	指示 HAA 配置目录的路径（仅在运行 install-haa.sh 脚本进行高级安装时）。
--var-dir	指示 HAA 变量目录的路径（仅在运行 install-haa.sh 脚本进行高级安装时）。
-h	用于显示安装帮助指南。
-l	HAA 集群的许可证代码。请输入许可证，不得使用 --- LICENSE START --- 或 --- LICENSE END --- 开头和结尾，并且不得使用任何 new line 字符。
--accept-license-agreement	接受 UiPath 许可协议
--offline	离线安装它假定包位于当前文件夹中，与安装脚本相同。可以在 get-haa.sh 脚本中找到包的链接。

配置 UiPath.Orchestrator.dll.config

重要提示：

仅当您对独立 Orchestrator 使用 HAA 时，才需要执行此步骤。

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

<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" />

配置 cluster_config.json

重要提示：

仅当您使用适用于 Automation Suite 的 HAA 时，才需要执行此步骤。

您必须通过更新 cluster_config.json 文件中的 fabric.redis 部分，将 Automation Suite 配置为使用 HAA。有关更多详细信息，请参阅 High Availability Add-on 配置。

验证集群安装

安装 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，正如此处所述。