1.1 --- a/docs/JavaServlet/NOTES.txt Fri Oct 05 23:02:51 2007 +0000
1.2 +++ b/docs/JavaServlet/NOTES.txt Fri Oct 05 23:03:07 2007 +0000
1.3 @@ -14,6 +14,8 @@
1.4 Jython to run on that environment, or even to install a completely separate
1.5 Jython from a different source such as jython.org.
1.6
1.7 +See below for notes on Java runtimes and Apache Tomcat.
1.8 +
1.9 Preparing the Application for Deployment
1.10 ----------------------------------------
1.11
1.12 @@ -36,6 +38,9 @@
1.13 application (activation.jar and mail.jar from the Tomcat libraries in this
1.14 case); it produces a directory called SimpleApp in the current directory.
1.15
1.16 +Run the script without arguments to see a full help message with some example
1.17 +arguments.
1.18 +
1.19 Important
1.20 ---------
1.21
1.22 @@ -81,8 +86,8 @@
1.23
1.24 http://localhost:8080/SimpleApp/
1.25
1.26 -Running Applications with Apache Tomcat
1.27 -=======================================
1.28 +Running Applications with Apache Tomcat (4.1.x)
1.29 +===============================================
1.30
1.31 Before starting Tomcat, make sure the following environment variables are set:
1.32 JAVA_HOME, CATALINA_HOME. On some systems, such as Ubuntu Feisty (7.04), even
1.33 @@ -90,7 +95,7 @@
1.34 development kit (JDK) will have been installed, yet Tomcat will require a JDK
1.35 to function. It is therefore necessary to install the Sun JDK or a suitable
1.36 package (eg. java-gcj-compat-dev). Then, the environment variables can be set
1.37 -up as in this example:
1.38 +up as in this example (but see the important note below):
1.39
1.40 export JAVA_HOME=/usr/lib/jvm/java-1.4.2-gcj-4.1-1.4.2.0
1.41 export CATALINA_HOME=/home/paulb/Software/Java/jakarta-tomcat-4.1.31
1.42 @@ -99,6 +104,19 @@
1.43 contain bin and lib directories, with the bin directory containing javac and
1.44 other tools.
1.45
1.46 +Important
1.47 +---------
1.48 +
1.49 +It would appear that, as far as Apache Tomcat is concerned, the use of a Sun
1.50 +Java runtime is preferable to that available in Ubuntu Feisty (7.04), and such
1.51 +a runtime can be enabled by setting JAVA_HOME appropriately. For example:
1.52 +
1.53 +export JAVA_HOME=/home/paulb/Software/Java/jdk1.5.0_03
1.54 +
1.55 +The Ubuntu version of Jython can still be used in this configuration - it is
1.56 +not necessary to install a separate Jython distribution when running Tomcat in
1.57 +this way.
1.58 +
1.59 Authentication/Authorisation with Apache Tomcat
1.60 ===============================================
1.61