mod_dav INSTALLATION INSTRUCTIONS
---------------------------------

There are two general mechanisms for installing mod_dav into your
Apache installation. The first is with the "apxs" tool, and the second
is to build mod_dav within the Apache tree itself.

-----
Step 1: EXPAT INSTALLATION

In all cases of installation, you will first need James Clark's Expat
parser. It is available from:

   http://www.jclark.com/xml/

Note that the expat Makefile does not automatically build the expat
library.  Add this rule to the Makefile:

libexpat.a: $(OBJS)
    ar -rc $@ $(OBJS)
    ranlib $@

(don't forget to use TABS before the ar and ranlib lines there)

Then type: make libexpat.a

And copy libexpat.a to /usr/local/lib and xmlparse/xmlparse.h to
/usr/local/include.  If you wish to use a different directory you need to
make sure it is on your link path, or edit the libdav.module file and
specify the correct location.

Once Expat is installed, then you can proceed with the mod_dav
installation.

-----
Step 2: COPY FILES

For apxs installation, the files may reside in any convenient
directory. After copying the files, you will need to edit
Makefile.apxs to point APXS to the apxs utility in your Apache
install.

If you will be building within the Apache 1.3.x source tree, then copy
the mod_dav files to src/modules/dav in tree.


-----
Step 3: INSTALL

--
APXS:

For apxs installation, simply issue the following command line:

   make -f Makefile.apxs install

That should compile the module and install it properly. If it does not
get installed properly, then you can add the following two lines to
your httpd.conf file:

   LoadModule dav_module      /pathname/goes/here/libdav.so
   AddModule mod_dav.c

Note: if your Apache installation does not support loadable modules,
then apxs will complain and terminate. For apxs to work, you will need
to rebuild Apache with the loadable module support (if available on your
platform).

--
APACHE REBUILD:

When including mod_dav as part of Apache itself, there are two ways to
"activate" the module:

1. Edit src/Configuration and at the end of the file add the line:

   AddModule modules/dav/libdav.a

*OR*

2. In your top-level Apache dir type:

   ./configure --activate-module=src/modules/dav/libdav.a

Once this is done, then build and install Apache normally.

-----

For comments, questions, and other issues, please email me at
gstein@lyra.org.


Greg Stein, http://www.lyra.org/
November 1998
