Weeds 2:  Common Weeds of the Carribean

This is the source code for the software which generates "Common
Weeds of the Carribean" which is at http://www.tapir.org/weeds/.

Although alternative components could be probably be substituted,
this software has been tested with the following toolset

* Sun JDK 1.1.7
(http://www.javasoft.com/products/jdk/1.1/)
* Sun Servlet SDK 2.0
(http://www.javasoft.com/products/servlet/index.html)
* Apache Web Server 1.3.6
(http://www.apache.org/)
* Apache JServ 1.0
(http://java.apache.org/)
* JavaServer(tm) Web Development Kit 1.0 EA
(http://www.javasoft.com/products/jsp/index.html)
* MySQL 3.21.33
(http://www.mysql.org/)
* mm.mysql 
(http://worldserver.com/mm.mysql/)

What's contained

README           -- this file
VERSION          -- version number
build-weeds-db   -- db initialization script
classes          -- compiled class files for WEEDS 2
compile-weeds    -- script to compile WEEDS 2
honeylocust &
tapir            -- Java source for WEEDS 2
identified-weeds -- weed descriptions and images
weeds            -- directory to install on web server,  contains JSP files


Compiling
---------

(This isn't necessary if you don't modify the code) 

On UNIX,  if javac is working correctly,  type

./compile-weeds

in this directory.

Installing
----------

	The details depend on your web server,  servlet runner,  etc.

[1] Install required support software

Apache must be compiled with URL Rewriting enabled.

[2] Install WEEDS 2 package. 

	 Install the contents of the ./weeds directory (including the hidden
.htaccess file) so that it will appear under

http://yourserver/weeds

	You can install it elsewhere,  but you'll need to change the
classpaths in the below documentation instructions and also change the
RewriteBase property in ./weeds/.htaccess

	I installed weeds in /home/www0/weeds/ -- in the next section,
substitute this with the location where you've placed it.

[3] Configure your classpaths

	You need to make sure that (a) the servlet runner JVM,  and the (b)
JSP page compiler both have weeds2.jar in their CLASSPATH.  The following
instructions are for the Apache Jserv/Sun WDK combination.

In the /usr/local/jserv/conf/jserv.properties file,  insert the following
[change paths to something appropriate for your system]

# Sun JSDK
wrapper.classpath=/usr/local/jsdk/jsdk.jar
# mysql JDBC driver
wrapper.classpath=/usr/local/mm.mysql/mysql.jar
# Sun's reference JSP engine implementation
wrapper.classpath=/usr/local/jswdk/jsp.jar
wrapper.classpath=/usr/local/jswdk/jspengine.jar
# The WEEDS 2 jar file
wrapper.classpath=/home/www0/weeds/weeds2.jar

[4] Initialize database:

	In this directory,  type

./build-weeds-db

	this creates the database and loads it from XML.





