Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
bpimmedia — 显示介质上 NetBackup 映像的相关信息
大纲
[-disk_stu storage_unit_label | [-dt disk_type | -stype server_type [-dp disk_pool_name [-dv disk_volume]] [-legacy]]] [-l | -L] [-disk | -tape] [-policy policy_name] [-client client_name] [-d date time] [-e date time] [-mediaid media_id | path_name] [-mtype image_type] [-option option_name] [-rl retlevel] [-sl sched_label] [-t sched_type] [-M master_server...] [-verbose]
-spanpools [-cn copy_number] [-mediaid media_id] [-U]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bpimmedia 查询 NetBackup 映像目录库并生成两种类型的映像报告:
“介质上的映像”报告
“跨池”报告
“提要”部分中第一种形式的 bpimmedia 在“介质上的映像”报告中显示一组 NetBackup 映像。此报告列出 NetBackup 映像目录库中记录的介质内容。
您可以对任何介质(包括磁盘)生成此报告。还可以根据客户端、介质 ID 或路径等过滤报告内容。
有关“介质上的映像”报告中字段的详细信息,请参见《NetBackup 管理指南,第 II 卷》中的“NetBackup 报告”。
该报告不显示用于备份 NetBackup 目录库的介质的信息。
若干选项(-dt、-dp、-dv 和 -stype)仅报告位于 SAN 磁盘存储器上的映像,而不报告位于任何其他磁盘上的映像。其他选项和输出格式继续照常使用。
“提要”部分中第二种形式的 bpimmedia 使用 -spanpools 列出由于映像跨越不同的卷而关联的磁盘 ID 池。该输出为群集中的每台介质服务器列出了包含跨介质映像的介质 ID。必须在管理卷的 NetBackup 主服务器上运行 bpimmedia 的这种 -spanpools 形式。
有关跨介质映像的详细信息,请参见《NetBackup 管理指南,第 II 卷》中的“跨介质”。
只处理可移动介质类型。
bpimmedia 将其错误消息发送到 stderr
,而bpimmedia 将其活动日志发送到当天的 NetBackup 管理日志文件。
授权用户可以运行此命令。
有关 NetBackup 授权的详细信息,请参见《NetBackup 安全和加密指南》。
选项
- client client_name
客户端名称。该名称必须与它在 NetBackup 目录库中显示的名称相同。默认情况下,bpimmedia 搜索所有客户端。
- -cn copy_number
备份 ID 的副本号(1 或 2)。默认值是副本 1。此选项仅与 -spanpools 组合使用。
- -d date time, -e date time
指定列表的开始和结束日期范围。
-d 指定列表的开始日期和时间。输出列表仅显示在指定日期和时间之后(包括在该日期和时间)生成的备份或存档中的映像。
-e 指定列表的结束日期和时间。输出列表仅显示在指定日期和时间之前(包括在该日期和时间)生成的备份或存档中的文件。所用的格式与开始日期格式相同。默认值是当前的日期和时间。
有效的日期范围为 01/01/1970 00:00:00 到 01/19/2038 03:14:07。默认值是前一天午夜 12 点。
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。
/usr/openv/msg/.conf
文件 (UNIX) 和install_path\VERITAS\msg\LC.CONF
文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。有关系统区域设置的更多信息,请参见《NetBackup 管理指南,第 II 卷》中的“关于指定 NetBackup 安装的区域设置”。
- -dp disk_pool_name
仅显示指定磁盘池上的映像。
- -dt disk_type
指定磁盘存储器的类型。以下为有效选项:
1 - BasicDisk
3 - SnapVault
此选项不适用于 OpenStorage 磁盘类型。
- -dv disk_volume
仅显示位于指定磁盘卷上的映像。输入值为 BasicDisk 的路径。
- -L
列表类型为长列表。
请参见后面的“显示格式”部分。
- -l
列表类型为短列表。如果命令行没有列表类型选项(例如,如果您输入 bpimmedia,然后按回车键),则此设置为默认值。
请参见后面的“显示格式”部分。
- -legacy
以旧式格式格式化新数据。
- -M master_server,...
备用主服务器的列表。这是一个以逗号分隔的主机名列表。如果包含该选项,将在该列表中的每一台主服务器上运行该命令。主服务器必须允许发出该命令的系统对其进行访问。如果任何主服务器发生错误,将在列表中的该主服务器位置处停止处理。默认为输入该命令的系统的主服务器。
- -mediaid media_id | pathname
此 ID 要么是 VSN,要么是绝对路径名。如果介质 ID 是 VSN,则它是包含 1 到 6 个字符的字符串。如果介质 ID 为路径名,则为磁盘存储单元文件系统的绝对路径名。
如果指定了 -mediaid,“介质上的映像”报告仅显示存储在该 VSN 或该路径名上的映像。默认情况下,该报告显示存储在所有介质 ID 和路径名上的映像。
对于“跨池”报告 (-spanpools),-mediaid 后面只能为 VSN。如果使用 -spanpools 时省略了 -mediaid,bpimmedia 将显示所有跨越池中的所有介质。
- -mtype image_type
映像类型。下面是所定义的值及其解释:
0 = 常规备份(预定或用户控制的备份)
1 = 预导入的备份(已完成阶段 1)
2 = 已导入的备份
- -option option_name
指定用于查找要列出的映像的条件。option_name 可为以下字符串之一(采用大写形式或小写形式):
INCLUDE_PRE_IMPORT - 包括已完成第一阶段导入操作的映像。
ONLY_PRE_IMPORT - 仅包括已完成第一阶段导入操作的映像。
默认值是 INCLUDE_PRE_IMPORT。
- -policy policy_name
搜索指定策略名称的映像。默认情况下,bpimmedia 搜索所有策略的映像。
- -rl retlevel
指定 retention_level。retention_level 是一个介于 0 到 100 之间的整数。默认情况下,bpimmedia 会搜索所有保留级别。
注意:
如果在 8.0 版本之前的 NetBackup 介质服务器上运行此命令,则只能指定介于 0 到 24 之间的保留级别。
- -sl sched_label
搜索指定日程表标签的映像。默认情况下,bpimmedia 搜索所有日程表标签的映像。
- -spanpools
指定 bpimmedia 应创建“跨池”报告。默认(-spanpools 不在命令行)创建一个“介质上的映像”报告。
- -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:将数据写入云存储之前压缩和加密数据。
存储服务器类型区分大小写。
- -t sched_type
指定选择映像时使用的日程表类型。默认值为任意日程表类型。有效值(可以采用大写或小写形式)如下所示:
FULL(完全备份)
INCR(差异增量式备份)
CINC(累积增量式备份)
UBAK(用户备份)
UARC(用户存档)
- -tape
“介质上的映像”报告仅显示至少有一个片段位于可移动介质或基于磁带的介质上的映像。忽略此类映像中基于磁盘的片段。如果映像在磁带上和磁盘上都有片段,则该选项仅显示基于磁带的片段。
- -U
列表类型为用户列表。该选项仅与 -spanpools 组合使用。
请参见后面的“显示格式”部分。
- -verbose
为日志记录选择详细模式。仅当该选项在启用了调试日志记录运行时(即,定义以下目录时)才有意义:
UNIX 系统:/usr/openv/netbackup/logs/admin
Windows 系统:install_path\NetBackup\logs\admin
显示格式
“介质上的映像”报告
“介质上的映像”报告有短型(-l,默认选项)和长型 (-L) 两种格式。
若要处理和使用 bpimmedia 的输出,请使用 -l 选项。如果使用 -L 或 -U 选项,则可能会截断 bpimmedia 的输出中的“备份 ID”、“策略”和“主机”列。如果需要快速直观地查看 NetBackup 介质上的映像,可以使用 -L 或 -U 选项。
以下显示“介质上的映像”报告的长显示格式 (-L) 与短显示格式 (-l):
长显示格式 (-L)
如果命令行包含 -L,则显示格式为长格式。它包含每个备份映像的多行条目。一个条目占用 n+1 行,其中 n 为映像的片段号。在后面将列出条目的字段。该条目的第一行包含 Backup_ID 到 Expires 的字段。在映像中,每个片段都有一行包含 Copy_Media ID 字段。该报告有一个包含两行的标题。第一个标题行列出每个条目第 1 行的字段名。第二个标题行列出包含片段信息的那些行的字段名。
有关“副本号”和“主副本”的详细信息,请参见 bpduplicate 命令页。
-L 格式的字段和含义如下:
第 1 行
备份 ID - 生成该映像的备份的唯一标识符
策略 - 策略名(如果太长,则可能会被截断)
类型 - 日程表类型(FULL 等)
RL - 保留级别(从 0 到 100)
注意:
如果在 8.0 版本之前的 NetBackup 介质服务器上运行此命令,则输出内容仅会显示介于 0 到 24 之间的保留级别。
文件数 - 备份中的文件数
C - 压缩(Y 或 N)
E - 加密(Y 或 N)
T - 映像类型
R - 常规备份(预定或用户控制的备份)
P - 预导入的备份(已完成阶段 1)
I – 导入的备份
PC - 主副本 1 或 2。指定在还原时 NetBackup 所选择的备份副本。
失效 - 即将失效的第一个副本的截止日期,它出现在片段的“失效”字段(将在后文中介绍)中。
第 2_n+1 行
副本 - 该片段的副本号
片段 - 片段号或实际映像还原 (TIR) 片段的 IDX
KB - 以 KB 为单位的片段大小。该值不包括两个备份间的磁带头的大小。对于多路复用的备份,其片段大小可能是 0。
类型 - 介质类型(Rmed - 可移动介质,其他情况为磁盘);密度 - 生成备份的可移动介质的密度;Fnum - 文件号,该可移动介质上的第 n 个备份;主机 - 目录库中包含该映像的服务器;DWO - 写入的设备,将备份写入其中的设备。DWO 按介质管理器中的配置与驱动器索引匹配(仅适用于可移动介质)。
MPX - 指出该副本是否被多路复用的标志:Y 或 N(仅适用于片段号为 1 的情况)
失效 - 此副本的截止日期(仅适用于片段号为 1 的情况)
介质 ID - 介质 ID 或存储该映像的绝对路径
长显示格式的示例:
bpimmedia -L -policy regr1_gava -t FULL Backup-ID Policy Type RL Files C E T PC Expires Copy Frag KB Type Density FNum Host DWO MPX Expires MediaID ---------------------------------------------------------------- gava_0949949902 r1_guav FULL 3 25 N N R 1 12:58 03/09/2012 1 1 256 RMed dlt 13 0 plim 0 Y 12:58 03/09/2012 A00002
短显示格式 (-l)
如果 bpconfig 命令行包含 -l 或者不包含任何列表格式选项,则显示格式为短型,将产生简要列表。对于将列表重新编排成自定义的报告格式的脚本或程序,该选项很有用。-l 显示格式包含每个备份映像的多行条目。一个条目占用 n+1 行,其中 n 为映像的片段号。条目的布局是,第一行包含有关该映像的信息。第二行包含有关映像中每个片段的信息。属性按以下顺序显示,并以空格分隔。
-l 格式的字段如下所示:
字段 1 = 客户端。映像的客户端的名称。
字段 2 = 版本。客户端的 NetBackup 版本。
字段 3 = 映像关键字。备份映像的关键字。
字段 4 = 策略名称。创建该映像的策略的名称。
字段 5 = 策略类型。0 = 标准,4 = Oracle,8 = Sybase,9 = MS-SharePoint
字段 6 = 日程表 - 运行以创建备份的日程表名称。
字段 7 = 日程表类型。0 = 完全备份,1 = 差异增量式备份,2 = 用户控制的备份,3 = 用户控制的存档,4 = 累积增量式备份
字段 8 = 保留级别 (0-100)。
注意:
如果在 8.0 版本之前的 NetBackup 介质服务器上运行此命令,则输出内容仅会显示介于 0 到 24 之间的保留级别。
0 = 1 周,4mm 盒式磁带介质
1 = 2 周,8mm 盒式磁带介质
2 = 3 周,8mm2 盒式磁带介质
3 = 1 个月,8mm3 盒式磁带介质
4 = 2 个月,dlt 盒式磁带介质
5 = 3 个月,dlt2 盒式磁带介质
6 = 6 个月,dlt3 盒式磁带介质
7 = 9 个月,dtf 盒式磁带介质
8 = 1 年,1/2 英寸盒式磁带介质
9-100 = 无限期(25 除外,其设置为立即失效),1/2 英寸盒式磁带 2 介质
字段 9 = 映像中的文件数。
字段 10 = 映像的截止时间(自 1970 年 1 月 1 日以来的秒数)。值为零 (0) 表示映像正在处理或者已失败。
字段 11 = 压缩。0 = 使用压缩,1 = 不使用压缩
字段 12 = 加密。
字段 13 = 保留。0 = 映像不处于暂停状态,1 = 映像处于暂停状态
片段
字段 1 = 副本号
字段 2 = 片段号
字段 3 = 片段大小 (KB)
字段 7 = 文件号
字段 8 = 介质。用于存储映像的介质。
字段 9 = 映像的介质服务器。
字段 10 = 块大小 (KB)
字段 11 = 偏移
字段 12 = 创建片段的时间(自 1970 年 1 月 1 日以来的秒数)
字段 13 = 将映像写入其中的设备编号
字段 16 = 映像的截止时间(自 1970 年 1 月 1 日以来的秒数)。值为零 (0) 表示映像正在处理或者已失败。
字段 17 = 多路复用。0 = 未使用多路复用,1 = 已使用多路复用
字段 18 = 保留级别。
0 = 1 周,4mm 盒式磁带介质
1 = 2 周,8mm 盒式磁带介质
2 = 3 周,8mm2 盒式磁带介质
3 = 1 个月,8mm3 盒式磁带介质
4 = 2 个月,dlt 盒式磁带介质
5 = 3 个月,dlt2 盒式磁带介质
6 = 6 个月,dlt3 盒式磁带介质
7 = 9 个月,dtf 盒式磁带介质
8 = 1 年,1/2 英寸盒式磁带介质
9-100 = 无限期(25 除外,其设置为立即失效),1/2 英寸盒式磁带 2 介质
字段 20 = 保留。0 = 片段不处于暂停状态,1 = 片段处于暂停状态
短显示格式的示例:
# bpimmedia -l -policy regr1_gava -t FULL IMAGE gava 3 gava_0949949902 regr1_gava 0 full 0 3 25 952628302 0 0 FRAG 1 1 10256 512 2 13 13 A00002 plim 65536 0 949616279 0 0 *NULL* 952628302 1
“跨池”报告
跨池报告有两种格式:用户(-U 选项)和短型(默认值)。这两种格式均列出每个服务器的名称和池数据。对于共享跨越的备份映像的每个介质池,还会列出介质 ID。当命令行中包含 -mediaid 时,将仅显示与该介质 ID 有关的服务器池和磁盘池。
如果打算处理和使用 bpimmedia 的输出,建议使用 -l 选项。如果使用 -U 或 -L 选项,则可能会截断 bpimmedia 的输出中的“备份 ID”、“策略”和“主机”列。如果需要快速直观地查看介质上的 NetBackup 映像,可以使用 -U 或 -L 选项。
用户 (-U) 显示格式如下所示:
# bpimmedia -spanpools -U Related media pools containing spanned backup images, server plim: Pool: A00002 A00003 Pool: 400032
短显示格式如下所示:
# bpimmedia -spanpools SERVER plim POOL A00002 A00003 POOL 400032
示例
示例 1 - 列出策略 c_NDMP 的映像。此请求在 NetBackup 介质服务器上运行。将针对该介质服务器的主服务器 almond 上的映像目录库生成报告。
# bpimmedia -L -policy c_NDMP Backup-ID Policy Type RL Files C E T PC Expires Copy Frag KB Type Density FNum Off Host DWO MPX Expires MediaID ------------------------------------------------------------------------------------ t_0929653085 c_NDMP FULL 3 5909 N N R 1 15:58 07/18/2012 1 IDX 844 RMed dlt 2 0 almond 3 CB7514 1 1 9136 RMed dlt 1 0 almond 3 N 15:58 07/18/2012 CB7514
示例 2 - 显示还原特定文件所需的磁带。如果 bpimmedia 命令行提供了标识单个备份的条件,输出将显示曾用于该备份的介质。
在此处,命令行提供了客户端、备份日期以及日程表类型。输出显示服务器 plim
上的磁带 A00002 包含该备份。
# bpimmedia -L -client gava -d 2/7/2012 -t UBAK Backup-ID Policy Type RL Files C E T PC Expires Copy Frag KB Type Density FNum Off Host DWO MPX Expires MediaID ------------------------------------------------------------------------------------- gava_0949949686 regr1_guav UBAK 3 25 N N R 1 12:54 03/09/2011 1 1 10256 RMed dlt 11 0 plim 0 Y 12:54 03/09/2011 A00002
示例 3 - 以长格式列出主服务器 gava
上的映像目录库中的所有备份。
# bpimmedia -L -M gava Backup-ID Policy Type RL Files C E T PC Expires Copy Frag KB Type Density FNum Off Host DWO MPX Expires MediaID ------------------------------------------------------------------------------------- gava_0949599942 test-policy FULL 1 15 N N R 1 11:45 02/17/2011 1 1 224 Disk - - - gava - N 11:45 02/17/2011 /var/qatest/storage_unit//gava_0949599942_C1_F1
示例 4 - 以长格式列出介质 ID CB7514 上的备份。
# bpimmedia -L -mediaid CB7514 Backup-ID Policy Type RL Files C E T PC Expires Copy Frag KB Type Density FNum Off Host DWO MPX Expires MediaID -------------------------------------------------------------------------------------- toaster1_0929679294 tort_policy FULL 3 5898 N N R 1 23:14 07/18/2012 1 IDX 839 RMed dlt 4 0 almond 6 CB7514 1 1 27154 RMed dlt 3 0 almond 6 23:14 07/18/2012 CB7514 toaster1_0929653085 NDMP_policy FULL 3 5909 N N R 1 15:58 07/18/2012 1 IDX 844 RMed dlt 2 0 almond 3 CB7514 1 1 9136 RMed dlt 1 0 almond 3 15:58 07/18/2012 CB7514
返回值
零 (0) 退出状态表示已成功运行命令。
任何非零 (0) 的退出状态都表示发生了错误。
如果启用了管理日志记录,退出状态将记录在日志目录下的每日管理日志中:
UNIX 系统:/usr/openv/netbackup/logs/admin
Windows 系统:install_path\NetBackup\logs\admin
它具有下列形式:
bpimmedia: EXIT status = exit status
如果出错,将在显示该消息之前进行诊断。
文件
UNIX 系统:
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/images
Windows 系统:
install_path\NetBackup\logs\admin\* install_path\NetBackup\db\images