INSTALLATION INSTRUCTIONS
=========================

THE JDK INSTALLATION
--------------------
This version of Venice runs under JDK 1.4.1.  The following extensions should
be installed to the $JAVA_HOME/jre/lib/ext directory:
- JavaMail 1.3
- JavaBeans Activation Framework 1.0.2
- Java Advanced Imaging 1.1.1, plus the JAI ImageIO extensions

In addition, the Xalan 2.4.1 and Xerces 2.2.1 XML tools should be installed
as "endorsed standards overrides" in the $JAVA_HOME/jre/lib/endorsed directory.

APACHE TOMCAT
-------------
A recent version of Apache Tomcat, such as version 4.1.24, must be installed.

JAKARTA ANT
-----------
A recent version of Jakarta Ant, such as 1.5.1, must be installed to build
Venice.

PACKAGES REQUIRED FOR VENICE
----------------------------
The following packages must be referenced from within build.properties:
- JavaCC 3.0 (parser generator tool)
- Java Servlet API 2.3 (use the servlet.jar file from Tomcat)
- Jakarta Bean Scripting Framework 2.3
- Jakarta Commons Collections Library, 2.1
- Jakarta Commons Lang Library, 1.0.1
- Mozilla.org Rhino, 1.5R3
- Jakarta Log4J, 1.2.7
- Jakarta Lucene, 1.3RC1
- Jakarta Velocity, 1.3.1

Optionally:
- SourceID-SSO 1.0

DATABASE DRIVERS REQUIRED FOR VENICE
------------------------------------
Currently, the only database supported with Venice is MySQL.  The MySQL
Connector 3.0.7 should be copied to the drivers/ subdirectory.

BUILDING AND DEPLOYING
----------------------
When built, the complete installation of Venice will be copied to the
subdirectory "assembly/venice".  This directory may be deployed into Tomcat
directly by editing $CATALINA_HOME/conf/server.xml.

INITIALIZING THE DATABASE
-------------------------
The script "conf/venice-db-init-mysql.sql" can be used to initialize the
database.