Modified: tomcat/site/trunk/docs/connectors-doc/common_howto/printer/quick.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/common_howto/printer/quick.html?rev=1763527&r1=1763526&r2=1763527&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/common_howto/printer/quick.html (original) +++ tomcat/site/trunk/docs/connectors-doc/common_howto/printer/quick.html Thu Oct 6 09:00:17 2016 @@ -1,14 +1,15 @@ -<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The Apache Tomcat Connectors - Common HowTo - Quick Start HowTo</title><meta name="author" value="Henri Gomez"><meta name="email" value="hgo...@apache.org"><link href="../../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; align="right" alt=" :: Apache Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4" ><tr><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Common >HowTo</h1><h2>Quick Start HowTo</h2></td><td align="right" valign="top" >nowrap="true"><img src="../../images/void.gif" width="1" height="1" >vspace="0" hspace="0" border="0" alt=" "></td></tr></table><table border="0" >cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font >color="#ffffff" face="arial,helvetica.sanserif"><a >name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote> +<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>The Apache Tomcat Connectors - Common HowTo - Quick Start HowTo</title><meta name="author" value="Henri Gomez"><meta name="email" value="hgo...@apache.org"><link href="../../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; align="right" alt=" :: Apache Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4" ><tr><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Common >HowTo</h1><h2>Quick Start HowTo</h2></td><td align="right" valign="top" >nowrap="true"><img src="../../images/void.gif" width="1" height="1" >vspace="0" hspace="0" border="0" alt=" "></td></tr></table><table border="0" >cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font >color="#ffffff" face="arial,helvetica.sanserif"><a >name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote> <p> This document describes the configuration files used by JK on the - Web Server side for the 'impatient': + web server side for the 'impatient': <ul> <li> - <b>workers.properties</b> is a mandatory file used by the webserver and which - is the same for all JK implementations (Apache/IIS/NES). + <b>workers.properties</b> is a mandatory file used by the web server and which + is the same for all JK implementations (mod_jk for the Apache HTTP Server, + ISAPI for Microsoft IIS, NSAPI for the iPlanet Web Server). </li> <li> - <b>web server</b> add-ons to be set on the webserver side. + <b>web server</b> add-ons to be set on the web server side. </li> </ul> </p> @@ -18,7 +19,7 @@ </p> </blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum workers.properties"><strong>Minimum workers.properties</strong></a></font></td></tr><tr><td><blockquote> <p> - Here is a minimum <b>workers.properties</b>, using just ajp13 to connect your Apache webserver + Here is a minimum <b>workers.properties</b>, using just ajp13 to connect your web server to the Tomcat engine, complete documentation is available in <a href="workers.html">Workers HowTo</a>. </p> <p> @@ -33,10 +34,10 @@ </pre></div> </p> -</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum Apache web server configuration"><strong>Minimum Apache web server configuration</strong></a></font></td></tr><tr><td><blockquote> +</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum Apache HTTP Server configuration"><strong>Minimum Apache HTTP Server configuration</strong></a></font></td></tr><tr><td><blockquote> <p> - Here is a minimum information about Apache configuration, a - more complete <a href="../../webserver_howto/apache.html">separate HowTo for Apache</a> is available. + Here is some very basic information about Apache configuration, a + more complete <a href="../../webserver_howto/apache.html">HowTo for Apache</a> is available. </p> <p> You should first have <b>mod_jk.so</b> (unix) or <b>mod_jk.dll</b> (Windows) installed @@ -48,10 +49,11 @@ <li>/usr/lib/apache/</li> <li>/usr/lib/apache2/</li> <li>/usr/local/apache/libexec/</li> + <li>/usr/local/apache/modules/</li> </ul> </p> <p> - Usual locations for modules directory on Windows : + Usual locations for modules directory on Windows: <ul> <li>C:\Program Files\Apache Group\Apache\modules\</li> <li>C:\Program Files\Apache Group\Apache2\modules\</li> @@ -74,7 +76,7 @@ </ul> </p> <p> - Usual locations for configuration directory on Windows : + Usual locations for configuration directory on Windows: <ul> <li>C:\Program Files\Apache Group\Apache\conf\</li> <li>C:\Program Files\Apache Group\Apache2\conf\</li> @@ -85,8 +87,8 @@ # Load mod_jk module # Update this path to match your modules location - LoadModule jk_module libexec/mod_jk.so - # Declare the module for <IfModule directive> (remove this line on Apache 2.x) + LoadModule jk_module modules/mod_jk.so + # Declare the module for <IfModule directive> (remove this line for Apache 2.x) AddModule mod_jk.c # Where to find workers.properties # Update this path to match your conf directory location (put workers.properties next to httpd.conf) @@ -106,16 +108,16 @@ </pre></div> </p> -</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum IIS web server configuration"><strong>Minimum IIS web server configuration</strong></a></font></td></tr><tr><td><blockquote> +</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum Microsoft IIS configuration"><strong>Minimum Microsoft IIS configuration</strong></a></font></td></tr><tr><td><blockquote> <p> - A separate <a href="../../webserver_howto/iis.html">HowTo for the IIS web server</a> is available. + A separate <a href="../../webserver_howto/iis.html">HowTo for the Microsoft IIS web server</a> is available. </p> <p class="todo"> This paragraph has not been written yet, but <b>you</b> can contribute to it. </p> -</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum NES/iPlanet/Sun web server configuration"><strong>Minimum NES/iPlanet/Sun web server configuration</strong></a></font></td></tr><tr><td><blockquote> +</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum iPlanet Web Server configuration"><strong>Minimum iPlanet Web Server configuration</strong></a></font></td></tr><tr><td><blockquote> <p> - A separate <a href="../../webserver_howto/nes.html">HowTo for the Netscape/iPlanet/Sun web server</a> is available. + A separate <a href="../../webserver_howto/nes.html">HowTo for the iPlanet Web Server</a> is available. <p class="todo"> This paragraph has not been written yet, but <b>you</b> can contribute to it. </p> @@ -126,5 +128,5 @@ </p> </blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em> - Copyright © 1999-2015, Apache Software Foundation + Copyright © 1999-2016, Apache Software Foundation </em></font></div></td></tr></table></body></html> \ No newline at end of file
Modified: tomcat/site/trunk/docs/connectors-doc/common_howto/printer/timeouts.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/common_howto/printer/timeouts.html?rev=1763527&r1=1763526&r2=1763527&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/common_howto/printer/timeouts.html (original) +++ tomcat/site/trunk/docs/connectors-doc/common_howto/printer/timeouts.html Thu Oct 6 09:00:17 2016 @@ -1,4 +1,4 @@ -<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The Apache Tomcat Connectors - Common HowTo - Timeouts HowTo</title><meta name="author" value="Rainer Jung"><meta name="email" value="rj...@apache.org"><link href="../../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; align="right" alt=" :: Apache Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr ><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Common >HowTo</h1><h2>Timeouts HowTo</h2></td><td align="right" valign="top" >nowrap="true"><img src="../../images/void.gif" width="1" height="1" >vspace="0" hspace="0" border="0" alt=" "></td></tr></table><table border="0" >cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font >color="#ffffff" face="arial,helvetica.sanserif"><a >name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote> > +<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>The Apache Tomcat Connectors - Common HowTo - Timeouts HowTo</title><meta name="author" value="Rainer Jung"><meta name="email" value="rj...@apache.org"><link href="../../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; align="right" alt=" :: Apache Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr ><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Common >HowTo</h1><h2>Timeouts HowTo</h2></td><td align="right" valign="top" >nowrap="true"><img src="../../images/void.gif" width="1" height="1" >vspace="0" hspace="0" border="0" alt=" "></td></tr></table><table border="0" >cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font >color="#ffffff" face="arial,helvetica.sanserif"><a >name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote> > <br> <p>Setting communication timeouts is very important to improve the communication process. They help to detect problems and stabilise @@ -185,17 +185,17 @@ Until version 1.2.26, the maintenance ta processed. So if your web server has processes that do not receive any requests for a long time, there is no way to close the idle connections in its pool. Starting with version 1.2.27 you can configure an independent -watchdog thread when using Apache 2.x with threaded APR or IIS. +watchdog thread when using Apache HTTP Server 2.x with threaded APR or Microsoft IIS. </p> <p> The maximum connection pool size can be configured with the attribute <b>connection_pool_size</b>. We generally do not recommend -to use this attribute in combination with Apache httpd. For -Apache httpd we automatically detect the number of threads per -process and set the maximum pool size to this value. For IIS we use +to use this attribute in combination with Apache HTTP Server. For +Apache we automatically detect the number of threads per +process and set the maximum pool size to this value. For Microsoft IIS we use a default value of 250 (before version 1.2.20: 10), -for the Sun Web Server the default is "1". -We strongly recommend adjusting this value for IIS and the Sun Web Server +for the iPlanet Web Server the default is "1". +We strongly recommend adjusting this value for IIS and the iPlanet Web Server to the number of requests one web server process should be able to send to a backend in parallel. You should measure how many connections you need during peak hours without performance problems, and then add some @@ -247,8 +247,8 @@ on good configuration values for the fir <p> In case none of our recommendations help and you are definitively having problems with idle connection drops, you can disable the use of persistent -connections when using JK together with Apache httpd. For this you set -"JkOptions +DisableReuse" in your Apache httpd configuration. +connections when using JK together with Apache HTTP Server. For this you set +"JkOptions +DisableReuse" in your Apache configuration. The amount of performance impact this will have depends on the details of your network and your firewall. </p> @@ -283,8 +283,8 @@ The default value is "0" (timeout disabl millisecond value. </p> <p> -In combination with Apache httpd, you can also set a more flexible reply_timeout -using an httpd environment variable. If you set the variable JK_REPLY_TIMEOUT +In combination with Apache HTTP Server, you can also set a more flexible reply_timeout +using an Apache environment variable. If you set the variable JK_REPLY_TIMEOUT to some integer value, this value will be used instead of the value in the worker configuration. This way you can set reply timeouts more flexible with mod_setenvif and mod_rewrite depending on URI, query string etc. @@ -370,5 +370,5 @@ with <b>ping_mode</b> and <b>ping_timeou </p> </blockquote></td></tr></table> </blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em> - Copyright © 1999-2015, Apache Software Foundation + Copyright © 1999-2016, Apache Software Foundation </em></font></div></td></tr></table></body></html> \ No newline at end of file Modified: tomcat/site/trunk/docs/connectors-doc/common_howto/printer/workers.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/common_howto/printer/workers.html?rev=1763527&r1=1763526&r2=1763527&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/common_howto/printer/workers.html (original) +++ tomcat/site/trunk/docs/connectors-doc/common_howto/printer/workers.html Thu Oct 6 09:00:17 2016 @@ -1,7 +1,7 @@ -<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The Apache Tomcat Connectors - Common HowTo - Workers HowTo</title><meta name="author" value="Henri Gomez"><meta name="email" value="hgo...@apache.org"><meta name="author" value="Gal Shachor"><meta name="email" value="shac...@il.ibm.com"><meta name="author" value="Mladen Turk"><meta name="email" value="mt...@apache.org"><link href="../../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; align="right" alt=" :: Apache Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr> <td colspan="2"><hr noshade size="1"></td></tr><tr><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Common HowTo</h1><h2>Workers HowTo</h2></td><td align="right" valign="top" nowrap="true"><img src="../../images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0" alt=" "></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote> +<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>The Apache Tomcat Connectors - Common HowTo - Workers HowTo</title><meta name="author" value="Henri Gomez"><meta name="email" value="hgo...@apache.org"><meta name="author" value="Gal Shachor"><meta name="email" value="shac...@il.ibm.com"><meta name="author" value="Mladen Turk"><meta name="email" value="mt...@apache.org"><link href="../../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; align="right" alt=" :: Apache Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr> <td colspan="2"><hr noshade size="1"></td></tr><tr><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Common HowTo</h1><h2>Workers HowTo</h2></td><td align="right" valign="top" nowrap="true"><img src="../../images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0" alt=" "></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote> <p> A Tomcat worker is a Tomcat instance that is waiting to execute servlets on behalf of some web server. -For example, we can have a web server such as Apache forwarding servlet requests to a +For example, we can have a web server such as the Apache HTTP Server forwarding servlet requests to a Tomcat process (the worker) running behind it. </p> <p> @@ -59,7 +59,7 @@ When starting up, the web server plugin <b>worker.list</b> property, these are also the workers to whom you can map requests. The directive can be used multiple times. </p> -<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Workers Type"><strong>Workers Type</strong></a></font></td></tr><tr><td><blockquote> +<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Worker Types"><strong>Worker Types</strong></a></font></td></tr><tr><td><blockquote> <p> Each named worker should also have a few entries to provide additional information on his behalf. This information includes the worker's type and other related worker information. @@ -68,10 +68,11 @@ Currently the following worker types tha <table> <tr><th>Type</th><th>Description</th></tr> - <tr><td>ajp12</td><td>This worker knows how to forward requests to out-of-process Tomcat workers using the ajpv12 protocol.</td></tr> - <tr><td>ajp13</td><td>This worker knows how to forward requests to out-of-process Tomcat workers using the ajpv13 protocol.</td></tr> - <tr><td>lb</td><td>This is a load-balancing worker; it knows how to provide round-robin based sticky load balancing with a certain level of fault-tolerance.</td></tr> + <tr><td>ajp13</td><td>This worker knows how to forward requests to out-of-process Tomcat workers using the ajp13 protocol.</td></tr> + <tr><td>lb</td><td>This is a load balancing worker; it knows how to provide flexible load balancing with a certain level of fault-tolerance.</td></tr> <tr><td>status</td><td>This is a status worker for managing load balancers.</td></tr> + <tr><td>ajp12</td><td>This worker knows how to forward requests to out-of-process Tomcat workers using the ajp12 protocol. It is deprecated</td></tr> + <tr><td>ajp14</td><td>This worker knows how to forward requests to out-of-process Tomcat workers using the ajp14 protocol. It is experimental</td></tr> </table> <p> @@ -85,9 +86,9 @@ in the table (a worker name may only con </p> <div class="example"><pre> - # Defines a worker named "local" that uses the ajpv12 protocol to forward requests to a Tomcat process. + # Defines a worker named "local" that uses the ajp12 protocol to forward requests to a Tomcat process. worker.local.type=ajp12 - # Defines a worker named "remote" that uses the ajpv13 protocol to forward requests to a Tomcat process. + # Defines a worker named "remote" that uses the ajp13 protocol to forward requests to a Tomcat process. worker.remote.type=ajp13 # Defines a worker named "loadbalancer" that loadbalances several Tomcat processes transparently. worker.loadbalancer.type=lb @@ -107,18 +108,18 @@ worker.<worker name>.<property& Each worker has a set of properties that you can set as specified in the following subsections: -<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="ajp12 Worker properties"><strong>ajp12 Worker properties</strong></a></font></td></tr><tr><td><blockquote> +<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="ajp12 Worker Properties"><strong>ajp12 Worker Properties</strong></a></font></td></tr><tr><td><blockquote> <p><p><font color="#ff0000"> -The <b>ajp12</b> has been <b>deprecated</b> with Tomcat 3.3.x and you should use instead -<b>ajp13</b> which is the only ajp protocol known by all Tomcat 4 and above. +The worker type <b>ajp12</b> has been <b>deprecated</b> and you should use instead +<b>ajp13</b> instead. </font></p></p> <p> The ajp12 typed workers forward requests to out-of-process Tomcat workers -using the ajpv12 protocol over TCP/IP sockets. +using the ajp12 protocol over TCP/IP sockets. It does not use persistent connections. </p> <p> -the ajp12 worker properties are : +The ajp12 worker properties are: </p> <p> @@ -130,39 +131,39 @@ the ajp12 worker properties are : </p> <p> -<b>lbfactor</b> property is used when working with a load balancer worker, this is the load-balancing factor for the worker. -We'll see more on this in the <a href="../../common_howto/loadbalancers.html">lb worker</a> section. +<b>lbfactor</b> property is used when working with a load balancer worker, this is the load balancing factor for the worker. +We'll see more on this in the <a href="../../common_howto/loadbalancers.html">load balancer worker</a> section. </p> <div class="example"><pre> # worker "worker1" will talk to Tomcat listening on machine www.x.com at port 8007 using 2 lb factor + worker.worker1.type=ajp12 worker.worker1.host=www.x.com worker.worker1.port=8007 worker.worker1.lbfactor=2 </pre></div> <p> -Notes: In the ajpv12 protocol, connections are created, used and then closed at each request. -The default port for ajp12 is 8007 +Note: The default port for ajp12 is 8007 </p> </blockquote></td></tr></table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="ajp13 Worker properties"><strong>ajp13 Worker properties</strong></a></font></td></tr><tr><td><blockquote> +<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="ajp13 Worker Properties"><strong>ajp13 Worker Properties</strong></a></font></td></tr><tr><td><blockquote> <p> -The ajp13 typed workers forward requests to out-of-process Tomcat workers using the ajpv13 protocol over TCP/IP sockets. -The main difference between ajpv12 and ajpv13 are that: +The ajp13 typed workers forward requests to out-of-process Tomcat workers using the ajp13 protocol over TCP/IP sockets. +The main difference between ajp12 and ajp13 are that: <ul> <li> -ajpv13 is a more binary protocol and it tries to compress some of the request data by coding +ajp13 is a more binary protocol and it tries to compress some of the request data by coding frequently used strings as small integers. </li> <li> -ajpv13 reuses open sockets and leaves them open for future requests (remember when you've got a Firewall between your +ajp13 reuses open sockets and leaves them open for future requests (remember when you've got a Firewall between your web server and Tomcat). </li> <li> -ajpv13 has special treatment for SSL information so that the container can implement +ajp13 has special treatment for SSL information so that the container can implement SSL related methods such as isSecure(). </li> </ul> @@ -170,12 +171,13 @@ SSL related methods such as isSecure(). </p> <p> -You should note that Ajp13 is now the only out-process protocol supported by Tomcat 4 and above. +You should note that ajp13 is the recommended protocol to connect to Tomcat. </p> <div class="example"><pre> # worker "worker2" will talk to Tomcat listening on machine www2.x.com at port 8009 using 3 lb factor + worker.worker2.type=ajp13 worker.worker2.host=www2.x.com worker.worker2.port=8009 worker.worker2.lbfactor=3 @@ -188,14 +190,14 @@ You should note that Ajp13 is now the on </pre></div> <p> -Notes: In the ajpv13 protocol, the default port is 8009 +Notes: In the ajp13 protocol, the default port is 8009 </p> </blockquote></td></tr></table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="lb Worker properties"><strong>lb Worker properties</strong></a></font></td></tr><tr><td><blockquote> +<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="lb Worker Properties"><strong>lb Worker Properties</strong></a></font></td></tr><tr><td><blockquote> <p> -The load-balancing worker does not really communicate with Tomcat workers. +The load balancing worker does not really communicate with Tomcat workers. Instead it is responsible for the management of several "real" workers. This management includes: </p> @@ -205,21 +207,22 @@ This management includes: Instantiating the workers in the web server. </li> <li> -Using the worker's load-balancing factor, perform weighed-round-robin load balancing where -high lbfactor means stronger machine (that is going to handle more requests) +Using the worker's load balancing factor, perform weighted round-robin load balancing where +a higher lbfactor means stronger machine (that is going to handle proportionally more requests) </li> <li> -Keeping requests belonging to the same session executing on the same Tomcat worker. +Keeping requests belonging to the same session executing on the same Tomcat worker +(session stickyness). </li> <li> -Identifying failed Tomcat workers, suspending requests to them and instead falling-back on +Identifying failed Tomcat workers, suspending requests to them and instead failing over on other workers managed by the lb worker. </li> </ul> <p> -The overall result is that workers managed by the same lb worker are load-balanced -(based on their lbfactor and current user session) and also fall-backed so a single +The overall result is that workers managed by the same lb worker are load balanced +(based on their lbfactor and current user session) and also fail over so a single Tomcat process death will not "kill" the entire site. The following table specifies some properties that the lb worker can accept: <ul> @@ -253,7 +256,7 @@ Instead it is responsible for the load b worker.jkstatus.type=status </pre></div> <p>Next thing is to mount the requests to the jkstatus worker. For Apache -web servers use the:</p> +HTTP Servers use:</p> <div class="example"><pre> # Add the jkstatus mount point JkMount /jkmanager/* jkstatus @@ -371,41 +374,38 @@ a sample worker.properties file is bundl </p> <p> -You could also find here a sample workers.properties defining : +You could also find here a sample workers.properties defining: </p> <ul> <li> -An ajp12 worker that used the host localhost and the port 8007 +Two ajp13 workers that use the host localhost and the ports 8109 and 8209 </li> <li> -An ajp13 worker that used the host localhost and the port 8008 -</li> -<li> -An lb worker that load balance the ajp12 and ajp13 workers +An lb worker that load balances over the two ajp13 workers </li> </ul> <div class="example"><pre> - # Define 3 workers, 2 real workers using ajp12, ajp13, the last one being a loadbalancing worker - worker.list=worker1, worker2, worker3 - # Set properties for worker1 (ajp12) - worker.worker1.type=ajp12 - worker.worker1.host=localhost - worker.worker1.port=8007 - worker.worker1.lbfactor=1 - # Set properties for worker2 (ajp13) - worker.worker2.type=ajp13 - worker.worker2.host=localhost - worker.worker2.port=8009 - worker.worker2.lbfactor=1 - worker.worker2.connection_pool_timeout=600 - worker.worker2.socket_keepalive=1 - worker.worker2.socket_timeout=60 - # Set properties for worker3 (lb) which use worker1 and worker2 - worker.worker3.balance_workers=worker1,worker2 + # Define 3 workers, 2 real workers using ajp13, and one being a load balancing worker + worker.list=node1, node2, lbworker + # Set properties for node1 (ajp13) + worker.node1.type=ajp13 + worker.node1.host=localhost + worker.node1.port=8109 + worker.node1.connection_pool_timeout=600 + worker.node1.socket_keepalive=1 + # Set properties for node2 (ajp13) + worker.node2.type=ajp13 + worker.node2.host=localhost + worker.node2.port=8209 + worker.node2.connection_pool_timeout=600 + worker.node2.socket_keepalive=1 + # Set properties for lbworker which uses node1 and node2 + worker.lbworker.type=lb + worker.lbworker.balance_workers=node1,node2 </pre></div> </blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em> - Copyright © 1999-2015, Apache Software Foundation + Copyright © 1999-2016, Apache Software Foundation </em></font></div></td></tr></table></body></html> \ No newline at end of file Modified: tomcat/site/trunk/docs/connectors-doc/common_howto/proxy.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/common_howto/proxy.html?rev=1763527&r1=1763526&r2=1763527&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/common_howto/proxy.html (original) +++ tomcat/site/trunk/docs/connectors-doc/common_howto/proxy.html Thu Oct 6 09:00:17 2016 @@ -1,8 +1,9 @@ -<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The Apache Tomcat Connectors - Common HowTo - Reverse Proxy HowTo</title><meta name="author" value="Rainer Jung"><meta name="email" value="rj...@apache.org"><link href="../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; align="right" alt=" :: Apache Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap="true"><p><strong>Links</strong></p><ul><li><a href="../i ndex.html">Docs Home</a></li></ul><p><strong>Common HowTo</strong></p><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><p><strong>Webserver HowTo</strong></p><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server</a></li><li><a href="../webserver_howto/iis.html">IIS</a></li><li><a href="../webserver_howto/nes.html">Netscape/SunOne/Sun</a></li></ul><p><strong>Reference Guide</strong></p><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</a></li><li><a href="../reference/ii s.html">IIS</a></li></ul><p><strong>AJP Protocol Reference</strong></p><ul><li><a href="../ajp/ajpv13a.html">AJPv13</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul><p><strong>Miscellaneous Documentation</strong></p><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=N ow&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 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><p><strong>News</strong></p><ul><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></td><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Common HowTo</h1><h2>Reverse Proxy HowTo</h2></td><td align="right" valign="top" nowrap="true"><small><a href="printer/proxy.html"><img src="../images/printer.gif" border="0" alt="Printer Friendly Version"><br>print-friendly<br>version +<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>The Apache Tomcat Connectors - Common HowTo - Reverse Proxy HowTo</title><meta name="author" value="Rainer Jung"><meta name="email" value="rj...@apache.org"><link href="../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; align="right" alt=" :: Apache Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap="true"><p><strong>Links</strong></p><ul><li><a href="../i ndex.html">Docs Home</a></li></ul><p><strong>Common HowTo</strong></p><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><p><strong>Web Server HowTo</strong></p><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><p><strong>Reference Guide</strong></p><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><p><strong>AJP Protocol Reference</strong></p><ul><li><a href="../ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul><p><strong>Miscellaneous Documentation</strong></p><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&emailty pe2=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 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><p><strong>News</strong></p><ul><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><l i><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></td><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Common HowTo</h1><h2>Reverse Proxy HowTo</h2></td><td align="right" valign="top" nowrap="true"><small><a href="printer/proxy.html"><img src="../images/printer.gif" border="0" alt="Printer Friendly Version"><br>print-friendly<br>version </a></small></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote> <br> -<p>The Apache module mod_jk and its ISAPI and NSAPI variants connect -a web server to a backend (typically Tomcat) using the AJP protocol. +<p>The Apache HTTP Server module mod_jk and its ISAPI and NSAPI redirector +variants for Microsoft IIS and the iPlanet Web Server connect +the web server to a backend (typically Tomcat) using the AJP protocol. The web server receives an HTTP(S) request and the module forwards the request to the backend. This function is usually called a gateway or a proxy, in the context of HTTP it is called a reverse proxy. @@ -37,9 +38,9 @@ This is also equal to <b class="code">ge is contained in the request. In this case the server name is taken from that header. </li> <li>local IP address: <b class="code">getLocalAddr()</b>. -The local IP address was initially not supported. It is available when using mod_jk 1.2.41 -with Apache or IIS (not for the NSAPI plugin) together with Tomcat version at least -6.0.42, 7.0.55 or 8.0.11. For older versions, <b class="code">getLocalAddr()</b> +The local IP address was initially not supported. It is available when using version 1.2.41 +for Apache or IIS together with Tomcat version at least +6.0.42, 7.0.55 or 8.0.11. For older versions or when using the NSAPI redirector, <b class="code">getLocalAddr()</b> will incorrectly return the same result as <b class="code">getLocalName()</b>. As a workaround you can forward the local IP address by setting <b class="code">JkEnvVar SERVER_ADDR</b> and then either using @@ -55,9 +56,9 @@ if it contains an explicit port, or is e <li>client address: <b class="code">getRemoteAddr()</b> </li> <li>client port: <b class="code">getRemotePort()</b>. -The remote port was initially not supported. It is available when using mod_jk 1.2.32 -with Apache or IIS (not for the NSAPI plugin) together with Tomcat version at least -5.5.28, 6.0.20 or 7.0.0. For older versions, <b class="code">getRemotePort()</b> +The remote port was initially not supported. It is available when using version 1.2.32 +for Apache or IIS together with Tomcat version at least +5.5.28, 6.0.20 or 7.0.0. For older versions or when using the NSAPI redirector, <b class="code">getRemotePort()</b> will incorrectly return 0 or -1. As a workaround you can forward the remote port by setting <b class="code">JkEnvVar REMOTE_PORT</b> and then either using <b class="code">request.getAttribute("REMOTE_PORT")</b> instead of <b class="code">getRemotePort()</b> @@ -82,7 +83,7 @@ if <b class="code">tomcatAuthentication= <li>query string: <b class="code">getQueryString()</b> </li> </ul> -The following additional SSL-related data will be made available by Apache and forwarded by mod_jk only +The following additional SSL-related data will be made available by the Apache HTTP Server and forwarded by mod_jk only if you set <b class="code">SSLOptions +StdEnvVars</b>. For the certificate information you also need to set <b class="code">SSLOptions +ExportCertData</b>. <ul> @@ -120,10 +121,10 @@ more cascading reverse proxies in front) content of such a header as the client IP address to pass to the backend. </p> <p>So we might need to manipulate some of the data that AJP sends to the backend. -When using mod_jk inside Apache httpd you can use several httpd environment +When using mod_jk inside the Apache HTTP Server you can use several Apache environment variables to let mod_jk know, which data it should forward. These environment variables -can be set by the httpd directives SetEnv or SetEnvIf, but also in a very flexible -way using mod_rewrite (since httpd 2.x it can not only test against environment +can be set by the configuration directives SetEnv or SetEnvIf, but also in a very flexible +way using mod_rewrite (since Apache 2.x it can not only test against environment variables, but also set them). </p> <p>The following list contains all environment variables mod_jk checks, before @@ -161,7 +162,7 @@ from the web server. Only in case you wa using these variables. </p> <p>Some of these variables might also be used by other web server modules. All -variables whose name does not begin with "JK" are set directly by Apache httpd. +variables whose name does not begin with "JK" are set directly by the Apache HTTP Server. If you want to change the data, but do not want to negatively influence the behaviour of other modules, you can change the names of all variables mod_jk uses to private ones. For the details see the <a href="../reference/apache.html">Apache reference</a> page. @@ -171,7 +172,7 @@ For the details see the <a href="../refe <p>In addition there are two special shortcuts to influence the client IP address that is forwarded. Using <b class="code">JkOptions ForwardLocalAddress</b> you can forward the local IP address of the web server as the client IP address. This can be useful, e.g. when using the Tomcat remote address valve for -allowing connections only from registered Apache web servers. +allowing connections only from registered Apache HTTP Servers. Using <b class="code">JkOptions ForwardPhysicalAddress</b> you always forward the physical peer IP address as the client address. By default mod_jk uses the logical address as provided by the web server. For example the module @@ -181,9 +182,9 @@ in the <b class="code">X-Forwarded-For</ </blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Tomcat AJP Connector Settings"><strong>Tomcat AJP Connector Settings</strong></a></font></td></tr><tr><td><blockquote> <br> <p>As an alternative to using the environment variables described in the previous section -(which do only exist when using Apache httpd), you can also configure Tomcat to overwrite +(which do only exist when using Apache), you can also configure Tomcat to overwrite some of the communications data forwarded by mod_jk. The AJP connector in Tomcat's <b class="code">server.xml</b> -allows to set the <a href="http://tomcat.apache.org/tomcat-6.0-doc/config/ajp.html#Attributes";>following properties</a>: +allows to set the <a href="http://tomcat.apache.org/tomcat-8.0-doc/config/ajp.html#Attributes";>following properties</a>: <ul> <li>proxyName: server name as returned by <b class="code">getServerName()</b> </li> @@ -215,7 +216,7 @@ here are the steps. <p>Case A: You need to make the application available at a simple URL, but it is OK, if users proceed using the more complex URLs, as long as they don't have to type them in. That's the easy case, and if this suffices to you, you're lucky. Use a simply RedirectMatch -for Apache httpd: +for the Apache HTTP Server: </p> <div class="example"><pre> RedirectMatch ^/$ http://www.mycompany.com/myapp/ @@ -227,7 +228,7 @@ and each visitor will be immediately red <p>Case B: You need to hide path components for all requests going to the application. Here's the recipe for the case, where you want to hide the first path component <b class="code">/myapp</b>. More complex manipulations are left as an exercise to the reader. -First the solution for the case of Apache httpd: +First the solution for the case of the Apache HTTP Server: </p> <p>1. Use <a href="http://httpd.apache.org/docs/current/mod/mod_rewrite.html";><b class="code">mod_rewrite</b></a> to add <b class="code">/myapp</b> to all requests before forwarding to the backend: @@ -263,12 +264,12 @@ In this case check, whether you find a c to configure the base URL. If not, your only chance is to parse all response content bodies and do search and replace. This is fragile and very resource intensive. If you really need to do this, you can use -<a href="http://apache.webthing.com/mod_proxy_html/";><b class="code">mod_proxy_html</b></a>, +<a href="http://httpd.apache.org/docs/current/mod/mod_proxy_html.html";><b class="code">mod_proxy_html</b></a>, <a href="http://httpd.apache.org/docs/current/mod/mod_substitute.html";><b class="code">mod_substitute</b></a> or <a href="http://blogs.sun.com/basant/entry/using_mod_sed_to_filter";><b class="code">mod_sed</b></a> for this task. </p> -<p>If you are using Microsoft IIS as a web server, the ISAPI plugin provides a way +<p>If you are using Microsoft IIS as a web server, the ISAPI redirector provides a way of doing the first step with a builtin feature. You define a mapping file for simple prefix changes like this: </p> @@ -308,22 +309,22 @@ the one which was used for the original <p> For historical reasons, there have been several alternatives, how mod_jk and the ISAPI plugin encoded the resulting URL before sending it to the backend. They could be chosen via -<b class="code">JkOptions</b> (Apache httpd) or <b class="code">uri_select</b> (ISAPI). None of those historical +<b class="code">JkOptions</b> (mod_jk) or <b class="code">uri_select</b> (ISAPI). None of those historical encodings are recommended, because they have either negative functionality implications or pose a security risk. The default encoding since version 1.2.24 is <b class="code">ForwardURIProxy</b> -(Apache httpd) or <b class="code">proxy</b> (ISAPI) and it is strongly recommended to keep the default +(mod_jk) or <b class="code">proxy</b> (ISAPI) and it is strongly recommended to keep the default and remove all old explicit settings. </p> </blockquote></td></tr></table> </blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Request Attributes"><strong>Request Attributes</strong></a></font></td></tr><tr><td><blockquote> <br> <p> -You can also add more attributes to any request you are forwarding when using Apache httpd. +You can also add more attributes to any request you are forwarding when using the Apache HTTP Server. For this use the <b class="code">JkEnvVar</b> directive (for details see the <a href="../reference/apache.html">Apache reference</a> page). Such request attributes can be retrieved on the Tomcat side via request.getAttribute(attributeName). -Note that their names will not be listed in request.getAttributeNames()! +Note that the names of attributes set via mod_jk will not be listed in request.getAttributeNames()! </p> </blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em> - Copyright © 1999-2015, Apache Software Foundation + Copyright © 1999-2016, Apache Software Foundation </em></font></div></td></tr></table></body></html> \ No newline at end of file Modified: tomcat/site/trunk/docs/connectors-doc/common_howto/quick.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/common_howto/quick.html?rev=1763527&r1=1763526&r2=1763527&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/common_howto/quick.html (original) +++ tomcat/site/trunk/docs/connectors-doc/common_howto/quick.html Thu Oct 6 09:00:17 2016 @@ -1,15 +1,16 @@ -<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The Apache Tomcat Connectors - Common HowTo - Quick Start HowTo</title><meta name="author" value="Henri Gomez"><meta name="email" value="hgo...@apache.org"><link href="../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; align="right" alt=" :: Apache Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap="true"><p><strong>Links</strong></p><ul><li><a href="../in dex.html">Docs Home</a></li></ul><p><strong>Common HowTo</strong></p><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><p><strong>Webserver HowTo</strong></p><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server</a></li><li><a href="../webserver_howto/iis.html">IIS</a></li><li><a href="../webserver_howto/nes.html">Netscape/SunOne/Sun</a></li></ul><p><strong>Reference Guide</strong></p><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</a></li><li><a href="../reference/iis .html">IIS</a></li></ul><p><strong>AJP Protocol Reference</strong></p><ul><li><a href="../ajp/ajpv13a.html">AJPv13</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul><p><strong>Miscellaneous Documentation</strong></p><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=No w&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 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><p><strong>News</strong></p><ul><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 h ref="../news/20041100.html">2004</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Common HowTo</h1><h2>Quick Start HowTo</h2></td><td align="right" valign="top" nowrap="true"><small><a href="printer/quick.html"><img src="../images/printer.gif" border="0" alt="Printer Friendly Version"><br>print-friendly<br>version +<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>The Apache Tomcat Connectors - Common HowTo - Quick Start HowTo</title><meta name="author" value="Henri Gomez"><meta name="email" value="hgo...@apache.org"><link href="../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; align="right" alt=" :: Apache Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap="true"><p><strong>Links</strong></p><ul><li><a href="../in dex.html">Docs Home</a></li></ul><p><strong>Common HowTo</strong></p><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><p><strong>Web Server HowTo</strong></p><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><p><strong>Reference Guide</strong></p><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><p><strong>AJP Protocol >Reference</strong></p><ul><li><a href="../ajp/ajpv13a.html">AJPv13 >(ajp13)</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension >Proposal</a></li></ul><p><strong>Miscellaneous >Documentation</strong></p><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&emailtyp e2=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 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><p><strong>News</strong></p><ul><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></td><!--RIGHT SIDE MAIN >BODY--><td width="80%" valign="top" align="left"><table border="0" >width="100%" cellspacing="4"><tr><td align="left" valign="top"><h1>The Apache >Tomcat Connectors - Common HowTo</h1><h2>Quick Start HowTo</h2></td><td >align="right" valign="top" nowrap="true"><small><a >href="printer/quick.html"><img src="../images/printer.gif" border="0" >alt="Printer Friendly Version"><br>print-friendly<br>version </a></small></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote> <p> This document describes the configuration files used by JK on the - Web Server side for the 'impatient': + web server side for the 'impatient': <ul> <li> - <b>workers.properties</b> is a mandatory file used by the webserver and which - is the same for all JK implementations (Apache/IIS/NES). + <b>workers.properties</b> is a mandatory file used by the web server and which + is the same for all JK implementations (mod_jk for the Apache HTTP Server, + ISAPI for Microsoft IIS, NSAPI for the iPlanet Web Server). </li> <li> - <b>web server</b> add-ons to be set on the webserver side. + <b>web server</b> add-ons to be set on the web server side. </li> </ul> </p> @@ -19,7 +20,7 @@ </p> </blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum workers.properties"><strong>Minimum workers.properties</strong></a></font></td></tr><tr><td><blockquote> <p> - Here is a minimum <b>workers.properties</b>, using just ajp13 to connect your Apache webserver + Here is a minimum <b>workers.properties</b>, using just ajp13 to connect your web server to the Tomcat engine, complete documentation is available in <a href="workers.html">Workers HowTo</a>. </p> <p> @@ -34,10 +35,10 @@ </pre></div> </p> -</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum Apache web server configuration"><strong>Minimum Apache web server configuration</strong></a></font></td></tr><tr><td><blockquote> +</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum Apache HTTP Server configuration"><strong>Minimum Apache HTTP Server configuration</strong></a></font></td></tr><tr><td><blockquote> <p> - Here is a minimum information about Apache configuration, a - more complete <a href="../webserver_howto/apache.html">separate HowTo for Apache</a> is available. + Here is some very basic information about Apache configuration, a + more complete <a href="../webserver_howto/apache.html">HowTo for Apache</a> is available. </p> <p> You should first have <b>mod_jk.so</b> (unix) or <b>mod_jk.dll</b> (Windows) installed @@ -49,10 +50,11 @@ <li>/usr/lib/apache/</li> <li>/usr/lib/apache2/</li> <li>/usr/local/apache/libexec/</li> + <li>/usr/local/apache/modules/</li> </ul> </p> <p> - Usual locations for modules directory on Windows : + Usual locations for modules directory on Windows: <ul> <li>C:\Program Files\Apache Group\Apache\modules\</li> <li>C:\Program Files\Apache Group\Apache2\modules\</li> @@ -75,7 +77,7 @@ </ul> </p> <p> - Usual locations for configuration directory on Windows : + Usual locations for configuration directory on Windows: <ul> <li>C:\Program Files\Apache Group\Apache\conf\</li> <li>C:\Program Files\Apache Group\Apache2\conf\</li> @@ -86,8 +88,8 @@ # Load mod_jk module # Update this path to match your modules location - LoadModule jk_module libexec/mod_jk.so - # Declare the module for <IfModule directive> (remove this line on Apache 2.x) + LoadModule jk_module modules/mod_jk.so + # Declare the module for <IfModule directive> (remove this line for Apache 2.x) AddModule mod_jk.c # Where to find workers.properties # Update this path to match your conf directory location (put workers.properties next to httpd.conf) @@ -107,16 +109,16 @@ </pre></div> </p> -</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum IIS web server configuration"><strong>Minimum IIS web server configuration</strong></a></font></td></tr><tr><td><blockquote> +</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum Microsoft IIS configuration"><strong>Minimum Microsoft IIS configuration</strong></a></font></td></tr><tr><td><blockquote> <p> - A separate <a href="../webserver_howto/iis.html">HowTo for the IIS web server</a> is available. + A separate <a href="../webserver_howto/iis.html">HowTo for the Microsoft IIS web server</a> is available. </p> <p class="todo"> This paragraph has not been written yet, but <b>you</b> can contribute to it. </p> -</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum NES/iPlanet/Sun web server configuration"><strong>Minimum NES/iPlanet/Sun web server configuration</strong></a></font></td></tr><tr><td><blockquote> +</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Minimum iPlanet Web Server configuration"><strong>Minimum iPlanet Web Server configuration</strong></a></font></td></tr><tr><td><blockquote> <p> - A separate <a href="../webserver_howto/nes.html">HowTo for the Netscape/iPlanet/Sun web server</a> is available. + A separate <a href="../webserver_howto/nes.html">HowTo for the iPlanet Web Server</a> is available. <p class="todo"> This paragraph has not been written yet, but <b>you</b> can contribute to it. </p> @@ -127,5 +129,5 @@ </p> </blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em> - Copyright © 1999-2015, Apache Software Foundation + Copyright © 1999-2016, Apache Software Foundation </em></font></div></td></tr></table></body></html> \ No newline at end of file Modified: tomcat/site/trunk/docs/connectors-doc/common_howto/timeouts.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/common_howto/timeouts.html?rev=1763527&r1=1763526&r2=1763527&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/common_howto/timeouts.html (original) +++ tomcat/site/trunk/docs/connectors-doc/common_howto/timeouts.html Thu Oct 6 09:00:17 2016 @@ -1,4 +1,4 @@ -<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The Apache Tomcat Connectors - Common HowTo - Timeouts HowTo</title><meta name="author" value="Rainer Jung"><meta name="email" value="rj...@apache.org"><link href="../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; align="right" alt=" :: Apache Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap="true"><p><strong>Links</strong></p><ul><li><a href="../index. html">Docs Home</a></li></ul><p><strong>Common HowTo</strong></p><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><p><strong>Webserver HowTo</strong></p><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server</a></li><li><a href="../webserver_howto/iis.html">IIS</a></li><li><a href="../webserver_howto/nes.html">Netscape/SunOne/Sun</a></li></ul><p><strong>Reference Guide</strong></p><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</a></li><li><a href="../reference/iis.htm l">IIS</a></li></ul><p><strong>AJP Protocol Reference</strong></p><ul><li><a href="../ajp/ajpv13a.html">AJPv13</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul><p><strong>Miscellaneous Documentation</strong></p><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&am p;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 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><p><strong>News</strong></p><ul><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></td><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Common HowTo</h1><h2>Timeouts HowTo</h2></td><td align="right" valign="top" nowrap="true"><small><a href="printer/timeouts.html"><img src="../images/printer.gif" border="0" alt="Printer Friendly Version"><br>print-friendly<br>version +<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>The Apache Tomcat Connectors - Common HowTo - Timeouts HowTo</title><meta name="author" value="Rainer Jung"><meta name="email" value="rj...@apache.org"><link href="../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; align="right" alt=" :: Apache Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap="true"><p><strong>Links</strong></p><ul><li><a href="../index. html">Docs Home</a></li></ul><p><strong>Common HowTo</strong></p><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><p><strong>Web Server HowTo</strong></p><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><p><strong>Reference Guide</strong></p><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">Apa che HTTP Server (mod_jk)</a></li><li><a href="../reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul><p><strong>AJP Protocol Reference</strong></p><ul><li><a href="../ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul><p><strong>Miscellaneous Documentation</strong></p><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=s ubstring&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 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><p><strong>News</strong></p><ul><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></td><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Common HowTo</h1><h2>Timeouts HowTo</h2></td><td align="right" valign="top" nowrap="true"><small><a href="printer/timeouts.html"><img src="../images/printer.gif" border="0" alt="Printer Friendly Version"><br>print-friendly<br>version </a></small></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote> <br> <p>Setting communication timeouts is very important to improve the @@ -186,17 +186,17 @@ Until version 1.2.26, the maintenance ta processed. So if your web server has processes that do not receive any requests for a long time, there is no way to close the idle connections in its pool. Starting with version 1.2.27 you can configure an independent -watchdog thread when using Apache 2.x with threaded APR or IIS. +watchdog thread when using Apache HTTP Server 2.x with threaded APR or Microsoft IIS. </p> <p> The maximum connection pool size can be configured with the attribute <b>connection_pool_size</b>. We generally do not recommend -to use this attribute in combination with Apache httpd. For -Apache httpd we automatically detect the number of threads per -process and set the maximum pool size to this value. For IIS we use +to use this attribute in combination with Apache HTTP Server. For +Apache we automatically detect the number of threads per +process and set the maximum pool size to this value. For Microsoft IIS we use a default value of 250 (before version 1.2.20: 10), -for the Sun Web Server the default is "1". -We strongly recommend adjusting this value for IIS and the Sun Web Server +for the iPlanet Web Server the default is "1". +We strongly recommend adjusting this value for IIS and the iPlanet Web Server to the number of requests one web server process should be able to send to a backend in parallel. You should measure how many connections you need during peak hours without performance problems, and then add some @@ -248,8 +248,8 @@ on good configuration values for the fir <p> In case none of our recommendations help and you are definitively having problems with idle connection drops, you can disable the use of persistent -connections when using JK together with Apache httpd. For this you set -"JkOptions +DisableReuse" in your Apache httpd configuration. +connections when using JK together with Apache HTTP Server. For this you set +"JkOptions +DisableReuse" in your Apache configuration. The amount of performance impact this will have depends on the details of your network and your firewall. </p> @@ -284,8 +284,8 @@ The default value is "0" (timeout disabl millisecond value. </p> <p> -In combination with Apache httpd, you can also set a more flexible reply_timeout -using an httpd environment variable. If you set the variable JK_REPLY_TIMEOUT +In combination with Apache HTTP Server, you can also set a more flexible reply_timeout +using an Apache environment variable. If you set the variable JK_REPLY_TIMEOUT to some integer value, this value will be used instead of the value in the worker configuration. This way you can set reply timeouts more flexible with mod_setenvif and mod_rewrite depending on URI, query string etc. @@ -371,5 +371,5 @@ with <b>ping_mode</b> and <b>ping_timeou </p> </blockquote></td></tr></table> </blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em> - Copyright © 1999-2015, Apache Software Foundation + Copyright © 1999-2016, Apache Software Foundation </em></font></div></td></tr></table></body></html> \ No newline at end of file --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org
![http://www.apache.org/images/asf-logo.gif"](http://www.apache.org/images/asf-logo.gif"){kind=link}