推送客户端

推送客户端可以理解为是在执行一个任务。执行任务的前提需要创建任务并发起任务。推送客户端实则是在创建任务完成的同时直接发起任务，减少了人工发起的成本。

前提条件

• 控制台已安装且完成用户初始化，超级管理员或者租户管理员登录。
• Linux、Unix或Windows主机配置已创建完成，且通过环境检查，主机状态正常。
• 指定的安装目录下不存在同名的AnyBackClient安装目录。
• 确保指定的安装目录以及父目录的剩余空间大于等于2 GB。

注意事项

• 跨网段场景，无法ssh连接目标主机，则不支持推送安装。
• 推送客户端支持多个主机批量推送，限制一次性不可超过20个主机。
• 在控制台证书替换之后，发起推送安装客户端，客户端证书不匹配无法上线。仍须手动在客户端机器上执行证书替换操作，使客户端证书与控制台证书保持一致。

操作步骤

1. 超级管理员或租户管理员登录管理控制台。

2. 左侧导航栏选择集合设置 > 客户端与代理，点击主机配置，进入主机配置页面。

3. 勾选一个或多个状态为正常的目标主机，点击推送客户端，创建推送安装任务。

4. 填写任务的基本信息，然后点击下一步。

   • 任务名称：自定义任务名称。
   • 并发数：同时执行安装的主机数，默认为1。并发数最大设置为5，且与勾选的主机数量两者取最小值，表示同一批量主机，最多支持5个主机并发同时安装。
   • Linux/Unix安装路径：Linux/Unix客户端安装路径，默认 /opt。如选择的主机为Linux/Unix系统，仅需填写此项。
   • Windows安装路径：Windows客户端安装路径，默认C:\BackupAgent。如选择的主机为Windows系统，仅需填写此项。
   • 卸载已安装的客户端：如主机上之前安装过客户端软件，可开启卸载已安装的客户端选项，卸载已安装的客户端。

5. 根据客户端需求选择主机需要安装的应用代理。可选一个或多个应用代理。

6. （Linux/Unix主机）配置数据库应用。

   Linux/Unix类型的主机，如选择安装数据库应用代理，需完成如下配置：

   数据库应用	配置说明
   Oracle	用户名：输入Oracle数据库的安装用户。如需添加多个用户，点击添加用户名。默认可输入1个安装用户，最大输入5个安装用户。
   MySQL	用户名：输入MySQL数据库的安装用户。 MySQL安装路径：为MySQL工具（mysqld、mysqld_safe、mysqladmin、mysqlbinlog、mysql）共同父路径。如有工具不存在，建议先安装。 如需添加多个用户，点击添加用户名。默认可输入1个安装用户与安装路径，最大输入5个安装用户和安装路径。
   DB2	用户名：输入DB2数据库的安装用户。默认可输入1个安装用户与文件路径，最大输入5个安装用户和文件路径。 libdb2.so文件路径：输入DB2数据库的libdb2.so路径，长度限制256字符。 如需添加多个用户，点击添加用户名。默认可输入1个安装用户与安装路径，最大输入5个安装用户和安装路径。 注意：libdb2.so文件路径不允许相同。
   GaussDB	用户名：输入GaussDB用户名。 GaussDB版本：选择GaussDB A或GaussDB T。
   达梦	用户名：输入达梦数据库的安装用户。 达梦数据文件路径：输入达梦数据库的数据路径。 如需添加多个用户，点击添加用户名。默认可输入1个安装用户与安装路径，最大输入5个安装用户和安装路径。
   Informix	用户名：输入Informix数据库的安装用户。 bash文件路径：bash文件查看方法：执行su - informix，ls -al，可以查看到 .bashrc或 .bash_profile，具体看环境实际情况，填入此文件路径即可。 缓存日志存放路径：不能设置为客户端安装目录 /AnyBackupClient 目录或其下级目录。在非客户端安装目录 /AnyBackupClient 目录或其下级目录创建一个文件即可，例如：mkdir Informixlog，创建好不需要手动修改权限，程序会自动修改。此路径存放的抢救日志文件会很多，建议此路径空间配置大一些。 如需添加多个用户，点击添加用户名。默认可输入1个安装用户与安装路径，最大输入5个安装用户和安装路径。
   PostgreSQL	用户名：输入PostgreSQL数据库的安装用户。 PostgreSQL数据库安装路径：填写PostgreSQL数据库安装路径的父路径。 安装类型：选择安装为单机实例或集群实例进行备份。 PostgreSQL数据库数据路径：安装类型为集群时，需填写PostgreSQL数据库的数据路径。 如需添加多个用户，点击添加用户名。默认可输入1个安装用户与安装路径，最大输入5个安装用户和安装路径。

7. 配置完成之后，点击完成，创建推送安装客户端任务完成，客户端开始执行推送安装任务。

8. 点击推送安装与更新作业标签页，可以看到创建的推送安装任务，任务状态为运行中或排队中。

更多操作

推送安装任务发起后，您可以查看任务详情或停止任务。推送安装任务完成后，您可以手动删除历史任务，或配置清理策略，实现自动删除。

查看任务详情

在推送安装与更新作业页面，选中一个任务，点击任务名称，在弹窗中可查看任务执行详情。同时可点击导出日志按钮导出当前任务日志，导出格式为TXT/XLS。

停止任务

在推送安装与更新作业页面，勾选一条或者多条运行中或者排队中的任务，点击终止。

任务状态首先流转为终止中，等待大约15-30秒左右（根据实际情况定）任务状态流转为已停止，准备中的主机直接失败，运行中的主机等待到运行结束，状态变为已终止。

手动删除任务

在推送安装与更新作业页面，勾选一条或者多条历史任务，点击删除。

注意：批量删除任务不超过50条，运行中和排队中的任务不可删除。

自动删除任务

可配置清理策略实现推送安装任务的自动清理。

1. 在推送安装与更新作业页面，点击清理策略。

2. 在清理策略弹框内，配置清理策略。

   可选择保留天数、保留个数、不清理三种策略。

   • 选择保留天数，默认90，输入需要保留的具体天数，区间范围30-180。当前用户下的所有历史任务将根据配置的天数进行定时清理。

   • 选择保留个数，默认100，输入具体数值，区间范围10-300。将根据配置的任务个数，默认每天早上8点定时清理历史任务。

   • 选择不清理，即不清理历史任务。

3. 点击确定。