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
名称
bperror — 显示 NetBackup 状态和故障排除信息或 NetBackup 错误目录库中的条目
大纲
{-S | -statuscode status_code} [-r | -recommendation] [[-p Unx | NTx] | [-platform Unx | NTx]] [-v]
[-all | -problems | -media | tape] {-backstat [-by_statcode]} [-L | -l | -U] [-columns ncols] [-d date | -hoursago hours] [-e date] [-client client_name] [-server server_name] [-jobid job_id] [-M master_server,...] [-v]
[-s {severity[+]}|severity ...] [-t type ...] [-dt disk_type] [-L | -l | -U] [-columns ncols] [-d date | -hoursago hours] [-e date] [-client client_name] [-server server_name] [-jobid job_id] [-M master_server,...] [-v]
在 UNIX 系统上，此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上，此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bperror 显示与联机故障排除工具（在活动监视器或“报告”应用程序中）同源的信息，或者显示来自 NetBackup 错误目录库的信息。bperror 提供下面的显示类型：
显示对应于某个状态码的消息以及如何排除故障的建议（可选）。此时，显示结果与本地系统的联机故障排除工具的来源相同。
显示满足命令行选项的错误目录库条目。例如，bperror 可以显示前一天的所有问题条目。
显示对应于特定消息严重性和消息类型的错误目录库条目。
有关上述显示类型的更多信息，请参见命令描述后面的“显示格式”部分。
bperror 将其调试日志信息写入以下目录中：
在 Windows 系统上：install_path\NetBackup\logs\admin
在 UNIX 系统上：/usr/openv/netbackup/logs/admin
您可以将该目录中的信息用于故障排除。
bperror 的输出将发送到标准输出中。
选项
- -all, -backstat [-by_statcode], -media, -problems
这些选项用于指定要显示的日志消息的类型和严重性。默认的类型是 ALL。默认的严重性也是 ALL。
-all：类型是 ALL，严重性也是 ALL。如果在运行 bperror 时带有该选项以及 -U，将生成“所有日志条目”报告。
-backstat：类型是 BACKSTAT，而严重性是 ALL。如果包含 -by_statcode，则为每个唯一的状态码分别显示一个条目。这种条目的第一行包含状态码和相应的消息文本。第二行包含出现此状态码的客户端的列表。仅当命令行同时包含 -backstat 和 -U 时，-by_statcode 才有效。如果在运行 bperror 时带有该选项以及 -U，将生成“备份状态”报告。
-media：类型是 MEDIADEV，而严重性是 ALL。如果在运行 bperror 时带有该选项以及 -U，将生成“介质日志”报告。
-problems：类型是 ALL，而严重性包括 WARNING、ERROR 以及 CRITICAL 三种。如果在运行 bperror 时带有该选项以及 -U，将生成“问题”报告。
- -client client_name
指定 NetBackup 客户端的名称。该名称必须与它在 NetBackup 目录库中显示的名称相同。默认情况下，bperror 搜索所有客户端。
- -columns ncols
对于 -L 和 -U 报告，-columns 将为最大行长度提供一个大概的上限。bperror 并不尝试生成长度恰好为 ncols 个字符的行。
-columns 不适用于 -l 报告。
ncols 至少必须为 40。默认值为 80。
- -d date, -e date
指定列表的开始和结束日期范围。
-d 指定列表的开始日期和时间（可选）。结果列表仅显示在指定日期和时间之后（包括此时间）生成的备份或存档中的映像。日期的有效范围为从 01/01/1970 00:00:00 到 01/19/2038 03:14:07。默认值是从当前日期和时间起的前 24 小时。
-e 指定列表的结束日期和时间（可选）。结果列表仅显示在指定日期和时间之前（包括此时间）生成的备份或存档中的文件。所用的格式与开始日期格式相同。默认值是当前的日期和时间。结束日期必须大于或等于开始日期。
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。
/usr/openv/msg/.conf文件 (UNIX) 和install_path\VERITAS\msg\LC.CONF文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。有关系统区域设置的更多信息，请参见《NetBackup 管理指南，第 II 卷》中的“关于指定 NetBackup 安装的区域设置”。
以下是 -d 和 -e 选项的典型格式：
[-d mm/dd/yyyy hh:mm:ss | -hoursago hours] [-e mm/dd/yyyy hh:mm:ss]
- -dt disk_type
允许用户指定磁盘类型。下面是 disk_type 的有效值：
0 - All
1 - BasicDisk
3 - SnapVault
6 - DiskPool
- -hoursago hours
指定开始时间为若干小时之前，这相当于将开始时间 (-d) 指定为当前时间减去 hours 值。hours 的值为整数。默认值为 24，表示开始时间比当前时间早 24 小时。
- -jobid job_id
指定 NetBackup 作业 ID。默认情况下，bperror 搜索所有的作业 ID。
- -L
长格式报告。
- -l
短格式报告。此选项将生成一个简明列表。对于将列表内容重新编排成自定义的报告格式的脚本或程序，该选项很有用。此选项是默认的列表类型。
- -M master_server,...
指定一个用逗号分隔的主机名列表，其中包括一个或多个主机名。该命令将运行于此列表中的每台主服务器。主服务器必须允许发出该命令的系统对其进行访问。如果任何主服务器发生错误，将在列表中的该主服务器位置处停止处理。默认为输入该命令的系统的主服务器。
- -p Unx | NTx, -platform Unx | NTx
显示适用于指定状态码的平台（UNIX 或 Windows）的消息。默认情况下，将显示运行 bperror 的平台的消息。使用该选项时，必须指定 -S 或 -statuscode 选项。
- -r | -recommendation
显示针对《NetBackup 状态码参考指南》中的指定状态码推荐的操作。默认为不显示推荐操作。使用该选项时，必须指定 -S 或 -statuscode 选项。
- -S status_code, -statuscode status_code
显示对应于状态码的消息。此选项没有默认情况。
- -s severity, -s severity+
指定要显示的日志消息的严重性。定义的值有 ALL、DEBUG、INFO、WARNING、ERROR 以及 CRITICAL。
可以用两种方法指定严重性。第一种方法是使用包含一个或多个严重性值的列表。例如，-s INFO ERROR 可显示严重性为 INFO 或 ERROR 的消息。在列表中，元素之间的分隔符必须为空格 ( )。第二种方法是使用附加有 + 的单个严重性值，表示不低于该值的严重性。例如，-s WARNING+ 可显示严重性为 WARNING、ERROR 以及 CRITICAL 的消息。
默认值为 ALL。严重性值可以为大写或小写形式。
- -server server_name
指定 NetBackup 服务器的名称。该名称必须与它在 NetBackup 目录库中显示的名称相同。仅限于显示为该服务器记录的消息，这些消息同时还满足任何其他 bperror 选项的条件。例如，如果 bperror 包含 -server plim 和 -hoursago 2 选项，则显示前两个小时内为
plim记录的消息。该服务器名称必须与在日志消息中记录的服务器名称相匹配。例如，如果日志中记录的服务器名称为 plim.null.com，则 -server plim 不会显示日志，而 -server plim.null.com 会显示。
将对位于本地主服务器或由 -M 指定的主服务器上的错误目录库进行查询。主服务器必须允许运行 bperror 的系统对其进行访问。
默认为显示主服务器已知的所有介质服务器的日志消息。
- -t type
指定要显示的日志消息类型。定义的值有 ALL、BACKSTAT、MEDIADEV、GENERAL、BACKUP、ARCHIVE、RETRIEVE 和 SECURITY。默认值为 ALL。类型值可以为大写或小写形式。以一个或多个值的列表形式输入类型值。例如，-t BACKSTAT MEDIADEV 可显示 BACKSTAT 类型或 MEDIADEV 类型的消息。在列表中，元素之间的分隔符必须为空格 ( )。
- -U
用户格式的报告。这是由 NetBackup 报告生成工具（如 NetBackup-Java 报告应用程序）使用的报告格式。
- -v
详细模式。此选项可使 bperror 记录 NetBackup 每日管理调试日志中记录的供调试用的附加信息。只有在 NetBackup 启用了调试日志（即定义了 install_path\NetBackup\logs\admin/usr/openv/netbackup/logs/admin 目录）的情况下，-v 才有意义。默认为不使用详细模式。
显示格式
以下是 bperror 命令的显示格式：
显示状态码（如 bperror -S status_code）：
bperror 可向本地系统上的 NetBackup 联机故障排除工具查询对应于状态码的消息。bperror 将在一行中显示消息文本，而在下一行中显示解释。
如果包含 -r 选项，则 bperror 还会查询对应于状态码的故障排除建议。bperror 在状态消息后面显示该建议（包含一行或多行）。
显示错误目录库（如 bperror -all；bperror -s severity）：
bperror 可查询本地主服务器或 -M 选项列表中的主服务器上的 NetBackup 错误目录库。显示内容包含查询主服务器上的错误目录库后返回的结果。这些结果仅限于满足所有 bperror 选项的目录库条目。例如，bperror 命令行可能包含客户端、开始时间和结束时间的选项。如果是这样，则 bperror 仅报告在开始时间和结束时间之间为指定客户端运行的作业。
显示错误目录库中个别消息条目的显示变量可以使用长格式 (-L)、用户格式 (-U) 或短格式 (-l) 来显示结果。按状态码分类的显示变量只能以用户格式 (-U) 来显示结果。以下是每种格式的显示内容：
错误目录库显示内容、个别消息条目、长格式（如 bperror -media -L）。该报告可针对每个日志条目生成若干行，内容如下：
字段 1：日期和时间 - 自 1970 年 1 月 1 日以来的秒数
字段 2：NetBackup 版本 - 正在使用的 NetBackup 版本
字段 3：错误类型 - 错误的介质数字标识符
字段 4：日志条目类型 - 2 = 调试、4 = 信息、8 = 警告、16 = 错误、32 = 严重
字段 5：服务器 - 服务器名称
字段 6：作业 ID
字段 7：组作业 ID
字段 8：未使用
字段 9：NetBackup 进程 - 执行日志记录的 NetBackup 进程的名称
字段 10：客户端名称
字段 11：策略名称
字段 12：日程表类型 - 正在为备份运行的日程表类型
0 = FULL，1 = INCR，2 = CINC，3 = UBAK，4 = UARC
字段 13：退出状态 - 备份完成后的状态
错误目录库显示内容、个别消息条目、用户格式（如 bperror -media -U）。用户格式首先生成用于显示列名称的标头行，然后为每个日志条目生成一行或多行。其内容如下：
第 1 行：日期和时间
服务器
客户端
文本（日志消息的开始部分，如果需要，可以在随后的行中继续）
错误目录库显示内容、个别消息条目、短格式（如 bperror -media -l）。短格式为每个日志条目生成一行，其内容如下：
第 1 行：时间（内部系统表示方法）
NetBackup 版本
类型代码（十进制）
严重性代码（十进制）
服务器
作业 ID
作业组 ID
未使用的字段
客户端
主体
文本（整个日志消息文本，不按行长度截断）
按状态码分类的错误目录库显示内容。该显示内容仅报告每个唯一的状态码，而不列出该状态码的每个日志条目（如 bperror -backstat -by_statcode -U）。此选项为每个状态码生成两行或多行，其内容如下：
第 1 行：状态码
文本（日志消息文本的开始部分，如有必要，可以在随后的行中继续）
第 2 行：出现此状态的客户端的列表。
示例
示例 1 - 显示因未安装 NetBackup Encryption 软件包而失败的一个作业的错误。该故障的 NetBackup 状态码为 9。第二次运行 bperror 时，可显示有关 NetBackup 状态码 9 的推荐操作。
# bperror -d 12/23/2012 16:00:00 -e 12/23/2012 17:00:00 -t backstat -U STATUS CLIENT POLICY SCHED SERVER TIME COMPLETED 9 plim dhcrypt user plim 12/23/2012 16:38:09 an extension package is needed, but was not installed # bperror -S 9 -r an extension package is needed, but was not installed A NetBackup extension product is required in order to perform the requested operation. Install the required extension product.
示例 2 - 按用户格式报告最近 24 小时内出现的问题。
# bperror -U -problems
TIME SERVER CLIENT - TEXT
11/23/2012 16:07:39 raisins - no storage units configured
11/23/2012 16:07:39 raisins - scheduler exiting - failed reading
storage unit database information (217)
11/23/2012 16:17:38 raisins - no storage units configured
11/23/2012 16:17:38 raisins - scheduler exiting - failed reading
storage unit database information (217)
11/23/2012 18:11:03 raisins nut bpcd on nut exited with status 59:
access to the client was not allowed
11/23/2012? 18:11:20 raisins - WARNING: NetBackup database backup is
currently disabled
示例 3 - 下面的示例显示最近 24 小时内运行的作业（类型为 backstat）的状态。选项 -by_statcode 用于生成按状态码组织的显示内容。
该显示内容表明，在客户端 chive、gava 和 raisins 上运行的一个或多个作业已成功完成（状态码是 0）。另外，为客户端 nut 运行的一个或多个作业失败，原因是 nut 不允许主服务器或介质服务器访问它 （状态码是 59）。
# bperror -U -backstat -by_statcode
0 the requested operation was successfully completed
chive gava raisins
59 access to the client was not allowed
nut
示例 4 - 确定并检索特定用户作业的结果。它首先列出作业 ID 不为零的日志条目。然后，对感兴趣的作业运行用户格式的报告。
# bperror -hoursago 2012 -L | grep 'S:' | egrep 'J\:[1-9]'
12/21/2012 17:24:14 V1 S:plim C:plim J:1 (U:0,0)
12/23/2012 16:31:04 V1 S:plim C:plim J:1 (U:0,0)
12/23/2012 16:38:04 V1 S:plim C:plim J:3 (U:0,0)
# bperror -d 1/7/2007 -jobid 34 -U
TIME SERVER CLIENT - TEXT
01/07/2012 13:12:31 plim plim started backup job for client plim,
policy jdhcrypt, schedule user on storage unit jdhcrypt
01/07/2012 13:12:40 plim plim successfully wrote backup id
plim_0947272350,copy 1, fragment 1, 32 Kbytes at 11.057 Kbytes/sec
01/07/2012 13:12:41 plim plim CLIENT plim POLICY jdhcrypt SCHED user
EXIT STATUS 0 (the requested operation was successfully completed)
示例 5 - 显示错误目录库中过去 2000 小时内的介质条目。
bperror -hoursago 2000 -media -U
TTIME SERVER CLIENT - TEXT
12/23/2012 16:31:04 plim plim Media Manager terminated during mount
of media id A00000, possible media mount timeout
12/24/2012 04:31:20 plim - media id A00000 removed from Media
Manager database (manual deassign)
示例 6 - 报告并合计过去 24 小时内备份的总字节数。
bperror -all -hoursago 24 | grep "successfully wrote backup id | awk
'{bytes= bytes + $20} END {print "backed up",bytes," Kbytes of
data"}'
backed up 64 Kbytes of data
up",bytes," Kbytes of data"}'