Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
DOCUMENTATION: How to
configure email notifications for
Windows clients using BLAT and
nbmail.cmd in Veritas NetBackup
(tm)
Article:000025818
Publish:January
January 14, 2016
Article URL:http://www.veritas.com/docs/000025818
http://www.veritas.com/docs/000025818
Support / Article
SIGN IN
Remember me
Forgot Password?
Don't have a Veritas Account?
Create a Veritas Account now!
Print Article
Products
Related Articles
Article Languages
Subscribe to this Article
Manage your Subscriptions
Problem
Solution
Manual: NetBackup (tm) System Administrator's Guide, Volume 1 for Windows
Modification Type: Supplement
Modification:
This document is designed to give a complete list of steps to configure Windows email
notification in NetBackup. It will be necessary to have the following information to
properly set up email notifications:
The email address of the NetBackup administrator who will receive the emails
It should be noted first that this document is primarily focused on Windows based
platforms. UNIX platforms have a built-in Simple Mail Transport Protocol (SMTP)
transfer method that Windows does not have. Windows requires a MAPI application or
some other application that can transfer messages over SMTP. NetBackup has
various .cmd files that assume an SMTP utility called BLAT is in place. The .cmd files
that will be discussed assume BLAT is going to be used as the SMTP utility.
BLAT is a open source utility and the most recent version of BLAT can be downloaded
from this site: http://www.blat.net/
Note: Blat is a third party product. It is not written, endorsed or supported by
Symantec. Any problems with blat should be reported to the makers of blat directly.
Symantec will be unable to assist with issues that are encountered when installing or
using blat.
I. Installing and Configuring the BLAT executable
1. Download the .ZIP file from the download page specified above
2. Extract the files to their own folder.
Note: Most of the files in this .ZIP file are informational and is source code for
developmental purposes.
3. Copy the blat.exe file to the \WINNT\System32 directory in Windows
4. From a command prompt, run the following command (Note: This will be the primary
account that will send the emails from the specified server):
% blat -install <server addr> <sender's addr> 4 25
Note: "<server addr>" is the hostname or IP address of the email server that will send
the email notifications.
"<sender's addr>" is the account that will be the primary sender of the email
notifications. Tries (4) and port (25) is added to the end.
Example:
% blat -install emailserver.company.com useraccount@company.com
4 25
5. Test the installation of blat by creating a text file C:\testfile.txt with a message and
emailing it to the NetBackup administrator.
% blat C:\testfile.txt -s test_subject -to useraccount@company.com
If blat is working correctly, the NetBackup administrator should receive the contents of
the C:\testfile.txt file.
Note: Blat stores its configuration information in the Windows registry. If you need to
confirm any default Blat settings, they can be found
under the following registry path: HKEY_LOCAL_MACHINE/SOFTWARE/Public
Domain/Blat.
Warning: Incorrect use of the Windows registry editor may prevent the operating
system from functioning properly. Great care should be taken when making changes to
a Windows registry. Registry modifications should only be carried-out by persons
experienced in the use of the registry editor application. It is recommended that a
complete backup of the registry and workstation be made prior to making any registry
changes.
1. Open nbmail.cmd using notepad.exe or some other text editor. The file can be
found on a NetBackup Server/Client install for Windows
at <install_path>\VERITAS\NetBackup\bin. If the file does not exist,
check <install_path>\VERITAS\NetBackup\bin\goodies and move
to <install_path>\VERITAS\NetBackup\bin. Please make a backup copy of this script
before modifying it.
Note: When using Notepad to modify a script do not use the Word Wrap option. If this
option is enabled, then it will need to be unchecked. Using this option can result in
extra line feeds being added to the script which will render it non-functional.
2. Most of the lines in the nbmail.cmd file are informational. The following line(s) are
what need to be adjusted:
@REM ) ELSE (
@REM )
3. Remove "@rem" from the beginning of each line. This will activate the sections
needed for blat to run.
4. Replace "WARTHOG" with the name of the email server. An example of how this line
should now appear is (please note the change of parameters for newer versions of
BLAT):
) ELSE (
) ELSE (
@IF "%~4"=="" (
) ELSE (
@REM -
This email address will appear in the "From:" field in the email. The reason for this is
that some email servers may not process the mail if it is from "NetBackup" as opposed
to a valid email address.
File list
---------
Options explained:
is the file that BLAT will send in the body of the email. This is generated
%3
2.6+)
%2 is the contents of the subject line. This is generated by another script that
To allow a specific client to send emails for all successful and failed jobs, do the
following:
1. Open the NetBackup Administration Console
2. Open the Host Properties for the Client and go to the Universal Settings tab
3. Under the Administrator section of this page, enter the email address for the
NetBackup administrator in the field calledClient Administrator's e-mail (separate
multiple entries with commas)
NetBackup should send email notifications at this point. To get more information sent to
the administrator configure some of
the<install_path>\VERITAS\NetBackup\bin\*.cmd files. This would result in additional
information for the administrator.
Providing more email address for BLAT can be done by adding additional email
addresses after the %1 in the nbmail.cmd file. Here is an example of the syntax
required:
) ELSE (
Configured this way, four emails will be sent out. It is important to separate the email
addresses with commas (,) and no spaces in between.
V. Troubleshooting BLAT
1. It may be necessary to do some troubleshooting of BLAT. If BLAT is run from a
straight command line, and it has an error, it will produce a message in the command
line results. To make a "log" file for BLAT, make an entry at the end of
the nbmail.cmd"@blat" line similar to this:
Example on NetBackup 4.5 and 5.x systems:
) ELSE (
This will create a .txt file in the specified directory and will append to the bottom of that
file. If there is an error message from BLAT it will show in the specified file.
2. There have been instances where email notification is working, but Vault will not send
reports correctly. To correct this, a modification to the "blat" line in the nbmail.cmd file
is necessary. If you are experiencing this, make the following modification to
the nbmail.cmd file:
Example on NetBackup 4.5 and 5.x systems:
@blat %3 -s %2 -t %1 -i NetBackup -server emailserver.company.com -q -mime
@IF "%~4"=="" (
) ELSE (
3. There have been instances where email notification is configured correctly, BLAT is
configured correctly, but emails are not received. Try making the following modification
to the nbmail.cmd file:
Example on NetBackup 4.5 and 5.x systems:
@blat %3 -s %2 -t %1 -i NetBackup -server emailserver.company.com -q enriched
) ELSE (
Create/Manage Case
SOLUTIONS
Healthcare
Government
PRODUCTS
Business Continuity
Storage Management
Information Governance
Products A-Z
SERVICES
Education Services
Consulting Services
Managed Services
Appliance Services
CUSTOMER CENTER
Support
Community
MyVeritas
Customer Success
Licensing Programs
Licensing Process
ABOUT
Corporate Profile
Corporate Leadership
Newsroom
Corporate Responsibilty
Careers
Sitemap
Legal Terms
Privacy
Contact