Installation: Permanent License

Usage of Ada-ASSURED is controlled by the Globetrotter FLEXlm License Manager, a third-party application software package. The purpose of the license manager software is to control the number of simultaneous users of a licensed copy of Ada-ASSURED. It restricts the use of Ada-ASSURED to the number of users specified in the licensing agreement.

For a permanent installation of Ada-ASSURED, you will need to have the FLEXlm License Manager running on the license server machine.

The license manager software is composed of four parts:

the license file: license.dat,
two daemons: lmgrd and aa.d,
license administration tools: lmhostid, lmutil, and
the license options file: license.opt.

In order to enable Ada-ASSURED, the following is required:

The license manager daemon lmgrd must know about Ada-ASSURED's daemon (aa.d).
The license file license.dat must be accessible to Ada-ASSURED.

License Manager

License management can be complicated depending on how many applications your site has that use FLEXlm and how you have chosen to set up the daemons. Be careful to follow all the steps needed for your site.

If you are already running the FLEXlm license daemon lmgrd on the license manager machine, follow the instructions in step A; depending on your choices, you may need to follow step B and step C as well.
If you are not running the FLEXlm license daemon lmgrd, skip step A and begin with step B.

Step A: Already Running a License Manager Daemon.

If you already have FLEXlm running at your site, then you have two choices:

Choice 1 (Recommended): Use One License
If the SERVER lines in the license.dat files of all your applications using FLEXlm are identical, you can merge these files. You will only need a single license manager daemon (lmgrd) and communication port. The steps are:
1. Copy the DAEMON and FEATURE lines, but not the SERVER line from the aahome/Ada-ASSURED3.5/files/license.dat file into your master license.dat file.
2. Tell the license manager to re-read the master license.dat file. For example, if your master license file is master/license.dat, execute the command:
  lmreread -c master/license.dat
If you choose this option, then you may skip the rest of the license management instructions.
Choice 2: Use Separate Licenses
You can maintain separate license.dat files for each of the applications using FLEXlm and run separate license server daemons lmgrd on separate ports. For this choice to work, you must ensure that the Ada-ASSURED license manager daemon will not conflict with any other license manager daemons that are running on the same server. A conflict will occur if the daemons attempt to use the same TCP/IP port number. The port number is the last field in the SERVER line in the license file. Ada-ASSURED creates license files with a port number of 7340. If this causes a conflict, it can be changed using a text editor.
Once you have ensured that there are no conflicts, continue with the instructions for starting the license manager in step B.

Step B: Starting the License Manager.

Start the license manager by executing the command:

aahome/Ada-ASSURED3.5/bin/lmgrd \ -c aahome/Ada-ASSURED3.5/files/license.dat >> \ aahome/Ada-ASSURED3.5/files/lmgrd.log &

This will cause the output from lmgrd to appear in the file aahome/Ada-ASSURED3.5/files/lmgrd.log; you may chose a different name if you wish. This file is a log of activity as licenses are checked out and in again.

Note that lmgrd will not operate correctly on diskless machines. If the logfile contains a message reporting that aa.d has failed to create a lockfile, you may be encountering this problem. The solution is to get a replacement key and run lmgrd on a server.

If you have specified multiple servers, then lmgrd must be started on each of these servers.

Step C: Automatically Starting the License Manager.

It is recommended that lmgrd be started automatically when the server boots. Note, as a security precaution, the umask for the license manager daemon should be 022. Do this by becoming root and adding the following line to /etc/rc.local on each server.

su flexlm -c ``umask 022; \ aahome/Ada-ASSURED3.5/bin/lmgrd \ -c aahome/Ada-ASSURED3.5/files/license.dat >> \ aahome/Ada-ASSURED3.5/files/lmgrd.log &''

The License File

To run Ada-ASSURED, the license file license.dat containing the information about Ada-ASSURED must be accessible. You have two choices:

Move this file to its default location, the directory /usr/local/flexlm/. No other actions are necessary.
Ensure that each end-user has the environment variable LM_LICENSE_FILE set to point at the license file used at your site. To accomplish this, GrammaTech recommends adding a line to each user's shell initialization file. For example, for the C shell add a line similar to
setenv LM_LICENSE_FILE aahome/Ada-ASSURED3.5/files/license.dat