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
- 索引
名称
nbstlutil — 运行 NetBackup 存储生命周期策略实用程序
大纲
active [-lifecycle name] [-destination name] [-before mm/dd/yyyy hh:mm:ss | -after mm/dd/yyyy hh:mm:ss]
inactive -lifecycle name | -destination name [-reactivation_time mm/dd/yyyy hh:mm:ss | -duration hours] [-before mm/dd/yyyy hh:mm:ss | -after mm/dd/yyyy hh:mm:ss]
inactive -lifecycle name -destination name [-reactivation_time mm/dd/yyyy hh:mm:ss | -duration hours] [-before mm/dd/yyyy hh:mm:ss | -after mm/dd/yyyy hh:mm:ss]
list_import_conf [-l|-U|-b|-json| -json_compact] [-lifecycle name] [-all_pending_images] [destination name] [-target_domain name]
cancel [-lifecycle name | -destination name] [-version number] [-before mm/dd/yyyy hh:mm:ss | -after mm/dd/yyyy hh:mm:ss] [-nowarn]
active | inactive | cancel -backupid id_value
diskspaceinfo [-stype server_type]
list [-l | -U | -b] [-rt I | IC | ICF | ICFS] [-lifecycle name [-version number] [-destination name] | -lifecycle_only | -backupid value | -jobid value] [-client name] [-mediaid value] [-mediaserver name] [-storageserver name] [-image_state value] | -copy_state value | -frag_state value | -image_incomplete | -image_inactive | -copy_incomplete | -copy_inactive] [-copy_type value] [-policy name] [-before mm/dd/yyyy hh:mm:ss | -after mm/dd/yyyy hh:mm:ss]
pendimplist
redo -backupid value -slpindex value
repllist [-l] [-U] [-sincetime timeval]
report [-lifecycle name [-version number]] [-client name] [-mediaid value] [-mediaserver name] [-storageserver name]
stlilist [-l] [-U] [[[-lifecycle name] [-destination name]] | -backupid value] [-client name] [-mediaid value] [-mediaserver name] [-image_state value | -image_incomplete | -image_inactive] [-copy_type value]
在 UNIX 系统上，此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上，此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
用户可以使用 nbstlutil 命令干预存储生命周期策略 (SLP) 操作。下面是该实用程序的功能：
注意:
不建议用户修改或删除自动管理的策略。
如果用户修改 SLP，则必须确保 SLP 继续满足保护计划定义的服务级别目标。
如果用户删除 SLP，则必须确保将资产添加到满足服务级别目标的其他保护计划。
注意:
不会审核使用 nbstlutil 命令激活和暂停 SLP 的操作。仅当从 NetBackup 图形用户界面或 API 启动时，才会对这些操作进行审核。
- active
激活对在存储生命周期策略中暂停的辅助操作的处理。符合辅助操作条件的操作有创建重复项、复制和从快照导入。将激活现有映像和新创建的映像。-lifecycle、-version、-destination、-before、-after 和 -backupid 选项用于标识辅助操作。
如果 -lifecycle 选项和 -destination 均未指定，则 nbstlutil 将继续处理所有存储生命周期策略的所有辅助操作。
如果仅指定了存储生命周期策略 (-lifecycle)，则 nbstlutil 仅继续处理该存储生命周期策略的所有辅助操作。
如果仅指定了目标，则 nbstlutil 将继续处理所有存储生命周期策略中使用指定目标的所有辅助操作。
运行 nbstlutil inactive 命令时，将暂停辅助操作。
- cancel
根据如何使用 -lifecycle、-before、-after 和 -destination 选项，将永久取消存储生命周期策略处理：
如果同时使用了 -lifecycle 选项和 -destination 选项，则 nbstlutil 将永久取消这些选项所标识的现有映像的处理。
如果未使用任一选项，则 nbstlutil 将永久取消存储生命周期策略管理的所有现有映像的所有暂停副本。
如果仅指定了存储生命周期策略 (-lifecycle)，则 nbstlutil 将永久取消该策略管理的现有映像的所有暂停副本。
如果仅指定了一个目标，则 nbstlutil 将永久取消所有存储生命周期策略的为该目标绑定的所有暂停副本。
在此命令之后创建的任何新映像将以正常方式处理。如果取消了某个映像的所有暂停副本，则会将该映像标记为完成。目标名称是在存储生命周期策略中使用的存储单元或存储单元组的名称。
- diskspaceinfo
报告所有磁盘卷所使用的空间或仅由指定类型使用的磁盘卷所用的空间。
- inactive
暂停处理某个存储生命周期策略中的辅助操作，但保留映像信息，从而使处理可在以后继续。辅助操作包括创建重复项、复制以及从快照导入。将暂停现有映像和新创建的映像。-lifecycle、-before、-after 和 -destination 选项用于标识辅助操作。
如果同时使用了 -lifecycle 选项和 -destination 选项，则 nbstlutil 将暂停处理存储生命周期策略和目标选项所标识的现有映像。
如果仅指定了存储生命周期策略 (-lifecycle)，则 nbstlutil 将暂停该存储生命周期策略的所有辅助操作。
如果仅指定了目标，则 nbstlutil 将暂停所有存储生命周期策略中使用指定目标的所有辅助操作。
inactive 选项将与 reactivation 选项一起使用，以便让用户选择何时可以继续处理不活动的辅助操作。
- list
显示映像列表的内容。它会列出引用 SLP 的映像。可以指定 SLP 名称以过滤映像列表。该选项主要是一个调试工具，但支持人员可以使用该信息进行故障排除。
- list_import_conf
列出已复制到目标域、但尚未收到相应的导入确认消息的映像。默认情况下，仅列出等待确认时间超过配置阈值的映像。如果选中 -all_pending_images 选项，则无论等待时间如何，均会列出所有等待映像。
- pendimplist
列出处于暂停导入状态的所有映像。这些是已接收但未成功导入的复制事件。由于映像导入功能不会导入备份时间为将来时间的映像，因此这些映像将处于暂停状态，直到过了备份时间。
- redo
对映像重复 SLP 操作。如果非 NetBackup 操作丢失、损坏或损毁了映像副本，可使用 redo 重新创建副本。如果原始源副本不再可用，重做将失败。
- report
显示生命周期受控映像不完整副本的汇总。
- repllist
显示已完成复制副本的状态。
- stlilist
显示生命周期受控映像的所有副本的状态。
选项
- -after mm/dd/yyyy hh:mm:ss
将 SLP 辅助操作限制为在指定日期时间之后开始的备份。
- -all_pending_images
无论等待时间如何，均会列出所有等待映像。
- -b
仅列出备份 ID。
- -backupid value
指定要处理其映像的备份 ID。
- -before mm/dd/yyyy hh:mm:ss
将 SLP 辅助操作限制为在指定日期时间之前开始的备份。
- -client name
将列出的用于存储生命周期操作的映像限制为仅是由 name 指定的客户端上的那些映像。
- -copy_inactive value
选择 NetBackup 数据库中一个或多个副本标记为不活动的映像。此选项主要用于调试。
- -copy_incomplete value
选择 NetBackup 数据库中一个或多个副本未标记为复制已完成的映像。该选项用于调试。
- -copy_state value
选择 NetBackup 数据库中具有指定副本状态的映像。此选项主要用于调试。以下是副本状态的有效值：
1 - NOT_STARTED
2 - IN_PROCESS
3 - COMPLETE
9 - NOT_STARTED | INACTIVE
10 - IN_PROCESS | INACTIVE
- -copy_type value
为 list 命令（list 和 stlilist）选择副本类型过滤器。有效值如下：
0 - 备份
1 - 复制
2 - 快照
3 - 对远程主服务器的复制（副本）
4 - 导入
- -destination name
选择预定要复制到由 name 指定的存储单元或存储单元组的映像。
- -duration hours
设置从生命周期映像停用到重新激活开始之间的时间（以小时为单位）。小时数必须是整数（1、2、…）。此选项只能与 inactive 选项结合使用。
- -frag_state value
选择 NetBackup 数据库中具有指定片段状态的映像。该选项用于调试。以下是 frag 状态的有效值：
1 - ACTIVE
2 - TO_BE_DELETED
3 - ELIGIBLE_FOR_EXPIRATION
- -image_inactive value
选择 NetBackup 数据库中标记为不活动的映像。该选项用于调试。
- -image_incomplete value
选择 NetBackup 数据库中未标记为生命周期已完成的映像。该选项用于调试。
- -image_state value
选择 NetBackup 数据库中具有指定映像状态的映像。此选项主要用于调试。映像状态的有效值包括：
1 - NOT_STARTED
2 - IN_PROCESS
3 - COMPLETE
9 - NOT_STARTED | INACTIVE
10 - IN_PROCESS | INACTIVE
- -jobid value
将用于存储生命周期操作的映像的输出列表限制为仅已创建指定作业 ID value 的映像。-jobid 只能与 list 选项一起使用。
- -json
以扩展可读的 json 格式生成输出。
- -json_compact
以压缩的 json 格式生成输出。
- -l
生成压缩的可分析列表输出。
- -lifecycle name
仅选择生命周期受控映像列表。
- -mediaid value
将列出的用于存储生命周期操作的映像限制为仅是由 value 指定的介质 ID 上的那些映像。
- -mediaserver name
将列出的用于存储生命周期操作的映像限制为仅是由 name 指定的介质上的那些映像。
- -nowarn
跳过交互式警告消息。
- -policy name
将映像处理限制为已创建指定备份策略 (name) 的映像。-policy 只能与 list 选项一起使用。
- -reactivation_time mm/dd/yyyy hh:mm:ss
如果想在以后重新激活将要停用的副本或 SLP，请以 mm/dd/yyyy hh:mm:ss 格式设置时间。inactive 选项可以使用此选项或 -duration 选项来重新激活已停用的副本或 SLP。
- -rt I | IC | ICF | ICFS
选择要列出的记录类型。可能的值为：
I - 仅列出映像记录。
IC - 列出映像和副本记录。
ICF - 列出映像、副本和片段记录。
ICFS - 列出映像、副本、片段和快照记录。
- -sincetime timeval
显示从指定的 timeval 到目前为止已完成复制副本的状态。此选项与 repllist 函数一起使用。
- -slpindex value
指定要重复的 SLP 操作。-slpindex 只能与 redo 操作一起使用。
- -storageserver name
将列出的用于存储生命周期操作的映像限制为仅是由 name 指定的存储服务器上的那些映像。
- -stype server_type
指定标识存储服务器类型的字符串。server_type 值可能源自以下来源之一：
Veritas 提供的存储。可能的值有 AdvancedDisk 和 PureDisk。
第三方磁盘设备。供应商提供了 server_type 字符串。
云存储。使用 csconfig cldprovider -l 命令确定可能的 stype 值。云 stype 值反映了云存储提供程序。云存储 stype 值还可包含一个后缀（例如
amazon_crypt）。可能的后缀是：_raw：将具有原始格式的 NetBackup 备份映像发送至云。如果您在将数据发送至云存储前不需要压缩或加密数据，则使用此选项。
_rawc：在将数据写入云存储之前压缩数据。
_crypt：在将数据写入云存储之前使用 AES-256 加密对此数据进行加密。要使用此选项，必须在 NetBackup 中配置 KMS。_cryptc：将数据写入云存储之前压缩和加密数据。
存储服务器类型区分大小写。
- -target_domain name
选择以仅输出那些与指定的目标域相关的记录。
- -U
生成用户可读的列表输出。
- -version number
将列表输出限制为仅由指定的 SLP 版本控制的映像。它必须与 -lifecycle 选项一起使用。
示例
示例 1 - 显示有关生命周期正在进行的映像的信息。
# nbstlutil -list -backupid dollhouse_1287744229 -U Image: Master Server : dollhouse Backup ID : dollhouse_1287744229 Client : dollhouse Backup Time : 1287744229 (Fri Aug 24 16:13:49 2012) Policy : pol-slp-2bkup-70-level Client Type : 13 Schedule Type : 0 Storage Lifecycle Policy : slp-pol-2backup-70-level Storage Lifecycle State : 2 (IN-PROCESS) Time In Process : 1287744327 (Fri Aug 24 16:15:27 2012) Data Classification ID : 85AA96DF9781453289A41745DD240A48 (Platinum) Version Number : 0 OriginMasterServer : (none specified) OriginMasterServerID : 00000000-0000-0000-0000-000000000000 Import From Replica Time : 0 (Thu Jan 01 05:30:00 1970) Required Expiration Date : 0 (Thu Jan 01 05:30:00 1970) Created Date Time : 1287744297 (Fri Aug 24 16:14:57 2012) Copy: Master Server : dollhouse Backup ID : dollhouse_1287744229 Copy Number : 1 Copy Type : 0 Expire Time : 1288953829 (Fri Nov 02 16:13:49 2012) Expire LC Time : 1288953829 (Fri Nov 02 16:13:49 2012) Try To Keep Time : 1288953829 (Fri Nov 02 16:13:49 2012) Residence : PDDE-Stu Copy State : 2 (IN-PROCESS) Job ID : 0 Retention Type : 0 (FIXED) MPX State : 0 (FALSE) Source : 0 Destination ID : *NONE* Last Retry Time : 0 Fragment: Master Server : dollhouse Backup ID : dollhouse_1287744229 Copy Number : 1 Fragment Number : 1 Resume Count : 0 Media ID : @aaaad Media Server : dollhouse Storage Server : (none specified) Media Type : 0 (DISK) Media Sub-Type : 6 (STSDYNAMIC) Fragment State : 1 (ACTIVE) Fragment Size : 5120 Delete Header : 1 Fragment ID : @aaaad The output displays "(none specified)" for blank fields.
示例 2 - 以压缩的可分析格式显示映像列表的内容。
# nbstlutil list -l V7.0 I abc.example.com abc_1225727 abc 1225727 Pol_SLPTest1 0 0 SLP_Test1 2 \ 1225727 *NULL* V7.0 C abc.example.com abc_1225727 1 2147483 1225735 AdvDisk1 3 0 0 0 0 V7.0 F abc.example.com abc_1225727 1 1 0 @ab abc.example.com *NULL* 0 6 1 \ 32768 1 @ab V7.0 C abc.example.com abc_1225727 2 2147483 1225735 AdvDisk2 3 0 0 0 0
示例 3 - 在用户可读的输出中显示未完成生命周期映像的信息。
# nbstlutil stlilist -U Image abc_1225727928 for Lifecycle SLP_Test1 is IN_PROCESS Copy to abc-tape1 is IN_PROCESS Copy to AdvDisk3 is NOT_STARTED