搜索 <book_title>...

NetBackup™ 命令参考指南

Last Published: 2022-04-27

Product(s): NetBackup & Alta Data Protection (10.0)

介绍
附录 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
索引

名称

nbstlutil — 运行 NetBackup 存储生命周期策略实用程序

大纲

nbstlutil active [-lifecycle name] [-destination name] [-before mm/dd/yyyy hh:mm:ss | -after mm/dd/yyyy hh:mm:ss]

nbstlutil 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]

nbstlutil 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]

nbstlutil list_import_conf [-l|-U|-b|-json| -json_compact] [-lifecycle name] [-all_pending_images] [destination name] [-target_domain name]

nbstlutil cancel [-lifecycle name | -destination name] [-version number] [-before mm/dd/yyyy hh:mm:ss | -after mm/dd/yyyy hh:mm:ss] [-nowarn] [-force]

nbstlutil active | inactive | cancel -backupid id_value

nbstlutil diskspaceinfo [-stype server_type]

nbstlutil pendimplist

nbstlutil redo -backupid value -slpindex value

nbstlutil repllist [-l] [-U] [-sincetime timeval]

nbstlutil report [-lifecycle name [-version number]] [-client name] [-mediaid value] [-mediaserver name] [-storageserver name]

nbstlutil 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]

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\

描述

用户可以使用 nbstlutil 命令干预存储生命周期策略 (SLP) 操作。下面是该实用程序的功能：

注意:

Veritas 建议用户不要修改或删除自动管理的策略。

如果用户修改 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 将永久取消所有存储生命周期策略的为该目标绑定的所有暂停副本。

在此命令之后创建的任何新映像将以正常方式处理。如果取消了某个映像的所有暂停副本，则会将该映像标记为完成。目标名称是在存储生命周期策略中使用的存储单元或存储单元组的名称。

如果未指定 -force，并且存在即将失效的映像，则会显示一条交互式警告消息。

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 选项结合使用。

-force

如果取消请求中的映像即将失效，请跳过交互式警告消息。

-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