LICENSING FOR NAGWARE FORTRAN TOOLS ----------------------------------- 1. INTRODUCTION --------------- The use of NAGWare Fortran Tools is controlled by the FLEXlm network licence management system (FLEXlm is a registered trademark of Globetrotter Software Inc). This release of NAGWare Fortran Tools uses version 7.0e of FLEXlm. All the NAGWare Fortran Tools licensing materials are contained in the directory 'license'. If you have a CD distribution of NAGWare Fortran Tools this will be a top level directory on your CD. If you have downloaded NAGWare Fortran Tools 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 Fortran Tools. 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 Fortran Tools 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 Fortran Tools. 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 - DEC Alpha AXP Digital UNIX hp700_u9 - Hewlett Packard 9000/700 series HP-UX i86_l1 - Intel 80x86 Linux with libc 5 (e.g. RedHat 4.x) i86_g2 - Intel 80x86 Linux with Gnu-libc (e.g. RedHat 5.x) i86_n3 - Intel 80x86 Microsoft Windows (NT and 95/98) i86_r6 - Intel 80x86 Linux with Gnu-glibc 2.1 (e.g. Redhat 6.x) rs6000_u3 - IBM RISC System/6000 AIX sgi32_u5 - Silicon Graphics IRIX version 5 sgi32_u6 - Silicon Graphics IRIX version 6 sgi64_u6 - Silicon Graphics IRIX version 64 sun4_u5 - Sun 4 (SPARC) SunOS version 5 (Solaris) 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 Fortran Tools on your licence server (provided you have bought NAGWare Fortran Tools for the same type of machine as your licence server). To run the Fortran Tools 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 the Fortran Tools 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.