Netbackup Help

Netbackup Help Overview
Bp.conf settings
Commands
Daemons and Processes
Logging
Troubleshooting

Overview

Device type:

txx[c]d
1st x is device type == l(ibrary), s(tacker), c(artridge)
2nd x is media type == 4(mm), d(LT), 8(mm), h(alf-inch)
[c] == library control drivers for some library types

The tar used by Netbackup is GNU tar and is located in /usr/openv/netbackup/bin.

Restores To Alternate Clients

This works similar to how a rhosts file works.

To allow a client to restore from another client.

Create on the master, the file /usr/openv/netbackup/db/altnames/clientname.
Where clientname is the client you want to restore on.
If you want to limit the access, then include in the file any clientname that this client can get data from.

On myclient you want to restore to myclient any other clients data:
touch /usr/openv/netbackup/db/altames/myclient
On myclient you want to restore to myclient restricting to ONLY thatclient:
vi /usr/openv/netbackup/db/altames/myclient; insert "thatclient";save

To allow ALL/ANY client to restore from any other client. Note: This is a security hole.

Create on the master, the file /usr/openv/netbackup/db/altnames/No.Restrictions

Retention Times

Level      Period
0           1 week
1           2 weeks
2           3 weeks
3           1 month
4           2 months
5           3 months
6           6 months
7           9 months
8           1 Year
9-24      Infinity

Media States

Note: A tape/media can have multiple states at one time. i.e. "ACTIVE & MPX"

Media State Reason Method to Change
FULL At Capacity bpexpdate or GUI
SUSPENDED Errors bpmedia
FROZEN Format bpmedia/bplabel ALLOW_MEDIA_OVERWRITE
IMPORTED From another cluster/refresh  
ACTIVE Current images bpexpdate or GUI
AVAILABLE Tape is currently unassigned  
MPX Tape contains multiplexed backups  
DBBACKUP Tape contains Netbackup catalog  

Logging

Levels of logging can be changed by:
Adding VERBOSE to the /usr/openv/netbackup/bp.conf.
The level number can be changed by setting VERBOSE = #, where # is from X-X

Log directories must exist before the process starts for logging to occurr.
Activity Logs: A new log is created daily, kept for 28 days (default). File anme log.mmddyy.
Process Logs: filename mmddyy.log.
Note: some daemons have a '-verbose' option.

Activity Logs Locations

The processes in the following table need to have a directory created using their name in /usr/openv/netbackup/logs BEFORE they are started for logging to occurr.

Note: The Media Manager logs vmd (/usr/openv/volmgr/debug/daemon) and process requests daemon (/usr/openv/volmgr/daemon/reqlib).
Media, robotic, network, and devices output via syslog to /var/adm/messages.

Process Master Server Media Server Client
bprd X    
bpdbm X    
bpsched X    
bpjobd X    
bpcd   X X
bpdrm   X  
bptm   X  
bpdm   X  
admin * X X X
bpbkar     X
user_ops * X X X

* highlights that these are not exactly processes, but directories and these directories should NEVER be deleted.

Troubleshooting

If jobs complete with status code of 96, 213, or 219:
Verify that Media Type = Drive type = Storage Unit Robot Type.

Jobs stuck in queue:

Check that the settings for the polichy are correct;also ensure that the specified Storage Unit is set up properly.

Tape mounts listed by files:

$NETBACUPHOME/db/media/tpreq

Bp.conf settings

/usr/openv/netbackup/bp.conf settings
VERBOSE

Daemons & Processes

  Master Server Media Server Client
Netbackup Arena
Daemons bprd, bpdbm, nbdbd, bpjobd    
Processes bpsched, start_nbdbd bpcd, bpbrm, bptm bpcd, bpbkar
Databases Class, Config, Jobs, Images, Error, Client Media  
Media Manager
Daemons vmd ltid, txxd, txxcd, avrd, vmd  
Processes   tpreq, tpunmount  
Databases Volume, Volume Pool Device  
Process Name Function Activated By Activates/Invokes Description
bprd Request Daemon N/A (daemon) bpsched (periodially) Listens for, and responds to, client requests
bpsched Scheduler bprd bpdbm, bpcd (media server) Checks policy configureations (through bpdbm)
for scheduled client backups (if a backup is due,
it commands bpcd to activate bpbrm).
bpdbm Netbackup Database Manager bpsched bpjobd Maintains Netbackup catalogs.
bpjobd Job Monitor bpdbm (primarily),
but other functions
invoke it as well		 none Performs queries and updates of the jobs database.

Netbackup Programs and Services/Daemons - Functional Areas 

          MASTER                     MEDIA                     CLIENT 

  NBU Mgt Infc
  (nbconsole.exe)
             |                                               +--------------+
             v                                               | nbinw.exe, bp|
            bprd<--------------------------------------------| jbpSA, xbp   |
             ^                                               | bpbackup     |
  (metadata) |                                               +--------------+
    +-----+  |
    |     |  |
    |     |  |                       +--->bpcd---+
    |     |  |                       |           |
    |     |  v                       v           |
 bpdbm<-->bpsched<------------->(bp)inetd       bprm
  ^  ^         ^                                ^^
  |  |         |        (metadata)              ||
  |  |         +--------------------------------+|
  |  |                                           |
  |  +-----------+                               |
  v              |                               |
bpjobd           |                               |
  |              v                               |
  |        +----------+      +---------+         |
  |        | CATALOGS |      |  media  |         |
  |        |----------|      | catalog |         |
  |        |  -class  |      +---------+         |
  |        |  -config |           ^              v
  |        |  -image  |           +----------->bptm
  |        |  -error  |                         | 
  |        | -------- |       +-------+         |
  +------->|  -jobs   |       | o   o |<--------+
           +----------+       +-------+

Commands

NBU Command Path Action
User Commands
bparchive /test /usr/openv/netbackup/bin Invoke a user archive of all files in /test.
bpbackup /test /usr/openv/netbackup/bin Invoke a user backup of all files in /test.
jbpSA /usr/openv/netbackup/bin Opens netbackup user interface.
Admin Commands
available_media /usr/openv/netbackup/bin List library media, slots, and state.
bpbackup -p test -s full -i -h somehost -t 13 /usr/openv/netbackup/bin Invoke a manual backup using the schedule full of the poilcy called test on host somehost.
bpbackupdb -m XXXXXX /usr/openv/netbackup/bin Use alternate media XXXXXX to backup Netbackup catalogs.
bpduplicate -hoursago 24 -dp duplicate -dstunit stu3 /usr/openv/netbackup/bin Duplicate all backups done in the last 24 hours to the duplicates volume pool on storage unit stu3.
bpclntcmd [-pn, -sv] /usr/openv/netbackup/bin -pn: Run on client to list master connection and sockets
-sv: Lists NBU version
bpexpdate -m MEDIA_ID -d 0
bpexpdate -recalculate -backupid BACKUP_ID -ret 2		 /usr/openv/netbackup/bin/admincmd Expires all images on a volume (tape)
Modify the expiration of the b ackup ID to retention level 2
bpimport -create_db_info -id XXXXXX -server servername -L /tmp/mylog
bpimport -Bidfile /tmp/import/images -L /tmp/mylog		 /usr/openv/netbackup/bin Create volume catalog entries for media and log the process in logfile.
Import the images listed in the bacukpID file
bplist -l -R /usr /usr/openv/netbackup/bin List recursively, in long format, the files that were backed up for the /usr directory.
bpps -a /usr/openv/netbackup/bin Lists all NBU/MMGR daemons & processes.
bpmedia -ACTION -m MEDIA_ID [-h media_server]
ACTION: freeze, unfreeze, suspend, unsuspend		 /usr/openv/netbackup/bin/admincmd Change media state.
bplabel -m MEDIA_ID -d DENSITY -p VOLUME_POOL -o /usr/openv/netbackup/bin/admincmd Write Netbackup label on the specified volume
bprestore -C client-name -D destination-name -L /tmp/mylog /work /usr/openv/netbackup/bin restore from client to client via the /work file list and log to /tmp.
bpverify -hoursago 8 /usr/openv/netbackup/bin Verify all backsups performed in the last 8 hours
jnbSA /usr/openv/netbackup/bin Opens netbackup admin interface.
netbackup [start] /usr/openv/netbackup/bin Starts all NBU/MMGR daemons & processes.
netbackup stop /usr/openv/netbackup/bin Kills all NBU/MMGR daemons & processes.
tpclean -L /usr/openv/volmgr/bin Lists cleaning statistics.
robtest
  (m s2 d1 #moves media from slot to to drive 1)
  (s s #displays status of all slots)
  (s d 1 #displays status of drive 1) 		/usr/openv/netbackup/bin Runs robotic test. Must be on media server, must exit when finished, interferes with backups.
vmadd -m MEDIA_ID -mt dlt -b MEDIA_ID -rt tld -rn 0 /usr/openv/volmgr/bin Add volume with barcode MEDIA_ID to TLD(0).
vmchange -p POOL_NUMBER -m MEDIA_ID /usr/openv/volmgr/bin Associate volume with another volume pool.
vmdelete -m MEDIA_ID /usr/openv/volmgr/bin Delete volume MEDIA_ID (all its images are lost).
vmcheckxxx -rt tld -rn 0 /usr/openv/volmgr/bin Compare volumes in robot TLD(0) for mismatch.
vmcheckxxx -rt tld -rn 0 -list /usr/openv/volmgr/bin Show contents of robot TLD(0).
vmupdate -rt tld -rn 0 /usr/openv/volmgr/bin Update volume config for robot TLD(O).
vmquery -a /usr/openv/volmgr/bin Lists all volume info for volume database.
vmpool -listall -b /usr/openv/volmgr/bin Lists all pools configures on master.

Command changes from 3.4 to 4.5

bparchive -class NAME
bparchive -policy NAME
   -t class TYPE
   -t policy TYPE

old 3.4 command new 4.5 command
bpclassnew bppolicynew
bpclclients bpplclients
bpcldelete bppldelete
bpclexclude bpplexclude
bpclinfo bpplinfo
bpcllist bppllist
bpclsched bpplsched
bpclschedwin bpplschedwin
bpcvalid bppvalid