Changeset 10068

Timestamp:

2005-06-13T14:18:50+12:00 (19 years ago)

Author:

kjdon

Message:

added some notes for jni stuff with external tomcat

File:

• trunk/gsdl3/README.txt (modified) (1 diff)

trunk/gsdl3/README.txt

@@ -101 +101 @@
 So should only use anonymous cvs.
 
+Using External Tomcat:
+------------------------
+
+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.
+
+1. 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.
+You will need to set the web.home property in the build.properties file
+eg
+web.home=path-to-tomcat/webapps/gsdl3
+
+2. Set up the JNI libraries and Java wrappers.
+JNI libraries and their Java wrappers cannot go into the web app. The libraries need to be loaded by the same class loader as their wrappers. The libraries need to be in java.library.path, and I think get loaded by the system class loader.
+The wrappers need to be loaded by this too. 
+To get the native libraries loaded, the directory they are in needs to be in the PATH variable (Windows) or the LD_LIBRARY_PATH variable (linux).
+
+These JNI bits are located by default in the lib/jni directory. There are two ways to get them into Tomcat:
+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.
+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 
+set CLASSPATH=%JAVA_HOME%\lib\tools.jar
+to 
+set CLASSPATH=%JAVA_HOME%\lib\tools.jar;%CLASSPATH%
+
+in setclasspath.sh, change
+# Set standard CLASSPATH
+if [ "$1" = "debug" -o "$1" = "javac" ] ; then
+  CLASSPATH="$JAVA_HOME"/lib/tools.jar
+fi
+
+to
+# Set standard CLASSPATH
+if [ "$1" = "debug" -o "$1" = "javac" ] ; then
+  CLASSPATH="$JAVA_HOME"/lib/tools.jar:"CLASSPATH"
+fi
+
+
+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. 
+This has the advantage that you can use this for other webapps without modifying the Tomcat environment.
+
+
+
+