
$Id: INSTALL 11990 2005-08-19 23:38:57Z jimg $

Updated for version 3.5.2 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.' If you installed libdap++ in a directory that's not 
   on your PATH, make sure to add <<libdap++ prefix>>/bin to PATH.

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 files are installed in $prefix/include/libnc-dap and
   the DAP-enabled ncdump installs in $prefix/bin.

4) Optionally run the tests. You will need CppUnit installed to run the tests
   in the unit-tests directory; you'll need DejaGNU installed to run the
   tests in ncdump. To run the dejagnu tests, use `make check.' If you want
   to run the unit tests, first cd to unit-tests and run 'make check.' If you
   only want to run the regression 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.2 or greater, libcurl, and
    libxml2. If you have installed libdap you should be all set.

  o To build from a fresh SVN checkout, you'll need automake 1.9.2, autoconf
    2.59 (2.57 will probably work and that's what's listed in the configure.ac
    file) and libtool 1.5.6. Earlier versions may work, but may cause
    problems, particularly with the 'distcheck' target for make. Given those
    requirements, use 'autoreconf --force --verbose' and then build as
    described above.

NOTES

  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.

