Installing and Configuring Xindice


The latest Xindice builds can be found via http://xml.apache.org/xindice/download.html. Two builds are available: a xml-xindice-*.zip file for Windows and an xml-xindice-*.tar.gz file for UNIX, Linux, and Mac OS X. You only need a single distribution file; there are no separate source and binary distributions.

For the sake of example, we’ll assume you’re unpacking the Xindice 1.0 distribution. Once you unpack the distribution (by unzipping on Windows or by using gzip and tar on the other platforms), you’ll have a directory called xml-xindice-1.0, either in the current directory or in the directory you specified to your archiving utility. The contents of that directory look like this:

  • bin—Windows batch files and UNIX shell scripts for the Xindice command-line programs. Also contains similar files for running Ant (to build Xindice).

  • config—Various Xindice configuration files.

  • db—Xindice database files (stored here by default).

  • docs—HTML documentation for Xindice.

  • icons—Icons used by Xindice.

  • idl—The CORBA IDL description of the XML:DB API.

  • java—Java-related files:

    • examples—Source code for the Xindice examples.

    • lib—Prebuilt jar files needed by Xindice.

    • src—Java source code for Xindice.

    • tests—JUnit unit tests for Xindice.

  • logs—Server log files.

When you’re writing Xindice applications, you need to place the Xindice jar files in your classpath. You need the following jars: openorb-1.2.0.jar, openorb_tools-1.2.0.jar, xindice.jar, xmldb.jar, xmldb-sdk.jar, and xmldb-xupdate.jar. You also need the Xerces and Xalan jars provided in the Xindice java/lib directory. This last requirement can cause you some headaches on JDK 1.4 because JDK 1.4 provides its own XML parser and a different version of Xalan, all via the Java Endorsed Standards mechanism. You need to use the Java Endorsed Standards Override Mechanism (see Chapter 1, "Xerces" or Chapter 2, "Xalan") to override the versions of Xerces and Xalan being used by JDK 1.4. Some of these problems will probably be addressed in a newer version of Xindice, but at the time of this writing, the production version of Xindice (1.0) is subject to these sorts of problems.




Professional XML Development with Apache Tools. Xerces, Xalan, FOP, Cocoon, Axis, Xindice
Professional XML Development with Apache Tools: Xerces, Xalan, FOP, Cocoon, Axis, Xindice (Wrox Professional Guides)
ISBN: 0764543555
EAN: 2147483647
Year: 2003
Pages: 95

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net