Search <book_title>...

NetBackup™ 命令参考指南

Last Published: 2023-12-28

Product(s): NetBackup (10.3)

介绍
附录 A. NetBackup 命令
1. acsd
2. backupdbtrace
3. backuptrace
4. bmrc
5. bmrconfig
6. bmrepadm
7. bmrprep
8. bmrs
9. bmrsrtadm
10. bp
11. bparchive
12. bpbackup
13. bpbackupdb
14. bpcatarc
15. bpcatlist
16. bpcatres
17. bpcatrm
18. bpcd
19. bpchangeprimary
20. bpcleanrestore
21. bpclient
22. bpclimagelist
23. bpclntcmd
24. bpclusterutil
25. bpcompatd
26. bpconfig
27. bpdbjobs
28. bpdbm
29. bpdgclone
30. bpdown
31. bpduplicate
32. bperror
33. bpexpdate
34. bpfis
35. bpflist
36. bpgetconfig
37. bpgetdebuglog
38. bpimage
39. bpimagelist
40. bpimmedia
41. bpimport
42. bpinst
43. bpkeyfile
44. bpkeyutil
45. bplabel
46. bplist
47. bpmedia
48. bpmedialist
49. bpminlicense
50. bpnbat
51. bpnbaz
52. bppficorr
53. bpplcatdrinfo
54. bpplclients
55. bppldelete
56. bpplinclude
57. bpplinfo
58. bppllist
59. bpplsched
60. bpplschedrep
61. bpplschedwin
62. bppolicynew
63. bpps
64. bprd
65. bprecover
66. bprestore
67. bpretlevel
68. bpschedule
69. bpschedulerep
70. bpsetconfig
71. bpstsinfo
72. bpstuadd
73. bpstudel
74. bpstulist
75. bpsturep
76. bptestbpcd
77. bptestnetconn
78. bpup
79. bpverify
80. cat_convert
81. cat_export
82. cat_import
83. configureCerts
84. configureMQ
85. configureWebServerCerts
86. create_nbdb
87. csconfig cldinstance
88. csconfig cldprovider
89. csconfig meter
90. csconfig reinitialize
91. csconfig throttle
92. duplicatetrace
93. importtrace
94. jbpSA
95. jnbSA
96. ltid
97. mklogdir
98. msdpcldutil
99. nbauditreport
100. nbcallhomeproxyconfig
101. nbcatsync
102. NBCC
103. NBCCR
104. nbcertcmd
105. nbcertupdater
106. nbcldutil
107. nbcmdrun
108. nbcomponentupdate
109. nbcplogs
110. nbcredkeyutil
111. nbdb_admin
112. nbdb_backup
113. nbdb_move
114. nbdb_ping
115. nbdb_restore
116. nbdb_unload
117. nbdb2adutl
118. nbdbms_start_server
119. nbdbms_start_stop
120. nbdc
121. nbdecommission
122. nbdelete
123. nbdeployutil
124. nbdevconfig
125. nbdevquery
126. nbdiscover
127. nbdna
128. nbemm
129. nbemmcmd
130. nbfindfile
131. nbfirescan
132. nbfp
133. nbftadm
134. nbftconfig
135. nbgetconfig
136. nbhba
137. nbholdutil
138. nbhostidentity
139. nbhostmgmt
140. nbhypervtool
141. nbidpcmd
142. nbimageshare
143. nbinstallcmd
144. nbjm
145. nbkmiputil
146. nbkmscmd
147. nbkmsutil
148. nboraadm
149. nborair
150. nbpem
151. nbpemreq
152. nbmariadb
153. nbmlb
154. nbperfchk
155. nbplupgrade
156. nbrb
157. nbrbutil
158. nbreplicate
159. nbrepo
160. nbrestorevm
161. nbseccmd
162. nbserviceusercmd
163. nbsetconfig
164. nbshvault
165. nbsmartdiag
166. nbsnapimport
167. nbsnapreplicate
168. nbsqladm
169. nbsqlite
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