vgritsenko 2003/12/12 16:16:50
Modified: java/examples/addressbook README
Log:
Update addressbook readme
Revision Changes Path
1.2 +21 -38 xml-xindice/java/examples/addressbook/README
Index: README
===================================================================
RCS file: /home/cvs/xml-xindice/java/examples/addressbook/README,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- README 12 Dec 2003 23:33:44 -0000 1.1
+++ README 13 Dec 2003 00:16:50 -0000 1.2
@@ -5,60 +5,43 @@
This code is an example application using Xindice and the XML:DB api with
jsp and servlets to provide an online address book.
-Tomcat 3.2
-
-If at all possible you should use Tomcat 4 as installation is much simpler,
but
-Tomcat 3.2 will work as well with a little extra effort.
+ This README assumes that you have JDK 1.4 and Tomcat 4 already installed.
+
-1. Make sure your current working directory is the directory where this
README
- file resides. If not, type.
+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/addressbook
+ cd $XINDICE_HOME/java/examples
(on Windows)
- cd %XINDICE_HOME%\java\examples\addressbook
+ cd %XINDICE_HOME%\java\examples
-2. Add the servlet.jar file from Tomcat to your classpath.
-
- CLASSPATH=path_to_your_tomcat_install/lib/servlet.jar
- export CLASSPATH
-
-3. Build the addressbook.war. The war is built by the ant script
+2. Build the addressbook.war. The WAR file is built by the ant script:
(on UNIX)
- $XINDICE_HOME/bin/ant
+ $XINDICE_HOME/tools/bin/ant
(on Windows)
- %XINDICE_HOME%\bin\ant
+ %XINDICE_HOME%\tools\bin\ant
-4. You should find the file addressbook.war in the current directory. This
file
- should be copied into the webapps directory of your tomcat installation.
+4. You should find the file addressbook.war in the $XINDICE_HOME/dist
directory.
+ This file should be copied into the webapps directory of your tomcat
installation.
-5. Place a copy of xerces.jar (From $XINDICE_HOME/java/lib) in Tomcat's lib
- directory, renaming the file to ensure that it will be first in the
- classpath. (Yes this is a kludge, but necessary since Tomcat is using it's
- own XML parser that is incompatible with Xindice) If the version of
xerces you
- find in your Xindice distribution is different just use it and change the
- numbers accordingly.
+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...
- cp $XINDICE_HOME/java/lib/xerces-1.3.0.jar
$TOMCAT_HOME/lib/1xerces-1.3.0.jar
+ 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. Copy the following jar files to your Tomcat lib directory. The same
directory
- where you just copied Xerces.
-
- From $XINDICE_HOME/java/lib. Again adjust the versions if necessary
-
- xindice.jar
- xmldb.jar
- xalan-2.2.D11.jar
-
-7. Make sure Xindice is running, follow the INSTALL instructions to start it
if
+6. Make sure Xindice is running, follow the INSTALL instructions to start it
if
it isn't.
-8. Start Tomcat
+7. Start Tomcat
(on UNIX)
$TOMCAT_HOME/bin/startup.sh
@@ -66,8 +49,8 @@
(on Windows)
%TOMCAT_HOME%\bin\startup.bat
-9. Finished - You should now be able to load the addressbook.
- http://localhost:8888/addressbook
+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.