Using email alerts with License Server

1. Create/Modify the license server configuration file or CNF file

2. Setup LSERVRCCNF variable with CNF file’s path/location

3. Setup the SMTP settings

4. Restart license server

Create/Modify the CNF file

In most installations, the CNF file will be called lservrc.cnf and reside in the license server default directory. It’s recommended that the default name and location are used for this file.

The CNF file broken into sections, one per each feature and version.

[feature_name1 feature_version1]
. . .
[feature_name2 feature_version2]
. . .

Note: on the header (in between brackets), the feature name/version, can be asterisk(*) to represent any license name/version

Each alert-action looks like:

alert-type=reporting-mechanism1 ON/OFF reporting-mechanism2 ON/OFF


· Line continuation is not supported, so all email addresses must fit on one long line.

· The maximum length of a line is 512 characters.

Each section can contain further customizing statements:

EMAIL=email-addr1 email-addr2…

alert-type can be:

· appstart — License issued. May generate a lot of network traffic

· appstop — License returned. May generate a lot of network traffic

· denied — License denied

· apptimeout — License time-out

· expired — License expiration date reached


· There 2 more alert types (softlimit and hardlimit) alert types, and its required values (the limits) can only be set during generation of the license key.

· Due to Hewlett Packard available licensing generation protocols, these values/fields are always set to "Unlimited" by design, therefore its alerts would not get triggered.

Create/Setup LSERVRCCNF variable with CNF file’s path/location

If LSERVRCCNF is not used to specify the configuration file then the name and location of this file will be based upon the name and location of the license code file. In this case the configuration file will reside in the same directory as the license code file and have the same base name as the license code file but with the extension .cnf.

If using environment variable LSERVOPTS only (without LSERVRCCNF), append the following to it: "-e <path>\filename.cnf"

Setup the SMTP settings

1. Run the LSMAIL.exe

2. (First time running it) Input SMTP server address (the mail server) to use. (Default port number is 25. Sender name is "Sentinel RMS License Manager")


· LSMAIL.exe should be in the directory in which the license server resides

· An anti-virus or such a program may block the SMTP port and then alert generation via e-mail will fail. Hence, make sure that SMTP is unblocked on the license server host.

· lsmail will automatically be called by the license server to send email when the alert action specified in the license server configuration file occurs.

To manually run if desired, its options are:

-t recipient-name Email address of the person who will receive the alert message.

-m message-text Text of the alert message.

-s subject Subject (if your email program accepts a subject argument).

To test lsmail, at the DOS prompt type (specifying your email address) say:

lsmail -t "" -m "This is a test" -s "Test"

Restart license server

It is possible to restart the license server software, by simply restarting the "Sentinel RMS" service. If alerts feature appears to still be inactive, reboot entire license server.