]> granicus.if.org Git - apache/commitdiff
Docs update. Refresh as well as fold in (better??) docs
authorJim Jagielski <jim@apache.org>
Wed, 9 Feb 2005 20:47:47 +0000 (20:47 +0000)
committerJim Jagielski <jim@apache.org>
Wed, 9 Feb 2005 20:47:47 +0000 (20:47 +0000)
about balancer.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@153116 13f79535-47bb-0310-9956-ffa450edef68

16 files changed:
docs/manual/mod/allmodules.xml.ja
docs/manual/mod/index.html.en
docs/manual/mod/mod_authnz_ldap.html.en
docs/manual/mod/mod_authz_owner.html
docs/manual/mod/mod_authz_owner.html.en
docs/manual/mod/mod_authz_owner.xml.meta
docs/manual/mod/mod_authz_user.html
docs/manual/mod/mod_authz_user.html.en
docs/manual/mod/mod_authz_user.xml.meta
docs/manual/mod/mod_proxy.html.en
docs/manual/mod/mod_proxy.xml
docs/manual/mod/mod_proxy_balancer.html.en
docs/manual/mod/mod_proxy_balancer.xml
docs/manual/mod/quickreference.html.en
docs/manual/platform/netware.html.en
docs/manual/platform/netware.xml.ko

index 6ccfb629442b931e83d28c229cba537f1f2a472b..d18b1900115bcd0b7fcebdc01e05d47010793153 100644 (file)
@@ -16,8 +16,8 @@
   <modulefile>mod_authz_default.xml.ja</modulefile>
   <modulefile>mod_authz_groupfile.xml.ja</modulefile>
   <modulefile>mod_authz_host.xml.ja</modulefile>
-  <modulefile>mod_authz_owner.xml</modulefile>
-  <modulefile>mod_authz_user.xml</modulefile>
+  <modulefile>mod_authz_owner.xml.ja</modulefile>
+  <modulefile>mod_authz_user.xml.ja</modulefile>
   <modulefile>mod_autoindex.xml.ja</modulefile>
   <modulefile>mod_cache.xml.ja</modulefile>
   <modulefile>mod_cern_meta.xml</modulefile>
index 34012fc93bf0d651e2982b8cb5be57b300d65bfb..21b22d70ee5457ee2f122fe6e2681030f81977c6 100644 (file)
@@ -147,8 +147,7 @@ by other LDAP modules</dd>
 <dt><a href="mod_proxy.html" id="P" name="P">mod_proxy</a></dt><dd>HTTP/1.1 proxy/gateway server</dd>
 <dt><a href="mod_proxy_ajp.html">mod_proxy_ajp</a></dt><dd>AJP support module for
 <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></dd>
-<dt><a href="mod_proxy_balancer.html">mod_proxy_balancer</a></dt><dd><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> extension for
-load balancing </dd>
+<dt><a href="mod_proxy_balancer.html">mod_proxy_balancer</a></dt><dd><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> extension for load balancing </dd>
 <dt><a href="mod_proxy_connect.html">mod_proxy_connect</a></dt><dd><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> extension for
 <code>CONNECT</code> request handling</dd>
 <dt><a href="mod_proxy_ftp.html">mod_proxy_ftp</a></dt><dd>FTP support module for
index cd23757b674c79fa67cb6a188dd3abf90d67d882..c9bc4fa338f232b02c627365a0d5454fda558bbd 100644 (file)
@@ -542,12 +542,18 @@ require valid-user
 <div class="section">
 <h2><a name="usingtls" id="usingtls">Using TLS</a></h2>
 
-    <p>To use TLS, see the <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> directives <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedca">LDAPTrustedCA</a></code> and <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedcatype">LDAPTrustedCAType</a></code>.</p>
+    <p>To use TLS, see the <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> directives <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedclientcert">LDAPTrustedClientCert</a></code>, <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedglobalcert">LDAPTrustedGlobalCert</a></code> and <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedmode">LDAPTrustedMode</a></code>.</p>
+
+    <p>An optional second parameter can be added to the 
+    <code class="directive"><a href="#authldapurl">AuthLDAPURL</a></code> to override
+    the default connection type set by <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedmode">LDAPTrustedMode</a></code>.
+    This will allow the connection established by an <em>ldap://</em> Url 
+    to be upgraded to a secure connection on the same port.</p>
 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="usingssl" id="usingssl">Using SSL</a></h2>
 
-    <p>To use SSL, see the <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> directives <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedca">LDAPTrustedCA</a></code> and <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedcatype">LDAPTrustedCAType</a></code>.</p>
+    <p>To use SSL, see the <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> directives <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedclientcert">LDAPTrustedClientCert</a></code>, <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedglobalcert">LDAPTrustedGlobalCert</a></code> and <code class="directive"><a href="../mod/mod_ldap.html#ldaptrustedmode">LDAPTrustedMode</a></code>.</p>
 
     <p>To specify a secure LDAP server, use <em>ldaps://</em> in the
     <code class="directive"><a href="#authldapurl">AuthLDAPURL</a></code>
@@ -799,7 +805,7 @@ environment variable</td></tr>
 <div class="directive-section"><h2><a name="AuthLDAPUrl" id="AuthLDAPUrl">AuthLDAPUrl</a> <a name="authldapurl" id="authldapurl">Directive</a></h2>
 <table class="directive">
 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>URL specifying the LDAP search parameters</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthLDAPUrl <em>url</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthLDAPUrl <em>url [NONE|SSL|TLS|STARTTLS]</em></code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig</td></tr>
 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
@@ -887,6 +893,22 @@ environment variable</td></tr>
     Jenson</code>, the resulting search filter will be
     <code>(&amp;(posixid=*)(cn=Babs Jenson))</code>.</p>
 
+    <p>An optional parameter can be added to allow the LDAP Url to override 
+    the connection type.  This parameter can be one of the following:</p>
+
+<dl>
+    <dt>NONE</dt>
+        <dd>Establish an unsecure connection on the default LDAP port. This
+        is the same as <code>ldap://</code> on port 389.</dd>
+    <dt>SSL</dt>
+        <dd>Establish a secure connection on the default secure LDAP port.
+        This is the same as <code>ldaps://</code></dd>
+    <dt>TLS | STARTTLS</dt>
+        <dd>Establish an upgraded secure connection on the default LDAP port.
+        This connection will be initiated on port 389 by default and then 
+        upgraded to a secure connection on the same port.</dd>
+</dl>
+
     <p>See above for examples of <code class="directive"><a href="#authldapurl">AuthLDAPURL</a></code> URLs.</p>
 
 </div>
index e0ab78af4e55759076e8eddcf9db97469efba6e6..f23a815ffe00398a3f201f637eb9788512b4da31 100644 (file)
@@ -2,6 +2,10 @@ URI: mod_authz_owner.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
+URI: mod_authz_owner.html.ja.euc-jp
+Content-Language: ja
+Content-type: text/html; charset=EUC-JP
+
 URI: mod_authz_owner.html.ko.euc-kr
 Content-Language: ko
 Content-type: text/html; charset=EUC-KR
index 963487255ecd1d5140ddf9923f7cdaabcaff5bdf..be7ad185b920e1e2b3fe4074a13da4a1403c3976 100644 (file)
@@ -22,6 +22,7 @@
 <div id="preamble"><h1>Apache Module mod_authz_owner</h1>
 <div class="toplang">
 <p><span>Available Languages: </span><a href="../en/mod/mod_authz_owner.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../ja/mod/mod_authz_owner.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/mod_authz_owner.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 </div>
 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Authorization based on file ownership</td></tr>
@@ -176,6 +177,7 @@ modules</td></tr>
 </div>
 <div class="bottomlang">
 <p><span>Available Languages: </span><a href="../en/mod/mod_authz_owner.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../ja/mod/mod_authz_owner.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/mod_authz_owner.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 </div><div id="footer">
 <p class="apache">Copyright 1995-2005 The Apache Software Foundation or its licensors, as applicable.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
index fd0c400caba1b47612c8a28ff4f24e97c812874b..181113fda028b9bee0dcfd03bdac3f912b43dd11 100644 (file)
@@ -7,6 +7,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>ja</variant>
     <variant>ko</variant>
   </variants>
 </metafile>
index b7841bd79e9e660c684518c6b11fa18a4fc2ca5d..bbf7fe111d92e8db18ab78ee9f7bb8d9335240d2 100644 (file)
@@ -2,6 +2,10 @@ URI: mod_authz_user.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
+URI: mod_authz_user.html.ja.euc-jp
+Content-Language: ja
+Content-type: text/html; charset=EUC-JP
+
 URI: mod_authz_user.html.ko.euc-kr
 Content-Language: ko
 Content-type: text/html; charset=EUC-KR
index 3a4c619adbb75f435c6824dedda23fb5f7aa8b45..565b05390bfb011f35e12f0580a2f928aa3729d6 100644 (file)
@@ -22,6 +22,7 @@
 <div id="preamble"><h1>Apache Module mod_authz_user</h1>
 <div class="toplang">
 <p><span>Available Languages: </span><a href="../en/mod/mod_authz_user.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../ja/mod/mod_authz_user.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/mod_authz_user.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 </div>
 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>User Authorization</td></tr>
@@ -75,6 +76,7 @@ modules</td></tr>
 </div>
 <div class="bottomlang">
 <p><span>Available Languages: </span><a href="../en/mod/mod_authz_user.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../ja/mod/mod_authz_user.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/mod/mod_authz_user.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 </div><div id="footer">
 <p class="apache">Copyright 1995-2005 The Apache Software Foundation or its licensors, as applicable.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
index 4fc70e1df072ab8e6af888d2f7ed2e1b58b81af0..eb2e5157a4781d6dd2f956137bbad4055a0b9a29 100644 (file)
@@ -7,6 +7,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>ja</variant>
     <variant>ko</variant>
   </variants>
 </metafile>
index 57c33dfa10415de9257d7c822756720304a83e84..c116bea5c055b39bd23872ecc56d1ce8a4d16162 100644 (file)
@@ -99,6 +99,7 @@
 <li><code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code></li>
 <li><code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code></li>
 <li><code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code></li>
+<li><code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></li>
 <li><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code></li>
 </ul></div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
index d3cfc66ee28bb04a99d7957dad7800cbca471179..764d3cd0e9a9619c124b8d354f02da5fa1589b1f 100644 (file)
@@ -65,6 +65,7 @@
 <seealso><module>mod_proxy_http</module></seealso>
 <seealso><module>mod_proxy_ftp</module></seealso>
 <seealso><module>mod_proxy_connect</module></seealso>
+<seealso><module>mod_proxy_balancer</module></seealso>
 <seealso><module>mod_ssl</module></seealso>
 
     <section id="forwardreverse"><title>Forward and Reverse Proxies</title>
index 12dfb262a44d2d6c7afe8c82a5636d2c0fc5e3a4..26821299ff290d106824013cf0b63e6bef640df6 100644 (file)
@@ -24,8 +24,7 @@
 <p><span>Available Languages: </span><a href="../en/mod/mod_proxy_balancer.html" title="English">&nbsp;en&nbsp;</a> |
 <a href="../ja/mod/mod_proxy_balancer.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><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> extension for
-load balancing </td></tr>
+<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> extension for load balancing </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">Module Identifier:</a></th><td>proxy_balancer_module</td></tr>
 <tr><th><a href="module-dict.html#SourceFile">Source File:</a></th><td>proxy_balancer.c</td></tr>
@@ -52,6 +51,8 @@ load balancing </td></tr>
 <h3>Topics</h3>
 <ul id="topics">
 <li><img alt="" src="../images/down.gif" /> <a href="#scheduler">Load balancer scheduler algorithm</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#requests">Request Counting Algorithm</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#traffic">Weighted Traffic Counting Algorithm</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#enable">Enabling Balancer Manager Support</a></li>
 </ul><h3>See also</h3>
 <ul class="seealso">
@@ -61,10 +62,25 @@ load balancing </td></tr>
 <div class="section">
 <h2><a name="scheduler" id="scheduler">Load balancer scheduler algorithm</a></h2>
     
-    <p>The idea behind this scheduler is the following:</p>
+    <p>At present, there are 2 load balancer scheduler algorithms available
+    for use: Request Counting and Weighted Traffic Counting. These are controlled
+    via the <code>lbmethod</code> value of the Balancer definition. See
+    the <code class="directive"><a href="../mod/mod_proxy.html#proxy">Proxy</a></code> directive for
+    more information.</p>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="requests" id="requests">Request Counting Algorithm</a></h2>
+    
+    <p>Enabled via <code>lbmethod=requests</code>, the idea behind this
+    scheduler is that we distribute the requests among the
+    various workers to ensure that each gets their configured share
+    of the number of requests. It works as follows:</p>
 
     <p><dfn>lbfactor</dfn> is <em>how much we expect this worker
-    to work</em>, or <em>the workers's work quota</em>.</p>
+    to work</em>, or <em>the workers's work quota</em>. This is
+    a normalized value representing their "share" of the amount of
+    work to be done.</p>
 
     <p><dfn>lbstatus</dfn> is <em>how urgent this worker has to work
     to fulfill its quota of work</em>.</p>
@@ -76,7 +92,8 @@ load balancing </td></tr>
     which of them needs to work most urgently (biggest lbstatus).  This
     worker is then selected for work, and its lbstatus reduced by the
     total work quota we distributed to all workers.  Thus the sum of all
-    lbstatus does not change.(*)</p>
+    lbstatus does not change(*) and we distribute the requests
+    as desired.</p>
 
     <p>If some workers are disabled, the others will
     still be scheduled correctly.</p>
@@ -135,7 +152,49 @@ candidate lbstatus -= total factor</code></pre></div>
 
     <p>That is it schedules: <var>a</var> <var>c</var> <var>d</var>
     <var>a</var> <var>c</var> <var>d</var> <var>a</var> <var>c</var>
-    <var>d</var> ...</p>
+    <var>d</var> ... Please note that:</p>
+
+    <table><tr><th>worker</th>
+        <th class="data">a</th>
+        <th class="data">b</th>
+        <th class="data">c</th>
+        <th class="data">d</th></tr>
+<tr><th>lbfactor</th>
+        <td class="data">25</td>
+        <td class="data">25</td>
+        <td class="data">25</td>
+        <td class="data">25</td></tr>
+</table>
+
+    <p>Has the exact same behavior as:</p>
+
+    <table><tr><th>worker</th>
+        <th class="data">a</th>
+        <th class="data">b</th>
+        <th class="data">c</th>
+        <th class="data">d</th></tr>
+<tr><th>lbfactor</th>
+        <td class="data">1</td>
+        <td class="data">1</td>
+        <td class="data">1</td>
+        <td class="data">1</td></tr>
+</table>
+
+    <p>This is because all values of <dfn>lbfactor</dfn> are normalized
+    with respect to the others. For:</p>
+
+    <table><tr><th>worker</th>
+        <th class="data">a</th>
+        <th class="data">b</th>
+        <th class="data">c</th></tr>
+<tr><th>lbfactor</th>
+        <td class="data">1</td>
+        <td class="data">4</td>
+        <td class="data">1</td></tr>
+</table>
+
+    <p>worker <var>b</var> will, on average, get 4 times the requests
+    that <var>a</var> and <var>c</var> will.</p>
 
     <p>The following asymmetric configuration works as one would expect:</p>
 
@@ -183,6 +242,39 @@ candidate lbstatus -= total factor</code></pre></div>
     are selected with 3 <var>b</var> interspersed.</p>
 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
+<h2><a name="traffic" id="traffic">Weighted Traffic Counting Algorithm</a></h2>
+    
+    <p>Enabled via <code>lbmethod=traffic</code>, the idea behind this
+    scheduler is very similar to the Request Counting method, with
+    the following changes:</p>
+
+    <p><dfn>lbfactor</dfn> is <em>how much traffic, in bytes, we want
+    this worker to handle</em>. This is also a normalized value
+    representing their "share" of the amount of work to be done,
+    but instead of simply counting the number of requests, we take
+    into account the amount of traffic this worker has seen.</p>
+
+    <p>If a balancer is configured as follows:</p>
+    
+    <table><tr><th>worker</th>
+        <th class="data">a</th>
+        <th class="data">b</th>
+        <th class="data">c</th></tr>
+<tr><th>lbfactor</th>
+        <td class="data">1</td>
+        <td class="data">2</td>
+        <td class="data">1</td></tr>
+</table>
+
+    <p>Then we mean that we want <var>b</var> to process twice the
+    amount of bytes than <var>a</var> or <var>c</var> should. It does
+    not necessarily mean that <var>b</var> would handle twice as
+    many requests, but it would process twice the I/O. Thus, the
+    size of the request and response are applied to the weighting
+    and selection algorithm.</p>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
 <h2><a name="enable" id="enable">Enabling Balancer Manager Support</a></h2>
     
     <p>This module <em>requires</em> the service of 
index 6099bf8fa9854849b1c98d5a41cff3f76b20a8ab..ee1e8c757fe86aabf95322138f6334ed8b19877e 100644 (file)
@@ -23,8 +23,7 @@
 <modulesynopsis metafile="mod_proxy_balancer.xml.meta">
 
 <name>mod_proxy_balancer</name>
-<description><module>mod_proxy</module> extension for
-load balancing </description>
+<description><module>mod_proxy</module> extension for load balancing </description>
 <status>Extension</status>
 <sourcefile>proxy_balancer.c</sourcefile>
 <identifier>proxy_balancer_module</identifier>
@@ -51,10 +50,25 @@ load balancing </description>
 
 <section id="scheduler">
     <title>Load balancer scheduler algorithm</title>
-    <p>The idea behind this scheduler is the following:</p>
+    <p>At present, there are 2 load balancer scheduler algorithms available
+    for use: Request Counting and Weighted Traffic Counting. These are controlled
+    via the <code>lbmethod</code> value of the Balancer definition. See
+    the <directive module="mod_proxy">Proxy</directive> directive for
+    more information.</p>
+
+</section>
+
+<section id="requests">
+    <title>Request Counting Algorithm</title>
+    <p>Enabled via <code>lbmethod=requests</code>, the idea behind this
+    scheduler is that we distribute the requests among the
+    various workers to ensure that each gets their configured share
+    of the number of requests. It works as follows:</p>
 
     <p><dfn>lbfactor</dfn> is <em>how much we expect this worker
-    to work</em>, or <em>the workers's work quota</em>.</p>
+    to work</em>, or <em>the workers's work quota</em>. This is
+    a normalized value representing their "share" of the amount of
+    work to be done.</p>
 
     <p><dfn>lbstatus</dfn> is <em>how urgent this worker has to work
     to fulfill its quota of work</em>.</p>
@@ -66,7 +80,8 @@ load balancing </description>
     which of them needs to work most urgently (biggest lbstatus).  This
     worker is then selected for work, and its lbstatus reduced by the
     total work quota we distributed to all workers.  Thus the sum of all
-    lbstatus does not change.(*)</p>
+    lbstatus does not change(*) and we distribute the requests
+    as desired.</p>
 
     <p>If some workers are disabled, the others will
     still be scheduled correctly.</p>
@@ -128,7 +143,52 @@ candidate lbstatus -= total factor</code></pre>
 
     <p>That is it schedules: <var>a</var> <var>c</var> <var>d</var>
     <var>a</var> <var>c</var> <var>d</var> <var>a</var> <var>c</var>
-    <var>d</var> ...</p>
+    <var>d</var> ... Please note that:</p>
+
+    <table style="data">
+    <tr><th>worker</th>
+        <th>a</th>
+        <th>b</th>
+        <th>c</th>
+        <th>d</th></tr>
+    <tr><th>lbfactor</th>
+        <td>25</td>
+        <td>25</td>
+        <td>25</td>
+        <td>25</td></tr>
+    </table>
+
+    <p>Has the exact same behavior as:</p>
+
+    <table style="data">
+    <tr><th>worker</th>
+        <th>a</th>
+        <th>b</th>
+        <th>c</th>
+        <th>d</th></tr>
+    <tr><th>lbfactor</th>
+        <td>1</td>
+        <td>1</td>
+        <td>1</td>
+        <td>1</td></tr>
+    </table>
+
+    <p>This is because all values of <dfn>lbfactor</dfn> are normalized
+    with respect to the others. For:</p>
+
+    <table style="data">
+    <tr><th>worker</th>
+        <th>a</th>
+        <th>b</th>
+        <th>c</th></tr>
+    <tr><th>lbfactor</th>
+        <td>1</td>
+        <td>4</td>
+        <td>1</td></tr>
+    </table>
+
+    <p>worker <var>b</var> will, on average, get 4 times the requests
+    that <var>a</var> and <var>c</var> will.</p>
 
     <p>The following asymmetric configuration works as one would expect:</p>
 
@@ -177,6 +237,40 @@ candidate lbstatus -= total factor</code></pre>
     are selected with 3 <var>b</var> interspersed.</p>
 </section>
 
+<section id="traffic">
+    <title>Weighted Traffic Counting Algorithm</title>
+    <p>Enabled via <code>lbmethod=traffic</code>, the idea behind this
+    scheduler is very similar to the Request Counting method, with
+    the following changes:</p>
+
+    <p><dfn>lbfactor</dfn> is <em>how much traffic, in bytes, we want
+    this worker to handle</em>. This is also a normalized value
+    representing their "share" of the amount of work to be done,
+    but instead of simply counting the number of requests, we take
+    into account the amount of traffic this worker has seen.</p>
+
+    <p>If a balancer is configured as follows:</p>
+    
+    <table style="data">
+    <tr><th>worker</th>
+        <th>a</th>
+        <th>b</th>
+        <th>c</th></tr>
+    <tr><th>lbfactor</th>
+        <td>1</td>
+        <td>2</td>
+        <td>1</td></tr>
+    </table>
+
+    <p>Then we mean that we want <var>b</var> to process twice the
+    amount of bytes than <var>a</var> or <var>c</var> should. It does
+    not necessarily mean that <var>b</var> would handle twice as
+    many requests, but it would process twice the I/O. Thus, the
+    size of the request and response are applied to the weighting
+    and selection algorithm.</p>
+
+</section>
+
 <section id="enable">
     <title>Enabling Balancer Manager Support</title>
     <p>This module <em>requires</em> the service of 
index 45584ce4174eac8c0b7b189c34cab27d04884186..aee74719a1e28e44a531ccad92f261fc98a1fcad 100644 (file)
@@ -171,7 +171,7 @@ of user groups for authorization</td></tr>
 group membership</td></tr>
 <tr class="odd"><td><a href="mod_authnz_ldap.html#authldapremoteuserisdn">AuthLDAPRemoteUserIsDN on|off</a></td><td> off </td><td>dh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Use the DN of the client username to set the REMOTE_USER
 environment variable</td></tr>
-<tr><td><a href="mod_authnz_ldap.html#authldapurl">AuthLDAPUrl <em>url</em></a></td><td></td><td>dh</td><td>E</td></tr><tr><td class="descr" colspan="4">URL specifying the LDAP search parameters</td></tr>
+<tr><td><a href="mod_authnz_ldap.html#authldapurl">AuthLDAPUrl <em>url [NONE|SSL|TLS|STARTTLS]</em></a></td><td></td><td>dh</td><td>E</td></tr><tr><td class="descr" colspan="4">URL specifying the LDAP search parameters</td></tr>
 <tr class="odd"><td><a href="core.html#authname">AuthName <var>auth-domain</var></a></td><td></td><td>dh</td><td>C</td></tr><tr class="odd"><td class="descr" colspan="4">Authorization realm for use in HTTP
 authentication</td></tr>
 <tr><td><a href="core.html#authtype">AuthType Basic|Digest</a></td><td></td><td>dh</td><td>C</td></tr><tr><td class="descr" colspan="4">Type of user authentication</td></tr>
index 54784498872b3f9a9fdb2ae0060dcbc452a9b316..d4a28e6b0c438ec5012818d6b070a53f73ce7b13 100644 (file)
         <li>Download the source code and unzip to an appropriate directory on
         your workstation.</li>
 
-        <li>Change directory to <code>\httpd-2.0\srclib\apr-util\uri</code> and build
-        <code>GENURI.nlm</code> by running "<code>gmake -f nwgnumakefile</code>".</li>
-
-        <li>Copy the file <code>GENURI.nlm</code> to the <code>SYS:</code> volume
-        of a NetWare server and run using the following command:
-          <div class="example"><p><code>SYS:\genuri &gt; sys:\uri_delims.h</code></p></div>
+        <li>Change directory to <code>\httpd-2.0</code> and build the prebuild utilities
+        by running "<code>gmake -f nwgnumakefile prebuild</code>". This target will create
+        the directory <code>\httpd-2.0\nwprebuild</code> and copy each of the utilities 
+        to this location that are necessary to complete the following build steps.
         </li>
 
-        <li>Copy the file <code>uri_delims.h</code> to the directory
-        <code>\httpd-2.0\srclib\apr-util\uri</code> on the build machine.</li>
-
-        <li>Change directory to <code>\httpd-2.0\srclib\apr</code> and build APR
-        by running "<code>gmake -f nwgnumakefile</code>"</li>
-
-        <li>Change directory to <code>\httpd-2.0\srclib\pcre</code> and build
-        <code>DFTABLES.nlm</code> by running "<code>gmake -f nwgnumakefile</code>"</li>
-
-        <li>Change directory to <code>\httpd-2.0\server</code> and build
-        <code>GENCHARS.nlm</code> by running "<code>gmake -f nwgnumakefile</code>"</li>
-
-        <li>Copy the files <code>GENCHARS.nlm</code> and <code>DFTABLES.nlm</code>
-        from their respective directories to the <code>SYS:</code> volume of a
+        <li>Copy the files <code>\httpd-2.0\nwprebuild\GENCHARS.nlm</code> and 
+        <code>\httpd-2.0\nwprebuild\DFTABLES.nlm</code> to the <code>SYS:</code> volume of a
         NetWare server and run them using the following commands:
           <div class="example"><p><code>
             SYS:\genchars &gt; sys:\test_char.h<br />
         distribution with binaries, docs and additional support files in a
         <code>\dist\Apache2</code> directory.</p></li>
 
+        <li><code>gmake -f nwgnumakefile prebuild</code><p>Builds all of the prebuild utilities
+        and copies them to the <code>\nwprebuild</code> directory.</p></li>
+
         <li><code>gmake -f nwgnumakefile installdev</code><p>Same as install but also creates a
         <code>\lib</code> and <code>\include</code> directory in the destination directory
         and copies headers and import files.</p></li>
 
         <li><code>gmake -f nwgnumakefile clean</code><p>Cleans all object files and binaries
-        from the <code>\release</code> or <code>\debug</code> build areas depending on whether
+        from the <code>\release.o</code> or <code>\debug.o</code> build areas depending on whether
         <code>DEBUG</code> has been defined.</p></li>
 
         <li><code>gmake -f nwgnumakefile clobber_all</code><p>Same as clean and also deletes
index 1242777772d66a7cc7e8be72b76aa1332d96647f..9a7031b55c77b0cb199bbf46ff72df086c4260ab 100644 (file)
@@ -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: 105989:151408 (outdated) -->
+<!-- English Revision: 105989:152957 (outdated) -->
 
 <!--
  Copyright 2004-2005 The Apache Software Foundation or its licensors,