How it Works
VERITAS
Loading...
NetBackup 6.0
Administrator s Guide
338 pgs4.06 Mb1
Commands Manual
517 pgs4.13 Mb0
Table of contents
Loading...

VERITAS NetBackup 6.0 Commands Manual

VERITAS NetBackup™ 6.0
Commands
for Windows
N152618
September 2005
Disclaimer
VERITAS Legal Notice
Copyright © 1998 - 2005 VERITAS Software Corporation. All rights reserved. VERITAS, the VERITAS Logo, and VERITAS NetBackup are trademarks or registered trademarks of V ERITAS Software Corporation or its affiliates in the U.S. and other countries. Other names may be trademarks of their respective owners.
Portions of this software are derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm. Copyright 1991-92, RSA Data Security, Inc. Created 1991. All rights reserved.
VERITAS Software Corporation 350 Ellis Street Mountain View, CA 94043 USA Phone 650-527-8000 Fax 650-527-2908 www.veritas.com
Third-Party Copyrights
For a list of third-party copyrights, see the NetBackup Release Notes appendix.
ii NetBackup Commands for Windows
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Accessibility Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Comment on the Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xii
Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xii
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Chapter 1. NetBackup Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
acsd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
Finding NetBackup Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Accessing the VERITAS Technical Support Web Site . . . . . . . . . . . . . . . . . . . . . . . . . .x
Contacting VERITAS Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Command Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xii
NetBackup Command Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
NetBackup Media Manager Command Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
add_media_server_on_clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
backupdbtrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
backuptrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
beconv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
bmrc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
bmrconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
bmrepadm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
bmrprep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
bmrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
iii
bmrsrtadm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
bparchive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
bpauthorize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
bpauthsync . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
bpbackup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
bpbackupdb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
bpcatarc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
bpcatlist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
bpcatres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
bpcatrm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
bpcd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
bpchangeprimary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
bpclient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
bpclntcmd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
bpcompatd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
bpconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
bpdbjobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
bpdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
bpduplicate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
bperror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
bpexpdate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
bpfis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
bpgetconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
bpgetdebuglog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
bpimage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
bpimagelist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
bpimmedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
bpimport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . 142
bpinst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
bpkeyfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
iv NetBackup Commands for Windows
bpkeyutil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .158
bplabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160
bplist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .163
bpmedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169
bpmedialist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .172
bpminlicense . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183
bpnbat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185
bpnbaz . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 91
bpplclients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
bppldelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215
bpplinclude . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
bpplinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221
bppllist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
bpplsched . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .232
bpplschedrep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .243
bppolicynew . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .250
bpps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
bprecover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .260
bprestore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .266
bpschedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
bpschedulerep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .282
bpsetconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .288
bpstsinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .290
bpstuadd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .294
bpstudel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .302
bpstulist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .304
bpsturep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .310
bptestbpcd(1M) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .317
bpup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .320
bpverify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
Contents v
cat_convert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
create_nbdb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
duplicatetrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
importtrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
nbdb_admin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
nbdb_backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
nbdb_move . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
nbdb_ping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
nbdb_restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
nbdb_unload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
nbemm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
nbemmcmd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
nbjm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . 367
nbnos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
nbpem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
nbpemreq . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
nbpushdata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
nbrb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
restoretrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . 379
set_ndmp_attr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
tl4d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
tl8d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
tldd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
tlhd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
tlmd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
tpautoconf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
tpclean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
tpconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
tpreq . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
tpunmount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
vi NetBackup Commands for Windows
verifytrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .419
vltcontainers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .422
vlteject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .427
vltinject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .431
vltoffsitemedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .433
vltopmenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
vltrun . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .438
vmadd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .442
vmchange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
vmcheckxxx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .453
vmdelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .455
vmoprcmd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .457
vmphyinv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
vmpool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .467
vmquery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .470
vmrule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .474
vmupdate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .476
vopie_util . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 79
vopied . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .483
vxlogcfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .485
vxlogmgr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .492
vxlogview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .496
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .500
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
Contents vii
viii NetBackup Commands for Windows

Preface

The purpose of this document is to provide you with a book that contains all of the NetBackup “man page” commands. This enables you to find a printable version of the command quickly and easily without searching through multiple books in the NetBackup Library.
This document contains detailed information about each NetBackup command pertinent to a Win dows system. Each co mmand co ntains a brief description of the primary function of the command, a synopsis, and descriptions of each of the options listed in the synopsis. In addition, some commands contain notes and examples to help the user understand how to use the command.

Getting Help

You can find answers to questions and get help from the NetBackup documentation and from the VERITAS technical support web site.

Finding NetBackup Documentation

A list of the entir e Ne tBackup do cumenta tion s et appea rs as an appendix in the NetBackup Release Notes. All NetBackup documents are included in PDF format on the NetBackup
Documentation CD. For definitions of NetBackup terms, consult the online glossary.
▼ To access the NetBackup online glossary
1. In the NetBackup Administration Console, click Help > Help Topics.
2. Click the Contents tab.
3. Click Glossary of NetBackup Terms.
Use the scroll function to navigate through the glossary.
ix
Getting Help

Accessing the VERITAS Technical Support Web Site

The address for the VERITAS Technical Support Web site is http://support.veritas.com. The VERITAS Support Web site lets you do an y of the following:
◆ Obtain updated information about NetBac kup, including system requirements,
supported platforms, and supported peripherals
◆ Contact the VERITAS Technical Support staff and post questions to them
◆ Get the latest patches, upgrades, and utilities
◆ View the NetBackup Frequently Asked Questions (FAQ) page
◆ Search the knowledge base for answers to technical support questions
◆ Receive automatic notice of product updates
◆ Find out about NetBackup training
◆ Read current white papers related to NetBackup
From http://support.veritas.com, you can complete various tasks to obtain specific types of support for NetBackup:
1. Subscribe to the VERIT AS Email notification service to be informed of software alerts, newly published documentation, Beta programs, and other services.
a. From the main http://support.veritas.com page, select a product family and a
product.
b. Under Support Resources, click Email Notifications.
Your customer profile ensures you receive the latest VERITAS technical information pertaining to your s p ecific interests.
2. Locate the telephone support directory at http://support.veritas.com by clicking the Phone Support icon. A page appears that contains VERITAS support numbers from around the world.
Note Telephone support for NetBackup is only available with a valid support
contract. To contact VERITAS for technical support, dial the appropriate phone number listed on the Technical Support Guide included in the product box and have your product license information ready for quick navigation to the proper support group.
3. Contact technical support using e-mail.
x NetBackup Commands for Windows
a. From the main http://support.veritas.com page, click the E-mail Support icon.
A wizard guides you to do the following:
◆ Select a language of your preference
◆ Select a produ ct and a platform
◆ Provide additional contact and product information, and your message
◆ Associate your message with an existing technical support case
b. After providing the required information, click Send Message.

Contacting VERITAS Licensing

For license information, you can conta c t us as follows:
◆ Call 1-800-634-4747 and select option 3
◆ Fax questions to 1-650-527-0952
◆ In the Americas, send e-mail to amercustomercare@veritas.com.
In the Asia and Pacific areas, send email to apaccustomercare@veritas.com. In all other areas, send email to internationallicense@veritas.com.

Accessibility Features

Accessibility Features
NetBackup contains features that make the user interface easier to use by people who are visually impaired and by people who have limited dexterity. A ccessibility features include:
◆ Support for assistive technolog ie s such as screen readers and voice input (Windows
servers only)
◆ Support for keyboard (mouseless) navigation using accelerator keys and mnemonic
keys
For more information, see the NetBackup Installation Guide.
Preface xi

Comment on the Documentation

Comment on the Documentation
Let us know what you like and dislike about the documentation. Wer e you able to find the information you needed quickly? Was the information clearly presented? You can report errors and omissions or tell us what you would find useful in future versions of our manuals and online help.
Please include the following information with your comment:
◆ The title and product version of the manual on which you are commenting
◆ The topic (if relevant) on which you are commenting
◆ Your comment
◆ Your name
Email your comment to NBDocs@veritas.com. Please only use this address to comment on product documentation. See “Getting Help”
in this preface for information on how to contact Technical Support about our software. We appreciate your feedback.

Conventions

The following section explains the various conventions used in this guide.

Command Usage

The following conventions are frequently used in the synopsis of command usage. brackets [ ]
The enclosed command line component is optional.
Vertical bar or pipe (|)
Separates optional arguments from which the user can choose. For example, when a command has the following format:
command arg1|arg2
In this example, the user can use either the arg1 or arg2 variable.
Navigating Multiple Menu Levels
When navigating multiple menu levels, a greater-than sign (>) is used to indicate a continued action.
xii NetBackup Commands for Windows
Conventions
The following example shows how the > is used to condense a series of menu selections into one step:
◆ Select Start > Programs > VERITAS NetBackup > NetBackup Administration
Console.
The corresponding actions could b e described in more steps as follows:
1. Click Start in the task bar.
2. Move your cursor to Programs.
3. Move your cursor to the right and highlight VERITAS NetBackup.
4. Move your cursor to the right. First highlight and then click NetBackup
Administration Console.

NetBackup Command Conventions

This document uses the following conventions when describing commands that are specific to NetBackup. Run these commands in the “Command Pr ompt” to see the re sults.
◆ Brackets [ ] indicate that the enclosed component of the command line is optional.
◆ Curly braces {} indicate an association between the enclosed options. For instance,
{opt1 [opt2 ... optn]} means that if the command contains opt1, then the command may optionally contain opt2 ... optn.
◆ A vertical bar (or the pipe symbol) | separates optional arguments from which the
user can choose. For example, if a command has the following format, you can choose
arg1 or arg2 (but not both): command [arg1 | arg2]
◆ Italics indicate that the information is user supplied. For exa mple, th e user supplies
policy, schedule, and filename in the following command:
bpbackup -p policy -s schedule filename
◆ An ellipsis (...) means that you can repeat the previous parameter. For example,
consider the following command:
bpbackup[-S master_server [,master_server,...]] filename
Here, the -S option requires the first master server name. Additional names can be added, separated by commas and followed by a file name as in:
bpbackup -S mars,coyote,shark,minnow memofile.doc
Preface xiii

Introduction

NetBackup Media Manager Command Notes

In addition, Media Manager has a set of commands that are for device management and are started or stopped by the NetBackup Device Manager service (ltid) as needed.
◆ tpreq and tpunmount are user commands for requesting tape mounts and
unmounts for configured drives.
◆ tpautoconf, tpclean, tpconfig, and vmoprcmd are administrative commands
for device management.
◆ vmadd, vmchange, vmcheckxxx, vmdelete, vmpool, and vmquery, vmrule, and
vmupdate are administrative commands for media management.
Introduction
Included in this document are the NetBackup Server and NetBackup Enterprise Server commands. In most cases, a command pertains to both NetBackup products. However, there are instances where portions or options within a command apply specifically to one product such as NetBackup Enterprise Server. In these situations, a note has been inserted in the text to identify the information as only information that only applies to one NetBackup product.
xiv NetBackup Commands for Windows

NetBackup Commands

This chapter describes all of the NetBackup commands that can be referenced on a Windows platform in alphabetical order.

acsd

NAME
acsd - Automated Cartridge System (ACS) process
SYNOPSIS
install_path\Volmgr\bin\acsd
DESCRIPTION
acsd interfaces with Media Manager to automatically mount and unmount tapes that are under Automated Cartridge System (ACS) control. It is initiated by the NetBackup Device Manager service (ltid), if the Media Manager device configuration s hows drives in an ACS robot. Stopping ltid stops acsd.
acsd performs its tasks by sending requests to the STK LibAttach service which communicates with the server that controls the Automated Cartridge System.
When the connection is established, acsd puts the ACS robot in the UP state and can mount and unmount tapes. If the connection cannot be established or Automated Cartridge System errors exist, acsd changes the robot to the DOWN state. In this state, acsd is still running and returns the robot to the UP state when the problem no longer exists.
1
Drives are addressed and defined in Media Manager using the following: ACS number, LSM number, Panel number, and Drive number.
Drive cleaning for ACS robots must be configured using ACS library software. Cleaning volumes cannot be defined using Media Manager. In addition, you cannot use the tpclean command for cleaning operations on drives under ACS robotic control.
1
acsd
The Internet service port number for acsd must be in %SystemRoot%\system32\drivers\etc\services. To override the services file, create the file install_path\Volmgr\database\ports\acsd with a single line that contains the service port number for acsd. The default service port number is 13702.
You must have administrator privileges to execute this command.
NOTES
This command applies only to NetBackup Enterprise Server.
ERRORS
Media Manager logs ACS and network errors to the Windows application event log. Log entries are also made when the state changes between UP and DOWN.
2 NetBackup Commands for Windows

add_media_server_on_clients

NAME
add_media_server_on_clients - Add Media Server on Clients
SYNOPSIS
install_path\NetBackup\bin\add_media_server_on_clients
DESCRIPTION
You can run the add_media_server_on_clients command from a NetBackup server to attempt to synchronize the server list from the server's configuration with the server lists on the known clients.
The add_media_server_on_clients command attempts to connect to all configured clients (clients listed in backup policies).
For each client that it can connect to, add_media_server_on_clients updates the client's configuration, if necessary, to include all the servers from the server's configuration.
add_media_server_on_clients
Chapter 1, NetBack up Commands 3

backupdbtrace

backupdbtrace
NAME
backupdbtrace – trace debug logs of backupdb (NetBackup image catalog backup) job[s]
SYNOPSIS
install_path\NetBackup\bin\admincmd\backupdbtrace [-server
DESCRIPTION
backupdbtrace consolidates the debug log mess ages for the specified backup database job[s] and writes them to standard output. The messages will be sorted by time. backupdbtrace will attempt to compensate for time zone chan ges and clock drift between remote servers and clients.
At a minimum, you must enable debug logging for administrator on the master server, and for bptm and bpbkar on the media server. For best results, set the verbose logging level to 5 and enable debug logging for bpdbm o n th e master server and bpcd on all servers in addition to the processes already identified.
name] [-job_id number] [-start_time hh:mm:ss] [-end_time hh:mm:ss] [-install_path path] mmddyy [mmddyy ...]
If -job_id is specified, backupdbtrace uses this option as the sole criterion for selecting the backupdb job to trace. If option -job_id is not used, then backupdbtrace selects all the backupdb jobs executed on all the days specified by day stamps (mmddyy). If –start_time/-end_time options are used then the debug logs in the specified time interval are examined.
backupdbtrace writes error messages to standard error. You must have administrator privileges to execute this command.
OPTIONS
-server
Name of the media server where the backupdb command is executed. The default is the local host name.
-job_id
Job ID number of the backupdb job to analyze. Default is any job ID.
-start_time
Earliest time stamp to start analyzing the logs. Default is 00:00:00.
-end_time
Latest time stamp to finish analyzing the logs. Default is 23 :59 : 59.
4 NetBackup Commands for Windows
mmddyy
One or more day stamps. This identifies the log file names ( log.mmddyy for UNIX, mmddyy.log for Windows) that will be analyzed.
OUTPUT FORMAT
The format of an output line is: <daystamp>.<millisecs>.<program>.<sequence> <machine> <log_line>
daystamp
The day of the log in yyyymmdd fo rmat.
millisecs
The number of milliseconds since midnight on the local machine.
program
The name of program (ADMIN, BPBKAR, BPCD, etc.) being logged.
sequence
Line number within the debug log file.
machine
The name of the NetBackup server or client.
log_line
The line that actually appears in the debug log fil e .
backupdbtrace
EXAMPLES
Example 1 The following example analyzes the log of backupdb job with job ID 5 executed on
August 6, 2002.
backupdbtrace -job_id 5 080602
Example 2 The following example analyzes the log of all backupdb jobs that are executed on August
5, 2002 and August 17, 2002.
backupdbtrace 080502 081702
Chapter 1, NetBack up Commands 5

backuptrace

backuptrace
NAME
backuptrace – consolidate the debugs logs for a NetBackup job.
SYNOPSIS
install_path\NetBackup\bin\admincmd\backuptrace [-master_server
DESCRIPTION
The backuptrace utility can be used to consolidate the debug logs for a specif ied NetBackup job[s]. The debug log messages relevant to the specified backup job[s] will be written to standard output. The messages will be sorted by time. The backuptrace utility will attempt to compensate for time zone changes and clock drift between remote servers and clients. The output is formatted so that it should be relatively easy to sort or grep by time stamp, program name, and/or server/client name.
At a minimum, you must enable debug logging for nbpem on the master server, for bpbrm, bptm/bpdm on the media server and bpbkar on the client. For best results, set the verbose logging level to 5 and enable debug logging for bpdbm and bprd on the master server and for bpcd on all servers and clients in addition to the processes already identified.
name] [-job_id number] [-birth_time number] [-policy_name name] [-client_name name] [-start_time hh:mm:ss] [-end_time hh:mm:ss] mmddyy [mmddyy...]
The backuptrace utility can be used for regular file system, database extension and alternate backup method backup jobs.
You must have administrator privileges to execute this command.
OPTIONS
-master_server name
Name of the master server. Default is the local host name.
-job_id number
Job ID number of the backup job to analyze.
-birth_time number
Birth time (seconds since 1970) of the backup job to analyze.
-policy_name name
Policy name of the jobs to analyze.
-client_name name
Client name of the jobs to analyze.
6 NetBackup Commands for Windows
backuptrace
-start_time hh:mm:ss
Earliest time stamp to start analyzing the logs.
-end_time hh:mm:ss
Latest time stamp to finish analyzing the logs.
mmddyy [mmddyy]
One or more day stamps. This identifies the log file names ( log.mmddyy for UNIX, mmddyy.log for Windows) that will be analyzed.
NOTES
Media Manager logs are not analyzed.
EXAMPLES
C:\Program Files\VERITAS\NetBackup\bin\admincmd\backuptrace policy weekly_bkups 051205 >/tmp/jobs.weekly_bkups
This invocation of the utility will consolidate logs for all jobs started for the policy weekly_bkups on 05/12/05. Use the -start_time/-end_time arguments to limit th e window for which the jobs are to be evaluated.
Chapter 1, NetBack up Commands 7

beconv

beconv
NAME
beconv - Convert Backup Exec on-disk catalogs to NetBackup on-disk catalogs.
SYNOPSIS
install_path\NetBackup\bin\admincmd\beconv -all [-L
output_file] [-non_interactive] [-auto_correct]
install_path\NetBackup\bin\admincmd\beconv -rn robot_number [-L
output_file] [-non_interactive]
install_path\NetBackup\bin\admincmd\beconv -tbs [-rn
robot_number] [-L output_file] [-non_interactive]
install_path\NetBackup\bin\admincmd\beconv -m media_id [-h
volume_database_host] [-L output_file]
[-non_interactive] [-f]
install_path\NetBackup\bin\admincmd\beconv -check_consistency
install_path\NetBackup\bin\admincmd\beconv -show_mappings
DESCRIPTION
The beconv command converts Backup Exec on-disk catalogs to NetBackup catalogs. It also converts Backup Exec media records to NetBackup Medi a Manager records with the media being assigned to NetBackup. The media is kept in a frozen state so t hat NetBa ckup does not accidentally use it for backups.
The expiration date for Backup Exec images is the current date plus a retention level of 2 weeks. For example, if Backup Exec catalogs are converted on 7 August 2003, the expiration date for converted NetBackup catalogs will be 21 August 2003.
When the images expire, run beconv to regenerate the images.
OPTIONS
-all
All media belonging to the Backup Exec server are converted and the corresponding images are generated.
-auto_correct
Use this option to take corrective actions (if any). Use it only when indicated during an earlier run of beconv.
-check_consistency
Use this option to check the consistency of Enterprise Media Manager Database.
8 NetBackup Commands for Windows
With this option specified, no conversion takes place. In this mode, beconv searches for Media Manager records with ambiguous GUIDs and media ids in all the volume databases belonging to locally configured devices, then displays the list.
-f
-f denotes the family to which the media belongs. -f converts a ll the
media belonging to the same Backup Exec family . Use for backups which span more that one media.
-h volume_database_host
Specifies the EMM server name where the media is actually present. If this is not specified, the local host name is taken.
-L output_file
Specifies the name of a file in which to write progress information. The default is to not use a progress file.
-m media_id
Specifies the media id of the Backup Exec media which needs to be converted.
-non_interactive
Do not prompt for user input and carry on with the changes. Default is interactive mode, during which the user is prompted before any actual image generation.
beconv
-rn robot_number
Specifies the NetBackup robot number for which the media need to be converted.
-show_mappings
This option lists the current mappings between Backup Exec and NetBackup robots. With this option specified, no conversion takes place and only the mappings are displayed .
-tbs
Trust By Slot. This mode is only for non-barcoded robotic media. In this mode, a match between a Backup Exec media record and a NetBackup Media Manager record is done on the basis of physical location of the media in the robot. In order for a match to be successful, physical inventory of the robot should be done prior to running beconv in this mode. The -tbs option can be combined with th e -rn option to convert media for the specified robot only.
EXAMPLES
Example 1 To run the catalog converter to convert all the media present on a Backup Exec server:
Chapter 1, NetBack up Commands 9
beconv
beconv -all
Example 2 To run the catalog converter to convert only one media present on a Backup Exec server:
beconv -m A00000 -h volume_database_host
Where: A00000 is the media record corresponding to the Backup Exec media which needs to be
converted. volume_database_host is the machine where the NetBackup volume manager database
resides.
10 NetBackup Commands for Windows

bmrc

bmrc
NAME
bmrc - submit requests to the server daemon
SYNOPSIS
install_path\NetBackup\bin\bmrc -operation change -resource {
restoretask | discovertask } [-client clientName]
-state numericStateCode -progress numericProgressCode
install_path\NetBackup\bin\bmrc -operation complete -resource {
restoretask | discovertask } [-client clientName]
-state numericStateCode
install_path\NetBackup\bin\bmrc -operation create -resource log
[-client clientName]
install_path\NetBackup\bin\bmrc -operation create -resource
message [-client clientName] -msg messageText
install_path\NetBackup\bin\bmrc -operation pull -resource {
info | procedure } [-client clientName] -source sourceFileName -destination destinationFileName
DESCRIPTION
The bmrc client program runs on a BMR client and submits requests to the Bare Metal Restore server daemon. The operation and resource are specified as arguments.
When invoked from an external procedure in the r epair envir onment on a re storing client, you must specify the path to the bmrc command as follows:
%SystemDrive%\BMR\NBU\bin At the first boot external procedure point, bmrc is in
install_path\VERITAS\NetBackup\bin.
OPTIONS
-client clientName
Name of the Bare Metal Restore client.
-destination destinationFileName
On pull operation, pathname of file to be created on the local host.
-msg messageText
Text message to be added to the log on the server.
Chapter 1, NetBack up Commands 11
bmrc
-operation operationName
An operation to perform:
change complete create pull
-progress numericProgressCode
A numeric progress code, used internally by Bare Metal Restore.
-resource resourceName
A resource on which to perform the operation:
discovertask info log message procedure restoretask
-source sourceFileName
On pull operation, name of file to retrieve from database.
-state numericStateCode
A numeric state code, used internally by Bare Metal Restore.
EXAMPLES
Example 1 Change the status of a discovery task:
bmrc -operation change -resource discovertask -client clientName
-state numericStateCode -progress numericProgressCode
Example 2 Change the status of a resto r e tas k:
bmrc -operation change -resource restoretask -client clientName
-state numericStateCode -progress numericProgressCode
Example 3 Complete a discovery task and set a final status code:
bmrc -operation complete -resource discovertask -client clientName
-status numericStatus
Example 4
12 NetBackup Commands for Windows
bmrc
Complete a restore task and set a final status code:
bmrc -operation complete -resource restoretask -client clientName
-status numericStatus
Example 5 Create a log on the server from standard input to this command:
bmrc -operation create -resource log -client clientName
Example 6 Create a message, which is added to a log on the server:
bmrc -operation create -resource message -client clientName -msg message text
Example 7 Pull a file from the server:
bmrc -operation pull -resource info -client clientName -source sourceFileName -destination destinationFileName
Example 8 Pull an external procedure from the server:
bmrc -operation pull -resource procedure -client clientName
-source sourceFileName -destination destinationFileName
NOTES
If NetBackup Access Management is used in your environment, you have to renew your user credentials and the machine credentials if the credentials expired before you perform prepare to restore operations. Use the bpnbat command and -Login option to renew your user credentials, and use the bpnbat command and -LoginMachine option to renew the machine credentials.
Specifying -? displays th e com mand’s usage statement when it is the only option on the command line.
Chapter 1, NetBack up Commands 13

bmrconfig

bmrconfig
NAME
bmrconfig - change con f iguration settings
SYNOPSIS
install_path\NetBackup\bin\bmrconfig -help [-resource
resourceType
[-platform win | hp | aix | solaris | linux] [-manager ldm | lvm | native | sfw | svm | vxvm] [-operation add | change | clearAll | delete | display | list | map]]
install_path\NetBackup\bin\bmrconfig -operation verify -client
clientName -configuration configName
install_path\NetBackup\bin\bmrconfig -operation initialize
-resource disk | network | all
-client clientName -configuration <configName>
-sourceconfiguration source_configName
install_path\NetBackup\bin\bmrconfig -operation initialize
-resource disk | network | all
-client clientName -configuration configName
-sourceclient source_clientName -sourceconfiguration
source_configName
install_path\NetBackup\bin\bmrconfig -operation add | change |
clearAll | delete | display | list | map
-resource resourceType [-name resourceName] [-manager ldm | lvm | native | sfw | svm | vxvm]
-client clientName -configuration configName [-attributes "key=value" ["key=value" ...]]
DESCRIPTION
The bmrconfig command changes a configuration's s ystem, network, volume, driver and NetBackup settings. The read-only current and discovered configurations cannot be changed; use the bmrs command to create a copy of a configuration that you can change.
14 NetBackup Commands for Windows
OPTIONS
-attributes
Attributes of the resource are specified as name-value pairs. The name will always be an alphanumeric string. The value is free form but must be double-quoted. To determine the specific set of attributes that apply to a resource, use bmrconfig –operation list –resource resourceType.
-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.
-help
Prints a command line usage message when -help is the only option on the command line.
-manager
The volume manager that controls the resource. Volu me managers are:
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 Volu me Manager
bmrconfig
-name resourceName
The name of the resource to act on. The valid characters in a resource name are determined by the various volume managers.
-operation operation_name
The operation to perform. Operations are:
add – adds a resource t o the configurat ion 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 all the resources required and optional attributes and values initialize – intitialize a configuration’s hardware from a discovered
configuration
Chapter 1, NetBack up Commands 15
bmrconfig
list – prints all the instances of the specified resource type map – maps a resource, including dependent resources, from the original
configuration to the working configuration
verify - checks that a config has sufficient data for a restore to succeed
-resource resourceType
The type of the resource on which the operation is performed. Resource types are:
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, Linux, and Windows gateway – a network gateway host – a network server hotfix – a Windows hot fix hotsparepool – a set of slices used for SVM failover ip – network identity license – a product license key logicaldrive – a Windows extended partition; first one implicitly
adds container
logicalvolume – an AIX or HP-UX logical volume metadb – a SVM database replica slice mountpoint – a path that serves as an access point to a volume msd – a mass storage drive r multidevice – a Linux multidevice network – a sub network nic – a network interface card nicpkg – a network interface card driver partition – Windows primary partition physicalvolume – an AIX or HP-UX physical volume slice – a Solaris slice; equivale nt to volume softpart – a SVM soft partition volume – a logical division of a disk or disk group
16
NetBackup Commands for Windows
Loading...
+ 487 hidden pages
Buy Points How it Works FAQ Contact Us Questions and Suggestions Privacy Policy Cookie Policy Terms of Use