On Wed, Jun 20, 2001 at 11:47:23AM +0100, Pier P. Fumagalli wrote:
> Aaron Bannert at [EMAIL PROTECTED] wrote:
> > On Tue, Jun 19, 2001 at 10:06:07AM -0700, Aaron Bannert wrote:
> >> Apache Tomcat Connectors
> >> ========================
[snip]
> >> Connectors
> >> ----------
> >>
> >> * jk: The native and java parts of the ajp12/ajp13 [is this correct?]
> >> connector. Both Tomcat 4.0 and Tomcat 3.3 are supported.
> >>
> >> * webapp: The native and java parts of the ajp14 connector, now known
> >> as mod_webapp and warp respectively.
> >
> > Whoops, that's obviously not correct. warp is the protocol (right?),
> > mod_webapp is the webserver module (Apache et al), and do we have a
> > name for "the java part"? How about this instead:
> >
> > * webapp: The native and java parts of the connector that implements
> > the warp protocol (ajp14). This includes mod_webapp for integration
> > with a frontend webserver (like Apache).
>
> WARP is _NOT_ AJPv14... It's actually AJPv20 with some additions from AJPv21
> (see the specs in JServ land) and some updates from the new concept of "web
> application"...
I appreciate the clarification. In the hopes that it will be added to
the j-t-c CVS repository, the revised README is attached.
With all the conflicting information I've received lately about
the contents of j-t-c it seems this README may serve more people than
just the newbies :)
-aaron
Apache Tomcat Connectors
========================
Introduction
============
This CVS module contains the code for the Tomcat Connectors. It currently
contains two distinct connectors: jk and webapp. This module also contains
utility classes that are used by the connectors as well as Tomcat itself.
The components are:
Connectors
----------
* jk: The native and java parts of the ajp12/ajp13 connector.
Both Tomcat 4.0 and Tomcat 3.3 are supported. This also includes
mod_jk for integration with various frontend webservers (like
Apache).
* webapp: The native and java parts of the warp connector. This
includes mod_webapp for integration with frontend webservers.
Utilities
---------
* coyote: A reflexion framework +/- of what is needed to handle HTTP requests
in Tomcat (in java). These utilities are not intended for user code.
They are used internally by Tomcat.
* util: A set of APIs used by Tomcat. Note: these came from Tomcat 3.3
and were extracted here for general use.
Building Apache Tomcat Connectors
=================================
It is not necessary to build and install both connectors. [ Talk about
tradeoffs between jk and webapp. Perhaps reference some other documentation
that already does this. ]
* If you wish to build the 'jk' connector, see the documentation in
jk/README.txt for the java implementation, and jk/native/README.configure
for help with the native Apache module.
* If you wish to build the 'webapp' connector, see the documentation in
webapp/README.txt.
Installing Apache Tomcat Connectors
===================================
[ This could use some serious work. There are a few factors that make this
more complicated than it should be, namely using 'jk' vs 'webapp', and
then how to install and configure for both TC 3.3 and TC 4.0. ]
[ Notes: from thread on tomcat-dev around Jun 20th:
We have a limited amount of install scripts (see jk/native/apache-1.3
for example), and may wish to expand these to cover the build.xml/jars.
It would also be good (IMHO) to put instructions for doing the same
here or at least have this document direct people to the appropriate
docs under jk/ or webapp/. ]
