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

名称

bpsturep — 替换所选的 NetBackup 存储单元属性

大纲

bpsturep -label storage_unit_label [-verbose] [-host host_name | -nodevhost] [-path path_name | -dp disk_pool | -density density [-rt robot_type -rn robot_number] [-nh NDMP_attach_host] [-cj max_jobs] [-odo on_demand_only_flag] [-mfs max_fragment_size] [-maxmpx mpx_factor] [-cf clearfiles] [-flags flags] [-tt transfer_throttle] [-hwm high_water_mark] [-lwm low_water_mark] [-okrt ok_on_root] [[-addhost | -delhost] host_name [host_name]] [-hostlist host_name [host_name]] [-M master_server [,...] [-uw 1|0]

bpsturep -group storage_unit_group [-addstu | -delstu] storage_unit_label [-M master_server [,...]] [-sm selection_method]

 

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

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

描述

bpsturep 命令修改现有的 NetBackup 存储单元,具体地说就是在 NetBackup 目录库中替换所选存储单元或存储单元组属性。命令行中必须包含存储单元的标签或存储单元组的组名。标签或组名是 bpsturep 唯一无法修改的存储单元属性。

注意:

此命令不允许将磁盘存储单元 (DSU) 或磁带存储单元更改为磁盘分段作业存储单元 (DSSU)。此外,也不能将 DSSU 更改为 DSU 或磁带存储单元。

使用 bpsturep 命令时务必谨慎。对存储单元或存储单元组的修改必须和现有的属性一致。请确保最后得到的属性组合是有效的,尤其要注意以下属性:

robot_type robot_number density_type max_fragment_size path_type NDMP_attach_host     

修改这些属性的最安全方法是为每个要替换的属性运行一次 bpsturep

bpsturep 通过使用指定属性更改来修改存储单元,从而完成更改操作。在运行 bpsturep 后,再运行 bpstulist,以确定是否应用了所需更改。

错误将发送到 stderr。而该命令的活动日志将发送到当天的 NetBackup 管理日志文件中。

有关存储单元的更多信息,请参见《NetBackup 管理指南,第 I 卷》

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

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

选项

-cf clearfiles

启用 NBU 介质以对备份数据执行数据转换操作。通常,OpenStorage 插件使用元数据执行块级别重复数据删除操作,以减少所用磁盘空间的总量。此值仅对使用 OST 磁盘池配置的磁盘存储单元有效。

clearfiles 变量可以是下列值之一:

  • 0 - 禁用所有数据转换操作。

  • 1 - 启用详细转换操作。元数据描述已备份文件的所有属性。这些文件称为透明文件。

  • 2 - 启用简单转换操作。元数据仅标识已备份文件的名称、大小和字节偏移位置。这些文件称为不透明文件。

-cj max_jobs

该存储单元最多可允许的并行作业数。max_jobs 为一个非负整数。合适的值取决于服务器有效运行多个备份进程的能力以及存储介质上的可用空间。

有关每个策略的最多作业数的更多信息,请参见《NetBackup 管理指南,第 I 卷》

零 (0) 表示调度作业时从不选择该存储单元。默认值为 1。

-density density_type

如果包含此选项,则存储单元类型是“介质管理器”。此选项没有默认值。如果命令行上有机械手类型,则密度值应该与机械手类型保持一致。只能独立使用 -density-path-dp 选项。

有效的“密度”类型包括:

dlt - DLT 盒式磁带

dlt2 - DLT 备用盒式磁带

8mm - 8 毫米盒式磁带

4mm - 4 毫米盒式磁带

qscsi - 1/4 英寸盒式磁带

注意:

以下密度仅适用于 NetBackup Enterprise Server。

hcart - 1/2 英寸盒式磁带

hcart2 - 备用 1/2 英寸盒式磁带

dtf - DTF 盒式磁带

-dp disk_pool

指定磁盘池的名称。磁盘池是该存储单元的数据存储区域。该选项仅在磁盘类型为 6(磁盘池)时才可以使用。磁盘池必须已存在。

-dt disk_type

允许用户指定磁盘类型。下面是 disk_type 的有效值:

1 - BasicDisk

3 - SnapVault

6 - DiskPool

-flags flags

将存储单元指定为分段作业存储单元,此时可进行快速还原。flags 的有效值为:NONE 和 STAGE_DATA。当前仅对于磁盘存储单元有效。

-group storage_unit_group

存储单元组的名称。bpsturep 将在此存储单元组中添加或删除其成员。使用 -addstu storage_unit 可在组中添加存储单元。使用 -delstu storage_unit 可从组中删除存储单元。

-host host_name

注意:

NetBackup 服务器不支持远程介质服务器。

目标介质挂接到的 NetBackup 主机。默认为本地系统的主机名。

选择的主机必须是 NetBackup 主服务器或介质服务器(如果配置的是介质服务器)。主机名必须是所有 NetBackup 服务器和客户端都知道的服务器的网络名。

如果 host_name 是有效的网络名,并且尚未配置它,则 host_name 值将作为介质服务器添加到 NetBackup 的配置中。在 UNIX 系统上,该值显示在 bp.conf 中;在 Windows 上,它显示在服务器的“配置”窗口中。如果 host_name 不是有效的网络名,则必须手动配置它。

-hwm high_water_mark

此选项是用户可配置的阈值。高位标记的默认设置为 98%。在以下两种不同情况下,达到高位标记时,NetBackup 将主动采取措施:

- 在启动作业时,如果使用了所有容量,则认为 DSU 已满。如果它从存储单元组的多个存储单元中进行选择,则发生如下情况:介质和设备选择 (MDS) 不会向达到或超过高位标记的单元分配新作业。而是在组内查找其他存储单元以用于处理该作业。

- 在执行作业期间,如果设置了分段作业属性,并且使用了所有容量,那么分段作业将使映像失效以释放 DSU 上的空间。这样可以容纳更多的备份数据。

-label storage_unit_label

存储单元的名称。bpsturep 命令将替换该存储单元的属性。必须指定此选项。存储单元标签的最大长度是 128 个字符。

-lwm low_water_mark

此选项是用户可配置的阈值,由执行磁盘分段作业操作的磁盘存储单元使用。低位标记的默认设置为 80%。

达到高位标记时,应该执行以下操作之一:

- 将映像迁移到其他存储单元,直到达到“低位标记”为止。

- 使最早的分段映像的磁盘映像失效以释放磁盘空间,直到达到“低位标记”为止。

注意:

如要保存大部分可用数据,请将低位标记配置为与高位标记相近。此外,低位标记必须小于高位标记。它们不能设置为相同的值。

-mfs max_fragment_size

指定的最大片段大小(以 MB 为单位),即 NetBackup 映像的片段可以有多大。NetBackup 支持的最大片段大小约为 1,000,000 MB (1 TB)。

对于介质管理器存储单元,该值为零。或者是大于或等于 50 MB、且小于或等于 1,048,576 MB/(1024 GB) 的任意整数。默认值为 0,即允许的最大值 1024 GB。

对于磁盘存储单元,该值的范围为 20 MB 到 2000 MB (2 GB)。默认值是 524288 (512 GB)。

-maxmpx mpx_factor

最多复用路数系数。多路复用操作从一个或几个客户端向单个驱动器发送多个并行备份。

有关多路复用 (MPX) 的更多信息,请参见《NetBackup 管理指南,第 I 卷》

多路复用因子的范围从 1 到 32,一 (1) 表示不多路复用。如果值大于一 (1),则表示 NetBackup 可以在目标介质上创建多路复用映像。由于本地 NetBackup 安装的授权方式,您可能无法分配整个 1-32 范围内的多路复用系数。默认值为 1。

-M master_server [,...]

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

-nh NDMP_attach_host

指定 NDMP 服务器的主机名。如果包含此选项,则将存储单元类型设置为 NDMP。默认为无 NDMP 服务器。

-nodevhost

表明将没有与此存储单元关联的介质服务器。

-odo on_demand_only_flag

on-demand-only 标志控制是否仅将存储单元用于显式请求它的备份:

要使存储单元仅对请求它的策略或日程表可用,请将该标志设置为 1(启用)。

要使存储单元对任何策略或日程表都可用,请将该标志设置为 0(禁用)。

如果存储单元的类型是“磁盘”,则默认值为 1;仅当有显式请求时,NetBackup 才使用该存储单元。否则,默认值是 0。

-okrt ok_on_root

如果没有设置此标志,则不会在根文件系统上创建备份或目录。如果设置了 ok_on_root 标志,则通常会创建备份和目录。

此标志的默认值为 0。如果路径位于根文件系统上,则不会为磁盘存储单元 (BasicDisk) 创建备份和目录。

在 UNIX 系统上,根目录是 "/"。

在 Windows 上,根目录是 windows\system 目录所在的卷。

-path path_name

磁盘文件系统的路径,用绝对路径名表示,这是存储单元的数据存储区域。如果包含此选项,则存储单元类型是 Disk。此选项没有默认值。只能独立使用 -density-path-dp 选项。

一般情况下,在使用此选项时,将启用 on-demand-only 标志(请参见 -odo)。否则,如果存在不要求特定存储单元的 NetBackup 策略,则这些策略可写入磁盘文件系统 path_name。这可能会导致严重的系统问题。例如,如果系统交换区恰好在此文件系统上,则新进程可能会失败。

如果将路径名定义为磁盘分段作业存储单元 (DSSU),则可以使用此选项将路径名更改为另一个 DSSU。不能使用该选项将 DSSU 更改为另一种类型的存储单元。

-rn robot_number

此存储单元的机械手编号。机械手编号必须大于或等于 0,可从管理控制台的“介质和设备管理”中获取。除非包含 -rt 选项,否则将忽略该选项。此选项没有默认值。

有关机械手编号的使用规则的更多信息,请参见《NetBackup 管理指南,第 II 卷》

-rt robot_type

此存储单元的机械手类型。对于非机械手(独立)设备,请选择 NONE 或者忽略该选项。默认值是 NONE(非机械手)。密度值应该与机械手类型保持一致。

如果将该选项设置为 NONE 以外的任何值,则必须同时使用 -rn 选项。

可用的机械手类型代码包括:

NONE - 非机械手

TLD - DLT 磁带库

ACS - 自动盒式系统

-sm selection_method

选择存储单元组的选择方法。此选项仅对存储单元组有效。下面是它的可能值:

按优先级排列 = 1(默认)最近最少选择的 = 2 故障转移 = 3

Load Balance = 4(如果安装了容量管理许可证,则显示该选项)

选项 1:“按优先级排列”是默认条件。它选择列表中的第一个存储单元,直到该单元发生故障、已满或达到其最多并行作业数设置为止。然后,查看列表中的下一个存储单元,直到找到可用的存储单元为止。

选项 2:“最近最少选择的”将选择最近最少选择的存储单元。

选项 3:“故障转移”与“按优先级排列”类似,但是当第一个存储单元达到最多并行作业数时,MDS 会对作业排队,以等待第一个存储单元。仅当第一个存储单元发生故障或已满时,MDS 才使用列表中的下一个存储单元。

选项 4:负载平衡。您必须已安装容量管理许可证,才会显示此选项。如果用户选择此选项,介质设备选择 (MDS) 根据介质服务器是否满足下列条件来平衡作业负载:

  • 有足够的磁盘卷可用空间来容纳估计的作业大小。

  • 有足够的 CPU 和内存资源来容纳另一个作业。

  • 与同类或同级别的其他介质服务器相比,正在处理的估计作业大小数据量最少。

如果许可证失效,则负载平衡恢复为“选项 2”行为。该选项将选择最近最少选择的存储单元。

-tt transfer_throttle

仅为 SnapVault 存储单元显示“传输限制”设置。

此设置指示 SnapVault 的最大数据传输带宽。如果此设置为零(默认值),则表示对带宽没有限制,并且数据传输时使用全部的网络带宽。(范围:0(默认)至 9999999。)

-uw 1|0

此选项用于将存储单元定义为一写多读 (WORM)。如果设置此选项,则写入到存储单元的映像将实施 WORM 锁定。此选项的默认值为 0。将 -uw 设置为 1(定义 WORM 的存储单元)后,该操作不可逆。必须先删除该存储单元,然后使用 -uw 0 重新创建它。

-verbose

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

UNIX 系统:

/usr/openv/netbackup/logs/admin

Windows 系统:

install_path\NetBackup\logs\admin

示例

UNIX 系统:

更改磁盘存储单元 mkbunit 的路径。路径由 /tmp/mkbunit 更改为 /tmp/mkbunit2

# bpstulist mkbunit 0 beaver 0 -1 -1 1 0 /tmp/mkbunit 1 1 2000 *NULL* # bpsturep -label mkbunit -path /tmp/mkbunit2 # bpstulist mkbunit 0 beaver 0 -1 -1 1 0 /tmp/mkbunit2 1 1 2000 *NULL*

Windows 系统:

更改磁盘存储单元 mkbunit 的路径。路径由 C:\tmp\mkbunit 更改为 C:\tmp\mkbunit2

# bpstulist mkbunit 0 beaver 0 -1 -1 1 0 C:\tmp\mkbunit 1 1 2000 *NULL* # bpsturep -label mkbunit -path C:\tmp\mkbunit2 # bpstulist mkbunit 0 beaver 0 -1 -1 1 0 C:\tmp\mkbunit2/ 1 1 2000 *NULL*

文件

UNIX 系统:

/usr/openv/netbackup/logs/admin/*

Windows 系统:

install_path\NetBackup\logs\admin\*

EMM 数据库

另请参见

请参见bpstsinfo(1m)。

请参见bpstuadd(1m)。

请参见bpstudel(1m)。

请参见bpstulist(1m)。