NAG Data Mining Components, Release 1

DRSOL10DA

Sun SPARC (Solaris)

Installer's Note



Contents


1. Introduction

This document is essential reading for whoever is responsible for the installation of the NAG Data Mining Components implementation specified in the title. The installer will be supplied with a printed copy of this document. Both this and the Users' Note (Documents/user_sol.html) are supplied on the distribution medium.

The use of all supplied software must be in accordance with the terms and conditions of the Software Licence signed by NAG and each site. Any request to use NAG software on a computer other than the one licensed must be referred to NAG (see Section 5).

2. Implementation Provided

2.1. Applicability

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

hardware:         Sun SPARC Ultra systems
operating system: Solaris 2.6 (SunOS 5.6) or compatible
C compiler:       Sun Workshop 5 C compiler (cc) or compatible

For information about implementations of the NAG Data Mining Components for use on other computer systems please contact NAG.

3. Distribution Medium

3.1. Recording Details

The implementation is distributed in tar format on CD-ROM, unless otherwise indicated on the medium and accompanying despatch note.

3.2. Contents

The following shows the directory/file organization of the library materials as they will be installed. 
                            
                           |-- *.html (NAG Data Mining Components online
            |-- Documents -|-- *.pdf   documentation)
            |               
            |
            |-- Library  --|-- libnag_dmc.a
            |
drsol10da --|
            |-- Include  --|-- *.h
            |
            |              |-- *.c
            |-- Examples --|-- *.dat
            |              |-- Results --|-- *.r
            |
            |              |-- bin ------|-- * (directories of FLEXlm binaries 
            |              |                    for supported platforms)
            |-- License ---|
                           |             |-- flexfaq ---|-- *.htm (FLEXlm FAQ)
                           |-- htmlman --|                         
                                         |-- flexuser --|-- *.htm (FLEXLM End 
                                                                   User Manual)

4. Installation

4.1. Product Installation

To install the NAG Data Mining Components use the Unix tar utility, e.g. 

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

The object library (Library/libnag_dmc.a) should be moved to a directory, such as /usr/lib, in the default search path of the linker, if possible, so that linkage is convenient.

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

4.2. License Management

The use of the NAG Data Mining Components is controlled by the FLEXlm network license management system (FLEXlm is a registered trademark of Globetrotter Software Inc). This release of the NAG Data Mining Components uses version 7.2g of FLEXlm. The remainder of this section describes how a FLEXlm license key should be installed to enable the use of the Components. Further details about FLEXlm and how it may be configured to suit your local circumstances are included in the FLEXlm End User Manual and FAQ supplied in the directory drsol10da/License/htmlman.

For the NAG Data Mining Components you will be provided with an uncounted license key for use on a specific machine.

An uncounted license key consists of one FEATURE or INCREMENT line for each product licensed, for example: 

FEATURE NAG_DMC NAG 1.000 31-dec-2001 0 CBDA2041DC1BC45D2B68 \
               "SOLA," 80896b27

This enables an unlimited number of instances of version 1 of the application NAG_DMC until the date specified on the system with hostid 80896b27 only. Note that the line is continued by escaping the newline character with '\'.

You will have to inform NAG of the hostid of the system. To obtain the hostid, locate the FLEXlm utility program 'lmutil' in drsol10da/License/bin/sun4_u5, and run it with argument 'lmhostid'.

Once you have obtained the license key, store the text of it in a file, say /usr/local/lib/nag/license.dat

The location of this file must be made known to the NAG application by setting the environment variable LM_LICENSE_FILE to the full pathname of the file before the application is invoked.

For example, in the C-shell, type: 

setenv LM_LICENSE_FILE /usr/local/lib/nag/license.dat
or in the Bourne shell, type: 
LM_LICENSE_FILE=/usr/local/lib/nag/license.dat
export LM_LICENSE_FILE

No other actions are required to install an uncounted license.

4.3. Documentation Installation

The online documentation for the NAG Data Mining Components is located in directory Documents. This User Guide is a set of both HTML and PDF files the root of which is the file nag_dmc_intro.html. You are encouraged to make the guide readily available to users, but in such a way that it is not generally accessible from outside your site. Please note that if you do not have a pdf viewer available then the Adobe Acrobat Reader can be downloaded free of charge from the Adobe Web site at http://www.adobe.com/.

4.4. Checking Accessibility

The installer should ensure that the advice given to users in Sections 3.1 and 3.2 of the Users' Note (Documents/user_sol.html) is suitable for the installation. This can be done by running a few example programs, in directory Examples, following that advice; the expected results are located in directory Examples/Results.

4.5. Release to Users

The Users' Note (Documents/user_sol.html) should be checked and amended as necessary (particularly Sections 3.1, 3.2 and 3.3). Besides modifying the commands required to access the NAG Data Mining Components you can give precise information regarding the location of the online documentation and the example programs at your installation.

The following material should also be made accessible to users:

compiled library: 

Library/libnag_dmc.a
include files: 
Include/*.h
example program material: 
Examples/*.c
Examples/*.dat
Examples/Results/*.r
documentation files: 
Documents/*.html
Documents/*.pdf

5. Support from NAG

(a) How to Contact NAG

If you have any queries concerning the installation or use of this product please contact NAG directly using one of the methods given below.

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

(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 you may want to register to receive our electronic newsletter, which will alert you to special offers, announcements about new products or product/service enhancements, case studies and NAG's event diary. To register visit one of our websites or contact us at nagnews@nag.co.uk.

6. 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 by email at feedback@nag.co.uk. Alternatively contact the appropriate NAG Response Centre who will be happy to record your comments.

Appendix - How to Contact NAG

NAG Ltd
Tel: +44 (0)1865 511245
Fax: +44 (0)1865 310139   
                               
NAG Ltd Response Centre
email: support@nag.co.uk
Tel: +44 (0)1865 311744
Fax: +44 (0)1865 310139
 
NAG Inc
Tel: +1 630 971 2337 
Fax: +1 630 971 2706                    
                   
NAG Inc Response Center
email: infodesk@nag.com
Tel: +1 630 971 2345
Fax: +1 630 971 2706
 
Nihon NAG KK
Tel: +81 (0)3 5542 6311
Fax: +81 (0)3 5542 6312

email: help@nag-j.co.jp


[NP3627/IN]