tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: jakarta-tomcat-connectors/jk/xdocs/config workers.xml
Date Tue, 14 Dec 2004 08:48:07 GMT
mturk       2004/12/14 00:48:07

  Modified:    jk/xdocs/config workers.xml
  Explain some default values.
  Revision  Changes    Path
  1.7       +14 -13    jakarta-tomcat-connectors/jk/xdocs/config/workers.xml
  Index: workers.xml
  RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/config/workers.xml,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- workers.xml	13 Dec 2004 09:26:12 -0000	1.6
  +++ workers.xml	14 Dec 2004 08:48:07 -0000	1.7
  @@ -107,13 +107,14 @@
   Port number of the remote Tomcat instance listening for defined protocol requests.
  -<directive name="socket_timeout" default="infinite" required="false">
  +<directive name="socket_timeout" default="0" required="false">
   Socket timeout in seconds used for communication channel between JK and remote host.
   If remote host does not respond inside that timeout the JK will generate an error,
  -and retry again. 
  +and retry again. If set to value zero (default) the JK will wait for infinite
  +on all socket operations.
  -<directive name="socket_keepalive" required="false">
  +<directive name="socket_keepalive" default="False" required="false">
   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
   to send <code>KEEP_ALIVE</code> message on inactive connections (interval depend
on global OS settings,
  @@ -125,13 +126,14 @@
  -<directive name="recycle_timeout" required="false">
  +<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
  +This property is very similar to <b>cache_timeout</b> but works also in non-cache
  +If set to value zero (default) no recycle will took place. 
   <directive name="retries" default="3" required="false">
  @@ -140,13 +142,13 @@
   each retry after default an extra wait of 100ms will be inserted.
  -<directive name="cachesize" default="0" required="false">
  +<directive name="cachesize" default="1" required="false">
   Cachesize property is usefull when you're using JK in multithreaded 
   web servers such as Apache 2.0 (worker), IIS and Netscape. They will benefit the most by

   setting this value to a higher level (such as the estimated average concurrent users for
   If cachesize is not set, the connection cache support is disabled.
   Cachesize determines the minimum number of open connections to backend Tomcat.
  -<warn>Do not use cachesize with <b>prefork mpm</b> or <b>apache
  +<warn>Do not use cachesize with values higer then 1 on <b>prefork mpm</b>
or <b>apache 1.3.x</b>!</warn>
   <directive name="cache_timeout" default="0" required="false">
  @@ -162,7 +164,7 @@
   until killed. And since the webserver will keep its childs/threads running
   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.
   <directive name="lb_factor" default="1" required="false">
  @@ -173,7 +175,6 @@
   that makes the load balancer. For example if one worker has lb_factor 5 times higher then
   other worker, then it will receive five times more requests. 
  @@ -218,7 +219,7 @@
  -<directive name="balance_workers" required="true">
  +<directive name="balance_workers" default="" required="true">
   A comma separated list of workers that the load balancer
   need to manage.
  @@ -242,7 +243,7 @@
   <subsection name="Advanced worker directives">
  -<directive name="connect_timeout" required="false">
  +<directive name="connect_timeout" default="0" required="false">
   Connect timeout property told webserver to send a PING request on ajp13 connection after

   connection is established. The parameter is the delay in milliseconds to wait for the PONG
  @@ -252,7 +253,7 @@
  -<directive name="prepost_timeout" required="false">
  +<directive name="prepost_timeout" default="0" required="false">
   Prepost timeout property told webserver to send a PING request on ajp13 connection before

   forwarding to it a request. The parameter is the delay in milliseconds to wait for the
PONG reply.
  @@ -262,7 +263,7 @@
  -<directive name="reply_timeout" required="false">
  +<directive name="reply_timeout" default="0" required="false">
   Reply_timeout property told webserver to wait some time for reply to a forwarded request
   before considering the remote tomcat is dead and eventually switch to another tomcat in
a cluster
   group. By default webserver will wait forever which could be an issue for you.

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message