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

名称

bpexpdate — 更改映像目录库中备份的截止日期以及介质目录库中介质的截止日期

大纲

bpexpdate -m media_id -d date | 0 | infinity [-host name] [-force] [-nodelete] [-notimmediate] [-force_not_complete] [-M master_server,...]

bpexpdate -deassignempty [-m media_id] [-force] [-M master_server,...]

bpexpdate -Bidfile filename | -backupid backup_id -d date | 0 | infinity [-client name] [-copy number] [-force] [-nodelete] [-notimmediate] [-force_not_complete] [-do_not_follow_dependee] [-M master_server,...] [-extend_worm_locks]

bpexpdate -servername servername -d date | 0 | infinity [-force] [-nodelete] [-notimmediate] [-force_not_complete] [-M master_server,...] [-extend_worm_locks]

bpexpdate -recalculate [-backupid backupid] [-copy number] [-d date | 0 | infinity] [-client name] [-policy name] [-ret retention_level] [-sched type] [-M master_server,...] [-extend_worm_locks]

bpexpdate -stype server_type [-dp disk_pool_name [-dv disk_volume]] [-nodelete] [-notimmediate] [-force_not_complete] [-M master_server,...]

 

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

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

描述

NetBackup 可维护目录库这一包含备份映像及介质信息的内部数据库。映像目录库中的映像记录以及介质目录库中的介质 ID 都包含截止日期。截止日期是指 NetBackup 从相应目录库中删除备份或介质 ID 记录的日期和时间。

bpexpdate 命令用于更改 NetBackup 映像目录库中备份的截止日期和时间。该命令还用于更改 NetBackup 介质目录库中可移动介质的截止日期。如果将该日期设置为零,bpexpdate 会立即使映像目录库中的备份或介质目录库中的介质失效。当从 NetBackup 介质目录库中删除介质 ID 时,无论此介质以前的状态如何(已冻结、已暂停等)。都会同时将其从企业介质管理器数据库中删除。

可以对一个介质 ID 或单个备份 ID 更改截止日期。在更改介质 ID 的截止日期时,此介质上所有备份的截止日期也会更改。bpexpdate 还提供下列选项:

  • 将不再包含有效备份的介质从介质目录库中删除。

  • 根据所配置或提供的保留级别重新计算截止日期。

某些 NetBackup 副本可能具有一写多读 (WORM) 属性。NetBackup 会尝试设置副本的 WORM 解锁时间,以与其 NetBackup 目录库的截止时间相匹配。延长 WORM 副本的截止时间时,NetBackup 会运行存储命令以增加 WORM 解锁时间。仅当使用 -extend_worm_locks 选项调用 bpexpdate 时,才允许延长此存储解锁时间。无法缩短 WORM 副本的截止时间。可以使用 -d 0 选项立即删除 WORM 副本。

设置 WORM 后,副本将永远无法再次写入。但是,在解锁时间过去之后,这些副本将变得可删除。

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

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

操作

命令操作如下所示:

-backupid backup_id

更改单个备份的截止日期。如果日期为零,则从映像目录库中删除备份。当备份位于可移动介质上时,如果 -d 截止日期超过了介质 ID 的当前截止日期,介质目录库的截止日期也将发生更改。除非使用 -copy 选项,否则这种更改将影响备份的所有副本。使用 -copy 选项将仅影响指定的副本。

-Bidfile filename

指定一个文件,该文件包含要更改其截止日期的备份 ID 列表。在该文件中,每行列出一个备份 ID。

-deassignempty

在目录库中搜索不再包含有效备份的可移动介质。然后将其从介质目录库中删除,并从介质管理器目录库中删除该介质 ID。然后,该介质将再次可供使用。可以使用 NetBackup 的“介质上的映像”报告来确定已分配的介质是否不再包含有效备份。

-recalculate

可以根据保留级别来更改备份的截止日期,也可以指定新的截止日期。可以更改单个备份的截止日期,或者更改特定客户端、策略或日程表类型的所有备份的截止日期。-bybackuptime-d-ret 选项之一可以与此选项一起使用。

使用 -bybackuptime 选项时,备份的截止日期设置为创建日期与最初用于备份的保留级别值之和。导入备份后,此选项可用于将其截止日期重置为原始值。

注意:

保留级别 25 的值为立即失效。不能编辑此值。如果将备份映像的保留级别设置为 25,则备份映像会立即失效。

使用 -ret 选项时,备份的截止日期设置为创建日期与指定的保留级别值之和。

如果 -bybackuptime-d-ret 不与此选项一起使用,则任何非存储生命周期策略 (SLP) 备份的截止日期均设置为创建日期与写入备份的日程表(如果该日程表已存在且其保留级别自备份创建以来已更改)的当前保留级别之和。在以下显示的任何情况下,不会重新计算备份的截止日期:

  • 备份由 SLP 创建。

  • 如果写入备份的策略和日程表不再存在。

  • 如果写入备份的日程表的保留级别自备份创建以来未发生更改。

当备份位于可移动介质上时,如果备份的新截止日期晚于当前介质截止日期,则介质的截止日期也会发生更改。

-servername server_name

指定截止日期发生改变时受到影响的服务器的名称。服务器名称指的是片段所在的映像片段记录的字段。该服务器是执行数据移动的介质服务器。对于快照,该服务器是快照所在的客户端。

-stype server_type

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

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

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

  • 云存储。云 stype 值反映了云存储提供程序。通过 csconfig 命令确定可能的值,如此处所示。粗体信息(加粗以进行强调)是指 -stype 选项必需的信息。请注意,可以基于当前支持的提供程序更改 csconfig 命令的输出。

    root:~# csconfig cldprovider -l amazon (Amazon - Simple Storage Service) amazongov (Amazon GovCloud - Simple Storage Service) azure (Microsoft Azure - Microsoft Azure Storage Service) cloudian (Cloudian HyperStore - Cloudian HyperStore Object Storage) google (Google Nearline - Google Cloud Storage Nearline) hitachi (Hitachi Cloud Service (HCS) - Hitachi Off Premise Public Cloud) hitachicp (Hitachi Content Platform (HCP) - Hitachi On Premise Private Cloud) swiftstack (SwiftStack - SwiftStack Object Storage) verizon (Verizon - Verizon Cloud Storage)

    云存储 stype 值必须包含一个后缀(例如 amazon_crypt)。可能的后缀是:

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

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

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

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

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

选项

-bybackuptime

指定截止日期设置为备份创建日期与用于备份的保留级别值之和。

-client name

指定 -backupid-recalculate 操作中使用的客户端名称。

对于 backupid 操作,该选项可使 NetBackup 首先搜索指定客户端的备份 ID。在已更改客户端名称的情况下,此选项非常有用。

对于 recalculate,该选项会使 NetBackup 基于所指定的全部客户端备份的保留级别重新计算截止日期。

-copy number

使指定的副本号失效或更改其截止日期。该选项仅与 -backupid-recalculate 选项一起使用时才有效。有效值介于 1 到 10 之间。

如果主副本失效,则另一个副本会变成主副本。如果未指定该选项,则截止日期同时影响备份的这两个副本。

-d date

指定截止日期和时间。date 可以是下面的任一值:

  • mm/dd/yy hh:mm:ss

  • 0 - 备份或介质立即失效

  • infinity - 备份将永不失效

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

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

-deassignempty

在目录库中搜索不再包含有效备份的可移动介质。这会将介质从介质目录库中删除。然后,该介质将再次可供使用。可以使用 NetBackup 的“介质上的映像”报告来确定已分配的介质是否不再包含有效备份。

-do_not_follow_dependee

默认情况下,当相关映像失效后,符合条件的被依赖者映像也将失效。-do_not_follow_dependee 选项将重写此行为,以便映像失效不会影响被依赖者映像。

-dp disk_pool_name -dv disk_volume

为要执行的截止日期操作指定磁盘池,也可以选择性指定磁盘卷。

-extend_worm_locks

使用 -extend_worm_locks 选项可延长 WORM 副本的截止日期。WORM 副本截止时间永远不能缩短。默认情况下,WORM 副本的截止时间不能延长。必须提供此选项才能延长 WORM 副本的截止时间。如果未指定 WORM 副本,则此选项将不起作用。

-force

在运行指定的操作前,bpexpdate 会先询问用户,然后再启动操作。该选项可强制 bpexpdate 命令不询问用户即执行操作。

-force_not_complete

默认情况下,如果 SLP 处理仍在进行中,无法使 SLP 管理的映像或其副本失效。-force_not_complete 选项仍将覆盖此限制并使映像失效,即使它不是 SLP 完整映像也会如此。请注意,当您终止对该映像执行进一步 SLP 处理时,其他映像副本也会失效。

-host name

注意:

对于 NetBackup 服务器,由于仅有一台服务器(主服务器),因此不需要使用此选项。如果您确实要使用此选项,请指定该服务器的主机名。

指定将介质分配到的服务器的主机名。此选项只能与 -m media_id 选项一起使用,且只有在满足下列条件时才能使用:主服务器具有远程介质服务器且未在运行 bpexpdate 的服务器上写入卷。

例如,假设主服务器名为 whale,介质服务器名为 eel。在 whale 上运行下面的命令,即可手动从介质目录库中删除介质 ID BU0001,并从映像目录库中删除所有相应的备份:

bpexpdate -m BU0001 -d 0 -host eel

可以使用 NetBackup 的“介质列表”报告来确定哪个服务器的介质目录库包含该卷。

-m media_id

检查此特定介质 ID 上是否存在有效的备份。此选项只能与 -deassignempty 选项结合使用。介质 ID 必须是 6 个或更少的字符,且必须位于 NetBackup 介质目录库中。

-M master_server [,...]

指定用于管理具有该介质 ID 的介质目录库的主服务器。如果未指定该选项,则默认值为以下服务器之一:

对于 NetBackup 服务器:

NetBackup 服务器仅支持一台没有远程介质服务器的服务器(主服务器)。因此,在这种情况下,默认值始终为运行该命令的主服务器。

对于 NetBackup Enterprise Server:

如果在主服务器上运行该命令,则该服务器为默认服务器。如果在不是主服务器的介质服务器上运行该命令,则该介质服务器的主服务器为默认服务器。

-nodelete

将备份从映像目录库中删除,但并不将其从磁盘存储器中删除。当您取消从一台主服务器导入某个磁盘组并将该磁盘组导入到另一台主服务器上时,可以使用此选项。

-notimmediate

bpexpdate 使磁盘上的映像失效后,禁止该命令调用 nbdelete 命令。如果您打算同时删除多个映像,可使用 -notimmediate,以避免因处理 nbdelete 而创建多个作业所致的开销。可以以后运行 nbdelete 命令。

-policy name

指定策略名。该选项与 -recalculate 选项一起使用时才有效。如果指定了策略名,将根据在该策略中创建的所有备份的保留级别重新计算截止日期。

-recalculate

可以根据指定的保留级别来更改备份的截止日期,也可以指定新的截止日期。必须将此选项与 -d-ret 选项一起指定。根据保留级别更改截止日期时,新日期将基于备份的创建日期与保留级别值的和。可以更改单个备份的截止日期,或者更改特定客户端、策略或日程表类型的所有备份的截止日期。

当备份位于可移动介质上时,如果该命令中的截止日期超过了当前的截止日期,则介质目录库中的截止日期会发生更改。

-ret retention_level

指定重新计算截止日期时将使用的保留级别。该选项与 -recalculate 选项一起使用时才有效。级别的范围为 0 到 100。新的截止日期为备份的创建日期与此保留级别之和。您必须将该选项与 -backupid-policy 一起指定。

注意:

如果在 8.0 版本之前的 NetBackup 介质服务器上运行此命令,则只能指定介于 0 到 24 之间的保留级别。

-sched type

指定日程表类型。该选项与 -recalculate 选项一起使用时才有效。如果指定了类型,将根据针对该日程表类型创建的所有备份的保留级别重新计算截止日期。可输入如下所示的类型数值:

0 = 完全备份

1 = 差异增量式备份

2 = 用户备份

3 = 用户存档

4 = 累积增量式备份

必须将 -policy 选项与 -sched 一起指定。

说明

在大型环境中,有些选项所执行的操作可能需要相当长的时间才能完成。使备份或介质失效的更改操作是不能取消的。如果使用该命令时出错,可能需要导入备份或恢复目录库的以前版本。

示例

示例 1 - 下面的命令在主服务器上运行,它从介质目录库中删除介质 ID BU0002。并在介质管理器目录库中取消对该介质 ID 的分配。它还使映像目录库中的关联映像记录失效。

# bpexpdate -m BU0002 -d 0

示例 2 - 更改备份 backupid eel_0904219764 的副本 2 的截止日期。该备份的副本 1 的截止日期不受影响。

# bpexpdate -backupid eel_0904219764 -d 12/20/2012 08:00:00 -copy 2

示例 3 - 从映像目录库中删除备份。由于未指定 -copy 选项,因此将删除所有副本。

# bpexpdate -backupid eel_0904219764 -d 0

示例 4 - 在主机 cat 的介质目录库中查找仍处于已分配状态但不再包含有效备份的介质。此命令将从目录库中删除任何此类介质,并在介质管理器目录库中取消分配该类介质。

# bpexpdate -deassignempty -host cat

示例 5 - 将备份 ID 1234 的截止日期重新计算为 2012 年 10 月 31 日。

# bpexpdate -recalculate -backupid 1234 -d 10/31/12

示例 6 - 根据保留级别重新计算备份 ID 1234 的截止日期。新的保留级别为 4,即两个月(默认值)。现在,备份 ID 1234 预定在 2 个月后失效。

# bpexpdate -recalculate -backupid 1234 -ret 4 

文件

UNIX 系统:

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

Windows 系统:

install_path\NetBackup\logs\admin\* install_path\NetBackup\db\media\* nstall_path\NetBackup\db\images\*