Veritas NetBackup™ 命令参考指南

Last Published:
Product(s): NetBackup (8.1.1)
  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.  
      bppolicynew
    62.  
      bpps
    63.  
      bprd
    64.  
      bprecover
    65.  
      bprestore
    66.  
      bpretlevel
    67.  
      bpschedule
    68.  
      bpschedulerep
    69.  
      bpsetconfig
    70.  
      bpstsinfo
    71.  
      bpstuadd
    72.  
      bpstudel
    73.  
      bpstulist
    74.  
      bpsturep
    75.  
      bptestbpcd
    76.  
      bptestnetconn
    77.  
      bptpcinfo
    78.  
      bpup
    79.  
      bpverify
    80.  
      cat_convert
    81.  
      cat_export
    82.  
      cat_import
    83.  
      configurePorts
    84.  
      create_nbdb
    85.  
      csconfig cldinstance
    86.  
      csconfig cldprovider
    87.  
      csconfig meter
    88.  
      csconfig throttle
    89.  
      duplicatetrace
    90.  
      importtrace
    91.  
      jbpSA
    92.  
      jnbSA
    93.  
      ltid
    94.  
      manageClientCerts
    95.  
      mklogdir
    96.  
      nbauditreport
    97.  
      nbcatsync
    98.  
      NBCC
    99.  
      NBCCR
    100.  
      nbcertcmd
    101.  
      nbcertupdater
    102.  
      nbcldutil
    103.  
      nbcomponentupdate
    104.  
      nbcplogs
    105.  
      nbdb_admin
    106.  
      nbdb_backup
    107.  
      nbdb_move
    108.  
      nbdb_ping
    109.  
      nbdb_restore
    110.  
      nbdb_unload
    111.  
      nbdbms_start_server
    112.  
      nbdbms_start_stop
    113.  
      nbdc
    114.  
      nbdecommission
    115.  
      nbdelete
    116.  
      nbdeployutil
    117.  
      nbdevconfig
    118.  
      nbdevquery
    119.  
      nbdiscover
    120.  
      nbdna
    121.  
      nbemm
    122.  
      nbemmcmd
    123.  
      nbexecute
    124.  
      nbfindfile
    125.  
      nbfirescan
    126.  
      nbftadm
    127.  
      nbftconfig
    128.  
      nbgetconfig
    129.  
      nbhba
    130.  
      nbholdutil
    131.  
      nbhostidentity
    132.  
      nbhostmgmt
    133.  
      nbhypervtool
    134.  
      nbjm
    135.  
      nbkmsutil
    136.  
      nboraadm
    137.  
      nborair
    138.  
      nbpem
    139.  
      nbpemreq
    140.  
      nbperfchk
    141.  
      nbplupgrade
    142.  
      nbrb
    143.  
      nbrbutil
    144.  
      nbregopsc
    145.  
      nbreplicate
    146.  
      nbrestorevm
    147.  
      nbseccmd
    148.  
      nbsetconfig
    149.  
      nbsnapimport
    150.  
      nbsnapreplicate
    151.  
      nbsqladm
    152.  
      nbstl
    153.  
      nbstlutil
    154.  
      nbstop
    155.  
      nbsu
    156.  
      nbsvrgrp
    157.  
      resilient_clients
    158.  
      restoretrace
    159.  
      stopltid
    160.  
      tl4d
    161.  
      tl8d
    162.  
      tl8cd
    163.  
      tldd
    164.  
      tldcd
    165.  
      tlhd
    166.  
      tlhcd
    167.  
      tlmd
    168.  
      tpautoconf
    169.  
      tpclean
    170.  
      tpconfig
    171.  
      tpext
    172.  
      tpreq
    173.  
      tpunmount
    174.  
      verifytrace
    175.  
      vltadm
    176.  
      vltcontainers
    177.  
      vlteject
    178.  
      vltinject
    179.  
      vltoffsitemedia
    180.  
      vltopmenu
    181.  
      vltrun
    182.  
      vmadd
    183.  
      vmchange
    184.  
      vmcheckxxx
    185.  
      vmd
    186.  
      vmdelete
    187.  
      vmoprcmd
    188.  
      vmphyinv
    189.  
      vmpool
    190.  
      vmquery
    191.  
      vmrule
    192.  
      vmupdate
    193.  
      vnetd
    194.  
      vwcp_manage
    195.  
      vxlogcfg
    196.  
      vxlogmgr
    197.  
      vxlogview
    198.  
      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 安全和加密指南》

选项

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