NAG Library for .NET Version 2 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 Library for .NET.

Your attention is drawn to the terms and conditions of the Software License Agreement (in file lic_agr.txt) regarding the use of NAG software. Any request to use this software other than on the licensed computer must be referred to NAG, as should requests for information about the availability of other implementations.

2. Implementation Provided

2.1. Applicability

The NAG Library for .NET Version 2 is applicable to both Windows 32 and Windows 64 systems (x86 and x64).

hardware:             x86 and x86-64 systems and compatible
operating system:     Microsoft Windows
.NET:                 .Net Framework 4.0 or higher (Visual Studio 2010 or later)

You do not need to have Visual Studio, but the system has been tested with Visual Studio Professional and Visual Studio Express.

Note that the 64 bit F# compiler in Visual Studio 2010 can not reference .Net Assemblies compiled for platfom:x64. This is fixed in later versions of Visual Studio. The 32 bit Library may be used with F# in Visual Studio 2010.

More details may be available on the post release page (see Section 2.2).

2.2. Post Release Information

Please check the following URL:
http://www.nag.co.uk/doc/inun/dt02/w3adal/postrelease.html
for details of any new information related to the applicability or usage of this implementation.

3. Contents

The following shows the folder and file organization of the implementation materials as they will be installed on an x86-64 system.

DTW02   bin32/*.dll	   
 	bin64/*.dll	   
 	NagLibrary64.dll	   
 	Naglibrary64.xml	   
 	NagLibrary32.dll	   
 	Naglibrary32.xml	   
 	NagDotNetExampleApp.exe	   
 	routines-to-run.xml
        flcsdnet.cs
        flcsdnet64.cs	   
 	NagLibrary.chm
 	ExampleClasses/*.cs	   
 	ExampleData/*.d
 	ExampleResults/*.r 	   
 	Kusari Licence/*.exe 
 	readme.html
 	License-agreement.rtf
        lic_agr.txt
        unins000.*

By default these files are installed under
C:\Program Files (x86)\NAG\DTW02.

4. Installation

You must have Administrator privileges to install this software.

Downloaded the Library materials from our website, then run the self-extracting executable to start the installation.

After installation, you should ensure that the software described in Section 3 is present and accessible.

This software is provided with an uninstallation facility via

  Control Panel|Programs|Uninstall a Program

or

  Control Panel|Programs and Features|Uninstall or change a program

(depending on which view is displayed).

4.1. Installation Options

4.2. Silent Installation

This product may be installed in silent (unattended) mode by running

  dtw3a02dal_setup.exe /SILENT

or

  dtw3a02dal_setup.exe /VERYSILENT

from a Command Prompt. With the first version, you see a progress bar on the screen as the installation occurs, whereas with the second, nothing is displayed. The files will be installed to the default location and the PATH environment variable will be modified. The default installation location may be overridden by using the /dir switch, e.g. /dir="C:\my folder". To prevent the environment variables being updated, the /type=noenv option may be used.

4.3. License Management

The use of this product is controlled by the Kusari license management system.

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. For evaluation purposes a trial license may be used. To get a trial license contact the NAG Technical Support Service. Before obtaining a full license you need to know the Kusari hostid of the system on which you intend to use this product and how to do this is described below.

The easiest way to request a license key is to use the GUI described in the next section. Once you have a key, the same GUI can be used to install it.

The information below covers the most common requirements. For more complex licensing situations, please contact us.

4.3.1. The GUI license key request and key installation program

The recommended way to request a license key is to use the GUI program provided. This will help you to build a standard message requesting either a trial key or a full key which can be pasted into an email to the NAG Technical Support Service. In the case of a full key, the message contains the Kusari hostid.

Once you have your license key, the same GUI can be used to install the key in the registry.

You can execute this GUI via the shortcut Request or Install NAG License Key for DTW3A02DAL found in the Start menu (Start->NAG->NAG Library for .NET Version 2).

To ensure that the license has been installed correctly please run the NAG Library for .NET Example Application (described in Section 7.1 below) and execute an example program.

5. Choice of Assemblies

The 32 bit assembly, NagLibrary32.dll was built using the following options

  /target:library /platform:x86 /optimize

The 64 bit assembly, NagLibrary64.dll was built using the following options

  /target:library /platform:x64 /optimize

It follows that the 32 bit assembly can be used on both 32 and 64 bit operating systems with the appropriate platform option.

6. NAG Library help

Help is provided as a Windows HTML help file, and online. The online help may also be downloaded as a zip archive for local installation.

7. Examples

The distributed example results were generated using the 32 bit version of the library with the NAG implementation of BLAS and LAPACK. These example results may not be exactly reproducible if the example programs are run in a slightly different environment. The results which are most sensitive to such differences are: eigenvectors (which may differ by a scalar multiple, often −1, but sometimes complex); numbers of iterations and function evaluations and residuals and other "small" quantities of the same order as the machine precision.

7.1 NET Example Application

A NAG Library for .NET application is also included which can be executed from the Start menu (Start->NAG->NAG Library for .NET Version 2->NAG Library for .NET Version 2 Example Application). This application provides a GUI that enables any subset of example programs to be conveniently executed, and also provides a check on the Licence Installation and Activation.

The NAG Library for .NET is a fully licence managed product. To use the product you will need to obtain a license key. See Section 4.3 above for details.

8. Support from NAG

(a) Contact with NAG

Queries concerning this document or the implementation generally should be directed to NAG at one of the addresses given in the Appendix. Users subscribing to the support service are encouraged to contact our support team (see below).

(b) NAG Technical Support Service

The NAG Technical Support Service is available for general enquiries from all users and also for technical queries from sites with an annually licensed product or support service.

The technical support desks are open during office hours, but contact is possible by email and phone (answering machine) at all times.

When contacting us, it helps us deal with your enquiry quickly if you can quote your NAG customer reference number and NAG product code (in this case DTW3A02DAL).

(c) NAG Websites

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 the following URLs:

http://www.nag.co.uk/, http://www.nag.com/, http://www.nag-j.co.jp/.

(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 announcements about new products or product/service enhancements, technical tips, customer stories and NAG's event diary. You can register via one of our websites, or by contacting us at nagnews@nag.co.uk.

(e) Product Registration

To ensure that you receive information on updates and other relevant announcements, please register this product with us. For NAG Library products this may be accomplished by filling in the online registration form at http://www.nag.co.uk/numeric/Library_Registration.asp.

9. User Feedback

Many factors influence the way that 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 any of the NAG offices (shown below).

Appendix - Contact Addresses

NAG Ltd
Wilkinson House
Jordan Hill Road
OXFORD  OX2 8DR                         Technical Support (Europe & ROW)
United Kingdom                          email: support@nag.co.uk

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

NAG Inc
801 Warrenville Road
Suite 185
Lisle, IL  60532-4332                   Technical Support (North America)
USA                                     email: support@nag.com

Tel: +1 630 971 2337                    Tel: +1 630 971 2337

Nihon NAG KK
Hatchobori Frontier Building 2F
4-9-9
Hatchobori
Chuo-ku
Tokyo 104-0032                          Technical Support (Japan)
Japan                                   email: naghelp@nag-j.co.jp

Tel: +81 3 5542 6311                    Tel: +81 3 5542 6311