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

名称

bpverify — 验证由 NetBackup 创建的备份

大纲

bpverify [-l] [-p] [-pb] [-v] [-local] [-client name] [-st sched_type] [-sl sched_label] [-L output_file [-en]] [-policy name] [-s date] [-e date] [-M master_server] [-Bidfile file_name] [-pt policy_type] [-hoursago hours] [[-cn copy number] | [-primary]] [-backupid backup_id] [[-id media_id or path] | [-stype server_type] [-dp disk_pool_name [-dv disk_volume]]] [-priority number]

 

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

On Windows systems, the directory path to this command is install_path\NetBackup\bin\admincmd\

描述

bpverify 通过读取备份卷,并将其内容与 NetBackup 目录库进行比较来验证一个或多个备份的内容。该操作并不将卷数据与客户端磁盘的内容进行比较。它读取映像中的每个块以验证卷是否为可读。NetBackup 一次只验证一个备份,并尝试最大限度地缩短介质装入和定位时间。

如果指定了 -Bidfile-backupid,则在选择要验证的备份集时,bpverify 将该选项作为唯一的条件。如果没有在命令行中指定 -Bidfile-backupidbpverify 将选择满足所有选项的备份。例如,如果命令行类似于以下内容:

bpverify -pt Standard -hoursago 10

bpverify 将验证在过去 10 小时内运行且具有 Standard 策略类型的备份集。

如果指定了 -p-pbbpverify 将预览满足选择条件的备份集。将显示备份 ID,但并不执行验证。

bpverify 会将其错误消息发送到 stderr。该命令会将其当天的活动日志发送到位于以下目录的 NetBackup 管理日志文件:

UNIX 系统:

/usr/openv/netbackup/logs/admin

Windows 系统:

install_path\NetBackup\Logs\admin

任何得到授权的用户均可运行此命令。

有关 NetBackup 授权的详细信息,请参见《NetBackup 安全和加密指南》

选项

-backupid backup_id

指定要验证的单个备份的备份 ID。除 -Bidfile 以外,该选项优先于任何其他选择条件。默认为任何备份。

-Bidfile file_name

指定一个包含要验证的备份 ID 列表的文件。此文件会在命令行界面 (CLI) 激活期间删除。删除文件的原因是 NetBackup GUI 经常使用此参数。而这些 GUI 要求该命令行界面在操作完成后删除用于 -Bidfile 选项的临时文件。命令行界面的直接用户也可以使用此选项,但是此选项将删除该文件。

在该文件中,一个备份 ID 占一行。如果指定该选项,则忽略其他的选择条件。默认为没有备份 ID 的文件,表示可以验证任何备份。

-client name

指定生成原始备份的客户端的名称。默认为任何客户端。

-cn copy_number | -primary

确定要验证的备份 ID 的副本号。有效值为从 1 到 bpconfig -max_copies 设置所指定的设置,最大值为 10。默认值为 1。

-primary 指示应验证主副本而不是该副本。

-dp disk_pool_name [-dv disk_volume]

指定磁盘池的名称。磁盘池是该存储单元的数据存储区域。另外,bpverify 仅验证驻留在指定磁盘卷上的映像。该选项必须与 -stype 选项一起使用。磁盘池必须已存在。

-hoursago hours

从当前时间算起,指定要搜索此前多少小时之内的备份。这相当于将开始时间 (-s) 指定为当前时间减去 hours 值。不要将该选项与 -s 选项一起使用。

Hours 值是一个非负整数。默认的开始时间为 24 小时前。

-id media_id | path

在映像目录库中搜索备份,以验证它们是否位于此介质 ID 或路径名上。如果备份的一些片段位于该介质 ID 上,而另一些片段位于其他介质 ID 上,则会发生以下情况:只要在所提供的介质 ID 的介质上开始备份,NetBackup 便会对跨介质映像进行验证。

对于存储在磁盘而非可移动介质上的映像,需要指定绝对路径名而不是 media_id。默认为任何介质 ID 或路径名。BasicDisk 使用此选项。

-L output_file [-en]

指定要在其中写入进度信息的文件的名称。默认为不使用进度文件,在这种情况下,将进度信息写入 stderr。有关更多信息,请参见此命令说明后面介绍的“显示格式”。

UNIX 系统示例路径:/usr/openv/netbackup/logs/user_ops

Windows 系统示例路径: c:\Program Files\Veritas\NetBackup\logs\user_ops

使用 -en 选项可生成英文的日志条目。日志名称中包含字符串 _en。在分布式环境中,不同的语言环境可能创建不同语言的日志,此时该选项对于支持人员很有用。

仅允许对此选项使用默认路径,建议使用默认路径。如果无法在您的设置中使用 NetBackup 默认路径,应向 NetBackup 配置中添加自定义路径。

有关如何添加自定义路径的更多信息,请参见 NetBackup 管理指南,第 I 卷中的“NetBackup 服务器和客户端的 BPCD_ALLOWED_PATH 选项”主题。

-l

指定列表类型为长列表,以使 bpverify 向进度日志中写入附加信息。默认列表类型为短列表。有关附加信息,请参见此命令说明后面介绍的“显示格式”。

-local

如果从主服务器以外的主机启动 bpverify,并且没有使用 -local(默认),则发生以下情况:bpverify 在主服务器上启动该命令的远程副本。

该远程副本允许从活动监视器终止该命令。

使用 -local 可禁止在主服务器上创建远程副本,并且仅从启动 bpverify 的主机上运行它。

如果使用了 -local 选项,将无法从活动监视器中取消 bpverify

-M master_server

指定提供 bpverify 映像数据的主服务器。主服务器必须允许发出 bpverify 命令的系统对其进行访问。默认为输入 bpverify 的系统的主服务器:

对于 NetBackup 服务器:

默认值始终是输入该命令的主服务器。

对于 NetBackup Enterprise Server:

如果在主服务器上输入该命令,则该服务器为默认服务器。

如果在远程介质服务器上输入该命令,则该介质服务器的主服务器为默认服务器。

-p

预览验证,但并不执行验证。有关附加信息,请参见此命令说明后面介绍的“显示格式”。

-pb

预览验证,但并不执行验证。-pb 选项类似于 -p 选项,但前者不显示各备份的信息。有关附加信息,请参见此命令说明后面介绍的“显示格式”。

-policy name

在指定策略中搜索要验证的备份。默认为任何策略。

-priority number

为验证作业指定一个新优先级来覆盖默认作业优先级。

-pt policy_type

指定选择要验证的备份时使用的策略类型。默认值为任意策略类型。

有效的策略类型包括:

BigData
DataStore
DataTools-SQL-BackTrack
DB2
Enterprise-Vault
FlashBackup
Hyper-V
Informix-On-BAR
Lotus-Notes
MS-Exchange-Server
MS-SharePoint
MS-SQL-Server
MS-Windows
NBU-Catalog
NDMP
Oracle
SAP
Split-Mirror
Standard
Sybase
Universal-share
Vault
VMware
-s date, -e date

为所有要验证的备份指定日期和时间范围的开始时间。-e 选项指定范围的截止时间。

NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。/usr/openv/msg/.conf 文件 (UNIX) 和 install_path\VERITAS\msg\LC.CONF 文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。

请参见《NetBackup 管理指南,第 II 卷》 中的“关于指定 NetBackup 安装的区域设置”。

有效的日期范围为 01/01/1970 00:00:00 到 01/19/2038 03:14:07。默认的开始时间为 24 小时前。默认的截止时间为当前的日期和时间。

-sl sched_label

搜索备份以验证指定的日程表已创建。默认值为所有日程表。

-st sched_type

搜索备份以验证指定的日程表类型已创建。默认值为任意日程表类型。

有效值包括:

FULL(完全备份)

INCR(差异增量式备份)

CINC(累积增量式备份)

UBAK(用户备份)

UARC(用户存档)

NOT_ARCHIVE(除用户存档之外的所有备份)

-stype server_type

指定标识存储服务器类型的字符串。server_type 值可能源自以下来源之一:

  • Veritas 提供的存储。可能的值有 AdvancedDiskPureDisk

  • 第三方磁盘设备。供应商提供了 server_type 字符串。

  • 云存储。使用 csconfig cldprovider -l 命令确定可能的 stype 值。云 stype 值反映了云存储提供程序。云存储 stype 值还可包含一个后缀(例如 amazon_crypt)。可能的后缀是:

    • _raw:将具有原始格式的 NetBackup 备份映像发送至云。如果您在将数据发送至云存储前不需要压缩或加密数据,则使用此选项。

    • _rawc:在将数据写入云存储之前压缩数据。

    • _crypt:在将数据写入云存储之前使用 AES-256 加密对此数据进行加密。要使用此选项,必须在 NetBackup 中配置 KMS。

    • _cryptc:将数据写入云存储之前压缩和加密数据。

存储服务器类型区分大小写。

-v

选择详细模式。如果指定了 -v,调试日志和进度日志将包含更多信息。默认为非详细模式。

显示格式

预览的显示内容:

bpverify 可以运行预览,采用的方法是搜索备份,然后按以下方式之一显示它们(bpverify 不验证备份):

  • -p 显示内容中列出了满足 bpverify 命令行选项所设条件的备份 ID。-p 信息按卷顺序显示。对于包含所选备份的每个卷,都会列出介质 ID 和服务器。随后显示驻留在该卷上的所选备份 ID。

  • -pb 显示内容是 -p 显示内容的简要版本。对于包含满足选择条件的备份的每个卷,此选项将列出这些卷的介质 ID 和服务器。

验证的显示内容:

bpverify 在验证映像时创建这些显示内容。如果 bpverify 不包含用于设置列表格式的选项,则显示格式为短格式。如果命令行包含 -l,则显示格式为长格式。如果命令行同时包含 -l-L,则 bpverify 会创建一个包含进度日志的文件。

验证列表使用以下格式按卷顺序显示:

  • 在长格式中,bpverify 显示每个所选备份 ID 的以下信息:

    • 策略、日程表、备份 ID、介质 ID 或路径以及创建时间

    • 备份的文件

    • bpverify 在验证映像时检测到的任何问题

    • 映像验证是否成功

  • 在短格式中,bpverify 不列出备份的文件。

示例

示例 1 - 对过去 36 小时内运行的备份进行验证:

# bpverify -hoursago 36
      Verify started Thu Feb  3 11:30:29 2012
      INF - Verifying policy mkb_policy, schedule Full
  (plim_0949536546), path /tmp/mkbunit, created 02/02/12 18:09:06.
  INF - Verify of policy mkb_policy, schedule Full 
  (plim_0949536546) was successful.
  INF - Status = successfully verified 1 of 1 images.

示例 2 - 比较 -p-pb 这两种预览显示模式:

# bpverify -p -hoursago 2002
Media id = A00002  Server = plim
Bid = plim_0949616279  Kbytes = 32800  Filenum = 1   Fragment = 1
Bid = gava_0949681647  Kbytes = 12191  Filenum = 2   Fragment = 1
Bid = gava_0949683298  Kbytes = 161    Filenum = 3   Fragment = 1
Bid = gava_0949683671  Kbytes = 11417  Filenum = 4   Fragment = 1
Bid = gava_0949684009  Kbytes = 11611  Filenum = 5   Fragment = 1
Bid = gava_0949684276  Kbytes = 806    Filenum = 6   Fragment = 1
Bid = gava_0949688704  Kbytes = 9869   Filenum = 7   Fragment = 1
Bid = gava_0949688813  Kbytes = 9869   Filenum = 8   Fragment = 1
Bid = gava_0949949336  Kbytes = 10256  Filenum = 9   Fragment = 1
Bid = plim_0949949337  Kbytes = 6080   Filenum = 9   Fragment = 1
Bid = plim_0949949337  Kbytes = 4176   Filenum = 10  Fragment = 2
Bid = gava_0949949686  Kbytes = 10256  Filenum = 11  Fragment = 1
Bid = plim_0949949687  Kbytes = 5440   Filenum = 11  Fragment = 1
Bid = plim_0949949687  Kbytes = 4816   Filenum = 12  Fragment = 2

Media id = 400032  Server = plim
Bid = toaster2_0950199621 Kbytes = 298180 Filenum = 1 Fragment = 1
Bid = toaster2_0950199901 Kbytes = 298180 Filenum = 3 Fragment = 1

# bpverify -pb -hoursago 200
Media id = A00002  Server = plim
Media id = 400032  Server = plim

返回值

0 退出状态表示已成功运行命令。任何非 0 的退出状态都表示发生了错误。

如果启用了管理日志功能,bpverify 会将退出状态记录在日志目录下的每日管理日志中:

UNIX 系统:

/usr/openv/netbackup/logs/admin

Windows 系统:

install_path\NetBackup\logs\admin

它具有下列形式:

bpverify: EXIT status = exit status

如果出错,将在显示该消息之前进行诊断。

文件

UNIX 系统:

/usr/openv/netbackup/logs/admin/*
/usr/openv/netbackup/db/error/*
/usr/openv/netbackup/db/images/*

Windows 系统:

install_path\NetBackup\logs\admin\*
install_path\NetBackup\db\error\*
install_path\NetBackup\db\images\*