Installation on Unix Systems using configure

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

A summary of NetSolve specific parameters are below.

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

	Note
	It is recommended that you set the environment variables NETSOLVE_ROOT and NETSOLVE_ARCH prior to running configure. If you wish to compile the Matlab interface to NetSolve, you must select a compiler flag setting for NetSolve that matches that used by Matlab. If you have the IRIX64 version of Matlab, you will need to overwrite NetSolve's flags to select the -64 during the configure step.

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.