离线单节点评估安装

本页说明如何使用单节点评估设置执行离线 Automation Suite 安装。

概述

重要提示：

You must meet the hardware and software prerequisites before proceeding with the installation. See Hardware and software requirements.

You can use a dedicated script to validate the installation prerequisites and infrastructure readiness. See Validating the prerequisites.

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

在无法访问互联网的离线环境中部署 UiPath Automation Suite 时，请使用本文档中的离线安装步骤。如果部署计算机可以访问互联网的环境，我们建议使用针对该情况优化的在线安装步骤。

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

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

重要提示：

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 – Mandatory. See installUiPathAS.sh for download instructions.

   • sf-installer.zip – Mandatory. See sf-installer.zip for download instructions.

   • sf.tar.gz – Mandatory. See sf.tar.gz for download instructions.

   • sf-infra.tar.gz - Optional. Only needed if you want to join additional nodes, including Task Mining and GPU. See sf-infra.tar.gz for download instructions.

   • du-ondemand.tar.gz – Optional. Needed only for Document Understanding. See du-ondemand.tar.gz for download instructions.

     备注：

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

   • cv-ondemand.tar.gz – Optional. Needed only for Computer Vision. See du-ondemand.tar.gz for download instructions.

     备注：

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

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

请务必执行以下步骤：

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

在集群的主计算机上

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

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

备注：

Running mkdir -p /opt/UiPathAutomationSuite/ is not required if you use the configureUiPathDisks.sh script.

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

将文件复制到其中一个节点：

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

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

   如果您计划加入其他节点，例如 Task Mining 或 GPU，请运行以下命令：

   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/
   

   警告：

   Not following this optional step prevents access to the Document Understanding services.

3. （可选）要使用计算机视觉，请将以下捆绑包复制到 /uipath/tmp 文件夹。

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

   警告：

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

步骤 2：配置安装

步骤 2.1：基本配置

在集群的主计算机上

1. 将先决条件文件夹添加到当前路径。

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

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

   如果您计划加入其他节点，例如 Task Mining 或 GPU，请运行以下命令：

   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
   

Running the interactive wizard in single-node offline mode

运行交互式安装向导以配置安装选项。该工具收集大多数常见安装选项的输入，并生成您可以在安装过程中使用的配置文件。

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

要使用交互式向导安装 Automation Suite，请执行以下步骤：

1. 选择“安装 UiPath Automation Suite”。

   

2. 选择部署模式：选择“单节点”选项。

3. 选择“继续”。

4. Select air-gapped installation.

5. 输入 DNS 主机名。

6. 指定是否要对 SQL 连接使用 Kerberos 身份验证。

7. 输入 SQL Server URL。按照提示输入连接端口、用户名和密码。

8. 指定是否要让安装程序自动创建必要的 DB（有关详细信息，请参阅下一步骤）。

   

9. 定义配置参数后，安装程序将自动生成配置。您可以直接在终端中编辑配置参数。

   

   在此步骤中，您可以直接编辑 UiPathAutomationSuite 文件夹中的 cluster_config.json 高级配置设置。编辑配置文件后，您可以重新运行向导以完成安装或手动完成安装。

   You can go to the following section here: Advanced configuration step for more details. After editing, you can re-run the wizard to continue with installation.

   如果要安装 Task Mining，请确保在 cluster_config.json 中同时启用 AI Center 和 Task Mining。

10. 此时，您可以继续安装。

    

11. 该流程即将完成，您将在给定的计算机上安装该套件。

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

此步骤是可选的。

您可以在 UiPathAutomationSuite 文件夹中找到 cluster_config.json 文件。您可以使用此文件启用其他产品、禁用任何默认产品、配置 SQL DB 及其各自的连接字符串以及证书。如果您使用代理进行互联网连接，也可以启用代理设置。

请注意，对于单节点评估安装，您无法启用高可用性。

For advanced configuration, see Advanced installation experience.

备注：

您必须重新运行交互式安装程序才能完成安装。

步骤 3：运行安装

确保您在执行配置的离线主计算机上复制了安装向导创建的安装文件夹中下载的文件。

接受许可协议

Before running the installation, make sure to read the License Agreement.

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

• Option 1 (Environment Variable): Set the LICENSE_AGREEMENT environment variable to accept by executing the following command: export LICENSE_AGREEMENT=accept
• 选项 2（内联参数）：或者，将 --accept-license-agreement 附加到 install-uipath.sh的每次执行中。

运行安装程序

运行安装命令以执行离线捆绑包（预计持续时间：2 小时 30 分钟 - 3 小时 30 分钟）：

./install-uipath.sh -i ./cluster_config.json -o ./output.json -a --offline-bundle /uipath/tmp/sf.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement

如需帮助，您可以运行 ./install-uipath.sh -h --accept-license-agreement。

加载可选捆绑包

要加载可选的 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"

This document focuses on -a command argument as this caters to need of installing all the required components.

安装 Task Mining

If you install Task Mining in single-node evaluation mode, you need to run an additional set of steps. Follow the Task Mining installation guide to complete the steps for Task Mining.

步骤 4：完成安装

备注：

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

更新证书

重要提示：

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

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

For instructions, see Managing certificates.

访问 Automation Suite

To access the newly created cluster and suite, see Accessing Automation Suite.

调整 PVC 大小

To resize the PVC, see Resizing PVC.

If you installed AI Center, we recommend resizing the PVC to 200 immediately after the installation to avoid downtimes. For more information on this, check Resizing PVC for AI Center.

添加 Rancher/暂停：3.5

If you installed AI CenterTM, you need to import and export the Rancher image. For more information on this, check Adding rancher/pause:3.5 to offline registry.