LICENSING FOR NAGWARE F95 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 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 sixteen 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)
sun64_u5 : Sun SPARC SunOS 5.7 (Solaris 2.7) or later 64-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 four
files in this directory - key_rqst, NAG, lmgrd and lmutil).
2.3 TO REQUEST A LICENSE KEY
----------------------------
Locate and run the program key_rqst in the appropriate platform specific
subdirectory under the license/bin/ subdirectory of the software distribution.
This utility does not have a GUI and must be run from a command prompt.
complete the form that it displays and e-mail (or FAX) it to NAG.
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.