离线多节点 HA 就绪生产安装

本页说明如何使用多节点 HA 就绪生产设置执行离线 Automation Suite 安装。

概述

重要提示：

在继续安装之前，您必须满足硬件和软件先决条件。 请参阅 硬件和软件要求。

您可以使用专用脚本来验证安装先决条件和基础架构就绪情况。 请参阅 验证先决条件。

为了获得流畅的安装体验，请确保遵循我们的最佳实践。请参阅 。

在无法访问互联网的离线环境中部署 UiPath Automation Suite 时，请使用本文档中的离线安装步骤。

安装流程包含以下一般步骤：

步骤	描述
步骤 1：下载安装包	此步骤需要在可访问互联网的计算机上执行，且此计算机可访问将要部署 Automation Suite 的离线计算机。在完成这些下载后，您可以继续执行后续的一些步骤。 这可以在 Linux 或 Windows 计算机完成。 步骤 1.1：下载安装包 步骤 1.2：获取第一台计算机上所有下载的文件
步骤 2：配置安装	运行交互式安装向导以配置安装选项 该工具将收集大多数常见安装选项的输入，并生成将在安装过程中使用的配置文件。 配置高级安装选项（可选） 默认安装配置包括核心自动化中使用的产品和所有产品使用的共享 SQL Server。要自定义安装的产品或为特定产品使用单独的 SQL Server，您可以通过编辑配置文件来实现。 步骤 2.1：基本配置 步骤 2.2：（可选）高级配置
步骤 3：复制所有计算机上的安装文件	在第一台计算机上，将下载的文件复制到安装向导在步骤 2 中创建的安装文件夹中。 在其他集群计算机上，将整个安装文件夹从第一台计算机复制到每台计算机上的相同文件夹路径。 步骤 3：复制所有计算机上的安装文件
步骤 4：运行安装	创建集群并加入所有计算机从第一台计算机安装套件的其余部分。 步骤 4：运行安装
步骤 5：完成安装	步骤 5：您已成功完成安装，可以转到安装后步骤。 您现在可以访问新创建的集群和套件、更新证书、调整 PVC 大小等。 步骤 5：完成安装

重要提示：

RHEL 内核版本 kernel-4.18.0-477.10.1.el8_8 受到中断 Automation Suite 集群安装或管理的问题的影响。请确保在安装前或安装后，没有 Automation Suite 节点使用此内核版本。您可以通过运行以下命令来更新内核版本：

dnf install -y kernel kernel-tools kernel-tools-libs

步骤 1：下载安装包并在第一台计算机上获取所有文件

步骤 1.1：下载安装包

您必须在可访问互联网的计算机上以及要安装 Automation Suite 的离线环境中的计算机上执行此步骤。

备注：

此计算机可以是 Linux 或 Windows。本指南中的命令适用于基于 RHEL 的操作系统。对于 Windows 或其他操作系统，请调整特定于这些环境的等效命令。

Automation Suite 安装程序是多个包的包装器，它还使用 Red Hat 包管理器 (RPM) 安装一些依赖项。它提供交互式体验，可帮助您配置外部资源，例如 SQL 和其他安装选项。

在可访问互联网的单独计算机上

本节说明如何获取启动安装流程所需的文件。

1. 连接到可访问互联网的计算机并运行以下命令以获取交互式向导文件：

   ssh <user>@<dns_of_vm>

2. 如果您使用了 ssh 密钥，请运行以下命令：

   ssh -i <path/to/Key.pem> <user>@<dns_of_vm>

3. 下载以下包：
   • installUiPathAS.sh – 必需。 有关下载说明，请参阅 installUiPathAS.sh 。
   • sf-installer.zip – 必需。 有关下载说明，请参见 sf-installer.zip 。
   • sf.tar.gz - 可选。仅在使用内部 Docker 注册表时需要在服务器节点上下载。有关下载说明，请参见 sf.tar.gz。
   • sf-infra.tar.gz - 必需。有关下载说明，请参见 sf-infra.tar.gz。
   • du-ondemand.tar.gz – 可选。仅 Document Understanding 需要。有关下载说明，请参见 du-onDemand.tar.gz。
     备注：

     不遵循此可选步骤将限制 Document Understanding 服务的功能。

   • cv-ondemand.tar.gz – 可选。仅 Computer Vision 需要。有关下载说明，请参见 cv-ondemand.tar.gz。
     备注：

     注意：不遵循此可选步骤将阻止访问 Computer Vision 服务。

   确保下载适合您的 Automation Suite 版本和操作系统的包。

步骤 1.2：获取第一台计算机上所有下载的文件

请务必执行以下步骤：

• 检查所有文件是否已在可访问互联网的计算机上完成下载；
• 在计算机上创建目标文件夹；
• 将文件从联机计算机复制到目标计算机。

在集群中的所有计算机上

通过运行以下命令创建安装文件夹：

sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 777 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp

重要提示： 如果使用 configureUiPathDisks.sh 脚本，则不需要运行 mkdir -p /opt/UiPathAutomationSuite/ 。

在可访问互联网的单独计算机上

通过执行以下步骤，将文件复制到第一个节点：

1. 从可访问互联网的计算机上，将文件复制到目标计算机上的安装文件夹，并将离线捆绑包复制到 /uipath/tmp 文件夹：

   scp ~/installUiPathAS.sh ~/sf-installer.zip ~/sf-infra.tar.gz <username>@<node dns>:/uipath/tmp
   scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/

2. （可选）要使用 Document Understanding，请将以下捆绑包复制到/uipath/tmp文件夹：

   scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/

   警告：不遵循此可选步骤将阻止访问 Document Understanding 服务。
3. （可选）要使用计算机视觉，请将以下捆绑包复制到 /uipath/tmp 文件夹：

   scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/

   警告：不遵循此可选步骤将阻止访问计算机实具视觉服务。

步骤 2：配置安装

步骤 2.1：基本配置

在集群的主计算机上

1. 将先决条件文件夹添加到当前路径。
   交互式安装程序需要 jq，已包含在我们的 Automation Suite 离线捆绑包中。运行以下命令将其添加到路径，确保您仍然是根用户：

   mv /uipath/tmp/installUiPathAS.sh /uipath/tmp/sf-installer.zip /uipath/tmp/sf-infra.tar.gz  /opt/UiPathAutomationSuite
   cd /opt/UiPathAutomationSuite
   unzip ./sf-installer.zip -d .
   chmod +x ./bin/jq
   export PATH=${PATH}:/opt/UiPathAutomationSuite/bin

2. 提供安装程序文件夹的权限。
   需要为安装脚本所在且即将在此处执行的 /opt/UiPathAutomationSuite 文件夹提供足够的权限。安装程序还将在每个阶段执行后创建一些文件 (output.json)。要提供所需的权限，请运行以下命令：

   chmod -R 755 /opt/UiPathAutomationSuite

3. 运行交互式安装程序以配置安装选项。
   如果 sf-installer.zip 中不存在 /opt/UiPathAutomationSuite/，安装程序将尝试下载它，但由于这是离线安装，所以安装程序会失败。

   交互式安装程序将指导您完成配置步骤并生成配置，以便您在剩余的安装步骤中自定义并加以使用。

4. 要启动交互式安装程序，请运行以下脚本：
   运行以下命令

   chmod +x ./installUiPathAS.sh
   ./installUiPathAS.sh

以多节点离线模式运行交互式向导

1. 输入多节点 HA 就绪生产模式选项。
   
2. 输入离线选项：
   
3. 指定集群的 URL（多节点 HA 就绪生产模式中的 DNS 主机名/负载均衡器 URL）和 SQL Server 信息，如下所示：
   
4. 将使用文件夹生成配置，如下图所示。
   

生成配置文件和文件夹后，即可退出向导并继续执行以下剩余步骤以完成安装。

步骤 2.2：（可选）高级配置

此步骤是可选的。

通过使用默认配置运行安装，您将选择使用我们的基础产品。您将安装我们的核心平台：Orchestrator、Insights、Action Center、Test Manager、Automation Ops 和 Automation Hub、Data Service。

您可以配置文件以进行更高级的配置。您可以启用其他产品、禁用任何默认产品、配置 SQL DB 及其各自的连接字符串以及证书。对于多节点 HA 就绪生产模式，我们默认启用高可用性，您可以根据需要将其禁用。

对于高级配置，您可以按照以下说明进行操作：高级安装体验。

注意： 如果退出交互式安装程序并执行高级配置，则需要重新运行交互式安装程序才能完成安装。

步骤 3：复制所有其他集群计算机上的安装文件

从执行配置的集群中的第一台计算机，将安装程序、证书和 cluster_config.json 复制到所有其他计算机。

在集群中的第一台计算机上

1. 通过运行以下命令，将 /opt/UiPathAutomationSuite 文件夹复制到所有其他节点：

   scp -r /opt/UiPathAutomationSuite <username>@<node dns>:/opt

   重要提示：由于我们处于离线环境中，因此您可能需要使用目标节点的私有 IP。
2. 如果使用证书登录，请添加 -i <cert.pem>。如果您将.pem内容复制到本地文件，则新文件需要具有正确的权限。您可以执行 chmod 400 <cert.pem> 授予权限。

上述步骤可确保在所有计算机上复制相同的配置以及安装捆绑包的所有下载包。

步骤 4：运行安装

有两种类型的计算机：服务器和代理。

• 服务器 - 运行 Kubernetes 基础架构（即 apiserver、etcd）的计算机。这些组件管理整个集群。
• 代理- 用于运行工作负载的计算机原始版本

多节点 HA 就绪生产模式至少需要 3 台服务器计算机。安装 Task Mining 需要添加一台额外的计算机作为代理。

备注：

• 对于多节点 HA 就绪生产安装，您需要负载均衡器。请确保已创建一个节点，并且已在节点之间分配流量。需要在 cluster_config.json 文件中使用负载均衡器的域名。
• 您至少需要一个服务器节点，而对于 HA，您至少需要 3 个服务器节点。服务器节点的数量需为奇数。

步骤 4.1：接受许可协议

在运行安装之前，请务必阅读许可证协议。

要接受许可证协议，请选择以下方法之一：

• 选项 1（环境变量）- 通过执行以下命令将 LICENSE_AGREEMENT 环境变量设置为“accept”：export LICENSE_AGREEMENT=accept
• 选项 2（内联参数）- 或者，将 --accept-license-agreement 附加到每次执行 install-uipath.sh 后。

步骤 4.2：创建所有计算机并将其加入集群

1. 设置第一台计算机。
   在第一台服务器上执行以下命令：

   cd /opt/UiPathAutomationSuite
   ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement

2. 将其余服务器加入集群。
   在其余服务器节点上依次执行以下命令：

   cd /opt/UiPathAutomationSuite
   sudo chmod -R 755 /opt/UiPathAutomationSuite
   sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j server --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement

3. 将其余代理加入集群。
   按顺序在其余代理节点上执行以下命令：

   cd /opt/UiPathAutomationSuite
   sudo chmod -R 755 /opt/UiPathAutomationSuite
   sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j agent --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement

步骤 4.3：完成套件安装

完成第一个节点上的安装

加入所有节点后，切换到第一台服务器以完成 Automation Suite 安装：

1. 通过运行以下命令检查是否已正确添加节点：

   sudo su
   export KUBECONFIG=/etc/rancher/rke2/rke2.yaml PATH=$PATH:/var/lib/rancher/rke2/bin
   kubectl get nodes

2. 如果一切正常，您应该会在列表中看到多个节点。

3. 通过执行以下命令完成安装：

   cd /opt/UiPathAutomationSuite
   ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f -s --offline-bundle /opt/UiPathAutomationSuite/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement

警告：

这是最耗时的操作。预计大约需要 2 小时。

加载可选捆绑包

• 要加载可选的 Document Understanding 捆绑包，请执行以下命令：

  ./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"

• 要加载可选的计算机视觉捆绑包，请执行以下命令：

  ./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"

步骤 5：完成安装

注意：您已成功完成安装，现在可以转到安装后步骤。

更新证书

重要提示：

安装流程会代表您生成自签名证书。但是，您也可以通过 Azure 部署模板，选择在安装时提供由 CA 颁发的服务器证书，而不是使用自动生成的自签名证书。

自签名证书将在 90 天后过期，安装完成后，您必须将其替换为由受信任的 CA 签名的证书。如果不更新证书，安装将在 90 天后停止工作。

有关说明，请参阅管理证书。

访问 Automation Suite

要访问新创建的集群和套件，请参阅访问 Automation Suite。

调整 PVC 大小

要调整 PVC 的大小，请参阅调整 PVC 大小。

如果您安装了 AI Center，我们建议在安装后立即将 PVC 的大小调整为 200，以避免停机。有关更多信息，请查看调整 AI Center 的 PVC 大小。

添加 Rancher/暂停：3.5

如果您安装了 AI CenterTM，则需要导入和导出 Rancher 映像。有关这方面的更多信息，请查看将 Rancher/pause:3.5 添加到离线注册表。