搜索 <book_title>...

NetBackup™ 命令参考指南

Last Published: 2025-04-24

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

介绍
附录 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. nbepicfile
131. nbfindfile
132. nbfirescan
133. nbfp
134. nbftadm
135. nbftconfig
136. nbgetconfig
137. nbhba
138. nbholdutil
139. nbhostidentity
140. nbhostmgmt
141. nbhsmcmd
142. nbhypervtool
143. nbidpcmd
144. nbimageshare
145. nbinstallcmd
146. nbjm
147. nbkmiputil
148. nbkmscmd
149. nbkmsutil
150. nblogparser
151. nbmariadb
152. nbmysql
153. nbmlb
154. nborair
155. nboracmd
156. nbpem
157. nbpemreq
158. nbmariadb
159. nbmlb
160. nbperfchk
161. nbpgsql
162. nbplupgrade
163. nbrb
164. nbrbutil
165. nbreplicate
166. nbrepo
167. nbrestorevm
168. nbseccmd
169. nbserviceusercmd
170. nbsetconfig
171. nbshvault
172. nbsmartdiag
173. nbsnapimport
174. nbsnapreplicate
175. nbsqlcmd
176. nbsqlite
177. nbstl
178. nbstlutil
179. nbstop
180. nbsu
181. nbsvrgrp
182. netbackup_deployment_insights
183. resilient_clients
184. restoretrace
185. stopltid
186. tiermover
187. tldd
188. tldcd
189. tpautoconf
190. tpclean
191. tpconfig
192. tpext
193. tpreq
194. tpunmount
195. verifytrace
196. vltadm
197. vltcontainers
198. vlteject
199. vltinject
200. vltoffsitemedia
201. vltopmenu
202. vltrun
203. vmadd
204. vmchange
205. vmcheckxxx
206. vmd
207. vmdelete
208. vmoprcmd
209. vmphyinv
210. vmpool
211. vmquery
212. vmrule
213. vmupdate
214. vnetd
215. vssat
216. vwcp_manage
217. vxlogcfg
218. vxlogmgr
219. vxlogview
220. W2KOption

名称

nbhostmgmt — 用于管理主机 ID-主机名映射

大纲

nbhostmgmt -add -hostid hostid | -host host -mappingname mappingname [-isshared] [-reason reason] [-server master_server]

nbhostmgmt -addhost -host host [-reason reason] [-server master_server]

nbhostmgmt -allowautoreissuecert -hostid hostid | -host host -autoreissue 0|1 [-reason reason] [-server master_server]

nbhostmgmt -delete -hostid hostid | -host host -mappingname mappingname [-reason reason] [-server master_server]

nbhostmgmt -addcomment -hostid hostid | -host host -comment comment [-server master_server]

nbhostmgmt -deletecomment -hostid hostid | -host host [-server master_server]

nbhostmgmt -updatehost -hostid hostid | -host host -newhostname newhostname [-reason reason] [-server master_server]

nbhostmgmt -decommissionhost -hostid hostid | -host host -reason "reason" [-force] [-json | -json_compact]

nbhostmgmt -help

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\

描述

nbhostmgmt 命令用于管理主机 ID 到主机名或 IP 地址的映射。可以使用该命令执行以下操作：

通过备用名称标识主机。
将这些备用名称映射到相应的主机 ID。
添加、删除和列出映射。
停用客户端主机。

只有 root 用户可以运行此命令。

必须先运行 bpnbat –login –loginType WEB 命令，然后再运行 nbhostmgmt 命令。bpnbat 命令将对 Web 服务登录进行身份验证。

选项

-add | -a

使用此选项可添加和批准指定主机的主机 ID-主机名或 IP 地址映射。

注意:

使用 -add（不带 -isshared 选项）来添加第一个共享。使用 -isshared 选项添加所有其他共享。

-addcomment | -ac

使用此选项为主服务器主机添加注释。您可以使用 nbhostmgmt -list 选项查看注释。添加的注释仅与主服务器主机关联，而不与已映射的备用主机名关联。不能编辑注释。您仅可以重写或删除现有注释。

-ah | -addhost

使用此选项在主机数据库中添加主机。

使用该选项可以添加主机条目，以便 NetBackup 管理员能够设置 autoreissue 参数。利用 autoreissue 参数，无需重新发布令牌即可在主机上部署证书。在自动映像同步复制 (AIR) 设置的 Bare Metal Restore 过程中，必须在目标域的主机数据库中添加主机条目。

除了 Bare Metal Restore AIR 设置等特定情况之外，Cohesity 不建议手动添加主机。

-aa | -allowautoreissuecert

使用此选项可为指定的主机或主机 ID 设置 autoreissue 参数。利用 autoreissue 参数，无需重新发布令牌即可在主机上部署证书。autoreissue 参数仅与主服务器主机名关联，而不与已映射的备用名称关联。

-approved |-ap

使用此选项可列出已批准的已映射主机名或 IP 地址。

-comment | -c: 使用此选项来指定您要添加到主服务器主机的注释的内容。您必须指定主机或主机 ID 以添加注释。如果注释包含空格，则必须用双引号 ("...") 将注释括起来。comment 字段长度限于 2048 个字符。

-conflict | -cf: 使用此选项可列出其条目与其他映射冲突的已映射主机名或 IP 地址。

-decommissionhost | -dh: 使用此选项可从 NetBackup 域中停用客户端主机。

-delete | -d: 使用此选项可删除主机 ID-主机名或 IP 地址映射。

-deletecomment | -dc

使用此选项来删除指定主机或主机 ID 的注释。此选项删除与主服务器主机关联的注释。

如果您尝试使用 nbhostmgmt-deletecomment 选项删除主机的不存在注释，nbauditreport 会针对成功的更新显示一个相应的条目。

-force: 使用此选项可强制执行停用操作。

-help | -h: 显示命令行用法消息。

-host | -n

指定主服务器主机名或备用的映射主机名或 IP 地址。对于 add 和 delete 操作，请确保备用的映射主机名或 IP 地址与单个主机 ID 关联。

对于停用操作，指定要停用的客户端主机名。

-hostid | -i: 指定 NetBackup 主机 ID。

-isshared | -is: 表示要将映射名称添加为共享映射。
注意:
使用 -add（不带 -isshared 选项）来添加第一个共享。使用 -isshared 选项添加所有其他共享。

-json | -j: 此选项跨多行以 json 格式生成数据。

-json_compact | -jc: 此选项在单行中以 json 格式生成数据

-list | -li: 使用此选项基于不同的过滤器列出已映射的主机名或 IP 地址。可以基于已批准、待批准和存在冲突的名称或地址列出主机名或 IP 地址。

-mappingname | -hm: 指定要添加或删除的主机名或 IP 地址。

-newhostname | -nh: 指定待更新主机的新的主服务器主机名。

-pending | -p: 使用此选项可列出待批准的已映射主机名或 IP 地址。

-reason | -r: 使用此选项可指定执行命令操作的原因。输入的字符串将被捕获并显示在审核报告中。请用双引号 ("...") 将此字符串括起来。reason 字段长度限于 512 个字符。该字符串不能以短划线字符 (-) 开头，也不能包含单引号 (') 字符。

-server | -s: 表示需要建立通信的 NetBackup 主服务器的名称。-server 选项的默认值是 bp.conf 文件中列出的第一个服务器名称。

-short | -l: 使用此选项仅列出主机 ID 和已映射的主机名。

-updatehost | -uh: 使用此选项可更新主机的主服务器主机名。

示例

示例 1：添加主机 ID-主机名映射。

#nbhostmgmt –add -hostid 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 
–mappingname testhost1
testhost1 is successfully mapped to 
0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0.

示例 2：使用主机名添加主机 ID-主机名映射。

#nbhostmgmt -add -host testhost1 -mappingname testhost2
testhost2 is successfully mapped to 
0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0.

示例 3：批准待定映射。此示例显示了已映射主机名 host3 的 testhost3 映射的批准过程。

#nbhostmgmt –add -host host3 –mappingname testhost3
testhost3 is successfully updated.

示例 4：使用主机 ID 从主机名映射中删除主机 ID。

#nbhostmgmt –delete -hostid 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0
–mappingname testhost1
Mapping between testhost1 and 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0
 is removed.

示例 5：使用主机从主机名映射中删除主机 ID。

#nbhostmgmt –delete -host fs001 –mappingname testhost4
Mapping between testhost4 and 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0
 is removed.

示例 6：使用指定主服务器中的主机从主机名映射中删除主机 ID。

#nbhostmgt -delete -server nbmaster01 -host fs001 -mappingname
 testhost3
Mapping between testhost3 and 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0
 is removed.

示例 7：使用主机名停用主机。

#nbhostmgmt -dh -host testhost1 -reason "Protected by different primary"

示例 8：使用主机 ID 停用主机。

#nbhostmgmt -decommissionhost -hostid 0a0aa0a0-0000-0aa0-aa00-
000a0a00a0a0 -reason "Protected by different primary"

另请参见

请参见bpnbat (1m)。