NetBackup™ 命令参考指南

Last Published:
Product(s): NetBackup & Alta Data Protection (10.0)
  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.  
      bpcleanrestore
    22.  
      bpclient
    23.  
      bpclimagelist
    24.  
      bpclntcmd
    25.  
      bpclusterutil
    26.  
      bpcompatd
    27.  
      bpconfig
    28.  
      bpdbjobs
    29.  
      bpdbm
    30.  
      bpdgclone
    31.  
      bpdown
    32.  
      bpduplicate
    33.  
      bperror
    34.  
      bpexpdate
    35.  
      bpfis
    36.  
      bpflist
    37.  
      bpgetconfig
    38.  
      bpgetdebuglog
    39.  
      bpimage
    40.  
      bpimagelist
    41.  
      bpimmedia
    42.  
      bpimport
    43.  
      bpinst
    44.  
      bpkeyfile
    45.  
      bpkeyutil
    46.  
      bplabel
    47.  
      bplist
    48.  
      bpmedia
    49.  
      bpmedialist
    50.  
      bpminlicense
    51.  
      bpnbat
    52.  
      bpnbaz
    53.  
      bppficorr
    54.  
      bpplcatdrinfo
    55.  
      bpplclients
    56.  
      bppldelete
    57.  
      bpplinclude
    58.  
      bpplinfo
    59.  
      bppllist
    60.  
      bpplsched
    61.  
      bpplschedrep
    62.  
      bpplschedwin
    63.  
      bppolicynew
    64.  
      bpps
    65.  
      bprd
    66.  
      bprecover
    67.  
      bprestore
    68.  
      bpretlevel
    69.  
      bpschedule
    70.  
      bpschedulerep
    71.  
      bpsetconfig
    72.  
      bpstsinfo
    73.  
      bpstuadd
    74.  
      bpstudel
    75.  
      bpstulist
    76.  
      bpsturep
    77.  
      bptestbpcd
    78.  
      bptestnetconn
    79.  
      bptpcinfo
    80.  
      bpup
    81.  
      bpverify
    82.  
      cat_convert
    83.  
      cat_export
    84.  
      cat_import
    85.  
      configureCerts
    86.  
      configureMQ
    87.  
      configurePorts
    88.  
      configureWebServerCerts
    89.  
      create_nbdb
    90.  
      csconfig cldinstance
    91.  
      csconfig cldprovider
    92.  
      csconfig meter
    93.  
      csconfig reinitialize
    94.  
      csconfig throttle
    95.  
      duplicatetrace
    96.  
      importtrace
    97.  
      jbpSA
    98.  
      jnbSA
    99.  
      ltid
    100.  
      mklogdir
    101.  
      nbauditreport
    102.  
      nbcallhomeproxyconfig
    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.  
      nbfp
    135.  
      nbftadm
    136.  
      nbftconfig
    137.  
      nbgetconfig
    138.  
      nbhba
    139.  
      nbholdutil
    140.  
      nbhostidentity
    141.  
      nbhostmgmt
    142.  
      nbhypervtool
    143.  
      nbidpcmd
    144.  
      nbimageshare
    145.  
      nbinstallcmd
    146.  
      nbjm
    147.  
      nbkmiputil
    148.  
      nbkmscmd
    149.  
      nbkmsutil
    150.  
      nboraadm
    151.  
      nborair
    152.  
      nbpem
    153.  
      nbpemreq
    154.  
      nbmlb
    155.  
      nbperfchk
    156.  
      nbplupgrade
    157.  
      nbrb
    158.  
      nbrbutil
    159.  
      nbregopsc
    160.  
      nbreplicate
    161.  
      nbrepo
    162.  
      nbrestorevm
    163.  
      nbseccmd
    164.  
      nbserviceusercmd
    165.  
      nbsetconfig
    166.  
      nbsmartdiag
    167.  
      nbsnapimport
    168.  
      nbsnapreplicate
    169.  
      nbsqladm
    170.  
      nbstl
    171.  
      nbstlutil
    172.  
      nbstop
    173.  
      nbsu
    174.  
      nbsvrgrp
    175.  
      netbackup_deployment_insights
    176.  
      resilient_clients
    177.  
      restoretrace
    178.  
      stopltid
    179.  
      tldd
    180.  
      tldcd
    181.  
      tpautoconf
    182.  
      tpclean
    183.  
      tpconfig
    184.  
      tpext
    185.  
      tpreq
    186.  
      tpunmount
    187.  
      verifytrace
    188.  
      vltadm
    189.  
      vltcontainers
    190.  
      vlteject
    191.  
      vltinject
    192.  
      vltoffsitemedia
    193.  
      vltopmenu
    194.  
      vltrun
    195.  
      vmadd
    196.  
      vmchange
    197.  
      vmcheckxxx
    198.  
      vmd
    199.  
      vmdelete
    200.  
      vmoprcmd
    201.  
      vmphyinv
    202.  
      vmpool
    203.  
      vmquery
    204.  
      vmrule
    205.  
      vmupdate
    206.  
      vnetd
    207.  
      vssat
    208.  
      vwcp_manage
    209.  
      vxlogcfg
    210.  
      vxlogmgr
    211.  
      vxlogview
    212.  
      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]

 

On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/

On Windows systems, the directory path to this command is 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

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

Prioritized = 1 (DEFAULT)
Least Recently Selected = 2
Failover = 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)。