httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From pque...@apache.org
Subject svn commit: r111587 - /httpd/httpd/trunk/docs/manual/mod/mod_proxy.html.en /httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml
Date Sat, 11 Dec 2004 08:25:40 GMT
Author: pquerna
Date: Sat Dec 11 00:25:39 2004
New Revision: 111587

URL: http://svn.apache.org/viewcvs?view=rev&rev=111587
Log:
* mod/mod_proxy.xml: First Draft trying to explain how to tune pooled connections.

Modified:
   httpd/httpd/trunk/docs/manual/mod/mod_proxy.html.en
   httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml

Modified: httpd/httpd/trunk/docs/manual/mod/mod_proxy.html.en
Url: http://svn.apache.org/viewcvs/httpd/httpd/trunk/docs/manual/mod/mod_proxy.html.en?view=diff&rev=111587&p1=httpd/httpd/trunk/docs/manual/mod/mod_proxy.html.en&r1=111586&p2=httpd/httpd/trunk/docs/manual/mod/mod_proxy.html.en&r2=111587
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_proxy.html.en	(original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_proxy.html.en	Sat Dec 11 00:25:39 2004
@@ -718,7 +718,7 @@
 <div class="directive-section"><h2><a name="ProxyPass" id="ProxyPass">ProxyPass</a>
<a name="proxypass" id="proxypass">Directive</a></h2>
 <table class="directive">
 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps
remote servers into the local server URL-space</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyPass
[<var>path</var>] !|<var>url</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyPass
[<var>path</var>] !|<var>url</var> [<var>key=value</var>
<var>key=value</var> ...]]</code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server
config, virtual host, directory</td></tr>
 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
@@ -757,6 +757,26 @@
       <p>Order is important. you need to put the exclusions <em>before</em>
the
       general <code class="directive">ProxyPass</code> directive.</p>
     </div>
+
+    <p>New in Apache 2.1, is the ability to use pooled connections to a 
+    backend server. Using the <code>key=value</code> parameters it is possible
+    to tune this connection pooling. The default for a <code>Hard Maximum</code>
+    for the number of connections is the number of threads per process in the 
+    active MPM. In the Prefork MPM, this is always 1, while with the Worker MPM
+    it is controlled by the <code class="directive">ThreadsPerChild</code>.</p>
+
+    <p>Setting <code>min</code> will determine how many connections will
always 
+    be open to the backend server. Upto the Soft Maximum or <code>smax</code>

+    number of connections will be created on demand. Any connections above 
+    <code>smax</code> are subject to a time to live or <code>ttl</code>.
 Apache
+    will never create more than the Hard Maximum or <code>hmax</code> connections
+    to the backend server.</p>
+
+    <div class="example"><p><code>
+        ProxyPass /example http://backend.example.com min=0 smax=5 hmax=20 ttl=60
+    </code></p></div>
+
+    
 
     <p>When used inside a <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code>
section, the first argument is omitted and the local
     directory is obtained from the <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code>.</p>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml
Url: http://svn.apache.org/viewcvs/httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml?view=diff&rev=111587&p1=httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml&r1=111586&p2=httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml&r2=111587
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml	(original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml	Sat Dec 11 00:25:39 2004
@@ -532,7 +532,7 @@
 <directivesynopsis>
 <name>ProxyPass</name>
 <description>Maps remote servers into the local server URL-space</description>
-<syntax>ProxyPass [<var>path</var>] !|<var>url</var></syntax>
+<syntax>ProxyPass [<var>path</var>] !|<var>url</var> [<var>key=value</var>
<var>key=value</var> ...]]</syntax>
 <contextlist><context>server config</context><context>virtual host</context>
 <context>directory</context>
 </contextlist>
@@ -572,6 +572,30 @@
       <p>Order is important. you need to put the exclusions <em>before</em>
the
       general <directive>ProxyPass</directive> directive.</p>
     </note>
+
+    <p>New in Apache 2.1, is the ability to use pooled connections to a 
+    backend server. Using the <code>key=value</code> parameters it is possible
+    to tune this connection pooling. The default for a <code>Hard Maximum</code>
+    for the number of connections is the number of threads per process in the 
+    active MPM. In the Prefork MPM, this is always 1, while with the Worker MPM
+    it is controlled by the <directive>ThreadsPerChild</directive>.</p>
+
+    <p>Setting <code>min</code> will determine how many connections will
always 
+    be open to the backend server. Upto the Soft Maximum or <code>smax</code>

+    number of connections will be created on demand. Any connections above 
+    <code>smax</code> are subject to a time to live or <code>ttl</code>.
 Apache
+    will never create more than the Hard Maximum or <code>hmax</code> connections
+    to the backend server.</p>
+
+    <example>
+        ProxyPass /example http://backend.example.com min=0 smax=5 hmax=20 ttl=60
+    </example>
+
+    <!-- Still to be documented:
+             retry acquire timeout 
+             iobuffersize receivebuffersize 
+             keepalive route redirect 
+         See modules/proxy/mod_proxy.c set_worker_param() for details.  -->
 
     <p>When used inside a <directive type="section" module="core"
     >Location</directive> section, the first argument is omitted and the local

Mime
View raw message