Tech Tip: Kusari Licence Management System
All current NAG products are licence managed using Kusari.
Because many of our products are run on single-user, Microsoft Windows based systems, this note gives an overview of the steps required to obtain and install a Kusari licence key on this system. Other machine ranges will follow the same general procedures, but will differ in detail. The more detailed information is, in all cases, found under the license subdirectory or from http://www.nag.co.uk/Kusari/index_2.2.asp or in the Installer's Note for the appropriate implementation. These are provided with the product but are also available on the web.
If you have a trial key you may jump straight to stage c); otherwise begin at a)
- Obtain a machine identification string using the khostid program provided. On Windows go to the easy to use GUI "Start / All programs / NAG / Product / Request or Install License Key" and click "Request New Licence", you will be prompted for the information required. On Unix systems run khostid from a terminal window. Use copy and paste to transfer the information generated to an email and send this to NAG. For Unix products, please add your name, company name and address, the NAG product code and your NAG Site ID (if known) to the email.
- Send the file by email to your local NAG office. This will be one of email@example.com, firstname.lastname@example.org, email@example.com or firstname.lastname@example.org.
- You will receive a licence key back from your local office.
On Windows, use the same GUI as in a), copy the key from the email attachment and paste it into the main window and click "Install Licence Key". Your licence is now ready for use.
On Unix, save the email attachment to a file. Some products have a default place for this file, please see the Installer's Note. If your product has such a default, save the email attachment to that file and your licence is ready for use. Otherwise, choose where you want the key to be stored and save the email attachment to this file. Then set the environment variable NAG_KUSARI_FILE to the full pathname of this file, perhaps in your shell startup script.
- Finally test the licence installation is correct.
For Windows library products, run "Start / All programs / NAG / Product / Check NAG DLL Accessibility" which checks that a licence is available as well as checking the DLL is installed correctly.
For other library products compile, link and run the A00ACF (Fortran Libraries), or a00acc (C Library), example program. Please see the Users' Note for information on how to do this.
For any other product, run it and see. For the NAG Fortran Compiler, try a compilation of any Fortran source file. For the .NET Library run the "Start / All programs / NAG / NAG Library for .NET / NAG Library for .NET Example Application".
- You can put more than one product licence in a file.
- If you edit the licence file don't use a word processor like Word, instead use a simple test editor like notepad or emacs.
- It is important to note that the licence management software searches only until a matching licence is recognised. If, for example, an expired licence is found the search will stop at this point even though a fresh licence is available in another file on the search list. We therefore recommend that expired licences be removed from licence files as the licences expire.
- The program klcheck, which is distributed in the product "bin" directory and/or may be found in the "license" directory, can be used to check the product licence availability without actually running the product or compiling the library example, e.g. klcheck FLL6A23D9