Installation on Unix Systems

The NetSolve distribution tar file is available from the NetSolve homepage.http://icl.cs.utk.edu/netsolve/software/ Once the file has been downloaded, the following UNIX commands will create the NetSolve-2.0 directory:

gunzip -c NetSolve-2.0.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

Optional Features:
  --disable-FEATURE            do not include FEATURE (same as --enable-FEATURE=no)
  --enable-FEATURE[=ARG]       include FEATURE [ARG=yes]
  --disable-debug              exclude debugging info when compiling
                                - (no effect when --with-cnoptflags and --with-coptflags are used
  --enable-port-restriction    server uses only ports 9001 thru 9204
  --enable-infoserver=alone    use InfoServer alone
NetSolve Compile Options:
  --with-cc                    determine which C compiler to use
  --with-cnooptflags           set compiler flags that don't deal with optimization
                                - (ONLY USE IN COMBINATION WITH --with-cc)
                                - CFLAGS will be set to C_OPT_FLAGS+C_NOOPT_FLAGS
  --with-coptflags             set compiler optimization flags
                                - (ONLY USE IN COMBINATION WITH --with-cc)
                                - CFLAGS will be set to C_OPT_FLAGS+C_NOOPT_FLAGS
  --with-fc                    determine which Fortran compiler to use
  --with-fnooptflags           set compiler flags that don't deal with optimization
                                - (ONLY USE IN COMBINATION WITH --with-fc)
                                - FFLAGS will be set to F_OPT_FLAGS+F_NOOPT_FLAGS
  --with-foptflags             set compiler optimization flags
                                - (ONLY USE IN COMBINATION WITH --with-fc)
                                - FFLAGS will be set to F_OPT_FLAGS+F_NOOPT_FLAGS
  --with-ldflags               set loader flags
NetSolve Run Time Options:
  --with-nws=NWSDIR            location of NWS installation dir
  --with-ibp=IBPDIR            location of IBP installation dir
  --with-kerberos=KRBDIR       use Kerberos5 client authentication
  --with-proxy                 which Proxy? (netsolve, globus)
  --with-outputlevel           output level (debug,view,none)
NetSolve Service Options:
  --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-ma28                           if ma28 is to be included in the NetSolve services
  --with-itpack                         if itpack is to be included in the NetSolve services
  --with-arpacklib=ARPACK_LIB           Arpack 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-blaslib=BLAS_LIB               BLAS link line
  --with-blacslib=BLACS_LIB             BLACS link line
  --with-mldk=MLDK_PATH                 Path to MathLink Development Kit
  --with-rpclib=RPC_LIB                 Full path of RPC library
  --with-octave-include=OCTAVE_INC_DIR  location of Octave include directory
  --with-rpcinc=RPC_INC                 Directory containing RPC header files
  --with-gpg=GPGPATH                    Full path of gpg binary
  --with-buildgpg=BUILDGPG              Location of gpg tar.gz file

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 is 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, if the user prefers to edit this file, 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 client compilation includes:
UNIX> make C Fortran tools tester
to build the C and Fortran client interfaces, NetSolve management tools (see Chapter 16), and NetSolve test suite (see the Section called Testing the Software in Chapter 13). To build the Matlab client interface to NetSolve, type
UNIX> make matlab
and to build the Mathematica client interface to NetSolve, type
UNIX> make mathematica
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.

NoteNote
 

It is recommended that you set the environment variables NETSOLVE_ROOT and NETSOLVE_ARCH prior to running configure.