Video Screencast Help

Making your life easier with NetBackup

Created: 28 May 2012 • Updated: 05 Aug 2012 | 9 comments
Language Translations
mph999's picture
+15 15 Votes
Login to vote

 

 

This entry is intended to cover a number of issues that I see time and time again with members posting questions on the forum, and from my experience as a NBU TSE.
 
The advice below is intended ...
 
(1) To make your life easier
(2) To assist in making a quicker resolutions
 
 
 
(A)
 
Command Issues
***************
 
 
A common question - Where is the <command> I cannot find it ?
 
 
The vast majorty of NetBackup binaries are located in the following directories, therfore by simple looking, you should find the command.  You could also search, using the search feature in windows, or the find command in Unix.
 
Unix/ Linux
 
/usr/openv/netbackup/bin
/usr/openv/netbackup/bin/support
/usr/openv/netbackup/bin/admincmd
/usr/openv/volmgr/bin
 
There are also so 'scripts' available in /usr/openv/netbackup/bin/goodies
 
Windows
 
<install path>\veritas\netbackup\bin
<install path>\veritas\netbackup\bin\support
<install path>\veritas\netbackup\bin\admincmd
<install path>\veritas\volmgr\bin
 
There are also some 'scripts' available in <install path>\veritas\netbackup\bin\goodies
 
 
It is even easier, if you add these paths to the PATH variable of the operating system.  This allows you to run commands without having to type in the comlete path each time, or, cd to the directory.
 
Unix:
 
Add the directories to the PATH variable in the .profile file in the home directory of the user you log in as.
 
For example ;
 
PATH=$PATH:/usr/openv/netbackup/bin/admincmd:/usr/openv/netbackup/bin:/usr/openv
/netbackup/bin/goodies:/usr/openv/netbackup/bin/support:/usr/openv/volmgr/bin:/u
sr/openv/java:/netbackup:/opt/sfw/bin:/netbackup/scripts:/opt/VRTSaz/bin/vxazd:/
opt/VRTSat/bin/:/opt/VRTSaz/bin/:/opt/vormetric/mseo/server/bin:/opt/vormetric/m
seo/agent/bin:/usr/openv/db/bin
 
Windows:
 
Add the directories the the PATH user variable (Right click computer, Properties, Advanced System Settings, Environment Variables (Path is under System variable ), For example.
 
C:\Perl\site\bin;C:\Perl\bin;C:\Oracle\Ora92\bin;C:\Program Files\Oracle\jre\1.3.1\bin;C:\Program Files\Oracle\jre\1.1.8\bin;C:\Program Files\RSA SecurID Token Common;%SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;%SYSTEMROOT%\System32\WindowsPowerShell\v1.0\;C:\Program Files\Symantec\pcAnywhere\;C:\Program Files\QuickTime\QTSystem\;C:\Program Files\Enterprise Vault\EVClient\;C:\Program Files\Symantec\Workspace Virtualization\;C:\Program Files\Veritas\NetBackup\bin;C:\Program Files\Veritas\NetBackup\bin\admincmd
 
 
(B)
 
Insufficient information
************************
 
 
Starting a post with a question such as ...
 
My media is getting frozon during a job, what do I do ?
 
 
.. is virtually useless, EVERY post should be started with information simailar to these questions ...
 
 
 
Initial Information recommended for all issues:
 
1.   The exact error message (if an error is given)
2.   During which type of operation does the problem occur ?  For example, Backup, Duplication, Vault, Restore etc.
3.   At what point in the job does the issue occur, for example, right at the beginning.
4.   Which system(s) are involved? For example, Master Server, Media Server - Please provide system names.
5.   Please submit the support report from the master and any relevant Media Servers in the environment.
6.   Is this a reoccurring issue ?
7.   What was the system doing at this time ?
8.   Please send in the contents of the details tab in the Activity Monitor for the job.
9.   What logs or screenshots are available?
10. Has this worked previously?  If so, when was the last time it DID work?
11. Have there been any environmental; system; or configuration changes?
12. When did the problem begin?
13. How often does the problem occur?
14. Is a similar configuration working properly?
 
 
(C)
 
Is NetBackup the cause
**********************
 
Many NetBackup issues, commonly, Tape/ Library issues and Networking issues are nothing to do with NBU, and the issue cannot be fixed through NetBackup commands.
 
NetBackup often reports and issue, but is nothing to do with the cause.
 
Consider this:
 
If you uninstall NetBackup, what are you left with  ???   Hopefully ...
 
An operating system
A network
Storage devices, tape or disk
 
So. straight away, it can been seen that that these three things are totally separate from NBU.
 
Clearly there is 'interaction' between them, for example, tape drives are 'configured' in NetBackup after all, but NetBAckup does not control these and if the advice given is to investigate from a hardware perspective, or OS issue, this is exactly what needs to be done.
 
In my experience, the majority of Network and Tape /Library issues have nothing to do with NetBackup, and the investigation should start with the vendor / network support.
 
 
 
(D)
 
NetBackup Engineers are not hardware engineers.  If you have a hardware issue, speak to hardware type people ...
 
 
(E)
 
Document your system.
 
 
Any backup environment should be documented, with the documents kept up-to-date.  An excellent start to this is to run :
 
nbsu -c -t  every day and keep the outputs, (perhaps back them up to tape.)
 
You will note I have not told you exactly where this command is, please see point (A).
 
 
 
(F)
 
Logs:
 
On occassion, we will ask for logs ...
 
See this technote, it contains everything you need to know.  
 
 
 
When you send logs in, if the issue happens at say 15.00, we don't need the past weeks worth of logs, edit the log down so you send in for example, 14.30 - 16-00.  (Note, sometimes the logs will be needed for a longer period, but usually / generally, the logs areound the time of the issue are fine).
 
Also, please rename logs to the process name (NOT for the case of Unified logs (see technote above).)
 
NetBackup defines different (legacy) logs simply by the folder name they are in, which isn't ideal.  This means if we ask for say bptm and bpbrm log, both will have exactly the same filename (log.<date>).  Please rename these to <process_name>.log.<date> )
 
The nbcplogs command is very good, it simplifies the collections of logs.
 
Have a go at learning to use this command.
 
http://www.symantec.com/docs/HOWTO43784
 
You should be able to set up logs without assistance, all that should be required is that we ask, pleased send bptm, bpbrm logs from the media server, or, please send vx logs 111, 116, 117, 118.  You should automatically know that these should be gathered, probably with the verbose levels increased.
 
 
(G)
 
Every log sent in for a problem, must cover the same time period.  It is no good sending in bptm from Monday and bpbrm from Tuesday, yes, people actually do this ...
 
(H)
 
 
If we ask for (example) bpmedialist -m <media id>, please DO NOT send the binary.  Please run the command and send the output.
I'm sure your binaries are very nice, but I have some of my own - thanks.
 
 
(I)
 
Our favorite question is "What changed".  The usual answer is "Nothing has changed".
 
Generally speaking, NBU does NOT break on it's own, 99% of the time, something HAS changed.
 
I've not yet worked out if people just have no idea who is changeing what and when, or if they just deny making any changes - but if a change has been made, we will find it, it just may take considerable time, adding days or even weeks to the time it takes to resolve an issue.
 
It's better to be truthful and say "I am not aware of any changes" than categorically deny that any changes have been made.
 
(J) 
 
If you make a change, write it down somewhere (preferably in a change file on the system) - see (I) above
 
(K)
 
Backups fail, get used to this idea, it is part of being a backup administrator.
Do NOT start making changes because of a single failure, this leads to broken systems.
 
(L)
 
If you make a change, and it does not fix the problem, revert it.  DO NOT MAKE MULTIPLE CHANGES WITHOUT RECORDING THEM.
It can be very very difficult to find an issue, if multiple changes have been made that cause the same symptoms.
 
Consider this :
 
I go home and the light does not work.  (Unknown to me, the fuse is broken)
 
I have three possibilities
 
The light switch is broken
The light bulb is broken
The fuse is broken
 
I decide to change the bulb, unfortunately the bulb I put in is also broken.
 
(I have now introduced another 'fault' that gives the same symptoms as the originally fault).
 
Next I change the fuse, but due to the broken buld, the light does not work.  Unknown to me, I have now fixed the originally issue, but I cannot tell due to the faulty bulb fitted,
 
So, from this example you can see how it is possoible to to completely break a system - avoid doing this.
 
 
(M)
 
NetBackup Engineers are not network engineers, if you have a network issue, go and talk to network type people
 
 
(N) 
 
Just because NetBackup reports and error, DOES NOT mean it caused the error.  This is particularly true for network, tape and library issues.
 
(O)
 
 
If your systems/ issue fits a description in the technote, no matter how many times you ask, the answer will be the same.
 
(P)
 
Hardware vendors often blame NBU, especially when it comes to tape/ library issues.  This is why the technote in (O) was written, to help prove that NBU is not at fault.
 
 
(Q)
 
Any backup system MUST be designed before being installed, else it WILL fail.  Backup design does NOT start with pressing buttons, it starts with a peice of papaer and a pen.
 
(R) 
 
If you want to know how to do something, try looking in the manuals.
 
 

MASTER Compatibility list: http://www.symantec.com/docs/TECH59978 
Master Download List : http://www.symantec.com/docs/TECH65429
Late Breaking News Links : http://www.symantec.com/docs/TECH74904
NBU 6.5 Documentation: http://www.symantec.com/docs/TECH52878
NBU 7.0 Documentation: http://www.symantec.com/docs/TECH126327
NBU 7.1 Documentation: http://www.symantec.com/docs/TECH154178
NBU 7.5 Documentation: http://www.symantec.com/docs/DOC5138

HOWTO Videos: http://www.symantec.com/docs/HOWTO41825

(S)
 
These are the 'minimum' skills thay ANY NetBackup Administrator should have ...
 
 
1/ Create and correctly collect NetBackup logs for a given time period ( seehttp://www.symantec.com/docs/TECH75805 )
2/ Understand when NetBackup probably isn't the cause (see http://www.symantec.com/docs/TECH169477 )
3/ Understand Operating system commands to list attached hardware, change /create directory, edit a file, configure network
4/ Understand basic NetBackup concepts :
 
Setting up policies
Configure devices via Device Wizard
Delete devices
Use and undersnd trhe meaning of results in scan/ tpautoconf / scsi_command (hint, see point (O)
Understand on which machine the basic NBU processes run
Run backups from the GUI
Run restores from the GUI
 
Master = nbemm/ bprd/ nbjm/ nbemm 
Media = bpbrm / bptm
Client = bpcd / bpbkar / tar
 
Understand the basic principles of a catalog backup and how to set it up
Understand that NetBackup DOES NOT CONTROL your network, we ONLY use what we are given
Understand that NetBackup does NOT write/ read  to/ from tape - this is done by the operating system
 
Understand the idea of 'density' (eg. hcart, hcart2 etc ...)
Understand barcode rules, media id generation rules and how to set them up
Understand how to inventory a library
Understand how to use the robtest command and the meaning of the output
Undersnad the difference between multi-streaming and multi-plexing
Understand the idea of storage units
Understand the idea of media pools
 
 
If you are stuck on any of these, first thing, see point (R)
 
 
(T)
 
It is not the job of people on the forum (or Symantec support) to read the manuals for you
 
(U) 
 
If something is unsupported (ie. not in the manuals) DO NOT DO IT.
 
(V)
 
When you are asked to do steps 1, 2, 3, 4, 5    Please ensure you do ALL the steps, and not just the ones you feel like doing.
We don't ask for the steps because we have nothing better to do, we ask for them because we need ALL of them.
 
(W)
 

Please do not make changes just because you can.  Any change to a system should be fully justified, researched, and recorded accurately in the system documentation.

The system documentation should be so detailed, it contains every change made and when, and the current setting of EVERYTHING that has been changed from the default  - are you doing this ?

 

Comments 9 CommentsJump to latest comment

Zahid.Haseeb's picture

 

A common question - Where is the <command> I cannot find it ?
as far as linux is concern you can find the command by typing :
 
#whereis Command_Name

Any comment will be appreciated. Mark as Solution if your query is resolved
__________________
Thanks in Advance
Zahid Haseeb

zahidhaseeb.wordpress.com

0
Login to vote
mph999's picture

I suspect this is similar to 'which' in Solaris ...

eg which bpmedialist

This will only return the path if the directory the command is in is alraedy in the systems PATH variable.

Not sure if this is the same for Linux, but I suspect it is.

Martin

 

Regards,  Martin
 
Setting Logs in NetBackup:
http://www.symantec.com/docs/TECH75805
 
0
Login to vote
Andy Welburn's picture

Just had to follow this up - seems like both are (possibly) on both OS's.

whereis (on our Solaris shows as a SunOS/BSD Compatibility Package under /usr/ucb)

whereis - locate the binary, source, and manual  page  files
for a command

attempts to locate the desired program in a list of standard places:

or

has a hard-coded path, so may not always find what you're looking for.

which

which - locate a command; display its pathname or alias

searched for along  the user's path.

or

 by searching for an executable or script in the directories listed
 in the environment variable PATH

So, had a little 'fun' with: which which, which whereis, whereis which or whereis whereis

0
Login to vote
Zahid.Haseeb's picture

if more info required about the work of both commands just do man whereis OR man which on solaris or even linux :)

Any comment will be appreciated. Mark as Solution if your query is resolved
__________________
Thanks in Advance
Zahid Haseeb

zahidhaseeb.wordpress.com

0
Login to vote
tushar.dahibhate's picture

nice artical for new one's

0
Login to vote
rajeshthink's picture

Good Post angel

 

cheer,

Rajesh Kumar

0
Login to vote
TroyDegarnham's picture

Thanks for the article. It works like a personalised and detailed "FAQ" sheet especially for new users. Maybe if you could add screenshots to complement each pointer you gave, would be even more clearer and easier to understand. I know you have already provided simple step-by-step instructions to follow, but images are very helpful and would make our lives even more easier.

+1
Login to vote
ankmah's picture

 

 
mph999.. Thanks
 
This info is very useful.
 
 
0
Login to vote
mansoor.sheik's picture

Good Article.

0
Login to vote