1.1 --- a/docs/JavaServlet/NOTES.txt Thu Sep 27 17:48:43 2007 +0000
1.2 +++ b/docs/JavaServlet/NOTES.txt Thu Sep 27 22:32:20 2007 +0000
1.3 @@ -22,20 +22,21 @@
1.4 deploy the directory in the servlet container. For example:
1.5
1.6 jython webstack_java_build.py examples/JavaServlet/SimpleApp.py \
1.7 - examples/Common/Simple/ \
1.8 . \
1.9 /tmp/jython-cache \
1.10 web.xml \
1.11 + examples/Common/Simple/ \
1.12 + --libraries \
1.13 $CATALINA_HOME/common/lib/activation.jar \
1.14 $CATALINA_HOME/common/lib/mail.jar
1.15
1.16 -This identifies the handler (SimpleApp.py), the application package (Simple),
1.17 -the directory where the WebStack package is found (.), the directory to be
1.18 -used for caching imported classes, and the name of the template for the
1.19 -deployment descriptor (web.xml); it also specifies the library files which
1.20 -must also be deployed with the application (activation.jar and mail.jar from
1.21 -the Tomcat libraries in this case); it produces a directory called SimpleApp
1.22 -in the current directory.
1.23 +This identifies the handler (SimpleApp.py), the directory where the WebStack
1.24 +package is found (.), the directory to be used for caching imported classes,
1.25 +and the name of the template for the deployment descriptor (web.xml); it also
1.26 +specifies the package directories for the application (Simple), and after the
1.27 +--libraries flag, the library files which must also be deployed with the
1.28 +application (activation.jar and mail.jar from the Tomcat libraries in this
1.29 +case); it produces a directory called SimpleApp in the current directory.
1.30
1.31 Important
1.32 ---------
1.33 @@ -57,6 +58,24 @@
1.34
1.35 http://localhost:8080/SimpleApp/
1.36
1.37 +Running Applications with Apache Tomcat
1.38 +=======================================
1.39 +
1.40 +Before starting Tomcat, make sure the following environment variables are set:
1.41 +JAVA_HOME, CATALINA_HOME. On some systems, such as Ubuntu Feisty (7.04), even
1.42 +if Jython is installed (see above), there is no guarantee that a suitable Java
1.43 +development kit (JDK) will have been installed, yet Tomcat will require a JDK
1.44 +to function. It is therefore necessary to install the Sun JDK or a suitable
1.45 +package (eg. java-gcj-compat-dev). Then, the environment variables can be set
1.46 +up as in this example:
1.47 +
1.48 +export JAVA_HOME=/usr/lib/jvm/java-1.4.2-gcj-4.1-1.4.2.0
1.49 +export CATALINA_HOME=/home/paulb/Software/Java/jakarta-tomcat-4.1.31
1.50 +
1.51 +Generally, the contents of the directory referenced by JAVA_HOME should
1.52 +contain bin and lib directories, with the bin directory containing javac and
1.53 +other tools.
1.54 +
1.55 Authentication/Authorisation with Apache Tomcat
1.56 ===============================================
1.57