You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by ka...@apache.org on 2005/05/27 03:06:33 UTC

svn commit: r178722 - in /httpd/httpd/trunk/docs/manual: mod/mod_proxy_balancer.xml.ja vhosts/examples.xml.ja

Author: kawai
Date: Thu May 26 18:06:32 2005
New Revision: 178722

URL: http://svn.apache.org/viewcvs?rev=178722&view=rev
Log:
update Japanese translation.

Submitted by: kawai
Reviewed by: OKANO Takayoshi <ka...@na.rim.or.jp>

Modified:
    httpd/httpd/trunk/docs/manual/mod/mod_proxy_balancer.xml.ja
    httpd/httpd/trunk/docs/manual/vhosts/examples.xml.ja

Modified: httpd/httpd/trunk/docs/manual/mod/mod_proxy_balancer.xml.ja
URL: http://svn.apache.org/viewcvs/httpd/httpd/trunk/docs/manual/mod/mod_proxy_balancer.xml.ja?rev=178722&r1=178721&r2=178722&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_proxy_balancer.xml.ja [iso-2022-jp] (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_proxy_balancer.xml.ja [iso-2022-jp] Thu May 26 18:06:32 2005
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="iso-2022-jp"?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
-<!-- English Revision: 105989:153116 (outdated) -->
+<!-- English Revision: 153116 -->
 
 <!--
- Copyright 2004-2005 The Apache Software Foundation or its licensors,
-                     as applicable.
+ Copyright 2004-2005 The Apache Software Foundation or its licensors, as
+ applicable.
 
  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.
@@ -39,12 +39,269 @@
     いなければいけません。</p>
 
     <note type="warning"><title>警告</title>
-      <p><a href="#access"
+      <p><a href="mod_proxy.html#access"
       >安全なサーバにする</a>までプロクシ機能は有効にしないでください。
       オープンプロキシサーバはあなた自身のネットワークにとっても、
       インターネット全体にとっても危険です。</p>
     </note>
 </summary>
 <seealso><module>mod_proxy</module></seealso>
+
+<section id="scheduler">
+    <title>ロードバランサのスケジューラのアルゴリズム</title>
+    <p>現時点では 2 種類のロードバランサスケジューラアルゴリズムから選べます。
+    リクエスト回数によるもの <transnote>Request Counting</transnote>
+    と、トラフィック量によるもの <transnote>Weighted Traffic Counting</transnote>
+    があります。バランサの設定 <code>lbmethod</code> 値で、どちらを使うか指定します。
+    詳細は <directive module="mod_proxy">Proxy</directive> ディレクティブを
+    参照してください。</p>
+
+</section>
+
+<section id="requests">
+    <title>Request Counting アルゴリズム</title>
+    <p><code>lbmethod=requests</code> で有効になります。
+    このスケジューラの背景にある考え方は、様々なワーカーがそれぞれ、
+    設定されている分担リクエスト数をきちんと受け取れるように、
+    リクエストを扱うという考え方です。次のように動作します:</p>
+
+    <p><dfn>lbfactor</dfn> は、<em>どの程度ワーカーに仕事を振るか</em>
+    つまり<em>ワーカーのクオータ</em>を指します。この値は "分担" 
+    量を表す正規化された値です。</p>
+
+    <p><dfn>lbstatus</dfn> は、<em>ワーカーのクオータを満たすために
+    どのぐらい急ぎで働かなければならないか</em>を指します。</p>
+
+    <p><dfn>ワーカー</dfn>はロードバランサのメンバで、通常は、
+    サポートされるプロトコルのうちの一つを提供しているリモートホストです。
+    </p>
+
+    <p>まず個々のワーカーにワーカークオータを割り振り、どのワーカーが最も急ぎで
+    働かなければならないか (lbstatus が最大のもの) を調べます。
+    次に仕事をするようにこのワーカーを選択し、選択したワーカーの lbstatus 
+    を全体に割り振ったぶんだけ差し引きます。ですから、lbstatus の総量は
+    結果的に変化しません(*)し、リクエストは期待通りに分散されます。</p>
+
+    <p>あるワーカーが無効になっても、他のものは正常にスケジュールされ続けます。
+    </p>
+
+    <example><pre><code>for each worker in workers
+    worker lbstatus += worker lbfactor
+    total factor    += worker lbfactor
+    if worker lbstatus > candidate lbstatus
+        candidate = worker
+
+candidate lbstatus -= total factor</code></pre>
+    </example>
+
+    <p>バランサを次のように設定した場合:</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>
+    <tr><th>lbstatus</th>
+        <td>0</td>
+        <td>0</td>
+        <td>0</td>
+        <td>0</td></tr>
+    </table>
+
+    <p>そして <var>b</var> が無効になった場合、次のようなスケジュールが
+    行われます。</p>
+
+    <table style="data">
+    <tr><th>worker</th>
+        <th>a</th>
+        <th>b</th>
+        <th>c</th>
+        <th>d</th></tr>
+    <tr><th>lbstatus</th>
+        <td><em>-50</em></td>
+        <td>0</td>
+        <td>25</td>
+        <td>25</td></tr>
+    <tr><th>lbstatus</th>
+        <td>-25</td>
+        <td>0</td>
+        <td><em>-25</em></td>
+        <td>50</td></tr>
+    <tr><th>lbstatus</th>
+        <td>0</td>
+        <td>0</td>
+        <td>0</td>
+        <td><em>0</em></td></tr>
+    <tr><td colspan="5">(repeat)</td></tr>
+    </table>
+
+    <p>つまりこのようにスケジュールされます: <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>
+
+    <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>この挙動は、次の設定と全く同じになります:</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>
+    <p><dfn>lbfactor</dfn> は全て正規化されたもので、
+    他との相対値だからです。次の設定では:</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>ワーカー <var>b</var> は、平均して、<var>a</var> と <var>c</var>
+    の 4 倍の数のリクエストを受け持つことになります。</p>
+
+    <p>次のような非対称な設定では、こうなると予想されるでしょう:</p>
+
+    <table style="data">
+    <tr><th>worker</th>
+        <th>a</th>
+        <th>b</th></tr>
+    <tr><th>lbfactor</th>
+        <td>70</td>
+        <td>30</td></tr>
+    <tr><td colspan="2">&nbsp;</td></tr>
+    <tr><th>lbstatus</th>
+        <td><em>-30</em></td>
+        <td>30</td></tr>
+    <tr><th>lbstatus</th>
+        <td>40</td>
+        <td><em>-40</em></td></tr>
+    <tr><th>lbstatus</th>
+        <td><em>10</em></td>
+        <td>-10</td></tr>
+    <tr><th>lbstatus</th>
+        <td><em>-20</em></td>
+        <td>20</td></tr>
+    <tr><th>lbstatus</th>
+        <td><em>-50</em></td>
+        <td>50</td></tr>
+    <tr><th>lbstatus</th>
+        <td>20</td>
+        <td><em>-20</em></td></tr>
+    <tr><th>lbstatus</th>
+        <td><em>-10</em></td>
+        <td>10</td></tr>
+    <tr><th>lbstatus</th>
+        <td><em>-40</em></td>
+        <td>40</td></tr>
+    <tr><th>lbstatus</th>
+        <td>30</td>
+        <td><em>-30</em></td></tr>
+    <tr><th>lbstatus</th>
+        <td><em>0</em></td>
+        <td>0</td></tr>
+    <tr><td colspan="3">(repeat)</td></tr>
+    </table>
+
+    <p>スケジュールは 10 スケジュール後に繰り返され、<var>a</var> 7 回と
+    <var>b</var> 3 回でまばらに選ばれます。</p>
+</section>
+
+<section id="traffic">
+    <title>Weighted Traffic Counting アルゴリズム</title>
+    <p><code>lbmethod=traffic</code> で有効になります。
+    このスケジューラの背景にある考え方は、Request Counting 
+    と非常に似ていますが、次の違いがあります:</p>
+
+    <p><dfn>lbfactor</dfn> は <em>どれだけのバイト数のトラフィック量を、
+    このワーカーに処理してもらいたいか</em> を表します。
+    この値も同様に正規化された値で、ワーカー全体のうちでの "分担"
+    量を表現しています。リクエスト数を単純に数える代わりに、
+    どれだけの転送量を処理したかを数えます。</p>
+
+    <p>次のようにバランサを設定した場合:</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><var>b</var> には <var>a</var> や <var>c</var> の 2 倍
+    処理してほしいということになります。
+    <var>b</var> は 2 倍の I/O を処理するという意味になり、
+    2 倍のリクエスト数を処理するということにはなりません。
+    ですからリクエストとレスポンスのサイズが、
+    重み付けと振り分けのアルゴリズムに効いています。</p>
+
+</section>
+
+<section id="enable">
+    <title>バランサマネージャのサポートを有効にする</title>
+    <p>このモジュールは <module>mod_status</module> のサービスを
+    <em>必要とします</em>。
+    バランサマネージャを使うと、バランサのメンバーの動的な更新が
+    できます。バランサマネージャを使って、バランス係数 (lbfactor)
+    を変更したり、メンバーを変更したり、特定のメンバーを
+    オフラインモードにしたりできます。</p>
+
+    <p>ですから、ロードバランサ管理機能を使いたければ、
+    <module>mod_status</module> と <module>mod_proxy_balancer</module>
+    をサーバに組み込まなければなりません。</p>
+
+    <p>foo.com ドメインのブラウザからロードバランサ管理機能を
+    使えるようにするには、次のようなコードを <code>httpd.conf</code>
+    に追加します。</p>
+<example>
+    &lt;Location /balancer-manager&gt;<br />
+    SetHandler balancer-manager<br />
+<br />
+    Order Deny,Allow<br />
+    Deny from all<br />
+    Allow from .foo.com<br />
+    &lt;/Location&gt;
+</example>
+
+    <p>こうすると、<code>http://your.server.name/balancer-manager</code>
+    のページ経由で、ウェブブラウザからロードバランサマネージャに
+    アクセスできるようになります。</p>
+</section>
 
 </modulesynopsis>

Modified: httpd/httpd/trunk/docs/manual/vhosts/examples.xml.ja
URL: http://svn.apache.org/viewcvs/httpd/httpd/trunk/docs/manual/vhosts/examples.xml.ja?rev=178722&r1=178721&r2=178722&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/vhosts/examples.xml.ja [iso-2022-jp] (original)
+++ httpd/httpd/trunk/docs/manual/vhosts/examples.xml.ja [iso-2022-jp] Thu May 26 18:06:32 2005
@@ -1,11 +1,11 @@
 <?xml version='1.0' encoding='iso-2022-jp' ?>
 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
-<!-- English Revision: 105989:151408 (outdated) -->
+<!-- English Revision: 151408  -->
 
 <!--
- Copyright 2004-2005 The Apache Software Foundation or its licensors,
-                     as applicable.
+ Copyright 2002-2005 The Apache Software Foundation or its licensors, as
+ applicable.
 
  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.
@@ -31,8 +31,7 @@
     href="name-based.html">名前ベース</a> や <a
     href="ip-based.html">IP ベース</a> のバーチャルホストを使って
     一つのサーバで複数のウェブサイトを運用している状況です。
-    一つのプロキシサーバの後ろで複数のサーバを運用するサイト向けの
-    説明は近々書かれるはずです。</p>
+    </p>
 
 </summary>
 
@@ -302,7 +301,7 @@
 
     <p>サーバマシンはそれぞれ <code>www.example.com</code> と
     <code>www.example.org</code> にそれぞれ解決される、IP アドレスを二つ
-    (<code>192.168.1.1</code> と <code>172.20.30.40</code>) 持っています。
+    (<code>172.20.30.40</code> と <code>172.20.30.50</code>) 持っています。
     どちらもポート 80 と 8080 でホストを走らせます。</p>
 
     <example>
@@ -396,6 +395,27 @@
 
     </section>
 
+    <section id="proxy"><title><code>Virtual_host</code> と
+    mod_proxy を併用する</title>
+
+    <p>次の例は、フロント側のバーチャルホストで他のマシンへプロクシします。
+    例では <code>192.168.111.2</code> のマシンではバーチャルホスト名は
+    同じ名前で設定されています。複数のホスト名を一台のマシンにプロクシする
+    場合は、<directive module="mod_proxy">ProxyPreserveHost On</directive>
+    ディレクティブを使って、希望のホスト名を渡せるようになります。
+    </p>
+
+    <example>
+    &lt;VirtualHost *:*&gt;<br />
+        ProxyPreserveHost On<br />
+        ProxyPass / http://192.168.111.2<br />
+        ProxyPassReverse / http://192.168.111.2/<br />
+        ServerName hostname.example.com<br />
+    &lt;/VirtualHost&gt;
+    </example>
+
+    </section>
+
     <section id="default"><title><code>_default_</code> のバーチャルホストを
     使う</title> 
 
@@ -457,7 +477,7 @@
     </example>
 
     <p>80 番ポートのデフォルトバーチャルホスト (ワイルドカードポートの
-    デフォルトバーチャルホストよりも前に書かれていなければなりません) は
+    デフォルトバーチャルホストよりも前に書かれていなければ<em>なりません</em>) は
     未指定の IP アドレスに送られたすべてのリクエストを扱います。
     主サーバはリクエストを扱いません。</p>
     </section>