Installation

Chapter 5. Installation-Related Procedures

This chapter contains various procedures that are related to the PE installation procedure provided in Chapter 4. "Installing the PE Software".

Removing an Installation Image

During the installation process, you may decide to remove a fileset from the system. If you have already installed it on a number of nodes, you may wish to use one of the "deinstallation" scripts provided with PE:

• PEdeinstallSP

• PEdeinstall

For detailed information about these scripts and how to run them, see "Deinstallation Scripts".

Recovering from a Software Vital Product Database Error

If you install PE frequently, you may encounter an error such as:

0503-283 :  Error in the Software Vital Product Data.  The "usr"
        part of a product does not have the same requisite file
        as the "root" part.  The product is: ppe.poe     2.4.0.0

This usually means there is an incompatibility in the Object Data Manager (ODM) as a result of installing a version of a product where prerequisites may have changed.

You need to remove the entries for a product from ODM. The following set of commands is one way to solve this problem (using POE as an example):

ODMDIR=/usr/lib/objrepos odmdelete -o product -qlpp_name=ppe.poe
ODMDIR=/usr/lib/objrepos odmdelete -o lpp -qname=ppe.poe
ODMDIR=/etc/objrepos odmdelete -o product -qlpp_name=ppe.poe
ODMDIR=/etc/objrepos odmdelete -o lpp -qname=ppe.poe

Customizing the Message Catalog

Message cataloging is used by all PE filesets so that messages can be displayed in languages other than English. Each fileset has message catalogs installed in a directory located by the NLSPATH environment variable. The message catalogs are installed in three common English language paths and are in the format of <component>.cat. The paths are:

/usr/lib/nls/msg/en_US

/usr/lib/nls/msg/En_US

/usr/lib/nls/msg/C

Notes:

1. Before verifying the installation for POE and VT, you should set the LANG environment variable to C.

2. If the message catalogs are installed in a directory other than C, then you need to modify /etc/environment to set the NLSPATH to the appropriate directory. You also need to set the user's LANG environment variable.

Enabling Fortran 90 Compiler Support

There are some restrictions and limitations in the MPI language bindings for Fortran 90.

For more information on the restrictions and implications of using MPI and the Fortran 90 compiler scripts, refer to the /usr/lpp/ppe.poe/samples/mpif90/README.mpif90 file after POE has been installed.

Header Files

An MPI Fortran 90 language bindings header file (mpif90.h) is shipped as a sample file; if you have users with existing programs that depend on this file, you need to copy it to the usual location so that these users can continue to compile such programs with it.

With PE Version 2 Release 3, the mpif.h header file is formatted to work for both mpxlf and mpxlf90 compilation. Users writing new code should use mpif.h.

Installing Communication Subsystem (CSS) Component of IBM Parallel System Support Programs for AIX After POE has been Installed

The CSS installation processing automatically establishes links to their message passing libraries in place of those supplied by POE. For your information, the following links are made when CSS is installed after POE:

This link:	To:
/usr/lpp/ppe.poe/lib/ip/libmpci.a	/usr/lpp/ssp/css/libip/libmpci.a
/usr/lpp/ppe.poe/lib/ip/libmpci_r.a	/usr/lpp/ssp/css/libip/libmpci_r.a
/usr/lpp/ppe.poe/lib/us/libmpci.a	/usr/lpp/ssp/css/libus/libmpci.a
/usr/lpp/ppe.poe/lib/us/libmpci_r.a	/usr/lpp/ssp/css/libus/libmpci_r.a

Servicing the POE Version of libc.a and libc_r.a

POE maintains copies of libc.a and libc_r.a, which are used to create the entry and exit points when a user's application is compiled with POE. In doing so, it creates a version of libc.a and libc_r.a for POE's use based on the system's copies.

As a result, when applying service that changes /usr/lib/libc.a and /usr/lib/libc_r.a, it is necessary to rebuild the POE version of libc.a. (In AIX Version 4.3, libc_r.a is a link to libc.a.) For this reason, POE ships a script called makelibc that automatically rebuilds its copies of libc.a and libc_r.a. Copies of libc.a and libc_r.a are also created in the /usr/lpp/ppe.poe/lib/profiled directory, if AIX Base Profiling Support is installed.

Any time you apply service that modifies /usr/lib/libc.a , you should run the makelibc script.

The makelibc script is in the /usr/bin path. You must run as root in order to run the script and rebuild the libraries.

AFS Installation Instructions

This section contains the instructions for tailoring the Parallel Operating Environment and pedb for execution with the AFS file system. The source files settokens.c and gettokens.c are intended to be used with Transarc's Kerberos Authentication program, but should be usable as a guide for other environments.

The files needed for setting up the AFS execution are in the /usr/lpp/ppe.poe/samples/afs directory. They are:

README.afs

README file that contains much of the same information in this section

gettokens.c

Subroutine to get an AFS token on the node where the user is logged on (or already authenticated)

settokens.c

Subroutine to put an AFS token on the remote node which is running the user's executable

makefile

Makefile for creating object modules from settokens.c and gettokens.c

buildAFS

Sample shell script for replacing the routines settoken and gettokens distributed with POE by the routines built by the makefile

Perform the following procedure as root for setting up POE and pedb for AFS execution:

1. Type cd /usr/lpp/ppe.poe/samples/afs to switch to the appropriate directory or copy the contents of the directory to a convenient location.

2. Issue the make command to create the files settokens.o and gettokens.o from gettokens.c and settokens.c. If you are not using the Transarc system, you may need to alter these routines to provide the desired token access. The calling sequence of the parameters cannot be changed.

3. Verify that the partition manager daemon, pmdv2, the home node partition manager, poe, and the parallel debugger, pdbx, are in /usr/lpp/ppe.poe/bin. Verify that the X-Windows parallel debugger, pedb, is in /usr/lpp/ppe.pedb/bin. If not, modify the buildAFS script.

   Note:

   Before completing the following step, ensure that you have the following amounts of available space in the current directory: Component(s) Being Built Total Available Space Required (in Megabytes) poe, pmdv2, and pdbx 2 pedb 1.5

4. Type buildAFS to create new versions of poe, pdbx, pedb, and pmdv2 in the current directory. If the linking step fails, locate the libraries containing the modules that were not found, and alter the library search list in buildAFS to include them.

   Note:

   If pedb is not currently installed, the steps to modify it for AFS execution are skipped.

5. Move poe, pdbx, and pmdv2 to their normal location in /usr/lpp/ppe.poe/bin on each node. Move pedb to its normal location in /usr/lpp/ppe.pedb/bin. You can rename the old versions in case they need to be restored. Make sure that they are made executable.

6. You should not have to modify your program executables. You can now pass AFS authorization across the partition.

7. The .rhosts file in the user's home directory has to include the nodes which are intended for Parallel Operating Environment use. This ensures that the proper access is permitted.