NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
- acsd
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- bpcleanrestore
- 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
- bpup
- bpverify
- cat_convert
- cat_export
- cat_import
- configureCerts
- configureMQ
- configureWebServerCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig reinitialize
- csconfig throttle
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- mklogdir
- msdpcldutil
- nbauditreport
- nbcallhomeproxyconfig
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcmdrun
- nbcomponentupdate
- nbcplogs
- nbcredkeyutil
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_restore
- nbdb_unload
- nbdb2adutl
- nbdbms_start_server
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbfindfile
- nbfirescan
- nbfp
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nboraadm
- nborair
- nbpem
- nbpemreq
- nbmariadb
- nbmlb
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbserviceusercmd
- nbsetconfig
- nbshvault
- nbsmartdiag
- nbsnapimport
- nbsnapreplicate
- nbsqladm
- nbsqlite
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- netbackup_deployment_insights
- resilient_clients
- restoretrace
- stopltid
- tldd
- tldcd
- 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
名称
bpimagelist — 生成有关 NetBackup 映像或可移动介质的状态报告
大纲
[-media] [-l | -L | -U | -idonly] [-tape] [-d date] [-e date] [-hoursago hours] [-keyword "keyword phrase"] [-client client_name] [-server server_name] [-backupid backup_id | -image_dtemode Off|On] [-option INCLUDE_PRE_IMPORT | INCLUDE_TIR | LIST_COMPLETE_COPIES | LIST_OLD_TO_NEW | ONLY_PRE_IMPORT | ONLY_TIR | INCLUDE_DELETE_PENDING] [-policy policy_name] [-pt policy_type] [-rl retention_level] [-sl sched_label] [-st sched_type] [-class_id class_guid] [-stl_complete] [-stl_incomplete] [-stl_name storage_lifecycle_name] [-M master_server,...] [-inter-domain] [-v] [-oracle_copilot_ir][-copy_dtemode Off|On] [-hierarchical_dtemode Off|On]
-changelog [-L | -json | -json_compact] [-min_changelog_keykey] [-d mm/dd/yyyy hh:mm:ss] [-e mm/dd/yyyy hh:mm:ss] [-new_images] [-updated_images] [-deleted_images]
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/
On Windows systems, the directory path to this command is install_path\NetBackup\bin\admincmd\
描述
bpimagelist 使用指定格式对目录库映像或与通过命令选项发送的属性相匹配的可移动介质进行报告。如果 -media 选项在命令行中，则 bpimagelist 将对可移动介质进行报告。否则，将对目录库映像进行报告。
bpimagelist -changelog 选项对映像更改日志中的记录进行报告。可以过滤仅对新映像、已更新映像或已删除映像的报告。
并将调试日志信息写入以下目录中：
On UNIX systems: /usr/openv/netbackup/logs/admin
On Windows systems: install_path\NetBackup\logs\admin
您可以将该目录中的信息用于故障排除。
bpimagelist 的输出将发送到标准输出中。
授权用户可以运行此命令。
有关 NetBackup 授权的详细信息，请参见《NetBackup 安全和加密指南》。
注意:
对于 NetBackup 加速器功能，bpimagelist 报告通过网络为每个备份传输的数据量。您还可以将该命令配置为在通常显示加速器备份映像大小的字段中显示已传输的数据。有关详细信息，请参见《NetBackup 管理指南，第 I 卷》、《NetBackup for VMware 管理指南》和《NetBackup NAS 管理指南》中的“加速器”主题。
选项
以下是 bpimagelist 选项：
- -backupid backup_id
指定用于查找适用映像的备份 ID（仅适用于映像列表）。
- -changelog
对映像更改日志中的记录进行报告。
- -class_id class_guid
指定要用来选择映像的类标识符。该标识符表示 GUID（全局唯一标识符）。bpimagelist 命令仅报告那些具有指定类标识符的映像。
- -client client_name
指定用于查找要列出的备份或存档的客户端名称。bpimagelist 搜索的客户端名称区分大小写。例如，bpimagelist 显示
client、cLiEnT和CLIENT中的映像。默认情况下，bpimagelist 搜索所有客户端。- -copy_dtemode Off|On
如果在创建此映像副本时启用了 DTE 模式，则副本 DTE 模式为 On。否则，该值为 Off。使用 bpimagelist -copy_dtemode Off|On 命令可根据副本 DTE 模式查看和过滤映像。
- -d mm/dd/yy hh:mm:ss, -e mm/dd/yy hh:mm:ss
指定列表的开始和结束日期范围。如果命令行上不包括这些值，则默认值如下所示：
-d 默认值是前一天午夜 12 点。
-e 默认值是当前日期和时间。
开始日期和结束日期的完整格式如下所示：
-d 指定列表的开始日期和时间。输出列表仅显示在指定日期和时间之后（包括在该日期和时间）生成的备份或存档中的映像（或 -changelog 选项的更改日志中的数据）。
-e 指定列表的结束日期和时间。输出列表仅显示在指定日期和时间之前（包括在该日期和时间）生成的备份或存档中的文件（或 -changelog 选项的更改日志中的数据）。所用的格式与开始日期格式相同。
有效的日期范围为 01/01/1970 00:00:00 到 01/19/2038 03:14:07。
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。
/usr/openv/msg/.conf文件 (UNIX) 和install_path\VERITAS\msg\LC.CONF文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。有关系统区域设置的更多信息，请参见《NetBackup 管理指南，第 II 卷》中的“关于指定 NetBackup 安装的区域设置”。
- -hierarchical_dtemode ON|OFF
如果在创建此映像副本及其层次中的所有父副本时启用了 DTE 模式，则副本层次模式为 ON。否则，该值为 off。使用 bpimagelist -hierarchical_dtemode Off|On 命令可根据副本层次 DTE 模式查看和过滤映像。
- -hoursago hours
包括在指定的小时数之前所写入的映像。该选项等效于将开始时间 (-d) 指定为当前时间减去 hours 值，该值必须大于或等于 1。
- -idonly
生成简化的列表。对于映像列表，它包含每个映像的创建时间、备份 ID 以及日程表类型。例如，如果列表条件是时段，则映像列表中包含以下内容：对于在该时段内创建的每个映像，仅包含该映像的创建时间、备份 ID 和日程表类型。
对于介质列表，仅包含适用的介质 ID。例如，如果列表条件是时段，则该列表仅包含在该时段中写入的介质 ID。
以下选项所代表的条件决定了为报告选择的映像或介质。在这些选项中关于映像的讨论，同样也适用于介质（如果是介质报告）。
- -image_dtemode Off|On
指定备份映像的 DTE 模式。使用 bpimagelist -image_dtemode Off|On 命令可根据 DTE 模式查看和过滤映像。
- -inter-domain
显示已从源同步复制的映像以及目标上处于暂停导入状态的同步复制映像的占位符副本。
- -json
以 json 格式打印数据并跨多行。
- -json_compact
在单独一行上以 json 格式打印数据。
- -keyword "keyword_phrase"
指定 NetBackup 在搜索时使用的关键字短语。该短语必须与以前已与该映像关联的短语匹配。例如，bpbackup 或 bparchive 命令的 -k 选项在创建映像后可将一个关键字与该映像关联。
- -L
在长模式下生成报告。例如，“介质列表”报告以一系列 attribute = value 对的形式列出每个介质 ID 的信息。密度值以描述性的词语和数字两种形式提供。长模式为默认情况。
- -l
短模式报告，会生成简要列表。对于将列表内容重新编排成自定义的报告格式的脚本或程序，该选项很有用。
有关 bpimagelist -l 命令输出的详细信息，请参见所示链接：
- -M master_server,...
指定由一个或多个备用主服务器组成的列表。这是一个以逗号分隔的主机名列表。如果包含该选项，则列表中的每台主服务器都会运行 bpimagelist 命令。如果任何主服务器发生错误，将在该主服务器位置处停止处理。
报告将由该列表中的全部主服务器所返回的信息组成。bpimagelist 查询其中的每台主服务器。主服务器返回来自映像目录库的映像或介质信息。每台主服务器都必须允许发出 bpimagelist 命令的系统对其进行访问。
默认为运行 bpimagelist 的系统的主服务器。
- -media
指定列表基于一组条件对可移动介质进行报告。如果命令行中没有 -media，则报告针对的是映像，而不是介质。
- -min_changelog_key key
打印具有指定日志密钥和较新日志密钥的记录。较新更改日志条目具有更大的更改日志密钥值。
- [-new_images] [-updated_images] [-deleted_images]
将更改日志报告限制为新、已更新或已删除映像。默认情况为报告所有更改日志映像。
- -option option_name,...
指定一个或多个用于查找要列出的映像的条件。option_name 为以下字符串之一（采用大写形式或小写形式）：
INCLUDE_PRE_IMPORT - 报告已完成第一阶段导入操作的映像。
INCLUDE_TIR - 报告由实际映像还原备份所创建的映像。
LIST_COMPLETE_COPIES - 不报告仍在处理的复制副本的片段。
LIST_OLD_TO_NEW - 按从最旧到最新的日期报告映像。
NO_VALIDATION - 即使因映像仍在处理中或作业失败导致未对映像进行验证，也要报告映像。
ONLY_PRE_IMPORT - 仅报告已完成第一阶段导入操作的映像。
ONLY_TIR - 仅报告由实际映像还原备份所创建的映像。
INCLUDE_DELETE_PENDING - 报告映像副本，包括从存储中成功删除后设置为失效的副本。
默认设置是不对选定的映像进行任何限制。
- -oracle_copilot_ir
搜索并显示可用于 Oracle Copilot 即时恢复的映像。
- -policy name
在指定策略中搜索要导入的备份。默认值为所有策略。
- -pt policy_type
指定策略类型。默认情况下，bpimagelist 将搜索所有策略类型。
policy_type 为以下字符串之一：
BigData DataStore DataTools-SQL-BackTrack DB2 Enterprise-Vault FlashBackup FlashBackup-Windows Hyper-V Informix-On-BAR LotusNotes MS-Exchange-Server MS-SharePoint MS-SQL-Server MS-Windows NDMP Oracle SAP Split-Mirror Standard Sybase Universal-share Vault VMware
- -rl retention_level
指定 retention_level。retention_level 是一个介于 0 到 100 之间的整数。默认情况下，bpimagelist 会搜索所有保留级别。
注意:
如果在 8.0 版本之前的 NetBackup 介质服务器上运行此命令，则只能指定介于 0 到 24 之间的保留级别。
- -server server_name
指定 NetBackup 服务器的名称或 ALL。如果 -server 指定了服务器名，则报告中仅包括位于该服务器上的映像和介质。此外，映像还满足 bpimagelist 所指定的其他条件。例如，如果指定了 -hoursago 2，则介质必须包含在过去两小时中创建的映像。
查询操作将访问位于本地主服务器上的映像目录库。主服务器必须允许运行 bpimagelist 的系统对其进行访问。
默认情况下，报告本地主服务器上映像目录库中的所有介质，这与指定 -server ALL 等效。
- -sl sched_label
指定选择映像时使用的日程表标签。默认值为所有日程表。
- -st sched_type
指定选择映像时使用的日程表类型。默认值为任意日程表类型。有效值包括：
FULL（完全备份）
INCR（差异增量式备份）
CINC（累积增量式备份）
UBAK（用户备份）
UARC（用户存档）
NOT_ARCHIVE（除用户存档之外的所有备份）
- -stl_complete
仅报告存储生命周期已完全处理的映像。此选项不能与 stl_incomplete 选项一起使用。
- -stl_incomplete
仅报告存储生命周期未完全处理的映像。此选项不能与 stl_complete 选项一起使用。
- -stl_name storage_lifecycle_name
指定要在选择映像时使用的存储生命周期的名称。仅选择那些具有指定的存储生命周期名称的映像。
- -tape
列表中仅显示至少有一个片段位于可移动介质或基于磁带的介质上的映像。这些映像中任何基于磁盘的片段将被忽略。如果映像在磁带上和磁盘上都有片段，则该选项仅显示基于磁带的片段。
- -U
在用户模式下生成报告。该报告具有一定的格式。它包括一个显示各列标题的标题行。而且状态是描述性的词语而不是数字。
- -v
选择详细模式。该选项可使 bpimagelist 记录供调试用的附加信息。这些信息记录在 NetBackup 每日管理调试日志中。该选项只有在启用了调试日志功能（即定义了以下目录）的情况下才有意义：
UNIX 系统：/usr/openv/netbackup/logs/admin
Windows 系统：install_path\NetBackup\logs\admin
示例
示例 1 - 显示对服务器可用的介质 ID 在指定的时间内最后一次写入备份映像的时间：
# bpimagelist -media -d 01/05/2012 18:00:46 -e 01/06/2012 23:59:59
-U
Media ID Last Written Server
-------- ---------------- ----------
IBM000 01/06/2012 01:06 hatt
AEK800 01/06/2012 03:01 hatt
C0015 01/06/2012 02:01 hatt
143191 01/05/2012 23:00 hatt 示例 2 - 列出今天写入的全部映像 - 未显示其他列：
bpimagelist -U Backed Up Expires Files KB C ICA Sched Type On Hold Policy Image DTE Mode ---------------- ---------- ----- --- - --- ----------- ------- ------- -------------- 01/03/2022 13:14 01/17/2022 3 416 N N Full Backup 0 test_fs Off 01/03/2022 13:13 01/17/2022 3 416 N N Full Backup 0 test_fs On
示例 3 - 列出今天写入的、存储生命周期尚未完全处理的所有映像：
# bpimagelist -U -stl_incomplete -idonly Time: 12/6/2011 1:03:46 PM ID: escape_1323198226 FULL (0) Time: 12/6/2011 12:48:22 PM ID: gordito19_1323197302 INCR (1) Time: 12/6/2011 1:02:42 PM ID: louisebl8vm1_1323198162 FULL (0) Time: 12/6/2011 1:03:28 PM ID: monterrey_1323198208 FULL (0) Time: 12/6/2011 1:03:10 PM ID: oprahbl14vm3_1323198190 FULL (0) Time: 12/6/2011 1:03:11 PM ID: oprahbl14vm4_1323198191 FULL (0) Time: 12/6/2011 1:03:12 PM ID: oprahbl15vm3_1323198192 FULL (0) Time: 12/6/2011 1:03:17 PM ID: oprahbl15vm4_1323198197 FULL (0) Time: 12/6/2011 1:02:22 PM ID: oprahbl8vm5_1323198142 FULL (0) Time: 12/6/2011 1:02:41 PM ID: thelmabl1vm1_1323198161 FULL (0) Time: 12/6/2011 1:02:54 PM ID: thelmabl1vm2_1323198174 FULL (0) Time: 12/6/2011 1:03:01 PM ID: thelmabl2vm1_1323198181 FULL (0)
示例 4 - 列出今天为 pem_tort 策略写入的所有未完成映像：
# bpimagelist -U -stl_incomplete -policy pem_tort Backed Up Expires Files KB C ICA Sched Type ... Policy ---------------- ---------- ----- ------- - --- ------------ --------- 12/06/2011 13:03 12/12/2011 86 1632 N Y Full Backup ... pem_tort 12/06/2011 13:02 12/12/2011 12 12512 N Y Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 5 32 N N Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 3742 95936 N Y Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 3762 95936 N Y Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 8 64 N N Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 9 32 N N Full Backup ... pem_tort 12/06/2011 13:02 12/12/2011 5041 223104 N Y Full Backup ... pem_tort 12/06/2011 13:02 12/12/2011 6 32 N N Full Backup ... pem_tort 12/06/2011 13:02 12/12/2011 3559 95808 N Y Full Backup ... pem_tort 12/06/2011 13:03 12/12/2011 5 32 N N Full Backup ... pem_tort
示例 5 - 列出自 2012 年 5 月 2 日以来输入的新更改日志条目和已更新更改日志条目：
# bpimagelist -changelog -new_images -updated_images -d 05/02/2012 10:18:00 -json Image Change Log Key: 2 Backup ID: jumpmanvm2_1335967123 Client Type: Standard (0) Image Change Log Oper. Id: Updated (2) Image Change Log Time: Wed 02 May 2012 10:39:09 AM CDT (1335973149)
文件
UNIX 系统：
/usr/openv/netbackup/logs/admin/log.mmddyy /usr/openv/netbackup/db/images
Windows 系统：
install_path\NetBackup\logs\admin\log.mmddyy install_path\NetBackup\db\images