This Installer's Note is essential reading for whoever is responsible for the installation of this implementation of NAG DMC. It is available together with the Users' Note (un.html) on the distribution medium.
This implementation is a compiled, tested, ready-to-use version of NAG DMC that is considered suitable for operation on the computer systems detailed below:
hardware: AMD 64-bit systems and compatible (including EM64T) operating system: Linux 22.214.171.124-20a (SuSE 9.3 x86-64) and compatible C compiler: gcc 3.3.5 and compatible
This implementation was produced at NAG Ltd., Oxford on the computer system detailed below:
hardware: AMD Athlon 64 operating system: Linux 126.96.36.199-20a (SuSE 9.3 x86-64) C compiler: gcc 3.3.5 compiler options: -O3
|-- in.html (Installer's Note (this document)) |-- documents --|-- un.html (User's Note) | |-- *.html | |-- *.pdf | | |-- *.c drl6a20dgl ----|-- examples ---|-- *.dat | |-- results --|-- *.r | |-- include ----|-- *.h | |-- library ----|-- libnagdmc.a | | |-- bin --|-- * (directories of binaries for | | supported platforms) |-- licence ----|-- README.TXT | |-- doc -- * (End User Guide)
To install NAG DMC materials use the tar utility:
tar xvf /cdrom/dr20.tar(assuming the CD-ROM has been mounted as /cdrom).
To simplify access you may wish to move the library (library/libnagdmc.a) to a system location such as /usr/lib, so that it is in the default search path of the linker during the link phase.
The include files, in directory include, should be moved to a directory such as /usr/include so that they can be accessed during compilation, e.g.,
mv include/*.h /usr/include
The use of NAG DMC is controlled by the Kusari licence management system. This release of NAG DMC uses version 2.1 of Kusari.
In order to enable the software, NAG will issue you with a licence key. The licence key is a simple text file containing details of the software that will be enabled.
To request a licence key, run the program khostid located in the licence/bin/amd64 subdirectory of the software distribution. This utility must be run from a command prompt. Return the information that it displays by e-mail (or FAX) to NAG.
A short term (demonstration or trial) licence key contains one or more lines like the following:
DRL6A20DG TRIAL 2006/02/12 "EMnxdA3oeoj0F1Yvi5ibxPjB7"
Specifically, it has a line containing the word TRAIL and is referred to here as an uncounted licence key. Longer term uncounted licence keys must be locked to a specific computer, i.e., they will enable the software on one computer only. These licence keys include the word NODE instead of the word TRIAL above. Other types of keys may also be issued.
Once you have obtained the licence key, store the text of it in a file, say [INSTALL_DIR]/licence.lic.
For an uncounted licence, the location of the licence file must be made known to the NAG application by setting the environment variable NAG_KUSARI_FILE to the full pathname of the file before the application is invoked.
For example, in the C-shell, type:
setenv NAG_KUSARI_FILE [INSTALL_DIR]/licence.licor in the Bourne shell, type:
NAG_KUSARI_FILE=[INSTALL_DIR]/licence.lic export NAG_KUSARI_FILE
No other actions are required to install an uncounted licence.
Further details about Kusari and how it may be configured to suit your local circumstances are included in the Kusari Licence Management documentation in the licence/doc subdirectory of the software distribution.
The documentation for NAG DMC is located in directory documents and comprises of PDF and HTML files. You are encouraged to make the documentation readily available to users.
The installer should ensure that the advice given to users in Sections 3.1 and 3.2 of the Users' Note (un.html) is suitable for the installation. This can be done by running a few example programs, in directory examples, following that advice. Results printed by example programs should be checked against the respective results located in directory examples/results.
The following material should also be made accessible to users:
include/*.hexample program material:
examples/*.c examples/*.dat examples/results/*.rdocumentation files:
The example results distributed were generated at Release 2 of NAG DMC, using the software described in Section 2.2. These example results may not be exactly reproducible if the example programs are run in a slightly different environment (for example, a different C compiler, a different compiler library or different arithmetic hardware).
The NAG Response Centres are available for general enquiries from all users and also for technical queries from sites with support service.
The Response Centres are open during office hours, but contact is possible by fax, email and phone (answering machine) at all times.
When contacting a Response Centre it helps us deal with your enquiry quickly if you can quote your NAG site reference and NAG product code (in this case DRL6A20DGL).
The NAG websites provide information about implementation availability, descriptions of products, downloadable software, product documentation and technical reports. The NAG websites can be accessed at
http://www.nag.co.uk/, http://www.nag.com/ (in North America) or http://www.nag-j.co.jp/ (in Japan)
NAG Ltd Wilkinson House Jordan Hill Road OXFORD OX2 8DR NAG Ltd Response Centre United Kingdom email: email@example.com Tel: +44 (0)1865 511245 Tel: +44 (0)1865 311744 Fax: +44 (0)1865 310139 Fax: +44 (0)1865 310139 NAG Inc 1431 Opus Place, Suite 220 Downers Grove IL 60515-1362 NAG Inc Response Center USA email: firstname.lastname@example.org Tel: +1 630 971 2337 Tel: +1 630 971 2337 Fax: +1 630 971 2706 Fax: +1 630 971 2706 Nihon NAG KK Hatchobori Frontier Building 2F 4-9-9 Hatchobori Chuo-ku Tokyo 104-0032 Japan email: email@example.com Tel: +81 (0)3 5542 6311 Fax: +81 (0)3 5542 6312