Author: rjung Date: Fri Oct 3 12:45:41 2008 New Revision: 701513 URL: http://svn.apache.org/viewvc?rev=701513&view=rev Log: Clarify a bit, how our watchdig thread works and what it does. Keep description for IIS and Apache consistent.
Modified: tomcat/connectors/trunk/jk/xdocs/reference/apache.xml tomcat/connectors/trunk/jk/xdocs/reference/iis.xml Modified: tomcat/connectors/trunk/jk/xdocs/reference/apache.xml URL: http://svn.apache.org/viewvc/tomcat/connectors/trunk/jk/xdocs/reference/apache.xml?rev=701513&r1=701512&r2=701513&view=diff ============================================================================== --- tomcat/connectors/trunk/jk/xdocs/reference/apache.xml (original) +++ tomcat/connectors/trunk/jk/xdocs/reference/apache.xml Fri Oct 3 12:45:41 2008 @@ -196,15 +196,25 @@ </p></attribute> <attribute name="JkWatchdogInterval" required="false"><p> This directive configures the watchdog thread interval in seconds. -The workers are maintained periodically on this interval. -If you set this directive to "0", watchdog thread will not be -created and standard on request maintenance will be applied. +The workers are maintained periodically by a background thread +running periodically every watchdog_interval seconds. Worker maintenance +checks for idle connections, corrects load status and is able +to detect backend health status. +<br/> +The maintenance only happens, if since the last maintenance at +least <a href="workers.html"><code>worker.maintain</code></a> +seconds have passed. So setting the JkWatchdogInterval +much smaller than <code>worker.maintain</code> is not useful. <br/> The default value is 0 seconds, meaning the watchdog thread -will not be created inside each child process. +will not be created, and the maintenance is done in combination +with normal requests instead. +<br/> +This directive is only allowed once. It must be put into +the global part of the configuration. <br/> This directive has been added in version 1.2.27 of mod_jk. -It is available only for httpd 2.0 and above using APR libraries +It is available only for httpd 2.x and above using APR libraries including thread support. </p></attribute> <attribute name="JkLogFile" required="false"><p> @@ -356,7 +366,7 @@ </source> <p> -Since JK 1.2.3 for Apache 2.0 and JK 1.2.16 for Apache 1.3 this can also +Since JK 1.2.3 for Apache 2.x and JK 1.2.16 for Apache 1.3 this can also be used for piped logging: </p> Modified: tomcat/connectors/trunk/jk/xdocs/reference/iis.xml URL: http://svn.apache.org/viewvc/tomcat/connectors/trunk/jk/xdocs/reference/iis.xml?rev=701513&r1=701512&r2=701513&view=diff ============================================================================== --- tomcat/connectors/trunk/jk/xdocs/reference/iis.xml (original) +++ tomcat/connectors/trunk/jk/xdocs/reference/iis.xml Fri Oct 3 12:45:41 2008 @@ -179,6 +179,26 @@ </p> <p>This directive has been added in version 1.2.24</p> </attribute> +<attribute name="watchdog_interval" required="false"><p> +A DWORD value representing the watchdog thread interval in seconds. +The workers are maintained periodically by a background thread +running periodically every watchdog_interval seconds. Worker maintenance +checks for idle connections, corrects load status and is able +to detect backend health status. +</p> +<p> +The maintenance only happens, if since the last maintenance at +least <a href="workers.html"><code>worker.maintain</code></a> +seconds have passed. So setting the watchdog_interval +much smaller than <code>worker.maintain</code> is not useful. +</p> +<p> +The default value is 0 seconds, meaning the watchdog thread +will not be created, and the maintenance is done in combination +with normal requests instead. +</p> +<p>This directive has been added in version 1.2.27</p> +</attribute> </attributes> </section> <section name="Using a properties file for configuration"> --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]