NAG Toolbox for MATLAB®

MBMI622DDL - License Managed

Mac OS X 10.5 (Intel 64 bit), MATLAB R2009b - R2011a

Installer's Note - MATLAB-based installation



Contents


1. Introduction

This Installer's Note is essential reading for whoever is responsible for the installation of this implementation of the NAG Toolbox for MATLAB. Please note administrative (root) rights are required in order to install the NAG Toolbox for MATLAB.

Your attention is drawn to the terms and conditions of the Software License Agreement 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

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

hardware:             Apple Intel Mac 64-bit
operating system:     OS X 10.5 and compatible
MATLAB Version:       7.9 (R2009b), 7.10 (R2010a) and 7.11 (R2010b)

The system must have MATLAB installed. This implementation may work with later versions of MATLAB. 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/mb22/mi6ddl/postrelease.html

for details of any new information related to the applicability or usage of this implementation.

3. Distribution Medium

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.

3.1. File Sizes

The approximate files sizes are given below
Help material    40 MB
Toolbox files    145 MB

4. Installation

If you have downloaded the toolbox materials from our website, double click on MBMI622DDL.dmg. This will mount itself on your system as /Volumes/MBMI622DDL and will extract the installation browser, i.e. InstallNAGToolbox.m, in addition to the files in.html and License Installer.app and other files.

If you received the product on CD then simply insert it in your CD drive and, if necessary, mount the CD device (normally this will happen automatically). This will contain the same files as the .dmg file above.

To install the NAG Toolbox for MATLAB software, start MATLAB and at the MATLAB prompt type

cd /Volumes/MBMI622DDL
InstallNAGToolbox
and follow the instructions in the installation browser. Your MATLAB path and MATLAB script will be updated during installation. You will need to restart MATLAB to finalise the installation.

After installation, you should ensure that the software described in Section 4.1 is present and accessible. Then on starting the MATLAB Help browser you should see the entry NAG (64 bit) Toolbox in the Contents list.

A quick test that the software has been correctly installed is to type a00aa at the MATLAB prompt, which should print some implementation details.

4.1. Installation Information

By default, MBMI622DDL is installed under your MATLAB installation. The help files will be placed in the directory help/toolbox/NAG while the executable files will be placed in toolbox/NAG/mex.maci64.

The MATLAB path is updated during installation, i.e., the file toolbox/local/pathdef.m will be modified. If you install the toolbox under /MyMatlab/MBMI622DDL then this file will have the lines:

  '/MyMatlab/MBMI622DDL/toolbox/NAG/mex.maci64:' ...
  '/MyMatlab/MBMI622DDL/help/toolbox/NAG:' ...
  '/MyMatlab/MBMI622DDL/help/toolbox/NAGToolboxDemos:' ...
inserted. Your MATLAB script will be modified during installation and the file bin/matlab in the MATLAB distribution will have the lines:
  # Inserted during installation of NAG Toolbox for 64 bit OS X
  DYLD_LIBRARY_PATH=/MyMatlab/MBMI622DDL/toolbox/NAG/mex.maci64:$DYLD_LIBRARY_PATH
added to it. If you decide to modify your DYLD_LIBRARY_PATH by hand then a good approach is to edit the definition of LDPATH_PREFIX in the .matlab7rc.sh file. The main reason that this is not the approach taken by the installation script is that MATLAB allows a user to override the system-wide version with their own version(s) and so it is not possible reliably to install the toolbox for all users this way. The MATLAB documentation contains more information about the use of the .matlab7rc.sh file.

4.2. Uninstalling the Software

To uninstall the software, at the MATLAB prompt type
UninstallNAGToolbox
This will remove the NAG toolbox and will restore your MATLAB path and MATLAB script.

4.3. License Management

The use of the NAG Toolbox is controlled by the Kusari license management system. This release of the NAG Toolbox uses version 2.2-20 of Kusari.

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

MBMI622DD TRIAL 2011/10/10 "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 a simple text file containing details of the software that will be enabled.

License key request and installation is performed through the installation browser. At the end of 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 you can enter it into the license installer (License Installer.app). The license installer will save the license key in /opt/NAG/nag.key (prepending to the file if it already exists). After installation, you can run the license installer from the MATLAB prompt by typing

RunNAGLicenseInstaller
The toolbox 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.

5. Documentation

On-line documentation, accessible via the standard MATLAB help facilities, is bundled with this implementation. Please see Section 4.

6. Support from NAG

NAG will provide free support for this product for a period of 90 days from the date of purchase. Beyond that period, support will continue to be provided for users who have a current support agreement.

(a) 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, it helps us deal with your enquiry quickly if you can quote your NAG site reference or account number and NAG product code (in this case MBMI622DDL).

(b) 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/ or http://www.nag-gc.com/

(c) 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.

7. 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 Response Centres (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                          Nihon NAG Response Centre
Japan                                   email: support@nag-j.co.jp

Tel: +81 3 5542 6311                    Tel: +81 3 5542 6311
Fax: +81 3 5542 6312                    Fax: +81 3 5542 6312

NAG Taiwan Branch Office
5F.-5, No.36, Sec.3
Minsheng E. Rd.
Taipei City 10480                       NAG Taiwan Response Centre
Taiwan                                  email: support@nag-gc.com

Tel: +886 2 25093288                    Tel: +886 2 25093288
Fax: +886 2 25091798                    Fax: +886 2 25091798