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.

Get the installation packages

Get the necessary installation packages from the download section of the ParaStation MPI homepage www.parastation.com. 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.

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 \
  psmpi-doc.5.0.0-0.noarch.rpm

Install software on the compute nodes

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

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.

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.

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”.