LICENSING FOR NAGWARE F95 COMPILER - LINUX IMPLEMENTATION
---------------------------------------------------------
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 9.2 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 downloaded NAGWare f95 from the Internet you may 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 Guide, which is 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 fifteen 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 to 11.20 32-bit
hp700_u11 : HP-UX 11.20 or higher 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.
i86_r9 : Intel x86 Linux Redhat 9
it64_lr2 : Itanium IA64 Redhat and Turbo Linux
ppc_mac10 : Macintosh PowerPC OS X 10.1 or higher
rs6000_u3 : IBM PowerPC and RS6000 32-bit AIX
sgi32_u6 : Silicon Graphics IRIX 32-bit
sgi64_u6 : Silicon Graphics IRIX 64-bit
sgio32_u6 : Silicon Graphics IRIX old 32-bit (mips2)
sun4_u5 : Sun SPARC SunOS 5.5 (Solaris 2.5) or later 32-bit
(1024 files)
sun4_u7 : Sun SPARC SunOS 5.7 (Solaris 2.7) or later 32-bit
(65535 files)
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 Response Centre, 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.