| 1 |
Jakarta-Tomcat 4.1 for Debian
|
| 2 |
=============================
|
| 3 |
|
| 4 |
- The home directory for Tomcat 4.1 (a.k.a. Catalina) is /usr/share/tomcat4
|
| 5 |
but most of the files in there are just symlinks to the proper FHS
|
| 6 |
directories.
|
| 7 |
|
| 8 |
- The package has been built as "light" distribution which means that some
|
| 9 |
of the additional features like JavaMail, JTA and Tyrex are not enabled.
|
| 10 |
Catalina was compiled using MX4J so JMX is available for an embedded
|
| 11 |
servlet engine.
|
| 12 |
|
| 13 |
- The main configuration file is /etc/tomcat4/server.xml.
|
| 14 |
The default setup enables the built-in HTTP web server on port 8180 and
|
| 15 |
a WARP (mod_webapp) connector for Apache on port 8008. The standard port
|
| 16 |
8080 for the web server was not used so the package does not conflict with
|
| 17 |
junkbuster. Tomcat also listens on port 8005 (localhost only) for a
|
| 18 |
shutdown command.
|
| 19 |
|
| 20 |
- Tomcat 4.1 requires a full Java Development Kit (JDK) because a Java
|
| 21 |
compiler is used for translating JavaServer Pages (JSP) into classes.
|
| 22 |
The Java Runtime Environment (JRE) does not include a Java compiler so
|
| 23 |
it can't be used.
|
| 24 |
|
| 25 |
- You can install web applications as .war files or extracted in a
|
| 26 |
subdirectory in /var/lib/tomcat4/webapps (for Tomcat 4 only) or
|
| 27 |
/usr/share/java/webapps (for all servlet engines). The name of the WAR file
|
| 28 |
or subdirectory is the servlet context for this webapp. You can't set
|
| 29 |
unpackWar to true in server.xml because /var/lib/tomcat4/webapps is not
|
| 30 |
writebale by the tomcat4 user for security reasons.
|
| 31 |
|
| 32 |
- You can test if Tomcat is working properly by pointing your favourite web
|
| 33 |
browser to http://localhost:8180/ and testing some of the Servlet and JSP
|
| 34 |
examples. This requires installation of the tomcat4-webapps package.
|
| 35 |
|
| 36 |
- Multiple Tomcat instances can be started by different users when
|
| 37 |
$CALALINA_BASE is set to a local cirectory that contains the subdirectories
|
| 38 |
conf, logs, webapps, work and temp. See RUNNING.txt for more about this.
|
| 39 |
|
| 40 |
- Tomcat is started using a security manager, you can define the permissions
|
| 41 |
for your servlets and JSPs in /etc/tomcat4/policy.d/*. All files in this
|
| 42 |
directory are joined to /etc/tomcat4/catalina.policy. Other Debian packages
|
| 43 |
that contain web applications might provide their own security rules in a
|
| 44 |
file in this directory, e.g. for JDBC access. You can also completely
|
| 45 |
disable the security manager in /etc/default/tomcat4 but this is not
|
| 46 |
recommended since a call to System.exit() in a servlet of JSP page
|
| 47 |
would then stop the whole virtual machine that is running Tomcat.
|
| 48 |
|
| 49 |
- For more information about Jakarta-Tomcat please take a look at the Tomcat
|
| 50 |
home page at http://jakarta.apache.org/tomcat/index.html.
|
| 51 |
|
| 52 |
- The official Servlet 2.3 and JSP 1.2 specifications can be found at
|
| 53 |
http://java.sun.com/products/servlet/ and http://java.sun.com/products/jsp/
|
| 54 |
|