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.  
    索引

名称

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。在分布式环境中,不同的语言环境可能创建不同语言的日志,此时该选项对于支持人员很有用。

仅允许对此选项使用默认路径,建议使用默认路径。如果无法在您的设置中使用 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\*