Veritas NetBackup™ Commands Reference Guide

Last Published:
Product(s): NetBackup (8.0)
  1. Introduction
    1.  
      About NetBackup commands
    2.  
      Navigating multiple menu levels
    3.  
      NetBackup command conventions
    4.  
      NetBackup Media Manager command notes
  2. 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

bplabel — write NetBackup label on tape media

SYNOPSIS

bplabel -m media_id -d density [-o] [-p volume_pool_name] [-n drive_name | -u device_number] [-host media_server] [-erase [-l]] [-priority number]

 

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\

DESCRIPTION

The bplabel command writes a NetBackup label on the specified media. Labels are required only for the media that were last used for NetBackup catalog backups or by a non-NetBackup application. You can use this command to erase and label the media that is unassigned in a volume database. In addition, you can use this command to assign specific media IDs. The NetBackup Device Manager daemon or service (ltid) must be active for bplabel to succeed. You also must manually assign the drive by using the NetBackup Device Monitor unless you include the -u option on the bplabel command.

Caution:

Ensure that the media does not contain required backups. After the media is relabeled, any backups that were on it cannot be restored.

Any authorized user can run this command.

For more about NetBackup authorization, see the NetBackup Security and Encryption Guide.

The following are some items about how to use this command:

  • The -m and -d options are required.

  • The -p option is required if the media ID is not in the NetBackup volume pool.

  • If the data on the media is in a recognized format and the -o option is not specified, bplabel prompts you to confirm the overwrite. Data format recognition works only if the first block on a variable length media is less than or equal to 32 kilobytes.

  • Use the bplabel command only for tapes.

You must have administrator privileges to run this command.

OPTIONS

-d density

A required option that specifies the density of the tape drive on which the media is mounted. The tape mount request must be performed on a drive type that satisfies the -d option.

Note:

Do not use capital letters when you enter the density. Incorrect density syntax causes the command to fail and an "Invalid Density Drive Type" message to appear.

The valid densities are as follows:

4mm (4-mm Cartridge)

8mm (8-mm Cartridge)

dlt (DLT Cartridge)

hcart (1/2 Inch Cartridge)

qscsi (1/4 Inch Cartridge)

-erase [-l]

This option is used to erase the media. Short erase is the default erase. If -l option is specified, the media is long erased. A long erase operation can take a long time depending on the type of drive.

-host media_server

The media_server variable is the host where the drive is attached. This drive is the drive that is used to mount the media. By default, if this option is not used, the command runs on the local system.

-m media_ID

A required option that specifies the external media ID that is written to the tape label as a media ID. You can enter the media ID in either uppercase or lowercase. Internally, it always converts to uppercase. The media ID must be six or fewer alphanumeric characters.

-n drive_name

Unconditionally assigns the stand-alone drive that drive_name specifies. The drive must contain media and be ready. By using this option, manual operator assignment is not required. The name for the drive can be obtained from the Media Manager configuration.

-o

Unconditionally overwrites the selected media ID. If this option is not specified, bplabel prompts for permission to overwrite the media that meets any of the following conditions:

Contains a NetBackup media header.

Is a NetBackup catalog backup media.

Is in TAR, CPIO, DBR, AOS/VS, or ANSI format.

-p volume_pool_name

This option is required if the media ID is defined in the Enterprise Media Manager Database but is not in the NetBackup volume pool.

volume_pool_name must specify the correct pool.

-priority number

Specifies a new priority (number) for the label job that overrides the default job priority.

-u device_number

Unconditionally assigns the stand-alone drive that device_number specifies. The drive must contain media and be ready. By using this option, manual operator assignment is not required. The number for the drive can be obtained from the Media Manager configuration.

NOTES

tpconfig -d, tpconfig -l, and vmoprcmd may truncate long drive names. Use tpconfig -dl to obtain the full drive name.

EXAMPLES

Example 1 - Label a DLT cartridge media as dlt001

bplabel -m dlt001 -d dlt

Example 2 - Erase the DLT cartridge media with the label dlt102

bplabel -m dlt102 -d dlt -erase

SEE ALSO

See ltid.