The second milestone release of Tomcat 3.3 is available for download
and testing. As a Tomcat 3.x release, it remains an implementation
of the Servlet 2.2 and JSP 1.1 specifications.
The Milestone 2 release primarily offers bug fixes over Milestone 1.
In this milestone release, documentation still hasn't caught up with
some of the changes for Milestone 1 and this release. For this reason,
be sure to read the "README" file found in Tomcat's "doc" directory.
It contains documentation that covers some of the more important of
the changes to Tomcat 3.3.
If you have did not try the Milestone 1 release, the following
additional information may help you make full use of the Milestone 2
release:
1) The binary distribution has source for the connectors, but not for
the Tomcat container. The source for the full jakarta-tomcat CVS
tree is available separately in the "v3.3-m2/src" directory.
2) The internal directory structure contained in the binary and source
archives differs from Tomcat 3.2. The binary expands to a directory
called "tomcat" and the source expands to "jakarta-tomcat". This
matches what you would get if you checked out CVS source and built
Tomcat from that source.
New for the Milestone 2 release is that building Tomcat 3.3 from
source creates the "build" and "dist" directories under the
"jakarta-tomcat" directory instead of at the same level as
"jakarta-tomcat". Also, jakarta-servletapi is not required, so its
source is not included in the "v3.3-m2/src" directory.
3) The new class loader scheme in this release ignores your CLASSPATH
setting. Instead, you may add needed jars to Tomcat's "lib/apps",
"lib/common", and "lib/container" directories. See the "README" file
in Tomcat's "doc" directory for details.
New for Milestone 2 are two System properties:
org.apache.tomcat.apps.classpath
org.apache.tomcat.common.classpath
which add their listed classes and jars to the jars in "lib/apps"
and "lib/common", respectively.
4) The "sanity-test" is not part of the binary distribution like it was
with Tomcat 3.2. However, it is available in "War" form, along with
the Watchdog JSP and servlet tests. These are found in the
"v3.3-m2/apps" directory. Place these War files in Tomcat's
"webapps" directory before starting Tomcat. To simplify testing,
these tests can be run from the Admin web application. See
the "README" file in Tomcat's "doc" directory for details.
5) On Windows, there have been instances where the watchdog-jsp.jsp test
fails to display successful tests. Running the watchdog-servlet.jsp
first seems to avoid this. You can also restart Tomcat and re-run
watchdog-jsp.jsp and it will display the successful tests.
6) The Admin web application's index.html file has an error in the
commands it displays to change it to "trusted". "run" should appear
before "-enableAdmin" when using the ".sh" and ".bat" files. This is
documented correctly in the "README" in the "doc" directory.
Please download this release and give it a try in your environment. The
source, rpms, and binaries may be found at:
http://jakarta.apache.org/builds/jakarta-tomcat/release/v3.3-m2
To log problems or bugs, as well as submit patches, please refer to:
http://jakarta.apache.org/site/bugs.html
When logging bugs to Bugzilla, please specify the Program as "Tomcat 3"
and the Version as "Nightly Build".
Thanks,
Larry Isaacs
