Installation on Unix Systems

The NetSolve distribution tar file is available from the NetSolve homepage. Once the file has been downloaded, the following UNIX commands will create the NetSolve directory:

gunzip -c NetSolve-1.4.tgz | tar xvf -

From this point forward, we assume that the UNIX SHELL is from the csh family.

The installation of NetSolve is configured for a given architecture using the GNU tool configure.

UNIX> cd NetSolve UNIX> ./configure

For a list of all options that can be specified to configure, type

UNIX> ./configure --help

Usage: configure [--with-cc=C_COMPILER] [--with-cnooptflags=C_NOOPT_FLAGS] [--with-coptflags=C_OPT_FLAGS] [--with-fc=F77_COMPILER] [--with-fnooptflags=F77_NOOPT_FLAGS] [--with-foptflags=F77_OPT_FLAGS] [--with-ldflags=LOADER_FLAGS] [--with-nws=NWSDIR] [--with-ibp=IBPDIR] [--with-kerberos] [--with-proxy=PROXY_TYPE] [--with-outputlevel=OUTPUT_LEVEL] [--enable-infoserver=INFOSERVER] [--with-mpi=MPI_DIR] [--with-petsc=PETSCDIR] [--with-aztec=AZTEC_DIR] [--with-azteclib=AZTEC_LIB] [--with-superlu=SUPERLU_DIR] [--with-superlulib=SUPERLU_LIB] [--with-scalapacklib=SCALAPACK_LIB] [--with-blacslib=BLACS_LIB] [--with-lapacklib=LAPACK_LIB] [--with-blaslib=BLAS_LIB] [--with-mldk=MLDK_PATH] where C_COMPILER = default is to use gcc C_NOOPT_FLAGS = C compiler flags to be used on files that must be compiled without optimization C_OPT_FLAGS = C compiler optimization flags (e.g., -O) F77_COMPILER = default is to use g77 F77_NOOPT_FLAGS = Fortran77 compiler flags to be used on files that must be compiled without optimization F77_OPT_FLAGS = Fortran77 compiler optimization flags (e.g., -O) LOADER_FLAGS = Flags to be passed only to the loader NWSDIR = directory where NWS is installed (optional) IBPDIR = directory where IBP is installed (optional) PROXY_TYPE = currently supported values are netsolve and globus (default is netsolve) OUTPUT_LEVEL = currently supported values are debug, view, and none (default is view) INFOSERVER = currently supported values are alone and nothing specified (default is not alone, where nothing is specified). MPI_DIR = location of the MPI directory (optional, assumes MPICH directory structure) (default is /usr/local/mpich-1.2.1). PETSCDIR = location of PETSc installation directory (optional) AZTEC_DIR = location of Aztec installation directory (optional) AZTEC_LIB = Aztec link line (optional) SUPERLU_DIR = location of SuperLU installation directory (optional) SUPERLU_LIB = SuperLU link line (optional) SCALAPACK_LIB = ScaLAPACK link line (optional) BLACS_LIB = MPIBLACS link line (optional) LAPACK_LIB = LAPACK link line (optional) BLAS_LIB = BLAS link line (optional) MLDK_PATH = Path to MathLink Development Kit (optional)

All arguments are optional. The options particularly pertinent to NetSolve are:

--with-nws=NWSDIR location of NWS installation dir --with-ibp=IBPDIR location of IBP installation dir --with-kerberos use Kerberos5 client authentication --with-proxy which Proxy? (netsolve, globus) --with-outputlevel output level (debug,view,none) --enable-infoserver[=alone] use InfoServer [alone]

The NetSolve service options are:

--with-petsc=PETSCDIR location of PETSc installation dir --with-petsclibdir=PETSC_LIB_DIR location of PETSc library --with-aztec=AZTEC_DIR location of Aztec installation dir --with-azteclib=AZTEC_LIB Aztec link line --with-superlu=SUPERLU_DIR location of SuperLU installation dir --with-superlulib=SUPERLU_LIB SuperLU link line --with-mpi=MPI_DIR location of MPI Root Directory --with-lapacklib=LAPACK_LIB LAPACK link line --with-scalapacklib=SCALAPACK_LIB ScaLAPACK link line --with-blacslib=BLACS_LIB MPIBLACS link line --with-blaslib=BLAS_LIB BLAS link line --with-mldk=MLDK_PATH Path to MathLink Development Kit

The configure script creates two main files, ./conf/Makefile.$NETSOLVE_ARCH.inc and ./conf/Makefile.inc. These files are created from the templates ./conf/Makefile.generic-arch and ./conf/Makefile.inc.in respectively. $NETSOLVE_ARCH is the string printed by the command ./conf/config.guess, with all '-' and '.' characters converted to '_' characters. The variable $NETSOLVE_ROOT is the complete path name to the installed NetSolve directory and defined in ./conf/Makefile.inc. These *.inc files are included by the Makefiles that build the NetSolve system. Manually editing these configuration files is strongly discouraged. However, details of the $NETSOLVE_ROOT/conf/Makefile.$NETSOLVE_ARCH.inc file are explained in the section called Details of the Makefile.NETSOLVE_ARCH.inc File in Chapter 12.

Typing make in the NetSolve directory will give instructions to complete the compilation. A typical agent and server compilation includes:

UNIX> make standard

to build the agent, server, NetSolve management tools (see Chapter 16), and NetSolve test suite (see the section called Testing the Software). After a successful compilation process, the appropriate binaries and/or libraries can be found in the $NETSOLVE_ROOT/bin/$NETSOLVE_ARCH and/or $NETSOLVE_ROOT/lib/$NETSOLVE_ARCH directories respectively. Thus, to execute a NetSolve binary, the user must either execute the command from within the $NETSOLVE_ROOT/bin/$NETSOLVE_ARCH directory, or add this directory name to his UNIX path variable.