summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/manual/howto/htaccess.xml.ja2
-rw-r--r--docs/manual/howto/htaccess.xml.ko2
-rw-r--r--docs/manual/howto/htaccess.xml.pt-br2
-rw-r--r--docs/manual/mod/mod_proxy_fcgi.html.en55
-rw-r--r--docs/manual/mod/mod_proxy_scgi.html.en7
5 files changed, 60 insertions, 8 deletions
diff --git a/docs/manual/howto/htaccess.xml.ja b/docs/manual/howto/htaccess.xml.ja
index d02c5e2296..d3a048676e 100644
--- a/docs/manual/howto/htaccess.xml.ja
+++ b/docs/manual/howto/htaccess.xml.ja
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
-<!-- English Revision: 574882:684332 (outdated) -->
+<!-- English Revision: 574882:933606 (outdated) -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/manual/howto/htaccess.xml.ko b/docs/manual/howto/htaccess.xml.ko
index bc218e0b90..dcf07e8ad8 100644
--- a/docs/manual/howto/htaccess.xml.ko
+++ b/docs/manual/howto/htaccess.xml.ko
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='EUC-KR' ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
-<!-- English Revision: 151408:684332 (outdated) -->
+<!-- English Revision: 151408:933606 (outdated) -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/manual/howto/htaccess.xml.pt-br b/docs/manual/howto/htaccess.xml.pt-br
index 3f1ce9f5ab..a9058cd1b9 100644
--- a/docs/manual/howto/htaccess.xml.pt-br
+++ b/docs/manual/howto/htaccess.xml.pt-br
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.pt-br.xsl"?>
-<!-- English Revision: 151408:684332 (outdated) -->
+<!-- English Revision: 151408:933606 (outdated) -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/manual/mod/mod_proxy_fcgi.html.en b/docs/manual/mod/mod_proxy_fcgi.html.en
index 044d0e99fe..aac7928f50 100644
--- a/docs/manual/mod/mod_proxy_fcgi.html.en
+++ b/docs/manual/mod/mod_proxy_fcgi.html.en
@@ -32,12 +32,18 @@
<h3>Summary</h3>
<p>This module <em>requires</em> the service of <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. It provides support for the
- <a href="http://www.fastcgi.com/">FastCGI</a>.</p>
+ <a href="http://www.fastcgi.com/">FastCGI</a> protocol.</p>
- <p>Thus, in order to get the ability of handling <code>FastCGI</code>
+ <p>Thus, in order to get the ability of handling the <code>FastCGI</code>
protocol, <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> and
<code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code> have to be present in the server.</p>
+ <p>Unlike <a href="http://httpd.apache.org/mod_fcgid/">mod_fcgid</a>
+ and <a href="http://www.fastcgi.com/">mod_fastcgi</a>,
+ <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code> has no provision for starting the
+ application process; <code class="program"><a href="../programs/fcgistarter.html">fcgistarter</a></code> is provided for
+ that purpose.</p>
+
<div class="warning"><h3>Warning</h3>
<p>Do not enable proxying until you have <a href="mod_proxy.html#access">secured your server</a>. Open proxy
servers are dangerous both to your network and to the Internet at
@@ -47,12 +53,55 @@
<div id="quickview"><h3 class="directives">Directives</h3>
<p>This module provides no
directives.</p>
-<h3>See also</h3>
+<h3>Topics</h3>
+<ul id="topics">
+<li><img alt="" src="../images/down.gif" /> <a href="#examples">Examples</a></li>
+</ul><h3>See also</h3>
<ul class="seealso">
<li><code class="program"><a href="../programs/fcgistarter.html">fcgistarter</a></code></li>
<li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></li>
</ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="examples" id="examples">Examples</a></h2>
+ <p>Remember, in order to make the following examples work, you have to
+ enable <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> and <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code>.</p>
+
+ <div class="example"><h3>Single application instance</h3><p><code>
+ ProxyPass /myapp/ fcgi://localhost:4000/
+ </code></p></div>
+
+ <p>This application should be able to handle multiple concurrent
+ connections. <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> enables connection reuse by
+ default, so after a request has been completed the connection will be
+ held open by that httpd child process and won't be reused until that
+ httpd process routes another request to the application. If the
+ FastCGI application is unable to handle enough concurrent connections
+ from httpd, requests can block waiting for the application to close
+ an existing connection. One way to resolve this is to disable connection
+ reuse on the <code class="directive">ProxyPass</code> directive, as shown in
+ the following example:</p>
+ <div class="example"><h3>Single application instance, no connection reuse</h3><p><code>
+ ProxyPass /myapp/ fcgi://localhost:4000/ disablereuse=on
+ </code></p></div>
+
+ <p>The balanced gateway needs <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> and
+ at least one load balancer algorithm module, such as
+ <code class="module"><a href="../mod/mod_lbmethod_byrequests.html">mod_lbmethod_byrequests</a></code>, in addition to the proxy
+ modules listed above. <code class="module"><a href="../mod/mod_lbmethod_byrequests.html">mod_lbmethod_byrequests</a></code> is the
+ default, and will be used for this example configuration.</p>
+
+ <div class="example"><h3>Balanced gateway to multiple application instances</h3><p><code>
+ ProxyPass /myapp/ balancer://myappcluster/<br />
+ &lt;Proxy balancer://myappcluster/&gt;<br />
+ <span class="indent">
+ BalancerMember fcgi://localhost:4000/<br />
+ BalancerMember fcgi://localhost:4001/<br />
+ </span>
+ &lt;/Proxy&gt;
+ </code></p></div>
+</div>
</div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/mod/mod_proxy_fcgi.html" title="English">&nbsp;en&nbsp;</a></p>
diff --git a/docs/manual/mod/mod_proxy_scgi.html.en b/docs/manual/mod/mod_proxy_scgi.html.en
index 2b67f5a260..1f5a8a9ebc 100644
--- a/docs/manual/mod/mod_proxy_scgi.html.en
+++ b/docs/manual/mod/mod_proxy_scgi.html.en
@@ -67,8 +67,11 @@
ProxyPass /scgi-bin/ scgi://localhost:4000/
</code></p></div>
- <p>The balanced gateway needs <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> in
- addition to the already mentioned proxy modules.</p>
+ <p>The balanced gateway needs <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> and
+ at least one load balancer algorithm module, such as
+ <code class="module"><a href="../mod/mod_lbmethod_byrequests.html">mod_lbmethod_byrequests</a></code>, in addition to the proxy
+ modules listed above. <code class="module"><a href="../mod/mod_lbmethod_byrequests.html">mod_lbmethod_byrequests</a></code> is the
+ default, and will be used for this example configuration.</p>
<div class="example"><h3>Balanced gateway</h3><p><code>
ProxyPass /scgi-bin/ balancer://somecluster/<br />