Changeset 20091

Timestamp:

2009-07-27T16:11:31+12:00 (15 years ago)

Author:

kjdon

Message:

added some notes about tomcat/java

File:

• greenstone3/trunk/README.txt (modified) (3 diffs)

greenstone3/trunk/README.txt

@@ -13 +13 @@
 See the README-SVN.txt file for extra notes about installing directly from SVN.
 
-Greenstone 3 requires Java and Ant to run. These may be installed during 
-Greenstone installation.
+Greenstone 3 requires Java and Ant to run. These will be installed during a
+Greenstone binary installation.
 
 Running Greenstone:
@@ -30 +30 @@
 Greenstone). You will need to manually start/stop an external Tomcat 
 (see below for notes about using a version of Tomcat external to Greenstone).
+
+You will need to run 'gs3-setup' (Windows) or 'source gs3-setup.sh' (Linux/Mac)
+before running ant targets.
 
 Once the Tomcat server is running, Greenstone will be available in a browser 
@@ -45 +48 @@
 
 You can build collections using the Greenstone Librarian Interface (GLI). 
-To start GLI, select it from the Start Menu (Windows), run 'ant gli" from the 
+To start GLI, select it from the Start Menu (Windows), run 'ant gli' from the 
 greenstone3 directory, or cd to greenstone3/gli and run gli.sh/bat. 
 
 Once you have created and built a collection, you can see it by clicking 'Preview collection' on the Build panel.
+
+Java/Tomcat Notes
+--------------------------------------------------------
+
+Binary releases of Greenstone are compiled with Java 1.5 and come with JRE 1.5 and Tomcat 6. Tomcat 6 does not work with Java 1.4.
+
+To recompile the source from a binary release: 
+* Download the source code component and unpack into Greenstone3 directory.
+* You will need to install a JDK, 1.5 or later.
+* Rename the packages/jre folder to something else (eg jre.old)
+* Set JAVA_HOME environment to be the root of your Java installation.
+* run 'ant install'
+
+If you wish to use Java 1.4:
+* Do all the above steps but before running ant install,
+* delete packages/tomcat/.flagfile and run 'ant prepare-tomcat' to get Tomcat 5.
+
+Greenstone 3 from SVN will download Tomcat 5 if you are using Java 1.4, otherwise will download Tomcat 6.
 
 Greenstone Admin