Author: mturk
Date: Sun Jun 4 02:32:30 2006
New Revision: 411543
URL: http://svn.apache.org/viewvc?rev=411543&view=rev
Log:
Update the docs with recent changes.
Modified:
tomcat/connectors/trunk/jk/xdocs/changelog.xml
tomcat/connectors/trunk/jk/xdocs/config/workers.xml
Modified: tomcat/connectors/trunk/jk/xdocs/changelog.xml
URL:
http://svn.apache.org/viewvc/tomcat/connectors/trunk/jk/xdocs/changelog.xml?rev=411543&r1=411542&r2=411543&view=diff
==============================================================================
--- tomcat/connectors/trunk/jk/xdocs/changelog.xml (original)
+++ tomcat/connectors/trunk/jk/xdocs/changelog.xml Sun Jun 4 02:32:30 2006
@@ -25,6 +25,15 @@
<br />
<subsection name="Native">
<changelog>
+ <update>
+ Renamed cache_timeout firective to connection_pool_timeout. (mturk)
+ </update>
+ <update>
+ Added connection_pool_minsize directive. (mturk)
+ </update>
+ <update>
+ Deprecate recycle_timeout directive. (mturk)
+ </update>
<fix>
<bug>37469</bug>: Fix shared memory close for forked childs.
The shared memory will be closed by the parent process. (mturk)
Modified: tomcat/connectors/trunk/jk/xdocs/config/workers.xml
URL:
http://svn.apache.org/viewvc/tomcat/connectors/trunk/jk/xdocs/config/workers.xml?rev=411543&r1=411542&r2=411543&view=diff
==============================================================================
--- tomcat/connectors/trunk/jk/xdocs/config/workers.xml (original)
+++ tomcat/connectors/trunk/jk/xdocs/config/workers.xml Sun Jun 4 02:32:30 2006
@@ -132,8 +132,8 @@
This directive should be used when you have a firewall between your webserver
and the Tomcat engine, who tend to drop inactive connections. This flag will
told Operating System
to send <code>KEEP_ALIVE</code> message on inactive connections (interval
depend on global OS settings,
-generally 120ms), and thus prevent the firewall to cut the connection.
-To enable keepalive set this property value to the number greater then
<b>0</b>.
+generally 120 minutes), and thus prevent the firewall to cut the connection.
+To enable keepalive set this property value to the <b>True</b>.
<p>
The problem with Firewall cutting inactive connections is that sometimes,
neither webserver or tomcat
have information about the cut and couldn't handle it.
@@ -141,13 +141,7 @@
</directive>
<directive name="recycle_timeout" default="0" required="false">
-The number of seconds that told webserver to cut an ajp13 connection after
some time of
-inactivity. When choosing an endpoint for a request and the assigned socket is
open, it will be
-closed if it was not used for the configured time.
-It's a good way to ensure that there won't too old threads living on Tomcat
side,
-with the extra cost you need to reopen the socket next time a request be
forwarded.
-This property is very similar to <b>cache_timeout</b> but works also in
non-cache mode.
-If set to value zero (default) no recycle will took place.
+<warn>This directive has been deprecated since 1.2.16. See <b>Connection
Poll</b> directives instead</warn>
</directive>
<directive name="retries" default="3" required="false">
@@ -157,12 +151,16 @@
</directive>
<directive name="cachesize" default="1" required="false">
-Cachesize defines the number of connections made to the AJP backend that
+<warn>This directive has been deprecated since 1.2.16. See
<b>connection_pool_size</b> instead</warn>
+</directive>
+
+<directive name="connection_pool_size" default="1" required="false">
+This defines the number of connections made to the AJP backend that
are maintained as a connection pool.
It will limit the number of those connection that each web server child
process can made.
<p>
-Cachesize property is used only for multi threaded
+Connection pool size property is used only for multi threaded
web servers such as Apache 2.0 (worker), IIS and Netscape. The cachesize
property
should reflect the number of threads per child process. JK will discover
the number of threads per child process on Apache 2 web server with worker-mpm
and set
@@ -172,9 +170,21 @@
<warn>Do not use cachesize with values higher then 1 on <b>Apache 2.x
prefork</b> or <b>Apache 1.3.x</b>!</warn>
</directive>
-<directive name="cache_timeout" default="0" required="false">
-Cache timeout property should be used with <b>cachesize</b> to specify how to
time JK should keep
-an open socket in cache before closing it. This property should be used to
reduce the number of threads
+<directive name="connection_pool_minsize" default="pool/2" required="false">
+Minimum size of the connection pool that will be maintained.
+<p>
+This property is used only when the <b>connection_pool_size</b> is specified.
+Its default value is connection_pool_size/2.
+</p>
+<warn>Do not use connection_pool_size with values higher then 1 on <b>Apache
2.x prefork</b> or <b>Apache 1.3.x</b>!</warn>
+<p>
+This feature has been added in <b>jk 1.2.16</b>.
+</p>
+</directive>
+
+<directive name="connection_pool_timeout" default="0" required="false">
+Cache timeout property should be used with <b>connection_pool_size</b> to
specify how long JK should keep
+an incative socket in cache before closing it. This property should be used to
reduce the number of threads
on the Tomcat WebServer.
<p>
Each child could open an ajp13 connection if it have to forward a request to
Tomcat, creating
@@ -186,6 +196,10 @@
to handle high-load, even it the child/thread handle only static contents, you
could
finish having many unused ajp13 threads on the Tomcat side.
</p>.
+</directive>
+
+<directive name="cache_timeout" default="0" required="false">
+<warn>This directive has been deprecated since 1.2.16. See
<b>connection_pool_timeout</b> instead</warn>
</directive>
<directive name="lbfactor" default="1" required="false">
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
