Commit f5c1ef79 authored by Christophe Jaillet's avatar Christophe Jaillet
Browse files

rebuild 

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1832296 13f79535-47bb-0310-9956-ffa450edef68
parent 5b9756d5

docs/manual/mod/mod_proxy.html.en

+6 −6
Original line number Diff line number Diff line
@@ -27,13 +27,13 @@ 
<div id="preamble"><h1>Apache Module mod_proxy</h1>

<div class="toplang">

<p><span>Available Languages: </span><a href="../en/mod/mod_proxy.html" title="English">&nbsp;en&nbsp;</a> |

<a href="../fr/mod/mod_proxy.html" hreflang="fr" rel="alternate" title="Franais">&nbsp;fr&nbsp;</a> |

<a href="../fr/mod/mod_proxy.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |

<a href="../ja/mod/mod_proxy.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>

</div>

<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Multi-protocol proxy/gateway server</td></tr>

<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr>

<tr><th><a href="module-dict.html#ModuleIdentifier">ModuleIdentifier:</a></th><td>proxy_module</td></tr>

<tr><th><a href="module-dict.html#SourceFile">SourceFile:</a></th><td>mod_proxy.c</td></tr></table>

<tr><th><a href="module-dict.html#ModuleIdentifier">Module Identifier:</a></th><td>proxy_module</td></tr>

<tr><th><a href="module-dict.html#SourceFile">Source File:</a></th><td>mod_proxy.c</td></tr></table>

<h3>Summary</h3>



    <div class="warning"><h3>Warning</h3>
@@ -1285,7 +1285,7 @@ ProxyPass "/mirror/foo" "http://backend.example.com"</pre> 
        <td>Route of the worker when used inside load balancer.

        The route is a value appended to session id.

    </td></tr>

    <tr><td>status</td>

    <tr><td><a name="status_table">status</a></td>

        <td>-</td>

        <td>Single letter value defining the initial status of

        this worker.
@@ -2002,7 +2002,7 @@ header for proxied requests</td></tr> 
</div>

<div class="bottomlang">

<p><span>Available Languages: </span><a href="../en/mod/mod_proxy.html" title="English">&nbsp;en&nbsp;</a> |

<a href="../fr/mod/mod_proxy.html" hreflang="fr" rel="alternate" title="Franais">&nbsp;fr&nbsp;</a> |

<a href="../fr/mod/mod_proxy.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |

<a href="../ja/mod/mod_proxy.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>

</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>

<script type="text/javascript"><!--//--><![CDATA[//><!--

docs/manual/mod/mod_proxy.xml.fr

+1 −1
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>

<!-- English Revision: 1828128 -->

<!-- English Revision: 1828128:1832295 (outdated) -->

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->

docs/manual/mod/mod_proxy.xml.ja

+1 −1
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>

<!-- English Revision: 344971:1828128 (outdated) -->

<!-- English Revision: 344971:1832295 (outdated) -->



<!--

 Licensed to the Apache Software Foundation (ASF) under one or more

docs/manual/mod/mod_proxy.xml.meta

+1 −1
Original line number Diff line number Diff line
@@ -8,7 +8,7 @@ 


  <variants>

    <variant>en</variant>

    <variant>fr</variant>

    <variant outdated="yes">fr</variant>

    <variant outdated="yes">ja</variant>

  </variants>

</metafile>

docs/manual/mod/mod_proxy_hcheck.html.en

+34 −19
Original line number Diff line number Diff line
@@ -31,8 +31,8 @@ 
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Dynamic health check of Balancer members (workers) for

<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></td></tr>

<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr>

<tr><th><a href="module-dict.html#ModuleIdentifier">ModuleIdentifier:</a></th><td>proxy_hcheck_module</td></tr>

<tr><th><a href="module-dict.html#SourceFile">SourceFile:</a></th><td>mod_proxy_hcheck.c</td></tr>

<tr><th><a href="module-dict.html#ModuleIdentifier">Module Identifier:</a></th><td>proxy_hcheck_module</td></tr>

<tr><th><a href="module-dict.html#SourceFile">Source File:</a></th><td>mod_proxy_hcheck.c</td></tr>

<tr><th><a href="module-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.4.21 and later</td></tr></table>

<h3>Summary</h3>
@@ -45,10 +45,11 @@ 


<div class="note"><h3>Parameters</h3>

  <p>The health check mechanism is enabled via the use of additional

  	BalancerMember parameters, which are configured in the standard

  	way via <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>:</p>

     <code class="directive"><a href="../mod/mod_proxy.html#balancermember">BalancerMember</a></code> parameters, which are configured

     in the standard way via <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>:</p>



  <p>A new BalancerMember status state (flag) is defined via this module: "<code>C</code>".

  <p>A new BalancerMember <a href="mod_proxy.html#status_table">status</a> state (flag)

     is defined via this module: "<code>C</code>".

     When the worker is taken offline due to failures as determined by the health

     check module, this flag is set, and can be seen (and modified) via the

     <code>balancer-manager</code>.</p>
@@ -86,10 +87,12 @@ 
        <td>Additional URI to be appended to the worker URL for the health check.</td></tr>

    <tr><td>hctemplate</td>

        <td>&nbsp;</td>

        <td>Name of template, created via <code class="directive">ProxyHCTemplate</code> to use for setting health check parameters for this worker</td></tr>

        <td>Name of template, created via <code class="directive"><a href="#proxyhctemplate">ProxyHCTemplate</a></code>,

            to use for setting health check parameters for this worker</td></tr>

    <tr><td>hcexpr</td>

        <td>&nbsp;</td>

        <td>Name of expression, created via <code class="directive">ProxyHCExpr</code>, used to check response headers for health.<br />

        <td>Name of expression, created via <code class="directive"><a href="#proxyhcexpr">ProxyHCExpr</a></code>,

            used to check response headers for health.<br />

            <em>If not used, 2xx thru 3xx status codes imply success</em></td></tr>

    </table>

</div>
@@ -149,8 +152,8 @@ not dynamically checked at all.</p> 
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>

<div class="directive-section"><h2><a name="ProxyHCExpr" id="ProxyHCExpr">ProxyHCExpr</a> <a name="proxyhcexpr" id="proxyhcexpr">Directive</a></h2>

<table class="directive">

<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Creates a named condition expression to use to determine health of the backend based on its response.</td></tr>

<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHCExpr name {ap_expr expression}</code></td></tr>

<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Creates a named condition expression to use to determine health of the backend based on its response</td></tr>

<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHCExpr <em>name</em> {<em>ap_expr expression</em>}</code></td></tr>

<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</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_hcheck</td></tr>
@@ -159,10 +162,14 @@ not dynamically checked at all.</p> 
       for creating a named condition expression that checks the response

       headers of the backend server to determine its health. This named

       condition can then be assigned to balancer members via the <code>hcexpr</code>

       parameter</p>

       parameter.</p>



    <div class="example"><h3>ProxyHCExpr: Allow for 2xx/3xx/4xx as passing</h3><pre class="prettyprint lang-config">ProxyHCExpr ok234 {%{REQUEST_STATUS} =~ /^[234]/}

ProxyPass "/apps"     "http://backend.example.com/" hcexpr=ok234</pre>

ProxyPass "/apps"     "balancer://foo"



&lt;Proxy balancer://foo&gt;

  BalancerMember http://www2.example.com/  hcmethod=HEAD hcexpr=ok234 hcinterval=10

&lt;/Proxy&gt;</pre>

</div>



    <div class="note">
@@ -179,7 +186,11 @@ ProxyPass "/apps" "http://backend.example.com/" hcexpr=ok234</pre> 
    we want to disable the backend.</p>



    <div class="example"><h3>ProxyHCExpr: Checking response body</h3><pre class="prettyprint lang-config">ProxyHCExpr in_maint {hc('body') !~ /Under maintenance/}

ProxyPass "/apps"     "http://backend.example.com/" hcexpr=in_maint hcmethod=get hcuri=/status.php</pre>

ProxyPass "/apps"     "balancer://foo"



&lt;Proxy balancer://foo&gt;

  BalancerMember http://www.example.com/ hcexpr=in_maint hcmethod=get hcuri=/status.php

&lt;/Proxy&gt;</pre>

</div>



    <p><em>NOTE:</em> Since response body can quite large, it is best if used against specific status pages.</p>
@@ -189,7 +200,7 @@ ProxyPass "/apps" "http://backend.example.com/" hcexpr=in_maint hcmethod=get 
<div class="directive-section"><h2><a name="ProxyHCTemplate" id="ProxyHCTemplate">ProxyHCTemplate</a> <a name="proxyhctemplate" id="proxyhctemplate">Directive</a></h2>

<table class="directive">

<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Creates a named template for setting various health check parameters</td></tr>

<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHCTemplate name parameter=setting &lt;...&gt;</code></td></tr>

<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHCTemplate <em>name</em> <em>parameter</em>=<em>setting</em> [...]</code></td></tr>

<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</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_hcheck</td></tr>
@@ -197,10 +208,14 @@ ProxyPass "/apps" "http://backend.example.com/" hcexpr=in_maint hcmethod=get 
    <p>The <code class="directive">ProxyHCTemplate</code> directive allows

       for creating a named set (template) of health check parameters

       that can then be assigned to balancer members via the <code>hctemplate</code>

       parameter</p>

       parameter.</p>



    <div class="example"><h3>ProxyHCTemplate</h3><pre class="prettyprint lang-config">ProxyHCTemplate tcp5 hcmethod=tcp hcinterval=5

ProxyPass "/apps"     "http://backend.example.com/" hctemplate=tcp5</pre>

ProxyPass "/apps"     "balancer://foo"



&lt;Proxy balancer://foo&gt;

  BalancerMember http://www2.example.com/ hctemplate=tcp5

&lt;/Proxy&gt;</pre>

</div>
@@ -208,8 +223,8 @@ ProxyPass "/apps" "http://backend.example.com/" hctemplate=tcp5</pre> 
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>

<div class="directive-section"><h2><a name="ProxyHCTPsize" id="ProxyHCTPsize">ProxyHCTPsize</a> <a name="proxyhctpsize" id="proxyhctpsize">Directive</a></h2>

<table class="directive">

<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the total server-wide size of the threadpool used for the health check workers.</td></tr>

<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHCTPsize &lt;size&gt;</code></td></tr>

<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the total server-wide size of the threadpool used for the health check workers</td></tr>

<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ProxyHCTPsize <em>size</em></code></td></tr>

<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</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_hcheck</td></tr>