# HG changeset patch
# User paulb
# Date 1191625387 0
# Node ID e4e199ce054b24317080a380b7b4ea190091b528
# Parent  015552f8bdc1aeb118ff6051e79ec15afe2a42b2
[project @ 2007-10-05 23:03:07 by paulb]
Added notes about Tomcat and Java runtimes.

diff -r 015552f8bdc1 -r e4e199ce054b docs/JavaServlet/NOTES.txt
--- a/docs/JavaServlet/NOTES.txt	Fri Oct 05 23:02:51 2007 +0000
+++ b/docs/JavaServlet/NOTES.txt	Fri Oct 05 23:03:07 2007 +0000
@@ -14,6 +14,8 @@
 Jython to run on that environment, or even to install a completely separate
 Jython from a different source such as jython.org.
 
+See below for notes on Java runtimes and Apache Tomcat.
+
 Preparing the Application for Deployment
 ----------------------------------------
 
@@ -36,6 +38,9 @@
 application (activation.jar and mail.jar from the Tomcat libraries in this
 case); it produces a directory called SimpleApp in the current directory.
 
+Run the script without arguments to see a full help message with some example
+arguments.
+
 Important
 ---------
 
@@ -81,8 +86,8 @@
 
 http://localhost:8080/SimpleApp/
 
-Running Applications with Apache Tomcat
-=======================================
+Running Applications with Apache Tomcat (4.1.x)
+===============================================
 
 Before starting Tomcat, make sure the following environment variables are set:
 JAVA_HOME, CATALINA_HOME. On some systems, such as Ubuntu Feisty (7.04), even
@@ -90,7 +95,7 @@
 development kit (JDK) will have been installed, yet Tomcat will require a JDK
 to function. It is therefore necessary to install the Sun JDK or a suitable
 package (eg. java-gcj-compat-dev). Then, the environment variables can be set
-up as in this example:
+up as in this example (but see the important note below):
 
 export JAVA_HOME=/usr/lib/jvm/java-1.4.2-gcj-4.1-1.4.2.0
 export CATALINA_HOME=/home/paulb/Software/Java/jakarta-tomcat-4.1.31
@@ -99,6 +104,19 @@
 contain bin and lib directories, with the bin directory containing javac and
 other tools.
 
+Important
+---------
+
+It would appear that, as far as Apache Tomcat is concerned, the use of a Sun
+Java runtime is preferable to that available in Ubuntu Feisty (7.04), and such
+a runtime can be enabled by setting JAVA_HOME appropriately. For example:
+
+export JAVA_HOME=/home/paulb/Software/Java/jdk1.5.0_03
+
+The Ubuntu version of Jython can still be used in this configuration - it is
+not necessary to install a separate Jython distribution when running Tomcat in
+this way.
+
 Authentication/Authorisation with Apache Tomcat
 ===============================================