搜索 <book_title>...

Veritas NetBackup™ 命令参考指南

Last Published: 2019-07-19

Product(s): NetBackup (8.2)

介绍
附录 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. 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. bptpcinfo
79. bpup
80. bpverify
81. cat_convert
82. cat_export
83. cat_import
84. configureCertsForPlugins
85. configureMQ
86. configurePorts
87. configureWebServerCerts
88. create_nbdb
89. csconfig cldinstance
90. csconfig cldprovider
91. csconfig meter
92. csconfig throttle
93. csconfig reinitialize
94. duplicatetrace
95. importtrace
96. jbpSA
97. jnbSA
98. ltid
99. manageClientCerts
100. mklogdir
101. nbauditreport
102. nbcatsync
103. NBCC
104. NBCCR
105. nbcertcmd
106. nbcertupdater
107. nbcldutil
108. nbcloudrestore
109. nbcomponentupdate
110. nbcplogs
111. nbdb_admin
112. nbdb_backup
113. nbdb_move
114. nbdb_ping
115. nbdb_restore
116. nbdb_unload
117. nbdbms_start_server
118. nbdbms_start_stop
119. nbdc
120. nbdecommission
121. nbdelete
122. nbdeployutil
123. nbdevconfig
124. nbdevquery
125. nbdiscover
126. nbdna
127. nbemm
128. nbemmcmd
129. nbfindfile
130. nbfirescan
131. nbftadm
132. nbftconfig
133. nbgetconfig
134. nbhba
135. nbholdutil
136. nbhostidentity
137. nbhostmgmt
138. nbhypervtool
139. nbimageshare
140. nbinstallcmd
141. nbjm
142. nbkmsutil
143. nboraadm
144. nborair
145. nbpem
146. nbpemreq
147. nbperfchk
148. nbplupgrade
149. nbrb
150. nbrbutil
151. nbregopsc
152. nbreplicate
153. nbrepo
154. nbrestorevm
155. nbseccmd
156. nbsetconfig
157. nbsnapimport
158. nbsnapreplicate
159. nbsqladm
160. nbstl
161. nbstlutil
162. nbstop
163. nbsu
164. nbsvrgrp
165. resilient_clients
166. restoretrace
167. stopltid
168. tl4d
169. tl8d
170. tl8cd
171. tldd
172. tldcd
173. tlhd
174. tlhcd
175. tlmd
176. tpautoconf
177. tpclean
178. tpconfig
179. tpext
180. tpreq
181. tpunmount
182. verifytrace
183. vltadm
184. vltcontainers
185. vlteject
186. vltinject
187. vltoffsitemedia
188. vltopmenu
189. vltrun
190. vmadd
191. vmchange
192. vmcheckxxx
193. vmd
194. vmdelete
195. vmoprcmd
196. vmphyinv
197. vmpool
198. vmquery
199. vmrule
200. vmupdate
201. vnetd
202. vssat
203. vwcp_manage
204. vxlogcfg
205. vxlogmgr
206. vxlogview
207. 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]

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]

在 UNIX 系统上，此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/

在 Windows 系统上，此命令的目录路径为 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 将永久取消所有存储生命周期策略的为该目标绑定的所有暂停副本。

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

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