Veritas NetBackup™ 命令参考指南

Last Published:
Product(s): NetBackup (8.3)
  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.  
      configureCerts
    85.  
      configureCertsForPlugins
    86.  
      configureMQ
    87.  
      configurePorts
    88.  
      configureWebServerCerts
    89.  
      create_nbdb
    90.  
      csconfig cldinstance
    91.  
      csconfig cldprovider
    92.  
      csconfig meter
    93.  
      csconfig throttle
    94.  
      csconfig reinitialize
    95.  
      duplicatetrace
    96.  
      importtrace
    97.  
      jbpSA
    98.  
      jnbSA
    99.  
      ltid
    100.  
      manageClientCerts
    101.  
      mklogdir
    102.  
      nbauditreport
    103.  
      nbcatsync
    104.  
      NBCC
    105.  
      NBCCR
    106.  
      nbcertcmd
    107.  
      nbcertupdater
    108.  
      nbcldutil
    109.  
      nbcloudrestore
    110.  
      nbcomponentupdate
    111.  
      nbcplogs
    112.  
      nbcredkeyutil
    113.  
      nbdb_admin
    114.  
      nbdb_backup
    115.  
      nbdb_move
    116.  
      nbdb_ping
    117.  
      nbdb_restore
    118.  
      nbdb_unload
    119.  
      nbdb2adutl
    120.  
      nbdbms_start_server
    121.  
      nbdbms_start_stop
    122.  
      nbdc
    123.  
      nbdecommission
    124.  
      nbdelete
    125.  
      nbdeployutil
    126.  
      nbdevconfig
    127.  
      nbdevquery
    128.  
      nbdiscover
    129.  
      nbdna
    130.  
      nbemm
    131.  
      nbemmcmd
    132.  
      nbfindfile
    133.  
      nbfirescan
    134.  
      nbftadm
    135.  
      nbftconfig
    136.  
      nbgetconfig
    137.  
      nbhba
    138.  
      nbholdutil
    139.  
      nbhostidentity
    140.  
      nbhostmgmt
    141.  
      nbhypervtool
    142.  
      nbidpcmd
    143.  
      nbimageshare
    144.  
      nbinstallcmd
    145.  
      nbjm
    146.  
      nbkmiputil
    147.  
      nbkmscmd
    148.  
      nbkmsutil
    149.  
      nboraadm
    150.  
      nborair
    151.  
      nbpem
    152.  
      nbpemreq
    153.  
      nbmlb
    154.  
      nbperfchk
    155.  
      nbplupgrade
    156.  
      nbrb
    157.  
      nbrbutil
    158.  
      nbregopsc
    159.  
      nbreplicate
    160.  
      nbrepo
    161.  
      nbrestorevm
    162.  
      nbseccmd
    163.  
      nbsetconfig
    164.  
      nbsnapimport
    165.  
      nbsnapreplicate
    166.  
      nbsqladm
    167.  
      nbstl
    168.  
      nbstlutil
    169.  
      nbstop
    170.  
      nbsu
    171.  
      nbsvrgrp
    172.  
      resilient_clients
    173.  
      restoretrace
    174.  
      stopltid
    175.  
      tldd
    176.  
      tldcd
    177.  
      tpautoconf
    178.  
      tpclean
    179.  
      tpconfig
    180.  
      tpext
    181.  
      tpreq
    182.  
      tpunmount
    183.  
      verifytrace
    184.  
      vltadm
    185.  
      vltcontainers
    186.  
      vlteject
    187.  
      vltinject
    188.  
      vltoffsitemedia
    189.  
      vltopmenu
    190.  
      vltrun
    191.  
      vmadd
    192.  
      vmchange
    193.  
      vmcheckxxx
    194.  
      vmd
    195.  
      vmdelete
    196.  
      vmoprcmd
    197.  
      vmphyinv
    198.  
      vmpool
    199.  
      vmquery
    200.  
      vmrule
    201.  
      vmupdate
    202.  
      vnetd
    203.  
      vssat
    204.  
      vwcp_manage
    205.  
      vxlogcfg
    206.  
      vxlogmgr
    207.  
      vxlogview
    208.  
      W2KOption
  3.  
    索引

名称

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 将根据指定的频率运行,以增量方式收集数据并生成基于容量的许可报告。有关如何启用和使用该功能的更多信息,请参见 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\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)。