NetBackup™ 命令参考指南

Last Published:
Product(s): NetBackup (10.3)
  1. 介绍
    1.  
      关于 NetBackup 命令
    2.  
      浏览多个菜单级别
    3.  
      NetBackup 命令约定
    4.  
      NetBackup 介质管理器命令说明
    5.  
      IPv6 更新
  2. 附录 A. NetBackup 命令
    1.  
      acsd
    2.  
      backupdbtrace
    3.  
      backuptrace
    4.  
      bmrc
    5.  
      bmrconfig
    6.  
      bmrepadm
    7.  
      bmrprep
    8.  
      bmrs
    9.  
      bmrsrtadm
    10.  
      bp
    11.  
      bparchive
    12.  
      bpbackup
    13.  
      bpbackupdb
    14.  
      bpcatarc
    15.  
      bpcatlist
    16.  
      bpcatres
    17.  
      bpcatrm
    18.  
      bpcd
    19.  
      bpchangeprimary
    20.  
      bpcleanrestore
    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.  
      bpup
    79.  
      bpverify
    80.  
      cat_convert
    81.  
      cat_export
    82.  
      cat_import
    83.  
      configureCerts
    84.  
      configureMQ
    85.  
      configureWebServerCerts
    86.  
      create_nbdb
    87.  
      csconfig cldinstance
    88.  
      csconfig cldprovider
    89.  
      csconfig meter
    90.  
      csconfig reinitialize
    91.  
      csconfig throttle
    92.  
      duplicatetrace
    93.  
      importtrace
    94.  
      jbpSA
    95.  
      jnbSA
    96.  
      ltid
    97.  
      mklogdir
    98.  
      msdpcldutil
    99.  
      nbauditreport
    100.  
      nbcallhomeproxyconfig
    101.  
      nbcatsync
    102.  
      NBCC
    103.  
      NBCCR
    104.  
      nbcertcmd
    105.  
      nbcertupdater
    106.  
      nbcldutil
    107.  
      nbcmdrun
    108.  
      nbcomponentupdate
    109.  
      nbcplogs
    110.  
      nbcredkeyutil
    111.  
      nbdb_admin
    112.  
      nbdb_backup
    113.  
      nbdb_move
    114.  
      nbdb_ping
    115.  
      nbdb_restore
    116.  
      nbdb_unload
    117.  
      nbdb2adutl
    118.  
      nbdbms_start_server
    119.  
      nbdbms_start_stop
    120.  
      nbdc
    121.  
      nbdecommission
    122.  
      nbdelete
    123.  
      nbdeployutil
    124.  
      nbdevconfig
    125.  
      nbdevquery
    126.  
      nbdiscover
    127.  
      nbdna
    128.  
      nbemm
    129.  
      nbemmcmd
    130.  
      nbfindfile
    131.  
      nbfirescan
    132.  
      nbfp
    133.  
      nbftadm
    134.  
      nbftconfig
    135.  
      nbgetconfig
    136.  
      nbhba
    137.  
      nbholdutil
    138.  
      nbhostidentity
    139.  
      nbhostmgmt
    140.  
      nbhypervtool
    141.  
      nbidpcmd
    142.  
      nbimageshare
    143.  
      nbinstallcmd
    144.  
      nbjm
    145.  
      nbkmiputil
    146.  
      nbkmscmd
    147.  
      nbkmsutil
    148.  
      nboraadm
    149.  
      nborair
    150.  
      nbpem
    151.  
      nbpemreq
    152.  
      nbmariadb
    153.  
      nbmlb
    154.  
      nbperfchk
    155.  
      nbplupgrade
    156.  
      nbrb
    157.  
      nbrbutil
    158.  
      nbreplicate
    159.  
      nbrepo
    160.  
      nbrestorevm
    161.  
      nbseccmd
    162.  
      nbserviceusercmd
    163.  
      nbsetconfig
    164.  
      nbshvault
    165.  
      nbsmartdiag
    166.  
      nbsnapimport
    167.  
      nbsnapreplicate
    168.  
      nbsqladm
    169.  
      nbsqlite
    170.  
      nbstl
    171.  
      nbstlutil
    172.  
      nbstop
    173.  
      nbsu
    174.  
      nbsvrgrp
    175.  
      netbackup_deployment_insights
    176.  
      resilient_clients
    177.  
      restoretrace
    178.  
      stopltid
    179.  
      tldd
    180.  
      tldcd
    181.  
      tpautoconf
    182.  
      tpclean
    183.  
      tpconfig
    184.  
      tpext
    185.  
      tpreq
    186.  
      tpunmount
    187.  
      verifytrace
    188.  
      vltadm
    189.  
      vltcontainers
    190.  
      vlteject
    191.  
      vltinject
    192.  
      vltoffsitemedia
    193.  
      vltopmenu
    194.  
      vltrun
    195.  
      vmadd
    196.  
      vmchange
    197.  
      vmcheckxxx
    198.  
      vmd
    199.  
      vmdelete
    200.  
      vmoprcmd
    201.  
      vmphyinv
    202.  
      vmpool
    203.  
      vmquery
    204.  
      vmrule
    205.  
      vmupdate
    206.  
      vnetd
    207.  
      vssat
    208.  
      vwcp_manage
    209.  
      vxlogcfg
    210.  
      vxlogmgr
    211.  
      vxlogview
    212.  
      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

 

On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/

On Windows systems, the directory path to this command is 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)。