Installation

Installation Scripts

PE provides the following two installation scripts, explained in the sections below:

• For an SP: PEinstallSP
• For an IBM pSeries or RS/6000 processor: PEinstall

PEinstallSP

You can use the PEinstallSP script to install any of the filesets on SP nodes through the use of the Distributed Shell (dsh). In order to run the PEinstallSP script, you must first set up a host list file of all nodes on which you want a particular fileset installed. The PEinstallSP script either mounts or copies the installation image to each node in the list. It then executes the proper installp command to install the product.

Because PEinstallSP makes extensive use of dsh, it can run only on SP nodes. Also, you must ensure that you have the proper access to run the dsh command to access your nodes.

The PEinstallSP script has one required parameter and three optional parameters. The syntax is:

PEinstallSP image_name [host_list_file] [-f fanout_value] [-copy | -mount]

Where:

image_name

is required. It specifies the name of the file that contains the installp image, of which the fileset is a part.

host_list_file

is optional and specifies the name of the file containing the list of nodes on which you want to install the fileset. The default file name is host.list in the current working directory. If a host list file cannot be found, the script exits with an error message.

fanout_value

is optional and specifies the dsh fanout value. This is the number of nodes for concurrent command execution. The default is 16. See the dsh command in IBM Parallel System Support Programs for AIX: Command and Technical Reference for more information.

You can specify either -copy or -mount to instruct PEinstallSP to copy or mount the installation image to each node. The default is -copy. For more information on copying or mounting installation images, refer to Copying the Installation Image or Mounting the Installation Image.

PEinstall

You can use the PEinstall script to install any of the PE filesets on IBM pSeries or RS/6000 nodes using the Remote Shell (rsh).

To run the PEinstall script, first set up a host list file of all nodes on which you want to install a particular fileset. You must have /usr resident. The PEinstall script either mounts or copies the installation image to each node in the list, and then executes the proper installp command to install the product.

The PEinstall script has one required parameter and two optional parameters. The syntax is:

PEinstall image_name [host_list_file] [-copy | -mount]

Where:

image_name

is required. It specifies the name of the file that contains the installp image, of which the PE fileset is a part.

host_list_file

is optional and specifies the name of file containing the list of nodes on which you want to install the fileset. The default file name is host.list in the current working directory. If a host list file cannot be found, the script exits with an error message.

You can specify either -copy or -mount to tell PEinstall to copy or mount the installation image to each node. The default is -copy.

Copying the Installation Image

Using the -copy option (or allowing it as the default) informs PEinstallSP or PEinstall to copy the named image to each node using rcp. You are prompted for the following information when you specify -copy (or defaulted):

• The installation image source directory. The default is /spdata/sys1/install/pssplpp for PEinstallSP and /usr/sys/inst.images for PEinstall.
• The installation image destination directory which is used for all nodes in the node list. The default is /spdata/sys1/install/pssplpp for PEinstallSP and /usr/sys/inst.images for PEinstall.

  Note:

  To have the image copied to different directories, invoke PEinstallSP or PEinstall for each different location or set of locations. Your host.list file should reflect only those nodes that you want to use with -copy.

The image is copied to the destination directory with the name specified as the image_name parameter. Be sure there is enough space in the destination directory file system for the image. Each image occupies approximately three megabytes.

Mounting the Installation Image

Specifying the -mount option informs PEinstallSP or PEinstall to mount the named image to each node using dsh (for PEinstallSP) or rsh (for PEinstall). You are prompted for the following information when you specify -mount:

• The installation image source directory. The default is /spdata/sys1/install/pssplpp for PEinstallSP and /usr/sys/inst.images for PEinstall.
• The remote node mount point directory. This is used for all nodes in the node list. The default is /mnt.

  Note:

  To have the image mounted to different directories, invoke PEinstallSP or PEinstall for each different location or set of locations. Your host.list file should reflect only those nodes that you want to use with -mount.

• When mounting the image, PEinstallSP or PEinstall also asks if you want to create the remote mount directory. If your remote mount directory already exists, answer no to this prompt.

PEinstallSP or PEinstall issues a mkdir command for the directory name specified, followed by a chmod 777. To execute the installp remotely on a mounted image, the directory containing the image needs to have this permission.

To avoid creating the directory with world-writable permissions, do not use the -mount option of PEinstallSP or PEinstall.