Installation

The prerequisites needed to build AcouSTO are:

• the complete GNU configure and build system;
• a working MPI-2 implementation, both libraries and compilers (OpenMPI strongly suggested);
• libconfig (http://www.hyperrealm.com/libconfig/);
• LAPACK and BLAS libraries (http://www.netlib.org);
• ScaLAPACK and BLACS libraries (http://www.netlib.org).

AcouSTO can save the results of the different runs on a MySQL Database. If you want to build AcouSTO to support this feature you must also have libmysqlclient (version >=5.0) and you must enable the MySQL function compilation with the option listed below.
The installation procedure is quite straightforward.
The configure script accepts the following non-standard options:

• --with-mpicc=<mpicc compiler>               location of mpicc compiler

• --with-libconfig=<config lib dir>           location of libconfig lib

• --with-libmysqlclient=<mysqlclient lib dir> location of MySQL client lib

• --with-scalapack-and-blacs=<dir>            location of Scalapack and BLACS libs 

• --with-lapack=<dir>                         location of Lapack libs (if not in search path)

• --enable-mysql=<yes|no>                     if 'yes' enables the MySQL save feature. Default is 'no'

Unfortunately the configure script at this stage cannot determine the right name of the netlib libraries, thus you must follow the following naming convention:

• liblapack.a
• libscalapack.a
• libblacsCinit_MPI.a
• libblacs_MPI.a

libraries with different names will NOT be recognized by the configure script so you must either rename the existing files or make symbolic links with the names expected by AcouSTO.


Users of libconfig version >= 1.3.2 must define the flag HAVE_LIBCONFIG_1_3_2 issuing the command

• "export CFLAGS=-DHAVE_LIBCONFIG_1_3_2" (for bash shell)
• "setenv CFLAGS -DHAVE_LIBCONFIG_1_3_2" (for csh or tcsh)

Example:
The netlib libraries are in the /usr/local/lib/netlib dir; in order to install acousto you can type the following commands:
This will compile and install the AcouSTO executable in the /usr/local/bin dir.