The following document is very incomplete, and in many
cases factually incorrect. The idea is to post it now, while
it's obviously in draft form, get feedback, and then clean it
up and publish it wherever would be most useful (jakarta-tomcat
connectors page, or the Tomcat FAQ)

 I'm currently tracking down user-level instructions for all the
connector/webserver/container combinations I can find, so pointers
to those are especially welcome. I'm not wedded to any of the listing
categories, or the format, or pretty much anything else, so if you
don't like it, speak up.


----------------------------------------------------------------


mod_jserv

 why it was written:
   it was there first. 

 where to get the source:
   java-jserv repository

 where to get documentation:
   java-jserv repository

 unerlying protocol:
   AJP11   

 works with:
   servlet containers:
     JServ
   web servers:
     old versions of Apache httpd
   operating systems:
     ???

 underlying protocol:
   AJP11


mod_jk

   should jk2 be listed out separately?

   why it was written:
     originally, clean-up of mod_jserv. 

   status:
     in production for tomcat 3, 4

   where to get the source:
     jakarta-tomcat-connectors/jk

   where to get documentation:
     jakarta-tomcat-connectors/jk
     tomcat-dev mailing list archives
     http://jakarta.apache.org/tomcat/tomcat-3.3-doc/mod_jk-howto.html
     http://jakarta.apache.org/tomcat/tomcat-4.1-doc/config/jk.html
     http://jakarta.apache.org/tomcat/tomcat-4.1-doc/config/jk2.html

   primary developers:
     evolved from mod_jserv (see above)
     Gal Shachor, IBM Research, Haifa Lab. refactored mod_jserv
     many others?

   works with:
     servlet containers:
       jserv?
       tomcat-3
       tomcat-4
     web servers:
       domino
       apache 1.3
       apache 2.0?
       netscape
       others?
     platforms:
       lots?

   it's big thing:
     production use

   underlying protocol:
     AJP, see mod_jserv
     evolution:
       AJP12, binary
       AJP13, better SSL support. the current protocol.
       AJP14, in testing. see "comments" below.

   special powers:
     load balancing with both tomcat 3 and tomcat 4

   documentation/mailing-list/cvs comments of interest:

   "Mod_jk v/s mod_webapp" on tomcat-dev: 

     Bill Barker wrote: "mod_jk2 is the next generation of mod_jk.  It
     is currently barely Alpha quality for Apache 2.x (and still
     subject to major changes from day-to-day)"

     <[EMAIL PROTECTED]>: "It works ( barely :-) with Apache2.x and
     1.3. The connector for apache1.3 can be used as a basis for
     updating IIS/iPlanet."

     costin: "Mod_jk works on all web servers and with all tomcat
     versions. Mod_jk2 will do the same."
 
     <[EMAIL PROTECTED]> : "What we called "ajp14" are a set of new
     APIs for config, shutdown, MD5 auth - added by Henri. Ajp14 API
     is not 'released', and the current plan is to postpone it after
     the first release of jk2"
     
     <[EMAIL PROTECTED]> : "it started with ajp11 and ajp12 ( first
     text based, second binary ).  Ajp12 evolved into ajp13 - using
     same encoding but with some extensions ( to deal with persistent
     connections ).

     "GOMEZ Henri" <[EMAIL PROTECTED]> : using jk instead of warp depend
     on webserver you want to have it.  If need today, or tomorrow
     IIS/NES/DOMINO, use mod_jk, if you only need to use Apache
     1.3/2.0 and have APR ready, you can use also mod_warp.

     costin: "jk had many developers contributing to it, more than any
     other tomcat component ( AFAIK ). It's also a matter of evolution
     - mod_jk started by implementing the ajp12 protocol and beeing
     backward compatible with mod_jserv ( actually a lot of code has
     been refactored from it ). You can still use mod_jserv with 3.x,
     and you can use mod_jk with anything from jserv to tomcat4."


 webapp

   you might see the terms "mod_webapp", "webapp" and "WARP", being
   used in a confusingly similiar way, but properly: mod_webapp - the
   apache module portion of webapp, WARP - the underlying protocol

   why it was written:
    uses APR, tight tomcat 4 intergration

   status:
     ???

   where to get the source:
     jakarta-tomcat-connectors/webapp

   where to find documentation:
     jakarta-tomcat-connectors/webapp
     http://nagoya.apache.org/~pier/
     http://jakarta.apache.org/tomcat/tomcat-4.1-doc/config/webapp.html

   works with:
     tomcat versions:
       tomcat-4
       others?
     web servers:
       apache 1.3
       others?
     operating systems:
       "not windows"?

   underlying protocol:
     WARP

   special powers:
     tight webserver/container integration means simple deployments
     are very easy

   primary developers:
     Pier Fumagalli <[EMAIL PROTECTED]>
     others?

   mailing list/documentation comments:

   Pier Fumagalli <[EMAIL PROTECTED]> : "I just said that for what
   matters to me (meaning, for what I use it, it works
   allright)... That's far from saying that I'm no longer interested
   on it."

   mod_jk vs mod_webapp thread: pier : "Motivation? I don't like
   mod_jk, I wanted to use APR as a portable runtime for an Apache 1.3
   module, I believe that the WARP protocol with built-in support for
   auto-deployment and web-application configuration is the way to go
   (rather than using mod_rewrite rules all the way around),"


 coyote

   coyote isn't properly a webserver connector like the others listed
   above, see cvs comments below.

   why it was written:
     ???

   status:
     being phased in as default for tomcat 4.1

   where to get the source:
     jakarta-tomcat-connectors/coyote
     org/apache/coyote/http11 - standalone http 1.1 connector

   where to get documentation:
     no documentation as such? mailing list archives, cvs notes only?

   works with:
     servlet containers:
      tomcat-3
      tomcat-4
     web servers:
      using jk2: apache 1.3
      apache 2.0 status?
      others?
     operating systems:
       ??

   underlying protocol:

     HTTP, as standalone connector for tomcat 4 (3?)

     AJPXX ref:  Re: [VOTE] Release Plan for Apache Tomcat 4.1 
     Wed, 24 Apr 2002 13:29:22 -0700 (PDT) <[EMAIL PROTECTED]>
     coyote-Jk2 is stable as a Ajp13/Socket connector - i.e. all that
     matter for mod_jk1. The Unix socket and all advanced features of
     jk2/java will not be 'release quality' either ( but with a bit of
     luck and some help from Nacho and maybe others we can have them
     working and beta-level).

   primary developers:
     "Remy Maucherat" <[EMAIL PROTECTED]>
     others?

   mailing list/documentation/cvs comments:

   coyote announcement? from cvs: Thu Jun 14 01:07:52 2001 UTC (10
   months, 1 week ago) by remm "Coyote is a proposal for a "new"
   connector API for Tomcat. It actually isn't that new, because it is
   derived from some of the components which are at the core of Tomcat
   3.3. Those components were significantly simplified."

   From: "Remy Maucherat" <[EMAIL PROTECTED]>
   Subject: Re: Coyote/jk2 - interaction explanations please
   Date: Thu, 18 Apr 2002 04:45:37 -0700
   In Coyote, there's:
   - the container adapters (for 3.3, 4.0, 4.0-HEAD)
   - the external API (request, response, and a couple other things)
   JK 2 and HTTP/1.1 are protocol handlers for Coyote.


 
-- 
Christopher St. John [EMAIL PROTECTED]
DistribuTopia http://www.distributopia.com

--
To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>

Reply via email to