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
- 索引
名称
vxlogview — 显示统一日志记录组件生成的日志
大纲
[-A] [-b StartDate] [-e EndDate] [-D] [-G Directory] [-g LogSet] [-I] [-i FileID] [-K HostName] [-L SeverityLevel] [-m Entity] [-N LevelMsgTypes] [-n NumberofDays] [-o OriginatorID] [-P ProcessID] [-p ProductID] [-r Result] [-s Subject] [-T ThreadID] [-t hh:mm:ss] [-X ContextToken] [-y]
-a [-p ProductID] {[-d DisplayOption,...] [-R ResourceDirectory] [-z TimeZone] [-l Locale]}
-q QueryName -f FileName {[-d DisplayOption,...][-R ResourceDirectory] [-z TimeZone] [-l Locale]}
-p ProductID -g LogSet | -i FileID {[-d DisplayOption,...] [-R ResourceDirectory] [-z TimeZone] [-l Locale]}
-p ProductID -w queryString {[-d DisplayOption,...] [-R ResourceDirectory] [-z TimeZone] [-l Locale]}
-v
在 UNIX 系统上，此命令的目录路径为 /usr/openv/netbackup/bin/
在 Windows 系统上，此命令的目录路径为 install_path\NetBackup\bin\
描述
使用 vxlogview 实用程序可以查看由统一日志记录生成的日志。可以使用命令行选项指定搜索条件，以查看特定的日志。
统一日志记录的日志文件使用如下所示的标准命名格式：
productID-originatorID-hostID-date-rotation.log
有关统一日志记录名称格式以及日志记录创建者 ID 的更多信息，请参考 NetBackup 日志记录参考指南。
选项
指定要查看的日志。
- -A, --audit
显示审核消息。
- -a, --all
显示多个 Veritas 产品生成的日志文件中的所有日志消息。
- -b, --stdate StartDate
显示在给定开始日期和时间记录的消息。
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。
/usr/openv/msg/.conf文件 (UNIX) 和install_path\VERITAS\msg\LC.CONF文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。有关更多信息，请参见NetBackup 管理指南，第 II 卷中的“关于指定 NetBackup 安装的区域设置”主题。
在 UNIX 中，应将日期放在单引号内；在 Windows 中，则应将日期放在双引号内。例如：
-b ’1/1/2013 12:00:00 AM’
如果未指定 -b，则将显示从日志文件开头到给定结束时间的消息（请参见 -e 选项）。
- -D, --debug
显示调试日志消息。
- -d, --display DisplayOption,...
显示指定的消息字段。请用逗号分隔多个 DisplayOptions。
DisplayOption 可能是以下一个或多个选项：
D – 显示日期
T - 显示时间戳
m – 显示消息类型
p – 显示进程 ID
t – 显示线程 ID
P – 显示产品 ID
O – 显示创建者 ID
c – 显示上下文标志
s – 显示应用程序日志条目的严重性
u – 显示应用程序或诊断的唯一消息 ID
x – 显示实际的日志消息文本
w - 显示记录诊断或调试消息的用户
i – 显示产品的简称
o – 显示创建者的简称
all – 显示日志记录的所有字段
如果 -d 未指定，则默认显示下列字段。
- 日期
- 时间
- 用户（仅对于诊断和调试消息）
- 严重性（仅应用程序消息）
- UMI（仅应用程序和诊断消息）
- 消息文本
- -e, --endate EndDate
显示在给定结束日期和时间之前记录的消息。
NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。
/usr/openv/msg/.conf文件 (UNIX) 和install_path\VERITAS\msg\LC.CONF文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。有关更多信息，请参见NetBackup 管理指南，第 II 卷中的“关于指定 NetBackup 安装的区域设置”主题。
在 UNIX 中，应将日期放在单引号内；在 Windows 中，则应将日期放在双引号内。例如：
--endate ’1/1/2013 12:00:00 PM’
如果未指定 -e 选项，则 vxlogview 将显示从给定开始日期和时间（请参见 -b 选项）到日志文件结束的消息。
- -f, --filename FileName
指定包含一个或多个查询的文件对应的路径名和文件名。与 -q 选项一同使用。
- -G, --logdir Directory
显示指定目录而非配置的日志目录中的日志。必须为目录指定绝对路径。
- -g, --logset LogSet
显示指定 LogSet 的日志配置设置。
- -I, --diag
显示诊断日志消息。
- -i, --fileid FileID
显示由给定文件 ID 或共享创建者 ID 记录的消息。它仅搜索由指定进程创建的日志文件。通过限制必须搜索的日志文件，vxlogview 可更快地返回结果。相比之下，vxlogview -o 选项用于在所有统一日志文件中搜索由指定进程记录的消息。
- -K, --hostname HostName
显示由指定主机名记录的消息。
- -L, --app -C | -E | -F | -M | -W
显示应用程序日志消息。以下参数可以与 -L 结合使用以指定严重性级别：
-C, --crit：出现可能影响应用程序可用性的严重错误。
-E, --err：出现不会影响整个应用程序的错误。
-F, --info：提示性消息。
-M, --emerg：出现可能导致操作系统出现故障或关闭的紧急情况。
-W, --warning：将针对已检测到的问题发出警告。
- -l, --locale Locale
使用指定的区域设置显示消息。默认为英文。如果没有指定此选项，将使用当前系统区域设置显示消息。
- -m, --who Entity
显示按给定实体方法名称或函数名称记录的消息。
- -N, --level Level -D | -I
显示给定级别 (Level) 的调试消息 (-D) 或诊断日志消息 (-I)。
- -n, --days NumberOfDays
显示最近 NumberOfDays 天记录的消息。
- -o, --orgid OriginatorID
显示由指定创建者 ID 记录的消息。您可以使用创建者的 ID 号或简称。例如，策略执行管理器可以通过 nbpem 或通过其创建者 ID 号 (116) 来指定。
- -P, --pid ProcessID
显示由指定进程 ID 记录的消息。
- -p, --prodid ProductID
显示产品（由给定产品 ID 标识）所记录的消息。用户可提供产品的缩略名，而不是提供标识符。NetBackup 产品 ID 为 51216，PBX 产品 ID 为 50936。
- -R, --resdir ResourceDirectory
使用指定目录而非配置的本地化资源目录中的资源。
- -r, --result Result
显示具有指定结果的审核消息。Result 可以为 0 或 1。
- -S, --tailloop
连续显示由给定产品 ID 和文件 ID 对记录的新消息。产品 ID (-pProductID) 和文件 ID (-iFileID) 必须在命令行上与 tailloop 选项 (-S) 一起使用。文件 ID 可以是共享的创建者 ID，也可以是不与任何其他 ID 共享的创建者 ID。tailloop 启动时会向控制台显示最近记录的 10 条消息，然后显示所有新的日志消息。可以随时使用 Ctrl-C 来停止该循环。
- -s, --subject Subject
显示具有指定 Subject 的审核消息。
- -T, --tid ThreadID
显示由指定线程 ID 记录的消息。
- -t, --tail hh:mm:ss
显示前 hh:mm:ss 时间段内的消息。
- -v, --version
显示此命令的版本信息。
- -w, --where QueryString
指定在查询日志消息时使用的 WHERE 子句，以便显示消息的子集。有关 QueryString 的更多详细信息，请参考《NetBackup 日志记录参考指南》。
- -X, --ctx ContextToken
显示属于给定上下文实例的消息。上下文标志可标识上下文实例。如果将上下文标志指定为 all，该选项将显示所有上下文名称和关联的标志。
- -y, --displayhost
显示每条日志消息时显示主机名。如果日志文件来自不同的主机并且需要显示哪条消息来自哪台主机，请使用此选项。
- -z, --timezone GMT+hh:ss | GMT-hh:ss
使用按照给定时区作相应调整后的时间显示消息。
退出状态
将返回下列退出值：
0 -- 成功完成。
-1 -- 出现错误。
查询字符串
查询字符串是文本表达式（类似于数据库的 WHERE 子句），可用于从统一日志记录系统中检索日志条目。表达式是关系运算符、常数整数、常数字符串以及日志字段名的组合，它们的计算结果为一个值。逻辑运算符（如 AND 和 OR）用于对表达式进行分组。
支持的关系运算符包括：<（小于）、>（大于）、<=（小于等于）、>=（大于等于）、=（等于）和 !=（不等于）。
支持的逻辑运算符包括 &&（逻辑与）和 ||（逻辑或）。
预定义的日志字段可以采用全部大写形式或全部小写形式（例如：PID | pid）。这些字段包括以下各项：
CTXTOK -- 上下文标志（字符串）
ENDATE -- 特定于区域设置的结束日期（长整数或字符串）
FILEID -- 共享的创建者 ID（整数）
HOSTNAME -- 源主机的名称（用引号括起的字符串）
LEVEL -- 调试和诊断级别。默认为全部显示（整数 0-6）
MSGTYPE -- 支持以下消息类型：
DEBUG | debug DIAG | diag APP | app AUDIT | audit
ORGID -- 创建者标识符（整数或字符串）
PID -- 进程标识符（整数）
PREVTIME -- 前一时间（字符串 hh:mm:ss）
PRODID -- 产品标识符（整数或字符串）
RETURNVAL -- 审核消息结果字段（0 或 1）
SEV -- 严重性级别。支持以下严重性类型：
INFO | info WARNING | warning ERR | err CRIT | crit EMERG | emerg
STDATE -- 特定于区域设置的开始日期（长整数或字符串）
SUBJECT -- 审核消息主题字段（字符串）
TID -- 线程 ID（整数）
WHO -- 消息的记录者（字符串）
示例
以下示例仅对 UNIX 有效，它们将选项参数放在单引号内。在 Windows 中，应使用双引号。
示例 1 - 显示安装的所有产品的日志消息：
# vxlogview -a
示例 2 - 显示 PBX（产品 ID 50936）的日志消息。您必须是具有管理员 (root) 权限的授权用户。它仅显示日期、时间、消息类型以及消息文本：
# vxlogview --prodid 50936 --display D,T,m,x
示例 3 - 显示从 2010 年 11 月 18 日到 2010 年 11 月 21 日记录的 NetBackup 日志消息：
# vxlogview --where "(prodid = 'NB') && (stdate >= '11/18/10 0:0:0 AM' && endate <= '11/21/10 10:12:00 AM')"
示例 4 - 显示 2013 年 1 月 3 日上午 11:00:00 及此后创建的日志消息：
# vxlogview -b '1/03/13 11:00:00 AM'
示例 5 - 显示在前一小时内记录的日志消息：
# vxlogview --tail 1:00:00
示例 6 - 显示结果为 0 的审核日志消息：
# vxlogview --audit -r 0
示例 7 - 显示 job_context 实例的上下文日志消息：
# vxlogview --ctx 'jobid=4'