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

名称

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]

 

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

在 Windows 系统上,此命令的目录路径为 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。在分布式环境中,不同的语言环境可能创建不同语言的日志,此时该选项对于支持人员很有用。

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

有关如何添加自定义路径的更多信息,请参见 NetBackup 管理指南,第 I 卷中的“NetBackup 服务器和客户端的 BPCD_WHITELIST_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
PureDisk-Export
SAP
Split-Mirror
Standard
Sybase
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\*