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
- configureCerts
- 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
- 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
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nboraadm
- nborair
- nbpem
- nbpemreq
- nbmlb
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbregopsc
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbsetconfig
- nbsnapimport
- nbsnapreplicate
- nbsqladm
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- 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
- 索引
名称
bplist — 列出 NetBackup 主机上已备份和存档的文件
大纲
[-A | -B] [-C client] [-S master_server] [-k policy] [-t policy_type] [-F] [-R [n]] [-b | -c | -u] [-l] [-r] [-flops options] [-Listseconds] [-T] [-Translateownership] [-unix_files] [-nt_files] [-s date] [-e date] [-I] [-PI] [-keyword keyword_phrase] [filename] [-Listpolicy] [-nboptimized | -nbnormal]
在 UNIX 系统上，此命令的目录路径为 /usr/openv/netbackup/bin/
在 Windows 系统上，此命令的目录路径为 install_path\NetBackup\bin\
描述
bplist 命令可根据指定的选项来显示以前存档或备份的文件的列表。您可以选择文件或目录以及希望该列表涵盖的时间段。可以递归地显示到目录的指定深度。bplist 仅显示您有读访问权限的文件。只有在管理员帐户执行用户备份时，该命令才列出文件。
您还必须对文件路径中的所有目录拥有所有权或读取权限。您可以列出由另一客户端备份或存档的文件（仅当 NetBackup 管理员证实您有权这样做时）。
如果您创建了具有公用写权限的下列目录，则 bplist 在该目录中创建可用于故障排除的调试日志文件。
UNIX 系统：usr/openv/netbackup/logs/bplist/
Windows 系统：install_path\NetBackup\logs\bplist\
选项
- -A | -B
指定生成存档列表 (-A) 还是备份列表 (-B)。默认值为 -B。
- -b | -c | -u
指定使用 -l 选项打印时的备用日期和时间：
-b 显示每个文件的备份日期和时间。
-c 显示上次修改每个文件的索引节点的日期和时间（UNIX 系统），或每个文件的创建日期和时间（Windows 系统）。
-u 显示上次访问每个文件的日期和时间。
默认为显示每个文件的上次修改时间。
- -C client
指定用于查找要列出的备份或存档的客户端名称。该名称必须与它在 NetBackup 配置中显示的名称相同。其默认值是当前客户端的名称。
- -F
指定在列表输出中，符号链接（仅适用于 UNIX 客户端）以 @ 结尾，而可执行文件以 * 结尾。
- filename
命名要列出的文件或目录。必须将指定的任何文件或目录列在结尾处，并位于所有其他选项之后。如果不指定路径，则默认为当前的工作目录。
对于 Windows 系统，驱动器盘符使用大写字母。例如：
C:\NetBackup\log1
对于目录，如果不使用 -R 选项，则应包括结尾路径分隔符，如下例所示：
UNIX 系统：
bplist -l "/home/user1/*"Windows 系统：
bplist -l "D:\WS_FTP.LOG\*"如果使用星号元字符 (*)，则应将文件名放在双引号内，以确保命令正常运行。
- -flops options
列出 NetBackup 文件。
- -I
指定不区分大小写的搜索。在比较名称时不考虑大小写（例如，Cat 与 cat 匹配）。
- -k policy
命名要搜索的策略以生成列表。如果不指定该选项，则搜索所有策略。
- -keyword keyword_phrase
指定 NetBackup 在搜索用来还原文件的备份或存档时使用的关键字短语。该短语必须与已与备份或存档关联的关键字短语匹配，该备份或存档使用 bpbackup 或 bparchive 的 -k 选项创建。
可以使用该选项来代替其他还原选项，或者将该选项与其他还原选项结合使用，以便更轻松地还原备份和存档。借助下面的元字符，可以匹配短语中的关键字或部分关键字：
* 匹配任何字符串。
? 匹配任何单个字符。
[ ] 匹配中括号内指定的字符序列中的一个字符。
[ - ] 匹配由 - 分隔的字符范围中的一个字符。
关键字短语的长度最多可达 128 个字符。允许使用所有可打印字符，包括空格 ( ) 和句号 (.)。
短语必须用双引号 ("...") 或单引号 ('...') 括起来。
默认的关键字短语为空字符串。
注意:
使用以下策略类型时，将忽略关键字短语：DB2、Informix-On-BAR、Oracle、SAP、MS-SQL-Server 和 Sybase。
- -l
在 Windows 系统上，-l 显示文件详细信息。
在 UNIX 系统上，-l 以长格式列出以下文件详细信息：每个文件的模式、所有者、组、大小（以字节为单位）以及上次修改的时间（参见“示例”部分）。该列表使用 10 个字符来显示每个文件的模式，这些字符代表了标准的 UNIX 文件权限。第一个字符是以下字符之一：
d（指定目录）
l（指定链接）
m（指定由 Veritas Storage Migrator for UNIX 或 Veritas 数据生命周期管理器迁移的文件）
-（指定文件）
接下来的 9 个字符显示了三组权限。第一组显示所有者的权限，下一组显示用户组权限，而最后一组显示所有其他用户的权限。三组中的每一组都按如下所示指定了读、写和执行权限：
r 表示文件可读
w 表示文件可写
x 表示文件可执行
- 表示未授予所指出的权限
- -Listpolicy
在命令输出中包含日程表类型和策略名。
- -Listseconds
指定使用 -l 选项时用于时间戳的秒粒度。
- -nboptimized
指定命令过滤输出，以便仅显示使用针对 Windows 重复数据删除优化的标志所备份的 Windows 映像。
- -nbnormal
指定命令过滤输出，以便仅显示未使用针对 Windows 重复数据删除优化的标志所备份的 Windows 映像。
- -nt_files
以 Windows 格式列出文件和目录。此选项仅适用于 Windows。例如：
C:\users\test- -PI
指定与路径无关的搜索，这意味着 NetBackup 在查找指定的文件或目录时不考虑路径。例如，名为 test 的文件位于以下三个目录中。对 test 的搜索将查找该文件的所有三个实例：
UNIX 系统：
/tmp/junk/test /abc/123/xxx/test /abc/123/xxx/yyy/zzz/test
Windows 系统：
\tmp\junk\test \abc\123\xxx\test \abc\123\xxx\yyy\zzz\test
- -r
在 Windows 系统上，-r 列出备份的磁盘映像。默认为列出文件系统。
在 UNIX 系统上，-r 列出备份的原始分区。默认为列出文件系统。
- -R [n]
以递归方式列出遇到的子目录，直至深度为 n。n 的默认值是 999。
- -s date, -e date
指定列表的开始日期 (-s) 和结束日期 (-e)。
s 指定列表的开始日期和时间。生成的列表仅显示在指定日期和时间之后（包括此时间）生成的备份或存档中的文件。
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。默认值是当前日期减去 6 个月。
-e 指定列表的结束日期和时间。生成的列表仅显示在指定日期和时间之前（包括此时间）生成的备份或存档中的文件。其格式与开始日期和时间的格式相同。默认值是当前的日期和时间。
- -S master_server
UNIX 系统：-s 指定 NetBackup 服务器的名称。默认值是在 /usr/openv/netbackup/bp.conf 文件中找到的第一个
SERVER条目。Windows 系统：-s 指定 NetBackup 服务器的名称。默认为在“指定 NetBackup 计算机”对话框的“服务器”选项卡上被指定为当前服务器的服务器。若要显示此对话框，请在客户端上启动“备份、存档和还原”用户界面。然后在“文件”菜单上单击“指定 NetBackup 计算机”。
- -t policy_type
指定与策略类型相对应的以下编号之一。Windows 客户端的默认编号是 13，所有其他客户端的默认编号都是 0。
0 = Standard
4 = Oracle
6 = Informix-On-BAR
7 = Sybase
8 = MS-SharePoint
11 = DataTools-SQL-BackTrack
13 = MS-Windows
15 = MS-SQL-Server
16 = MS-Exchange-Server
17 = SAP
18 = DB2
19 = NDMP
20 = FlashBackup
21 = Split-Mirror
25 = Lotus Notes
29 = FlashBackup-Windows
35 = NBU-Catalog
39 = Enterprise-Vault
40 = VMware
41 = Hyper-V
44= BigData
- -T
列出实际映像备份中的目录。默认为列出非实际映像备份。
注意:
即使合成完全备份中使用了 TIR 信息，也不会显示这些信息。
- -Translateownership
仅限用于 Linux VMware 备份的 Linux 系统：将拥有这些文件的个人的用户 ID (UID) 和组 ID (GID) 转换为用户名和组名。默认情况下，Linux VMware 备份的 bplist 显示 UID 和 GID。
运行 bplist 命令和 -Translateownership 选项的客户端必须与使用 -C 选项指定的客户端相同。
在除 Linux 之外的操作系统上，此选项不起作用。
- -unix_files
以 UNIX 格式列出文件和目录。此选项仅适用于 UNIX。例如：
/C/users/test
示例
示例 1 - 以长格式递归列出 /home/user1 (UNIX) 或 D:\WS_RTP.LOG (Windows) 中备份的文件。
在 UNIX 系统上：
# bplist -l -R /home/usr1 lrwxrwxrwx usr1;usr@ eng;None 0 Apr 28 12:25 /home/usr1/dirlink drwxr-xr-x usr1;usr@ eng;None 0 Apr 04 07:48 /home/usr1/testdir drwxr-x--- usr1;usr@ eng;None 0 Apr 04 07:49 /home/usr1/dir -rwxr----- usr1;usr@ eng;None 1002 Apr 02 09:59 /home/usr1/dir/file lrwxrwxrwx usr1;usr@ eng;None 0 Apr 04 07:49 /home/usr1/dir/link
在 Windows 系统上：
# bplist -l -R D:\WS_FTP.LOG -rwx------ bjm;usr@ bjm;None 64 Oct 10 2012 D:\WS_FTP.LOG -rwx------ bjm;usr@ bjm;None 64 Oct 10 2012 D:\WS_FTP.LOG -rwx------ bjm;usr@ bjm;None 64 Oct 10 2012 D:\WS_FTP.LOG
示例 2 - 列出已备份且同关键字短语 "MyHomeDirectory" 的部分或全部相关联的文件。
UNIX：# bplist -keyword "*MyHomeDirectory*" -l /home/kwc/
Windows：# bplist -keyword "*MyHomeDirectory*" -l C:\home\kwc\
示例 3 - 列出已存档且同关键字短语 "MyHomeDirectory" 的部分或全部相关联的文件。
UNIX：# bplist -A -keyword "*MyHomeDirectory*" -l /home/kwc/
Windows：# bplist -A -keyword "*MyHomeDirectory*" -l C:\home\kwc\
示例 4 - 在 Windows 客户端上以递归形式详细列出在 Windows 主服务器上执行的 bplist 的输出。输入下列命令，列出已在 Windows 客户端 slater 的驱动器 D 上备份且与关键字短语 Win NT: 的部分或全部相关联的文件。
# bplist -keyword "*Win NT*" -C slater -R -l C:\client_data_2 drwx------ root;usr@ root;None 0 Aug 28 17 C:\client_data_2\ -rwx------ root;usr@ root;None 40 Aug 05 24 C:\client_data_2\ewr.txt drwx------ root;usr@ root;None 0 Aug 28 17 C:\client_data_2\ -rwx------ root;usr@ root;None 40 Aug 05 24 C:\client_data_2\ewr.txt
Windows 映像的用户列 (root;usr@) 显示备份文件的用户和 owner@domain，这两者之间用分号分隔。Windows 映像的组列 (root;None) 为备份文件的组和 group@domain，这两者之间用分号分隔。
示例 5 - 列出 Linux VMware 备份中的文件并将 UID 和 GID 转换为用户名和组名：
# bplist -Translateownership -S host0.example.com -C client0.example.com -R 1 -l -t 40 -E -unix_files -b /user1_home drwxr-xr-x user1 grp 0 Sep 09 10:39 /user1_home/ drwxr-xr-x user1 grp 0 Sep 09 10:39 /user1_home/user_data/ drwxr-xr-x root root 0 Sep 09 10:39 /user1_home/root_data/ drwxr-xrwx root root 0 Sep 09 10:39 /user1_home/root_data_write/ drwxr-xr-x root root 0 Sep 09 10:39 /user1_home/root_data.orig/ drwxr-xr-x user1 grp 0 Sep 09 10:39 /user1_home/444.txt/
文件
UNIX 系统：/usr/openv/netbackup/logs/bplist/log.mmddyy
Windows 系统：install_path\NetBackup\logs\bplist\*.log