Engineering and Scientific Subroutine Library for AIX Version 3 Release 3: Installation Memo

Document Number GI10-0604-04

5765-C42

Fifth Edition (December 2001)

This edition applies to Version 3 Release 3 of the IBM^(R) Engineering and Scientific Subroutine Library (ESSL) for Advanced Interactive Executive (AIX^(R)) licensed program, program number 5765-C42, and to all subsequent releases and modifications until otherwise indicated by new editions.

In this document, ESSL refers to the above version of ESSL for AIX. Changes are periodically made to the information herein.

Order IBM publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address given below.

IBM welcomes your comments. A form for reader's comments appears at the back of this publication. If the form has been removed, address your comments to:

International Business Machines Corporation

Department 55JA, Mail Station P384

2455 South Road

Poughkeepsie, NY 12601-5400

United States of America

 

FAX (United States & Canada): 1+845+432-9405

FAX (Other Countries):

   Your International Access Code +1+845+432-9405

 

IBMLink^(TM) (United States customers only): IBMUSM(MHVRCFS)

IBM Mail Exchange: USIB6TC9 at IBMMAIL

Internet e-mail: mhvrcfs@us.ibm.com

World Wide Web: http://www.ibm.com/servers/eserver/pseries

If you would like a reply, be sure to include your name, address, telephone number, or FAX number.

Make sure to include the following in your comment or note:

• Title and order number of this book
• Page number or topic related to your comment

When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.

© Copyright International Business Machines Corporation 1997, 2001. All rights reserved.
U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

Introduction

Installing ESSL Version 3 Release 3 on AIX

Keeping ESSL 3.1.2 POWER2 Libraries

Locating and Obtaining ESSL Documentation

Appendix A. List of ESSL Product Files

Notices

Tell Us What You Think

Introduction

This memo provides information needed to install:

Product:

Engineering and Scientific Subroutine Library Version 3 Release 3 (program number 5765-C42)

On operating system:

AIX 5L^(TM) for POWER Version 5.1, with service

If you have POWER2 processors and require the tuned ESSL 3.1.2 POWER2 Libraries, first read the section "Keeping ESSL 3.1.2 POWER2 Libraries".

The topics covered in this memo are listed in the table below.

Installing ESSL Version 3 Release 3 on AIX

This chapter provides step-by-step instructions for installing:

Product:

Engineering and Scientific Subroutine Library Version 3 Release 3 (program number 5765-C42)

On operating system:

AIX 5L for POWER Version 5.1, with service

Table 1 summarizes the required steps. When performing each step of the installation, enter all commands as shown, because AIX commands are case sensitive.

Table 1. Overview of Installation on AIX

Step 1. Plan the Installation

Before installing ESSL, contact your IBM Support Center for any updates to the information and procedures in this installation memo. When requesting this information, specify the following:

Upgrade:

ESSLAIX33

Subset:

ESSLAIX/330

Plan your installation according to the requirements listed in the table below.

Table 2. Installation Requirements

Type of Requirement	Requirement
Operating system	AIX 5L for POWER Version 5.1, with service (program number 5765-E61), or later modification levels
Hardware	All (R) pSeries(TM) and RS/6000(R) processors supported by the above operating system.
Software	For compiling XL Fortran for AIX, Version 7.1.1 (program number 5765-E02) -or- VisualAge(R) C++ Professional for AIX Version 5.0.2 (program number 5765-E26) -or- C for AIX, Version 5.0.2 (program number 5765-E32) For linking, loading, or running XL Fortran Run-Time Environment for AIX, Version 7.1.1 (program number 5765-E03) -and- C libraries1 1 The AIX product includes the C and math libraries in the Application Development Toolkit.
Disk space	essl.rte (package):
		essl.rte.common	1.9 M
		essl.rte.rs1	0.1 M
		essl.rte.rs2	0.1 M
		essl.rte.smp	0.1 M
	essl.rte.rs143		17.3 M
	essl.rte.rs243		0.1 M
	essl.rte.smp43		21.2 M
	essl.msg.en_US		0.1 M
	essl.msg.En_US		0.1 M
	essl.html.en_US		4.5 M
	essl.pdf.en_US		5.8 M
Installation materials	CD-ROM, ESSL feature LCD4-4671-01

Step 2. Determine Which ESSL Filesets To Install

ESSL is packaged on the medium in such a way that groups of files forming a logical unit of the product can be individually installed, allowing you to install only those files that you need. Each installable group of files is called a "fileset." The ESSL filesets are described in Table 3.

Based on your needs, decide which ESSL filesets to install.

Table 3. ESSL Product Filesets

Step 3. Log in to the AIX Root and Install ESSL

There are two variations of this step:

• "Install on one node at a time"
• "Install on several SP(TM) nodes at once"

Follow the variation that is appropriate for your installation.

Notes:

1. The XLF Run-time Environment is a prerequisite to installation of ESSL.

2. No application programs that are using ESSL Libraries should be in progress when executing this step.

Install on one node at a time

Follow the steps below to install ESSL on one node at a time:

1. Log in to the AIX root.
2. Put the CD in the drive.
3. Enter smit on the AIX command line, and follow the Software Installation panels (see sample panel path below).

   Note:

   If you need more information about the smit command, use the help facility within SMIT.

   Figure 1. Sample Software Installation Panels
   

   +--------------------------------------------------------------------------------+
   |Software Installation & Maintenance                                             |
   |      Install and Update Software                                               |
   |         Install and Update from LATEST Available Software                      |
   |              Install and Update from LATEST Available Software                 |
   +--------------------------------------------------------------------------------+

4. When the "Install and Update from LATEST Available Software" panel is displayed, either:
   • Press F4 or click on LIST, then select the appropriate input device and press Enter;

     --or--

   • Type the name of the directory where the filesets are located, then press Enter.
5. When the "Install and Update from LATEST Available Software" panel is displayed again, either:
   • Type the names of the ESSL filesets you want to install in the "SOFTWARE to install" field, then press Enter;

     --or--

   • Do the following:
     1. Press F4 to list the available filesets (as described in Table 3).
     2. Press F7 to select the ones you want to install, then press Enter.

        Messages are displayed as the installation of each fileset is successfully completed.

        Notes:

        1. For details about the contents of each package or fileset, see Table 3.

        2. To install all the run-time libraries, select essl.rte.

           Attention: If you select essl.rte, then the filesets essl.rte.rs2 and essl.rte.rs243 shipped with this release will automatically be installed, and the ESSL 3.1.2 POWER2 libraries will be removed.

           If you do not wish to have the ESSL 3.1.2 POWER2 libraries removed, do not install the package essl.rte; instead, select specific filesets.

        3. The message filesets will not be listed, but one will automatically be selected for installation based on your setting for locale.

           If you require the messages for another locale, choose "Install and Update from ALL Available Software" in smit instead of "Install and Update from LATEST Available Software"; then press F4 to list the message filesets for selection.

6. Fill in the other fields as appropriate for your situation.

Install on several SP(TM) nodes at once

If you are installing ESSL on several nodes at once, do the following:

1. Copy the packages that contain the filesets to the hard disk of either a node of the SP or the control workstation. To do this:
   1. Put the CD-ROM into the appropriate drive.
   2. Type the following, then press Enter:

      smit bffcreate

      The system displays the "Copy Software to Hard Disk for Future Installation"panel.

   3. In the "INPUT device / directory for software" field, specify the device where the CD-ROM is located, then press Enter.
   4. On the next panel, in the "SOFTWARE package to copy" field, type the name(s) of the package or fileset(s) you want to install, or select them from the list that appears when you click on LIST.

      Note:

      For details about the contents of each package or fileset, see Table 3.

   5. Type information in the other fields on the panel as appropriate for your situation. Whe you have finished filling in the panel, press the Enter key.

      The packages are copied to your hard disk and are placed in the directory that you specified on the SMIT panel.

2. Install the filesets from the hard disk to the various nodes. To do this:
   • Use the dsh and installp commands, specifying the name(s) of the ESSL package or fileset(s) you want to install and the directory in which you previously installed them on the hard disk, as shown in the example below.

     Example:

     If you previously copied the essl.rte package to the /usr/sys/inst.images directory on the hard disk, you would enter the command:

     dsh -av installp -acgNQqwX -d /usr/sys/inst.images essl.rte
     

     Messages are displayed as the installation of each fileset is successfully completed.

     Note:

     The full path name of the dsh command is /usr/lpp/ssp/bin/dsh. For more information about this command, refer to IBM Parallel System Support Programs for AIX: Administration Guide.

Step 4. Run the Installation Verification Programs (IVPs)

To test that the ESSL libraries have been properly installed, you must execute the installation verification programs corresponding to the libraries you have installed and the language from which you will be calling ESSL.

There are two variations of this step:

• "Run the 32-Bit IVP"
• "Run the 64-Bit IVP"

Run the 32-Bit IVP

To run the 32-bit IVP, do the following:

1. Use the cd command to change to a writable directory.
2. Type the following command and press Enter:

   /usr/lpp/essl.rte.common/custom/esslivp language library

   where:

   language

   is the language you want to verify. It can have one of the following values:

   fortran

   The XL Fortran compiler does not have to be on your system to use this value.

   c

   The C compiler must already be on your system to use this value; see Table 2.

   C++

   The C++ compiler must already be on your system to use this value; see Table 2.

   library

   is the ESSL library you are testing. It can have the following values:

   essl

   Test the serial library.

   esslsmp

   Test the SMP library.

   esslp2

   Test the link to the serial library; provided for migration purposes.

   esslp2_r

   Test the link to the serial library; provided for migration purposes.

   essl_r

   Test the link to the serial library; provided for migration purposes.

   Note to SP users:

   On SP nodes, you can use dsh to issue the command.

   Note to POWER2 library users:

   If you kept the ESSL 3.1.2 POWER2 libraries and did not install the filesets essl.rte.rs2 and essl.rte.rs243 shipped with this release, the script /usr/lpp/essl.rte.common/custom/esslivp provided with this release will not work for the library options esslp2 and esslp2_r unless you alter the script, as described in "Keeping ESSL 3.1.2 POWER2 Libraries".

Run the 64-Bit IVP

Note:

You can run the 64-bit IVP only if you have 64-bit hardware.

To run the 64-bit IVP, do the following:

1. Use the cd command to change to a writable directory.
2. Type the following command and press Enter:

   /usr/lpp/essl.rte.common/custom/esslivp64 language library

   where:

   language

   is the language you want to verify. It can have one of the following values:

   fortran

   The XL Fortran compiler does not have to be on your system to use this value.

   c

   The C compiler must already be on your system to use this value; see Table 2.

   C++

   The C++ compiler must already be on your system to use this value; see Table 2.

   library

   is the ESSL library you are testing. It can have the following values:

   essl

   Test the serial library.

   esslsmp

   Test the SMP library.

   essl_r

   Test the link to the serial library; provided for migration purposes.

   Note to SP users:

   On SP nodes, you can use dsh to issue the command.

Keeping ESSL 3.1.2 POWER2 Libraries

This chapter explains what to do if you want to keep the ESSL 3.1.2 POWER2 libraries.

Attention:

If you have POWER2 processors and require the tuned ESSL 3.1.2 POWER2 libraries, note the following:

• The ESSL POWER2 and Thread-safe ESSL POWER2 libraries are not provided in ESSL Version 3 Release 3. Therefore, if you already have the ESSL 3.1.2 POWER2 libraries are already installed, keep them. If they are not already installed, do so now.
• Do not install the filesets essl.rte.rs2 and essl.rte.rs243 shipped with this release, as installing them will automatically remove the ESSL 3.1.2 POWER2 libraries.

Before installing any fileset from ESSL Version 3 Release 3, do the following:

1. Use the following command to make a copy of the directory that was provided with ESSL 3.1.2:

   cp -p /usr/lpp/essl.rte.common/custom your_directory

   where:

   /usr/lpp/essl.rte.common/custom

   is the name of the ESSL 3.1.2 directory.

   your_directory

   is the name of the directory to which you want to copy the ESSL 3.1.2 directory.

2. Edit the script esslivp and change the following line:

   custom_dir="/usr/lpp/essl.rte.common/custom"

   to:

   custom_dir="your_directory"

   where:

   your_directory

   is the name of the directory to which you copied the ESSL 3.1.2 directory.

   The script esslivp now points to your directory, so you can use this altered script to run the IVPs for the library options esslp2 and esslp2_r. (See "Step 4. Run the Installation Verification Programs (IVPs)").

Locating and Obtaining ESSL Documentation

Location of HTML Files

Once you have installed the essl.html.en_US fileset, the HTML files and related control information for the ESSL publications will be located at:

/usr/lpp/essl.html.en_US/html

To allow access to these files from a Web server, you should copy the files or link the directory to a location the server can access.

Note:

Do not move these files from this directory, as some other parts of ESSL link to the HTML publications at this directory location.

Location of PDF Files

Once you have installed the essl.pdf.en_US fileset, the PDF files and related control information for the ESSL publications will be located at:

/usr/lpp/essl.pdf.en_US/pdf

Software Products for Displaying ESSL Documentation

To view the HTML version of the ESSL publications, you need access to a common HTML document browser (such as Netscape Navigator).

To view the PDF version of the ESSL publications, you need access to the Adobe Acrobat Reader. The Acrobat Reader is shipped with the AIX Bonus Pack and is also freely available for downloading from the Adobe web site at:

http://www.adobe.com

ESSL Internet Resources

This section describes the ESSL resources available over the Internet.

ESSL Online Documentation

To obtain documentation online, go to the following Web site:

http://www.ibm.com/servers/eserver/pseries/library

and click on "RS/6000 SP Hardware and Software Books".

ESSL Product Home Pages

The following home page contains information on ESSL and Parallel ESSL:

http://www.ibm.com/servers/eserver/pseries/software/sp/essl.html

SP Resource Center

If you have a question about the SP, PSSP, or a related product, the SP Resource Center can make it easy to find the information, as follows:

• If the ssp.resctr fileset has been installed, you can access the SP Resource Center ¹ by issuing the command:

  /usr/lpp/ssp/bin/resource_center

• If you have the Resource Center on CD ROM, see the readme.txt file for information on how to run it.
• You can access the SP Resource Center Web Site at:

  http://www.rs6000.ibm.com/support/sp/resctr.html

Appendix A. List of ESSL Product Files

Table 4 lists the files created in the file system after installing each ESSL fileset. If you have any files with the same full path name that are not related to ESSL, they must be renamed before installing that fileset.

Table 4. ESSL Product Files, Symbolic Links, and Installation Control Files

Notices

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:
IBM Corporation
Department LJEB/P905
2455 South Road
Poughkeepsie, NY 12601-5400
U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrates programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.

If you are viewing this information softcopy, the photographs and color illustrations may not appear.

Trademarks

The following terms are trademarks of the International Business Machines Corporation in the United States or other countries or both:
AIX
AIX 5L
e (logo)
IBM
IBMLink
pSeries
RS/6000
SP

Other company, product, and service names may be the trademarks or service marks of others.

Software Update Protocol

IBM has provided modifications to this software. The resulting software is provided to you on an "AS IS" basis and WITHOUT WARRANTY OF ANY KIND, WHETHER EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

Tell Us What You Think

ESSL Version 3 Release 3 Installation Memo--December 2001

We'd like to know if you are satisfied with the installation process for ESSL, and we'd appreciate any comments and suggestions you might have. Your feedback on this survey form will help us do a better job. Thank you for your participation.

For each of the topics below please indicate your satisfaction level by circling your choice from the rating scale. If a statement does not apply, please circle N.

 
RATING SCALE:
 
very satisfied <--------------------> very dissatisfied     not applicable
       1        2        3         4           5                    N
 
                                                           Satisfaction
--------------------------------------------------------------------------
 
Ease of product installation                             1  2  3  4  5  N
 
Time required to install the product                     1  2  3  4  5  N
 
Contents of install memo                                 1  2  3  4  5  N
 
Readability and organization of install memo tasks       1  2  3  4  5  N
 
Necessity of all installation tasks                      1  2  3  4  5  N
 
Accuracy of the definition of the installation tasks     1  2  3  4  5  N
 
Technical level of the installation tasks                1  2  3  4  5  N
 
Installation verification procedure                      1  2  3  4  5  N
 
Ease of migrating the product from a previous release    1  2  3  4  5  N
 
Ease of putting the system into production after 
installation                                             1  2  3  4  5  N
 
Ease of installing service                               1  2  3  4  5  N
 
 
 
Is this the first time your organization has installed this product?
 
&box. Yes
&box. No
 
 
Were the people who did the installation experienced with the installation 
of AIX products using SMIT?
 
&box. Yes--How many years of experience do they have? __________
&box. No
 
 
How long did it take to install this product? _________
 
 
If you have any comments to make about your ratings above, or any other aspect 
of the product installation, please list them below: 
 
______________________________________________________________________________ 
______________________________________________________________________________ 
______________________________________________________________________________ 
______________________________________________________________________________
 
 
Please provide the following contact information:
 
Name and Job Title: ____________________________________________________________
 
Address:            ____________________________________________________________ 
                    ____________________________________________________________
 
Telephone:          ______________________
 

Thank you for your participation. Please send or fax the completed form to the following:
IBM Corporation
Dept 85BA MS P963
2455 South Road
Poughkeepsie, NY 12601-5400
Fax: (914)433-8363

¹

Available with PSSP 3.1 or later.