C H A P T E R  3

Installing the Software on Nodes Running the Linux OS

This chapter includes the following sections:


Supported Linux Versions

Sun HPC ClusterTools 8.2.1c software supports Red Hat Linux (RHEL) 5, SUSE Linux (SLES) version 10, and CentOS 5.3 Linux. The Linux packages are delivered in RPM and tarball format. Ten ClusterTools 8.2.1c RPMs are available and built with each of the following compilers:

For each compiler-specific RPM, an i386 (32-bit) and x86_64 (64-bit) RPM is available. The file names of the RPMs are listed below. The <x> component represents the build number of the most recent build of the software:


Unpacking the Linux Packages

In this example, the commands install the SUSE Linux version 9 package built with the Sun Studio 12 compiler. Substitute the file name of the Linux version you want to install for ClusterTools-8.2.1c_compiler-name-x.x86_64.rpm.

  1. Create a scratch directory (called $SCRATCH_DIR in this example) on the system on which you are installing the ClusterTools 8.2.1c software.

  2. Type the following commands to unpack the Linux packages, substituting the name of your scratch directory and the name of the Linux package you want to install.


    # cd SunHPCClusterTools_8.2.1c/
    # cp sun-hpc-ct-8.2.1c-Linux-x86_64.tar.gz $SCRATCH_DIR
    # cd $SCRATCH_DIR
    # gunzip sun-hpc-ct-8.2.1c-Linux-x86_64.tar.gz
    # tar xf sun-hpc-ct-8.2.1c-Linux-x86_64.tar
    


Installation Location Notes

By default, the software is installed into /opt/SUNWhpc/HPC8.2.1c/compiler. You can use the --relocate option on the rpm --install command line to install the software into another location.

For example, the following command line will cause the software to be installed into /usr/mpi/clustertools8.2.1c/intel:


rpm --install --relocate=/opt/SUNWhpc/HPC8.2.1c/intel=/usr/mpi/clustertools8.2.1c/intel

To use this path, you must set both the PATH and OPAL_PREFIX variables. The following example uses the non-default path specified in the previous example:


setenv PATH OPAL_PREFIX /usr/mpi/clustertools8.2.1c/intelsetenv PATH $(OPAL_PREFIX)/bin:$(PWATH)


Installing the RPM Packages

You need to install the RPM packages individually on each Linux node in your cluster. To facilitate the process, you might want to use a parallel SSH tool such as cconsole. For more information on cconsole, see Cluster Console Tools.

Other parallel SSH tools include the following:

The following example shows the commands you would type to install the ClusterTools 8.2.1c package (built with the Sun Studio compiler) for SUSE Linux version 9.



Note - You only need to use the rpm --erase command if you already have a previous version of Sun HPC ClusterTools software installed on the system.




# cd sun-hpc-ct-8.2.1c-Linux-x86_64/Product/Install_Utilities/bin
# rpm --erase ClusterTools
# rpm --install ClusterTools-8.2.1c-23.x86_64-sles9-built-with-sun.rpm


Verifying the Software Installation

You can verify that the software is installed properly by launching a simple non-MPI parallel job using mpirun. In the following example, hostname is the name of the system on which the RPM packages were installed:


% /opt/SUNWhpc/HPC8.2.1c/bin/mpirun hostname