Installation

How Installing the POE Fileset Alters Your System

The ppe.poe fileset includes all of the components of the parallel operating environment (POE), and consists of:

• API subroutine libraries (message passing and collective communication)
• Parallel compilation scripts
• Parallel profiling capability
• The parallel utility library
• Partition manager
• The pdbx debugger
• Program marker array

Installing this fileset, as described in Step 2: Performing the Initial Installation, does the following:

1. If migrating from a previous version or release of POE, the following occurs:
   • Man pages for commands that were shipped in /usr/man/cat1 in the PE 2.4 ppe.poe fileset are removed and replaced with the copies shipped with ppe.man.
   • Man pages for commands that were shipped in /usr/man/cat1 in the PE 2.1 ppe.pedocs fileset are removed and replaced with the copies shipped with ppe.man.
2. Creates the directories and files detailed in the following table:
   

   Table 4. POE directories and files installed
   

   Directory or file	Description
   /usr/lib/nls/msg/en_US/mpci_err.cat /usr/lib/nls/msg/En_US/mpci_err.cat /usr/lib/nls/msg/C/mpci_err.cat	Message catalog for Message Passing Client Interface
   /usr/lib/nls/msg/En_US/pedig.cat /usr/lib/nls/msg/en_US/pedig.cat /usr/lib/nls/msg/C/pedig.cat	Message catalog for trace functions
   /usr/lib/nls/msg/en_US/pempl.cat /usr/lib/nls/msg/En_US/pempl.cat /usr/lib/nls/msg/C/pempl.cat	Message Catalog for Message Passing Library
   /usr/lib/nls/msg/en_US/pepdbx.cat /usr/lib/nls/msg/En_US/pepdbx.cat /usr/lib/nls/msg/C/pepdbx.cat	Message Catalog for pdbx
   /usr/lib/nls/msg/en_US/pepoe.cat /usr/lib/nls/msg/En_US/pepoe.cat /usr/lib/nls/msg/C/pepoe.cat	Message catalog for POE
   /usr/lpp/ppe.poe/bin/mpamddir	Shell script for echoing an AMD mountable directory name
   /usr/lpp/ppe.poe/bin/mcp	Executable for multiple file copy utility
   /usr/lpp/ppe.poe/bin/mcpgath	Executable for parallel file copy gather utility
   /usr/lpp/ppe.poe/bin/mcpscat	Executable for parallel file copy scatter utility
   /usr/lpp/ppe.poe/bin/mpcc	Shell script for compiling parallel C programs
   /usr/lpp/ppe.poe/bin/mpcc_r	Shell script for compiling threaded parallel C programs
   /usr/lpp/ppe.poe/bin/mpCC	Shell script for compiling parallel C++ programs
   /usr/lpp/ppe.poe/bin/mpCC_r	Shell script for compiling threaded parallel C++ programs
   /usr/lpp/ppe.poe/bin/mpiexec	Portable MPI startup script
   /usr/lpp/ppe.poe/bin/mpxlf	Shell script for compiling parallel FORTRAN programs
   /usr/lpp/ppe.poe/bin/mpxlf90	Shell script for compiling parallel FORTRAN 90 programs
   /usr/lpp/ppe.poe/bin/mpxlf95	Shell script for compiling parallel FORTRAN 95 programs
   /usr/lpp/ppe.poe/bin/mpxlf_r	Shell script for compiling threaded parallel FORTRAN programs
   /usr/lpp/ppe.poe/bin/mpxlf90_r	Shell script for compiling threaded parallel FORTRAN 90 programs
   /usr/lpp/ppe.poe/bin/mpxlf95_r	Shell script for compiling threaded parallel FORTRAN 95 programs
   /usr/lpp/ppe.poe/bin/pdbx	Executable to run the command-line interface of the PE debugging facility
   /usr/lpp/ppe.poe/bin/PEdeinstall	Shell script to remove an installation of PE on IBM pSeries or RS/6000 nodes
   /usr/lpp/ppe.poe/bin/PEdeinstallSP	Shell script to remove an installation of PE on SP nodes
   /usr/lpp/ppe.poe/bin/PEinstall	Shell script to complete the installation process on IBM pSeries or RS/6000 nodes
   /usr/lpp/ppe.poe/bin/PEinstallSP	Shell script for installing PE on SP nodes
   /usr/lpp/ppe.poe/bin/pmadjpri	Dispatching priority adjustment daemon
   /usr/lpp/ppe.poe/bin/pmarray	The program marker array program
   /usr/lpp/ppe.poe/bin/pmdv3	An Internet daemon process that runs on each of your processor nodes
   /usr/lpp/ppe.poe/bin/poe	Partition manager executable
   /usr/lpp/ppe.poe/bin/poeckpt	Executable for checkpointing interactive POE applications
   /usr/lpp/ppe.poe/bin/poerestart	Executable for restarting POE applications
   /usr/lpp/ppe.poe/bin/poekill	Shell script for terminating all POE started tasks
   /usr/lpp/ppe.poe/include	Directory of header files containing declarations used by other installed files
   /usr/lpp/ppe.poe/include/pm_ckpt.h	Header for compiling programs with Checkpoint and Restart capability
   /usr/lpp/ppe.poe/include/thread/mpi.mod	MPI Fortran module support (use MPI)
   /usr/lpp/ppe.poe/include/thread64/mpi.med	MPI Fortran 64-bit module support (use MPI)
   /usr/lpp/ppe.poe/include/thread64/mpif.h	Header for compiling 64-bit threaded MPI Fortran applications
   /usr/lpp/ppe.poe/include/VT_mpi.h	Parallel tracing header file
   /usr/lpp/ppe.poe/include/VT_trc.h	Parallel tracing header file
   /usr/lpp/ppe.poe/lib/ip/libmpci.a	Message Passing Client Interface library (IBM pSeries or RS/6000 network cluster only)
   /usr/lpp/ppe.poe/lib/ip/libmpci_r.a	Message Passing Client Interface library (IBM pSeries or RS/6000 network cluster only) in a threads environment
   /usr/lpp/ppe.poe/lib/libmpi.a	Archive library containing subroutines for parallel message-passing programs
   /usr/lpp/ppe.poe/lib/libmpi_r.a	Archive library containing subroutines for parallel message-passing programs in a threads environment
   /usr/lpp/ppe.poe/lib/libppe.a	Archive library containing subroutines for POE
   /usr/lpp/ppe.poe/lib/libpoeapi.a	Archive library containing subroutines for the POE API
   /usr/lpp/ppe.poe/READMES/poe.README	Memo to users relating to this release
   /usr/lpp/ppe.poe/samples	Directory containing sample programs for the program marker array and other samples
   /usr/lpp/ppe.poe/include/poeapi.h	Header file for the POE API
   /usr/lpp/ppe.poe/include/thread/mpif.h	Header file for compiling threaded MPI FORTRAN applications
   /usr/lpp/ppe.poe/samples/scripts/poewhere	Script for displaying the stack trace for each thread of a program
   /usr/lpp/ppe.poe/samples/swtbl	Directory containing sample code for running User Space POE jobs without LoadLeveler

3. When the installp command successfully restores POE's files from the distribution medium, the command looks at the ppe.poe.post_i file for post-installation steps. As part of these post-installation steps, ppe.poe.post_i sets up the following symbolic links:
   

   This link:	To:
   /etc/pmdv3	/usr/etc/pmdv3
   /usr/bin/mpcc	/usr/lpp/ppe.poe/bin/mpcc
   /usr/bin/mpcc_r	/usr/lpp/ppe.poe/bin/mpcc_r
   /usr/bin/mpCC	/usr/lpp/ppe.poe/bin/mpCC
   /usr/bin/mpCC_r	/usr/lpp/ppe.poe/bin/mpCC_r
   /usr/bin/mpamddir	/usr/lpp/ppe.poe/bin/mpamddir
   /usr/bin/mpxlf	/usr/lpp/ppe.poe/bin/mpxlf
   /usr/bin/mpxlf_r	/usr/lpp/ppe.poe/bin/mpxlf_r
   /usr/bin/mpxlf90	/usr/lpp/ppe.poe/bin/mpxlf90
   /usr/bin/mpxlf90_r	/usr/lpp/ppe.poe/bin/mpxlf90_r
   /usr/bin/mpxlf95	/usr/lpp/ppe.poe/bin/mpxlf95
   /usr/bin/mpxlf95_r	/usr/lpp/ppe.poe/bin/mpxlf95_r
   /usr/bin/mcp	/usr/lpp/ppe.poe/bin/mcp
   /usr/bin/mcpgath	/usr/lpp/ppe.poe/bin/mcpgath
   /usr/bin/mcpscat	/usr/lpp/ppe.poe/bin/mcpscat
   /usr/bin/mpiexec	/usr/lpp/ppe.poe/bin/mpiexec
   /usr/bin/pdbx	/usr/lpp/pdbx/bin/pdbx
   /usr/bin/pmarray	/usr/lpp/ppe.poe/bin/pmarray
   /usr/bin/pmdadjpri	/usr/lib/ppe.poe/bin/pmdadjpri
   /usr/bin/poe	/usr/lpp/poe/bin/poe
   /usr/bin/poeckpt	/usr/lpp/ppe.poe/bin/poeckpt
   /usr/bin/poekill	/usr/lpp/ppe.poe/bin/poekill
   /usr/bin/poerestart	/usr/lpp/ppe.poe/bin/poerestart
   /usr/etc/pmdv3	/usr/lpp/ppe.poe/bin/pmdv3
   /usr/include/VT_mpi.h	/usr/lpp/ppe.poe/include/VT_mpi.h
   /usr/include/VT_trc.h	/usr/lpp/ppe.poe/include/VT_trc.h
   /usr/lpp/poe/lib/ip/libmpci.a	/usr/lpp/ssp/css/libip/libmpci.a (SP only)
   /usr/lpp/poe/lib/us/libmpci.a	/usr/lpp/ssp/css/libus/libmpci.a (SP only)
   /usr/lpp/X11/lib/X11/app-defaults/PMarray	/usr/lpp/ppe.poe/samples/marker/PMarray.ad
   /usr/sbin/PEdeinstall	/usr/lpp/ppe.poe/bin/PEdeinstall
   /usr/sbin/PEdeinstallSP	/usr/lpp/ppe.poe/bin/PEdeinstallSP
   /usr/sbin/PEinstall	/usr/lpp/ppe.poe/bin/PEinstall
   /usr/sbin/PEinstallSP	/usr/lpp/ppe.poe/bin/PEinstallSP

4. During installation, if an existing version of ppe.poe is installed, the following files are saved during installation of the new version in the /usr/lpp/save.config directory:

   /usr/lpp/ppe.poe/bin/mpamddir
   /usr/lpp/ppe.poe/bin/mpcc
   /usr/lpp/ppe.poe/bin/mpCC
   /usr/lpp/ppe.poe/bin/mpcc_chkpt
   /usr/lpp/ppe.poe/bin/mpCC_chkpt
   /usr/lpp/ppe.poe/bin/mpcc_r
   /usr/lpp/ppe.poe/bin/mpCC_r
   /usr/lpp/ppe.poe/bin/mpxlf
   /usr/lpp/ppe.poe/bin/mpxlf90
   /usr/lpp/ppe.poe/bin/mpxlf95
   /usr/lpp/ppe.poe/bin/mpxlf_chkpt
   /usr/lpp/ppe.poe/bin/mpxlf90_chkpt
   /usr/lpp/ppe.poe/bin/mpxlf95_chkpt
   /usr/lpp/ppe.poe/bin/mpxlf_r
   /usr/lpp/ppe.poe/bin/mpxlf90_r
   /usr/lpp/ppe.poe/bin/mpxlf95_r
   /usr/lpp/ppe.poe/lib/poe.cfg
   

   If these files were previously modified, the older versions are preserved in the /usr/lpp/save.config directory and the new versions will need to be updated.

POE Installation Effects

Also, as part of the post-installation steps, the following steps occur.

1. The file /etc/services is modified in the following manner:
   • If no entry for the pmv3 service is found, an entry is added using port 6126/tcp.
   • If an entry exists for the pmv3 service that uses port 6126/tcp, no change is made to the /etc/services file.
   • If one of the following is true:
     1. A pmv3 entry exists for a port other than 6126/tcp
     2. A 6126/tcp entry exists for a service other than pmv3

     the user receives a warning and is instructed to correct the problem before running POE. When the user receives this warning, he must manually update the /etc/services file to ensure that the port number for the pmv3 service is the same on all machines that could run POE Version 3.

   • If no entry for the pmv2 service is found, an entry is added using port 6125/tcp.
   • If an entry exists for the pmv2 service that uses port 6125/tcp, no change is made to the /etc/services file.
   • If one of the following statements is true:
     1. A pmv2 entry exists for a port other than 6125/tcp
     2. A 6125/tcp entry exists for a service other than pmv2

     the user receives a warning and is instructed to correct the problem before running POE. When this warning is received, the user must manually update the /etc/services file in such a way as to ensure that the port number for the pmv2 service is the same on all machines that could run POE Version 2.

2. The file /etc/inetd.conf is modified.

   An entry for the pmv3 service that spawns the /etc/pmdv3 daemon is created if no pmv3 entry exists.

3. inetd is refreshed.
4. If a symbolic link for /usr/etc/digd to /usr/lpp/ppe.vt/bin/digd exists, but /usr/lpp/ppe.vt/bin/digd itself does not exist, the link is removed.
5. The existence of IP and US versions of libmpci.a and libmpci_r.a from CSS is verified.
6. Executable versions of mcp, mcpgath, and mcpscat are created.