6397f4212c
the underlying support) - incidentally, this is a lot of support for the SIG logo as well, just need some front end work for that in the future (of course, we now require JAI 1.1.1)
84 lines
4.1 KiB
Plaintext
84 lines
4.1 KiB
Plaintext
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.0.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).
|
|
|
|
It is recommended that you install JAXP, JSSE, JavaMail, and JAF by copying
|
|
or symbolically linking their JAR files to the <jdk>/jre/lib/ext
|
|
directory, to avoid creating a huge CLASSPATH variable. 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.)
|
|
|