Appendix A. Quick Installation Guide

This appendix gives a brief overview how to install ParaStation MPI on a cluster. A detailed description can be found in Chapter 3 and Chapter 4.

  1. Shutdown

    If this is an update of ParaStation MPI, first shut down the ParaStation MPI system. In order to do this, startup psiadmin and issue a shutdown command.

      # /opt/parastation/bin/psiadmin
      psiadmin> shutdown

    This will terminate all currently running tasks controlled by ParaStation MPI, including psiadmin.

  2. Get the installation packages

    Get the necessary installation packages from the download section of the ParaStation MPI homepage Required packages are psmgmt, pscom and psmpi2. The documentation packages psmpi-doc and psmpi2-doc are optional.

    If you want to compile the packages yourself, download the source packages (*.src.rpm) and rebuild it, using the rpmbuild command, e.g.:

      # rpmbuild --rebuild psmgmt.5.0.0-0.src.rpm
      # rpm -U psmgmt.5.0.0-0.i586.rpm
      # rpmbuild --rebuild pscom.5.0.0-0.src.rpm
      # rpm -U pscom.5.0.0-0.i586.rpm
      # rpm -U pscom-modules.5.0.0-0.i586.rpm
      # rpmbuild --rebuild psmpi2.5.0.0-1.src.rpm
      # rpm -U psmpi2.5.0.0-1.i586.rpm

    The psmgmt package must be installed before the pscom package may be built, similar for pscom and psmpi2. If you only want to rebuild the kernel modules for the p4sock protocol, use

      # rpmbuild --rebuild --with modules pscom.5.0.0-0.src.rpm

    This will render a RPM package with the ParaStation MPI kernel modules suitable for your setup.

  3. Install software on the server

    Install the ParaStation MPI distribution files on the server machine, if not yet done:

      # rpm -U psmgmt.5.0.0-0.i586.rpm pscom.5.0.0-0.i586.rpm \
      pscom-modules.5.0.0-0.i586.rpm psmpi2.5.0.0-1.i586.rpm \
  4. Install software on the compute nodes

    Repeat step 3 for each node. You may omit the documentation package.

  5. Configuration

    Next, the configuration file parastation.conf has to be adapted to the local settings. The template file /opt/parastation/config/parastation.conf.tmpl should be copied to /etc/parastation.conf and adjusted to the local needs. The configuration could be verified using the command test_config(1) located in /opt/parastation/bin.

    This configuration file must be copied to all other nodes.

  6. Startup ParaStation MPI

    Provided the ParaStation MPI daemon is started by the xinetd, run the psiadmin(1) command located in /opt/parastation/bin and execute the add command. This will bring up the ParaStation MPI daemon psid(8) on every node.

      # /opt/parastation/bin/psiadmin
      psiadmin> add

    Alternatively you can start psiadmin(1) with the -s option.

    To install the ParaStation MPI daemon as a system service, started up at boot time, use

      # chk_config -a /etc/init.d/parastation

    This step must be repeated for each node.

  7. Testing

    A brief test of the entire communication and management system can be accomplished by using the test_nodes(1) command. For a detailed description please refer to the section called “Testing the installation”.