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

名称

nbdeployutil — 这是一个部署实用程序,用于收集并分析有关客户端和容量的主服务器信息

大纲

nbdeployutil --debug-inputs dir1 [dir2dir3]

nbdeployutil --gather [--bpimagelist=options] [--capacity ¦ --traditional] [--client hostname1, [hostname2, ...] | --clientlist=filename] [--hoursago=number] [--log=filename] [--master=hostname] [--nolog] [--output=directory] [--runtimestats] [-start date [-end date]] [--client-timeout seconds] [--exclude-clients client1[,client2,...]] [--exclude-clientlist path] [--exclude-all-clients]

nbdeployutil --report [--capacity ¦ --traditional] [--day-boundary=time] [dir1 dir2 dir# | --dirsfile=filename | --parentdir=directory] [--log=filename] [--nolog] [--overlap-details] [--runtimestats]

nbdeployutil --retry dir1 [dir2dir#]

nbdeployutil --version

 

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

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

描述

nbdeployutil 实用程序从主服务器收集部署信息并进行分析。该实用程序根据两个 NetBackup 许可模式之一(传统许可或容量许可)执行部署分析。传统许可部署分析会计算客户端和服务器的数量,然后将此信息与获得许可的选件进行比较。容量许可部署分析会计算受保护的源数据量。

该命令分两个步骤运行。nbdeployutil 在第一步收集数据,在第二步分析数据。

nbdeployutil 命令支持增量式报告。通过该功能,nbdeployutil 将根据指定的频率运行,以增量方式收集数据并生成基于容量的许可报告。有关如何启用和使用该功能的更多信息,请参见 Veritas NetBackup 管理指南,第 II 卷

该实用程序在收集操作期间将生成一个名为 nbdeployutil-gather-timestamp.log 的日志文件,在分析和报告生成操作期间将生成一个名为 nbdeployutil-report-timestamp.log 的日志文件。默认情况下,这些日志文件是在收集的数据所在的目录中创建的。

有关传统的和基于容量的许可的更多信息,请参见 NetBackup 管理指南,第 II 卷

操作

--client-timeout seconds

此选项在 nbdeployutil 中强制 bptestbpcd 的超时,而不依赖于 NetBackup 配置。

仅当指定了 --gather 选项时,此选项才适用。如果指定了 --capacity,则此选项不适用。

--debug-inputs

将用于生成报告的文件转换为用户可读的格式。这些新文件比原始输出更方便阅读。只能指定包含基本 ASCII 字符的目录。不支持带有扩展 ASCII 字符的目录。

--exclude-all-clients

使用此选项,可以从 bptestbpcd 连接中排除所有客户端。指定的客户端在报告中显示为不可连接。

仅当指定了 --gather 选项时,此选项才适用。如果指定了 --capacity,则此选项不适用。

--exclude-clientlist path

使用此选项,可以指定包含要从 bptestbpcd 连接中排除的客户端列表的文件。每个客户端名称将单独列在文件中的一行内。指定的客户端在报告中显示为不可连接。

仅当指定了 --gather 选项时,此选项才适用。如果指定了 --capacity,则此选项不适用。

--exclude-clients client1[,client2,...]

使用此选项,可以从 bptestbpcd 连接中排除任何指定的客户端。指定的客户端在报告中显示为不可连接。

仅当指定了 --gather 选项时,此选项才适用。如果指定了 --capacity,则此选项不适用。

--gather

收集数据以便使用 report 选项进行分析。如果使用了 capacitytraditional 参数,则只会收集该特定许可模型的数据。如果 capacitytraditional 均未指定,gather 将收集这两种许可模型的数据。

在 NetBackup 8.0 或更高版本的主服务器上,在容量许可模式下运行 nbdeployutil --gather 命令时,系统会提示您输入其他信息。必须输入显示用于对 NetBackup Web 管理服务进行身份验证的凭据信息:

  • 域类型:从 NIS、NISPLUS、WINDOWS、vx、unixpwd、ldap 中输入域类型值。该值区分大小写。

  • 域名:主服务器主机所属的域的名称。如果主服务器不属于任何域,则输入主服务器的名称。

  • 用户名:具有管理员权限的用户的名称。

  • 密码:具有管理员权限的同一用户的密码。输入密码时,字符不会特意显示在命令行中。

在多主服务器的情况下,必须输入 gather 命令提及的所有主服务器的凭据。

--report

基于通过 gather 选项收集的数据生成许可报告。指定供该实用程序用于报告的目录或目录列表。在使用 --report 操作时,必须使用 capacitytraditional 参数。

--retry

重新运行收集操作,并尝试重新连接到收集过程中失败的主机(由收集目录中的信息确定)。当报告多个主机无法访问时,此操作对传统许可模型很有用。

--version

返回该命令的版本。此选项用于识别运行该命令的最新 NetBackup 产品版本。版本字符串还可指示该实用程序的特殊版本,例如工程二进制文件。如果实用程序被手动复制到 7.1 版本之前的主服务器,则此选项很有用。

选项

--bpimagelist

用于在该过程的 gather 阶段将特定选项传递给 bpimagelist 命令。

--capacity

指定要与 gatherreport 结合使用的许可模型。使用 capacity 可根据 NetBackup 的每 TB 容量许可模型来报告部署情况。

--client 或 --clientlist

仅收集或报告所指定的某个或一系列客户端的数据。使用 client 时,请以逗号分隔多个客户端。要使用 clientlist 参数,请在 filename 中在不同的行上列出各个客户端。当您使用 --client--clientlist 选项时,报告可能会将某些介质服务器显示为无法连接,即使实用程序可以连接到这些服务器。此问题不会影响摘要信息。

--day-boundary

改变用于创建报告的报告窗口的起始时间。默认的报告窗口从午夜开始并运行到晚上 11:59:59。请以 24 小时表示法将 time 值指定为 hh:mm,其中,早上 6:00 表示为 06:00,晚上 6:00 表示为 18:00

--dirsfile

一个包含目录列表的文件,report 参数将使用这些目录生成报告。此参数是在 report 参数后列出所有文件的替代方法。您还可以使用 parentdir 参数列出供 report 参数使用的父目录。

--end

指定收集期限的受限日期范围的结束日期。此选项只能与 start 选项结合使用。此参数的格式为 "MM/DD/YYYY hh:mm:ss"。以 24 小时表示法指定时间值 hh:mm:ss,其中,早上 6:00 表示为 06:00:00,晚上 6:00 表示为 18:00:00。日期时间值必须用双引号括起来。

--hoursago

更改映像收集时间间隔的默认值。以小时为单位指定该值。默认值为 2160 小时(90 天)。

--log

将日志强制输出到特定的日志文件。默认情况下,日志输出会写入所收集的数据和报告的存储目录中的日志文件。

--master

收集指定主服务器的容量授权数据。此选项只能与 --gather 结合使用。要使本地主机能够从远程服务器收集数据,主机名必须显示在该远程服务器的服务器列表中。

此选项仅支持远程收集的容量授权信息,不支持远程收集的传统授权数据。

--nolog

禁止创建调试日志文件。

--output

将结果保存在所指定的输出目录中。只能指定包含基本 ASCII 字符的目录。不支持带有扩展 ASCII 字符的目录。如果操作是 gather,则输出目录将保存收集的数据。对于 report 操作,报告和日志文件将被置于输出目录中,而不是与收集的数据一起位于指定的输入目录中。如果未指定 output 选项,则输出内容将被置于以下目录:

  • 对于 UNIX: /usr/openv/var/global/reports/ YYYYMMDD_hhmmss_masterserver

  • 对于 Windows: install_path\ VERITAS\netbackup\var\global\reports\YYYYMMDD_hhmmss_masterserver

--overlap-details

显示容量许可报告的“重复的选择项”列中的重复备份选择项。此选项仅可用于 ASCII 或备份选择数据中的仅限英文字符。

--parentdir

指定目录树的顶层目录(目录树中包含许多目录,这些目录内有收集的许可数据),report 参数应使用这些数据生成报告。您也可以使用 dirsfile 参数指定一个包含目录列表的文件。

--runtimestats

显示实用程序的运行时统计数据。统计数据包括内存和 CPU 使用情况。

UNIX 输出示例:

stats  mem 40.1 M, cpu 27.0% after splitting t/fixture/
nbdeployutil_sidon/bpimagelist_sidon.out
stats  mem 40.1 M, cpu 28.0% after parsing records from t/fixture/
nbdeployutil_sidon/tmp/policy_db_arc_tab_2gig_nt_client_totem7.out
stats  mem 40.6 M, cpu 50.0% after calculating for UNKNOWN-1 in 
t/fixture/nbdeployutil_sidon/ stats  mem 40.6 M, cpu 51.0% after 
main report loop took 1 sec
--start

指定收集期限的受限日期范围的开始日期。此参数的格式为 "MM/DD/YYYY hh:mm:ss"。以 24 小时表示法指定时间值 hh:mm:ss,其中,早上 6:00 表示为 06:00:00,晚上 6:00 表示为 18:00:00。请注意,日期时间值两边的双引号是必需的。

--traditional

gatherreport 结合使用,用以指定许可模型。使用 --traditional 可根据 NetBackup 的每服务器传统授权模型来报告部署情况。默认值为 2160 小时(90 天)。

--verbose

将实用程序的详细进度信息输出到屏幕,这对调试日志文件中的信息没有影响。该日志文件的内容始终很详细。

先决条件

nbdeployutil 实用程序的前提条件如下:

  • 主服务器后台驻留程序或服务必须在环境中运行,才能收集数据。

  • 确认运行 gather 命令的主服务器上有足够的磁盘空间。收集容量许可数据时,将会收集前 90 天的 bpimagelist 输出。输出大小是目录库中该期限内的映像数的函数。可以移动或缩小默认时间段。分析时间较短将导致数字不准确或不完整。

  • 查看报告需要使用 Microsoft Excel。不必在主服务器上安装该软件。

示例

示例 1 - 为 NetBackup 的容量许可模型和传统许可模型创建部署分析报告。目录路径是 Windows 系统的,但此示例也适用于 UNIX 系统。

# nbdeployutil --gather
NetBackup Deployment Utility, version 7.1.0000.0000
Gathering license deployment information...
  Discovered master server marybl2g1
  Output for marybl2g1 at: D:\Program Files\VERITAS\netbackup\
  var\global\reports\20101029_170534_marybl2g1
Gather DONE
Execution time: 1 min
To create a report for this master server, run the following:
  nbdeployutil.exe --report "D:\Program Files\VERITAS\netbackup\
  var\global\reports\20101029_170534_marybl2g1"

D:\>nbdeployutil.exe --report --traditional "D:\Program Files\
VERITAS\netbackup\var\global\reports\
20101029_170534_marybl2g1"
NetBackup Deployment Utility, version 7.1.0000.0000
Analyzing license deployment for master marybl2g1 ...
  Report created at: D:\Program Files\VERITAS\netbackup\var\global\
  reports\20101029_170534_marybl2g1\report-20101029_170705.xls
Analysis DONE
Execution time: 27 secs

示例 2 - 目标部署容量分析。该命令在非默认时段内收集一部分客户端的数据。目录路径是 Windows 系统的,但此示例也适用于 UNIX 系统。

# nbdeployutil.exe --gather --output pickedclient --start "11/01/10 
06:00:00" --end "11/02/10 01:00:00" --clients marybl2g1,marybl7g1  /
--verbose NetBackup Deployment Utility, version 7.1.0000.0000
Gathering license deployment information...
run: bpgetconfig
  Discovered master server marybl2g1
run: bpimagelist -M marybl2g1 -d "11/01/10 06:00:00" -e "11/02/10 
01:00:00" -l -client marybl2g1
run: bpimagelist -M marybl2g1 -d "11/01/10 06:00:00" -e "11/02/10 
01:00:00" -l -client marybl7g1
  Output for marybl2g1 at: pickedclient\20101102_155246_marybl2g1
Gather DONE
Execution time: 4 secs
To create a report for this master server, run the following:
  nbdeployutil.exe --report "pickedclient\20101102_155246_marybl2g1"

D:\># nbdeployutil.exe --report --capacity pickedclient\
20101102_154010_marybl2g1 --start "11/01/10 06:00:00" 
--end "11/02/10 01:00:00" --clients marybl2g1,
marybl7g1 --verbose
NetBackup Deployment Utility, version 7.1.0000.0000
Analyzing license deployment ...
  Master marybl2g1
  Report created at: pickedclient\20101102_154010_marybl2g1\
  report-20101102_155414.xls
Analysis DONE
Execution time: 2 secs

另请参见

请参见bpimagelist(1m)。