Changeset 10096 for trunk/gsdl3/README.txt

Timestamp:

2005-06-15T11:10:06+12:00 (19 years ago)

Author:

kjdon

Message:

more external tomcat instructions

File:

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

trunk/gsdl3/README.txt

@@ -105 +105 @@
 
 If you want to use an existing Tomcat, set the path to its base directory
-in build.properties. You will need to modify the Tomcat setup slightly.
+in build.properties (tomcat.installed.path). Then run 'ant install'. If you have already done an install (e.g. using a local Tomcat), you don't need to do it again.
 
-1. Add in the Greenstone context to Tomcat's server.xml. 
+ You will need to modify the Tomcat setup slightly.
+
+1. Tell Tomcat about the Greenstone web app. There are two ways to do this.
+
+A. Add in the Greenstone context to Tomcat's server.xml. 
 
 <Context path="/gsdl3" docBase="path-to-gsdl3/web" debug="1" 
 reloadable="true"><Resources allowLinking='true'/></Context>
 
-Alternatively, you can rename the gsdl3/web directory to gsdl3 and move it into
-Tomcat's webapps directory. (i.e. the resulting directories will be like
-webapps/gsdl3/WEB-INF, no web directory).
-TODO: check that this works.
+B. Alternatively, you can move (and rename) the gsdl3/web directory to tomcat/webapps/gsdl3 (i.e. the resulting directories will be like
+tomcat/webapps/gsdl3/WEB-INF, no web directory).
+TODO: this doesn't work at the moment.
 You will need to set the web.home property in the build.properties file
-eg
+i.e.
 web.home=path-to-tomcat/webapps/gsdl3
 
@@ -128 +131 @@
 A: Keep all the Greenstone stuff inside the gsdl3 directory, and just modify the environment that Tomcat runs in
 
-set LD_LIBRARY_PATH/PATH to include gsdl3/lib/jni directory.
+set LD_LIBRARY_PATH (linux) or PATH (windows) to include gsdl3/lib/jni directory.
 add all the jar files in gsdl3/lib/jni directory to the CLASSPATH, then edit tomcats setclasspath.sh/bat to use the system CLASSPATH.
 (in setclasspath.bat, change 
@@ -150 +153 @@
 B: Copy the files into Tomcat installation:
 Move the gsdl3/lib/jni jar files into tomcat's shared/lib directory.
-Move the gsdl3/lib/jni library files (.so/.dll) into shared/classes, and set LD_LIBARARY_PATH/PATH to include this directory. 
+Move the gsdl3/lib/jni library files (.so for linux, .dll for windows) into shared/classes, and set LD_LIBARARY_PATH (linux) or PATH (windows) to include this directory. 
 This has the advantage that you can use this for other webapps without modifying the Tomcat environment.
+
+
+Once all these changes have been made, you will need to restart the Tomcat server for them to take effect.