Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
bpclient — 管理主服务器上的客户端条目
大纲
-All [-M master_server] [-l | -L | -H]
-client client_name [-M master_server] [-l | -L | -H]
-client client_name [-M master_server] -add | -update [-dynamic_address 0|1] [-free_browse 0|1|2] [-list_restore 0|1|2|3] [-max_jobs [1-99] [-current_host host_name] [[-online] | [-offline [[-ut] -onlineat time]] | [-online_backup] | [-offline_backup [[-ut] -online_backup_at time]] | [-online_restore] | [-offline_restore [[-ut] -online_restore_at time]]] [-WOFB_enabled 0|1] [-WOFB_FIM 0|1] [-WOFB_usage 0|1] [-WOFB_error 0|1] [-connect_options 0|1|2 0|1|2 0|1|2|3] [-granular_proxy granular_proxy_host] [-client_direct 0|1|2] [-client_direct_restore 0|1|2]
-client client_name [-M master_server] -delete
-client client_name -add_alias alias_name | -delete_alias alias_name [-M master_server]
-client client_name -add_all_aliases | -delete_all_aliases | -list_all_aliases [-M master_server]
-policy policy_name -validate -fi
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bpclient 命令描述 NetBackup 服务器连接到 NetBackup 客户端的方式。
选项
- -add
添加新的客户端条目。
- -add_alias | -delete_alias alias_name
添加新的客户端别名条目,或者删除现有的客户端别名条目。
- -add_all_aliases | -delete_all_aliases | -list_all_aliases
执行以下各项之一:
-add_all_aliases 为每个客户端别名添加一个新条目。
-delete_all_aliases 删除所有别名。
-list_all_aliases 输出所有别名条目的列表。
- -All
列出所有客户端条目。仅显示使用 bpclient 命令显式添加的客户端条目。
- -client client_name
指定要列出或更新的客户端名称。
- -client_direct 0 | 1 | 2
Client Direct 通过使用 OpenStorage 存储服务器(而不是介质服务器)将数据传输到客户端来提高备份性能。-client_direct 选项设置确定客户端是否以及何时使用此功能。可能的设置如下:
0 = 从不在指定的主机上使用 Client Direct 作为数据传输方法。始终使用正常的数据传输方法。这是默认设置。
1 = 希望使用 Client Direct。用于在备份期间标识的存储服务器上探查 Client Direct 功能。如果探查通过,NetBackup 将在指定的客户端上使用 Client Direct 数据传输方法。如果探查失败,则将使用正常的数据传输方法。
2 = 始终使用 Client Direct。尝试仅对指定的客户端使用 Client Direct 方法。如果此方法因故失败,则相应的作业会失败。不会尝试任何其他传输方法。
- -client_direct_restore 0 | 1 | 2
Client Direct 还原通过使用 OpenStorage 存储服务器(而不是介质服务器)将数据还原到客户端来提高还原性能。-client_direct 选项设置确定客户端是否以及何时使用此功能。可能的设置如下:
0 = 从不在指定的主机上使用 Client Direct 还原作为数据传输方法。始终使用正常的数据传输方法。这是默认设置。
1 = 希望使用 Client Direct 还原。该命令用于在还原期间标识的存储服务器上探查 Client Direct 还原功能。如果探查通过,NetBackup 将在指定的客户端上使用 Client Direct 还原数据传输方法。如果探查失败,则将使用正常的数据传输方法。
2 = 始终使用 Client Direct 还原。尝试仅对指定的客户端使用 Client Direct 还原方法。如果此方法因故失败,则相应的作业会失败。不会尝试任何其他传输方法。
- -connect_options 0|1|2 0|1|2 0|1|2|3
此选项仅适用于本地 NetBackup 服务器进行连接的客户端名称。
第一组参数与“端口”对应,所代表的含义如下:
0 = 保留端口:使用保留端口号。
1 = 非保留端口:使用非保留端口号连接到客户端的 bpcd。如果选择该选项,则为选定客户端启用“允许非保留端口”
2 = 使用默认值:“使用默认值”是默认设置。使用服务器上的 DEFAULT_CONNECT_OPTIONS 配置条目所定义的值。
第二组参数与“BPCD 逆向连接”对应,所代表的含义如下:
0 = 随机端口:NetBackup 在允许的范围内随机选择一个空闲的端口来执行传统的逆向连接方法。
1 = VNETD 端口: 此方法不需要逆向连接到随机端口。相反,应逆向连接到网络后台驻留程序 (vnetd)。网络后台驻留程序用于在服务器-服务器和服务器-客户端通信期间,针对 NetBackup 提高防火墙效率。
2 = 使用默认值:默认选项。使用服务器上的 DEFAULT_CONNECT_OPTIONS 配置条目所定义的值。
第三组参数与“后台驻留程序连接端口”对应,所代表的含义如下:
0 = 自动:此选项表示尽可能使用 VNETD 端口,否则使用旧式端口。
1 = 使用 VNETD 端口。
2 = 使用旧式端口号。
3 = 使用默认值:默认选项。使用服务器上的 DEFAULT_CONNECT_OPTIONS 配置条目所定义的值。
注意:
如果使用 vnetd 后台驻留程序连接端口,则“BPCD 逆向连接”设置不适用。如果使用 vnetd 后台驻留程序连接端口,则不管如何设置“端口”的值,都始终使用非保留端口。
- -current_hostname host_name
客户端的当前主机名。仅在使用 -dynamic_address 1 选项时,该选项才有意义。通常,不需要输入 -current_hostname 的值。客户端通常会与主服务器联系以设置主机名和 IP 地址。
- -delete
删除现有的客户端条目。
- -dynamic_address 0 | 1
0 = 假定客户端名称为客户端的有效主机名(默认值)。
1 = 假定客户端具有动态主机名(如 DHCP)。
- -fi
验证 bpplinfo 命令中的 -snapshot_method_args 选项。请参见 –validate 选项。
- -free_browse 0 | 1 | 2
一种方法,用户可通过该方法在浏览映像(所有者或组)时避开服务器检查。默认情况下,Windows 中不允许普通用户浏览预定备份。
0 = 允许
1 = 拒绝
2 = 使用
默认情况下,应将客户端和服务器都设置为 0(允许)。要实现自由浏览,必须将客户端或服务器设置为 2(使用)。两者都不能设置为 1(拒绝)。
- -granular_proxy granular_proxy_host
为源客户端指定 Windows 粒度代理主机。复制由粒度恢复技术 (GRT) 启用的备份映像时,可以使用此选项。
- -H
列出特定于主机的客户端信息。
- -l
列出有限的客户端信息。
- -L
以详细格式列出所有客户端信息。
- -list_restore 0 | 1 | 2 | 3
可在服务器上设置为禁止来自特定客户端的列出请求和还原请求。客户端数据库中的值会覆盖
bp.conf
文件设置。0 = 未指定(默认值)
1 = 允许列出请求和还原请求
2 = 仅允许列出请求
3 = 拒绝列出请求和还原请求
- -M master_server
包含客户端条目的主服务器的名称。本地配置中的第一个服务器名称即为默认主服务器。
- -max_jobs [1-99]
在该客户端上最多可并行运行的作业数,最多为 99。可以在 NetBackup 管理控制台上配置此项。它标注为“最多数据流数”。要使用此 GUI 来执行这一功能,请选择以下内容:“主机属性” (双击主服务器名称) 。
- -online | -offline
将客户端状态设置为联机或脱机以便进行备份和还原。
- -onlineat time
在指定的时间将客户端状态设置为联机以便进行备份和还原。
- -online_backup | -offline_backup
将客户端状态设置为联机或脱机以便进行备份。
- -online_backup_at time
在指定的时间将客户端状态设置为联机以便进行备份。
- -online_restore | -offline_restore
将客户端状态设置为联机或脱机以便进行还原。
- -online_restore_at time
在指定的时间将客户端状态设置为联机以便进行还原。
- -policy policy_name
指定要验证的备份策略的名称。此选项与 –validate 和 –fi 选项一起使用。
- -update
更新现有的客户端条目。
- -ut
指定时间(UNIX 时间)。
- -validate
使用 NetBackup 命令创建基于快照的策略(例如 VMware 或 Hyper-V)时,此选项将验证该策略。要验证使用 bpplinfo -snapshot_method_args 命令创建的策略,–validate 必须与 –fi 选项一起使用。
有关使用 NetBackup 命令创建 VMware 或 Hyper-V 策略的更多信息,请参见 NetBackup for VMware 指南或 NetBackup for Hyper-V 指南。
- -WOFB_enabled 0|1
0 = 对 client_name 中指定的客户端禁用 Windows Open File Backup。
1 = 对 client_name 中指定的客户端启用 Windows Open File Backup。
- -WOFB_error 0 | 1
0 = 发生错误时中止备份。该属性指定,在创建快照后,如果备份操作使用该快照来备份文件系统上已打开的或活动的文件,却因快照相关问题而失败,则备份将中止。
1 = 禁用快照并继续。指定如果备份过程中快照失效,则销毁用于该备份的卷快照。备份将在禁用 Windows Open File Backup 的情况下继续执行。
- -WOFB_FIM 0 | 1
0 = 将 Volume Snapshot Provider (VSP) 用作 Windows Open File Backup 的快照提供程序。VSP 仅在使用 NetBackup 6.x 版的客户端上受支持。使用 NetBackup 7.x 版的客户端仅使用 VSS。如果运行 7.x 版客户端并为此选项选择 VSP,NetBackup 会自动运行 VSS。
1 = 将 Microsoft 的 Volume Shadow Service (VSS) 用作 Windows Open File Backup 的快照提供程序。
- -WOFB_usage 0|1
0 = 单个驱动器快照。指定快照应为单个驱动器的快照。如果启用了此属性,则创建快照和备份文件将基于每个卷依次完成。
1 = 全局驱动器快照。指定快照应为全局驱动器的快照。即同时为备份作业(或多数据流备份的流组)中需要快照的所有卷创建快照。
示例
示例 1 - 确定客户端 hagar
是否位于主服务器上的客户端数据库中:
# bpclient -client hagar -L
示例 2 - 将 casper
添加到主服务器上的客户端数据库中。它还允许最多在 casper
上运行五个并行作业。
# bpclient -client casper -add -max_jobs 5
示例 3 - 详细列出了客户端 ollie
的所有客户端信息。
# bpclient -client ollie -L Client Name: ollie Current Host: Hostname: ollie IP Address: 0.0.0.0 Dynamic Address: no Free Browse: Allow List Restore: Not Specified Max Jobs This Client: Not Specified WOFB Enabled: yes WOFB FIM: VSP WOFB Usage: Individual Drive Snapshot WOFB Error Control: Abort on Error Client Direct: Prefer to use client-side deduplication or Prefer to move data direct to storage Client Direct Restore: Move data via media server OST Proxy: Off OST Proxy Server: Unspecified Connect options: 2 2 3