Veritas NetBackup™ 命令参考指南

Last Published:
Product(s): NetBackup (8.2)
  1. 介绍
    1.  
      关于 NetBackup 命令
    2.  
      浏览多个菜单级别
    3.  
      NetBackup 命令约定
    4.  
      NetBackup 介质管理器命令说明
    5.  
      IPv6 更新
  2. 附录 A. NetBackup 命令
    1.  
      acsd
    2.  
      add_media_server_on_clients
    3.  
      backupdbtrace
    4.  
      backuptrace
    5.  
      bmrc
    6.  
      bmrconfig
    7.  
      bmrepadm
    8.  
      bmrprep
    9.  
      bmrs
    10.  
      bmrsrtadm
    11.  
      bp
    12.  
      bparchive
    13.  
      bpbackup
    14.  
      bpbackupdb
    15.  
      bpcatarc
    16.  
      bpcatlist
    17.  
      bpcatres
    18.  
      bpcatrm
    19.  
      bpcd
    20.  
      bpchangeprimary
    21.  
      bpclient
    22.  
      bpclimagelist
    23.  
      bpclntcmd
    24.  
      bpclusterutil
    25.  
      bpcompatd
    26.  
      bpconfig
    27.  
      bpdbjobs
    28.  
      bpdbm
    29.  
      bpdgclone
    30.  
      bpdown
    31.  
      bpduplicate
    32.  
      bperror
    33.  
      bpexpdate
    34.  
      bpfis
    35.  
      bpflist
    36.  
      bpgetconfig
    37.  
      bpgetdebuglog
    38.  
      bpimage
    39.  
      bpimagelist
    40.  
      bpimmedia
    41.  
      bpimport
    42.  
      bpinst
    43.  
      bpkeyfile
    44.  
      bpkeyutil
    45.  
      bplabel
    46.  
      bplist
    47.  
      bpmedia
    48.  
      bpmedialist
    49.  
      bpminlicense
    50.  
      bpnbat
    51.  
      bpnbaz
    52.  
      bppficorr
    53.  
      bpplcatdrinfo
    54.  
      bpplclients
    55.  
      bppldelete
    56.  
      bpplinclude
    57.  
      bpplinfo
    58.  
      bppllist
    59.  
      bpplsched
    60.  
      bpplschedrep
    61.  
      bpplschedwin
    62.  
      bppolicynew
    63.  
      bpps
    64.  
      bprd
    65.  
      bprecover
    66.  
      bprestore
    67.  
      bpretlevel
    68.  
      bpschedule
    69.  
      bpschedulerep
    70.  
      bpsetconfig
    71.  
      bpstsinfo
    72.  
      bpstuadd
    73.  
      bpstudel
    74.  
      bpstulist
    75.  
      bpsturep
    76.  
      bptestbpcd
    77.  
      bptestnetconn
    78.  
      bptpcinfo
    79.  
      bpup
    80.  
      bpverify
    81.  
      cat_convert
    82.  
      cat_export
    83.  
      cat_import
    84.  
      configureCertsForPlugins
    85.  
      configureMQ
    86.  
      configurePorts
    87.  
      configureWebServerCerts
    88.  
      create_nbdb
    89.  
      csconfig cldinstance
    90.  
      csconfig cldprovider
    91.  
      csconfig meter
    92.  
      csconfig throttle
    93.  
      csconfig reinitialize
    94.  
      duplicatetrace
    95.  
      importtrace
    96.  
      jbpSA
    97.  
      jnbSA
    98.  
      ltid
    99.  
      manageClientCerts
    100.  
      mklogdir
    101.  
      nbauditreport
    102.  
      nbcatsync
    103.  
      NBCC
    104.  
      NBCCR
    105.  
      nbcertcmd
    106.  
      nbcertupdater
    107.  
      nbcldutil
    108.  
      nbcloudrestore
    109.  
      nbcomponentupdate
    110.  
      nbcplogs
    111.  
      nbdb_admin
    112.  
      nbdb_backup
    113.  
      nbdb_move
    114.  
      nbdb_ping
    115.  
      nbdb_restore
    116.  
      nbdb_unload
    117.  
      nbdbms_start_server
    118.  
      nbdbms_start_stop
    119.  
      nbdc
    120.  
      nbdecommission
    121.  
      nbdelete
    122.  
      nbdeployutil
    123.  
      nbdevconfig
    124.  
      nbdevquery
    125.  
      nbdiscover
    126.  
      nbdna
    127.  
      nbemm
    128.  
      nbemmcmd
    129.  
      nbfindfile
    130.  
      nbfirescan
    131.  
      nbftadm
    132.  
      nbftconfig
    133.  
      nbgetconfig
    134.  
      nbhba
    135.  
      nbholdutil
    136.  
      nbhostidentity
    137.  
      nbhostmgmt
    138.  
      nbhypervtool
    139.  
      nbimageshare
    140.  
      nbinstallcmd
    141.  
      nbjm
    142.  
      nbkmsutil
    143.  
      nboraadm
    144.  
      nborair
    145.  
      nbpem
    146.  
      nbpemreq
    147.  
      nbperfchk
    148.  
      nbplupgrade
    149.  
      nbrb
    150.  
      nbrbutil
    151.  
      nbregopsc
    152.  
      nbreplicate
    153.  
      nbrepo
    154.  
      nbrestorevm
    155.  
      nbseccmd
    156.  
      nbsetconfig
    157.  
      nbsnapimport
    158.  
      nbsnapreplicate
    159.  
      nbsqladm
    160.  
      nbstl
    161.  
      nbstlutil
    162.  
      nbstop
    163.  
      nbsu
    164.  
      nbsvrgrp
    165.  
      resilient_clients
    166.  
      restoretrace
    167.  
      stopltid
    168.  
      tl4d
    169.  
      tl8d
    170.  
      tl8cd
    171.  
      tldd
    172.  
      tldcd
    173.  
      tlhd
    174.  
      tlhcd
    175.  
      tlmd
    176.  
      tpautoconf
    177.  
      tpclean
    178.  
      tpconfig
    179.  
      tpext
    180.  
      tpreq
    181.  
      tpunmount
    182.  
      verifytrace
    183.  
      vltadm
    184.  
      vltcontainers
    185.  
      vlteject
    186.  
      vltinject
    187.  
      vltoffsitemedia
    188.  
      vltopmenu
    189.  
      vltrun
    190.  
      vmadd
    191.  
      vmchange
    192.  
      vmcheckxxx
    193.  
      vmd
    194.  
      vmdelete
    195.  
      vmoprcmd
    196.  
      vmphyinv
    197.  
      vmpool
    198.  
      vmquery
    199.  
      vmrule
    200.  
      vmupdate
    201.  
      vnetd
    202.  
      vssat
    203.  
      vwcp_manage
    204.  
      vxlogcfg
    205.  
      vxlogmgr
    206.  
      vxlogview
    207.  
      W2KOption

名称

vxlogview — 显示统一日志记录组件生成的日志

大纲

vxlogview[-A] [-b StartDate] [-e EndDate] [-D] [-G Directory] [-g LogSet] [-I] [-i FileID] [-K HostName] [-L SeverityLevel] [-m Entity] [-N Level MsgTypes] [-n NumberofDays] [-o OriginatorID] [-P ProcessID] [-p ProductID] [-r Result] [-s Subject] [-T ThreadID] [-t hh:mm:ss] [-X ContextToken] [-y]

vxlogview -a [-p ProductID] {[-d DisplayOption,...] [-R ResourceDirectory] [-z TimeZone] [-l Locale]}

vxlogview -q QueryName -f FileName {[-d DisplayOption,...][-R ResourceDirectory] [-z TimeZone] [-l Locale]}

vxlogview -p ProductID -g LogSet | -i FileID {[-d DisplayOption,...] [-R ResourceDirectory] [-z TimeZone] [-l Locale]}

vxlogview -p ProductID -w queryString {[-d DisplayOption,...] [-R ResourceDirectory] [-z TimeZone] [-l Locale]}

vxlogview -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,...

显示指定的消息字段。请用逗号分隔多个 DisplayOption

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 (-p ProductID) 和文件 ID (-i FileID) 必须在命令行上与 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'

另请参见

请参见vxlogcfg(1m)。

请参见vxlogmgr(1m)。