NAG C Library, Mark 25

CLMI625DCL - License Managed

Intel-based Mac, Mac OS X 64, Intel C/C++ or Apple clang, 64-bit integers

Installer's Note



Contents


1. Introduction

This document provides implementation-specific information relating to the installation of the NAG C Library specified in the title.

Your attention is drawn to the terms and conditions of the Software License Agreement (in file lic_agr.txt, see Section 3.1) regarding the use of NAG software. Requests for information about the availability of other implementations must be referred to NAG.

2. Implementation Provided

2.1. Applicability

This implementation is a compiled, tested, ready-to-use version of the NAG C Library that is considered suitable for operation on the computer systems detailed below:

hardware:          Intel(R) Mac 64 systems and compatible
operating system:  Mac OS X 10.10.1 Darwin Kernel Version 14.0.0 and compatible
C compiler:        Intel(R) C Intel(R) 64
                   Version 15.0.3.187 and compatible

The definitions and sizes of the Integer and Pointer types used in this implementation are shown in Section 3.3 of the Users' Note.

2.2. Derivation and Additional Test Platforms

This implementation was produced at NAG Ltd., Oxford on the computing system detailed below:

hardware:         Mac mini 7,1 - 2.6 GHz Intel Core i5
operating system: Mac OS X 10.10.1
                  Darwin Kernel Version 14.0.0
C compiler:       Intel(R) C Intel(R) 64 Compiler XE
                  for applications running on Intel(R) 64,
                  Version 15.0.3.187 Build 20150408
vendor library:   Intel MKL version 11.2.3
compiler options: -fPIC -m64 -fexceptions -fp-model precise

For details of any other systems on which this implementation has been tested, please see the Supplementary Information page on our website.

2.3. Supplementary Information

Please check the following URL:

http://www.nag.co.uk/doc/inun/cl25/mi6dcl/supplementary.html

for details of any new information related to the applicability or usage of this implementation. Details of any other systems on which it has been tested may also be found on this page.

3. Distribution

The software is available to download from any of the NAG websites (see Section 6 for contact details).

3.1. Contents

The following shows the directory and file organization of the implementation materials after installation.
                    |- in.html  (Installer's Note - this document)
            |- doc -|- un.html  (Users' Note)
            |       |- lic_agr.txt  (license agreement)
            |
            |       |- libnagc_nag.a     (static self-contained library
            |       |                     including NAG BLAS/LAPACK)
            |       |- libnagc_nag.dylib (shareable self-contained library
            |       |                     including NAG BLAS/LAPACK)
            |- lib -|
            |       |- libnagc_mkl.a     (static library requiring
            |       |                     MKL BLAS/LAPACK)
            |       |- libnagc_mkl.dylib (shareable library requiring
            |       |                     MKL BLAS/LAPACK)
clmi625dcl -|
            |- include -|- *.h
            |
            |            |- source --|- ??????e.c
            |            |
            |- examples -|- data ----|- ??????e.d
            |            |           |- ??????e.opt
            |            |
            |            |- results -|- ??????e.r
            |
            |- scripts -|- nagc_example*  (scripts to compile and run
            |                              NAG example programs)
            |
            |- mkl_intel64_11.2.3 -|- *  (Intel Math Kernel Library)
            |
            |- rtl -|- *  (Intel compiler run-time libraries)
            |
            |           |- bin -|- *  (directories of license management
            |           |              binaries for supported platforms)
            |- license -|- README.txt
                        |
                        |- doc -|- *  (license management documentation)

The following shows the directory and file organization of the Library Manual materials after installation.

nagdoc_cl25 -|- index.html
             |
             |- examples -|- baseresults -|- *.r.html
             |            |- source      -|- *.c.html (syntax highlighted
             |            |               |            source files)
             |            |- data        -|- *.d.html
             |            |               |- *.opt.html
             |            |- replaced    -|- *.c.html
             |
             |- html  -|- frontmatter -|- manconts.html  (main HTML index)
             |         |               |- copyright.html (copyright notice)
             |         |
             |         |- genint -|- *.html  (general introductory material)
             |         |
             |         |- [a00-x07] -|- *conts.html  (chapter contents)
             |         |             |- *intro.html  (chapter introduction)
             |         |             |- *c.html      (routine documents)
             |         |
             |         |- figures -|- *.png  (figures and plotfiles)
             |         |
             |         |- indexes -|- kwic.html (keyword and GAMS search)
             |         |
             |         |- styles -|- libdoc.css  (CSS stylesheets)
             |                    |- nagmathml.js   (JavaScript)
             |
             |- pdf   -|- frontmatter -|- manconts.html (main contents page)
                       |               |- manconts.pdf  (main contents page)
                       |               |- copyright.pdf (NAG copyright page)
                       |
                       |- genint -|- *.pdf  (general introductory material)
                       |
                       |- [a00-x07] -|- *conts.html   (chapter contents)
                       |             |- *conts.pdf    (chapter contents)
                       |             |- *intro.pdf    (chapter introduction)
                       |             |- *c.pdf        (routine documents)
                       |
                       |- indexes -|- indexnote.pdf
                       |           |- kwic.html     (keyword and GAMS search)
                       |
                       |- inuns -|- usersnote.pdf   (implementation-specific
                       |                             details)
                       |
                       |- styles -|- libdoc.css  (CSS stylesheets)
                                  |- nagmathml.js   (JavaScript)

Details of the software are given in the Users' Note (un.html).

4. Installation

4.1. Installation of Library Software and Manual

If you have downloaded the Library materials, double click on CLMI625DCL.dmg. This will extract the two packages CLMI625DCL.pkg and "NAG C Library Manual, Mark 25.pkg" in addition to the files in.html, un.html and LicenseInstaller and the folder resources.

4.1.1. Installation Procedure

To install the Library Software, double click on CLMI625DCL.pkg and follow the instructions.

By default, the Library Software will be installed in /opt/NAG/. In this document we refer to the directory /opt/NAG/clmi625dcl as [INSTALL_DIR].

The directory [INSTALL_DIR] is referenced in the Users' Note (un.html).

The directory [INSTALL_DIR]/scripts contains several scripts to show how to use the libraries provided with this implementation. See Users' Note, Example Programs. Subsequent to the installation, if the installer moves the library to some other location then these scripts must be changed to reflect that fact.

To install the Library manual, double click on "NAG C Library Manual, Mark 25.pkg".

By default, the Library Manual will be installed in /opt/NAG/. You are encouraged to make it readily available to users.

4.1.2. License Management

The use of this product is controlled by the Kusari license management system. This release of the Library uses version 2.2-72 of Kusari.

A short term (demonstration or trial) license key contains one or more lines like the following:

  CLMI625DC TRIAL 2015/11/12 "EMnxidA3oeoj0F1Yvi5ibxPjB7"
Specifically, it has a line containing the word TRIAL. Longer term license keys must be locked to a specific computer, i.e. they will enable the software on one computer only. These license keys include the word NODE instead of the word TRIAL above.

In order to enable the software, NAG will issue you with a license key. The license key is contained in a text file consisting of details of the software that will be enabled.

License key request and installation is performed through the Apple Installer when clmi625dcl.pkg is installed. During installation, you will be prompted for a license key. If you do not have a license key, a request form will be generated for you to complete and send to NAG via fax or e-mail.

Once you have obtained one of the above license keys it MUST be installed by running the license installer License Installer.app. By default, the license installer will save the license key in /opt/NAG/nag.key (prepends the file if it exists). The Library will then validate the license at runtime.

If you need to update or change the license key after installation, we recommend that you run the license installer again.

Further details about Kusari and how it may be configured to suit your local circumstances (e.g. how to install the license key on a server) are included in the Kusari License Management documentation in the license/doc/ subdirectory of the software distribution. See also the Kusari FAQ: http://www.nag.co.uk/Kusari/kusari_faq.html.

4.2. Further Information

4.2.1. Checking the Installation

Access to the Library materials can be checked by running a few example programs following the advice given in the Users' Note, Section 3.1; a suitable sample would be d01sjc, f07adc and g05sjc. The installation can also be tested using the batch files nagc_example* (see Users' Note, Section 3.2).

5. Support from NAG

Please see

http://www.nag.co.uk/support_tech_supp.asp

for information about the NAG Technical Support Service, including details of the NAG Technical Support Service contact points. We would also be delighted to received your feedback on NAG's products and services.

6. Contact Addresses

Please see

http://www.nag.co.uk/contact_us.asp

for worldwide contact details for the Numerical Algorithms Group.