INSTALLATION INSTRUCTIONS
-------------------------

Software requirements:
    You must install the following software on your system:

    * Java 2 SDK version 1.3.0/1.3.1.  Venice is normally run with the Blackdown
      JDK port, available at http://www.blackdown.org.
    * Java API for XML Parsing (JAXP) version 1.1, available from
      http://java.sun.com.
    * Java Secure Socket Extension (JSSE) version 1.0.2, available from
      http://java.sun.com.  (Venice does not (yet) require this, but Apache
      Tomcat does.)
    * JavaMail API version 1.2, available from http://java.sun.com.
    * JavaBeans Activation Framework (JAF) version 1.0.1, available from 
      http://java.sun.com.  (Required by JavaMail.)
    * Java Advanced Imaging (JAI) version 1.1.1, available from
      http://java.sun.com.
    * Apache Jakarta LOG4J library 1.1.x, available from
      http://jakarta.apache.org.
    * MySQL 3.23.x (get the most recent 3.23 version), available from
      http://www.mysql.com.
    * The MM.MySQL JDBC drivers version 2.0.3, available from XXXX.
    * Apache Jakarta Ant, version 1.2, available from
      http://jakarta.apache.org.
    * Apache Jakarta Servlet API, version 3.2, available from
      http://jakarta.apache.org.
    * Apache Tomcat version 3.2.1, available from http://jakarta.apache.org.
      If you plan on using Apache-Tomcat integration, get at least 3.2.2b3, as
      otherwise there will be a problem with file uploads (Bug#526 in the Apache
      Jakarta Bug Database).
    * Additional libraries; please see the document lib/README.lib for further
      details.  (This section will be rewritten when the list of libraries used
      by Venice stabilizes enough.)

    The lib/README.lib file details which library JAR files should be
    placed in the <jdk>/jre/lib/ext directory, and which should be placed in
    the Venice "lib" subdirectory.  You can symbolically link the JAR files
    instead of copying them.  The JDK /bin subdirectory should be in your PATH,
    naturally.

    You should have access to a mail server that can relay e-mail messages
    from the host on which Tomcat will be running.  (If it's the same host,
    so much the better.)

Setting Up:
    After extracting the source from CVS, you will need to choose your
    deployment directory.  This will need to be specified as the "deploy.home"
    property in the build.xml file.  In addition, the three main Venice
    configuration files (logging-config.xml, render-config.xml, and
    venice-config.xml) are all copied to the WEB-INF subdirectory of the
    deployment directory, and three parameters in web.xml point to them, so
    those parameters will have to be modified.

    The MySQL JDBC driver (mysql.jar) and the LOG4J JAR file (log4j.jar) need
    to be copied to the "lib" subdirectory.  The build process will copy them
    to the "WEB-INF/lib" subdirectory of the deployment directory.

    Also modify the three configuration files to suit your system layout.
    Each file is reasonably commented, so you should be able to figure it out
    based on your directory location and your Tomcat configuration.

    The database.sql file's "grant privileges" section may also need to be
    modified to suit your tastes.  Make sure though, that the Venice database
    username and password match those specified in venice-config.xml, or
    nothing will work.

    Finally, in the setup directory, the files context-add.xml and
    tomcat.policy.add contain snippets to be added to your Tomcat server.xml
    and tomcat.policy files, respectively.  These also need to be modified
    as necessary.  (Yes, I know the policy should not be granting AllPermission
    to the entire server application.  This will be fixed later, once I know
    exactly what permissions are required.)

    Create the Venice database by using the command:

    mysql -u root -p < setup/database.sql

    and type your MySQL root password when prompted.  If your database gets
    horked, this command will reset it to its "pristine" state as well.

    Now start Tomcat in the usual way, and point your Web browser at the
    URL "http://<servername>:<port>/venice/top".  If all goes well, you will
    see the Venice "top level" page pop up in your browser.  (It'll take a
    minute or so the first time, as the classes all get loaded and some of
    the JSPs compile for the first time.)

