NAGWare f95 Compiler Release 4.2
LICENSING FOR COMPILERS
-----------------------------------
1. INTRODUCTION
---------------
The use of NAGWare f95 is controlled by the FLEXlm network licence management
system (FLEXlm is a registered trademark of Globetrotter Software Inc). This
release of NAGWare f95 uses version 7.2g of FLEXlm. (Exceptionally, an
implementation will not have licence management; see the Machine-specific
Details section of the file TECHINFO.)
All NAGWare f95 licensing materials are contained in the directory 'license'.
If you have a CD distribution of NAGWare f95 this will be a top level directory
on your CD. If you have a tape distribution, you will need to extract the
directory from the tape, e.g.
tar xf /dev/rmt0 license
If you have downloaded NAGWare f95 from the Internet you will also need to
download the licensing materials.
This document should contain sufficient information to enable FLEXlm to be
installed for the NAGWare f95 compiler. Further FLEXlm information is supplied
in the FLEXlm End User Manual and the FLEXlm FAQ, which are in HTML form in the
directory license/htmlman. The file license/nag_licensing.txt gives more
detailed information about installing NAG FLEXlm licences, including a
description of the different types of licences and specific instructions for
installing FLEXlm on Windows NT.
2. HOW TO GET A LICENCE
-----------------------
2.1 CHOOSING THE LICENCE SERVER
--------------------------------
The licensing software, FLEXlm, is designed to run on a licence server. A
licence server may be any machine on the same network as the machine(s) you
wish to use the NAGWare f95 compiler on (provided it has an operating system
matched by one of those listed in 2.2 below). Note that the licence server
does not have to be the same type of machine as that on which you intend to run
the compiler. Once you have chosen your licence server you must copy the
necessary software to your licence server.
2.2 COPYING THE FLEXLM SOFTWARE TO YOUR LICENSE SERVER
-------------------------------------------------------
The licensing software is in one of the directories in 'license/bin'. There
are eleven directories in 'license/bin' - each one for a different platform.
The directories are:
alpha_u3 : Compaq (DEC) Alpha Tru64 (OSF/1, Digital unix)
hp700_u10 : HP-UX 10.x through 11.x 32-bit
i86_g2 : Intel x86 Linux with GLibc 2.3, Redhat 5
i86_n3 : Intel x86 Microsoft Windows
i86_r6 : Intel x86 Linux Redhat 6, etc.
it64_lr2 : Itanium IA64 Redhat and Turbo Linux
rs6000_u3 : IBM Power PC and RS6000, 32-bit AIX
sgi32_u6 : Silicon Graphics IRIX 32-bit
sgi64_u6 : Silicon Graphics IRIX 64-bit
sun4_u4 - Sun 4 (SPARC) SunOS version 4 (FLEXlm 6.1c)
sun4_u5 : Sun SPARC SunOS 5 (Solaris) 32-bit
So, for example, if your licence server is an IBM RS6000, you need to copy the
contents of 'license/bin/rs6000_u3' to your licence server (you will find three
files in this directory - NAG, lmgrd and lmutil).
2.3 FINDING THE FLEXLM HOSTID
------------------------------
Execute the command 'lmutil lmhostid' on your licence server, where the
executable 'lmutil' was copied to your system in step 2.2 above. Now send the
hostid obtained to the NAG helpdesk, and also the hostname of your licence
server (which you can get from 'uname -n' on UNIX systems). We will then send
you a licence.
3. HOW TO USE THE LICENCE
-------------------------
3.1 INSTALLING THE LICENCE KEY
------------------------------
a) Put the licence key in a file on your licence server, for example
/usr/local/NAGWare/license/license.dat
The second line of your licence file will look like this:
DAEMON NAG /usr/local/flexlm/bin/NAG
You need to change the path '/usr/local/flexlm/bin/NAG' to the full path name
of the NAG daemon - that is the file NAG that you copied to your licence server
in step 2.2 above.
You should also check that the hostname in your SERVER line is correct. You can
change this if necessary. (The hostname is the second field in the SERVER
line; for example the hostname in 'SERVER guy 000000000000 7312' is guy).
b) Set the environment variable LM_LICENSE_FILE to the full pathname of the
licence file.
For example, in the C-shell, type:
setenv LM_LICENSE_FILE /usr/local/NAGWare/license/license.dat
in the Bourne shell, type:
LM_LICENSE_FILE=/usr/local/NAGWare/license/license.dat
export LM_LICENSE_FILE
Note that if your licence file is in /usr/local/flexlm/licenses/license.dat,
this is the default location and you don't need to set LM_LICENSE_FILE.
3.2 RUNNING FLEXLM
------------------
Execute the licensing software, FLEXlm by running the command 'lmgrd' (lmgrd
was installed in step 2.2 above). You should get a message saying that FLEXlm
has started properly, and that the NAG daemon has started. If you need to stop
lmgrd, you should issue the command 'lmutil lmdown'. Now, you should be able
to run the NAGWare f95 compiler on your licence server (provided you have
bought NAGWare f95 for the same type of machine as your licence server).
To run f95 on another machine on the network, say the machine with hostname
'local':
set the environment variable LM_LICENSE_FILE on the machine 'local' to
`port@host', where port and host come from the SERVER line in the licence file.
For example if the SERVER line is
SERVER guy 000000000000 7312
then set LM_LICENSE_FILE to 7312@guy on the machine 'local'. Now you should be
able to run f95 on the machine 'local' - provided that 'lmgrd' is running on
the licence server.
When you are satisfied that the licence management system is functioning
correctly, lmgrd should be installed so that it starts when the license server
is booted. Stop lmgrd using the command 'lmutil lmdown'. For a server running
UNIX, edit one of the scripts (below the directory /etc) that are executed at
boot time (or when the run-level changes) to start lmgrd and send its output to
a file.