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

名称

vxlogcfg — 修改统一日志记录配置设置

大纲

vxlogcfg -a -p ProductID -c ConfigPath -n Names [-q]

vxlogcfg -a -p ProductID -o OriginatorID -s keyname=value [-q]

vxlogcfg -a -p ProductID -g LogSet -s keyname=value [-q]

vxlogcfg -d -p ProductID

vxlogcfg -l [-p ProductID [-o OriginatorID]] [-q]

vxlogcfg -l [-p ProductID [-g LogSet]] [-q]

vxlogcfg -r -p ProductID [-o OriginatorID] [-s keyname] [-q]

vxlogcfg -r -p ProductID [-g LogSet] [-s keyname] [-q]

vxlogcfg -v

 

在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/

在 Windows 系统中,此命令的目录路径为 install_path\NetBackup\bin\

描述

使用 vxlogcfg 命令可更改 NetBackup 统一日志记录的日志记录设置。在安装和卸载过程中注册和注销产品日志配置。

统一日志记录的日志文件使用如下所示的标准命名格式:

productID-originatorID-hostID-date-rotation.log

有关统一日志记录命名格式以及日志记录创建者 ID 的更多信息,请参考 NetBackup 日志记录参考指南

选项

指定要注册或注销的产品日志配置。应对所有目录路径使用完全限定路径名。如果目录名包含空格,请将该目录的路径名放在引号内(如 "Program Files" 目录)。

-a, --add

注册或创建产品日志配置设置。现有的全部日志设置将被覆盖。请不要使用该选项来向使用统一日志记录的那些日志设置列表添加产品。而是仅将此选项用于修改现有的统一日志记录设置。请参见示例。

-c, --config ConfigPath

提供应从中读取产品日志配置设置的绝对路径。

在 UNIX 系统上,使用产品日志配置文件的绝对路径(例如,/opt/vrts/ProductA/log.conf)。

在 Windows 系统上,使用产品日志注册表设置的路径(例如,\\SOFTWARE\VERITAS\PRODUCTA\

-d, --delete

如果没有为产品配置创建者 ID,则将从主日志记录配置文件中注销和删除产品日志配置设置。也将删除相应的产品日志配置文件。

-g, --logset LogSet

创建或修改指定 LogSet 的日志配置设置。使用文本字符串 Default 或文本字符串 ALL 作为 LogSet。如果 LogSet 为 Default,则 –s 配置设置为默认设置。如果 LogSet 为 ALL,则 –s 配置设置适用于给定产品 ID 的所有创建者。

-l, --list

列出以下各项之一:

  • 所有配置的产品。

  • 所有创建者 ID 和 LogSet

  • 所有为产品 ID 和创建者 ID 对或产品 ID 和 LogSet 定义的配置设置

-n, --names Name

为产品指定缩写名称或简称。用逗号分隔多个名称。

-o, --orgid OrgID

对指定的创建者 ID 创建或修改日志配置设置。可以为创建者 ID 提供有效的创建者 ID(一个数字),或者文本字符串 Default 或文本字符串 ALL。如果创建者 ID 为 Default,则 –s 配置设置为默认设置。如果创建者 ID 为 ALL,则 –s 配置设置适用于给定产品 ID 的所有创建者。

-p, --prodid ProductID

创建或修改 productID 的日志配置设置。

-q, --quiet

不显示错误或提示性消息(静默模式)。

-r, --remove

从产品日志记录的配置文件中注销和删除指定 OID 和产品的日志配置设置。可以用 -s, --setting keyname=value 选项删除单个设置。

小心:

应始终将 -r 选项与 -o 选项一起使用。否则,所有现有的 NetBackup 日志设置都将删除,并且不会对整个 NetBackup 执行任何进一步的日志记录。

-s, --setting keyname=value

当和 -a(添加选项)一起使用时,设置单个配置设置。keyname 是配置设置的名称,value 是该设置的值。可以在命令行上使用多个 -s keyname=value 参数。

-s, --setting keyname

当和 -r 选项一起使用时,删除配置设置。使用 -r 选项时仅使用一个键名。要删除多个设置,请提供多个 -s 选项。有关特定的键名,请参见“键名和值”部分。

-v, --version

显示此命令的版本信息。

键名和值

以下是可在 -s 选项中指定的键名和值。对于 NetBackup,vxlogcfg 命令会将这些键名和值放在 /usr/openv/netbackup/nblog.conf 文件中(在 UNIX 上),或者放在 install_path\NetBackup\nblog.conf 中(在 Windows 上)。对于 PBX,将其放在 /etc/vx/VxICS/icsul.conf 中(在 UNIX 上),或者放在注册表条目 SOFTWARE\VERITAS\VxICS\logcfg 中(在 Windows 上)。

UNIX 和 Windows 的键名和值

LogDirectory

提供目录的绝对路径或相对路径。无默认值。如果为创建者 ID 指定相对路径,该路径相对于产品 ID 日志目录(由日志配置文件中的 Default.LogDirectory 指定)。

小心:

在使用 LogDirectory 键名以将统一日志重定向到备用目录时,需要停止然后重新启动 NetBackup 服务。此操作可使重定向生效。

DebugLevel

设置调试日志消息的详细级别 (调试日志供 Veritas 工程人员使用。) 有效值介于 0 到 6 之间。

DiagnosticLevel

设置诊断日志消息的详细级别 (诊断日志供 NetBackup 管理员和用户使用)。有效值为 0 到 6。零 (0) 表示无调试消息。

DynaReloadInSec

动态重新加载调试和诊断设置。60 秒之后,重新加载 0-60 间的整数。大于 60 的整数在指定秒数重新加载。

LogToStdout

将所有日志消息发送到标准输出(默认为终端)和日志文件。有效值为 true 和 false(默认值)。

LogToStderr

将应用程序日志消息发送到 Stderr(默认为终端)和日志文件。有效值为 true 和 false(默认值)。

LogToOslog

将应用程序日志消息发送到操作系统日志(UNIX 上为 syslog,Windows 上为事件日志)。有效值为 true 和 false(默认值)。

RolloverMode

指定日志文件滚动的时间。如果滚动日志文件,则会关闭当前的日志文件并打开一个新文件。目的是使日志文件不致于太大,并可删除或存档较早的日志文件。有效值为 FileSize、LocalTime、Periodic、FileSize | LocalTime、FileSize | Periodic 和 None。

FileSize 表示当日志达到 MaxLogFileSizeKB 所设置的大小时开始回转。FileSize 是默认值。

LocalTime 表示日志文件每天应在 RolloverAtLocalTime 指定的时间回转一次。

Periodic 表示日志文件应在 RolloverAtLocalTime 指定的秒数后回转。

FileSize | LocalTime 表示当达到 FileSize 或 LocalTime 时(无论哪个先达到),将重新记录日志文件。

FileSize | Periodic 表示当达到 FileSize 或 Periodic 时(无论哪个先达到),将重新记录日志文件。

None 表示日志文件不滚动。

MaxLogFileSizeKB

RolloverMode 设置为 FileSize 时,指定发生回转前允许的日志文件最大大小(以 KB 为单位)。有效值介于 1 到 4294967295 之间。默认值是 51200 (51.2 MB)。

RolloverPeriodInSeconds

RolloverMode 设置为 Periodic 时,指定日志文件开始回转前的时间段(以秒为单位)。有效值介于 1 到 2147483648 之间。默认值为 43200(12 小时)。

RolloverAtLocalTime

RolloverMode 设置为 LocalTime 时,指定一天中日志文件开始回转的时间。有效值为 00:00 到 23:59。默认值为 00:00(本地午夜时间)。

NumberOfLogFiles

指定在日志目录中最多可为每个统一日志记录创建者保留的文件数。有效值介于 1 到 4294967295 之间。

vxlogmgr --auto 命令使用 NumberOfLogFiles 来确定要删除或移动的日志文件(从最早的文件开始)的数目。例如,一个日志目录包含 7 个由特定创建者创建的文件。将 NumberOfLogFiles 设置为 5,vxlogmgr --auto --del 命令将删除该创建者创建的两个最早的文件。

LogRecycle

有效值为 true 和 false。默认值为 false。如果为 true,则日志文件的数目不超过 NumberOfLogFiles

OIDNames

为 -o 选项所指定的统一日志记录创建者指定一个或多个备用名称。当使用 vxlogview 命令执行搜索时,可以使用这些名称来替代创建者 ID。每个名称的最大长度为 80 个字符。可以指定多个名称,以空格分隔。

L10nLib

指定外部本地化库的绝对路径和文件名。此选项仅供 Veritas 内部使用。使用此选项可以禁用统一日志记录。

L10nResource

指定与统一日志记录产品或创建者关联的本地化资源的名称。此选项仅供 Veritas 内部使用。使用此选项可以禁用统一日志记录。

L10nResourceDir

此设置指定与统一日志记录产品或创建者关联的本地化资源目录的名称。此选项仅供 Veritas 内部使用。使用此选项可以禁用统一日志记录。

下面的四个密钥名称仅适用于 UNIX 系统。

LogFilePermissions

一个八进制数,用于指定为日志文件(该日志文件是由 -o 选项所指定的创建者创建的)分配的 UNIX 文件权限。在大多数情况下,不需要使用此选项。

SyslogIdent

在将 LogToOslog 设置为 true 时,指定添加到每条 syslog 消息开头的字符串。SyslogIdent 可以是最多为 80 个字符的任何字符串。在大多数情况下,不需要使用此选项。

SyslogOpt

指定传递给 syslog openlog 函数的 syslog 选项值。在启用 LogToOslog 时,会将日志消息发送到 UNIX syslog。有效值介于 0 到 4294967295 之间。在大多数情况下,不需要使用此选项。

SyslogFacility

指定与发送到 syslog 的日志消息关联的 syslog 功能值。在启用 LogToSyslog 时,会将日志消息发送到 syslog。在大多数情况下,不需要使用此选项。

有效值包括:LOG_KERN、LOG_USER、LOG_MAIL、LOG_DAEMON、LOG_AUTH、LOG_LPR、LOG_NEWS、LOG_UUCP、LOG_CRON、LOG_LOCAL0、LOG_LOCAL1、LOG_LOCAL2、LOG_LOCAL3、LOG_LOCAL4、LOG_LOCAL5、LOG_LOCAL6 和 LOG_LOCAL7。 默认值为 LOG_USER。

下面的三个键名仅在 Windows 系统上使用。

NtEventLogCategory

在启用了 LogToOslog 时,指定与发送到 Windows 事件日志的日志消息相关联的类别编号。在大多数情况下,不需要使用此选项。

LogFileSDDL

指定 Windows 安全描述符定义语言 (SDDL) 字符串。此字符串可以为 -o 选项指定的创建者所创建的日志文件设置访问控制列表 (ACL)。在大多数情况下,不需要使用此选项。

NtEventLogSourceName

在 Windows 上启用 LogToOslog 选项时,指定将日志消息发送到的 Windows 事件日志。此选项仅供内部使用。使用此选项可以禁用统一日志记录。

示例

示例 1 - 在 UNIX 上设置 NetBackup 的 LogDirectory 和创建者 ID 111:

# vxlogcfg -a --prodid 51216 --orgid 111 -s 
LogDirectory=/usr/openv/logs

示例 2 - 为 NetBackup 中的所有统一日志记录创建者设置 DebugLevel 和 DiagnosticLevel:

# vxlogcfg -a --prodid 51216 -o ALL -s DebugLevel=3 -s 
DiagnosticLevel=3

示例 3 - 为产品 ID 1 设置默认 RolloverMode:

# vxlogcfg -a --prodid 1 -o Default -s RolloverMode=FileSize

示例 4 - 显示产品 ID 1 的创建者 2 的配置设置。

# vxlogcfg -l --prodid 1 --orgid 2

示例 5 - 列出为产品 ID 1 配置的所有创建者。

# vxlogcfg -l --prodid 1

示例 6 - 列出所有配置的产品。

# vxlogcfg -l

文件

UNIX 系统:

/usr/openv/netbackup/nblog.conf
/etc/vx/VxICS/icsul.conf

另请参见

请参见vxlogmgr(1m)。

请参见vxlogview(1)。