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

名称

bpplinclude — 维护由 NetBackup 策略自动备份的文件列表

大纲

bpplincludepolicy_name [-v] [-M master_server,...] -L | -l [-generation generation] [-exclude_volumes]

bpplincludepolicy_name [-v] [-M master_server,...] [-generation generation] -add pathname or directive ... | -add -f filename | -addtoquery query_string... -addtoquery -f filename | -delete pathname or directive ... | -delete -f filename | -deletefromquery query_string... | -deletefromquery -f filename | -modify old_pathname new_pathname ... [-reason "string"] [-exclude_volumes]

 

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

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

描述

bpplinclude 维护 NetBackup 策略的策略文件列表。策略文件列表是 NetBackup 为策略运行自动备份时备份的文件列表。策略文件列表不适用于用户备份或存档,原因是用户在开始执行这些操作时会选择这些文件。

bpplinclude 执行以下操作之一:

  • 将指定路径名添加到策略文件列表中

  • 从策略文件列表中删除路径名

  • 修改策略文件列表中的路径名

  • 显示策略的策略文件列表

  • 从策略中排除指定的卷。此选项仅适用于 NAS-Data-Protection 策略类型。

对于大多数策略,-add-delete-modify 选项包括一个路径名列表。路径名列表必须是 bpplinclude 命令行的最后一部分。路径名必须是从文件系统的根到所需位置的完整路径。

有关客户端类型的路径名语法,请参见《NetBackup 管理指南,第 I 卷》

路径的最后一部分可以是文件名、目录名或通配符指定项。可以将路径名放在引号内。如果路径名包含特殊字符或通配符指定项,则必须使用引号。

文件路径规则不检验输入目录或文件是否存在。NetBackup 只备份它找到的文件,并且不要求列表中的所有条目都存在于每个客户端上。

对于大多数数据库代理,输入条目是脚本或指令。有关其他信息,请参见数据库代理产品附带的 NetBackup 指南。另请参见 -add pathname 选项。

添加到策略文件列表的条目可以是某些策略属性(例如“允许多个数据流”)和附加产品(例如 NetBackup for NDMP)的指令,但不能是它们的路径名。

请参见《NetBackup 管理指南,第 I 卷》或针对扩展产品的 NetBackup 指南。

选项 -l-L 显示的策略文件列表几乎相同。

bpplinclude 将它的错误消息发送到 stderr并将它的活动日志发送到当天的 NetBackup 管理日志文件中。

授权用户可启动此命令。

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

注意:

不建议用户修改或删除自动管理的策略。

如果用户修改策略,则必须确保策略继续满足保护计划定义的服务级别目标。

如果用户删除策略,则必须确保将资产添加到满足服务级别目标的其他保护计划。

选项

-add pathname ...

将指定的 pathname 添加到策略文件列表中。pathname 可以是目录、文件名、脚本或指令。

如果路径名包含特殊字符(如空格“ ”)或通配符指定项,则必须将路径名放在引号 (") 内。请使用空格而不是逗号来分隔两个路径名。bpplinclude 将逗号解释为路径名的一部分;因此,会将两个或多个以逗号分隔的路径名连接成包含内嵌逗号的单个路径名。该命令不验证路径名的语法或路径名是否存在。

对于 MS-SQL-Server 智能策略,此选项会将 SQL Server 对象添加到备份选定项中。有效值为 WHOLE_DATABASE、文件组的名称或文件的名称。WHOLE_DATABASE 将备份 SQL Server 实例中的所有数据库。如果添加的是文件组或文件,则所有数据库都会在包含同名文件组或文件的策略中添加该对象。使用 bpplclients 命令可配置为策略配置的实例和数据库的列表。

对于 NAS-Data-Protection 策略,可以按照以下格式指定备份选择:

nfs:<array>StorageArrayIPAddress</array><nas_head>Filer_or_NAS_Server </nas_head><nas_share./volume_name</nas_share>"

示例:

NetApp:nfs:<array>10.0.0.1</array><nas_head>ExampleNAS</nas_head><nas_share> /nas_share_01</nas_share> Nutanix AFS:nfs:<array>Example.company.com</array><nas_head>EXAMPLE_AFS</nas_head> <nas_share>/afs_share_01</nas_share>
-add -f filename

filename 中列出的所有文件添加到策略文件列表中。

-addtoquery query_string...

将指定的查询字符串添加到策略查询规则的末尾,或者如果不存在任何查询,则创建一个查询。引号 (") 必须通过反斜杠 (\) 进行转义。

有关更多详细信息和示例,请参考《适用于 VMware 的 NetBackup 指南》。

-addtoquery -f filename

将指定文件中的条目添加到查询规则中,或者如果不存在任何查询,则创建一个查询。在该文件中,引号 (") 无需转义。

有关更多详细信息和示例,请参考《适用于 VMware 的 NetBackup 指南》。

-delete pathname ...

从策略文件列表中删除指定路径名、文件名、脚本或指令。有关路径名列表的语法,请参考 -add。即使从策略文件列表中删除了某一项,仍然可以恢复该项的所有备份或存档。该选项必须是命令行中的最后一个条目。

-delete -f filename

filename 中的指定文件从策略文件列表中删除。

-deletefromquery query_string...

从策略查询规则中删除指定的查询字符串。

有关更多详细信息和示例,请参考《适用于 VMware 的 NetBackup 指南》。

-deletefromquery -f filename

从查询规则中删除文件条目。

有关更多详细信息和示例,请参考《适用于 VMware 的 NetBackup 指南》。

-exclude_volumes

在执行策略时,不会备份指定的卷。目前,仅适用于 NAS-Data-Protection 策略。

-generation generation

确保命令作用于特定的某一代或某一版本的策略。策略每保存一次,代值就递增一次。使用 bpplinfobppllist 可列出当前代值。如果未指示任何代值,则此命令将作用于当前版本。

-L

以长格式显示策略文件列表的内容。

-l

以简明格式显示策略文件列表的内容。

注意:

-l-L 显示的内容相似。

-modify {old_path_name new_path_name}

修改策略文件列表中的条目。这些值是路径名对列表,形式为 {old_path_name new_path_name}。对于每个路径名对,new_name_path 在策略文件列表中取代 old_name_path。如果没有与 old_path_name 匹配的列表条目,则不会将 new_path_name 输入到策略文件列表中。有关路径名语法,请参考 -add 选项。在路径名对内部以及路径名对之间,使用空格分隔列表条目。该选项必须是命令行中的最后一个条目。

-M master_server,...

主服务器的列表。这是一个以逗号分隔的主机名列表。如果包含该选项,将在该列表中的每一台主服务器上运行该命令。主服务器必须允许发出该命令的系统对其进行访问。如果任何主服务器发生错误,将在列表中的该主服务器位置处停止处理。默认为输入该命令的系统的主服务器。

policy_name

指定要为其设置策略文件列表的策略。

-reason "string"

指示您选择此命令操作的原因。您输入的原因文本字符串将被捕获并显示在审核报告中。用双引号 ("...") 将此字符串括起来。该字符串不能超过 512 个字符。该字符串不能以短划线字符 (-) 开头,也不能包含单引号 (')。

-v

为日志记录选择详细模式。仅在调试日志功能时处于启用状态(即定义了以下目录)的情况下运行该选项才有意义:

UNIX 系统:

/usr/openv/netbackup/logs/admin

Windows 系统:

install_path\NetBackup\logs\admin

示例

示例 1 - 在另一台主服务器 kiwi 上运行备份时,显示主服务器 plim 上策略 oprdoc_policy 的策略文件列表:

# bpplinclude oprdoc_policy -L -M plim
Include: /oprdoc (UNIX systems)
Include: c:\oprdoc (Windows systems)

示例 2 - 添加和删除包括一个通配符条目的路径名,以说明 bpplinclude 对通配符的解释:

UNIX 系统:

# bpplinclude mkbpolicy -add /yap /y* # bpplinclude mkbpolicy -L Include: yap Include: /y* # bpplinclude mkbpolicy -delete /y* # bpplinclude mkbpolicy -L Include: /yap

Windows 系统:

# bpplinclude mkbpolicy -add C:\yap C:\y* # bpplinclude mkbpolicy -L Include: C:\yap Include: C:\y*/y* # bpplinclude mkbpolicy -delete C:\y* # bpplinclude mkbpolicy -L Include: C:\yap

注意:

bpplinclude 不会将 -delete 的通配符条目 y* 解释为 yapy* 都应该删除。而只是将 y*mkbpolicy 的包括列表中删除。在实际备份期间,当 NetBackup 选择要备份的文件时,便会解释通配符。

示例 3 - 将下面两个条目添加到某个策略的策略文件列表中,然后修改它们:

UNIX 系统:

# bpplinclude mkbpolicy -add "/ima file" "/ura file" # bpplinclude mkbpolicy -L Include: /ima file Include: /ura file bpplinclude mkbpolicy -modify "/ima file" "/ima file 2" "/ura file" "/ura file 2" bpplinclude mkbpolicy -L Include: /ima file 2 Include: /ura file 2

Windows 系统:

# bpplinclude mkbpolicy -add "C:\ima file" "C:\ura file" # bpplinclude mkbpolicy -L Include: C:\ima file Include: C:\ura file # bpplinclude mkbpolicy -modify "C:\ima file" "C:\ima file 2" "C:\ura file" "C:\ura file 2" # bpplinclude mkbpolicy -L Include: C:\ima file 2 Include: C:\ura file 2

示例 4 - 将原始分区添加到策略 rc(UNIX 客户端)的策略文件列表中。使用设备的完整路径名(命令全部位于一行):

bpplinclude rc -add /devices/sbus@2,0/dma@2,81000/esp@2,80000/ sd@6,0:h,raw

有关 UNIX 原始分区的更多信息,请参见《NetBackup 管理指南,第 I 卷》

示例 5 - 显示策略 mkb_policy 的策略文件列表:

# bpplinclude mkb_policy -l

UNIX 系统:

INCLUDE /etc/services INCLUDE /etc/aliases INCLUDE /usr/bin

Windows 系统:

INCLUDE C:\services INCLUDE C:\aliases INCLUDE C:\Programs

示例 6 - 将 vm17 添加到 policy1 的查询规则中的值列表中。

# bpplinclude policy1 -addtoquery ,\"vm17\"

示例 7 - 从策略中删除查询。

# bpplinclude policy1 -deletefromquery -f qfile1

示例 8 - 将 SQL Server 文件组添加到策略文件列表中。

# bpplinclude sql_policy -add FG1

文件

UNIX 系统:

/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/policy/policy_name/includes

Windows 系统:

install_path\NetBackup\logs\admin\* install_path\NetBackup\dv\policy\policy_name\includes

另请参见

请参见bpplclients(1m)。

请参见bpplinfo(1m)。

请参见bpschedule(1m)。

请参见bppldelete(1m)。

请参见bppllist(1m)。