Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
- acsd
- add_media_server_on_clients
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- bpclient
- bpclimagelist
- bpclntcmd
- bpclusterutil
- bpcompatd
- bpconfig
- bpdbjobs
- bpdbm
- bpdgclone
- bpdown
- bpduplicate
- bperror
- bpexpdate
- bpfis
- bpflist
- bpgetconfig
- bpgetdebuglog
- bpimage
- bpimagelist
- bpimmedia
- bpimport
- bpinst
- bpkeyfile
- bpkeyutil
- bplabel
- bplist
- bpmedia
- bpmedialist
- bpminlicense
- bpnbat
- bpnbaz
- bppficorr
- bpplcatdrinfo
- bpplclients
- bppldelete
- bpplinclude
- bpplinfo
- bppllist
- bpplsched
- bpplschedrep
- bpplschedwin
- bppolicynew
- bpps
- bprd
- bprecover
- bprestore
- bpretlevel
- bpschedule
- bpschedulerep
- bpsetconfig
- bpstsinfo
- bpstuadd
- bpstudel
- bpstulist
- bpsturep
- bptestbpcd
- bptestnetconn
- bptpcinfo
- bpup
- bpverify
- cat_convert
- cat_export
- cat_import
- configureCerts
- configureCertsForPlugins
- configureMQ
- configurePorts
- configureWebServerCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig throttle
- csconfig reinitialize
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- manageClientCerts
- mklogdir
- nbauditreport
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcloudrestore
- nbcomponentupdate
- nbcplogs
- nbcredkeyutil
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_restore
- nbdb_unload
- nbdb2adutl
- nbdbms_start_server
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbfindfile
- nbfirescan
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nboraadm
- nborair
- nbpem
- nbpemreq
- nbmlb
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbregopsc
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbsetconfig
- nbsnapimport
- nbsnapreplicate
- nbsqladm
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- resilient_clients
- restoretrace
- stopltid
- tldd
- tldcd
- tpautoconf
- tpclean
- tpconfig
- tpext
- tpreq
- tpunmount
- verifytrace
- vltadm
- vltcontainers
- vlteject
- vltinject
- vltoffsitemedia
- vltopmenu
- vltrun
- vmadd
- vmchange
- vmcheckxxx
- vmd
- vmdelete
- vmoprcmd
- vmphyinv
- vmpool
- vmquery
- vmrule
- vmupdate
- vnetd
- vssat
- vwcp_manage
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
- 索引
名称
bpstuadd — 创建 NetBackup 存储单元或存储组
大纲
-label storage_unit_label -path path_name [-dt disk_type] | -dp disk_pool [-dt disk_type] | -density density_type [-rt robot_type -rn robot_number] [-host host_name] [-cj max_jobs] [-odo on_demand_only_flag] [-flags flags] [-cf clearfiles] [-tt transfer_throttle] [-hwm high_water_mark] [-lwm low_water_mark] [-okrt ok_on_root] [-mfs max_fragment_size] [-maxmpx mpx_factor] [-nh NDMP_attach_host] [-nodevhost] [-verbose] [-hostlist host_name...] [-M master_server,...] [-reason "string"] [-uw 1|0]
-group storage_unit_group storage_unit_label ... [-sm selection_method]
在 UNIX 系统上，此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上，此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
bpstuadd 命令创建 NetBackup 存储单元或存储单元组。创建单个存储单元时，请确保包含新存储单元的标签：-density、-path 或 -dp 选项。如果主服务器创建的存储单元数已达到其 NetBackup 配置所允许的最大值，则 bpstuadd 将无法创建存储单元。此命令不会创建与现有存储单元指定了相同的目标介质的存储单元。
注意:
此命令不允许将磁盘存储单元 (DSU) 或磁带存储单元更改为磁盘分段作业存储单元 (DSSU)。此外，也不能将 DSSU 更改为 DSU 或磁带存储单元。
NetBackup 有几种类型的存储单元。存储单元类型影响 NetBackup 存储数据的方式。bpstuadd 命令行选项用于指定以下项之一：
磁盘。存储目标是一个磁盘文件系统目录、一个磁盘池或同时包括两者。
磁盘分段作业。磁盘分段作业存储单元 (DSSU) 将自动（或预定）映像扫描从 DSSU 定址到最终存储单元。
介质管理器。存储目标是由介质管理器管理的一个磁带设备。
NDMP。NDMP 是介质管理器控制的存储单元。必须安装 NetBackup for NDMP 选件。在该命令描述中，如无特殊说明，涉及介质管理器存储单元类型的内容也适用于 NDMP 存储单元类型。NDMP 存储单元的介质总是直接挂接到 NDMP 主机，无法用来存储其他 NetBackup 客户端的数据。要定义 NDMP 存储单元，请在主服务器上运行 bpstuadd 命令。
有关如何添加 NDMP 存储单元的更多信息，请参见《NetBackup for NDMP 管理指南》。
错误将发送到 stderr。而该命令的活动日志将发送到当天的 NetBackup 管理日志文件中。
有关存储单元的更多信息，请参见《NetBackup 管理指南，第 II 卷》。
只有授权用户可以运行此命令。
有关 NetBackup 授权的详细信息，请参见《NetBackup 安全和加密指南》。
选项
- -cf clearfiles
启用 NetBackup 介质以对备份数据执行数据转换操作。通常，OpenStorage 插件使用元数据执行块级别重复数据删除操作，以减少所用磁盘空间的总量。此值仅对使用 OST 磁盘池配置的磁盘存储单元有效。
clearfiles 变量可以是下列值之一：
0 - 禁用所有数据转换操作。
1 - 启用详细转换操作。元数据描述已备份文件的所有属性。这些文件称为透明文件。
2 - 启用简单转换操作。元数据仅标识已备份文件的名称、大小和字节偏移位置。这些文件称为不透明文件。
- -cj max_jobs
指定该存储单元最多可允许的并行作业数。max_jobs 为一个非负整数。合适的值取决于服务器有效运行多个备份进程的能力以及存储介质上的可用空间。
有关每个客户端的最多作业数的更多信息，请参见《NetBackup 管理指南，第 I 卷》。
max_jobs 选项设置为零 (0)，表示在调度作业时从不选择该存储单元。默认值为 1。
- -density density_type
指定介质的密度类型。如果包含此选项，则存储单元类型是“介质管理器”。此选项无默认值。命令行中必须有 -density、-path 或 -dp。如果在命令行中指定了机械手类型，density 值应该与机械手类型一致。只能独立使用 -density、-path 和 -dp 选项。
density_type 的有效值为：
dlt - DLT 盒式磁带
dlt2 - DLT 备用盒式磁带
8mm - 8 毫米盒式磁带
4mm - 4 毫米盒式磁带
qscsi - 1/4 英寸盒式磁带
注意:
NetBackup 支持下列 NetBackup Enterprise Server 密度。
hcart - 1/2 英寸盒式磁带
hcart2 - 备用 1/2 英寸盒式磁带
dtf - DTF 盒式磁带
- -dp disk_pool
指定磁盘池的名称。磁盘池是该存储单元的数据存储区域。磁盘池必须已存在。
- -dt disk_type
允许用户指定磁盘类型。下面是 disk_type 的有效值：
1 - BasicDisk
3 - SnapVault
6 - DiskPool
- -flags flags
将存储单元指定为分段作业存储单元，此时可进行快速还原。flags 的有效值为：NONE 和 STAGE_DATA。当前仅对于磁盘存储单元有效。
- -group storage_unit_group storage_unit_label...
添加存储单元组，并指定组名以及组成该组的存储单元。通过用空格分隔存储单元名称，可将多个存储单元添加到存储单元组中。存储单元组标签的最大长度是 128 个字符。
- -host host_name
表示与该存储单元关联的一台特定介质服务器。只能选择该介质服务器作为从存储单元读取或写入存储单元的系统。默认为本地系统的主机名。
注意:
NetBackup 服务器不支持远程介质服务器。
选择的主机必须是 NetBackup 主服务器或远程介质服务器（如果配置的是远程介质服务器）。主机名必须是所有 NetBackup 服务器和客户端都知道的服务器的网络名。
如果 host_name 是有效的网络名，但尚未在 NetBackup 中配置它，则它将作为介质服务器添加到 NetBackup 的配置中。在 UNIX 上，此服务器在 bp.conf 文件中显示为
SERVER条目；在 Windows 上，“主机属性”在“服务器”列表中指定服务器。如果 host_name 不是有效的网络名，则必须手动配置它。
- -hostlist host_name...
表示应使用可访问存储单元的介质服务器子集。如果多台介质服务器共享一个磁盘池，则使用此选项。您希望将一组介质服务器专用于一组策略和客户端。然后，将另一组介质服务器用于其他策略和客户端（或特定角色，如复制作业）。
- -hwm high_water_mark
指定磁盘存储单元视为已满的百分比。此选项是用户可配置的阈值。高位标记的有效范围是 0-100%，默认设置为 98%。在以下两种不同情况下，达到高位标记时，NetBackup 将主动采取措施：
在启动作业时，如果使用了所有容量，则认为 DSU 已满。如果您选择存储单元组中的存储单元，则发生如下情况：介质和设备选择 (MDS) 不会向已使用容量超过高位标记的存储单元分配新作业。而是在组内查找其他存储单元以用于处理该作业。
在执行作业期间，如果设置了分段作业属性，并且使用了所有容量，那么分段作业将使映像失效以释放 DSU 上的空间。这样可以容纳更多的备份数据。
- -label storage_unit_label
指定存储单元的名称。您必须使用此选项，但使用 -group 时除外。存储单元标签的最大长度是 128 个字符。
- -lwm low_water_mark
此选项是用户可配置阈值，由执行磁盘分段作业操作的磁盘存储单元使用。低位标记的有效范围是 0-100%。默认设置为 80%。
达到高位标记时，执行以下操作之一：
将映像迁移到其他存储单元，直到达到“低位标记”为止。
使最早的分段映像的磁盘映像失效以释放磁盘空间，直到达到“低位标记”为止。
如要保存大部分数据，请将低位标记配置为与高位标记相近。
- -M master_server,...
主服务器的列表。这是一个以逗号分隔的主机名列表。如果包含该选项，将在该列表中的每一台主服务器上运行该命令。服务器必须允许发出该命令的系统对其进行访问。如果任何主服务器发生错误，将在该主服务器位置处停止处理。默认为输入该命令的系统的主服务器。
- -maxmpx mpx_factor
最多复用路数系数。多路复用操作从一个或几个客户端向单个驱动器发送多个并行备份。
有关多路复用 (MPX) 的更多信息，请参见《NetBackup 管理指南，第 I 卷》。
多路复用因子的范围从 1 到 32。默认值为 1，表示不多路复用。如果值大于一 (1)，则表示 NetBackup 可以在目标介质上创建多路复用映像。许可证确定了适用于本地 NetBackup 系统的 1-32 范围内的有效值。
- -mfs max_fragment_size
指定最大片段大小（以 MB 为单位），即 NetBackup 映像的片段可以有多大。NetBackup 支持的最大片段大小约为 1,000,000 MB (1 TB)。
对于可移动介质，此值为 0，或者为介于 50（兆字节）和 1,048,576（兆字节）(1024 GB)（含两端值）之间的任何整数。默认值为 0，即最大值 1,048,576 MB。
对于磁盘存储单元，该值的范围为 20 MB 到 524,288 MB (512 GB)。默认值为 524,288 MB。
- -nh NDMP_attach_host
指定 NDMP 服务器的主机名。如果包含此选项，则将存储单元类型设置为 NDMP。默认为无 NDMP 服务器。
- -nodevhost
表示存储单元没有相关联的介质服务器。可以选择能访问该存储单元的任意介质服务器来移动数据（如备份、复制、还原）。
- -odo on_demand_only_flag
On-Demand-Only 标志控制 NetBackup 使用存储单元的条件：
要使存储单元仅对请求它的策略或日程表可用，请将该标志设置为 1（启用）。
要使存储单元对任何策略或日程表都可用，请将该标志设置为 0（禁用）。
如果存储单元的类型是“磁盘”，则默认值为 1；仅当有显式请求时，NetBackup 才使用该存储单元。否则，默认值是 0。
DSSU 只根据要求使用。必须显式地选择它们作为备份目标。
- -okrt ok_on_root
如果没有设置此标志，则不会在根文件系统上创建备份或目录。如果设置了 ok_on_root 标志，则通常会创建备份和目录。
此标志的默认值为 0。如果路径位于根文件系统上，则不会为磁盘存储单元 (BasicDisk) 创建备份和目录。
- -path path_name
指定磁盘文件系统的路径，用绝对路径名表示，这是存储单元的数据存储区域。如果包含此选项，则存储单元类型是 Disk。此选项无默认值。命令行中必须有 -path、-dp 或 -density。只能独立使用 -density、-path 和 -dp 选项。
一般情况下，在使用此选项时，将启用 On-Demand-Only 标志（请参见 -odo）。否则，如果存在不要求特定存储单元的 NetBackup 策略，则这些策略可写入磁盘文件系统 path_name。这可能会导致严重的系统问题。例如，如果系统交换区恰好在此文件系统上，则新进程可能会失败。
- -reason "string"
指示您选择此命令操作的原因。您输入的原因文本字符串将被捕获并显示在审核报告中。用双引号 ("...") 将此字符串括起来。该字符串不能超过 512 个字符。该字符串不能以短划线字符 (-) 开头，也不能包含单引号 (')。
- -rn robot_number
指定此存储单元的机械手编号。它必须大于或等于 0。可以从管理控制台的“介质和设备管理”获取机械手编号。除非包含 -rt 选项，否则将忽略该选项。此选项无默认值。
有关机械手编号的使用规则的更多信息，请参见《NetBackup 管理指南，第 II 卷》。
- -rt robot_type
此存储单元的机械手类型。对于非机械手（独立）设备，请选择 NONE 或者忽略该选项。默认值是 NONE（非机械手）。密度值应该与机械手类型一致。
如果将该选项设置为 NONE 以外的任何值，则必须同时使用 -rn 选项。可用的机械手类型代码包括：
NONE - 非机械手
TLD - DLT 磁带库
ACS - 自动盒式系统
- -sm selection_method
选择存储单元组的选择方法。此选项仅对存储单元组有效。selection_method 的可能值有：
优先 = 1（默认值）
最近最少选择 = 2
故障转移 = 3
负载平衡 = 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
为日志记录选择详细模式。仅当在调试日志功能处于启用状态（即定义了以下目录）的情况下运行该选项才有意义：
UNIX 系统：/usr/openv/netbackup/logs/admin
Windows 系统：install_path\NetBackup\logs\admin
示例
示例 1 - 创建一个名为 hatunit 的新存储单元。其存储单元类型是“磁盘”，
在 UNIX 系统上，存储单元的路径为 /tmp/hatdisk。
在 Windows 系统上，存储单元的路径为 C:\tmp\hatdisk。
UNIX 系统：
# bpstuadd -label hatunit -path /tmp/hatdisk -verbose
Windows 系统：
# bpstuadd -label hatunit -path C:\tmp\hatdisk -verbose <2>bpstuadd: INITIATING: NetBackup 8.0 created: 0 <2>bpstuadd: EXIT status = 0.
示例 2 - 使用先前没有在 NetBackup 中配置的 UNIX 服务器来创建存储单元：
注意:
以下示例涉及的是远程介质服务器，它仅适用于 NetBackup Enterprise Server。NetBackup 服务器只支持主服务器，不支持远程介质服务器。
# bpstuadd -label parrot_stu -host parrot -density dlt -rt TLD -rn 2
远程介质服务器 parrot 添加到了 bp.conf 文件中。
还必须在 parrot 上安装 NetBackup 和介质管理器，并在主服务器上运行 add_media_server_on_clients 可执行文件。
% grep parrot /usr/openv/netbackup/bp.conf SERVER = parrot
返回值
零 (0) 退出状态表示已成功运行命令。
任何非零 (0) 的退出状态都表示发生了错误。
如果启用了管理日志功能，bpstuadd 会将退出状态记录在日志目录下的每日管理日志中：
UNIX 系统：
/usr/openv/netbackup/logs/admin
Windows 系统：
install_path\NetBackup\logs\admin
它具有下列形式：
# bpstuaddnew: EXIT status = exit status
如果出错，将在显示该消息之前进行诊断。
文件
UNIX 系统：
/usr/openv/netbackup/logs/admin/*
Windows 系统：
install_path\NetBackup\logs\admin\*
EMM 数据库