Installation: Purchased 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 evaluation period 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(s). If you have a demonstration license, skip this section.

The license manager software is composed of the following parts:

the license file: license.dat,
the license options file: license.opt.
two daemons: lmgrd.exe and aa.d,
license administration tool: lmtools.exe.

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

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

The license file as send to you will look like more or less like:

SERVER duck 00c04f792e62 8752
DAEMON aa.d $DPATH$/aa.d license.opt
FEATURE Ada-ASSURED aa.d 3.3 permanent 1 1B5EC032159ACF7A858F \
        VENDOR_STRING=9090D0B175341FDDDA75 PLATFORMS=i86_n ck=90
FEATURE Ada-ASSURED-BATCH aa.d 3.3 permanent 1 0B3E0A13BEF39FA12DA8 \
        PLATFORMS=i86_n ck=212

This enables a single floating license for version 3.3 of Ada-ASSURED. The first line of the file specifies the name of the server on which the license manager daemon will run (in this case duck), its hostid (00c04f792e62), and the TCP/IP port on which it will communicate (8752). The second line specifies the name of the vendor daemon (aa.d), and the full pathname to its executable. The $DPATH$ will need to be replaced manually by the correct pathname (aahome\bin\aa.d). You can do this using a text editor like notepad.

License Manager

License management can be complicated depending on whether your site has any applications 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.exe on the license manager machine, follow the instructions in step A; depending on your choices, you may need to follow step B as well.
If you are not running the FLEXlm license daemon lmgrd.exe, 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.exe) and communication port. The steps are:
1. Copy the DAEMON and FEATURE lines, but not the SERVER line from the aahome\files\license.dat file into your master license.dat file.
2. Use the lmtools utility to tell the license manager to re-read the master license.dat file.
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.exe 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 8752. If this causes a conflict, it can be changed using a text editor.
If you wish to merge the licenses into one file, please refer to Chapter 3: ``Combining License Files'' of the FLEXlm End User Manual.
Once you have ensured that there are no conflicts, continue with the instructions for starting the license manager in step B.

Step B: Starting and Configuring the License Manager.

You will need to know where Ada-ASSURED is installed. Call this directory AALOC.

Start up the license server control tool. This can be done by double-clicking on the lmtools.exe icon in the AALOC\bin directory.
Select the Server/License File tab.
Select the Configuration using Services option
Select the Configure Services tab
Enter the paths for the license manager daemon AALOC\lmgrd.exe, license file, and log file. For example, assuming you installed Ada-ASSURED in C:\GrammaTech, enter:
```
C:\GrammaTech\Ada-ASSURED\bin\lmgrd.exe
C:\GrammaTech\Ada-ASSURED\files\license.dat
C:\GrammaTech\Ada-ASSURED\files\lmgrd.log
```
Select Use Services and Start Server at Powerup.
Select the Control tab.
Click on the Save button.
Select the Start/Stop/Reread tab.
Start the server now by clicking on Start Server.
Choose OK to exit.

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 C:\flexlm. No other actions are necessary.

OR
Ensure that each end-user has the environment variable LM_LICENSE_FILE set to point at the license file used at your site.