Netbackup Cheat Sheet

Master Daemons | Media Daemons | Catalog | Log Files | Server | Volume | Media |
Tape/Robot | Archive | Client

Master Server Daemons/Processes

Request daemon bprd

Scheduler bpsched (started with bprd)
Netbackup database manager bpdbm (started with bpsched)
Job Monitor bpjobd (started with bpdbm)

Media Server Daemons/Processes

Communications daemon bpcd

Backup and restore manager bpbrm (started with bpcd)
Tape Manager bptm (started with bpbrm)
Disk Manager bpdm (started with bpbrm)
Media Manager ltid
Bar code reader avrd (started with ltid)
Remote device management/ controls
vmd (started with ltid)
volume database
Roboticdaemon (one on each media
tldd (started with ltid)
server) talks to tldcd
Robotic control daemon talks to the
tldcd (started with ltid)
robot directl via scsi

Catalogs

Master Server
Information about backed-up files image - /opt/openv/netbackup/db
Storage Unit, Global Configuration,
config - /opt/openv/netbackup/db
Catalog backup configuration.
Backup Policy information class - /opt/openv/netbackup/db
Job status information jobs - /opt/openv/netbackup/db
Netbackup logs with error and status
error - /opt/openv/netbackup/db
information
Information on volumes, volume
volume - /opt/openv/volmgr/database
pools, scratch pool and volume groups
 Media Server
Tracks assigned volumes (media that
media - /opt/openv/netbackup/db
has data them)
Information about devices managed by
device - /opt/openv/volmgr/database
the media server

Log and Information Files

Netbackup and Patch versions /opt/openv/netbackup/bin/version

Media Version /opt/openv/volmgr/version
Patch Level history /opt/openv/netbackup/patch/patch.history
Buffer size /opt/openv/netbackup/db/config/SIZE_DATA_BUFFERS
Number of buffers /opt/openv/netbackup/db/config/NUMBER_DATA_BUFFERS
Network Buffer Size /opt/openv/netbackup/NET_BUFFER_SZ (default = 32)
Java GUI authorisation /opt/openv/java/auth.conf
Catalog type (binary or ASCII) /opt/openv/netbackup/db/config/cat_format.cfg
Netbackup and media manager /opt/openv/netbackup/bp.conf
parameter files /opt/openv/volmgr/vm.conf
Corrupt Database image files (5.0
/opt/openv/netbackup/db.corrupt
and above)

Server Commands

Check license details /opt/openv/netbackup/bin/admincmd/get_license_key

netbackup start
Start Netbackup
/opt/openv/netbackup/bin/initbprd (master)
/opt/openv/volmgr/bin/vmd (media)
netbackup stop
Stop Netbackup (does not disconnect GUI
sessions) /opt/openv/netbackup/bin/admincmd/bprdreq -terminate (master)
/opt/openv/netbackup/bin/bpdbm -terminate (master)
Stop Netbackup and kill all GUI sessions /opt/openv/netbackup/bin/goodies/bp.kill_all
Start the GUI /opt/openv/netbackup/bin/jnbSA
sgscan (solaris)
Scan for tape devices
ioscan (HPUX)
Display all Netbackup processes bpps -a
lists servers errors bperror -U -problems -hoursago <number of hours>
bperror -U -backstat -by_statcode -hoursago <number of hours>
display information on a error code bperror -statuscode <statuscode> [-recommendation]
Reread bp.conf file without stopping
bprdreq -rereadconfig
Netbackup
bpdbm -consistency 1
bpdbm -consistency 2
Check database consistency
Check for the below lines:
Bad image header
Does not exist
Netbackup Recovery
bprecover -l -m <media ID> -d dlt (listing)
Device catalog is intact
bprecover -r -m <media ID> -d dlt (recovering)
bprecover -l -tpath <tape_path> (listing)
Device catalog is gone or corrupted
bprecover -r -tpath <tape_path> (recovering)
bprecover -l -dpath <disk_path> (listing)
Disk backups
bprecover -r -dpath <disk_path> (recovering)

Volume Commands

Tape Drive and Inventory Commands

List drive status, detail
drive info and pending vmoprcmd
requests
List the tape drive status vmoprcmd -d ds
List the pending requests vmoprcmd -d pr
Control a tape device vmoprcmd [-reset][-up][-down] <drive number>
vmupdate -recommend -rt tld -rn 0
List all changes in the
robot(but do not update)
vmcheckxxx -rt tld -rn 0 -recommend
Empty the robot and re-
vmupdate -rt tld -rn <robot number> -rh <silo slave> -vh <host> -nostderr
inventory (using
-use_barcode_rules -use_seed -empty_ie
barcodes)
Tape Media Commands
List all pools vmpool -listall -bx
List tapes in pool vmquery -pn <pool name> -bx
List all tapes in the robot vmquery -rn 0 -bx |grep 'TLD' | sort +4
List cleaning tapes vmquery -mt dlt_clean -bx
List tape volume details vmquery -m <media ID>
Delete a volume from the
vmdelete -m <media ID>
catalog
Change a tapes expiry
vmchange -exp 12/31/06 23:59:58 -m <media ID>
date
Change a tape's media
vmchange -p <pool number> -m <media ID>
pool

Media commands

List the storage units bpstulist -U

Freeze or unfreeze media bpmedia [-freeze][-unfreeze] -ev <media ID>
List media details bpmedialist -ev <media ID>
List media contents bpmedialist -U mcontents -m <media ID>
List backup Image Information bpimagelist -backupid <image ID>
Expire client images bpimage -cleanup -allclients
Expire a tape bpexpdate -d 0 -ev <media ID> -force
List all netbackups jobs bpdbjobs -report [-hoursago]
Move media from one media server
bpmedia -movedb -newserver <media server> -oldserver <media serve
to another

Tape/Robot commands

List tape drives tpconfig -d

List cleaning times on drives tpclean -L
clean a drive tpclean -C <drive number>
change a drives cleaning frequency tpclean -F <drive> <frequency>
set a drives cleaning time to zero tpclean -M <drive>
Move tapes within robot using robtest robtest

commands that can be used are as follows:

s s       (show slots)
s d       (show drives)
s i       (show load port)
m s250 d5 (move tape from slot 250 into drive 5)
uload d5  (unload tape from drive 5)
m d5 s250 (move tape from drive 5 to slot 250)
 m s250 i1 (mov tape from slot 250 to load port 1)

 
List load port tapes echo "s i q" | tldtest -r /dev/sg/c0t4l0
List all slot contents echo "s s q" | tldtest -r /dev/sg/c0t4l0
List tape drive contents echo "s d q" | tldtest -r /dev/sg/c0t4l0
Move a tape in s100 to drive 1 echo "m s100 d1" | tldtest -r /dev/sg/c0t4l0
Move a tape to load port 1 echo "m s100 i1" | tldtest -r /dev/sg/c0t4l0

Archiving Commands

list archive info bpcatlist -client all -before Jul 01 2006

bpcatlist -client all -before Aug 01 2006
archive and remove images bpcatlist -before Jul 01 2006 | bpcatarc | bpcatrm

restore archive files

bpcatlist -before Jul 01 2006 | bpcatres

Client commands

bpclntcmd [-ip <ip addres>]

test client connectivity bpclntcmd [-hn <hostname>]
bpclntcmd [-pn]
bpclntcmd [-sv]
 Netbackup Tips

Glossary

Term Definition
CLI Command Line Interface
GUI Graphical User Interface
Media Server
Master Server

Starting and Stopping Netbackup

Stopping Netbackup
 /usr/openv/netbackup/bin/K77netbackup    --> graceful shutdown
 /usr/openv/netbackup/bin/bpps -a   --> check for any remaining processes
 /usr/openv/netbackup/bin/goodies/bp.kill_all   --->  kills all remaining netbackup
processes, not necessarily graceful
 /usr/openv/netbackup/bin/bpps -a   --> check for any remaining processes
 kill -9 <pid>  for any remaining.   NOTE:  unkillable processes may require a
reboot

Starting Netbackup
 /usr/openv/netbackup/bin/S77netbackup  --> after bp.kill_all, to restart

Common Tasks

Starting the Administration GUI

 java from the windows client
  x-windows from the server - /usr/openv/netbackup/bin/xnb &

Checking Backup Status

 Activity Monitor or
 /usr/openv/netbackup/bin/admincmd/bpdbjobs -report
Cleaning a tape manually
 Identify the drive name to be cleaned
o tpclean -L
 Manually clean the drive:
o tpclean -C <drive name>

Determining what tapes were used for a backup

 GUI
o Backup and Restore --> Find the file system --> Preview Media Button
 CLI
o Find the correct backup images
 bpimagelist -U -client <CLIENT> -d <STARTDATE> -e
<ENDDATE>
o Find the media used for those images
 bpimagelist -U -client <CLIENT> -d <STARTDATE> -e
<ENDDATE> -media

Listing the files in a backup

Find the tape(s) used (above procedure using bpimagelist)

cd /usr/openv/netbackup/db/jobs/done
Run the following script and redirect it's output to a text file:
        for file in `grep MOUNTING *|grep <MEDIA_ID>|awk '{print $1}'|sed
's/:MOUNTING//'`
        do
        echo $file
         grep PATH_WRITTEN $file|awk '{print $3}'
        echo " "
        echo "==========================================End of
Image======================================"
        echo " "
        done

This process works for NBU V3.4:

 cd /usr/openv/netbackup/db/images/<CLIENT>
 ls -ltr  -->  this will identify the directory with the proper date
 verify directory with "bpdbm -ctime <Unixtime>
 cd <Unixtime>
 ls -ltr --> lists all of the backups for this client on this date
 cat <POLICY>_<Unixtime>_<BU Type>.f | awk '{print $10}'  --> this prints out
the files in the backup

For NBU > V3.4

  bpflist  --help   --> undocumented netbackup command to list files from a
binary .f file

Inventory the Robot

 Inventory Robot  -->  /opt/openv/volmgr/bin/vmcheckxxx -rt robot_type -rn
robot_number -list  (where robot_type is tld, acs, . . .)
 Inventory Robot and Update Configuration -->  /opt/openv/volmgr/bin/vmupdate
-rt robot_type -rn robot_number -list  (where robot_type is tld, acs, . . .)

Listing Properties of the Volume Pools

 vmpool -listall

Scratch Tapes
 Count scratch tapes:  /usr/openv/volmgr/bin/vmquery -pn Scratch | grep -c "robot
slot"
 Moving tapes to the scratch pool
o If Needed - Expire the tape
 bpexpdate -ev <TAPE ID> -d 0 -force -host <Media Manager>
o Move the tape
 vmchange -p 2 -m <TAPE ID>

Checking Drive Usage

 /usr/openv/volmgr/bin/vmoprcmd

Taking a drive down or up

 /usr/openv/volmgr/vmoprcmd -down <drive index>
 /usr/openv/volmgr/vmoprcmd -up <drive index>

Performing a Restore
 From the GUI
o user backup & restore --> configuration --> client
o user backup & restore --> configuration --> client to restore
o directory to search
o directory depth
o date range
o file --> browse backups for restore

Adding New Tapes to the Library

 Using the GUI
o Media Management --> Actions --> New --> Single Volume . .  -->
o Media Type (ie DLT)
o Robot Type (ie TLD)
o Media ID (from Inventory)
 o Slot Number (from Inventory)
o Robot Number (ie 0)
o Volume Group
o Volume Pool (ie Scratch)
 Using the CLI
o vmadd -m <media id> -mt <tape type> -verbose -rt <robot type> -b
<barcode> -rn <robot number> -rc1 <slot> -p <pool number> -mm <max
mounts>
 vmpool -listall  --> lists all pools, both name and number
o For example:  vmadd -m 000151 -mt dlt -verbose -rt tld -b 000151 -rn 0
-rc1 8 -p 2 -mm 0

Re-using Tapes from other systems or older Netbackups

 Expire the media
o bpexpdate -ev MEDIA_ID -d 0 -force -host HOST
 Deassign the media
o  vmquery -deassignbyid MEDIA_ID 4 0
 Move to the scratch pool
o  vmchange -m MEDIA_ID -p POOL#
 Relabel the media
o bplabel -ev CIM572 -d dlt -p Scratch

Changing the attributes of media

 Changing the barcode
o vmchange -barcode CYM100D -m CYM100
 Changing the Volume Pool
o vmchange -m MEDIA_ID -p POOL#

To expire media
 bpexpdate -ev <medai id> -d 0 -force -host <media server>

To unfreeze media
 List the frozen media
o /usr/openv/netbackup/bin/goodies/available_media | grep -i FROZEN
 Unfreeze the media
o bpmedia -unfreeze -ev <media id> -h <media server>

To relabel a tape
 bplabel -ev <media id> -d <tape density> -p <pool name>
 bplabel -ev 000687 -d dlt -p TriVrgt_OFFSITE
To remove media from the Netbackup database
 Verify that there are no images on the tape
o bpimmedia -mediaid 000687 -L
 Expire the tape
o bpexpdate -ev 000687 -d 0 -host scorpius -force
 Get the status and pool number of the tape
o vmquery -m 000687
 Deassign the tape
o vmquery -deassignbyid <media id> <pool number> <status code from
vmquery -m>
o vmquery -deassignbyid 000687 4 0x0
 Delete the tape
o vmdelete -m 000687

Installing the Netbackup Client

 /update_clients -ForceInstall -ClientList /tmp/clients.lst
o requires that TMPDIR and TEMPDIR be set correctly

Excludng files from backup on a client

 Create /usr/openv/netbackup/exclude_list
 Put the file specifications of the files/directories to be excluded
o /mnt/directory/*

Displaying Information about a Tape

 vmquery -m <media id>   --> Displays attributes about a particular tape
 bpmedialist -U -mcontents -ev 000687   --> Displays media contents
 bpmedialist -U -mlist  --> List of all media
  bpmedialist -U -mlist -ev CYM966  --> Listing of a particular media id
  bpimmedia -mediaid 000687 -L   --> Listing of images on a tape

Robtest Commands

 Starting robtest
o robtest
o 1  --> to select TLD 0
 Getting help
o ?
 Looking at contents of the tape drives
o sd
 Looking at the contents of the library
o ss
  Moving a tape from a drive to a library slot
o s d  --> to identify drive number that has tape (Contains Cartridge = yes,
Barcode=XXXXXX)
o s s  --> to identify an empty slot in the tape library (Netbackup will need
to be re-inventoried)
o m d# s#  --> from from drive # to slot #
o s d  --> verify the tape drive is empty
o s s --> verify the library slot has the tape

Configuration Files

/usr/openv/netbackup/bp.conf
 configuration file, sets backup server and backup clients
 force statement must be correct
 client to browse from
 client to restore to

/usr/openv/volmgr/vmconf

Logfiles

To utilize logfiles, create the corresponding directory in /usr/openv/netbackup/logs

Server Logfile directories:

 admin - adminstrative commands
 bpbrm - backup and restore manager
 bpcd - client daemon
 bpdbjobs - database manager program process
 bpdm - disk manager process
 bpjava-msvc - Java application server authentication service
 bpjava-usvc - process that services Java requests
 bprd - request daemon process
 bpsched - scheduler process that runs on master servers
 bptm - tape/optical media management process
 user-ops - required directory for use by Java programs
 xbpadm - X based administration utility
 xbpmon - X based job monitor process

Client Logfile directories:

 bp - client user interface process
 bparchive - archive program
 bpbackup - backup program
 bpbkar - program that generates golden images
 bpcd - client daemon
  bpjava-msvc - Java application server authentication service
 bpjava-usvc - process that services Java requests
 bplist - program that lists backed up and archived files
 bpmount - program that determines local mountpoints  and wildcard expansion
for multiple streams
 bphdb - Oracle database backup program start process
 db_log - database specific extension log
 tar - tar process log during restores
 user_ops

Media Manager logging automatically goes to the system log using syslogd logging
facility

.Logging will only occur if these directories are created.  These directories will generate a
lot of data and should be deleted when no longer necessary.

To increase the amount of logging information set VERBOSE=2 in

/usr/open/netbackup/bp.conf  (default is VERBOSE=1)

Processes

ltid
acsd
vmd

Useful Commands

bpcllist - list classes

bpclinfo <class> -L   --> displays info about a class
vmpool - volume pools
vmpool -listall
vmpool -listscratch
bplabel -ev <media id> -d hcart
bpbackup db  --> backs up the catalog
bpclclients <policy>  --> lists the clients for a particular policy (class)

Troubleshooting

bperror -statuscode   <-- displays information about the  netbackup error.

No Backups are running:

 Check system log file for error messages
 Stop and restart all the netbackup processes
 Look for a downed drive
 o /usr/openv/volmgr/bin/vmoprcmd
o /usr/openv/volmgr/bin/vmoprcmd -up 0   --> this will bring up drive 0 if
it's control shows as down
 Look for pending requests
o /usr/openv/volmgr/bin/vmoprcmd or gui --> device management
o If there is a pending request either re-assign it to a drive, or deny the
request

Downed drive does not come back up or does not stay up

 Check for a hardware problem by looking for messages on the tape library
 Make sure there is not a tape stuck in the drive
o Use robtest (described above) to look at the drives
 If there is a tape stuck in the drive, try to remove it using robtest
 If robtest fails, then you must manually remove it.

Verify the Client is communicating properly:

 bpclncmd -ip  <ip address>  --> from both client and server
 bpclntcmd -hn <hostname>  --> from both client and server
 bpclntcmd -pn    -->  from client only

Device Actions

Device Management --> info about tape drives

 dlt
 hcart (ultrium)

Media Actions

Media id must agree with # of the tape

Create a media id
 actions -->new-->single volume-->dlt cart (not dlt2)
 put it into the "netbackup" volume pool

Netbackup Client

To check things out do this:

It could be a couple things.  Mostly DNS, bp.conf, or something stupid.  On

the client run this command
/usr/openv/netbackup/bin/bpclntcmd -pn

/usr/openv/netbackup/bin/bpclntcmd -server "server name"

/usr/openv/netbackup/bin/bpclntcmd ip "ip_address"

One of these usually fails and your able to fix it right off

1074  ./bpclntcmd -hn corpbu1

 1075  ./bpclntcmd -ip 10.194.1.129
 1076  ping 10.194.1.129
 1077  ./bpclntcmd -hn corpldv1
 1078  ./bpclntcmd -hn corpbu1.corporate.vox.net
 1079  ping corpldv1
 1080  ./bpclntcmd -ip 10.194.1.120

Must be able to resolve correctly from the master server and the client or it will not
work!!!