INSTALLATION

The directory structure of the full distribution is:

bin -- contains some simple scripts to access the example DBMS
contrib -- redistributed software from other sources
db -- scripts to create a relational database for storing and accessing XML
java -- source code and jsp tag library description files
lib -- jar files that are required (except JDBC is also needed and not distrobuted)

To fully utilize the system you may need:

1. A relational DBMS, such as IBM DB2 or Oracle.
2. A Java runtime environment, and possibly a Java compiler.
3. JDBC driver for the relational DBMS (Open Database Connectivity for Java).
4. A web server that supports Java servlets or JSPs. (optional)
5. An XML parser in Java that implements SAX2 interface (Simple API for XML) 
   (included).
6. The system uses log4j for logging and JUnit for testing. (both included)

More information on acquiring that software is available at
http://www.phptr.com/graves/required_software.html

Create the XML storage system by executing a creation script from the
"db" directory, "db/cr_xmldb_oracle.sql" or "db/cr_xmldb_db2.sql" in
the DBMS. (This SQL is described in more detail in Chapter 4 of
"Designing XML Databases". The PDF for that chapter is available for
free.) If possible, create a new account for the database. The
examples in the book use the "xmldb" account (with the password
"xmldb") and the schema "XMLDB" for DB2 and "ORCL" for Oracle. (In
Oracle, the "xmldb" user will need the "connect" and "resource"
roles.) If a different account is used, you will need to set the
account using the xmldb.properties file (or alternately set java
properties each time the java code is executed).

Place the appropriate JDBC jar file for your relational DBMS into
your classpath.

Place the xmldb.properties file in your Java classpath and modify
it if the XML parser or DB account is modified.

More comprehensive, step-wise instructions are available at
http://www.phptr.com/graves/installation.html