NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
- acsd
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- bpcleanrestore
- 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
- bpup
- bpverify
- cat_convert
- cat_export
- cat_import
- configureCerts
- configureMQ
- configureWebServerCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig reinitialize
- csconfig throttle
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- mklogdir
- msdpcldutil
- nbauditreport
- nbcallhomeproxyconfig
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcmdrun
- 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
- nbfp
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nboraadm
- nborair
- nbpem
- nbpemreq
- nbmariadb
- nbmlb
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbserviceusercmd
- nbsetconfig
- nbshvault
- nbsmartdiag
- nbsnapimport
- nbsnapreplicate
- nbsqladm
- nbsqlite
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- netbackup_deployment_insights
- 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
名称
nbstl — 添加、删除、修改或列出 NetBackup 存储生命周期策略
大纲
storage_lifecycle_name [-add | -modify | -modify_current | -modify_version] [-dc class] [-dp duplication_priority] [-version version_number]
[-uf used_for1 [,used_for2,..used_forn]]
[-source source1[,source2,..sourcen]]
[-residence storage_unit1 | __NA__[,storage_unit2 | __NA__,..storage_unitn | __NA__]]
[-pool volume_pool1 | __NA__[,volume_pool2 | __NA__,..volume_pooln | __NA__]]
[-server_group host1 | *ANY* | *NONE* | __NA__[,host2 | *ANY* | *NONE* | __NA__,..hostn | *ANY* | *NONE* | __NA__]]
[-managed m1[,m2,..mn]] [-rl retention_level1 | __NA__ [,retention_level2 | __NA__,..retention_leveln | __NA__]] [-as alt_read_server1 | __NA__ [,alt_read_server2 | __NA__,..alt_read_servern | __NA__]]
[-mpx T | F [,T | F,..,T | F]] [-target_master target_master_server1 | __NA__ [,target_master_server2 | __NA__,..target_master_servern | __NA__]][-target_importslp target_importslp1 | __NA__ [,target_importslp2 | __NA__,..target_importslpn | __NA__]] [-defop T | F [,T | F,..,T | F]] [-v] [-M master_server] [-destpri priority1 [,priority2,..priorityn]] [-window window_1 [,window_2,..window_n]] [-wcopt option_set1 [,option_set2,..option_setn]
storage_lifecycle_name -delete [-v] [-M master_server]
[storage_lifecycle_name] -L | -l | -b | U | -json | -json_compact | -conflicts [-v] [-M master_server] [-all_versions] [-version version_number]
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\
描述
nbstl 命令可执行下列操作：
-add 添加新存储生命周期。
-delete 删除现有存储生命周期。
-modify 修改现有存储生命周期。
-L 或 -l 列出有关一个或所有存储生命周期的长格式或短格式的信息。-b 仅列出存储生命周期策略名称本身。
nbstl 命令同时创建、修改或删除所有目标，但不支持添加或修改单个目标。要更改一个目标的属性，必须考虑所有现有目标以及要更新的目标。
可能有多个需要为目标输入的选项不适用 (NA)。在这种情况下，应输入 __NA__ 值（NA 前后各一条下划线）。下列选项接受 __NA__ 值：
-residence
-pool
-server_group
-as（备用读取服务器）
-target_master
-target_importslp
注意:
通过 nbstl 命令、NetBackup 图形用户界面或 API 启动创建、修改或删除存储生命周期策略的成功尝试时，将审核并记录这些尝试。
选项
- -all_versions
显示指定的存储生命周期策略的所有版本；如果未指定 storage_lifecycle_name，则显示所有存储生命周期策略的所有版本。
- -b
显示指定存储生命周期策略的名称；如果未指定 storage_lifecycle_name，则显示所有存储生命周期策略。将此选项与 -all_versions 选项结合使用可显示所有存储生命周期策略的名称和版本。
- -conflicts
显示对此 SLP 的更改（如其他 nbstl 选项所述）会如何影响与此 SLP 相关联的策略。nbstl 会提交 SLP 更改以供验证。会将 SLP 的建议内容与使用 SLP 的所有策略相比较，并通过 stdout 显示所有错误。此时不提交任何更改。如果未发现任何错误，用户随后可以重新提交更改，而无需 -conflicts 选项提交更改。
- -dc class
指定与该服务关联的数字数据分类。
- -delete
删除指定的存储生命周期策略。
- -defop T | F [,T | F,..,T | F]
为复制副本设置延迟操作标志。
F 或 f - 不延迟创建其他映像副本。
T 或 t - 将其他映像副本的创建推迟到源副本即将失效时。复制作业约在源失效前四个小时开始。可通过更改 SLP 参数主机属性中的“延迟复制偏移”参数来更改此默认时间。
- -dp duplication_priority
指定与此存储服务关联的复制作业优先级。
- storage_lifecycle_name
标识要创建、修改、删除或显示的存储生命周期策略的名称。
- -json
以 json 格式生成数据并跨多行。
- -json_compact
在单独的一行上以 json 格式生成数据。
- -l
显示指定的存储生命周期策略的精简输出；如果未指定 storage_lifecycle_name，则显示所有存储生命周期策略的精简输出。输出仅包含存储生命周期的相关数据。此命令不标识名称。
- -L
显示指定的存储生命周期的长输出；如果未指定 storage_lifecycle_name，则显示所有存储生命周期的长输出。此命令用名称标识输出。
- -M master_server
指定 NetBackup 主服务器。默认为本地服务器。
- -modify
修改指定的存储生命周期策略。此选项创建新版本的存储生命周期策略。您可以修改诸如池卷或保留级别之类的信息。
- -modify_current
修改存储生命周期策略的当前版本而不是创建新策略。此选项不能与 –dc、-uf、-source 或 –managed 选项一起使用。
- -modify_version
修改存储生命周期策略的所选版本 (nn) 而不是创建新策略。此选项不能与 –dc、-uf、-source 或 –managed 选项一起使用。
- -v
为日志记录选择详细模式。
- -version nn
仅显示指定版本号 (nn) 的存储生命周期策略；如果未指定 storage_lifecycle_name，则显示所有存储生命周期策略。
下面每个目标选项都必须指定相同数量的参数，即为每个存储服务的目标各指定一个参数。得到的目标数量等于参数数量。参数用逗号进行分隔，参数之间没有空格。
- -destpri priority1 [,priority2,...priorityn]]
指定每个存储生命周期策略目标索引的作业优先级。此选项只能用于导入目标。所有其他目标都必须设置为 0。
- -managed m,...
为每个目标指定受控保留类型。可能的值如下：
0 - 固定
1 - 受控容量
2 - 复制后失效。在使用此副本作为源的所有操作完成后，该副本就失效了。这些操作包括重复、复制、从快照备份以及从快照编制索引。
3 - 远程（导入的）截止日期。
4 - 最大快照循环。
5 - 镜像副本
例如，-managed 4 意味着保留类型为最大快照循环。
- -mpx T | F [,T | F,..,T | F]
设置复制副本的保持多路复用标志。不允许对备份或快照副本使用此选项。策略主机和存储单元属性中的设置决定了备份副本的多路复用状态。标志只与磁带副本有关。选项 -mpx 后跟一组用来分隔下列值的逗号：
F 或 f - 不保持副本的多路复用。
T 或 t - 保持副本的多路复用（如果可能）
__NA__ - 不适用
- -pool volume_pool1 | __NA__[,volume_pool2 | __NA__,..volume_pooln | __NA__]
指定每个目标的卷池。卷池不适用于磁盘副本。
- -residence storage_unit1 | __NA__[,storage_unit2 | __NA__,..storage_unitn | __NA__]
要用于每个目标的存储单元。存储单元不适用于快照目标（-uf 选项设置为 2）或复制到远程主服务器（-uf 选项设置为 3）。
- -rl retention_level1 [,retention_level,...retention_level]
应用到每个目标的保留级别 (0-100)。如果在 8.0 版本之前的 NetBackup 介质服务器上运行此命令，则输出内容仅会显示介于 0 到 24 之间的保留级别。
注意:
保留级别 25 的值为立即失效。不能编辑此值。
- -server_group host1 | *ANY* | *NONE* | __NA__[,host2 | *ANY* | *NONE* | __NA__,..hostn | *ANY* | *NONE* | __NA__]
指定服务器组。可以使用任何介质共享服务器组时，请使用 *ANY*。不允许共享组时，请使用 *NONE*。
- -as alt_read_server1 | __NA__ [,alt_read_server2 | __NA__,..alt_read_servern | __NA__]
每个目标的备用读取服务器。备用读取服务器仅适用于复制目标。
- -source source1[,source2,...sourcen]
配置存储生命周期 -add 和 -modify 操作的复制分层结构。
-source 接受以下值：
备份和快照目标 - 值必须为 0。备份和快照副本不需要源。
复制目标 - 目标列表中用作源副本的目标的序列号。（快照副本无法用作复制的源。）必须将不使用任何特定源（使用主副本作为源）的复制目标设置为 0。
- -U
以用户显示格式输出有关指定存储生命周期的数据。
- -uf used_for1 [used_for2,...used_forn]
指定何时使用各目标。使用以下值之一：
0 - 备份
1 - 复制
2 - 快照
3 - 对远程主服务器的复制（要求 -residence 值为 __NA__）
4 - 导入
5 - 从快照备份
6 - 从快照编制索引
7 - 复制
例如，-uf 2 适用于快照操作。
- -wcopt option1 [,option2,...optionn]
指定如何处理无法暂停的映像。如果时段关闭，但 SLP 的作业未完成，NetBackup 将尝试暂停正在处理中的映像。在时段重新打开之后，NetBackup 将从暂停处恢复这些作业。
如果无法暂停映像，option 将确定映像的处理方式：
SFN - 处理完活动映像。时段关闭，但 NetBackup 继续处理完活动映像。NetBackup 在时段重新打开之后再开始处理其他映像。
SHN - 取消活动映像的处理。时段关闭，且 NetBackup 立即停止处理活动映像。在时段重新打开时，NetBackup 开始处理剩下的映像。
- -window window_1 [,window_2,..window_n]
为特定目标指定时段。如果用户运行 bpschedule 命令来创建新的复制时段，随后使用 nbstl 命令可以创建具有备份和复制目标的生命周期，并且从该策略进行的复制将仅从上午 6 点开始并持续 4 个小时（这意味着所有作业应在上午 10 点完成）。
示例
示例 1 - 列出 lifecycle1 上的长格式输出信息：
# nbstl lifecycle1 -L
Name: lifecycle1
Data Classification: Gold
Duplication job priority: 0
State: active
Destination 1 Use for: backup
Storage Unit: adv_dsu1
Volume Pool: (none specified)
Server Group: (none specified)
Retention Type: Fixed
Retention Level: 1 (2 hours)
Alternate Read Server: (none specified)
Preserve Multiplexing: false
State: inactive
Source: (client)
名为 adv_dsu1 的存储单元处于不活动状态。-L 显示的“状态”值处于活动或不活动状态。
示例 2 - 创建名为 HDLifecyle1 的生命周期。此生命周期采用黄金数据分类。它包含以下四个目标：
带有存储单元 AdvDisk1，不需要任何源（-source 值为 0）的备份目标（-uf 值为 0）。
使用存储单元 DataDomain1 的备份目标。
带有存储单元 DataDomain2，使用序列号 1 处的目标（即带有存储单元 DataDomain1 的备份目标）作为源（-source 值为 1）的复制目标（-uf 值为 1）。
带有存储单元 cooperstown-tape1，使用序列号 2 处的目标（即带有存储单元 DataDomain2 的复制目标）作为源（-source 值为 2）的复制目标。
# nbstl HDLifecycle1 -add -dc Gold -uf 0,0,1,1,1 -residence AdvDisk1, DadaDomain1,DataDomain2,cooperstown-tape1 -source 0,0,1,2
示例 3 - 创建一个通过备份到磁盘来执行快照，然后再复制到磁带的生命周期。磁盘存储单元为 DskSTU，磁带存储单元为 TpSTU。
# nbstl LCPolicy -add -dc Gold -uf 0,1,2 -residence DskStU,TpSTU,__NA__ -pool NetBackup,DLP_Pool1,__NA__ -managed 0,0,0 -rl 6,12,1
数据保留的定义如下。
快照映像保留一周。
磁盘上的备份映像保留六 (6) 个月。
磁带映像保留五 (5) 年。
用户已经将保留级别 12 定义为五 (5) 年。
示例 4 - 更改生命周期的现有版本 4 的保留级别：
# nbstl LCPolicy -modify_version -version 4 -rl 4,6,7,7
存储生命周期策略以前必须定义了四个目标。
示例 5 - 列出 LCPolicy 的版本 2 的精简内容：
# nbstl LCPolicy -l -version 2
示例 6 - 更改存储生命周期策略 SLP8 的当前版本中的字段：
# nbstl SLP8 -modify_current -pool Pool1,Pool2,Pool3 -as __NA__, AltReadServer2,__NA__ -mpx F,F,T
示例 7 - 创建新复制时段。随后使用 nbstl 命令可以创建具有备份和复制目标 (0,1) 的生命周期。前面的 bpplsched 命令将该策略的复制时段设置为在上午 6:00 到上午 10:00（4 个小时）之间运行。
# nbstl morning_dup_slp -add -dc Gold -dp 999 -uf 0,1 -source 0,1 -residence DISK1,TAPE1