安装

了解有关高可用性加载项 (HAA) 安装的信息。

安装概述

注意：我们支持与 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 时，才需要执行此步骤。

You must configure standalone Orchestrator to use HAA and add all HAA nodes to the Orchestrator's UiPath.Orchestrator.dll.config configuration file using the LoadBalancer.UseRedis and LoadBalancer.Redis.ConnectionString parameters. For example:

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