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
- 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
- configurePorts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig throttle
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- manageClientCerts
- mklogdir
- nbauditreport
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- 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
- nbexecute
- nbfindfile
- nbfirescan
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbjm
- nbkmsutil
- nboraadm
- nborair
- nbpem
- nbpemreq
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbregopsc
- nbreplicate
- 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
- vwcp_manage
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
名称
bpflist — 列出 NetBackup 服务器上已备份和存档的文件
大纲
[-l | -L | -U ] [-v] [-M master_server,...] [-d mm/dd/yyyy hh:mm:ss] [-e mm/dd/yyyy hh:mm:ss] [-ut unixtime] [-bt unixtime] [-st sched_type] [-policy policy_name] [-client client_name] [-keyword keyword_phrase] [-pattern fullpath] [-pt policy_type] [-user name] [-group name] [-raw mode] [-backupid name] [-psep path_separator_character] [-malgo match_algorithm] [-rl recursion_level] [-option option ...]
在 UNIX 系统上，此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上，此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bpflist 命令可根据指定的选项来显示以前存档或备份的文件的列表。此命令只能用于 NetBackup 服务器并只能由授权用户运行。此命令类似于在所有 NetBackup 主机（包括客户端）中可用的 bplist 命令。
可以使用下列方法报告此列表：
- -l
在短模式中生成报告（这是默认情况）。对于将列表内容重新编排成自定义的报告格式的脚本或程序，该简明列表很有用。请参见“示例 1”。
- -L
在长模式下生成报告。
- -U
在用户模式下生成报告，每个结果有一个对应的文本标题。这些值以逗号分隔。请参见“示例 2”。
选项
- -backupid name
指定用于查找要列出的映像的备份 ID。
- -bt unixtime
将开始日期设置为指定的 UNIX 时间。-bt 选项是 –d 选项的替代选项。
- -client client_name
指定用于查找要列出的备份或存档的客户端名称。默认情况下，bpflist 使用运行此命令的主机的名称。
- -d mm/dd/yyyy hh:mm:ss -e mm/dd/yyyy hh:mm:ss
指定列表的开始和结束日期范围，如下所示：
-d 指定列表的开始日期和时间。输出列表仅显示自指定日期和时间（含）起生成的备份或存档中的文件。-d 默认值是前一天午夜 12 点。
-e 指定列表的结束日期和时间。输出列表仅显示在指定日期和时间之前（包括在该日期和时间）生成的备份或存档中的文件。-e 默认值是当前日期和时间。
开始日期和结束日期的格式相同。有效的日期范围为 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 安装的区域设置”。
- -group name
指定可以访问并列出文件的组。仅列出组可以访问的文件。仅当 –malgo 选项设置为 3 时该选项才会生效。
- -keyword "keyword_phrase"
指定 NetBackup 搜索备份或存档以列出文件时使用的关键字短语。该短语必须与已与使用 bpbackup -k 命令或 bparchive -k 命令创建的备份或存档关联的关键字短语匹配。可以使用该选项来代替其他选项，或者将该选项与其他选项结合使用，以便更轻松地选择备份和存档。
借助下面的元字符，可以匹配短语中的关键字或部分关键字：
* 匹配任何字符串。
? 匹配任何单个字符。
[ ] 匹配中括号内指定的字符序列。
[ - ] 匹配由连字符（“-”）分隔的字符的范围。
关键字短语的长度最多可达 128 个字符。允许使用所有可打印字符，包括空格和句点（“.”）。短语必须用双引号 ("...") 或单引号 ('...') 括起来。默认的关键字短语为空字符串。
- -M master_server,...
指定主机名的逗号分隔列表，该列表代表一个或多个备用主服务器。列表中的每个主服务器都运行 bpflist 命令。如果任何主服务器发生错误，进程将在出错时停止。报告中包含该列表中的全部主服务器返回的信息。bpflist 命令会查询每台主服务器。主服务器返回来自映像目录库的映像或介质信息。每台主服务器都必须允许发出 bpflist 命令的系统对其进行访问。默认为运行 bpflist 的系统的主服务器。
- -malgo match_algorithm
命名要列出的文件或目录。必须将指定的任何文件或目录列在结尾处，并位于所有其他选项之后。如果不指定路径，则默认为当前的工作目录。有效值如下所示：
0 (MA_DEFAULT)
1 (MA_AWBUS)
2 (MA_USE_GMATCH)
3 (MA_WITH_SECURITY)
- -option option ...
指定影响命令操作的空格分隔选项列表。option 的可能值如下所示：
NONE FILESYSTEM_ONLY GET_ALL_FILES GET_PRIMARY_COPY_NUM_BLOCKS (Return the number of blocks in the primary copy) IGNORE_CASE INCLUDE_BITMAP INCLUDE_EDI (Include EDI images) INCLUDE_EFI (Include EFI system partition images) INCLUDE_FSMAP INCLUDE_HIDDEN_IMAGES (Include hidden images) INCLUDE_RAW_INCR (Include raw incremental images) INCLUDE_TIR (Include True Image Restore images) NO_HSHAKE (Continue sending data even if the socket is not ready) ONE_CONNECT (Run multiple queries on a single connection) ONE_PASS (Return all files at once) ONLY_DIRS(Return only directories) ONLY_ENV_VARS (Return only NDMP environment variables) ONLY_FIRST_FRAGMENT ONLY_INPROGRESS_IMAGES (Return only in progress or unvalidated images) ONLY_SC_CLIENT_TYPES ONLY_TIR (Return only TIR images) ONLY_VM_FILES (Return only virtual machine images) STR2FILE_ENTRY_FORMAT- -pattern fullpath
仅列出与指定模式匹配的文件。
- -policy policy_name
命名要搜索的策略以生成列表。如果不指定该选项，则搜索所有策略。
- -psep path_separator_character
指定路径分隔符字符。
- -pt policy_type
指定策略类型。默认情况下，bpflist 将搜索所有策略类型。policy_type 为以下字符串之一：
Auspex-FastBackup 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 PureDisk-Export SAP Split-Mirror Standard Sybase Vault VMware
- -raw mode
指定原始的分区模式。
- -rl recursion_level
以递归方式列出遇到的子目录，直至深度为指定的深度。
- -st schedule_type
对于将更改其主副本的选定备份映像，指定日程表类型。默认情况下，bpchangeprimary 可使用任何日程表类型。有效值包括：
FULL（完全备份）
INCR（差异增量式备份）
CINC（累积增量式备份）
UBAK（用户备份）
UARC（用户存档）
NOT_ARCHIVE（除用户存档之外的所有备份）
SCHED（FULL、INCR、CINC、TLOG）
USER（UBAK 和 UARC）
TLOG（事务日志）
ANY（之前任何一种类型）
- -user name
指定可以访问并列出文件的用户。仅列出用户可以访问的文件。仅当 –malgo 选项设置为 3 时该选项才会生效。
- -ut unixtime
指定 –d 和 –e 选项的替代选项，并将开始日期和结束日期设置为指定的 UNIX 时间。使用此选项指定要列出的单个备份或存档。
- -v
在详细模式下生成报告并在控制台上显示日志消息。
示例
示例 1 - 在 UNIX 系统中，搜索自 unix 时间 1380000000 之后的备份中的路径 /images。此列表为短模式（默认情况）。
# bpflist -client cl2 -bt 1380000000 -rl 0 -pt Standard -pattern /images FILES 10 0 0 1383577314 0 cl2 test cl2_1383577314 - *NULL* 1 0 unknown unknown 0 0 *NULL* 1 0 19 50 8 1 0 0 2051 /images/ 16877 root root 0 1383334897 1382366087 1383559354 FILES 10 0 0 1383334895 0 cl2 test cl2_1383334895 - *NULL* 1 0 unknown unknown 0 0 *NULL* 1 0 19 50 8 1 0 0 2051 /images/ 16877 root root 0 1383331790 1382366087 1383296672 FILES 10 0 0 1383331752 0 cl2 test cl2_1383331752 - *NULL* 1 0 unknown unknown 0 0 *NULL* 355 0 19 50 1708556 1 0 0 2051 /images/ 16877 root root 0 1382647177 1382366087 1383296672
示例 2 - 以用户 (-U) 模式显示列表。
# bpflist -client cl2 -bt 1380000000 -rl 0 -pt Standard -pattern /images -U Client: cl2 Policy: test Backup ID: cl2_1383577314 Backed up: Mon 04 Nov 2013 09:01:54 AM CS (1383577314) Software Version: ? Policy Type: Standard Schedule Type: FULL Version: 10 Keyword: ? Num Files: 1 Files: FN=1 L=0 PL=19 DL=50 BK=8 II=1 RS=0 GB=0 DN=2051 P=/images/ D=16877 root root 0 1383334897 1382366087 1383559354 Client: cl2 Policy: test Backup ID: cl2_1383334895 Backed up: Fri 01 Nov 2013 02:41:35 PM CD (1383334895) Software Version: ? Policy Type: Standard Schedule Type: FULL Version: 10 Keyword: ? Num Files: 1 Files: FN=1 L=0 PL=19 DL=50 BK=8 II=1 RS=0 GB=0 DN=2051 P=/images/ D=16877 root root 0 1383331790 1382366087 1383296672
另请参见
请参见bparchive(1)。