ai-center
2022.4
true
- 入门指南
- 网络要求
- 单节点要求和安装
- 多节点要求和安装
- 安装后
- 配置 GPU
- 使用配置文件
- 节点调度
- 迁移和升级
- 基本故障排除指南
AI Center 安装指南
Last updated 2024年6月6日
程序
此步骤需要在可访问互联网的计算机上运行,且此计算机可访问将要安装UiPath AI Center的离线环境中的计算机。
注意:此计算机可以是 Linux 或 Windows。提供的步骤将在此计算机上运行。在本文档中,存在针对基于 RHEL 的操作系统的示例。对于 Windows 或其他操作系统版本,请调整特定于这些环境的等效步骤。
在 可访问互联网的单独计算机 上按照以下步骤操作,以获取开始安装过程所需的文件:
- 连接到可访问互联网的计算机并运行以下命令以获取交互式向导文件:
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
- 必填。有关下载说明,请参阅 installUiPath.as。sf-installer.zip
- 必填。有关下载说明,请参见sf-installer.zip 。sf.tar.gz
- 必填。有关下载说明,请参见 sf.tar.gz。sf-infra.tar.gz
- 可选。仅当您要加入其他节点(包括 Task Mining 和 GPU)时才需使用。有关下载说明,请参阅 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。注意:不遵循此可选步骤将阻止访问计算机实具视觉服务。
确保下载适合您的 AI Center 版本和操作系统的包。
请务必执行以下步骤:
- 检查所有文件是否已在可访问互联网的计算机上完成下载。
- 在计算机上创建目标文件夹。
- 将文件从联机计算机复制到目标计算机。
通过运行以下命令在集群的主计算机上创建安装文件夹:
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
在 可访问互联网的单独计算机上,将文件复制到第一个节点:
- 从可访问互联网的计算机上,将文件复制到目标计算机上的安装文件夹,并将离线捆绑包复制到
/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/注意:不遵循此可选步骤将阻止访问 Document Understanding 服务。 - (可选)要使用计算机视觉,请将以下捆绑包复制到
/uipath/tmp
文件夹。scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/注意:不遵循此可选步骤将阻止访问计算机实具视觉服务。
注意:如果是链式证书,请查看链式证书部分,了解如何正确提供证书。
下载 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-----
以下先决条件适用于 集群的主机。
- 将以下先决条件添加到当前 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/bin
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 - 提供安装程序文件夹的权限:
需要为安装脚本所在且即将在此处执行的
/opt/UiPathAutomationSuite
文件夹提供足够的权限。安装程序还将在每个阶段执行后创建一些文件 (output.json
)。运行以下命令以提供权限:
chmod -R 755 /opt/UiPathAutomationSuite
chmod -R 755 /opt/UiPathAutomationSuite - 运行交互式安装向导以配置安装选项:
交互式向导将指导您完成配置步骤并生成配置文件,然后可以在剩余的安装步骤中自定义并使用该配置文件。
- 通过运行以下命令,运行脚本以启动交互式向导:
chmod +x ./installUiPathAS.sh ./installUiPathAS.sh
chmod +x ./installUiPathAS.sh ./installUiPathAS.sh - 按照以下向导中的步骤操作。
注意:确保不要从脚本开始安装,并在生成配置文件时退出脚本,否则它将尝试安装完整的 Automation Suite。此脚本主要用于 Automation Suite,显示的信息(产品、要求)与 Automation Suite 相关。在过程的后续步骤中,配置文件将适应我们的需求。
启动安装向导后,将显示主菜单。在这里,您需要选择所需的部署模式:单节点或多节点。做出选择后,系统会提示您有关每种模式的详细信息。之后,您可以选择继续当前选项或返回主菜单。
请按照部署配置步骤操作:
- 接受许可协议。
- 选择部署模式:选择“多节点部署”选项。
- 选择“继续”。
- 选择离线安装。
- 选择“完成安装”。
- 输入 DNS 主机名。
- 指定是否要对 SQL 连接使用 Kerberos 身份验证。
- 输入 SQL Server URL。按照提示输入连接端口、用户名和密码。
- 指定是否要让安装程序自动创建必要的数据库。
系统将使用文件夹生成集群配置文件,如下图所示。
注意:生成配置文件和文件夹后,即可退出向导并继续执行以下剩余步骤以完成安装。您可以忽略产品列表,因为我们将在以下步骤中进行更新。
现在已生成
cluster_config.json
文件的第一个版本。我们将根据 AI Center 安装目的更新此文件。
使用编辑器(例如 vi)打开文件:
vi /opt/UiPathAutomationSuite/cluster_config.json
vi /opt/UiPathAutomationSuite/cluster_config.json
替换以下块:
"aicenter": {
"enabled": "false"
},
"aicenter": {
"enabled": "false"
},
注意:如果启用了 AI Center,则默认启用 Document Understanding。
使用以下信息(将
<>
之间的信息替换为您的值):"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>"
},
您可以在
UiPathAutomationSuite
文件夹中找到 cluster_config.json
文件。您可以使用此文件配置 SQL DB 及其各自的连接字符串和证书。如果您使用代理进行互联网连接,也可以启用代理设置。
有关高级配置,请参阅使用配置文件。
从执行配置的集群中的第一台计算机,将整个安装文件夹复制到所有其他计算机:
- 运行以下命令,将
~/UiPathAutomationSuite
文件夹复制到所有其他节点:scp -r ~/UiPathAutomationSuite <username>@<node dns>:/opt
scp -r ~/UiPathAutomationSuite <username>@<node dns>:/opt注意:由于我们处于离线环境中,因此您可能需要使用目标节点的私有 IP。 - 如果使用证书登录,请添加
-i <cert.pem>
。如果您将.pem
内容复制到本地文件,则新文件需要具有正确的权限。您可以执行chmod 400 <cert.pem>
授予权限。
注意:上述步骤可确保在所有计算机上复制相同的配置以及安装捆绑包的所有下载包。
- 在所有节点上运行基础架构安装程序:
- 通过在主服务器上执行以下命令来设置主计算机:
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-aicenter
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-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-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-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-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-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-aicenter
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-aicenter - 在主节点上运行软件安装程序首先,您需要连接到身份服务器并检索安装令牌。然后复制此令牌并将其粘贴到步骤 3.2 中的占位符中。(在 cluster_config.json 文件中)。
一旦令牌存在,您就可以运行 AI Center 安装程序。
./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"