Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
bpverify — 验证由 NetBackup 创建的备份
大纲
[-l] [-p] [-pb] [-v] [-local] [-client name] [-st sched_type] [-sl sched_label] [-L output_file [-en]] [-policy name] [-s date] [-e date] [-M master_server] [-Bidfile file_name] [-pt policy_type] [-hoursago hours] [[-cn copy number] | [-primary]] [-backupid backup_id] [[-id media_id or path] | [-stype server_type] [-dp disk_pool_name [-dv disk_volume]]] [-priority number]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bpverify 通过读取备份卷,并将其内容与 NetBackup 目录库进行比较来验证一个或多个备份的内容。该操作并不将卷数据与客户端磁盘的内容进行比较。它读取映像中的每个块以验证卷是否为可读。NetBackup 一次只验证一个备份,并尝试最大限度地缩短介质装入和定位时间。
如果指定了 -Bidfile 或 -backupid,则在选择要验证的备份集时,bpverify 将该选项作为唯一的条件。如果没有在命令行中指定 -Bidfile 或 -backupid,bpverify 将选择满足所有选项的备份。例如,如果命令行类似于以下内容:
bpverify -pt Standard -hoursago 10
bpverify 将验证在过去 10 小时内运行且具有 Standard 策略类型的备份集。
如果指定了 -p 或 -pb,bpverify 将预览满足选择条件的备份集。将显示备份 ID,但并不执行验证。
bpverify 会将其错误消息发送到 stderr。该命令会将其当天的活动日志发送到位于以下目录的 NetBackup 管理日志文件:
UNIX 系统:
/usr/openv/netbackup/logs/admin
Windows 系统:
install_path\NetBackup\Logs\admin
任何得到授权的用户均可运行此命令。
有关 NetBackup 授权的详细信息,请参见《NetBackup 安全和加密指南》。
选项
- -backupid backup_id
指定要验证的单个备份的备份 ID。除 -Bidfile 以外,该选项优先于任何其他选择条件。默认为任何备份。
- -Bidfile file_name
指定一个包含要验证的备份 ID 列表的文件。此文件会在命令行界面 (CLI) 激活期间删除。删除文件的原因是 NetBackup GUI 经常使用此参数。而这些 GUI 要求该命令行界面在操作完成后删除用于 -Bidfile 选项的临时文件。命令行界面的直接用户也可以使用此选项,但是此选项将删除该文件。
在该文件中,一个备份 ID 占一行。如果指定该选项,则忽略其他的选择条件。默认为没有备份 ID 的文件,表示可以验证任何备份。
- -client name
指定生成原始备份的客户端的名称。默认为任何客户端。
- -cn copy_number|-primary
确定要验证的备份 ID 的副本号。有效值为从 1 到 bpconfig -max_copies 设置所指定的设置,最大值为 10。默认值为 1。
-primary 指示应验证主副本而不是该副本。
- -dp disk_pool_name [-dv disk_volume]
指定磁盘池的名称。磁盘池是该存储单元的数据存储区域。另外,bpverify 仅验证驻留在指定磁盘卷上的映像。该选项必须与 -stype 选项一起使用。磁盘池必须已存在。
- -hoursago hours
从当前时间算起,指定要搜索此前多少小时之内的备份。这相当于将开始时间 (-s) 指定为当前时间减去 hours 值。不要将该选项与 -s 选项一起使用。
Hours 值是一个非负整数。默认的开始时间为 24 小时前。
- -id media_id | path
在映像目录库中搜索备份,以验证它们是否位于此介质 ID 或路径名上。如果备份的一些片段位于该介质 ID 上,而另一些片段位于其他介质 ID 上,则会发生以下情况:只要在所提供的介质 ID 的介质上开始备份,NetBackup 便会对跨介质映像进行验证。
对于存储在磁盘而非可移动介质上的映像,需要指定绝对路径名而不是 media_id。默认为任何介质 ID 或路径名。BasicDisk 使用此选项。
- -L output_file [-en]
指定要在其中写入进度信息的文件的名称。默认为不使用进度文件,在这种情况下,将进度信息写入 stderr。有关更多信息,请参见此命令说明后面介绍的“显示格式”。
UNIX 系统示例路径:
/usr/openv/netbackup/logs/user_ops
Windows 系统示例路径:
c:\Program Files\Veritas\NetBackup\logs\user_ops
使用 -en 选项可生成英文的日志条目。日志名称中包含字符串 _en。在分布式环境中,不同的语言环境可能创建不同语言的日志,此时该选项对于支持人员很有用。
仅允许对此选项使用默认路径,建议使用默认路径。如果无法在您的设置中使用 NetBackup 默认路径,应向 NetBackup 配置中添加自定义路径。
有关如何添加自定义路径的更多信息,请参见 NetBackup 管理指南,第 I 卷中的“NetBackup 服务器和客户端的 BPCD_WHITELIST_PATH 选项”主题。
- -l
指定列表类型为长列表,以使 bpverify 向进度日志中写入附加信息。默认列表类型为短列表。有关附加信息,请参见此命令说明后面介绍的“显示格式”。
- -local
如果从主服务器以外的主机启动 bpverify,并且没有使用 -local(默认),则发生以下情况:bpverify 在主服务器上启动该命令的远程副本。
该远程副本允许从活动监视器终止该命令。
使用 -local 可禁止在主服务器上创建远程副本,并且仅从启动 bpverify 的主机上运行它。
如果使用了 -local 选项,将无法从活动监视器中取消 bpverify。
- -M master_server
指定提供 bpverify 映像数据的主服务器。主服务器必须允许发出 bpverify 命令的系统对其进行访问。默认为输入 bpverify 的系统的主服务器:
对于 NetBackup 服务器:
默认值始终是输入该命令的主服务器。
对于 NetBackup Enterprise Server:
如果在主服务器上输入该命令,则该服务器为默认服务器。
如果在远程介质服务器上输入该命令,则该介质服务器的主服务器为默认服务器。
- -p
预览验证,但并不执行验证。有关附加信息,请参见此命令说明后面介绍的“显示格式”。
- -pb
预览验证,但并不执行验证。-pb 选项类似于 -p 选项,但前者不显示各备份的信息。有关附加信息,请参见此命令说明后面介绍的“显示格式”。
- -policy name
在指定策略中搜索要验证的备份。默认为任何策略。
- -priority number
为验证作业指定一个新优先级来覆盖默认作业优先级。
- -pt policy_type
指定选择要验证的备份时使用的策略类型。默认值为任意策略类型。
有效的策略类型包括:
BigData DataStore DataTools-SQL-BackTrack DB2 Enterprise-Vault FlashBackup Hyper-V Informix-On-BAR Lotus-Notes MS-Exchange-Server MS-SharePoint MS-SQL-Server MS-Windows NBU-Catalog NDMP Oracle PureDisk-Export SAP Split-Mirror Standard Sybase Vault VMware
- -s date, -e date
为所有要验证的备份指定日期和时间范围的开始时间。-e 选项指定范围的截止时间。
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。
/usr/openv/msg/.conf
文件 (UNIX) 和install_path\VERITAS\msg\LC.CONF
文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。请参见《NetBackup 管理指南,第 II 卷》 中的“关于指定 NetBackup 安装的区域设置”。
有效的日期范围为 01/01/1970 00:00:00 到 01/19/2038 03:14:07。默认的开始时间为 24 小时前。默认的截止时间为当前的日期和时间。
- -sl sched_label
搜索备份以验证指定的日程表已创建。默认值为所有日程表。
- -st sched_type
搜索备份以验证指定的日程表类型已创建。默认值为任意日程表类型。
有效值包括:
FULL(完全备份)
INCR(差异增量式备份)
CINC(累积增量式备份)
UBAK(用户备份)
UARC(用户存档)
NOT_ARCHIVE(除用户存档之外的所有备份)
- -stype server_type
指定标识存储服务器类型的字符串。server_type 值可能源自以下来源之一:
Veritas 提供的存储。可能的值有 AdvancedDisk 和 PureDisk。
第三方磁盘设备。供应商提供了 server_type 字符串。
云存储。使用 csconfig cldprovider -l 命令确定可能的 stype 值。云 stype 值反映了云存储提供程序。云存储 stype 值还可包含一个后缀(例如
amazon_crypt
)。可能的后缀是:_raw:将具有原始格式的 NetBackup 备份映像发送至云。如果您在将数据发送至云存储前不需要压缩或加密数据,则使用此选项。
_rawc:在将数据写入云存储之前压缩数据。
_crypt
:在将数据写入云存储之前使用 AES-256 加密对此数据进行加密。要使用此选项,必须在 NetBackup 中配置 KMS。_cryptc:将数据写入云存储之前压缩和加密数据。
存储服务器类型区分大小写。
- -v
选择详细模式。如果指定了 -v,调试日志和进度日志将包含更多信息。默认为非详细模式。
显示格式
预览的显示内容:
bpverify 可以运行预览,采用的方法是搜索备份,然后按以下方式之一显示它们(bpverify 不验证备份):
-p 显示内容中列出了满足 bpverify 命令行选项所设条件的备份 ID。-p 信息按卷顺序显示。对于包含所选备份的每个卷,都会列出介质 ID 和服务器。随后显示驻留在该卷上的所选备份 ID。
-pb 显示内容是 -p 显示内容的简要版本。对于包含满足选择条件的备份的每个卷,此选项将列出这些卷的介质 ID 和服务器。
验证的显示内容:
bpverify 在验证映像时创建这些显示内容。如果 bpverify 不包含用于设置列表格式的选项,则显示格式为短格式。如果命令行包含 -l,则显示格式为长格式。如果命令行同时包含 -l 和 -L,则 bpverify 会创建一个包含进度日志的文件。
验证列表使用以下格式按卷顺序显示:
在长格式中,bpverify 显示每个所选备份 ID 的以下信息:
策略、日程表、备份 ID、介质 ID 或路径以及创建时间
备份的文件
bpverify 在验证映像时检测到的任何问题
映像验证是否成功
在短格式中,bpverify 不列出备份的文件。
示例
示例 1 - 对过去 36 小时内运行的备份进行验证:
# bpverify -hoursago 36 Verify started Thu Feb 3 11:30:29 2012 INF - Verifying policy mkb_policy, schedule Full (plim_0949536546), path /tmp/mkbunit, created 02/02/12 18:09:06. INF - Verify of policy mkb_policy, schedule Full (plim_0949536546) was successful. INF - Status = successfully verified 1 of 1 images.
示例 2 - 比较 -p 和 -pb 这两种预览显示模式:
# bpverify -p -hoursago 2002 Media id = A00002 Server = plim Bid = plim_0949616279 Kbytes = 32800 Filenum = 1 Fragment = 1 Bid = gava_0949681647 Kbytes = 12191 Filenum = 2 Fragment = 1 Bid = gava_0949683298 Kbytes = 161 Filenum = 3 Fragment = 1 Bid = gava_0949683671 Kbytes = 11417 Filenum = 4 Fragment = 1 Bid = gava_0949684009 Kbytes = 11611 Filenum = 5 Fragment = 1 Bid = gava_0949684276 Kbytes = 806 Filenum = 6 Fragment = 1 Bid = gava_0949688704 Kbytes = 9869 Filenum = 7 Fragment = 1 Bid = gava_0949688813 Kbytes = 9869 Filenum = 8 Fragment = 1 Bid = gava_0949949336 Kbytes = 10256 Filenum = 9 Fragment = 1 Bid = plim_0949949337 Kbytes = 6080 Filenum = 9 Fragment = 1 Bid = plim_0949949337 Kbytes = 4176 Filenum = 10 Fragment = 2 Bid = gava_0949949686 Kbytes = 10256 Filenum = 11 Fragment = 1 Bid = plim_0949949687 Kbytes = 5440 Filenum = 11 Fragment = 1 Bid = plim_0949949687 Kbytes = 4816 Filenum = 12 Fragment = 2 Media id = 400032 Server = plim Bid = toaster2_0950199621 Kbytes = 298180 Filenum = 1 Fragment = 1 Bid = toaster2_0950199901 Kbytes = 298180 Filenum = 3 Fragment = 1 # bpverify -pb -hoursago 200 Media id = A00002 Server = plim Media id = 400032 Server = plim
返回值
0 退出状态表示已成功运行命令。任何非 0 的退出状态都表示发生了错误。
如果启用了管理日志功能,bpverify 会将退出状态记录在日志目录下的每日管理日志中:
UNIX 系统:
/usr/openv/netbackup/logs/admin
Windows 系统:
install_path\NetBackup\logs\admin
它具有下列形式:
bpverify: EXIT status = exit status
如果出错,将在显示该消息之前进行诊断。
文件
UNIX 系统:
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/error/* /usr/openv/netbackup/db/images/*
Windows 系统:
install_path\NetBackup\logs\admin\* install_path\NetBackup\db\error\* install_path\NetBackup\db\images\*