自动化：在集群上启用备份

在开始之前

备注：

• Make sure you meet the prerequisites for backing up and restoring the cluster.
• Make sure you have prepared your environment for using the uipathctl.sh script. For details, see Using uipathctl.sh.
• 本节中的步骤不会为任何外部数据源备份（例如 SQL Server）启用备份。 您必须单独启用外部数据源备份。

Ansible 用于在 Automation Suite 集群中的所有服务器节点上自动执行备份。 服务器节点是存储所有数据和 etcd 配置的位置。 因此，您只需创建服务器节点的备份。

在下图中，节点服务器 1 （或 Ansible 主机节点）使用 Ansible 跨所有服务器节点编排备份配置。 您不需要在代理和专用 Task Mining 或 GPU 节点上启用备份。

备注：

在备份阶段，您不必提供 Ansible inventory.ini文件。 uipathclt.sh脚本代表您从现有集群生成此文件。

但是，在还原集群时，您必须向还原脚本提供inventory.ini文件，因为不会建立任何集群来生成它。

配置备份

要配置备份，请执行以下步骤：

1. 登录到之前标识为 Ansible 主机节点的服务器节点，然后导航到安装程序文件夹。 安装程序位于/opt/UiPathAutomationSuite/{version}/installer文件夹中。

2. 使用基本参数运行以下命令以启用备份，确保使用适用于您的参数值。

   ./uipathctl.sh configure-backup --install-type online --backup-endpoint "10.0.0.1" --backup-mount "/asbackup" --backup-name "mycluster"
   

Basic Parameters

参数	值
--install-type	可能的值： online和offline 。
--backup-endpoint	NFS 服务器的端点。 提供 NFS 服务器的 IP 地址或 FQDN。 示例： IP 地址 – 10.0.0.1 FQDN – mynfs.mycompany.com
--backup-mount	NFS 服务器上已装载用于存储备份数据的磁盘的位置。 这是绝对文件路径。 示例： /asbackup
--backup-name	要与 Automation Suite 集群关联的备份的名称。 还将使用相同的名称在--backup-mount位置下创建一个用于存储备份数据的文件夹。 参数的值必须是名称，而不是文件路径。 示例： 接受的值 – mycluster 值不正确 – /asbackup/mycluster
--backup-config	As an alternative to --backup-endpoint, --backup-mount, and --backup-name, you can provide the backup.json file to the uipathctl.sh script at the time of configuring the backup. For details, see the Preparing the backup configuration section.

高级参数

参数	值
--ansible-username	指定用于与所有节点的 SSH 连接的用户名。 默认为当前用户。 如果您对所有节点使用不同的用户名，则不要使用此参数，而是在inventory.ini中设置所有节点的用户名，并将其传递给脚本。 示例： 运行脚本时，您将以myadminuser用户名登录。 但是，如果要使用testadmin用户名通过 SSH 连接，则必须为此参数提供testadmin 。
--inventory	指定现有的 Ansible 清单文件。 如果未指定，系统将使用基本配置从现有集群自动生成一个。 在某些情况下，您希望进行更精细的控制，您可能需要提供自己的清单文件。 例如，如果您想对集群中的所有节点使用不同的 SSH 用户名或 SSH 密钥。 For details, see Generating the Ansible inventory.ini file.

备注：

创建备份后，系统将生成restore.json文件并将其保存到/var/tmp/uipathctl_<version>/restore.json 。 您可以在还原方案中使用此文件。