Search <book_title>...

Important Update: Cohesity Products Documentation

All Cohesity product documentation are now managed via the Cohesity Docs Portal: https://docs.cohesity.com/HomePage/Content/home.htm. Some documentation available here may not reflect the latest information or may no longer be accessible.

NetBackup™ Commands Reference Guide

Last Published: 2025-11-24

Product(s): NetBackup (11.1)

Introduction
Appendix A. NetBackup Commands
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. msdpimgutil
100. nbauditreport
101. nbcallhomeproxyconfig
102. nbcatsync
103. NBCC
104. NBCCR
105. nbcertcmd
106. nbcertupdater
107. nbcldutil
108. nbcmdrun
109. nbcomponentupdate
110. nbcplogs
111. nbcredkeyutil
112. nbdb_admin
113. nbdb_backup
114. nbdb_move
115. nbdb_ping
116. nbdb_restore
117. nbdb_unload
118. nbdb2adutl
119. nbdbms_start_server
120. nbdbms_start_stop
121. nbdc
122. nbdecommission
123. nbdelete
124. nbdeployutil
125. nbdevconfig
126. nbdevquery
127. nbdiscover
128. nbdna
129. nbemm
130. nbemmcmd
131. nbepicfile
132. nbfindfile
133. nbfirescan
134. nbfp
135. nbftadm
136. nbftconfig
137. nbgetconfig
138. nbhba
139. nbholdutil
140. nbhostidentity
141. nbhostmgmt
142. nbhsmcmd
143. nbhypervtool
144. nbidpcmd
145. nbimageshare
146. nbinstallcmd
147. nbjm
148. nbkmiputil
149. nbkmscmd
150. nbkmsutil
151. nblogparser
152. nbmariadb
153. nbmysql
154. nbmlb
155. nborair
156. nboracmd
157. nbpem
158. nbpemreq
159. nbmariadb
160. nbmlb
161. nbperfchk
162. nbpgsql
163. nbplupgrade
164. nbrb
165. nbrbutil
166. nbreplicate
167. nbrepo
168. nbrestorevm
169. nbseccmd
170. nbserviceusercmd
171. nbsetconfig
172. nbshvault
173. nbsmartdiag
174. nbsnapimport
175. nbsnapreplicate
176. nbsqlcmd
177. nbsqlite
178. nbstl
179. nbstlutil
180. nbstop
181. nbsu
182. nbsvrgrp
183. netbackup_deployment_insights
184. resilient_clients
185. restoretrace
186. stopltid
187. tiermover
188. tldd
189. tldcd
190. tpautoconf
191. tpclean
192. tpconfig
193. tpext
194. tpreq
195. tpunmount
196. verifytrace
197. vltadm
198. vltcontainers
199. vlteject
200. vltinject
201. vltoffsitemedia
202. vltopmenu
203. vltrun
204. vmadd
205. vmchange
206. vmcheckxxx
207. vmd
208. vmdelete
209. vmoprcmd
210. vmphyinv
211. vmpool
212. vmquery
213. vmrule
214. vmupdate
215. vnetd
216. vssat
217. vwcp_manage
218. vxlogcfg
219. vxlogmgr
220. vxlogview
221. W2KOption

Name

bmrconfig — change configuration settings

SYNOPSIS

bmrconfig -operation verify -client clientName -configuration configName

bmrconfig -operation initialize -resource disk | network | device | all -client clientName -configuration configName -sourceconfiguration discovered_configName

bmrconfig -operation initialize -resource disk | network | device | all -client clientName -configuration configName -sourceclient source_clientName -sourceconfiguration source_configName

bmrconfig -operation initialize -resource driver -client clientName -configuration configName

On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/

On Windows systems, the directory path to this command is install_path\NetBackup\bin\

DESCRIPTION

The bmrconfig command changes the configuration of the system, network, volume, driver, and NetBackup settings. The read-only current configuration and discovered configuration cannot be changed. Use the bmrs command to create a copy of a configuration that you can change.

OPTIONS

-attributes

Attributes of the resource are specified as name-value pairs. The name is always an alphanumeric string. The value is free form but must be double quoted if it contains white space or a shell-interpreted characters. To determine the specific set of attributes that apply to a resource, use bmrconfig -operation list -resource resourceType.

The following are some attributes specific to Solaris ZFS:

-cachedevice - Cache device if used.

-copiesnumber of copies - applies only to the mirror layout

-devtype - The possible device types are the following:

concat - concatenation layout
mirror - mirror layout
raidz1 - raidz1 layout
raidz2 - raidz2 layout
raidz3 - raidz3 layout

-diskdisk name - Disk name to be used. Provide a disk name for every disk used.

-logdevice - Log device if used.

-sliceslice name - Slice name to be used. Provide a slice name for every slice used.

-spare - spare device if used.

-storagepoolZFS storage pool name - Provides a ZFS storage pool name during ZFS and volume operations.

-client clientName: The NetBackup client name.

-configuration configName: The configuration to operate on.

-force: Forces the removal of a resource and all of its dependent resources.

-initialize: Initializes BMR configuration on a specified client.

-manager

The volume manager that controls the resource. Volume managers are as follows:

ldm - Windows Logical Disk Manager

lvm - AIX or HP-UX Logical Volume Manager

native - the volume manager native to the operating system

sfw and vxvm - Arctera InfoScale

svm - Solaris Volume Manager

zfs - ZFS Volume Manager

-name resourceName: The name of the resource to act on. The various volume managers determine the valid characters in a resource name.

-operation operation_name

The operation to perform. Operations are as follows:

add - adds a resource to the configuration

change - changes specific attributes of a resource

clearALL - removes all resources except disks from a disk group

delete - removes a resource from the configuration

display - prints high-level information about the resource

help - prints the required resources and the optional attributes and values

initialize - initializes a configuration's hardware from a discovered configuration

list - prints all the instances of the specified resource type

map - maps a resource that includes dependent resources, from the original configuration to the working configuration

verify - checks that a config has sufficient data for a restore to succeed

-platform win | hp | aix | solaris | linux: The platform of the specified resource. Used with -help only.

-resource resourceType

The type of the resource on which the operation is performed. Resource types are as follows:

all - all resources

accesspath - a Windows access path

disk - a physical storage device

diskgroup - a logical grouping of disks

diskset - a Solaris Volume Manager disk set

driveletter - a Windows drive letter

esm - backup client identity

filesystem - a file system for UNIX and Windows

gateway - a network gateway

host - a network server

hotfix - a Windows hotfix

hotsparepool - a set of the slices that are used for SVM failover

ip - network identity

license - a product license information

logicaldrive - a Windows extended partition; first one implicitly adds container

logicalvolume - an AIX or HP-UX logical volume

metadb - an SVM database replica slice

mountpoint - a path that serves as an access point to a volume

msd - a mass storage driver

multidevice - a Linux multidevice

nativedisk - Solaris Native disk resource

nativepart - Solaris Native partition resource

network - a sub network

nic - a network interface card

nicpkg - a network interface card driver

partition - Windows primary partition

physical volume - an AIX or HP-UX physical volume

slice - a Solaris slice; equivalent to volume

softpart - an SVM soft partition

volume - a logical division of a disk or a disk group

volumegroup - an AIX or HP-UX volume group

zfsfilesystem - ZFS file system

zfsstoragepool - ZFS storage pool

zfsvolume - ZFS volume

-sourceconfiguration source_configName: The configuration that is the source in an initialized configuration operation.

-sourceclient source_clientName: The client that serves as the source in an initialized configuration operation. If a source client is not specified, the configuration comes from the list of discovered configurations.

EXAMPLES

Example 1 - List the physical volumes in a configuration for client aixp31:

# bmrconfig -operation list -resource physical volume -configuration 
current -client aixp31

Example 2 - Map Native partitions on Solaris:

# bmrconfig -op map -re nativepart -name /dev/dsk/c1t0d0p1 -client
client1 -config config1 -attributes disk=/dev/dsk/c1t1d0p0
percent=50 partid=191 active=true

Example 3 - List the volume groups in a configuration for client aixp31:

# bmrconfig -operation list -resource volume group -configuration 
current -client aixp31

Example 4 - Display the attributes of a volume group for client aixp31:

# bmrconfig -operation display -resource volume group -configuration 
current -client aixp31 -name rootvg

Example 5 - Initialize the new configuration with the discovered hardware for client aixp31:

# bmrconfig -operation initialize -resource config -configuration 
mynew -client aixp31 -sourceconfiguration discover

Example 6 - Add a volume group to a configuration for client aixp31:

# bmrconfig -operation add -configuration mynew -client aixp31 
-resource volume group -name rootvg -attributes physical 
volume=hdisk1

Example 7 - Add a disk to a volume group for client aixp31 (requires a full list of physical volumes to be specified):

# bmrconfig -operation modify -configuration my new -client aixp31 
-resource volume group -name rootvg -attributes physical 
volume=hdisk1 physical volume=hdisk0

Example 8 - Remove a physical volume from a volume group for client aixp31:

# bmrconfig -operation modify -configuration my new -client aixp31 
-resource volume group -name rootvg -attributes physical 
volume=hdisk0

Example 9 - Map a volume group from the original configuration for client aixp31:

# bmrconfig -operation map -configuration my new -client aixp31 
-resource volume group -name rootvg

Example 10 - On UNIX, map a ZFS storage pool set up in a mirrored layout that provides three copies:

# bmrconfig -operation map -resource zfsstoragepool -client solbox 
-config solconfig -namedatapool -attributes devtype=mirror copies=3 
spare=/dev/dsk/c1t1d0 cache=/dev/dsk/c1t1d1 log=/dev/dsk/c1t1d2 
disk=/dev/dsk/c1t1d3 disk=/dev/dsk/c1t1d4

NOTES

If you use NetBackup Access Management, and the user credentials and computer credentials expire, renew them before you perform prepare-to-restore operations. Use the bpnbat -Login command to renew your user credentials. Use the bpnbat -LoginMachine command to renew the computer credentials.