On Fri, Jun 29, 2001 at 03:42:53AM +0100, Pier P. Fumagalli wrote:
> Justin Erenkrantz at [EMAIL PROTECTED] wrote:
>
> > On Thu, Jun 28, 2001 at 10:07:57PM -0400, Donald Ball wrote:
> >> hate to be plaintive, but i'd really appreciate any suggestions y'all
> >> would have to offer on this. so close, and yet...
> >
> > As Pier said, just add ServerName.
> >
> > Be nice if you took all of this info and submitted a patch for the docs.
> > I'd bet someone would commit it. I know Aaron Bannert submitted a patch
> > for j-t-c to help installation, but no one committed it.
>
> Hmm... I cannot find any patch from Aaron in my mail log... Can you please
> resubmit it?
It's not complete, but it's a start. It's not really an install doc yet,
since that part is the part I need help with, but it does attempt to
describe to newbies what the heck is going on in this weird j-t-c
directory, and points them in the right direction for what they want
to do. I intended it to be a toplevel j-t-c README file.
-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/. ]
