验证多节点 HA 就绪生产设置中的先决条件

概述

在安装 Automation Suite 之前，最好验证安装先决条件和基础架构是否准备就绪。 在执行安装之前，您可以使用validateUiPathASReadiness.sh脚本评估您的环境并生成摘要。

验证	描述
硬件要求	验证集群中的每台计算机是否满足硬件要求。检查时考虑以下方面： 服务器、代理或受污染的节点； 在线或离线系统； 单节点评估配置文件或多节点 HA 就绪生产配置文件。 已启用交换内存。
磁盘分区和配置	验证您是否正确对磁盘进行了分区和配置。检查时考虑以下方面： 服务器或代理节点； 在线或离线系统； 主服务器节点或辅助服务器节点。
SQL Server 连接	验证与已配置的 SQL Server 和数据库的连接。 检查时考虑以下方面： 与给定端点上 SQL Server 主机（端点）的连接； 如果 create_db 的设置为 true，则连接到主体数据库； 如果 create_db 的设置为 true，则创建数据库 (dbcreator) 权限； 创建架构 (db_ddladmin)、读取 (db_datareader) 和写入 (db_datawriter) 权限； 当将 create_db 设置为 false 时与数据库的连接； 每个服务的特殊要求。例如，对于 Insights，脚本会检查列存储索引、json 支持以及 SQL Server 兼容性级别是否 >= 130； 通过集成身份验证连接到数据库和 SQL Server。
服务器证书	检查您提供的服务器证书是否有效。 检查时考虑以下方面： 证书文件格式为 .pem，即 Base64 编码的 DER 证书； 私钥长度至少为 2048； 扩展密钥用法和 TLS Web 服务器身份验证，在 iOS 设备上访问 Automation Suite 所必需的； 所有必需 DNS 条目的主题备用名称； 服务器证书和私钥相符； 您提供的 CA 捆绑包实际上是服务器证书的颁发者； 证书有效期超过 30 天； 证书在启用 FIPS 的计算机上合规。
令牌签名证书	检查您提供的令牌签名证书是否有效。 检查时考虑以下方面： 证书采用 pfx 格式； 解密证书的密码有效； 证书有效期超过 30 天； 证书在启用 FIPS 的计算机上合规。
代理	验证您是否正确配置了代理。 检查时考虑以下方面： https_proxy、http_proxy 和 no_proxy 在计算机上的设置为环境变量； 可以访问代理服务器。
连接性	验证所有计算机是否可以相互连接，所有必需的 URL 是否都在防火墙允许列表中，等等。 检查时考虑以下方面： Automation Suite 的 FQDN 和所有其他子域的 FQDN 可从计算机解析； 在在线设置中，可以从计算机访问所有外部 URL； 所有服务器、代理和受污染的节点都可以通过所需的端口相互连接； 出站连接 (URL) 可通过 /etc/resolve.conf 中存在的所有名称服务器进行解析； 如果无法通过所有名称服务器解析任何 URL，则至少有一个名称服务器可以解析所有 URL； 允许使用 TCP 或 UDP 协议； fixed_rke_address 已设置为端口 9345 和 6443； 在端口 443 上调用 FQDN 时，系统将发出响应。
系统服务	验证系统服务是否已正确配置。 检查时考虑以下方面： nm-cloud-setup.service、nm-cloud-setup.timer、firewalld 已禁用； iscsi-initiator-utils 已安装并已启用； 已为设置为 1 的 --backlog_wait_time 正确配置 auditd； logrotate 已正确配置； 已禁用 net.ipv4.conf.all.rp_filter（设置为 0）。
软件要求	验证是否已安装所有必需的软件。 如果未安装某些软件， install-uipath.sh安装程序将尝试安装该软件。
升级	验证跨 Automation Suite 版本的升级路径是否正确。

使用脚本验证安装先决条件

下载脚本

备注：

对于离线安装，您必须在可访问互联网的计算机上执行此步骤，且此计算机可访问已部署 Automation Suite 的离线计算机。将文件从联机计算机复制到第一台目标计算机。

必备程序脚本与安装程序一起打包在名为as-installer.zip的存档中，支持工具捆绑为as-infra.tar.gz ，仅供离线使用。 您需要这些文件来生成有关计划安装 Automation Suite 的所有计算机的报告。

安装类型	要下载的文件
在线	as-installer.zip – Mandatory. For download instructions, see as-installer.zip.
离线	as-installer.zip – Mandatory. For download instructions, see as-installer.zip. as-infra.tar.gz – Mandatory. For download instructions, see as-infra.tar.gz.

准备使用脚本

1. 通过运行以下命令成为根用户：

   sudo su -
   

2. 运行以下命令，将文件复制到/opt/UiPathAutomationSuite/{version}文件夹：

   VERSION="" #add the version number you are trying to install. Ex: for 2022.4.0 Set VERSION="2022.4.0"
   mkdir -p /opt/UiPathAutomationSuite/${VERSION}
   # For below command replace the /path/to where actually the files are present.
   cp /path/to/as-installer.zip /opt/UiPathAutomationSuite/${VERSION}
   # Additionally for offline, copy as-infra.tar.gz as well to /opt/UiPathAutomationSuite/{VERSION} folder
   cp /path/to/as-infra.tar.gz /opt/UiPathAutomationSuite/${VERSION}
   cd /opt/UiPathAutomationSuite/${VERSION}
   

3. 通过运行以下命令解压缩包：

   unzip as-installer.zip -d installer
   

4. 通过运行以下命令分配必要的权限并导航到脚本文件夹：

   chmod -R 755 installer
   cd installer
   

Script parameters

要查看帮助部分和支持的标志，请运行以下命令：

./validateUiPathASReadiness.sh --help

输出:

***************************************************************************************
validateUiPathASReadiness.sh Runs pre-install validation checks
Usage:
  validateUiPathASReadiness.sh [command]
  validateUiPathASReadiness.sh [flags]
Available Commands:
  validate-packages                                     Validate that required packages are installed
  install-packages                                      Install required packages. If --install-type offline, this will also install offline required packages
Arguments:
 -i|--input                                             Specify cluster config json file. Defaults to /opt/UiPathAutomationSuite/cluster_config.json
 -d|--debug                                             Debug mode to get additional details helpful for debugging
 -m|--machines                                          Comma separated IP address / hostnames of all the machines
 -n|--node-type                                         Possible values [server|agent|taskmining|asrobots|gpu]. Defaults to server
 --install-type                                         Possible values [online|offline]. Defaults to online
 --prereq-bundle </uipath/offline_bundle.tar.gz>        Specify the path to the prereq bundle
 --prereq-tmp-folder </uipath>                          Specify parent directory for the temporary install folder
 --kubeconfig                                           Specify path to the kubeconfig file
 -h|--help                                              Display help
***************************************************************************************

下表描述了运行脚本时可以使用的参数：

参数	描述
-i|--input	Accepts the cluster_config.json file as input. This file defines the parameters, settings, and preferences applied to the UiPath services deployed via Automation Suite. For details, see Advanced Installation Experience. 如果您不提供此文件，则脚本将触发交互式体验以收集这些输入。 然后，系统将代表您生成该文件。
-d|--debug	调试模式，以获取有助于调试的其他详细信息。
-m|--machines	接受所有计算机的以逗号分隔的 IP 地址/主机名。 这是检查所需端口上所有节点之间的连接性所必需的。 对于多节点 HA 就绪生产安装，必须使用该参数。除此之外，如果您计划在单节点评估集群中添加 Task Mining、GPU 或 Automation Suite Robot 节点，则也必须使用该参数。
-n|--node-type	接受当前节点的类型。 可能的值包括： server 、 agent 、 task-mining 、 gpu和asrobots 。 默认值为 server。
--install-type	接受安装方法： online或offline 。 默认值为 online。
--prereq-bundle	接受as-infra.tar.gz所在的绝对路径。
--prereq-tmp-folder	接受将临时提取as-infra.tar.gz捆绑包的绝对路径。 如果未提供此路径，则安装程序将选择/tmp文件夹。
--kubeconfig	指定 kubeconfig 文件的路径。
validate-packages	验证所需的 RPM 包。
install-packages	安装在线安装所需的 RPM 包。
install-packages --install-type offline	安装离线安装所需的 RPM 包。

验证多节点 HA 就绪生产设置

在第一台服务器计算机上

1. 要验证第一台服务器计算机，请运行以下命令：

在线

./validateUiPathASReadiness.sh \
  --node-type server \
  --install-type online \
  --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IPs of all the nodes in cluster

离线

./validateUiPathASReadiness.sh \
  --node-type server \
  --install-type offline \
  --prereq-bundle ../as-infra.tar.gz \
  --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp \
  --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IPs of all the nodes in cluster

执行此脚本后，它将在/opt/UiPathAutomationSuite文件夹下生成一个cluster_config.json文件。 所有其他计算机上都需要此文件。

2. 要在其他计算机上复制cluster_config.json文件，请运行以下命令：

scp /opt/UiPathAutomationSuite/cluster_config.json <username>@<node dns>:/opt/UiPathAutomationSuite

备注：

如果由于权限错误而无法将文件复制到/opt/UiPathAutomationSuite文件夹，则可以将其临时复制到新计算机上的/var/tmp ，然后将其移动到/opt/UiPathAutomationSuite 。

或者，您也可以通过运行以下命令来提供对新计算机上/opt/UiPathAutomationSuite文件夹的完全访问权限 ( 777 )： chmod -R 777 /opt/UiPathAutomationSuite 。

在其他服务器计算机上

要验证其他服务器计算机，请运行以下命令：

在线

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type server \
  --install-type online \
  --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IP of all the nodes in cluster

离线

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type server \
  --install-type offline \
  --prereq-bundle ../as-infra.tar.gz \
  --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp \
  --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IP of all the nodes in cluster

在代理计算机上

要验证代理计算机，请运行以下命令：

在线

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type agent \
  --install-type online \
  --machines "10.0.1.8, 10.0.1.9" # replace with actual machine IP of all the nodes in cluster

离线

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type agent \
  --install-type offline \ #replace with offline for airgap
  --prereq-bundle ../as-infra.tar.gz \
  --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp \
  --machines "10.0.1.8, 10.0.1.9" # replace with actual machine IP of all the nodes in cluster

在专用代理计算机上

要验证 Task Mining、GPU 或 Automation Suite Robot 计算机，请运行以下命令：

备注：

确保使用合适的参数来标识您的专用代理节点：

• 对于 Task Mining 计算机，请使用--node-type task-mining
• 对于 GPU 计算机，请使用--node-type gpu
• 对于 Automation Suite 机器人计算机，请使用--node-type asrobots

在线

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type task-mining \ #replace with gpu for GPU node or asrobots for Automation Suite Robots node
  --install-type online \
  --machines "10.0.1.8, 10.0.1.9" # replace with actual machine IP of all the nodes in cluster

离线

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type task-mining \ #replace with gpu for GPU node or asrobots for Automation Suite Robots node
  --install-type offline \
  --prereq-bundle ../as-infra.tar.gz \
  --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp \
  --machines "10.0.1.8, 10.0.1.9" # replace with actual machine IP of all the nodes in cluster