- 入门指南
- 网络要求
- 单节点要求和安装
- 多节点要求和安装
- 安装后
- 配置 GPU
- 使用配置文件
- 节点调度
- 迁移和升级
- 基本故障排除指南
程序
步骤 1:在第一台计算机上下载安装脚本
1.1 下载安装包
This step needs to be run on a machine with internet access and access to the machines in the air-gapped environment where UiPath AI Center will be installed.
此计算机可以是 Linux 或 Windows。提供的步骤将在此计算机上运行。在本文档中,存在针对基于 RHEL 的操作系统的示例。对于 Windows 或其他操作系统版本,请调整特定于这些环境的等效步骤。
Follow the steps below on the separate machine with internet access to get the required files to start the installation process:
-
连接到可访问互联网的计算机并运行以下命令以获取交互式向导文件:
ssh <user>@<dns_of_vm>ssh <user>@<dns_of_vm> -
如果您使用了 ssh 密钥,请运行以下命令:
ssh -i <path/to/Key.pem> <user>@<dns_of_vm>ssh -i <path/to/Key.pem> <user>@<dns_of_vm> -
下载以下包:
-
installUiPathAS.sh- Mandatory. See installUiPath.as 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 needd 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 cv-ondemand.tar.gz for download instructions.备注:注意:不遵循此可选步骤将阻止访问 Computer Vision 服务。
-
确保下载适合您的 AI Center 版本和操作系统的包。
1.2 获取第一台计算机上所有下载的文件
请务必执行以下步骤:
- 检查所有文件是否已在可访问互联网的计算机上完成下载。
- 在计算机上创建目标文件夹。
- 将文件从联机计算机复制到目标计算机。
Create the installation folder on the main machine of the cluster by running the following command:
sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 777 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp
sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 777 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp
On the separate machine with internet access, copy the files to the first node:
-
从可访问互联网的计算机上,将文件复制到目标计算机上的安装文件夹,并将离线捆绑包复制到
/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/ scp ~/sf-infra.tar.gz <username>@<node dns>:/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/ scp ~/sf-infra.tar.gz <username>@<node dns>:/uipath/tmp/ -
(可选)要使用 Document Understanding,请将以下捆绑包复制到
/uipath/tmp文件夹。scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/备注:Not following this optional step prevents access to the Document Understanding services.
-
(可选)要使用计算机视觉,请将以下捆绑包复制到
/uipath/tmp文件夹。scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/备注:注意:不遵循此可选步骤将阻止访问 Computer Vision 服务。
步骤 2:将 Orchestrator 证书复制到虚拟机
In case of chain certificates, check the Chain certificates section on how to correctly provide certificates.
下载 Orchestrator 证书并将其保存在本地计算机上。您可以使用浏览器执行此操作,也可以要求 IT 部门提供证书。证书必须为 base64 和 .cer 格式。使用以下命令将证书复制到虚拟机。
确保 /opt/UiPathAutomationSuite 具有通过 scp 复制文件的正确权限,或将文件复制到您的主目录,然后将其移动到 /opt/UiPathAutomationSuite。
scp /path/to/orch.cer <username>@<node dns>:/opt/UiPathAutomationSuite
scp /path/to/orch.cer <username>@<node dns>:/opt/UiPathAutomationSuite
如果 Identity Server 与 Orchestrator 不同,请对 identityserver.cer 重复上述步骤。
链式证书
使用域颁发的证书时,请确保按如下方式导出根证书:
-
打开证书,转到“证书路径”选项卡,然后选择第一个证书。单击“查看证书”。
-
显示根证书后,转到“详细信息”选项卡,然后单击“复制到文件”。
-
确保选择 base64
cer文件格式。 -
使用您选择的名称保存,然后将其发送到 AI Center 计算机。
生成的文件应类似于以下示例。
-----BEGIN CERTIFICATE-----
certificate
base64
encoded
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
certificate
base64
encoded
-----END CERTIFICATE-----
步骤 3:配置安装
基本配置
The following prerequisites are applicable for the main machine of the cluster.
-
将以下先决条件添加到当前 PATH:
交互式安装程序需要
jq,已包含在我们的离线捆绑包中。运行以下命令将其添加到路径:(确保您仍然是根用户)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/binmv /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 -
提供安装程序文件夹的权限:
需要为安装脚本所在且即将在此处执行的
/opt/UiPathAutomationSuite文件夹提供足够的权限。安装程序还将在每个阶段执行后创建一些文件 (output.json)。运行以下命令以提供权限:
chmod -R 755 /opt/UiPathAutomationSuitechmod -R 755 /opt/UiPathAutomationSuite -
运行交互式安装向导以配置安装选项:
交互式向导将指导您完成配置步骤并生成配置文件,然后可以在剩余的安装步骤中自定义并使用该配置文件。
-
通过运行以下命令,运行脚本以启动交互式向导:
chmod +x ./installUiPathAS.sh ./installUiPathAS.shchmod +x ./installUiPathAS.sh ./installUiPathAS.sh -
按照以下向导中的步骤操作。
3.1 使用交互式向导创建基本配置文件
Make sure to not start the install from the script and exit it when config file is generated, it will try to install full Automation suite otherwise. This script is primarily used for Automation Suite and the displayed information (products, requirements) is relative to Automation Suite. The config file will be adapted to our needs in the next steps of the procedure.
启动安装向导后,将显示主菜单。在这里,您需要选择所需的部署模式:单节点或多节点。做出选择后,系统会提示您有关每种模式的详细信息。之后,您可以选择继续当前选项或返回主菜单。
请按照部署配置步骤操作:
-
Accept the license agreement.
-
选择部署模式:选择“多节点部署”选项。
-
选择“继续”。
-
选择离线安装。
-
选择“完成安装”。
-
输入 DNS 主机名。
-
指定是否要对 SQL 连接使用 Kerberos 身份验证。
-
输入 SQL Server URL。按照提示输入连接端口、用户名和密码。
-
指定是否要让安装程序自动创建必要的数据库。
系统将使用文件夹生成集群配置文件,如下图所示。
生成配置文件和文件夹后,即可退出向导并继续执行以下剩余步骤以完成安装。 您可以忽略产品列表,因为我们将在以下步骤中进行更新。
现在已生成 cluster_config.json 文件的第一个版本。我们将根据 AI Center 安装目的更新此文件。
3.2 添加特定于 AI Center 的配置
使用编辑器(例如 vi)打开文件:
vi /opt/UiPathAutomationSuite/cluster_config.json
vi /opt/UiPathAutomationSuite/cluster_config.json
替换以下块:
"aicenter": {
"enabled": "false"
},
"aicenter": {
"enabled": "false"
},
Document Understanding is enabled by default if AI Center is enabled.
使用以下信息(将 <> 之间的信息替换为您的值):
"aicenter": {
"enabled": "true",
"orchestrator_url":"<https://orchestrator-url.com>",
"identity_server_url": "<https://orchestrator-url.com/identity>",
"orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
"identity_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
"identity_access_token": "<placeholder will be replaced later>"
},
"aicenter": {
"enabled": "true",
"orchestrator_url":"<https://orchestrator-url.com>",
"identity_server_url": "<https://orchestrator-url.com/identity>",
"orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
"identity_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
"identity_access_token": "<placeholder will be replaced later>"
},
3.3(可选)高级配置
您可以在 UiPathAutomationSuite 文件夹中找到 cluster_config.json 文件。您可以使用此文件配置 SQL DB 及其各自的连接字符串和证书。如果您使用代理进行互联网连接,也可以启用代理设置。
For advanced configuration, see Using the configuration file.
步骤 4:复制所有其他集群计算机上的安装文件
From the first machine in the cluster, where the configuration was performed, copy the entire install folder to all other machines:
-
运行以下命令,将
~/UiPathAutomationSuite文件夹复制到所有其他节点:scp -r ~/UiPathAutomationSuite <username>@<node dns>:/optscp -r ~/UiPathAutomationSuite <username>@<node dns>:/opt备注:Since we are in an air-gapped environment, you might need to use the private IP of the target node.
-
如果使用证书登录,请添加
-i <cert.pem>。如果您将.pem内容复制到本地文件,则新文件需要具有正确的权限。您可以执行chmod 400 <cert.pem>授予权限。
上述步骤可确保在所有计算机上复制相同的配置以及安装捆绑包的所有下载包。
步骤 5:运行安装
-
在所有节点上运行基础架构安装程序:
-
通过在主服务器上执行以下命令来设置主计算机:
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 --install-standalone-aicentercd /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 --install-standalone-aicenter -
通过在其余服务器节点上执行以下命令,将其余服务器加入集群:
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 /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicentercd /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 /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicenter -
通过在其余代理节点上执行以下命令,将其余代理加入集群:
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 /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicentercd /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 /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicenter
-
-
在主节点上运行 Fabric 安装程序
cd /opt/UiPathAutomationSuite export TMPDIR="/uipath/lib/containers/tmp" mkdir -p "/uipath/lib/containers/tmp" ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f --offline-bundle /uipath/tmp/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement --install-standalone-aicentercd /opt/UiPathAutomationSuite export TMPDIR="/uipath/lib/containers/tmp" mkdir -p "/uipath/lib/containers/tmp" ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f --offline-bundle /uipath/tmp/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement --install-standalone-aicenter -
Run the software installer on primary node First you need to connect to identity server and retrieve an installation token. Then copy this token and paste it in placeholder we had in step 3.2. (in the cluster_config.json file). Once the token is there, you can run the AI Center install.
./install-uipath.sh -i cluster_config.json -o output.json --install-type offline --accept-license-agreement --install-standalone-aicenter -s./install-uipath.sh -i cluster_config.json -o output.json --install-type offline --accept-license-agreement --install-standalone-aicenter -s -
加载可选的 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/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" -
加载可选的 Computer Vision 捆绑包命令。 要加载可选的计算机视觉捆绑包,请执行以下命令:
./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-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"