You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by la...@apache.org on 2001/08/02 19:15:48 UTC
cvs commit: jakarta-tomcat/src/doc mod_jk-howto.html readme
larryi 01/08/02 10:15:48
Modified: src/doc mod_jk-howto.html readme
Log:
Additions and corrections to documentation
Revision Changes Path
1.12 +30 -9 jakarta-tomcat/src/doc/mod_jk-howto.html
Index: mod_jk-howto.html
===================================================================
RCS file: /home/cvs/jakarta-tomcat/src/doc/mod_jk-howto.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- mod_jk-howto.html 2001/08/02 10:34:08 1.11
+++ mod_jk-howto.html 2001/08/02 17:15:47 1.12
@@ -36,9 +36,9 @@
<!-- Banner element, all hail the Project! -->
<table BORDER=0 CELLSPACING=0 CELLPADDING=0 WIDTH="100%" >
<tr>
-<td ALIGN=LEFT WIDTH="50%"><a href="http://jakarta.apache.org/index.html"><img SRC="banner.gif" ALT="The Jakarta Project" BORDER=0 height=100 width=350></a></td>
+<td ALIGN=LEFT WIDTH="50%"><a href="http://jakarta.apache.org/index.html"><img SRC="images/banner.gif" ALT="The Jakarta Project" BORDER=0 height=100 width=350></a></td>
-<td ALIGN=RIGHT WIDTH="50%"><img SRC="tomcat.gif" ALT="The mighty Tomcat - Meow!" BORDER=0 height=71 width=100></td>
+<td ALIGN=RIGHT WIDTH="50%"><img SRC="images/tomcat.gif" ALT="The mighty Tomcat - Meow!" BORDER=0 height=71 width=100></td>
</tr>
</table>
@@ -551,7 +551,7 @@
</blockquote>
That's it, you can now start Tomcat and Apache and access Tomcat from the
Apache server.
-<p>Note: Settings for mod_jk auto-configuration is new in Tomcat 3.3.
+<p><b>Note:</b> Settings for mod_jk auto-configuration is new in Tomcat 3.3.
Older versions of Tomcat create the auto-config file without a directive
in server.xml. The new directive in Tomcat 3.3 allows for additional
configuration options as detailed later in this section. For older
@@ -575,11 +575,11 @@
by setting options in the <ApacheConfig /> block. The following
details the syntax:
<blockquote>
-<pre>< ContextManager ... >
+<pre>< ContextManager ... >
...
- <ApacheConfig <i>options</i> />
+ <ApacheConfig <i>options</i> />
...
-< /ContextManager ></pre>
+< /ContextManager ></pre>
</blockquote>
where <i>options</i> can include any of the following attributes:
<ul>
@@ -587,7 +587,7 @@
If not set, this defaults to TOMCAT_HOME. Ignored
whenever any of the following paths is absolute.</li>
<li><b>jkConfig</b> - path to use for writing Apache mod_jk conf file. If
- not set, defaults to "conf/jk/mod_jk.conf".</li>
+ not set, defaults to "conf/auto/mod_jk.conf".</li>
<li><b>workersConfig</b> - path to workers.properties file used by
mod_jk. If not set, defaults to "conf/jk/workers.properties".</li>
<li><b>modJk</b> - path to Apache mod_jk plugin file. If not set,
@@ -624,12 +624,33 @@
<blockquote>
<pre>...
-<AutoWebApp dir="webapps" host="DEFAULT" />
+<AutoWebApp dir="webapps" host="DEFAULT" />
-<ApacheConfig confighome="/home/mydir" />
+<ApacheConfig configHome="/home/mydir" />
...</pre>
</blockquote>
+
+<p><b>Note:</b> The default Apache auto-configuration file generated by:
+<blockquote>
+<pre><ApacheConfig /></pre>
+</blockquote>
+differs from the file generated by Tomcat 3.2.x. In Tomcat 3.3, the default
+is to forward all requests to Tomcat for Tomcat's contexts (i.e.
+forwardAll="true"), excluding the root context. This helps insure
+that behavior configured in web.xml files will function properly.
+The configuration that best matches Tomcat 3.2.x behavior is:
+<blockquote>
+<pre><ApacheConfig forwardAll="false" noRoot="false"
+ jkConfig="conf/mod_jk.conf-auto" jkDebug="error" /></pre>
+</blockquote>
+With this configuration, JSP and servlet requests to the root context
+will be served from Tomcat's ROOT webapp. Other requests, such as for static
+files, will be served from Apache's DocumentRoot directory. If Apache's
+DocumentRoot isn't updated to point to Tomcat's ROOT webapp, then the
+root context will malfunction. For example, JSP's that reference ".gif"
+files in Tomcat's ROOT webapp will not be able to display them since
+they won't be found under Apache's DocumentRoot directory.</p>
</div>
<h3>
1.18 +20 -2 jakarta-tomcat/src/doc/readme
Index: readme
===================================================================
RCS file: /home/cvs/jakarta-tomcat/src/doc/readme,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- readme 2001/07/20 18:42:33 1.17
+++ readme 2001/08/02 17:15:47 1.18
@@ -1,4 +1,4 @@
-$Id: readme,v 1.17 2001/07/20 18:42:33 larryi Exp $
+$Id: readme,v 1.18 2001/08/02 17:15:47 larryi Exp $
Release Notes for:
====================
@@ -188,7 +188,7 @@
=============================================================================
-5. NEW FEATURES IN THIS RELEASE
+5. NEW FEATURES AND CHANGES IN THIS RELEASE
Many new features have been added to Tomcat since the 3.2.x release. Among the
most important are:
@@ -208,7 +208,25 @@
See conf/server.xml for more information.
+- The Tomcat documentation directory (i.e. TOMCAT_HOME/doc) is now included
+ in the ROOT webapp and is available from a link in the root's index.html.
+
+- (more to be added)
+
+
+In addition, numerous changes have occured since the 3.2.x release. Among the
+primary changes are:
+
+- The Tomcat Users Guide (i.e. tomcat-ug.html) is now in the TOMCAT_HOME/doc
+ directory instead of the TOMCAT_HOME/doc/uguide directory as it Tomcat 3.2.x.
+
+- The writing of the connector configuration files, such as tomcat-apache.conf
+ is not enabled by default. Each config file may be enabled by modifying the
+ server.xml file. For details, see the information in section 2 of this
+ document or refer to the Tomcat documentation.
+
- (more to be added)
+
=============================================================================
6. KNOWN BUGS AND ISSUES