$Id$

                 --- Xindice address book example ---


This code is an example application using Xindice and the XML:DB api with
jsp and servlets to provide an online address book.

   This README assumes that you have JDK 1.4 and Tomcat 4 already installed.
   

1. Make sure your current working directory is the parent directory of directory
   where this README file resides. If not, type:
   
   (on UNIX)
   cd $XINDICE_HOME/java/examples
   
   (on Windows)
   cd %XINDICE_HOME%\java\examples

2. Build the addressbook.war. The WAR file is built by the ant script:
   
   (on UNIX)
   $XINDICE_HOME/tools/bin/ant
   
   (on Windows)
   %XINDICE_HOME%\tools\bin\ant
   
4. You should find the file addressbook.war in the $XINDICE_HOME/build directory.
   This file should be copied into the webapps directory of your tomcat installation.

5. Place a copy of xerces, xalan, and xml-api JAR files (from $XINDICE_HOME/java/lib)
   in Tomcat's common/endorsed lib directory, removing old versions of these files
   (This is not necessary with the recent Tomcat releases, but might be necessary
   if Tomcat's versions of the jars are much older).

   Example...

     rm $TOMCAT_HOME/common/endorsed/xercesImpl-*.jar
     cp $XINDICE_HOME/java/lib/xerces-2.6.0.jar $TOMCAT_HOME/common/endorsed/xercesImpl-2.6.0.jar
      
6. Make sure Xindice is running, follow the INSTALL instructions to start it if
   it isn't.
      
7. Start Tomcat
      
   (on UNIX)
   $TOMCAT_HOME/bin/startup.sh
   
   (on Windows)
   %TOMCAT_HOME%\bin\startup.bat

8. Finished - You should now be able to load the addressbook.

   http://localhost:8080/addressbook


If you have problems please post you questions on the Xindice users
mailing list.