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!!!
