NAG Parallel Library, Release 3

FDL6I03DCL - License Managed

Intel EM64T, Linux64, Intel Fortran, Intel MPI

Installer's Note



Contents

1. Introduction

This Installer's Note is essential reading for whoever is responsible for the installation of this implementation of the NAG Parallel Library. It is available together with the Users' Note (un.html) on the distribution medium.

Your attention is drawn to the terms and conditions of the Software License regarding the use of NAG software. Requests for information about the availability of other implementations must be referred to NAG (see Section 6).

2. Implementation Provided

2.1. Applicability

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

hardware:          Intel EM64T systems and compatible (including AMD64)
operating system:  Linux for x86-64 with glibc-2.5 and compatible
Fortran compiler:  Intel(R) Fortran Intel(R) 64 Compiler
                   Version 11.0 and compatible
C compiler:        Intel(R) C Intel(R) 64 Compiler 
                   Version 11.0 and compatible
MPI:               Intel(R) MPI Library 3.2 for Linux
ScaLAPACK:         Intel(R) Math Kernel Library 10.1 for Linux
BLAS/LAPACK:       Intel(R) Math Kernel Library 10.1 for Linux

For information about implementations of the NAG Parallel Library for use on other computer systems please contact NAG.

2.2. Derivation

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

hardware:                  Dell PowerEdge SC430 (dual-core Pentium D)
operating system:          Linux 2.6.18, glibc 2.5
Fortran compiler:          Intel(R) Fortran Intel(R) 64 Compiler Version 11.0
                           Build 20080930 Package ID: l_cprof_p_11.0.069
compiler options:          -fPIC -O3
C compiler:                Intel(R) C Intel(R) 64 Compiler Version 11.0 
                           Build 20080930 Package ID: l_cproc_p_11.0.069
compiler options:          -fPIC -O3
MPI:                       Intel(R) MPI Library 3.2 for Linux
ScaLAPACK:                 Intel(R) Math Kernel Library 10.1 for Linux
BLAS/LAPACK:               Intel(R) Math Kernel Library 10.1 for Linux

The entire NAG Parallel Library, Release 3, was compiled with full optimization (-O3).

This version of the Library has been tested only in conjunction with Intel's Math Kernel Library.

3. Distribution Medium

3.1. Recording Details

The software is available to download from any of the NAG Web sites (see NAG Websites). Upon request, the software may be distributed by CD-ROM. Section 6).

3.2. Contents

The following shows the directory/file organization of the materials as they will be installed.
                          |-- in.html (Installer's Note)
            |-- doc ------|-- un.html (User's Note)
            |
            |             |-- source ---|-- *e.f
            |-- examples -|-- data -----|-- *e.d
            |             |-- results --|-- *e.r
            |
            |-- libnagmpi.a     (static library)
            |-- libnagmpisup.a  (support static library)
            |-- libnagmpi.so    (shared library)
            |-- libnagmpisup.so (support shared library)
fdl6i03dcl -|
            |             |- bin -|- * (directories of binaries
            |             |             for supported platforms)
            |-- license --|- README.TXT
            |             |
            |             |- doc -|- * (Installation and User Guides)
	    |
            |-- mkl_em64t |-- (Intel Math Kernel Library redistributables)
	    |
            |-- scripts --|-- nagmpiexample
                          |-- nagmpiexampleshared

3.3. File Sizes

The files require approximately the following disk space:
compiled libraries, libnagmpi.a:     6140 kb
                    libnagmpi.so:    3780 kb
                    libnagmpisup.a:   396 kb
                    libnagmpisup.so:  208 kb
example program material:            1388 kb
license material:                    3632 kb
MKL materials:                     442752 kb
documentation files:                   32 kb

4. Library Installation

4.1. Installation

To install all material, use the Unix tar utility, e.g.

tar xvf /cdrom/fd03.tar
(assuming the CD-ROM has been mounted as /cdrom).

Links to the object libraries libnagmpi.a, libnagmpisup.a, libnagmpi.so and libnagmpisup.so should be placed in a directory, such as /usr/lib64, in the default search path of the linker so that linkage is convenient.

The script nagmpiexample is intended to provide users with a simple means of access to the example material. It will require some minor edits to reflect the local installation and should be placed in a directory, such as /usr/local/bin, which is on users' execution search paths.

4.2. License Management

The use of the NAG Parallel Library is controlled by the Kusari network license management system. This release of the NAG Parallel Library uses version 2.2 of Kusari.

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

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

FDL6I03DC TRIAL 2009/02/10 "GrhrRhgJdtAlFBom0iDRfLIeyJ"
Specifically, it has a line containing the word TRIAL and is referred to here as an uncounted license key.

An annual license key is also an uncounted license key and contains one or more lines like the following:

FDL6I03DC ANNUAL SITE:5056442 2009/09/30 "y5gkechs7qMrB2fe54ctn1dptr"

These two types are the only types supported in this implementation.

Once you have obtained the license key, store the text of it in a file, say [INSTALL_DIR]/license.lic. Please make sure that the file is accessible from all nodes where NAG Parallel Library code will execute. This could be on a shared file system or on separate filesystems for each node.

For an uncounted license, the location of the license 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]/license.lic
or in the Bourne shell, type:
   NAG_KUSARI_FILE=[INSTALL_DIR]/license.lic
   export NAG_KUSARI_FILE
You should either ensure that all users of the NAG Parallel Library inherit this environment variable in their working environment or that they know how to set it themselves. You can modify the User's Note to that effect, adding the above information. In particular, this environment variable must be set and exported at every invocation of an mpirun command from every participating node of your MPI installation and the license file must be accessible at the specified path on every node. No other actions are required to install an uncounted license.

Further details about Kusari and how it may be configured to suit your local circumstances are included in the Kusari Licence Management User Guide.

4.3. Checking Accessibility

The installation may be tested by using the script nagmpiexample (when logged in as a normal user). The script will copy an example program and its data, compile it, link it with the libraries and run it. You should ensure that it is adapted to your local MPI and compiler installation and setup. Most example programs require 4 MPI tasks. Please consult your Intel MPI documentation for help on setting up a suitable MPI execution environment.

For example, give the command

nagmpiexample f04ebfp
to run the F04EBFP example program. If the parallel execution environment is not available interactively, the nagmpiexample script can be invoked instead inside a batch job script.

It is important that the environment variables PATH and LD_LIBRARY_PATH are set up correctly so that compilation, linking and parallel execution can all complete successfully. This is best accomplished by the scripts that are provided with Intel software. Details vary according to which version is installed on your system and which interactive shell you are using. Here are the invocations of the bash shell scripts for the installation at NAG Ltd, corresponding to Version 11.0 of the compilers, Version 3.2 of the MPI library and Version 10.1 of the MKL library.

. /opt/intel/Compiler/11.0/069/bin/ifortvars.sh intel64
. /opt/intel/Compiler/11.0/069/bin/iccvars.sh intel64
. /opt/intel/impi/3.2.0.011_em64/bin64/mpivars.sh
. /opt/intel/10.1.1.019/tools/environment/mklvarsem64t.sh
It is recommended that the above scripts are sourced in the user's shell startup file (.bashrc for the bash shell). There are variants of the above scripts suitable for the C shell.

4.4. Release to Users

The Users' Note (doc/un.html) should be checked and amended as necessary (particularly Section 2.2). It can then be made available to users directly, or be absorbed into local access information.

The following material should also be made accessible to users:

other library documentation (see Section 5)

compiled libraries:

libnagmpi.a
libnagmpisup.a
libnagmpi.so
libnagmpisup.so
MKL libraries supplied by NAG
example program material:
examples/source/*e.f
examples/data/*e.d
examples/results/*e.r
scripts/nagmpiexample
scripts/nagmpiexampleshared

Making the supplied example material directly available to users provides them with easily adaptable templates for their own problems.

4.5. Maintenance Level

The maintenance level of the supplied library can be determined by writing a simple program to call A00AAFP, which prints out details of the implementation, including title and product code, precision used, release, maintenance level and the underlying message passing mechanism (MPI in this case).

5. Documentation

On-line documentation is provided, in PDF form, with this implementation. Please see the Readme file on the distribution medium for further information.

6. Support from NAG

(a) Contact with NAG

Queries concerning this document or the implementation generally should be directed initially to your local Advisory Service. If you have difficulty in making contact locally, you can contact NAG directly at one of the addresses given in the Appendix.

(b) NAG Response Centres

The NAG Response Centres are available for general enquiries from all users and also for technical queries from sites with an annually licensed product or 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 please quote your NAG site reference and NAG product code (in this case FDL6I03DCL).

(c) NAG Websites

The NAG websites are an information service providing items of interest to users and prospective users of NAG products and services. The information is reviewed and updated regularly and includes implementation availability, descriptions of products, downloadable software, product documentation and technical reports. The NAG websites can be accessed at

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

or

http://www.nag.com/ (in North America)

or

http://www.nag-j.co.jp/ (in Japan)

(d) NAG Electronic Newsletter

If you would like to be kept up to date with news from NAG then please register to receive our free electronic newsletter, which will alert you to special offers, announcements about new products or product/service enhancements, customer stories and NAG's event diary. You can register via one of our websites, or by contacting us at nagnews@nag.co.uk.

7. User Feedback

Many factors influence the way NAG's products and services evolve and your ideas are invaluable in helping us to ensure that we meet your needs. If you would like to contribute to this process we would be delighted to receive your comments. Please contact your local NAG Response Centre (shown below).

Appendix - Contact Addresses

NAG Ltd
Wilkinson House
Jordan Hill Road
OXFORD  OX2 8DR                         NAG Ltd Response Centre
United Kingdom                          email: support@nag.co.uk

Tel: +44 (0)1865 511245                 Tel: +44 (0)1865 311744
Fax: +44 (0)1865 310139                 Fax: +44 (0)1865 310139

NAG Inc
801 Warrenville Road
Suite 185
Lisle, IL  60532-4332                   NAG Inc Response Center
USA                                     email: support@nag.com

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: help@nag-j.co.jp

Tel: +81 (0)3 5542 6311
Fax: +81 (0)3 5542 6312