订阅

UiPath Automation Suite

UiPath Automation Suite 指南

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

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

概述


🚧

重要

在继续安装之前,必须完成硬件和软件先决条件。
硬件和软件要求


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

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

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

StepDescription
Step 1: Download the installation packagesThis step needs to be performed from a machine with access to internet and to the air-gapped machines where Automation Suite will be deployed. While these are finishing downloading, you can continue to some of the next steps.

This can be done from a Linux or windows machine.

Step 1.1: Downloading the installation package
Step 1.2: Getting all downloaded files on the first machine
Step 2: Configure the installation Run the interactive install wizard to configure the installation options

The tool will gather inputs for most common install options and generate a configuration file that will be used during the installation.

Configure advanced install options (Optional)

The default install configuration includes the products used in core automation and a shared SQL server to be used by all products. To customize the products installed or have separate SQL servers used for specific products you can do so by editing the configuration file.

Step 2.1: Basic configuration
Step 2.2: (Optional) Advanced configuration
Step 3: Copy the installation files on all the machines On the first machine, copy the downloaded files in the installation folder created by the installation wizard at step 2.
On the other cluster machines, copy the entire installation folder from the first machine to the same folder path on each machine.

Step 3: Copy the installation files on all the machines
Step 4: Run the installation Create the cluster and join all machines

From the first machine install the rest of the suite.

Step 4: Running the installation
Step 5: Complete the installation Step 5: You have completed the installation successfully and can move to post-installation steps.
You can now access the newly created cluster and suite, update certificates, resize the PVC, and more.

Step 5: Completing the installation

 

蓝色后台步骤在可访问互联网的计算机上执行。
在正在部署安装套件的计算机上执行绿色后台步骤。

 

步骤 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 - 必填。有关下载说明,请参见 sf.tar.gz
    • sf-infra.tar.gz - 必填。有关下载说明,请参见 sf-infra.tar.gz
    • du-ondemand.tar.gz - 可选。仅 Document Understanding 需要。有关下载说明,请参见 du-onDemand.tar.gz
      注意:不遵循此可选步骤将限制 Document Understanding 服务的功能。
    • du2110-ondemand.tar.gz - 可选。仅 Document Understanding 需要。有关下载说明,请参见 du2110-onDemand.tar.gz
      注意:不遵循此可选步骤将限制 Document Understanding 服务的功能。
    • cv-ondemand.tar.gz - 可选。仅 Computer Vision 需要。有关下载说明,请参见 du-onDemand.tar.gz
      注意:不遵循此可选步骤将阻止访问计算机实具视觉服务。

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

 

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

  • 检查所有文件是否已在可访问互联网的计算机上完成下载
  • 在第一台计算机上创建目标文件夹
  • 将文件从联机计算机复制到第一台目标计算机
在集群中的所有计算机上
&nbsp

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

sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 777 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp
Note: Running mkdir -p /opt/UiPathAutomationSuite/ is not required if you use the configureUiPathDisks.sh script.
在可访问互联网的单独计算机上
&nbsp

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

  1. 从可访问互联网的计算机上,将文件复制到目标计算机上的安装文件夹,并将离线捆绑包复制到 /uipath/tmp 文件夹。
  2. scp ~/installUiPathAS.sh ~/sf-installer.zip ~/sf-infra.tar.gz <username>@<node dns>:/uipath/tmp
    scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/
  3. (可选)要使用 Document Understanding,请将以下捆绑包复制到 /uipath/tmp 文件夹。
  4. scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
    scp ~/du2110-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
    注意:不遵循此可选步骤将阻止访问 Document Understanding 服务。
    &nbsp
  5. (可选)要使用计算机视觉,请将以下捆绑包复制到 /uipath/tmp 文件夹。
  6. scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
    注意:不遵循此可选步骤将阻止访问计算机实具视觉服务。

 

步骤 2:配置安装


步骤 2.1:基本配置

在集群的主计算机上
&nbsp
  1. 将先决条件文件夹添加到当前路径。
    交互式安装程序需要 jq,已包含在我们的 Automation Suite 离线捆绑包中。运行以下命令将其添加到路径,确保您仍然是根用户:
  2. 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

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

  5. 运行交互式安装向导以配置安装选项。
    交互式向导将指导您完成配置步骤并生成配置,以便您在剩余的安装步骤中自定义并加以使用。

  6. 运行脚本以开始交互式向导:
    chmod +x ./installUiPathAS.sh
    ./installUiPathAS.sh


按照向导中的步骤操作
逐屏序列
  1. 输入多节点 HA 就绪生产模式选项。

  2. &nbsp
  3. 输入离线选项:

  4. &nbsp
  5. 指定集群的 URL(多节点 HA 就绪生产模式中的 DNS 主机名/负载均衡器 URL)和 SQL Server 信息,如下所示:

  6. &nbsp
  7. 将使用文件夹生成配置,如下图所示。

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

 

步骤 2.2:(可选)高级配置

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

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

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

 

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


从执行配置的集群中的第一台计算机,将整个安装文件夹复制到所有其他计算机。

在集群中的第一台计算机上
&nbsp
  1. 通过运行以下命令,将 /opt/UiPathAutomationSuite 文件夹复制到所有其他节点:
  2. scp -r /opt/UiPathAutomationSuite <username>@<node dns>:/opt
    请注意:由于我们处于离线环境中,因此您可能需要使用目标节点的私有 IP。
    &nbsp

  3. 如果使用证书登录,请添加 -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. Set up the first machine.
      Execute the following commands on the first server:
      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. 将其余服务器加入集群。
      Execute the following commands on the rest of the server nodes in sequence:
      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. 将其余代理加入集群。
      Execute the following commands on the rest of the agent nodes in sequence:
      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:完成套件安装

    Once all nodes are joined, switch to the first server to finish the Automation Suite installation:
     
    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 /uipath/tmp/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement
      请注意:这是最耗时的操作。预计需要约 2 小时。
     

    加载可选捆绑包命令
     
    • 要加载可选的 Document Understanding 捆绑包,请执行以下命令:
    ./install-uipath.sh -i ./cluster_config.json -o ./output.json --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" --accept-license-agreement
    ./install-uipath.sh -i ./cluster_config.json -o ./output.json --optional-offline-bundle "/uipath/tmp/du2110-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" --accept-license-agreement
    

  • 要加载可选的计算机视觉捆绑包,请执行以下命令:
  • ./install-uipath.sh -i ./cluster_config.json -o ./output.json --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" --accept-license-agreement

     

    步骤 5:完成安装


    📘

    备注:

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

    更新证书

    🚧

    重要

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

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

    有关说明,请参阅管理证书

    访问 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.

    2 个月前更新


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


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

    建议的编辑仅限用于 API 参考页面

    您只能建议对 Markdown 正文内容进行编辑,而不能建议对 API 规范进行编辑。