2.5 Source distribution only: unpack, configure and compile the source
The downloaded sources should be unpacked first (i.e. before unpacking binaries), for example, as follows:
gzip -cd adf2008.01.src.tgz | tar xf -
The result will be a new adf2008.01 directory containing the sources.
Next, unpack the binary distribution. This installs a couple of programs in the $ADFBIN directory that are not included in the source distribution.
gzip -cd adf2008.01.bin.tgz | tar xf -
After unpacking everything and setting up your environment properly (see previous section), you should run the configure script. This script is located in the $ADFHOME/Install directory, and it must be executed from the $ADFHOME directory. The script replaces some files in the bin directory with versions specifically targeted for your system. For example, if you want to install an OpenMPI version of ADF on a platform for which only an HP-MPI version is available, then configure will make an $ADFBIN/start script suitable for OpenMPI and overwrite the old one which was made for HP-MPI. Further, configure creates the Makeflags and settings files that you will need to compile ADF.
Example:
cd $ADFHOME Install/configure -p hpmpi
The configure script accepts the following options:
-h with this option configure will print the system name, processor type and, for Linux, the GLIBC version. It will also print the default machine name used internally by ADF and a list of known parallel implementations for this combination, as well as a list of possible optional parameters, if any (see below).
-p par specifies the parallel implementation to use. The list of possible par values varies per platform and can be obtained by running configure with the -h option. The default is "serial".
-n ncpus specifies the maximum number of processes on which you can later run ADF and other parallel programs from the package. The default value of 128 is sufficient in most cases.
-o option specifies an optional parameter if available. For example, on IBM AiX you can specify -o 64 to configure a version with 64-bit addressing.
Next, you can compile and link the ADF sources by executing the yam (Yet Another Make) script created in the $ADFBIN directory by configure.
cd $ADFHOME bin/yam
After a while, depending on the speed of your computer, ADF should be ready to use, just as if you had installed the precompiled executables.
