Search <book_title>...

Veritas NetBackup™ Commands Reference Guide

Last Published: 2017-07-21

Product(s): NetBackup (8.0)

Introduction
Appendix A. NetBackup Commands
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. bppolicynew
62. bpps
63. bprd
64. bprecover
65. bprestore
66. bpretlevel
67. bpschedule
68. bpschedulerep
69. bpsetconfig
70. bpstsinfo
71. bpstuadd
72. bpstudel
73. bpstulist
74. bpsturep
75. bptestbpcd
76. bptestnetconn
77. bptpcinfo
78. bpup
79. bpverify
80. cat_convert
81. cat_export
82. cat_import
83. configurePorts
84. create_nbdb
85. csconfig
86. duplicatetrace
87. importtrace
88. jbpSA
89. jnbSA
90. ltid
91. mklogdir
92. nbauditreport
93. nbcatsync
94. NBCC
95. NBCCR
96. nbcertcmd
97. nbcertupdater
98. nbcomponentupdate
99. nbcplogs
100. nbdb_admin
101. nbdb_backup
102. nbdb_move
103. nbdb_ping
104. nbdb_restore
105. nbdb_unload
106. nbdbms_start_server
107. nbdbms_start_stop
108. nbdc
109. nbdecommission
110. nbdelete
111. nbdeployutil
112. nbdevconfig
113. nbdevquery
114. nbdiscover
115. nbdna
116. nbemm
117. nbemmcmd
118. nbexecute
119. nbfindfile
120. nbfirescan
121. nbftadm
122. nbftconfig
123. nbgetconfig
124. nbhba
125. nbholdutil
126. nbhypervtool
127. nbjm
128. nbkmsutil
129. nboraadm
130. nbpem
131. nbpemreq
132. nbperfchk
133. nbplupgrade
134. nbrb
135. nbrbutil
136. nbregopsc
137. nbreplicate
138. nbrestorevm
139. nbseccmd
140. nbsetconfig
141. nbsnapimport
142. nbsnapreplicate
143. nbsqladm
144. nbstl
145. nbstlutil
146. nbsu
147. nbsvrgrp
148. resilient_clients
149. restoretrace
150. stopltid
151. tl4d
152. tl8d
153. tl8cd
154. tldd
155. tldcd
156. tlhd
157. tlhcd
158. tlmd
159. tpautoconf
160. tpclean
161. tpconfig
162. tpext
163. tpreq
164. tpunmount
165. verifytrace
166. vltadm
167. vltcontainers
168. vlteject
169. vltinject
170. vltoffsitemedia
171. vltopmenu
172. vltrun
173. vmadd
174. vmchange
175. vmcheckxxx
176. vmd
177. vmdelete
178. vmoprcmd
179. vmphyinv
180. vmpool
181. vmquery
182. vmrule
183. vmupdate
184. vnetd
185. vxlogcfg
186. vxlogmgr
187. vxlogview
188. W2KOption

Name

tpautoconf — discover and configure devices

SYNOPSIS

tpautoconf -get_gdbhost

tpautoconf -set_gdbhost host_name

tpautoconf -verify ndmp_host_name

tpautoconf -probe ndmp_host_name

tpautoconf -report_disc

tpautoconf -replace_drive drive_name -path drive_path

tpautoconf -replace_robot robot_number -path robot_path

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

On Windows systems, the directory path to this command is <install_path>\Volmgr\bin\

DESCRIPTION

The Device Configuration Wizard normally uses tpautoconf to discover devices. This wizard calls tpautoconf with a different set of options.

The get and the set options are useful in special situations. For example, use them to specify a different host as the Enterprise Media Manager (EMM) server. The EMM server name is automatically defined when NetBackup is installed.

For more about how to manage the EMM server, see "About the Enterprise Media Manager" in the NetBackup Administrator's Guide, Volume I.

Use -report_disc, -replace_drive, and -replace_robot to reconfigure the devices in the EMM database to reflect a serial number change that a configured device replacement caused. After hardware replacement, the correction process requires that at least one system is available through the operating system. You may need to re-map, rediscover, and restart the system.

After you configure the server or servers, use the -report_disc option to scan the current hardware and compare it with the configured hardware. A list of discrepancies appears and shows the replaced hardware and the new hardware.

Note:

Not all servers have access to robotic hardware. Even though no access is expected, these robots are listed as missing.

The final step to add replacement hardware is to configure the hardware on all servers by their operating systems. Then run the Device Configuration Wizard to configure the new path information.

You must have administrator privileges to run this command.

OPTIONS

Note:

Only limited validation of the option parameters is done.

-get_gdbhost: Returns the name of the EMM server host.
-set_gdbhost host_name: Sets the name of the EMMSERVER entry in bp.conf.
-probe ndmp_host_name: Lists all devices that are attached to the NDMP host.
-report_disc: Enables the device data to be queried from the EMM server to enable a "diff" to be run on these data records against those scanned. You can run this command on reconfigured servers to produce a list of new and missing hardware. This command scans for new hardware and produces a report that shows the new and the replaced hardware.
-replace_drive drive_name -path drive_path, -replace_robot robot_number -path robot_path: The EMM database is used to query or to update robot drives and robot records.
Note:
On Windows systems, drive_path is a non-NDMP Windows device path for drives and robot_path is a non-NDMP Windows device path for robots. Use the path in the {p,b,t,l} format (where p -port, b -bus, t -target, and l -lun). This information is located in the registry.
-verify ndmp_host_name: Verifies the server name of the NDMP host.

EXAMPLES

Example 1 - Return the name of the host where the Enterprise Media Manager database is stored:

# tpautoconf -get_gdbhost

Example 2 - Set the Enterprise Media Manager Server to be the host server2:

# tpautoconf -set_gdbhost server2

Example 3 - Show the -report_disc command reports discrepancies between detected devices and the EMM database. Included is an example of how to use the -replace_drive drive_name -path drive_path command.

# tpautoconf -report_disc
======================= New Device (Tape) =======================
 Inquiry = "QUANTUM DLT8000         0250"
 Serial Number = PXB08P3242
 Drive Path = /dev/rmt/119cbn
 Found as TLD(6), Drive = 1
===================== Missing Device (Drive) =====================
 Drive Name = QUANTUMDLT800014
 Drive Path = /dev/rmt/9cbn
 Inquiry = "QUANTUM DLT8000         0250"
 Serial Number = PXB08P1345
 TLD(6) definition Drive = 1
 Hosts configured for this device:
  Host = plum
  Host = avocado
# tpautoconf -replace_drive QUANTUMDLT800014 -path /dev/rmt/119cbn
Found a matching device in EMM DB, QUANTUMDLT800014 on host plum
  update on host plum completed
Found a matching device in EMM DB, QUANTUMDLT800014 on host avocado
  update on host avocado completed