Cluster software

Cloning of nodes

The NIFLHEIM cluster uses the SystemImager toolkit on a central server to create an image of a Golden Client node that has been installed in the usual way using a distribution on CD-ROM (Centos Linux in our case). The SystemImager is subsequently used to install identical images of the Golden Client on all of the nodes (changing of course hostname and network parameters).

NetCDF (network Common data Form)

NetCDF (network Common Data Form) is an interface for array-oriented data access and a library that provides an implementation of the interface. The NetCDF library also defines a machine-independent format for representing scientific data.

NetCDF is installed on the cluster via the rpm netcdf-3.6.1-1.2.el4.fys. This build includes bindings to the PathScale fortran compiler. A locally developed spec file for the NetCDF rpm is in:


OpenMPI (A High Performance Message Passing Library)

OpenMPI is an open source implementation of the MPI message passing standard.

The OpenMPI version now installed is 1.1.1 and is built with support for:

* Torque task-manager (TM) interface (installation in /usr/local)
* gcc C compiler
* Pathscale EKOpath Fortran compiler (Opteron) or PGI compiler (Intel Pentium-4).

Building OpenMPI RPM

The version on the cluster is installed using the RPM package openmpi-1.1.1-2, which is built using the script. Download this script to the working directory and customize it for our environment:

  • Pathscale EKOpath compiler (AMD Opteron):

    configure_options="--with-tm=/usr/local FC=pathf90 F77=pathf90"
  • PGI compiler (Intel Pentium-4):

    configure_options="--with-tm=/usr/local FC=pgf90 F77=pgf90 CC=pgcc CXX=pgCC"

Change the build parameters to build one single RPM including man pages (The build of multiple RPMs did not seem to work in version 1.1.1):

build_multiple=no needs the RPM .spec file which can be copied from the unpacked openmpi tar-file:

cp openmpi-1.1.1/contrib/dist/linux/openmpi.spec .

Now run:

cd /home/camp/rpmbuild/SOURCES/
./ openmpi-1.1.1.tar.gz

Processor affinity

For some parallel libraries like BLACS and ScaLAPACK which are using OpenMPI as the communication layer, setting processor affinity seems to be important. Processor affinity is when a process is fixed on a specific processor, see more details in this OpenMPI FAQ.

To enable processor affinity use:

mpirun --mca mpi_paffinity_alone 1 -np 4 a.out

Without this option all copies of the parallel program (siesta) would land on one CPU.


Making RPM for the dacapo/Python interface

Start by checking the latest version out from CVS:

cvs co dacapo/Python
cd dacapo/Python

Update the file with the correct version and release numbers (Lars: how do we know these ??) like this:

setup(name = 'Dacapo',

Now build a tar-file using:

python sdist

The tar-file will be in dist/Dacapo-<version>.tar.gz, copy this file to the rpmbuild directory /home/camp/rpmbuild/SOURCES, and build the RPM package using:

rpmbuild -bb campos-dacapo-python.spec

The architecture independent RPM campos-dacapo-python is placed in /home/camp/rpmbuild/RPMS.

Building RPM for Opteron nodes

An RPM package containing only the binary executables /usr/local/bin/dacapo... is built.

Follow the steps for compiling dacapo on opteron nodes, end after building the binary executables:

cd dacapo-<version>/src
make pathscale
make pathscale MP=mpi

Now make a tar file of the directory dacapo-<version> (<version> may be 2.7.7 or later). Create a tar-ball in the RPM SOURCES directory:

cd ../..
tar zcf /home/camp/rpmbuild/SOURCES/campos-dacapo-<version>-opteron.tar.gz dacapo-<version>

Use the spec file in /home/camp/rpmbuild/SPECS/campos-dacapo-opteron.spec, and remember to update version and release numbers in the spec file (Lars: How do we know the version number ??). Now build the RPM package by:

rpmbuild -bb campos-dacapo-opteron.spec

Making RPM for the P4 nodes

The spec file /home/camp/rpmbuild/SPEC/campos-dacapo-pgi.spec will build the i386 version of dacapo on svol, current version is 2.7.8. Follow the steps for compiling dacapo on svol, end with:

gmake pglinux MP=mpi
gmake pglinux

in the directory dacapo/src. Now make a tarfile using:

cd ../..
tar -zcf dacapo_<version>.tar.gz dacapo/src

Copy this file to /home/camp/rpmbuild/SOURCES/ and build the rpm using:

rpmbuild -bb /home/camp/rpmbuild/SPECS/campos-dacapo-pgi.spec

Make sure that the version number and release number are correct in the spec file.


The SIESTA setup at niflheim consists of the following rpms:

  • siesta-2.0-3.2.el4.fys

    spec file /home/camp/rpmbuild/SPECS/siesta2.spec. This will build the serial version of siesta2.

  • siesta2-openmpi-2.0-1.2.el4.fys

    spec file /home/camp/rpmbuild/SPECS/siesta2-openmpi.spec This will build the parallel siesta version2.

  • campos-siesta-pseudopotentials-1-1.2.el4.fys

    /home/camp/rpmbuild/specs/campos-siesta-pseudopotentials.spec, spec file on local disktops. This will build the small local fys pseudopotential database, mainly for initial tryout of SIESTA.

Building serial SIESTA

The serial SIESTA is build using the ACML library, using the spec file siesta2.spec. The build part looks like:

cd Src
FC="pathf90" FCFLAGS="-O2 -OPT:Olimit=0" \
LDFLAGS="/opt/pathscale//lib/2.4/libpathfortran.a" \
%configure --with-lapack=/opt/acml3.5.0//pathscale64/lib/libacml.a --build='x86_64' --with-blas=/opt/acml3.5.0//pathscale64/lib/libacml.a

Building parallel SIESTA

The parallel version of SIESTA requires BLACS (Basic Linear Algebra Communication Subprograms) and ScalaPack, plus a MPI message passing library. Here we build SIESTA with OpenMPI. See also the niflheim note on OpenMPI.

BLACS (Basic Linear Algebra Communication Subprograms)

Since BLACS is not included in ACML (it is included in MKL), we build it from source. The following BLACS tar files are used:

* mpiblacs.tgz
    MPI version of the BLACS.
    UPDATED:  May 5, 1997 (Version 1.1)

* mpiblacs-patch03.tgz
    MPIBLACS patch!! Details in old_errata.blacs file.
    To install: gunzip -c mpiblacs-patch03.tgz | tar xvf -
    Date: February 24, 2000

* blactester.tgz

These files are installed in /home/camp/rpmbuild/blacs/BLACS.

BLACS is build ontop of a MPI library, here we use the OpenMPI library. The configuration file in BLACS/, is edited following the OpenMPI BLACS FAQ. For more details see this FAQ and the file.

Setting Processor infinity also seems important, then running a program based on BLACS.


The tar file scalapack-1.7.4.tgz from ScaLAPACK is used and installed in /home/camp/rpmbuild/scalapack/scalapack-1.7.4.

The configuration file scalapack-1.7.4/ is edited following the OpenMPI ScaLAPACK FAQ For more details see this FAQ and the file.

Building the parallel siesta

Finally the parallel siesta2 is build using the spec file siesta2-openmpi.spec. The tar file for siesta2 is in /home/camp/rpmbuild/SOURCES/siesta-2.0.tgz. The configuration file for this build is in /home/camp/rpmbuild/SOURCES/arch.make.

Siesta building problems

From Magnus Paulsson <> we have received the following advice about building SIESTA:

These atom.f module should be compiled with zero optimization (-O0).

The dhscf.F module should be compiled with -O2.

The vmat.f, vmatsp.f, rhoofd.f, cellxc.F modules should be optimized with -O3.

In MPI/mpi.F remove the #ifdef OLD_CRAY part.

You can specify the optimizations in the Makefile:

      $(FC) -c -m64 -O0 atom.f
      $(FC) -c -m64 -O2 $(INCFLAGS) $(FPPFLAGS) $(FCFLAGS_fixed_f) dhscf.F
      $(FC) -c -m64 -O3 $(INCFLAGS) $(FCFLAGS_fixed_f) vmat.f
      $(FC) -c -m64 -O3 $(INCFLAGS) $(FCFLAGS_fixed_f) vmatsp.f
      $(FC) -c -m64 -O3 $(INCFLAGS) $(FCFLAGS_fixed_f) rhoofd.f
      $(FC) -c -m64 -O3 $(INCFLAGS) $(FPPFLAGS) $(FPPFLAGS_fixed_F) cellxc.F