loadb.html

Sun Java System Application Server Enterprise Edition 8.1 管理指南

</p>
<a name="wp697251"> </a><code class="pCodeline">
<em class="cEmphasis">install_dir</em>/samples/ee-samples/highavailability<br /><em class="cEmphasis">install_dir</em>/samples/ee-samples/failover
</code>
<a name="wp697253"> </a><p class="pParagraph">
<code class="cCode">ee-samples</code> 目录还包含有关设置运行样例的环境的信息。
</p>
<a name="wp697259"> </a><h3 class="pHeading2">
HTTP 负载平衡设置概述
</h3>
<a name="wp697263"> </a><p class="pParagraph">
使用 <code class="cCode">asadmin</code> 工具可以在您的环境中配置负载平衡。请执行以下步骤：
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp697273"> </a><div class="pSmartList1"><li>完成“<a  href="loadb.html#wp697074" tppabs="http://docs.sun.com/source/819-1553/loadb.html#wp697074">HTTP 负载平衡的要求</a>”，包括安装和配置 Web 服务器和 Application Server 实例和（或）群集。</li></div>
<a name="wp697275"> </a><div class="pSmartList1"><li>使用 <code class="cCode">asadmin</code> 命令 <code class="cCode">create-http-lb-config</code> 创建负载平衡器配置。 </li></div>
<a name="wp697277"> </a><div class="pSmartList1"><li>使用 <code class="cCode">asadmin</code> <code class="cCode">create-http-lb-ref</code> 为要管理的负载平衡器添加对群集和独立服务器实例的引用。</li></div>
<a name="wp697279"> </a><p class="pStepParaI1">
如果您创建了具有目标的负载平衡器配置，并且该目标是负载平衡器引用的唯一群集或独立服务器实例，则请跳过此步骤。
</p>
<a name="wp697281"> </a><div class="pSmartList1"><li>使用 <code class="cCode">asadmin enable-http-lb-server</code> 启用负载平衡器引用的群集或独立服务器实例。</li></div>
<a name="wp697283"> </a><div class="pSmartList1"><li>使用 <code class="cCode">asadmin enable-http-lb-application</code> 启用要用于负载平衡的应用程序。</li></div>
<a name="wp697285"> </a><p class="pStepParaI1">
这些应用程序必须已部署到负载平衡器所引用的群集或独立实例上，并且已启用，可以在群集或独立实例上使用。启用应用程序以用于负载平衡与启用以使用这些应用程序是两个独立的步骤。 
</p>
<a name="wp697287"> </a><div class="pSmartList1"><li>使用 <code class="cCode">asadmin</code> <code class="cCode">create-health-checker</code> 创建运行状况检查器。 </li></div>
<a name="wp697289"> </a><p class="pStepParaI1">
运行状况检查器监视工作异常的服务器实例，以便在这些服务器实例重新正常工作时，负载平衡器可以向它们发送新请求。
</p>
<a name="wp697291"> </a><div class="pSmartList1"><li>使用 <code class="cCode">asadmin</code> <code class="cCode">export-http-lb-config</code> 生成负载平衡器配置文件。</li></div>
<a name="wp697301"> </a><p class="pStepParaI1">
此命令用于生成要同 Sun Java System Application Server 附带的负载平衡器插件一起使用的配置文件。 
</p>
<a name="wp697303"> </a><div class="pSmartList1"><li>将负载平衡器配置文件复制到 Web 服务器的 <code class="cCode">config</code> 目录，此目录中存储了负载平衡器插件配置文件。</li></div>
</ol></div>
<a name="wp697331"> </a><h2 class="pHeading1">
<hr />
为 HTTP 负载平衡配置 Web 服务器
</h2>
<div class="pSmartList1"><ul class="pSmartList1">
<a name="wp697337"> </a><div class="pSmartList1"><li><a  href="loadb.html#wp697365" tppabs="http://docs.sun.com/source/819-1553/loadb.html#wp697365">关于 Web 服务器配置</a></li></div>
<a name="wp697343"> </a><div class="pSmartList1"><li><a  href="loadb.html#wp697374" tppabs="http://docs.sun.com/source/819-1553/loadb.html#wp697374">对 Sun Java System Web Server 的修改</a></li></div>
<a name="wp697349"> </a><div class="pSmartList1"><li><a  href="loadb.html#wp697410" tppabs="http://docs.sun.com/source/819-1553/loadb.html#wp697410">对 Apache Web Server 的修改</a></li></div>
<a name="wp697355"> </a><div class="pSmartList1"><li><a  href="loadb.html#wp697465" tppabs="http://docs.sun.com/source/819-1553/loadb.html#wp697465">对 Microsoft IIS 的修改</a></li></div>
<a name="wp697361"> </a><div class="pSmartList1"><li><a  href="loadb.html#wp697536" tppabs="http://docs.sun.com/source/819-1553/loadb.html#wp697536">配置多个 Web 服务器实例</a></li></div>
</ul></div>
<a name="wp697365"> </a><h3 class="pHeading2">
关于 Web 服务器配置
</h3>
<a name="wp697367"> </a><p class="pParagraph">
负载平衡器插件安装程序将对 Web 服务器的配置文件进行一些修改。所作的更改取决于该 Web 服务器。
</p>
<a name="wp697370"> </a><p class="pAnchor">

</p><div align="left">
<table border="0" width="90%" summary="This table is used for Notes, Tips, and Cautions" id="wp696489">
  <caption></caption>
<tr><td colspan="2">
<hr noshade="-1" />
</td></tr>

  <tr align="left" valign="top">    <td><a name="wp696489"> </a><p class="pNote">
注
</p>
</td>
    <td><a name="wp696491"> </a><p class="pParagraph">
在运行支持的 Web 服务器的计算机上，负载平衡器插件可随 Sun Java System Application Server Enterprise Edition 一起安装，也可单独安装。 
</p>
<a name="wp696493"> </a><p class="pParagraph">
有关安装过程的完整信息，请参见 Sun Java System Application Server 安装指南。 
</p>
</td>
</tr>


<tr><td colspan="2">
<hr noshade="-1" />
</td></tr>
</table>
</div>
<p class="pAnchor">

</p>
<a name="wp697374"> </a><h3 class="pHeading2">
对 Sun Java System Web Server 的修改
</h3>
<a name="wp697378"> </a><p class="pParagraph">
安装程序将对 Sun Java System Web Server 的配置文件进行以下更改： 
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp697382"> </a><div class="pSmartList1"><li>将以下负载平衡器插件特定的条目添加到 Web 服务器实例的 <code class="cCode">magnus.conf</code> 文件中： </li></div>
<a name="wp697384"> </a><p class="pStepParaI1">
<code class="cCode">##EE lb-plugin<br />Init fn=&quot;load-modules&quot; shlib=&quot;</code><em class="cEmphasis">web_server_install_dir</em><code class="cCode">/plugins/lbplugin/bin/libpassthrough.so&quot; funcs=&quot;init-passthrough,service-passthrough,name-trans-passthrough&quot; Thread=&quot;no&quot;</code>
</p>
<a name="wp697386"> </a><p class="pStepParaI1">
<code class="cCode">Init fn=&quot;init-passthrough&quot;</code>
</p>
<a name="wp697388"> </a><p class="pStepParaI1">
<code class="cCode">##end addition for EE lb-plugin</code>
</p>
<a name="wp697392"> </a><div class="pSmartList1"><li>将以下特定于负载平衡器插件的条目添加到 Web 服务器实例的 <code class="cCode">obj.conf</code> 文件中：</li></div>
<a name="wp697394"> </a><code class="pCodeline">
&lt;Object name=default&gt;
</code>
<a name="wp697396"> </a><code class="pCodeline">
NameTrans fn=&quot;name-trans-passthrough&quot; name=&quot;lbplugin&quot; config-file=&quot;<em class="cEmphasis">web_server_install_dir/web_server_instance</em>/config/loadbalancer.xml&quot;
</code>
<a name="wp697398"> </a><code class="pCodeline">
&lt;Object name=&quot;lbplugin&quot;&gt;<br />ObjectType fn=&quot;force-type&quot; type=&quot;magnus-internal/lbplugin&quot;<br />PathCheck fn=&quot;deny-existence&quot; path=&quot;*/WEB-INF/*&quot;<br />Service type=&quot;magnus-internal/lbplugin&quot; fn=&quot;service-passthrough&quot;<br />Error reason=&quot;Bad Gateway&quot; fn=&quot;send-error&quot; uri=&quot;$docroot/badgateway.html&quot;<br />&lt;/object&gt;
</code>
<a name="wp697400"> </a><p class="pStepParaI1">
<code class="cCode">lbplugin</code> 是唯一标识 <code class="cCode">Object</code> 的名称；<em class="cEmphasis">web_server_install_dir</em><code class="cCode">/</code><em class="cEmphasis">web_server_instance</em><code class="cCode">/config/loadbalancer.xml</code> 是负载平衡器要在其上运行的虚拟服务器的 XML 配置文件所在的位置。
</p>
</ol></div>
<a name="wp697406"> </a><p class="pParagraph">
安装后，请按照“<a  href="loadb.html#wp697259" tppabs="http://docs.sun.com/source/819-1553/loadb.html#wp697259">HTTP 负载平衡设置概述</a>”中的说明配置负载平衡器。 
</p>
<a name="wp697410"> </a><h3 class="pHeading2">
对 Apache Web Server 的修改
</h3>
<a name="wp697418"> </a><p class="pParagraph">
在 Apache 上安装负载平衡器插件之前，请参见<a  href="apache.html#wp106337" tppabs="http://docs.sun.com/source/819-1553/apache.html#wp106337">附录&#160;A“编译和配置 Apache Web Server”</a>中有关编译和配置 Apache 的信息。
</p>
<a name="wp697420"> </a><h4 class="pHeading3">
安装程序所作的修改
</h4>
<a name="wp697424"> </a><p class="pParagraph">
负载平衡器插件安装程序将所需文件解压缩到 Web 服务器根目录下的 <code class="cCode">libexec</code> (Apache 1.3) 或 <code class="cCode">modules</code> (Apache 2.0) 文件夹下。它将以下特定于负载平衡器插件的条目添加到 Web 服务器实例的 <code class="cCode">httpd.conf</code> 文件中： 
</p>
<a name="wp697426"> </a><p class="pParagraph">
<code class="cCode">&lt;VirtualHost</code> <em class="cEmphasis">machine_name</em>:443<code class="cCode">&gt;</code>
</p>
<a name="wp697428"> </a><p class="pParagraph">
<code class="cCode">##Addition for EE lb-plugin</code>
</p>
<a name="wp697430"> </a><p class="pParagraph">
<code class="cCode">LoadFile /usr/lib/libCstd.so.1</code>
</p>
<a name="wp697432"> </a><p class="pParagraph">
<code class="cCode">LoadModule apachelbplugin_module libexec/mod_loadbalancer.so<br />#AddModule mod_apachelbplugin.cpp<br />&lt;IfModule mod_apachelbplugin.cpp&gt;<br />	config-file </code><em class="cEmphasis">webserver_instance</em><code class="cCode">/conf/loadbalancer.xml<br />locale en<br />&lt;/IfModule&gt;</code>
</p>
<a name="wp697434"> </a><p class="pParagraph">
<code class="cCode">&lt;VirtualHost </code><em class="cEmphasis">machine_ip_address</em><code class="cCode">&gt;<br />DocumentRoot &quot;</code><em class="cEmphasis">webserver_instance</em><code class="cCode">/htdocs&quot;<br />ServerName server_name<br />&lt;/VirtualHost&gt;</code>
</p>
<a name="wp697436"> </a><p class="pParagraph">
<code class="cCode">##END EE LB Plugin ParametersVersion 7</code>
</p>
<a name="wp697439"> </a><p class="pAnchor">

</p><div align="left">
<table border="0" width="90%" summary="This table is used for Notes, Tips, and Cautions" id="wp696499">
  <caption></caption>
<tr><td colspan="2">
<hr noshade="-1" />
</td></tr>

  <tr align="left" valign="top">    <td><a name="wp696499"> </a><p class="pNote">
注
</p>
</td>
    <td><div class="pSmartList1"><ul class="pSmartList1">
<a name="wp696501"> </a><div class="pSmartList1"><li>在 Apache 1.3 上，当多个 Apache 子进程运行时，每个进程都有自己的负载平衡循环（共享）序列。 <br /><br />例如，如果有两个 Apache 子进程正在运行，并且负载平衡插件对两个应用程序服务器实例进行负载平衡，则第一个请求将发送给实例 1，第二个请求也将发送给实例 1，而第三个请求将发送给实例 2，第四个请求也将发送给实例 2。系统将重复执行这种模式（实例 1、实例 1、实例 2、实例 2 等）。<br /><br />此行为可能与您预期的行为（即，实例 1、实例 2、实例 1、实例 2 等）不同。在 Sun Java System Application Server 中，用于 Apache 的负载平衡插件将为每个 Apache 进程启动一个负载平衡器实例，从而创建独立的负载平衡序列。</li></div>
<a name="wp696503"> </a><div class="pSmartList1"><li>如果使用 <code class="cCode">--with-mpm=worker</code> 选项进行编译，则 Apache 2.0 将具有多线程行为。</li></div>
</ul></div>
</td>
</tr>


<tr><td colspan="2">
<hr noshade="-1" />
</td></tr>
</table>
</div>
<p class="pAnchor">

</p>
<a name="wp697441"> </a><h4 class="pHeading3">
安装后的修改
</h4>
<a name="wp697445"> </a><h4 class="pHeading3">
对 Microsoft Windows 的其他修改
</h4>
<a name="wp697447"> </a><p class="pParagraph">
如果是在 Microsoft Windows 上运行 Apache，则在安装插件后，需要更改某些环境变量：
</p>
<a name="wp697449"> </a><p class="pParagraph">
通过单击“开始”-&gt;“设置”-&gt;“控制面板”-&gt;“系统”-&gt;“高级”-&gt;“环境变量”-&gt;“系统变量”将新路径添加到 Path 环境变量中。编辑 Path 变量使其包含以下路径：
</p>
<a name="wp697451"> </a><p class="pParagraph">
<em class="cEmphasis">application_server_install_dir</em><code class="cCode">/bin</code>
</p>
<a name="wp697453"> </a><p class="pParagraph">
此外，在启动 Apache Web 服务器之前，请将环境变量 NSPR_NATIVE_THREADS_ONLY 设置为 1。 
</p>
<a name="wp697455"> </a><p class="pParagraph">
在“环境变量”窗口的“系统变量”下，单击“新建”。输入以下名称和值对：
</p>
<a name="wp697457"> </a><p class="pParagraph">
变量名：NSPR_NATIVE_THREADS_ONLY
</p>
<a name="wp697459"> </a><p class="pParagraph">
变量值： 1