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

名称

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

大纲

bpplinclude policy_name [-v] [-M master_server,...] -L | -l [-generation generation]

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"]

 

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

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

描述

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

bpplinclude 执行以下操作之一:

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

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

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

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

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

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

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

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

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

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

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

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

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

授权用户可启动此命令。

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

注意:

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

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

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

选项

-add pathname ...

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

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

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

-add -f filename

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

-addtoquery query_string...

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

有关更多详细信息和示例,请参考《NetBackup for VMware 指南》

-addtoquery -f filename

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

有关更多详细信息和示例,请参考《NetBackup for VMware 指南》

-delete pathname ...

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

-delete -f filename

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

-deletefromquery query_string...

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

有关更多详细信息和示例,请参考《NetBackup for VMware 指南》

-deletefromquery -f filename

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

有关更多详细信息和示例,请参考《NetBackup for VMware 指南》

-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)。