tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mt...@apache.org
Subject svn commit: r411543 - in /tomcat/connectors/trunk/jk/xdocs: changelog.xml config/workers.xml
Date Sun, 04 Jun 2006 09:32:30 GMT
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: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org


Mime
View raw message