Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
- acsd
- add_media_server_on_clients
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- bpclient
- bpclimagelist
- bpclntcmd
- bpclusterutil
- bpcompatd
- bpconfig
- bpdbjobs
- bpdbm
- bpdgclone
- bpdown
- bpduplicate
- bperror
- bpexpdate
- bpfis
- bpflist
- bpgetconfig
- bpgetdebuglog
- bpimage
- bpimagelist
- bpimmedia
- bpimport
- bpinst
- bpkeyfile
- bpkeyutil
- bplabel
- bplist
- bpmedia
- bpmedialist
- bpminlicense
- bpnbat
- bpnbaz
- bppficorr
- bpplcatdrinfo
- bpplclients
- bppldelete
- bpplinclude
- bpplinfo
- bppllist
- bpplsched
- bpplschedrep
- bpplschedwin
- bppolicynew
- bpps
- bprd
- bprecover
- bprestore
- bpretlevel
- bpschedule
- bpschedulerep
- bpsetconfig
- bpstsinfo
- bpstuadd
- bpstudel
- bpstulist
- bpsturep
- bptestbpcd
- bptestnetconn
- bptpcinfo
- bpup
- bpverify
- cat_convert
- cat_export
- cat_import
- configureCertsForPlugins
- configureMQ
- configurePorts
- configureWebServerCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig throttle
- csconfig reinitialize
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- manageClientCerts
- mklogdir
- nbauditreport
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcloudrestore
- nbcomponentupdate
- nbcplogs
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_restore
- nbdb_unload
- nbdbms_start_server
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbfindfile
- nbfirescan
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmsutil
- nboraadm
- nborair
- nbpem
- nbpemreq
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbregopsc
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbsetconfig
- nbsnapimport
- nbsnapreplicate
- nbsqladm
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- resilient_clients
- restoretrace
- stopltid
- tl4d
- tl8d
- tl8cd
- tldd
- tldcd
- tlhd
- tlhcd
- tlmd
- tpautoconf
- tpclean
- tpconfig
- tpext
- tpreq
- tpunmount
- verifytrace
- vltadm
- vltcontainers
- vlteject
- vltinject
- vltoffsitemedia
- vltopmenu
- vltrun
- vmadd
- vmchange
- vmcheckxxx
- vmd
- vmdelete
- vmoprcmd
- vmphyinv
- vmpool
- vmquery
- vmrule
- vmupdate
- vnetd
- vssat
- vwcp_manage
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
名称
bpmedialist — 显示 NetBackup 磁带介质状态
大纲
[-mlist] [-U | -l | -L] [-m media_id] [-rl ret_level] [-d density] [-p pool_name] [-json] [-h host_name | -M master_server,...] [-owner host_name | group_name] [-v]
-summary [-U | -L] [-brief] [-p pool_name] [-h host_name | -M master_server,...] [-owner host_name | group_name] [-v]
-mcontents -m media_id [-U | -l | -L] [-d density] [-h host_name | -M master_server,...] [-owner host_name | group_name] [-v] [-priority number]
-rt robot_type -rn robot_number [-d density] [-U | -l] [-h host_name | -M master_server] [-v]
在 UNIX 系统上，此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上，此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bpmedialist 查询一个或多个 NetBackup 介质目录库，并生成 NetBackup 介质状态报告。授权用户可以运行此命令。
有关 NetBackup 授权的详细信息，请参见《NetBackup 安全和加密指南》。
bpmedialist 生成下列三类报告之一：“介质列表”报告、“介质摘要”报告和“介质内容”报告。
“介质列表”报告
“介质列表”(-mlist) 报告提供 NetBackup 介质目录库中的单个卷或所有卷的相关信息。此报告不适用于磁盘存储单元。它针对报告中的每个卷列出介质 ID、介质服务器以及其他属性。这是默认的报告类型。
如果使用了 -U 选项（默认），则以英文文本显示状态字段。如果加上 -L 选项，则状态字段显示为一个十六进制整数。下面给出了对该数字的解释。可设置其中的任何一个标志或所有标志。未在下面列出的设置对应于未报告的状态。
>= 0x2000 介质包含一些加密映像。
>= 0x800 该磁带是 WORM（一次写入，多次读取）。
>= 0x400 用于备用服务器还原。
>= 0x200 多路复用为 TRUE。
>= 0x080 已导入为 TRUE。
>= 0x040 多个保留级别为 TRUE。
要确定低序状态数字所代表的意义，请将该数字依次与以下值相比较。
>= 0x008 状态为“已满”。
>= 0x004 这是未报告的状态。
>= 0x002 状态为“已暂停”。
== 0x001 状态为“已冻结”。
== 0x000 状态为“活动”。
报告的状态是低序数字状态与高序数字状态的组合。例如，对于状态值 0x040，介质 ID 是活动的，并且多个保留级别有效。
-l 选项生成短模式报告。每个介质 ID 只占报告中的一行。本说明稍后列出了这一行中的字段。
如果本节未提到以下任意字段，则该字段将留给 NetBackup 内部使用：
media id
partner id
version
density
time allocated
time last written
time of expiration
time last read
Kbytes
nimages
vimages（未失效的映像）
retention level
volume pool
number of restores
status（前面描述的）
hsize
ssize
l_offset
reserved
psize
reserved
四个保留字段
“介质内容”报告
“介质内容”报告列出从介质直接读取的介质内容。它列出单个介质 ID 上的备份 ID，而不列出各个文件。此报告不适用于磁盘存储单元。请注意，如果出现以下情况，存储单元在命令中断后的某段时间仍然可用：尝试通过输入 ctl-c 终止命令，而此时所请求的介质尚未装入或定位。当读取存储单元的该区域时，将显示报告中的每一条目。
“介质内容”报告的 -l 格式为每个备份 ID 生成一行，其中包含以下字段。
有关更多详细信息，请参见《NetBackup 管理指南，第 II 卷》中的“‘介质内容’报告”一节。
如果本节未提到以下任意字段，则该字段将留供 NetBackup 内部使用。
Version（1 表示数据库备份映像，2 表示常规备份映像）
Backup ID
Creation time
Expiration time
Retention level
Fragment number
File number
Block size（以字节为单位）
Status
media_id
Size
Reserved
data_start
Reserved
client_type *
copy_num *
sched_type *
Flags *
opt_extra
mpx_headers
res1
Policy name *
Schedule label *
* 仅当版本为 2 时，这些字段才有意义。
选项
报告类型选项
bpmedialist 生成四种报告类型中的一种。所生成的报告类型由命令行中的选项确定。报告类型选项如下：
- -mlist
生成“介质列表”报告（默认的报告类型）。
- -summary
生成“介质摘要”报告。
- -mcontents
生成“介质内容”报告。
bpmedialist 报告可以采用几种格式之一。报告格式选项如下所示：
- -brief
生成简短报告。该选项仅适用于“介质摘要”报告。默认为完整报告，其中包括活动介质和不活动介质的细目分类，并报告这些类别中每个介质 ID 的状态。
- -U
用户模式报告（默认的报告模式）。此报告包括一个显示列标题的标题行。而且报告样式是描述性的，而非概述性的。
- -L
长模式报告。此格式生成的报告包含最完整的信息。例如，“介质列表”报告以一系列的 keyword = value 对的形式列出每个介质 ID 的属性，每行列出一个属性。值既可以是数值，也可以是描述性的值。
- -l
短模式报告。此格式生成一种简要的报告。对于将列表内容重新编排成自定义的报告格式的脚本或程序，该选项很有用。
下面是 bpmedialist 使用的其他选项：
- -d density
报告此密度类型的介质。如果在命令行中指定了机械手类型，密度值应该与机械手类型一致。可用的密度类型包括：
4mm - 4 毫米盒式磁带
8mm - 8 毫米盒式磁带
dlt - DLT 盒式磁带
qscsi - 1/4 英寸盒式磁带
注意:
仅 NetBackup Enterprise Server 上支持以下密度。
dlt2 - DLT 盒式磁带 2
dlt3 - DLT 盒式磁带 3
dtf - DTF 盒式磁带
hcart - 1/2 英寸盒式磁带
hcart2 - 1/2 英寸盒式磁带 2
hcart3 - 1/2 英寸盒式磁带 3
- -h host_name
包含要报告介质的主机的名称。使用 -h 而不是 -M 收集失效介质的内容列表。
要从 NDMP 主机提取介质记录，请使用 NDMP 主机名，而不要使用 NetBackup for NDMP 服务器主机名。在与该主服务器域关联的 NDMP 存储单元或作为 NDMP 服务器类型的 EMM（或一个关联 EMM 别名）中定义 NCMP 主机名。
- -json
在单独一行上以
json（JavaScript 对象表示法）格式打印输出。- -m media_id
仅报告该介质 ID。对于“介质内容”报告，该选项是必需的。
对于“介质列表”报告，该选项是可选的。默认情况下，该报告中包括所有介质的 ID。介质 ID 可以为大写或小写形式。必须是 6 个或更少的字符，而且必须位于 NetBackup 介质目录库中（即从 NetBackup 卷池中分配）。
- -owner host_name | group_name
指定介质列表的所有者。所有者可以是主机或服务器组。
注意:
对于 NetBackup 服务器，由于只有一台服务器（主服务器），因此将该服务器的名称用作 host_name。
host_name 可以是某个主机名，也可以是字符串 ALL。如果 host_name 是主机名，查询将转到位于系统 host_name 上的介质目录库。对于 -mcontents 选项，该选项只能出现一次。对于 -mlist 和 -summary 选项，该选项可以出现多次。默认为可移动介质的存储单元集内的所有服务器。
系统 host_name 必须允许运行 bpmedialist 的系统对其进行访问。host_name 可以是除本地主服务器以外的任何其他主服务器的介质服务器。默认为本地群集的主服务器。
对于其他主服务器（非本地主服务器）的介质服务器，如果 bpmedialist 查询使用的是 -h the_media_server。而等效的 bpmedialist 查询使用的是 -M the_media_servers_master，则使用 -h 时 bpmedialist 查询会完成得更快。如果属于以下情况，响应时间可能明显不同：主服务器的 -M 地址为远程位置，介质服务器的 -h 地址为当地位置。
如果 host_name 是 ALL，则查询转到本地主服务器及其介质服务器。
group_name 指定服务器组的名称或字符串 ALL。如果 group_name 是服务器组的名称，则查询返回该服务器组拥有的介质。如果 group_name 是 ALL，则查询返回所有的服务器组拥有的介质。
- -M master_server,...
备用主服务器的列表。这是一个以逗号分隔的主机名列表。如果包含该选项，则列表中的每台主服务器都会运行 bpmedialist 命令。如果任何主服务器发生错误，报告过程将在该位置处停止。
报告将由该列表中的全部主服务器所返回的信息组成。bpmedialist 查询其中的每台主服务器。列表中的每台主服务器必须允许发出 bpmedialist 命令的系统对其进行访问。
仅对于 -mcontents（“介质内容”报告），主服务器才会返回介质目录库中的介质信息。这些介质信息包括主服务器及其介质服务器的介质信息（NetBackup 服务器除外，它不支持远程介质服务器）。例如，如果某个介质 ID 位于 -M 列表中某台主服务器的介质服务器上，则会发生以下情况：该主服务器从介质服务器检索介质信息，并将信息返回到运行 bpmedialist 的系统。在这种情况下，主服务器和介质服务器都必须允许发出 bpmedialist 命令的系统对其进行访问。
默认为运行 bpmedialist 的服务器的主服务器。
注意:
NetBackup 服务器只支持一台服务器，即主服务器，因此在这种情况下，默认服务器始终是运行 bpmedialist 的 NetBackup 服务器主服务器。
- -p pool_name
报告属于该卷池的介质 ID。默认为所有池。
- -priority number
为介质内容作业（用于“介质内容”报告）指定一个新的优先级 (number) 来覆盖默认作业优先级。
- -rl retention_level
报告使用此保留级别的介质。保留级别决定了备份和存档的保留期限。retention_level 是 0 到 100 之间的一个整数，默认级别为 1。
注意:
如果在 8.0 版本之前的 NetBackup 介质服务器上运行此命令，则输出内容仅会显示介于 0 到 24 之间的保留级别。
下面是保留级别以及相应保留期限的安装值。您所在的位置可能已经重新配置了与保留级别对应的保留期限。
0（一周）
1（2 周）
2（3 周）
3（1 个月）
4（2 个月）
5（3 个月）
6（6 个月）
7（9 个月）
8（1 年）
9-100（无限期，25 除外，其设置为立即失效）
- -rn robot_number
报告使用此机械手编号的机械手。可以从“介质和设备管理”中获取机械手编号。
有关此编号的使用规则，请参见《NetBackup 管理指南，第 II 卷》。
- -rt robot_type
报告该类型的机械手。如果使用非机械手（独立）设备，请选择 NONE。有效的机械手类型包括：：
TL4 - 4 毫米磁带库
TL8 - 8 毫米磁带库
TLD - DLT 磁带库
NONE - 非机械手
请注意，下面的机械手类型仅适用于 NetBackup Enterprise Server：
ACS - 自动盒式系统
TLH - 1/2 英寸磁带库
TLM - 多介质磁带库
- -v
选择详细模式。该选项可使 bpmedialist 记录供调试用的附加信息。这些信息记录在 NetBackup 每日管理调试日志中。该选项仅在 NetBackup 启用了调试日志记录功能（即定义了以下目录）的情况下才有意义：
For UNIX systems: /usr/openv/netbackup/logs/admin
For Windows systems: install_path\NetBackup\logs\admin
示例
示例 1 - 针对为本地系统的主服务器和介质服务器定义的所有介质 ID 生成介质报告。
注意:
由于 NetBackup 服务器不支持远程介质服务器，因此报告中只包含主服务器的介质 ID。
# bpmedialist
Server Host = hatt
id rl images allocated last updated density kbytes restores
vimages expiration last read <------- STATUS ------->
---------------------------------------------------------------------------
143191 0 28 12/03/2012 23:02 12/22/2012 23:00 dlt 736288 1
7 12/29/2012 23:00 12/09/2012 10:59
144280 0 9 11/25/2012 11:06 12/01/2012 23:03 dlt 290304 0
0 12/08/2012 23:03 N/A EXPIRED FROZEN
AEK800 0 22 12/06/2012 03:05 12/23/2012 03:01 dlt 23213184 0
7 12/30/2012 03:01 12/09/2012 10:48
C0015 0 28 11/26/2012 02:09 12/23/2012 02:01 dlt 896448 0
7 12/30/2012 02:01 N/A
IBM001 0 16 12/16/2012 01:01 12/23/2012 01:07 dlt 6447360 0
14 12/30/2012 01:07 N/A
L00103 0 20 12/07/2012 08:33 12/23/2012 01:07 dlt 7657728 0
9 12/30/2012 01:07 N/A
L00104 0 9 12/11/2012 01:09 12/21/2012 01:04 dlt 5429504 0
5 12/28/2012 01:04 N/A示例 2 - 生成介质 ID AEK802 的介质内容报告。下面列出了报告的一部分。
# bpmedialist -mcontents -m AEK802
media id = AEK802, allocated 01/08/2007 03:10, retention level = 0
File number 1
Backup id = hat_0915786605
Creation date = 01/08/2007 03:10
Expiration date = 01/15/2007 03:10
Retention level = 0
Copy number = 1
Fragment number = 2
Block size (in bytes) = 65536
File number 2
Backup id = hat_0915809009
Creation date = 01/08/2007 09:23
Expiration date = 01/15/2007 09:23
Retention level = 0
Copy number = 1
Fragment number = 1
Block size (in bytes) = 65536示例 3 - 为主服务器 hatt 和 duo 生成“介质列表”报告。bpmedialist 在主服务器 buff 上运行。
# bpmedialist -M hatt,duo
Server Host = hatt
id rl images allocated last updated density kbytes restores
vimages expiration last read <------- STATUS ------->
---------------------------------------------------------------------------
143191 0 51 12/03/2008 23:02 01/11/2009 23:04 dlt 1436686 2
9 01/18/2009 23:04 01/08/2009 10:26
144280 0 9 11/25/2008 11:06 12/01/2008 23:03 dlt 290304 0
0 12/08/2008 23:03 01/12/2009 16:10 EXPIRED FROZEN
AEK800 0 38 12/06/2008 03:05 01/08/2009 03:10 dlt 3922200024 0
3 01/15/2009 03:10 12/09/2008 10:48 FULL
AEK802 0 6 01/08/2009 03:10 01/12/2009 03:05 dlt 6140544 0
6 01/19/2009 03:05 01/12/2009 16:12
C0015 0 48 11/26/2008 02:09 01/12/2009 02:11 dlt 1531968 0
7 01/19/2009 02:11 N/A
IBM000 0 19 01/01/2009 01:09 01/12/2009 02:05 dlt 8284224 0
13 01/19/2009 02:05 01/09/2009 05:41
Server Host = duo
id rl images allocated last updated density kbytes restores
vimages expiration last read <------- STATUS ------->
---------------------------------------------------------------------------
A00004 0 0 11/16/2009 05:31 N/A 4mm 0 0
0 N/A N/A FROZEN
DLT210 1 5 12/09/2008 06:10 01/08/2009 06:04 dlt 2560 0
2 01/22/2009 06:04 N/A
DLT215 0 124 12/08/2008 14:57 01/12/2009 08:07 dlt 9788072 4
28 01/19/2009 08:07 12/31/2008 15:42示例 4 - 报告两个主机中的哪一个配置了给定的介质 ID。主机 hatt 未在其介质目录库中配置 A00004。因此，它将报告在 NetBackup 介质目录库或企业介质管理器数据库中未找到所请求的介质 ID。
主机 duo 确实配置了 A00004，所以它将生成 A00004 的“介质列表”报告（命令全部位于一行）。
# bpmedialist -mlist -h hatt -h duo -m A00004
requested media id was not found in NB media database and/or MM volume database
Server Host = duo
id rl images allocated last updated density kbytes restores
vimages expiration last read <------- STATUS ------->
---------------------------------------------------------------------------
A00004 0 0 11/16/2009 05:31 N/A 4mm 0 0
0 N/A N/A FROZEN文件
UNIX 系统：/usr/openv/netbackup/logs/admin/*
Windows 系统：install_path\NetBackup\logs\admin\*