离线单节点评估安装

概述

重要提示：

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

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

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

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

步骤	描述
步骤 1：下载安装包	您可以从可以访问互联网的 Linux 或 Windows 计算机以及计划部署 Automation Suite 的离线计算机执行此步骤。安装包下载完成后，您可以继续执行后续步骤。 步骤 1.1：下载安装包 步骤 1.2：获取计算机上所有下载的文件
步骤 2：配置安装	交互式安装程序会收集最常见安装选项的输入，并生成可在安装期间使用的配置。 步骤 2.1：配置安装：默认配置 交互式安装程序提供默认体验，配置选项数量有限。要自定义已安装的产品，请为特定产品设置单独的 SQL 服务器等，请编辑配置文件。 步骤 2.2：（可选）配置安装：高级配置（可选）
步骤 3：运行安装	运行安装。安装完成后，您就可以开始使用集群了。 步骤 3：运行安装
步骤 4：完成安装	您已成功完成安装，可以转到安装后步骤。 您现在可以访问新创建的集群和套件、更新证书、调整 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：下载安装包

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

本页面中的命令适用于基于 RHEL 的操作系统。对于 Windows 或其他操作系统，请调整特定于这些环境的等效命令。

重要提示： 在启动 Automation Suite 安装程序之前，您必须安装所需的 RPM 包。有关详细信息，请参阅 RPM 包要求。

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

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

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

   ssh <user>@<dns_of_vm>

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

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

3. 下载以下包：
   • installUiPathAS.sh – 必需。 有关下载说明，请参阅 installUiPathAS.sh 。
   • as-installer.zip – 必需项。有关下载说明，请参阅 as-installer.zip。
   • as.tar.gz – 可选。仅在没有可用的外部 Docker 注册表时才需要。有关下载说明，请参阅 as.tar.gz。
   • as-infra.tar.gz - 可选。仅在使用外部 Docker 注册表或加入其他节点（例如 Task Mining 或 GPU）时才需要。有关下载说明，请参阅 as-infra.tar.gz。
   • du-ondemand.tar.gz – 可选。仅 Document Understanding 需要。有关下载说明，请参见 du-onDemand.tar.gz。
     注意：不遵循此可选步骤将限制 Document Understanding 服务的功能。
   • cv-ondemand.tar.gz – 可选。仅 Computer Vision 需要。有关下载说明，请参见 du-onDemand.tar.gz。
     备注：

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

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

请务必执行以下步骤：

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

在集群的主计算机上

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

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

注意： 如果使用“ configureUiPathDisks.sh ”脚本，则无需运行 mkdir -p /opt/UiPathAutomationSuite/ 。

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

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

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

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

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

   scp ~/installUiPathAS.sh ~/as-installer.zip ~/as-infra.tar.gz <username>@<node dns>:/uipath/tmp
   scp ~/as.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/as-installer.zip /opt/UiPathAutomationSuite
   cd /opt/UiPathAutomationSuite
   unzip ./as-installer.zip -d .
   chmod +x ./bin/jq
   export PATH=${PATH}:/opt/UiPathAutomationSuite/bin

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

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

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

   chmod -R 755 /opt/UiPathAutomationSuite

3. 运行交互式安装程序以配置安装选项。
   重要提示：

   交互式安装程序尝试下载 as-installer.zip，但在离线环境中失败。要绕过下载步骤并防止出现任何安装问题，请运行以下命令：

   export BUNDLE_FILE="/opt/UiPathAutomationSuite/as-installer.zip"

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

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

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

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

运行交互式安装程序以配置安装选项。该工具会收集最常见安装选项的输入，并生成配置文件。单节点评估模式不支持 HAA。

要安装 Automation Suite，请执行以下步骤：

1. 启动交互式安装程序。
2. 接受许可协议以继续安装。
3. 在“主菜单”中，选择您的部署模式。选择“单节点部署”（建议用于演示/评估目的）并确认您的选择。
   
4. 在“部署配置”中，选择您的环境类型。选择“离线”。
5. 选择您的产品选择。您的选项包括：
   • 完成（所有产品）
   • 选择产品

   备注：

   有关产品选择选项的详细信息，请参阅硬件和软件要求。

6. 如果您在上一步中选择了“选择产品”，请指明要安装的产品。您的选项包括：
   • Action Center
   • AI Center
   • Apps
   • Automation Hub
   • Automation Ops
   • Automation Suite 机器人
   • Data Service
   • Document Understanding
   • Insights
   • Orchestrator
   • Process Mining
   • Task Mining
   • Test Manager

   重要提示：

   某些 Automation Suite 产品之间存在其他依赖项。选择要安装的产品时，请务必考虑跨产品依赖项。尝试安装不带依赖项的产品会导致错误。

   某些 Automation Suite 产品（例如 Task Mining 和 Document Understanding）需要专用代理节点。在继续之前，请确保您满足硬件要求。

7. 要安装 AI Center，您必须执行其他步骤：
   1. 指定 AI Center 是否需要外部 Orchestrator。
      • 如果 AI Center 需要外部 Orchestrator，请继续执行步骤 8。
      • 如果 AI Center 需要外部 Orchestrator，请继续执行步骤 7b。
   2. 将 Orchestrator 证书复制到虚拟机。有关这方面的更多信息，请查看复制 Orhcestrator 证书页面。
   3. 指定 AI Center 的 Orchestrator URL。示例：https://orchestrator.example.com。
   4. 指定 AI Center 的身份 URL。示例：https://orchestrator.example.com/identity。
   5. 指定 Orchestrator 证书文件的路径。示例：/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer。
   6. 指定身份证书文件的路径。示例：/opt/UiPathAutomationSuite/UiPath_Installer/identity.cer。
      重要提示：在离线安装中，您无需指定计量 API 密钥。要完成 AI Center 安装，请按照“完成安装”部分中的步骤操作。
8. 确认您的产品选择，以确定最低硬件和软件要求。
9. 输入 Automation Suite FQDN。
10. 指定是否要为所选产品引入自己的对象存储。如果选择“否”，则表示选择默认对象存储。如果选择“是”，请选择以下选项之一：
    • Azure 存储帐户 – 指明是否要将基于托管身份的托管标识与 Azure 存储帐户一起使用，提供与您的选择相对应的以下详细信息，然后指定是否要为所有选定产品自动配置容器：
      • 如果为“是”，请提供 Azure 存储帐户名称和端点后缀，以及您的客户端 ID；
      • 如果为“否”，请提供 Azure 存储帐户名称和端点后缀，以及您的 Azure 帐户密钥；
    • AWS S3 – 提供存储桶名称的前缀和后缀、托管存储桶的 AWS 区域、S3 帐户的访问密钥和密钥，并指定是否要为所有选定产品自动配置存储桶。
    • 其他与 S3 兼容的存储 – 指定存储桶名称的前缀和后缀、S3 服务器 FQDN、S3 端口、访问密钥和 S3 帐户的密钥，并指定是否要为所有选定的产品自动配置存储桶。
      重要提示：许多 S3 对象存储要求将 CORS 设置为来自 Automation Suite 集群的所有流量。您必须在对象存储级别配置 CORS 策略，以允许使用集群的 FQDN。
11. 指定是否要加入自己的与 OCI 兼容的外部 Docker 注册表。

    • 如果选择“否”，则默认选择内部 Docker 注册表。

    • 如果选择“是”，则必须提供有关要使用的注册表的以下详细信息：包含端口、用户名、密码和拉取密码的注册表 URL。

12. 指定是否要对 SQL 连接使用 Kerberos 身份验证。
13. 输入 SQL Server URL。按照提示输入连接端口、用户名和密码。
    重要提示：如果您安装 Process Mining，则建议使用第二个 SQL Server。确保提供仓库 SQL Server URL、连接提示、用户名和密码。

    有关第二个 SQL Server 必须满足的硬件要求的详细信息，请参阅 Process Mining 的 SQL 要求。
14. 指定是否要让安装程序自动创建必要的数据库。
15. 为需要安全 TLS 通信的任何外部软件提供 CA 证书，否则安装将失败。如果未启用 TLS 通信，则可以在安装后配置证书。
    重要提示：安装程序仅接受“PEM”格式的 Base64 编码 DER 证书。如果外部服务器具有不同的 CA，则可以将所有公共证书连接到一个文件中。
16. 定义配置参数后，安装程序会自动生成配置文件。您可以直接在终端中编辑配置参数。
    重要提示：生成配置文件和文件夹后，您可以退出安装程序并继续执行以下剩余步骤以完成安装。

在安装过程结束时，系统会提示您提供部署摘要，您可以在其中访问集群管理门户、主机门户、组织管理界面、Rancher、ArgoCD 等。

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

此步骤是可选的。

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

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

有关高级配置，请参阅高级安装体验。

备注：

完成安装后，您可以重新运行向导。

步骤 3：运行安装

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

接受许可协议

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

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

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

运行安装程序

运行以下命令，以执行基础架构安装并安装 Kubernetes、存储和网络组件：

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

使用内部 Docker 注册表时上传离线捆绑包

完成架构安装后，如果您使用内部 Docker 注册表，请通过在第一个节点上运行以下命令来上传离线捆绑包：

./configureUiPathAS.sh registry upload --offline-bundle /opt/UiPathAutomationSuite/as.tar.gz --offline-tmp-folder /uipath/tmp

完成安装

运行安装命令以安装产品（预计持续时间：2 小时 30 分钟 - 3 小时 30 分钟）：

cd /opt/UiPathAutomationSuite
./install-uipath.sh -i ./cluster_config.json -o ./output.json -f -s --install-type offline --accept-license-agreement

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

加载可选捆绑包

备注：

仅当您未选择外部 Docker 注册表时，才需要执行此步骤。

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

本文档重点介绍 -a 命令参数，因为它可以满足安装所有必需组件的需求。

安装 Task Mining 节点

如果您在单节点评估模式下安装 Task Mining 节点，则需要运行一组额外的步骤。请按照 Task Mining 安装指南完成 Task Mining 的步骤。

步骤 4：完成安装

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

更新证书

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

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

如果您在启用 FIPS 140-2 的主机上安装了 Automation Suite，并想要更新证书，请确保它们与 FIPS 140-2 兼容。

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

访问 Automation Suite

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

完成 AI Center 安装

如果 AI Center 需要外部 Orchestrator，请运行以下命令以完成安装：

./configureUiPathAS.sh aicenter configure --installation-token <identity token>

有关如何配置 AI Center 的 Orchestrator 的更多信息，请查看 AI Center 指南中的“配置 Orchestrator”页面。