
$Id: INSTALL,v 1.9 2005/05/13 20:55:16 jimg Exp $

Updated for version 3.5.0 beta of the DAP netCDF Client Library.

Installing the NetCDF client library for DAP2

---------------------------------------------------------------------------

BUILDING THE SOFTWARE
REQUIREMENTS
NOTES

---------------------------------------------------------------------------

BUILDING THE SOFTWARE

0) Please skim REQUIREMENTS and NOTES sections of this file
   before reporting problems. Thanks.

1) Type `./configure' at the system prompt. On some systems you may have to
   type `sh configure.'

2) Type `make' to build the library and dncdump (a DAP2-enabled version of
   ncdump). 

3) Type 'make install to install the library. The library installs in
   /usr/local/lib by default; to change this use the --prefix option of
   configure to specify a prefix directory different than /usr/local (e.g.,
   to use /opt/opendap run configure as ./configure --prefix=/opt/opendap).
   The library's header file install in $prefix/include/dap and the
   DAP-enabled ncdump installs in $prefix/bin.

4) Optionally run the tests. You will CppUnit installed to run the tests in the
   top level directory; you'll need DejaGNU installed to run the tests in
   ncdump. To run the tests use `make check.' If you only want to run the
   regressin tests supplied by Unidata, first cd to nc_test and run those
   using 'make check.' The tests are run twice, once for local access and
   once for remote access. The latter can take several hours to complete.

   You can change the location of the remote server used by the regression
   tests in nc_test; see configure --help for information about
   --with-data-url. 

REQUIREMENTS

  o You need to have the DAP library version 3.5.0 or greater, libcurl, and
    libxml2. If you have installed libdap you should be all set.

NOTES

  o If the build fails because make reports that it does not know how to make
    a particular file, try runing `make depend' to rebuild the Makefile's
    dependencies.

  o If the build fails because the FORTRAN jackets cannot be built, try
    setting the environment variables FC and FCFLAGS. FC should give the name
    of a FORTRAN compiler and FCFLAGS should hold any options that need to be
    passed to the compiler.

  o DEBUGGING AIDS

    - The OPeNDAP libdap++ includes the following debugging aids that may be
      of help to you in developing new DODS applications.

    - DBG: simple program instrumentation -- see the file debug.h in
      $DODS_ROOT/include for more information

    - DBG2: more elaborate program instrumentation -- by convention this is
      used for output that is half a page or more, while DEBUG is used for
      single line output.

    - To build with program instrumentation use `--enable-debug=<level>'
      where <level> is 1 or 2.

