Search <book_title>...

NetBackup™ Commands Reference Guide

Last Published: 2024-03-27

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

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. 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. nbhypervtool
142. nbidpcmd
143. nbimageshare
144. nbinstallcmd
145. nbjm
146. nbkmiputil
147. nbkmscmd
148. nbkmsutil
149. nboraadm
150. nborair
151. nboracmd
152. nbpem
153. nbpemreq
154. nbmariadb
155. nbmlb
156. nbperfchk
157. nbplupgrade
158. nbrb
159. nbrbutil
160. nbreplicate
161. nbrepo
162. nbrestorevm
163. nbseccmd
164. nbserviceusercmd
165. nbsetconfig
166. nbshvault
167. nbsmartdiag
168. nbsnapimport
169. nbsnapreplicate
170. nbsqladm
171. nbsqlite
172. nbstl
173. nbstlutil
174. nbstop
175. nbsu
176. nbsvrgrp
177. netbackup_deployment_insights
178. resilient_clients
179. restoretrace
180. stopltid
181. tldd
182. tldcd
183. tpautoconf
184. tpclean
185. tpconfig
186. tpext
187. tpreq
188. tpunmount
189. verifytrace
190. vltadm
191. vltcontainers
192. vlteject
193. vltinject
194. vltoffsitemedia
195. vltopmenu
196. vltrun
197. vmadd
198. vmchange
199. vmcheckxxx
200. vmd
201. vmdelete
202. vmoprcmd
203. vmphyinv
204. vmpool
205. vmquery
206. vmrule
207. vmupdate
208. vnetd
209. vssat
210. vwcp_manage
211. vxlogcfg
212. vxlogmgr
213. vxlogview
214. 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 - Veritas Storage Foundation for Windows

svm - Solaris Volume Manager

vxvm - Veritas 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.