Modified: tomcat/site/trunk/docs/connectors-doc/reference/printer/workers.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/reference/printer/workers.html?rev=1850977&r1=1850976&r2=1850977&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/reference/printer/workers.html (original) +++ tomcat/site/trunk/docs/connectors-doc/reference/printer/workers.html Thu Jan 10 20:17:16 2019 @@ -29,7 +29,7 @@ })(window, document); }), false); })(); - </script></head><body><div id="wrapper"><header><div id="header"><div><div><div class="logo noPrint"><a href="http://tomcat.apache.org/";><img alt="Tomcat Home" src="../../images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo noPrint"><a href="https://www.apache.org/"; target="_blank"><img src="../../images/asf-logo.svg" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1>The Apache Tomcat Connectors - Reference Guide</h1><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2>Links</h2><ul><li><a href="../index.html">Docs Home</a></li></ul></div><div><h2>Common HowTo</h2><ul><li><a href="../common_howto/quick.html">For the impatient</a></li><li><a href="../common_howto/workers.html">All about workers</a></li><li><a href="../common_howto/timeouts.html">Timeouts</a></li><li><a href="../common_howto/loadbalancers.h tml">Load Balancing</a></li><li><a href="../common_howto/proxy.html">Reverse Proxy</a></li></ul></div><div><h2>Web Server HowTo</h2><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="../webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul></div><div><h2>Reference Guide</h2><ul><li><a href="../reference/workers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul></div><div><h2>AJP Protocol Reference</h2><ul><li><a href="../ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul></div><div><h2>Miscellane ous Documentation</h2><ul><li><a href="../miscellaneous/faq.html">Frequently asked questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=";>Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribut e documentation</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html";>Old JK/JK2 documentation</a></li></ul></div><div><h2>News</h2><ul><li><a href="../news/20180301.html">2018</a></li><li><a href="../news/20150901.html">2016</a></li><li><a href="../news/20150101.html">2015</a></li><li><a href="../news/20140201.html">2014</a></li><li><a href="../news/20120301.html">2012</a></li><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></div></nav></div></div><div id="mainR ight"><div id="content"><h2>workers.properties configuration</h2><h3 id="Introduction">Introduction</h3><div class="text"> + </script></head><body><div id="wrapper"><header><div id="header"><div><div><div class="logo noPrint"><a href="http://tomcat.apache.org/";><img alt="Tomcat Home" src="../../images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo noPrint"><a href="https://www.apache.org/"; target="_blank"><img src="../../images/asf-logo.svg" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1>The Apache Tomcat Connectors - Reference Guide</h1><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2>Links</h2><ul><li><a href="../index.html">Docs Home</a></li></ul></div><div><h2>Common HowTo</h2><ul><li><a href="../common_howto/quick.html">Quick Start</a></li><li><a href="../common_howto/workers.html">All About Workers</a></li><li><a href="../common_howto/timeouts.html">Timeouts</a></li><li><a href="../common_howto/loadbalancers.html">L oad Balancing</a></li><li><a href="../common_howto/proxy.html">Reverse Proxy</a></li></ul></div><div><h2>Web Server HowTo</h2><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="../webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul></div><div><h2>Reference Guide</h2><ul><li><a href="../reference/workers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul></div><div><h2>AJP Protocol Reference</h2><ul><li><a href="../ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul></div><div><h2>Miscellaneous Do cumentation</h2><ul><li><a href="../miscellaneous/faq.html">Frequently Asked Questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=";>Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute docu mentation</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html";>Old JK/JK2 documentation</a></li></ul></div><div><h2>News</h2><ul><li><a href="../news/20180301.html">2018</a></li><li><a href="../news/20150901.html">2016</a></li><li><a href="../news/20150101.html">2015</a></li><li><a href="../news/20140201.html">2014</a></li><li><a href="../news/20120301.html">2012</a></li><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></div></nav></div></div><div id="mainRight"> <div id="content"><h2>workers.properties configuration</h2><h3 id="Introduction">Introduction</h3><div class="text"> <p> A <b>Tomcat worker</b> is a Tomcat instance that is waiting to execute servlets or any other content on behalf of some web server. For example, we can have a web server such as @@ -763,8 +763,7 @@ used directly via the workers.list, <b>L and <b>SUB</b> for the workers used indirectly in a load balancer worker as a sub worker or member. </p> -<advanceddirectives> -<directive name="connect_timeout" workers="AJP,SUB" default="0" required="false"> +<table class="defaultTable"><tr><th style="width: 10%;"><font color="#ffffff">Directive</font></th><th style="width: 10%;"><font color="#ffffff">Worker Type</font></th><th style="width: 8%;"><font color="#ffffff">Default</font></th><th style="width: 72%;"><font color="#ffffff">Description</font></th></tr><tr><td><code class="attributeName">connect_timeout</code></td><td><code>AJP,SUB</code></td><td><code>0</code></td><td> Connect timeout property told web server to send a PING request on ajp13 connection after connection is established. The parameter is the delay in milliseconds to wait for the PONG reply. The default value zero disables the timeout (infinite timeout). @@ -773,9 +772,7 @@ This features has been added in <b>jk 1. ping/pong support which has been implemented on Tomcat <b>3.3.2+, 4.1.28+ and 5.0.13+</b>. Disabled by default. </p> -</directive> - -<directive name="prepost_timeout" workers="AJP,SUB" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">prepost_timeout</code></td><td><code>AJP,SUB</code></td><td><code>0</code></td><td> Prepost timeout property told web server 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. The default value zero disables the timeout (infinite timeout). @@ -784,9 +781,7 @@ This features has been added in <b>jk 1. ping/pong support which has been implemented on <b>Tomcat 3.3.2+, 4.1.28+ and 5.0.13+</b>. Disabled by default. </p> -</directive> - -<directive name="reply_timeout" workers="AJP,SUB" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">reply_timeout</code></td><td><code>AJP,SUB</code></td><td><code>0</code></td><td> The parameter is the number of milliseconds to wait for success during a read event. So this is not a timeout for the complete answer time of a request, but only for the maximum time between two packets received from Tomcat. Usually the longest @@ -813,9 +808,7 @@ works on all servlet engines supporting The variable <b>JK_REPLY_TIMEOUT</b> and the worker map extension have been added in version <b>1.2.27</b>. </p> -</directive> - -<directive name="retries" workers="AJP,SUB" default="2" required="false"> +</td></tr><tr><td><code class="attributeName">retries</code></td><td><code>AJP,SUB</code></td><td><code>2</code></td><td> <warn>This directive also exists for load balancer workers. For those it has a <a href="#Load Balancing Directives">different meaning</a>.</warn> The maximum number of times that the worker will send a request to Tomcat @@ -830,16 +823,12 @@ of retries and <b>retry_interval</b> for <p> Until version <b>1.2.16</b> the default value was 3. </p> -</directive> - -<directive name="retry_interval" workers="AJP,SUB" default="100" required="false"> +</td></tr><tr><td><code class="attributeName">retry_interval</code></td><td><code>AJP,SUB</code></td><td><code>100</code></td><td> The amount of time in milliseconds the worker sleeps before doing any retry. <p> This features has been added in <b>jk 1.2.27</b>. </p> -</directive> - -<directive name="recovery_options" workers="AJP,SUB" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">recovery_options</code></td><td><code>AJP,SUB</code></td><td><code>0</code></td><td> Recovery options influence, how we should handle retries, in case we detect a problem with Tomcat. How often we will retry is controlled by the attribute <b>retries</b>. @@ -857,9 +846,7 @@ This features has been added in <b>jk 1. Option 4 has been added in version <b>1.2.16</b>, options 8 and 16 in version <b>1.2.24</b>. </p> -</directive> - -<directive name="fail_on_status" workers="AJP,SUB" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">fail_on_status</code></td><td><code>AJP,SUB</code></td><td><code>0</code></td><td> Set this value to the HTTP status code that will cause a worker to fail if returned from Servlet container. Use this directive to deal with cases when the servlet container can temporary return non-200 responses @@ -887,9 +874,7 @@ fail_on_status. This feature gets enable front of those status codes. For example: <code>worker.xxx.fail_on_status=-404,-500,503</code> </p> -</directive> - -<directive name="busy_limit" workers="AJP,SUB" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">busy_limit</code></td><td><code>AJP,SUB</code></td><td><code>0</code></td><td> If set to a positive number, the worker will only be used for a request, if it is currently working on less than this number of concurrent requests. <p> @@ -899,9 +884,7 @@ Note that this is not related to the <b> <p> This feature is experimental and has been added in <b>jk 1.2.41</b>. </p> -</directive> - -<directive name="max_packet_size" workers="AJP,SUB" default="8192" required="false"> +</td></tr><tr><td><code class="attributeName">max_packet_size</code></td><td><code>AJP,SUB</code></td><td><code>8192</code></td><td> This attribute sets the maximal AJP packet size in Bytes. It should be a multiple of 1024. Configuration values that are not a multiple of 1024 will be aligned to the next multiple of 1024. The maximum value is 65536. If you change @@ -916,9 +899,7 @@ certificate chains. <p> This feature has been added in <b>jk 1.2.19</b>. </p> -</directive> - -<directive name="prefer_ipv6" workers="AJP,SUB" default="false" required="false"> +</td></tr><tr><td><code class="attributeName">prefer_ipv6</code></td><td><code>AJP,SUB</code></td><td><code>false</code></td><td> When compiled with IPV6 support, this directive forces IPV6 address resolution for host names which have both IPV6 and IPV4 addresses. In case there is no IPV6 address defined for the given hostname this directive in ineffective. This directive will @@ -927,9 +908,7 @@ either in IPV4 or IPV6 notation. <p> This feature has been added in <b>jk 1.2.38</b>. </p> -</directive> - -<directive name="secret" workers="AJP,SUB,LB" default="" required="false"> +</td></tr><tr><td><code class="attributeName">secret</code></td><td><code>AJP,SUB,LB</code></td><td><code>-</code></td><td> You can set a secret keyword on the Tomcat AJP Connector. Then only requests from workers with the same secret keyword will be accepted. <p> @@ -943,17 +922,13 @@ If you set a secret on a load balancer, <p> This feature has been added in <b>jk 1.2.12</b>. </p> -</directive> - -<directive name="mount" workers="AJP,LB" default="" required="false"> +</td></tr><tr><td><code class="attributeName">mount</code></td><td><code>AJP,LB</code></td><td><code>-</code></td><td> Space delimited list of uri maps the worker should handle. It is only used, if the worker is included in worker.list. <p> This directive can be used multiple times for the same worker. </p> -</directive> - -<directive name="max_reply_timeouts" workers="LB" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">max_reply_timeouts</code></td><td><code>LB</code></td><td><code>0</code></td><td> If you use a <b>reply_timeout</b> for the members of a load balancer worker, and you want to tolerate a few requests taking longer than reply_timeout, you can set this attribute to some positive value. @@ -969,9 +944,7 @@ seconds). This features has been added in <b>jk 1.2.24</b> to make <b>reply_timeout</b> less sensitive for sporadic long running requests. </p> -</directive> - -<directive name="recover_time" workers="LB" default="60" required="false"> +</td></tr><tr><td><code class="attributeName">recover_time</code></td><td><code>LB</code></td><td><code>60</code></td><td> The recover time is the time in seconds the load balancer will not try to use a worker, after it went into error state. Only after this time has passed, a worker in error state will be marked as in recovering, so that it will be @@ -985,9 +958,7 @@ runs of global maintenance is controlled Do not set recover_time to a very short time unless you understand the implications. Every recovery attempt for a worker in error is done by a real request! </p> -</directive> - -<directive name="error_escalation_time" workers="LB" default="recover_time / 2" required="false"> +</td></tr><tr><td><code class="attributeName">error_escalation_time</code></td><td><code>LB</code></td><td><code>recover_time / 2</code></td><td> Setting a member of a load balancer into an error state is quite serious. E.g. it means that if you need stickyness, all access to the sessions of the respective node is blocked. @@ -1001,26 +972,20 @@ will the node be put into error state. <p> This features has been added in <b>jk 1.2.28</b>. </p> -</directive> - -<directive name="session_cookie" workers="LB" default="JSESSIONID" required="false"> +</td></tr><tr><td><code class="attributeName">session_cookie</code></td><td><code>LB</code></td><td><code>JSESSIONID</code></td><td> The name of the cookie that contains the routing identifier needed for session stickyness. The routing identifier is everything after a "." character in the value of the cookie. <p> This feature has been added in <b>jk 1.2.27</b>. </p> -</directive> - -<directive name="session_path" workers="LB" default=";jsessionid" required="false"> +</td></tr><tr><td><code class="attributeName">session_path</code></td><td><code>LB</code></td><td><code>;jsessionid</code></td><td> The name of the path parameter that contains the routing identifier needed for session stickyness. The routing identifier is everything after a "." character in the value of the path parameter. <p> This feature has been added in <b>jk 1.2.27</b>. </p> -</directive> - -<directive name="set_session_cookie" workers="LB" default="false" required="false"> +</td></tr><tr><td><code class="attributeName">set_session_cookie</code></td><td><code>LB</code></td><td><code>false</code></td><td> Activates generation of session stickyness cookies. Typically you don't need this. <p> Some web frameworks replace Tomcat session management and use a different way @@ -1043,18 +1008,14 @@ we will send a new cookie to switch stic <p> This feature has been added in <b>jk 1.2.38</b>. </p> -</directive> - -<directive name="session_cookie_path" workers="LB" default="" required="false"> +</td></tr><tr><td><code class="attributeName">session_cookie_path</code></td><td><code>LB</code></td><td><code>-</code></td><td> This attribute is only used if "set_session_cookie" is set to <b>true</b>. See "set_session_cookie" for a description. If the value of "session_cookie_path" is empty (default), then the send cookie will not contain a PATH information. <p> This feature has been added in <b>jk 1.2.38</b>. </p> -</directive> - -<directive name="activation" workers="SUB" default="Active" required="false"> +</td></tr><tr><td><code class="attributeName">activation</code></td><td><code>SUB</code></td><td><code>Active</code></td><td> Using this directive, a balanced worker of a load balancer can be configured as disabled or stopped. A disabled worker only gets requests, which belong to sessions for that worker. A stopped @@ -1071,9 +1032,7 @@ This flag can be changed at runtime usin <p> This feature has been added in <b>jk 1.2.19</b>. </p> -</directive> - -<directive name="route" workers="SUB" default="worker name" required="false"> +</td></tr><tr><td><code class="attributeName">route</code></td><td><code>SUB</code></td><td><code>worker name</code></td><td> Normally the name of a balanced worker in a load balancer is equal to the jvmRoute of the corresponding Tomcat instance. If you want to include a worker corresponding to a Tomcat instance into several load balancers with different balancing configuration @@ -1097,9 +1056,7 @@ This feature has been added in <b>jk 1.2 The automatic domain rule has been added in <b>jk 1.2.20</b>.<br> The attribute has been renamed from jvm_route to route in <b>jk 1.2.20</b>. </p> -</directive> - -<directive name="distance" workers="SUB" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">distance</code></td><td><code>SUB</code></td><td><code>0</code></td><td> An integer number to express preferences between the balanced workers of an lb worker. A load balancer will never choose some balanced worker @@ -1111,9 +1068,7 @@ workers of a larger distance are eligibl <p> This feature has been added in <b>jk 1.2.16</b>. </p> -</directive> - -<directive name="domain" workers="SUB" default="" required="false"> +</td></tr><tr><td><code class="attributeName">domain</code></td><td><code>SUB</code></td><td><code>-</code></td><td> Domain directive can be used only when the worker is a member of the load balancer. Workers that share the same domain name are treated as single worker. If sticky_session is used, then the domain name is used as session route. @@ -1125,9 +1080,7 @@ transfer between them. <p> This feature has been added in <b>jk 1.2.8</b>. </p> -</directive> - -<directive name="redirect" workers="SUB" default="" required="false"> +</td></tr><tr><td><code class="attributeName">redirect</code></td><td><code>SUB</code></td><td><code>-</code></td><td> Set to the name of the preferred failover worker. If worker matching SESSION ID is in error state then the redirect worker will be used instead. It will be used even if being disabled, thus offering hot standby. @@ -1138,9 +1091,7 @@ to this route of the preferred failover <p> This feature has been added in <b>jk 1.2.9</b>. </p> -</directive> - -</advanceddirectives> +</td></tr></table> </div></div> <div class="subsection"><h4 id="Deprecated_Worker_Directives">Deprecated Worker Directives</h4><div class="text"> @@ -1148,8 +1099,7 @@ This feature has been added in <b>jk 1.2 in case you need to use an older version of mod_jk. We urge you to update and not use them any more. Please migrate your existing configurations. </p> -<deprecations> -<directive name="cachesize" successor="connection_pool_size" default="see text" required="false"> +<table class="defaultTable"><tr><th style="width: 15%;"><font color="#ffffff">Directive</font></th><th style="width: 15%;"><font color="#ffffff">Successor</font></th><th style="width: 10%;"><font color="#ffffff">Default</font></th><th style="width: 60%;"><font color="#ffffff">Description</font></th></tr><tr><td><code class="attributeName">cachesize</code></td><td><code>connection_pool_size</code></td><td><code>see text</code></td><td> <warn>This directive has been deprecated since 1.2.16.</warn> Cachesize defines the number of connections made to the AJP backend that are maintained as a connection pool. @@ -1164,9 +1114,7 @@ its default value to match the current T value is 10. For web servers other than Apache or IIS this value has to be set manually. </p> <warn>Do not use cachesize with values higher then 1 on <b>Apache 2.x with prefork MPM</b> or <b>Apache 1.3.x</b>!</warn> -</directive> - -<directive name="cache_timeout" successor="connection_pool_timeout" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">cache_timeout</code></td><td><code>connection_pool_timeout</code></td><td><code>0</code></td><td> <warn>This directive has been deprecated since 1.2.16.</warn> 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 @@ -1181,9 +1129,7 @@ until killed. And since the web server w 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="recycle_timeout" successor="connection_pool_timeout" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">recycle_timeout</code></td><td><code>connection_pool_timeout</code></td><td><code>0</code></td><td> <warn>This directive has been deprecated since 1.2.16.</warn> The number of seconds that told web server 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 @@ -1192,24 +1138,18 @@ It's a good way to ensure that there won 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. -</directive> - -<directive name="balanced_workers" successor="balance_workers" default="" required="true"> +</td></tr><tr><td><code class="attributeName">balanced_workers</code></td><td><code>balance_workers</code></td><td><code>-</code></td><td> <warn>This directive has been deprecated since 1.2.7.</warn> A comma separated list of workers that the load balancer need to manage. -</directive> - -<directive name="disabled" successor="activation" default="false" required="false"> +</td></tr><tr><td><code class="attributeName">disabled</code></td><td><code>activation</code></td><td><code>false</code></td><td> <warn>This directive has been deprecated since 1.2.19.</warn> If set to <b>true</b> the worker will be disabled if member of load balancer. This flag can be changed at runtime using status worker. <p> This feature has been added in <b>jk 1.2.9</b>. </p> -</directive> - -<directive name="stopped" successor="activation" default="false" required="false"> +</td></tr><tr><td><code class="attributeName">stopped</code></td><td><code>activation</code></td><td><code>false</code></td><td> <warn>This directive has been deprecated since 1.2.19.</warn> If set to <b>true</b> the worker will be stopped if member of load balancer. The flag is needed for stop complete traffic of a sticky session @@ -1218,9 +1158,7 @@ This flag can be changed at runtime usin <p> This feature has been added in <b>jk 1.2.11</b>. </p> -</directive> - -<directive name="jvm_route" successor="route" default="worker name" required="false"> +</td></tr><tr><td><code class="attributeName">jvm_route</code></td><td><code>route</code></td><td><code>worker name</code></td><td> <warn>This directive has been deprecated since 1.2.20.</warn> Normally the name of a balanced worker in a load balancer is equal to the jvmRoute of the corresponding Tomcat instance. If you want to include a worker corresponding @@ -1239,9 +1177,7 @@ This attribute can be changed at runtime <p> This feature has been added in <b>jk 1.2.16</b>. </p> -</directive> - -</deprecations> +</td></tr></table> </div></div> </div><div class="noprint"><h3 id="comments_section">
Modified: tomcat/site/trunk/docs/connectors-doc/reference/status.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/reference/status.html?rev=1850977&r1=1850976&r2=1850977&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/reference/status.html (original) +++ tomcat/site/trunk/docs/connectors-doc/reference/status.html Thu Jan 10 20:17:16 2019 @@ -29,7 +29,7 @@ })(window, document); }), false); })(); - </script></head><body><div id="wrapper"><header><div id="header"><div><div><div class="logo noPrint"><a href="http://tomcat.apache.org/";><img alt="Tomcat Home" src="../images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo noPrint"><a href="https://www.apache.org/"; target="_blank"><img src="../images/asf-logo.svg" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1>The Apache Tomcat Connectors - Reference Guide</h1><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2>Links</h2><ul><li><a href="../index.html">Docs Home</a></li></ul></div><div><h2>Common HowTo</h2><ul><li><a href="../common_howto/quick.html">For the impatient</a></li><li><a href="../common_howto/workers.html">All about workers</a></li><li><a href="../common_howto/timeouts.html">Timeouts</a></li><li><a href="../common_howto/loadbalancers.html">L oad Balancing</a></li><li><a href="../common_howto/proxy.html">Reverse Proxy</a></li></ul></div><div><h2>Web Server HowTo</h2><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="../webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul></div><div><h2>Reference Guide</h2><ul><li><a href="../reference/workers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul></div><div><h2>AJP Protocol Reference</h2><ul><li><a href="../ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul></div><div><h2>Miscellaneous Do cumentation</h2><ul><li><a href="../miscellaneous/faq.html">Frequently asked questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=";>Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute docu mentation</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html";>Old JK/JK2 documentation</a></li></ul></div><div><h2>News</h2><ul><li><a href="../news/20180301.html">2018</a></li><li><a href="../news/20150901.html">2016</a></li><li><a href="../news/20150101.html">2015</a></li><li><a href="../news/20140201.html">2014</a></li><li><a href="../news/20120301.html">2012</a></li><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></div></nav></div></div><div id="mainRight"> <div id="content"><h2>Status Worker Reference</h2><h3 id="Introduction">Introduction</h3><div class="text"> + </script></head><body><div id="wrapper"><header><div id="header"><div><div><div class="logo noPrint"><a href="http://tomcat.apache.org/";><img alt="Tomcat Home" src="../images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo noPrint"><a href="https://www.apache.org/"; target="_blank"><img src="../images/asf-logo.svg" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1>The Apache Tomcat Connectors - Reference Guide</h1><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2>Links</h2><ul><li><a href="../index.html">Docs Home</a></li></ul></div><div><h2>Common HowTo</h2><ul><li><a href="../common_howto/quick.html">Quick Start</a></li><li><a href="../common_howto/workers.html">All About Workers</a></li><li><a href="../common_howto/timeouts.html">Timeouts</a></li><li><a href="../common_howto/loadbalancers.html">Load Ba lancing</a></li><li><a href="../common_howto/proxy.html">Reverse Proxy</a></li></ul></div><div><h2>Web Server HowTo</h2><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="../webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul></div><div><h2>Reference Guide</h2><ul><li><a href="../reference/workers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul></div><div><h2>AJP Protocol Reference</h2><ul><li><a href="../ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul></div><div><h2>Miscellaneous Document ation</h2><ul><li><a href="../miscellaneous/faq.html">Frequently Asked Questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=";>Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute documentat ion</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html";>Old JK/JK2 documentation</a></li></ul></div><div><h2>News</h2><ul><li><a href="../news/20180301.html">2018</a></li><li><a href="../news/20150901.html">2016</a></li><li><a href="../news/20150101.html">2015</a></li><li><a href="../news/20140201.html">2014</a></li><li><a href="../news/20120301.html">2012</a></li><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></div></nav></div></div><div id="mainRight"><div i d="content"><h2>Status Worker Reference</h2><h3 id="Introduction">Introduction</h3><div class="text"> <p> Tomcat Connectors has a special type of worker, the so-called status worker. The status worker does not forward requests to Tomcat instances. Instead it allows Modified: tomcat/site/trunk/docs/connectors-doc/reference/uriworkermap.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/reference/uriworkermap.html?rev=1850977&r1=1850976&r2=1850977&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/reference/uriworkermap.html (original) +++ tomcat/site/trunk/docs/connectors-doc/reference/uriworkermap.html Thu Jan 10 20:17:16 2019 @@ -29,7 +29,7 @@ })(window, document); }), false); })(); - </script></head><body><div id="wrapper"><header><div id="header"><div><div><div class="logo noPrint"><a href="http://tomcat.apache.org/";><img alt="Tomcat Home" src="../images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo noPrint"><a href="https://www.apache.org/"; target="_blank"><img src="../images/asf-logo.svg" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1>The Apache Tomcat Connectors - Reference Guide</h1><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2>Links</h2><ul><li><a href="../index.html">Docs Home</a></li></ul></div><div><h2>Common HowTo</h2><ul><li><a href="../common_howto/quick.html">For the impatient</a></li><li><a href="../common_howto/workers.html">All about workers</a></li><li><a href="../common_howto/timeouts.html">Timeouts</a></li><li><a href="../common_howto/loadbalancers.html">L oad Balancing</a></li><li><a href="../common_howto/proxy.html">Reverse Proxy</a></li></ul></div><div><h2>Web Server HowTo</h2><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="../webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul></div><div><h2>Reference Guide</h2><ul><li><a href="../reference/workers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul></div><div><h2>AJP Protocol Reference</h2><ul><li><a href="../ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul></div><div><h2>Miscellaneous Do cumentation</h2><ul><li><a href="../miscellaneous/faq.html">Frequently asked questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=";>Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute docu mentation</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html";>Old JK/JK2 documentation</a></li></ul></div><div><h2>News</h2><ul><li><a href="../news/20180301.html">2018</a></li><li><a href="../news/20150901.html">2016</a></li><li><a href="../news/20150101.html">2015</a></li><li><a href="../news/20140201.html">2014</a></li><li><a href="../news/20120301.html">2012</a></li><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></div></nav></div></div><div id="mainRight"> <div id="content"><h2>uriworkermap.properties configuration</h2><h3 id="Introduction">Introduction</h3><div class="text"> + </script></head><body><div id="wrapper"><header><div id="header"><div><div><div class="logo noPrint"><a href="http://tomcat.apache.org/";><img alt="Tomcat Home" src="../images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo noPrint"><a href="https://www.apache.org/"; target="_blank"><img src="../images/asf-logo.svg" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1>The Apache Tomcat Connectors - Reference Guide</h1><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2>Links</h2><ul><li><a href="../index.html">Docs Home</a></li></ul></div><div><h2>Common HowTo</h2><ul><li><a href="../common_howto/quick.html">Quick Start</a></li><li><a href="../common_howto/workers.html">All About Workers</a></li><li><a href="../common_howto/timeouts.html">Timeouts</a></li><li><a href="../common_howto/loadbalancers.html">Load Ba lancing</a></li><li><a href="../common_howto/proxy.html">Reverse Proxy</a></li></ul></div><div><h2>Web Server HowTo</h2><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="../webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul></div><div><h2>Reference Guide</h2><ul><li><a href="../reference/workers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul></div><div><h2>AJP Protocol Reference</h2><ul><li><a href="../ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul></div><div><h2>Miscellaneous Document ation</h2><ul><li><a href="../miscellaneous/faq.html">Frequently Asked Questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=";>Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute documentat ion</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html";>Old JK/JK2 documentation</a></li></ul></div><div><h2>News</h2><ul><li><a href="../news/20180301.html">2018</a></li><li><a href="../news/20150901.html">2016</a></li><li><a href="../news/20150101.html">2015</a></li><li><a href="../news/20140201.html">2014</a></li><li><a href="../news/20120301.html">2012</a></li><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></div></nav></div></div><div id="mainRight"><div i d="content"><h2>uriworkermap.properties configuration</h2><h3 id="Introduction">Introduction</h3><div class="text"> <p> The forwarding of requests from the web server to tomcat gets configured by defining mapping rules. Such a rule maps requests to workers. The request part of the map is described by a URI pattern, Modified: tomcat/site/trunk/docs/connectors-doc/reference/workers.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/reference/workers.html?rev=1850977&r1=1850976&r2=1850977&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/reference/workers.html (original) +++ tomcat/site/trunk/docs/connectors-doc/reference/workers.html Thu Jan 10 20:17:16 2019 @@ -29,7 +29,7 @@ })(window, document); }), false); })(); - </script></head><body><div id="wrapper"><header><div id="header"><div><div><div class="logo noPrint"><a href="http://tomcat.apache.org/";><img alt="Tomcat Home" src="../images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo noPrint"><a href="https://www.apache.org/"; target="_blank"><img src="../images/asf-logo.svg" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1>The Apache Tomcat Connectors - Reference Guide</h1><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2>Links</h2><ul><li><a href="../index.html">Docs Home</a></li></ul></div><div><h2>Common HowTo</h2><ul><li><a href="../common_howto/quick.html">For the impatient</a></li><li><a href="../common_howto/workers.html">All about workers</a></li><li><a href="../common_howto/timeouts.html">Timeouts</a></li><li><a href="../common_howto/loadbalancers.html">L oad Balancing</a></li><li><a href="../common_howto/proxy.html">Reverse Proxy</a></li></ul></div><div><h2>Web Server HowTo</h2><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="../webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul></div><div><h2>Reference Guide</h2><ul><li><a href="../reference/workers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul></div><div><h2>AJP Protocol Reference</h2><ul><li><a href="../ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul></div><div><h2>Miscellaneous Do cumentation</h2><ul><li><a href="../miscellaneous/faq.html">Frequently asked questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=";>Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute docu mentation</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html";>Old JK/JK2 documentation</a></li></ul></div><div><h2>News</h2><ul><li><a href="../news/20180301.html">2018</a></li><li><a href="../news/20150901.html">2016</a></li><li><a href="../news/20150101.html">2015</a></li><li><a href="../news/20140201.html">2014</a></li><li><a href="../news/20120301.html">2012</a></li><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></div></nav></div></div><div id="mainRight"> <div id="content"><h2>workers.properties configuration</h2><h3 id="Introduction">Introduction</h3><div class="text"> + </script></head><body><div id="wrapper"><header><div id="header"><div><div><div class="logo noPrint"><a href="http://tomcat.apache.org/";><img alt="Tomcat Home" src="../images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo noPrint"><a href="https://www.apache.org/"; target="_blank"><img src="../images/asf-logo.svg" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1>The Apache Tomcat Connectors - Reference Guide</h1><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2>Links</h2><ul><li><a href="../index.html">Docs Home</a></li></ul></div><div><h2>Common HowTo</h2><ul><li><a href="../common_howto/quick.html">Quick Start</a></li><li><a href="../common_howto/workers.html">All About Workers</a></li><li><a href="../common_howto/timeouts.html">Timeouts</a></li><li><a href="../common_howto/loadbalancers.html">Load Ba lancing</a></li><li><a href="../common_howto/proxy.html">Reverse Proxy</a></li></ul></div><div><h2>Web Server HowTo</h2><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="../webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul></div><div><h2>Reference Guide</h2><ul><li><a href="../reference/workers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul></div><div><h2>AJP Protocol Reference</h2><ul><li><a href="../ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul></div><div><h2>Miscellaneous Document ation</h2><ul><li><a href="../miscellaneous/faq.html">Frequently Asked Questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=";>Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute documentat ion</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html";>Old JK/JK2 documentation</a></li></ul></div><div><h2>News</h2><ul><li><a href="../news/20180301.html">2018</a></li><li><a href="../news/20150901.html">2016</a></li><li><a href="../news/20150101.html">2015</a></li><li><a href="../news/20140201.html">2014</a></li><li><a href="../news/20120301.html">2012</a></li><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></div></nav></div></div><div id="mainRight"><div i d="content"><h2>workers.properties configuration</h2><h3 id="Introduction">Introduction</h3><div class="text"> <p> A <b>Tomcat worker</b> is a Tomcat instance that is waiting to execute servlets or any other content on behalf of some web server. For example, we can have a web server such as @@ -763,8 +763,7 @@ used directly via the workers.list, <b>L and <b>SUB</b> for the workers used indirectly in a load balancer worker as a sub worker or member. </p> -<advanceddirectives> -<directive name="connect_timeout" workers="AJP,SUB" default="0" required="false"> +<table class="defaultTable"><tr><th style="width: 10%;"><font color="#ffffff">Directive</font></th><th style="width: 10%;"><font color="#ffffff">Worker Type</font></th><th style="width: 8%;"><font color="#ffffff">Default</font></th><th style="width: 72%;"><font color="#ffffff">Description</font></th></tr><tr><td><code class="attributeName">connect_timeout</code></td><td><code>AJP,SUB</code></td><td><code>0</code></td><td> Connect timeout property told web server to send a PING request on ajp13 connection after connection is established. The parameter is the delay in milliseconds to wait for the PONG reply. The default value zero disables the timeout (infinite timeout). @@ -773,9 +772,7 @@ This features has been added in <b>jk 1. ping/pong support which has been implemented on Tomcat <b>3.3.2+, 4.1.28+ and 5.0.13+</b>. Disabled by default. </p> -</directive> - -<directive name="prepost_timeout" workers="AJP,SUB" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">prepost_timeout</code></td><td><code>AJP,SUB</code></td><td><code>0</code></td><td> Prepost timeout property told web server 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. The default value zero disables the timeout (infinite timeout). @@ -784,9 +781,7 @@ This features has been added in <b>jk 1. ping/pong support which has been implemented on <b>Tomcat 3.3.2+, 4.1.28+ and 5.0.13+</b>. Disabled by default. </p> -</directive> - -<directive name="reply_timeout" workers="AJP,SUB" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">reply_timeout</code></td><td><code>AJP,SUB</code></td><td><code>0</code></td><td> The parameter is the number of milliseconds to wait for success during a read event. So this is not a timeout for the complete answer time of a request, but only for the maximum time between two packets received from Tomcat. Usually the longest @@ -813,9 +808,7 @@ works on all servlet engines supporting The variable <b>JK_REPLY_TIMEOUT</b> and the worker map extension have been added in version <b>1.2.27</b>. </p> -</directive> - -<directive name="retries" workers="AJP,SUB" default="2" required="false"> +</td></tr><tr><td><code class="attributeName">retries</code></td><td><code>AJP,SUB</code></td><td><code>2</code></td><td> <warn>This directive also exists for load balancer workers. For those it has a <a href="#Load Balancing Directives">different meaning</a>.</warn> The maximum number of times that the worker will send a request to Tomcat @@ -830,16 +823,12 @@ of retries and <b>retry_interval</b> for <p> Until version <b>1.2.16</b> the default value was 3. </p> -</directive> - -<directive name="retry_interval" workers="AJP,SUB" default="100" required="false"> +</td></tr><tr><td><code class="attributeName">retry_interval</code></td><td><code>AJP,SUB</code></td><td><code>100</code></td><td> The amount of time in milliseconds the worker sleeps before doing any retry. <p> This features has been added in <b>jk 1.2.27</b>. </p> -</directive> - -<directive name="recovery_options" workers="AJP,SUB" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">recovery_options</code></td><td><code>AJP,SUB</code></td><td><code>0</code></td><td> Recovery options influence, how we should handle retries, in case we detect a problem with Tomcat. How often we will retry is controlled by the attribute <b>retries</b>. @@ -857,9 +846,7 @@ This features has been added in <b>jk 1. Option 4 has been added in version <b>1.2.16</b>, options 8 and 16 in version <b>1.2.24</b>. </p> -</directive> - -<directive name="fail_on_status" workers="AJP,SUB" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">fail_on_status</code></td><td><code>AJP,SUB</code></td><td><code>0</code></td><td> Set this value to the HTTP status code that will cause a worker to fail if returned from Servlet container. Use this directive to deal with cases when the servlet container can temporary return non-200 responses @@ -887,9 +874,7 @@ fail_on_status. This feature gets enable front of those status codes. For example: <code>worker.xxx.fail_on_status=-404,-500,503</code> </p> -</directive> - -<directive name="busy_limit" workers="AJP,SUB" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">busy_limit</code></td><td><code>AJP,SUB</code></td><td><code>0</code></td><td> If set to a positive number, the worker will only be used for a request, if it is currently working on less than this number of concurrent requests. <p> @@ -899,9 +884,7 @@ Note that this is not related to the <b> <p> This feature is experimental and has been added in <b>jk 1.2.41</b>. </p> -</directive> - -<directive name="max_packet_size" workers="AJP,SUB" default="8192" required="false"> +</td></tr><tr><td><code class="attributeName">max_packet_size</code></td><td><code>AJP,SUB</code></td><td><code>8192</code></td><td> This attribute sets the maximal AJP packet size in Bytes. It should be a multiple of 1024. Configuration values that are not a multiple of 1024 will be aligned to the next multiple of 1024. The maximum value is 65536. If you change @@ -916,9 +899,7 @@ certificate chains. <p> This feature has been added in <b>jk 1.2.19</b>. </p> -</directive> - -<directive name="prefer_ipv6" workers="AJP,SUB" default="false" required="false"> +</td></tr><tr><td><code class="attributeName">prefer_ipv6</code></td><td><code>AJP,SUB</code></td><td><code>false</code></td><td> When compiled with IPV6 support, this directive forces IPV6 address resolution for host names which have both IPV6 and IPV4 addresses. In case there is no IPV6 address defined for the given hostname this directive in ineffective. This directive will @@ -927,9 +908,7 @@ either in IPV4 or IPV6 notation. <p> This feature has been added in <b>jk 1.2.38</b>. </p> -</directive> - -<directive name="secret" workers="AJP,SUB,LB" default="" required="false"> +</td></tr><tr><td><code class="attributeName">secret</code></td><td><code>AJP,SUB,LB</code></td><td><code>-</code></td><td> You can set a secret keyword on the Tomcat AJP Connector. Then only requests from workers with the same secret keyword will be accepted. <p> @@ -943,17 +922,13 @@ If you set a secret on a load balancer, <p> This feature has been added in <b>jk 1.2.12</b>. </p> -</directive> - -<directive name="mount" workers="AJP,LB" default="" required="false"> +</td></tr><tr><td><code class="attributeName">mount</code></td><td><code>AJP,LB</code></td><td><code>-</code></td><td> Space delimited list of uri maps the worker should handle. It is only used, if the worker is included in worker.list. <p> This directive can be used multiple times for the same worker. </p> -</directive> - -<directive name="max_reply_timeouts" workers="LB" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">max_reply_timeouts</code></td><td><code>LB</code></td><td><code>0</code></td><td> If you use a <b>reply_timeout</b> for the members of a load balancer worker, and you want to tolerate a few requests taking longer than reply_timeout, you can set this attribute to some positive value. @@ -969,9 +944,7 @@ seconds). This features has been added in <b>jk 1.2.24</b> to make <b>reply_timeout</b> less sensitive for sporadic long running requests. </p> -</directive> - -<directive name="recover_time" workers="LB" default="60" required="false"> +</td></tr><tr><td><code class="attributeName">recover_time</code></td><td><code>LB</code></td><td><code>60</code></td><td> The recover time is the time in seconds the load balancer will not try to use a worker, after it went into error state. Only after this time has passed, a worker in error state will be marked as in recovering, so that it will be @@ -985,9 +958,7 @@ runs of global maintenance is controlled Do not set recover_time to a very short time unless you understand the implications. Every recovery attempt for a worker in error is done by a real request! </p> -</directive> - -<directive name="error_escalation_time" workers="LB" default="recover_time / 2" required="false"> +</td></tr><tr><td><code class="attributeName">error_escalation_time</code></td><td><code>LB</code></td><td><code>recover_time / 2</code></td><td> Setting a member of a load balancer into an error state is quite serious. E.g. it means that if you need stickyness, all access to the sessions of the respective node is blocked. @@ -1001,26 +972,20 @@ will the node be put into error state. <p> This features has been added in <b>jk 1.2.28</b>. </p> -</directive> - -<directive name="session_cookie" workers="LB" default="JSESSIONID" required="false"> +</td></tr><tr><td><code class="attributeName">session_cookie</code></td><td><code>LB</code></td><td><code>JSESSIONID</code></td><td> The name of the cookie that contains the routing identifier needed for session stickyness. The routing identifier is everything after a "." character in the value of the cookie. <p> This feature has been added in <b>jk 1.2.27</b>. </p> -</directive> - -<directive name="session_path" workers="LB" default=";jsessionid" required="false"> +</td></tr><tr><td><code class="attributeName">session_path</code></td><td><code>LB</code></td><td><code>;jsessionid</code></td><td> The name of the path parameter that contains the routing identifier needed for session stickyness. The routing identifier is everything after a "." character in the value of the path parameter. <p> This feature has been added in <b>jk 1.2.27</b>. </p> -</directive> - -<directive name="set_session_cookie" workers="LB" default="false" required="false"> +</td></tr><tr><td><code class="attributeName">set_session_cookie</code></td><td><code>LB</code></td><td><code>false</code></td><td> Activates generation of session stickyness cookies. Typically you don't need this. <p> Some web frameworks replace Tomcat session management and use a different way @@ -1043,18 +1008,14 @@ we will send a new cookie to switch stic <p> This feature has been added in <b>jk 1.2.38</b>. </p> -</directive> - -<directive name="session_cookie_path" workers="LB" default="" required="false"> +</td></tr><tr><td><code class="attributeName">session_cookie_path</code></td><td><code>LB</code></td><td><code>-</code></td><td> This attribute is only used if "set_session_cookie" is set to <b>true</b>. See "set_session_cookie" for a description. If the value of "session_cookie_path" is empty (default), then the send cookie will not contain a PATH information. <p> This feature has been added in <b>jk 1.2.38</b>. </p> -</directive> - -<directive name="activation" workers="SUB" default="Active" required="false"> +</td></tr><tr><td><code class="attributeName">activation</code></td><td><code>SUB</code></td><td><code>Active</code></td><td> Using this directive, a balanced worker of a load balancer can be configured as disabled or stopped. A disabled worker only gets requests, which belong to sessions for that worker. A stopped @@ -1071,9 +1032,7 @@ This flag can be changed at runtime usin <p> This feature has been added in <b>jk 1.2.19</b>. </p> -</directive> - -<directive name="route" workers="SUB" default="worker name" required="false"> +</td></tr><tr><td><code class="attributeName">route</code></td><td><code>SUB</code></td><td><code>worker name</code></td><td> Normally the name of a balanced worker in a load balancer is equal to the jvmRoute of the corresponding Tomcat instance. If you want to include a worker corresponding to a Tomcat instance into several load balancers with different balancing configuration @@ -1097,9 +1056,7 @@ This feature has been added in <b>jk 1.2 The automatic domain rule has been added in <b>jk 1.2.20</b>.<br> The attribute has been renamed from jvm_route to route in <b>jk 1.2.20</b>. </p> -</directive> - -<directive name="distance" workers="SUB" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">distance</code></td><td><code>SUB</code></td><td><code>0</code></td><td> An integer number to express preferences between the balanced workers of an lb worker. A load balancer will never choose some balanced worker @@ -1111,9 +1068,7 @@ workers of a larger distance are eligibl <p> This feature has been added in <b>jk 1.2.16</b>. </p> -</directive> - -<directive name="domain" workers="SUB" default="" required="false"> +</td></tr><tr><td><code class="attributeName">domain</code></td><td><code>SUB</code></td><td><code>-</code></td><td> Domain directive can be used only when the worker is a member of the load balancer. Workers that share the same domain name are treated as single worker. If sticky_session is used, then the domain name is used as session route. @@ -1125,9 +1080,7 @@ transfer between them. <p> This feature has been added in <b>jk 1.2.8</b>. </p> -</directive> - -<directive name="redirect" workers="SUB" default="" required="false"> +</td></tr><tr><td><code class="attributeName">redirect</code></td><td><code>SUB</code></td><td><code>-</code></td><td> Set to the name of the preferred failover worker. If worker matching SESSION ID is in error state then the redirect worker will be used instead. It will be used even if being disabled, thus offering hot standby. @@ -1138,9 +1091,7 @@ to this route of the preferred failover <p> This feature has been added in <b>jk 1.2.9</b>. </p> -</directive> - -</advanceddirectives> +</td></tr></table> </div></div> <div class="subsection"><h4 id="Deprecated_Worker_Directives">Deprecated Worker Directives</h4><div class="text"> @@ -1148,8 +1099,7 @@ This feature has been added in <b>jk 1.2 in case you need to use an older version of mod_jk. We urge you to update and not use them any more. Please migrate your existing configurations. </p> -<deprecations> -<directive name="cachesize" successor="connection_pool_size" default="see text" required="false"> +<table class="defaultTable"><tr><th style="width: 15%;"><font color="#ffffff">Directive</font></th><th style="width: 15%;"><font color="#ffffff">Successor</font></th><th style="width: 10%;"><font color="#ffffff">Default</font></th><th style="width: 60%;"><font color="#ffffff">Description</font></th></tr><tr><td><code class="attributeName">cachesize</code></td><td><code>connection_pool_size</code></td><td><code>see text</code></td><td> <warn>This directive has been deprecated since 1.2.16.</warn> Cachesize defines the number of connections made to the AJP backend that are maintained as a connection pool. @@ -1164,9 +1114,7 @@ its default value to match the current T value is 10. For web servers other than Apache or IIS this value has to be set manually. </p> <warn>Do not use cachesize with values higher then 1 on <b>Apache 2.x with prefork MPM</b> or <b>Apache 1.3.x</b>!</warn> -</directive> - -<directive name="cache_timeout" successor="connection_pool_timeout" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">cache_timeout</code></td><td><code>connection_pool_timeout</code></td><td><code>0</code></td><td> <warn>This directive has been deprecated since 1.2.16.</warn> 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 @@ -1181,9 +1129,7 @@ until killed. And since the web server w 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="recycle_timeout" successor="connection_pool_timeout" default="0" required="false"> +</td></tr><tr><td><code class="attributeName">recycle_timeout</code></td><td><code>connection_pool_timeout</code></td><td><code>0</code></td><td> <warn>This directive has been deprecated since 1.2.16.</warn> The number of seconds that told web server 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 @@ -1192,24 +1138,18 @@ It's a good way to ensure that there won 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. -</directive> - -<directive name="balanced_workers" successor="balance_workers" default="" required="true"> +</td></tr><tr><td><code class="attributeName">balanced_workers</code></td><td><code>balance_workers</code></td><td><code>-</code></td><td> <warn>This directive has been deprecated since 1.2.7.</warn> A comma separated list of workers that the load balancer need to manage. -</directive> - -<directive name="disabled" successor="activation" default="false" required="false"> +</td></tr><tr><td><code class="attributeName">disabled</code></td><td><code>activation</code></td><td><code>false</code></td><td> <warn>This directive has been deprecated since 1.2.19.</warn> If set to <b>true</b> the worker will be disabled if member of load balancer. This flag can be changed at runtime using status worker. <p> This feature has been added in <b>jk 1.2.9</b>. </p> -</directive> - -<directive name="stopped" successor="activation" default="false" required="false"> +</td></tr><tr><td><code class="attributeName">stopped</code></td><td><code>activation</code></td><td><code>false</code></td><td> <warn>This directive has been deprecated since 1.2.19.</warn> If set to <b>true</b> the worker will be stopped if member of load balancer. The flag is needed for stop complete traffic of a sticky session @@ -1218,9 +1158,7 @@ This flag can be changed at runtime usin <p> This feature has been added in <b>jk 1.2.11</b>. </p> -</directive> - -<directive name="jvm_route" successor="route" default="worker name" required="false"> +</td></tr><tr><td><code class="attributeName">jvm_route</code></td><td><code>route</code></td><td><code>worker name</code></td><td> <warn>This directive has been deprecated since 1.2.20.</warn> Normally the name of a balanced worker in a load balancer is equal to the jvmRoute of the corresponding Tomcat instance. If you want to include a worker corresponding @@ -1239,9 +1177,7 @@ This attribute can be changed at runtime <p> This feature has been added in <b>jk 1.2.16</b>. </p> -</directive> - -</deprecations> +</td></tr></table> </div></div> </div><div class="noprint"><h3 id="comments_section"> Modified: tomcat/site/trunk/docs/connectors-doc/webserver_howto/apache.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/webserver_howto/apache.html?rev=1850977&r1=1850976&r2=1850977&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/webserver_howto/apache.html (original) +++ tomcat/site/trunk/docs/connectors-doc/webserver_howto/apache.html Thu Jan 10 20:17:16 2019 @@ -29,7 +29,7 @@ })(window, document); }), false); })(); - </script></head><body><div id="wrapper"><header><div id="header"><div><div><div class="logo noPrint"><a href="http://tomcat.apache.org/";><img alt="Tomcat Home" src="../images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo noPrint"><a href="https://www.apache.org/"; target="_blank"><img src="../images/asf-logo.svg" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1>The Apache Tomcat Connectors - Web Server HowTo</h1><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2>Links</h2><ul><li><a href="../index.html">Docs Home</a></li></ul></div><div><h2>Common HowTo</h2><ul><li><a href="../common_howto/quick.html">For the impatient</a></li><li><a href="../common_howto/workers.html">All about workers</a></li><li><a href="../common_howto/timeouts.html">Timeouts</a></li><li><a href="../common_howto/loadbalancers.html"> Load Balancing</a></li><li><a href="../common_howto/proxy.html">Reverse Proxy</a></li></ul></div><div><h2>Web Server HowTo</h2><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="../webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul></div><div><h2>Reference Guide</h2><ul><li><a href="../reference/workers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul></div><div><h2>AJP Protocol Reference</h2><ul><li><a href="../ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul></div><div><h2>Miscellaneous D ocumentation</h2><ul><li><a href="../miscellaneous/faq.html">Frequently asked questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=";>Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute doc umentation</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html";>Old JK/JK2 documentation</a></li></ul></div><div><h2>News</h2><ul><li><a href="../news/20180301.html">2018</a></li><li><a href="../news/20160901.html">2016</a></li><li><a href="../news/20150101.html">2015</a></li><li><a href="../news/20140201.html">2014</a></li><li><a href="../news/20120301.html">2012</a></li><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></div></nav></div></div><div id="mainRight" ><div id="content"><h2>Apache HTTP Server HowTo</h2><h3 >id="Introduction">Introduction</h3><div class="text"> + </script></head><body><div id="wrapper"><header><div id="header"><div><div><div class="logo noPrint"><a href="http://tomcat.apache.org/";><img alt="Tomcat Home" src="../images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo noPrint"><a href="https://www.apache.org/"; target="_blank"><img src="../images/asf-logo.svg" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1>The Apache Tomcat Connectors - Web Server HowTo</h1><div style="height: 1px;"></div><div style="clear: left;"></div></div></div></div></header><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2>Links</h2><ul><li><a href="../index.html">Docs Home</a></li></ul></div><div><h2>Common HowTo</h2><ul><li><a href="../common_howto/quick.html">Quick Start</a></li><li><a href="../common_howto/workers.html">All About Workers</a></li><li><a href="../common_howto/timeouts.html">Timeouts</a></li><li><a href="../common_howto/loadbalancers.html">Load B alancing</a></li><li><a href="../common_howto/proxy.html">Reverse Proxy</a></li></ul></div><div><h2>Web Server HowTo</h2><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="../webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul></div><div><h2>Reference Guide</h2><ul><li><a href="../reference/workers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul></div><div><h2>AJP Protocol Reference</h2><ul><li><a href="../ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul></div><div><h2>Miscellaneous Documen tation</h2><ul><li><a href="../miscellaneous/faq.html">Frequently Asked Questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=";>Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute documenta tion</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html";>Old JK/JK2 documentation</a></li></ul></div><div><h2>News</h2><ul><li><a href="../news/20180301.html">2018</a></li><li><a href="../news/20160901.html">2016</a></li><li><a href="../news/20150101.html">2015</a></li><li><a href="../news/20140201.html">2014</a></li><li><a href="../news/20120301.html">2012</a></li><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></div></nav></div></div><div id="mainRight"><div id="content"><h2>Apache HTTP Server HowTo</h2><h3 id="Introduction">Introduction</h3><div class="text"> <p> This document explains how to connect Tomcat to the popular open source web server, Apache HTTP Server. You can use the connection module mod_jk with any version of Apache starting with 1.3 and any version --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org
