[PATCH] Tomcat 3.3 m3 mod_jk-howto.html (new Bug #1809)

[Hans Schmid]

Hello,

I just installed Tomcat3.3-m3 with ajpv13 behind Apache 1.3.19 on Win2000.

While setting up mod_jk with ajp1.3, I noticed a bug in the
mod_jk-howto.html
It states:


Add the following block to your TOMCAT_HOME/conf/server.xml file.

<Connector className="org.apache.tomcat.service.PoolTcpConnector">
  <Parameter name="handler"
value="org.apache.tomcat.service.connector.Ajp13ConnectionHandler"/>
  <Parameter name="port" value="8009"/>
</Connector>


but this is the way Tomcat 3.2.2 has to be setup.

In TC 3.3 the entry should be:

<RequestInterceptor
className="org.apache.tomcat.modules.server.Ajp13Interceptor"
 port="8009" />


and its enabled by default.

Anyway, I have attatched diffs against /src/doc/mod_jk-howto.html. This is
the new paragraph:

----------------------------------------------------------------------------
-------------------------------
(Optional) Configuring Tomcat to use the Ajpv13 protocol
mod_jk can use either the original Ajpv12 protocol or the newer Ajpv13
protocol. If you choose the latter, you need to activate the "Ajp13"
Connection Handler in Tomcat. This will give you the benefit of a faster
protocol and the ability to identify requests made via HTTPS.

Add the following block to your TOMCAT_HOME/conf/server.xml file.
<Connector className="org.apache.tomcat.service.PoolTcpConnector">
  <Parameter name="handler"
value="org.apache.tomcat.service.connector.Ajp13ConnectionHandler"/>
  <Parameter name="port" value="8009"/>
</Connector>

The server.xml file already has a block similar to this for Ajp12
connections on port 8007 (as delivered by mod_jserv). Even if you think
you're only using Ajp13, you probably don't want to delete this connector --
it's required to shut down Tomcat.
----------------------------------------------------------------------------
-------------------------------

There is a mod_jk-howto.html in proposals as well. I don't know, if this
patch should be applied to this one as well.

I hope this helps a little bit since there seems to be so much confusion in
the user-list about setting up mod_jk.

Best regards,

Hans

--- mod_jk-howto.html.orig      Fri May 18 14:22:58 2001
+++ mod_jk-howto.html   Fri May 18 14:32:21 2001
@@ -643,14 +643,13 @@
 <h3><a name="s82">(Optional) Configuring Tomcat to use the Ajpv13 protocol</a></h3>
 <div class=subsection>
 mod_jk can use either the original Ajpv12 protocol or the newer Ajpv13 protocol.
-If you choose the latter, you need to activate the &quot;Ajp13&quot; Connection 
Handler in Tomcat. This
-will give you the benefit of a faster protocol and the ability to identify requests 
made via HTTPS.<BR><BR>
-Add the following block to your <tt>TOMCAT_HOME/conf/server.xml</tt> file.
+Both protocols are enabled by default. The &quot;Ajp13&quot; Connection Handler in 
+Tomcat will
+give you the benefit of a faster protocol and the ability to identify requests made 
+via HTTPS.<BR><BR>
+The following block enables Ajpv13 in your <tt>TOMCAT_HOME/conf/server.xml</tt> file.
 <blockquote><pre>
-&lt;Connector className=&quot;org.apache.tomcat.service.PoolTcpConnector&quot;&gt;
-  &lt;Parameter name=&quot;handler&quot; 
value=&quot;org.apache.tomcat.service.connector.Ajp13ConnectionHandler&quot;/&gt;
-  &lt;Parameter name=&quot;port&quot; value=&quot;8009&quot;/&gt;
-&lt;/Connector&gt;
+&lt;RequestInterceptor
+  className=&quot;org.apache.tomcat.modules.server.Ajp13Interceptor&quot;
+  port=&quot;8009&quot;/&gt;
 </pre></blockquote>
 
 <p>The <tt>server.xml</tt> file already has a block similar to this for