SDPARA-C installation manual

[Copyright (C) 2004 SDPA Project]

  This file explains how to install the SDPARA-C.
  If you have any trouble about the installation,
send us an e-mail
(kojima-sdpa+is.titech.ac.jp replaced '+' by '@').

  In this manual we assume two main points.

  1. You have already installed the SDPA-C 6.2.0 in
$HOME/sdpa/ with ATLAS, LAPACK, SPOOLES and METIS
in $HOME/lapack/.
  2. You have a knowledge of how to compile and 
use the MPICH program and MPICH is installed in
/usr/local/mpich/.

  In this manual, we also assume that your operating 
system is "Linux" such as "Fedora Core". The SDPARA-C
can work on other Unix operating systems as well.
  The line whose starts with the character '$' 
indicates a command you should execute.
  We have tested the installation on the "Fedora Core 1"
with "mpich-1.2.6" configured by the following command.

$ ./configure --prefix=/usr/local/mpich \
   --with-device=ch_p4 --with-arch=LINUX \
   --with-romio -opt = -O4


-- index --------------------------------
1. Install SDPA-C
2. Install BLACS
3. Install ScaLAPACK
4. Copy header and library files
5. Install SDPARA-C
-----------------------------------------




*******************************************************
1. Install SDPA-C

  See the SDPA web site.
    http://grid.r.dendai.ac.jp/sdpa/

  Follow the installation manual of the SDPA-C to install ATLAS
and CLAPACK as we assumed.

*******************************************************
2. Install BLACS

$ cd $HOME/lapack
$ wget http://www.netlib.org/blacs/mpiblacs.tgz
  This command downloads the file mpiblacs.tgz
  into this directory.
$ tar xzvf mpiblacs.tgz
$ cd $HOME/lapack/BLACS
$ cp BMAKES/Bmake.MPI-LINUX Bmake.inc

  Edit Bmake.inc
   line  16 :: BTOPdir = $(HOME)/lapack/BLACS
   line  51 :: MPIdir = /usr/local/mpich
   line  52 :: MPIdev = ch_p4
   line  53 :: MPIplat = LINUX
   line  54 :: MPILIBdir = $(MPIdir)/lib
   line  55 :: MPIINCdir = $(MPIdir)/include
   line  56 :: MPILIB = $(MPILIBdir)/libmpich.a
   line 201 :: F77NO_OPTFLAGS = -w -fugly-complex -fno-globals

$ make mpi
$ make mpi what=clean


*******************************************************
3. Install ScaLAPACK

$ cd $HOME/lapack
$ wget http://www.netlib.org/scalapack/scalapack.tgz
  This command downloads the file scalapack.tgz
  into this directory.
$ tar xzvf scalapack.tgz
$ cd $HOME/lapack/SCALAPACK

  Edit SLmake.inc
   line 22 :: home          = $(HOME)/lapack/SCALAPACK
   line 32 :: BLACSdir      = $(HOME)/lapack/BLACS/LIB
   line 38 :: SMPLIB        = /usr/local/mpich/lib/libmpich.a
   line 39 :: BLACSFINIT    = $(BLACSdir)/blacsF77init_MPI-LINUX-0.a
   line 40 :: BLACSCINIT    = $(BLACSdir)/blacsCinit_MPI-LINUX-0.a
   line 41 :: BLACSLIB      = $(BLACSdir)/blacs_MPI-LINUX-0.a
   line 97 :: BLASLIB       = $(HOME)/lapack/lib/libf77blas.a $(HOME)/lapack/lib/libatlas.a

$ make
$ make clean

*******************************************************
4. Copy header and library files

$ cd $HOME/lapack
$ cp SCALAPACK/libscalapack.a lib/libscalapack.a
$ cp BLACS/LIB/blacs_MPI-LINUX-0.a lib/libblacs.a
$ cp BLACS/LIB/blacsF77init_MPI-LINUX-0.a lib/libblacsf77.a
$ cp BLACS/LIB/blacsCinit_MPI-LINUX-0.a lib/libblacsc.a
$ cp SCALAPACK/PBLAS/SRC/*.h include/

$ cd $HOME/lapack/include

   Edit PBtools.h
    line 1151 :: /* comment out prototype of csymv_,zsymv_,csyr_,zsyr_ to avoid conflict with clapack.h
    line 1165 :: */


*******************************************************
5. Install SDPARA

$ cd $HOME
  Download sdpara-c.1.0.0.src.tar.gz into this directory.

$ tar xzvf sdpara-c.1.0.0.src.tar.gz
$ cd sdpara

  Edit Makefile
   line  21  :: LAPACK = $(HOME)/lapack
   line  35  :: RSDPA_LIB_NAME = sdpara-c
   line  39  :: MPIBIN = /usr/local/mpich/bin/
   line  40  :: CC = $(MPIBIN)mpicxx

   If mpich compile wrapper of g++ is 'mpiCC', then
   line  40  :: CC = $(MPIBIN)mpiCC

$ make clean
$ make

Please examine the following command to check whether
the installation has been done successfully.

$ mpirun -np 4 ./sdpara-c example1.dat-s first.result

We suggest also that you check for larger SDP problems
such as 'control8.dat-s' from SDPLIB because 'example1.dat-s'
may be too small to verify that the processes are running.