第 3 章
配置负载平衡和故障转移

本章介绍了如何设置 Sun Java System Application Server 中的 HTTP 请求的负载平衡。并说明了如何配置由负载平衡器所控制的服务器实例之间的故障转移。此外，本章还讨论了 RMI-IIOP 负载平衡和故障转移。

它包含以下各节：

关于 HTTP 负载平衡和故障转移
为 HTTP 负载平衡配置 Web 服务器
HTTP 负载平衡器配置任务
升级应用程序
关于 RMI-IIOP 负载平衡和故障转移

---

关于 HTTP 负载平衡和故障转移

HTTP 负载平衡和故障转移
HTTP 负载平衡的要求
了解指定的请求和未指定的请求
HTTP 负载平衡算法
HTTP 负载平衡设置概述

HTTP 负载平衡和故障转移

负载平衡的目的是在多个 Sun Java System Application Server 实例（独立或群集）之间平均分配工作量，从而提高系统的整体吞吐量。

使用负载平衡器还可以启用从一个服务器实例故障转移到另一个服务器实例的请求。对于要保留的 HTTP 会话信息，请配置 HTTP 会话持久性。有关更多信息，请参见“配置可用性和会话持久性”。

使用 asadmin 工具而不是管理控制台来配置 HTTP 负载平衡。

HTTP 负载平衡的要求

在使用负载平衡器插件进行 HTTP 请求之前，必须满足以下要求：

已安装 Sun Java System Application Server Enterprise Edition。
安装并配置了 Web 服务器。

有关更多信息，请参见“为 HTTP 负载平衡配置 Web 服务器”。

已安装负载平衡器插件。
已配置 Application Server。
已创建参与负载平衡的 Application Server 实例或群集。
应用程序已部署到参与负载平衡的所有 Application Server 实例或群集中。
参与负载平衡的服务器实例和群集必须具有同构环境。通常，这意味着服务器实例将引用相同的服务器配置，并且部署到服务器实例中的应用程序也相同。

了解指定的请求和未指定的请求

在某个请求首次从 HTTP 客户机传入负载平衡器时，该请求为新会话请求。新会话请求称为未指定的请求。负载平衡器会根据循环（共享）算法将此请求路由到群集中的应用程序服务器实例。有关更多信息，请参见“HTTP 负载平衡算法”。

在某个应用程序服务器实例中创建会话后，负载平衡器会将此会话的所有后续请求都路由到该特定实例而且只路由到该实例。现有会话的请求称为指定的或粘性请求。

HTTP 负载平衡算法

Sun Java System Application Server 负载平衡器使用粘性 Round Robin 算法对收到的 HTTP 和 HTTPS 请求进行负载平衡。给定会话的所有请求都将被发送到同一个应用程序服务器实例。使用粘性负载平衡器，会话数据将被高速缓存在单个应用程序服务器上，而不会被分布到群集中的所有实例。

因此，粘性 Round Robin 方案能够带来明显的性能优势，这些优势超过了使用纯 Round Robin 带来的更加平均分布负载的优势。

关于粘性 Round Robin 负载平衡算法

当新的 HTTP 请求发送到负载平衡器插件时，系统将基于简单的循环（共享）方案将该请求转发到某个应用程序服务器实例；随后，将通过使用 Cookie 或显式 URL 重写将该请求“粘”到此特定应用程序服务器实例上。

从粘性信息中，负载平衡器插件将首先确定请求先前被转发到的实例。如果发现该实例工作正常，负载平衡器插件会将请求转发至该特定应用程序服务器实例。因此，给定会话的所有请求都将被发送到同一个应用程序服务器实例。

负载平衡器插件使用以下方法来确定会话粘性：

基于 Cookie 的方法
显式 URL 重写方法

基于 Cookie 的方法

在基于 Cookie 的方法中，负载平衡器插件使用一个单独的 Cookie 来记录路由信息。

注	要使用基于 Cookie 的方法，HTTP 客户机必须支持 Cookie。

显式 URL 重写方法

在显式 URL 重写方法中，粘性信息将被附加至 URL。即使 HTTP 客户机不支持 Cookie，也可以使用此方法。

负载平衡和故障转移样例应用程序

以下目录包含了用于演示负载平衡和故障转移的样例应用程序：

install_dir/samples/ee-samples/highavailability
install_dir/samples/ee-samples/failover

ee-samples 目录还包含有关设置运行样例的环境的信息。

HTTP 负载平衡设置概述

使用 asadmin 工具可以在您的环境中配置负载平衡。请执行以下步骤：

完成“HTTP 负载平衡的要求”，包括安装和配置 Web 服务器和 Application Server 实例和（或）群集。
使用 asadmin 命令 create-http-lb-config 创建负载平衡器配置。
使用 asadmin create-http-lb-ref 为要管理的负载平衡器添加对群集和独立服务器实例的引用。

如果您创建了具有目标的负载平衡器配置，并且该目标是负载平衡器引用的唯一群集或独立服务器实例，则请跳过此步骤。

使用 asadmin enable-http-lb-server 启用负载平衡器引用的群集或独立服务器实例。
使用 asadmin enable-http-lb-application 启用要用于负载平衡的应用程序。

这些应用程序必须已部署到负载平衡器所引用的群集或独立实例上，并且已启用，可以在群集或独立实例上使用。启用应用程序以用于负载平衡与启用以使用这些应用程序是两个独立的步骤。

使用 asadmin create-health-checker 创建运行状况检查器。

运行状况检查器监视工作异常的服务器实例，以便在这些服务器实例重新正常工作时，负载平衡器可以向它们发送新请求。

使用 asadmin export-http-lb-config 生成负载平衡器配置文件。

此命令用于生成要同 Sun Java System Application Server 附带的负载平衡器插件一起使用的配置文件。

将负载平衡器配置文件复制到 Web 服务器的 config 目录，此目录中存储了负载平衡器插件配置文件。

---

为 HTTP 负载平衡配置 Web 服务器

关于 Web 服务器配置
对 Sun Java System Web Server 的修改
对 Apache Web Server 的修改
对 Microsoft IIS 的修改
配置多个 Web 服务器实例

关于 Web 服务器配置

负载平衡器插件安装程序将对 Web 服务器的配置文件进行一些修改。所作的更改取决于该 Web 服务器。

注	在运行支持的 Web 服务器的计算机上，负载平衡器插件可随 Sun Java System Application Server Enterprise Edition 一起安装，也可单独安装。 有关安装过程的完整信息，请参见 Sun Java System Application Server 安装指南。

对 Sun Java System Web Server 的修改

安装程序将对 Sun Java System Web Server 的配置文件进行以下更改：

将以下负载平衡器插件特定的条目添加到 Web 服务器实例的 magnus.conf 文件中：

##EE lb-plugin
Init fn="load-modules" shlib="web_server_install_dir/plugins/lbplugin/bin/libpassthrough.so" funcs="init-passthrough,service-passthrough,name-trans-passthrough" Thread="no"

Init fn="init-passthrough"

##end addition for EE lb-plugin

将以下特定于负载平衡器插件的条目添加到 Web 服务器实例的 obj.conf 文件中：
<Object name=default> NameTrans fn="name-trans-passthrough" name="lbplugin" config-file="web_server_install_dir/web_server_instance/config/loadbalancer.xml" <Object name="lbplugin">
ObjectType fn="force-type" type="magnus-internal/lbplugin"
PathCheck fn="deny-existence" path="*/WEB-INF/*"
Service type="magnus-internal/lbplugin" fn="service-passthrough"
Error reason="Bad Gateway" fn="send-error" uri="$docroot/badgateway.html"
</object>

lbplugin 是唯一标识 Object 的名称；web_server_install_dir/web_server_instance/config/loadbalancer.xml 是负载平衡器要在其上运行的虚拟服务器的 XML 配置文件所在的位置。

安装后，请按照“HTTP 负载平衡设置概述”中的说明配置负载平衡器。

对 Apache Web Server 的修改

在 Apache 上安装负载平衡器插件之前，请参见附录 A“编译和配置 Apache Web Server”中有关编译和配置 Apache 的信息。

安装程序所作的修改

负载平衡器插件安装程序将所需文件解压缩到 Web 服务器根目录下的 libexec (Apache 1.3) 或 modules (Apache 2.0) 文件夹下。它将以下特定于负载平衡器插件的条目添加到 Web 服务器实例的 httpd.conf 文件中：

<VirtualHost machine_name:443>

##Addition for EE lb-plugin

LoadFile /usr/lib/libCstd.so.1

LoadModule apachelbplugin_module libexec/mod_loadbalancer.so
#AddModule mod_apachelbplugin.cpp
<IfModule mod_apachelbplugin.cpp>
config-file webserver_instance/conf/loadbalancer.xml
locale en
</IfModule>

<VirtualHost machine_ip_address>
DocumentRoot "webserver_instance/htdocs"
ServerName server_name
</VirtualHost>

##END EE LB Plugin ParametersVersion 7

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

安装后的修改

对 Microsoft Windows 的其他修改

如果是在 Microsoft Windows 上运行 Apache，则在安装插件后，需要更改某些环境变量：

通过单击“开始”->“设置”->“控制面板”->“系统”->“高级”->“环境变量”->“系统变量”将新路径添加到 Path 环境变量中。编辑 Path 变量使其包含以下路径：

application_server_install_dir/bin

此外，在启动 Apache Web 服务器之前，请将环境变量 NSPR_NATIVE_THREADS_ONLY 设置为 1。

在“环境变量”窗口的“系统变量”下，单击“新建”。输入以下名称和值对：

变量名：NSPR_NATIVE_THREADS_ONLY

变量值： 1

重新启动计算机。

对 Microsoft IIS 的修改

要配置 Microsoft Internet 信息服务 (IIS) 以使用负载平衡器插件，请修改 Windows Internet 服务管理器中的某些属性。Internet 服务管理器位于“控制面板”文件夹的“管理工具”文件夹中。

安装 Sun Java System Application Server 后，请执行以下修改。

打开 Internet 服务管理器。
选择要为其启用插件的 Web 站点。此 Web 站点通常命名为“默认的 Web 站点”。
在此 Web 站点上单击鼠标右键，并选择“属性”以打开“属性”记事本。
要添加新的 ISAPI 过滤器，请打开“ISAPI 过滤器”选项卡，单击“添加”，然后执行以下步骤：
在“过滤器名”字段中，输入 Application Server
在“可执行文件”字段中，键入 C:\Inetpub\wwwroot\sun-passthrough\sun-passthrough.dll
单击“确定”关闭“属性”记事本。
创建并配置新的虚拟目录：
在默认的 Web 站点上单击鼠标右键，选择“新建”，然后选择“虚拟目录”。

将打开“虚拟目录创建向导”。

在“别名”字段中，键入 sun-passthrough。
在“目录”字段中，键入 C:\Inetpub\wwwroot\sun-passthrough
选中“执行权限”复选框。使与权限相关的所有其他复选框保持未选中状态。
单击“完成”。
将 sun-passthrough.dll 文件的路径和 application_server_install_dir/bin 添加到系统的 PATH 环境变量中。重新启动计算机。
停止然后启动 Web 服务器以使新设置生效。

要停止 Web 服务器，请在此 Web 站点上单击鼠标右键，然后选择“停止”。要启动 Web 服务器，请在此 Web 站点上单击鼠标右键，然后选择“启动”。

接下来，在 Web 浏览器中键入以下地址，以访问此 Web 应用程序的上下文根：

http://webserver_name/web_application

其中，webserver_name 是 Web 服务器的主机名或 IP 地址，/web_application 是 C:\Inetpub\wwwroot\sun-passthrough\sun-passthrough.properties 文件中列出的上下文根路径。检验 Web 服务器、负载平衡器插件和 Application Server 是否运行正常。

安装程序将自动配置 sun-passthrough.properties 中的下列属性。您可以更改默认值。

表 3-1 为 Microsoft IIS 自动配置的 sun-passthrough.properties

属性	定义	默认值
lb-config-file	负载平衡器配置文件的路径	IIS_www_root\sun-passthrough\loadbalancer.xml
log-file	负载平衡器日志文件的路径	IIS_www_root\sun-passthrough\lb.log
log-level	Web 服务器的日志级别	INFO

配置多个 Web 服务器实例

Sun Java System Application Server 安装程序不允许在单个计算机上安装多个负载平衡器插件。要在单个群集或多个群集中的单个计算机上安装多个带有负载平衡器插件的 Web 服务器，需要手动执行一些步骤来配置负载平衡器插件。

配置新的 Web 服务器实例以使用负载平衡器插件，如“对 Sun Java System Web Server 的修改”、“对 Apache Web Server 的修改”或“对 Microsoft IIS 的修改”所述。
将 sun-loadbalancer_1_1.dtd 文件从现有 Web 服务器实例的 config 目录复制到新实例的 config 目录中。
要使用相同的负载平衡器配置，请将 loadbalancer.xml 文件从现有的 Web 服务器实例的 config 目录复制到新实例的 config 目录中。
要使用其他负载平衡器配置，请执行以下步骤：
使用 asadmin create-http-lb-config 创建新的负载平衡器配置。
使用 asadmin export http-lb-config 将新配置导出到 loadbalancer.xml 文件中。
将 loadbalancer.xml 文件复制到新 Web 服务器的 config 目录中。

有关创建负载平衡器配置并将其导出到 loadbalancer.xml 文件的信息，请参见“HTTP 负载平衡器配置任务”。

---

HTTP 负载平衡器配置任务

创建 HTTP 负载平衡器配置
创建 HTTP 负载平衡器引用
启用用于负载平衡的服务器实例
启用用于负载平衡的应用程序
创建 HTTP 运行状况检查器
导出负载平衡器配置文件
更改 HTTP 负载平衡器配置
启用动态重新配置
禁用（停止）服务器实例或群集
禁用（停止）应用程序
配置 HTTP 和 HTTPS 会话故障转移
配置幂等 URL
配置 HTML 错误页面

创建 HTTP 负载平衡器配置

负载平衡器配置是定义负载平衡器的 domain.xml 文件中的命名配置。

负载平衡配置非常灵活：

尽管每个负载平衡器只有一个负载平衡器配置，但每个负载平衡器配置可以关联多个负载平衡器。
尽管一个域可以关联多个负载平衡器，但一个负载平衡器只为一个域提供服务。

使用 asadmin 命令 create-http-lb-config 创建配置。指定下列参数：

response timeout

服务器实例必须返回响应的时间（以秒为单位）。如果在该时间段内未收到任何响应，则服务器将被视为处于异常状态。默认值为 60。

HTTPS routing

指定对负载平衡器的 HTTPS 请求是否会导致对服务器实例的 HTTPS 或 HTTP 请求。

有关更多信息，请参见“配置 HTTP 和 HTTPS 会话故障转移”。

reload interval

检查负载平衡器配置文件 loadbalancer.xml的更改的时间间隔。当检查检测到更改时，系统将重新装入配置文件。0 值禁用重新装入。

有关更多信息，请参见“启用动态重新配置”。

monitor

指定是否为负载平衡器启用监视功能。

有关更多信息，请参见“监视 HTTP 负载平衡器插件”。

routecookie

指定负载平衡器插件用于记录路由信息的 Cookie 的名称。HTTP 客户机必须支持 Cookie。如果您的浏览器设置为在存储 Cookie 之前进行询问，则 Cookie 的名称为 JROUTE。

target

为负载平衡器配置指定目标。指定目标的效果与向该目标添加引用的效果相同。目标可以是群集，也可以是独立实例。

有关更多信息，请参见 create-http-lb-config、delete-http-lb-config 和 list-http-lb-configs 的文档。

创建 HTTP 负载平衡器引用

当您在负载平衡器中创建对独立服务器或群集的引用时，该服务器或群集将被添加到负载平衡器控制的目标服务器和群集的列表中。仍然需要先启用所引用的服务器或群集（使用 enable-http-lb-server），然后才能对该服务器或群集的请求进行负载平衡。如果创建了带有目标的负载平衡器配置，则系统已将该目标添加为引用。

使用 create-http-lb-ref 创建引用。您必须提供负载平衡器配置名称和目标服务器实例或群集。

要删除引用，请使用 delete-http-lb-ref。要删除某个引用，必须先使用 disable-http-lb-server 禁用引用的服务器或群集。

有关更多信息，请参见 create-http-lb-ref 和 delete-http-lb-ref 的文档。

启用用于负载平衡的服务器实例

创建对服务器实例或群集的引用后，请使用 enable-http-lb-server 启用服务器实例或群集。如果在创建负载平衡器配置时使用了某个服务器实例或群集作为目标，则必须启用该服务器实例或群集。

有关更多信息，请参见 enable-http-lb-server 的文档。

启用用于负载平衡的应用程序

负载平衡器管理的所有服务器都必须具有同构配置，包括部署到这些服务器的相同应用程序集。部署和启用某个应用程序以便进行访问（在部署期间或部署之后发生）后，您必须启用该应用程序以进行负载平衡。如果没有为负载平衡启用应用程序，则即使已对该应用程序所部署到的服务器的请求执行了负载平衡和故障转移，也不会对该应用程序的请求执行负载平衡和故障转移。

启用应用程序时，请指定应用程序名称和目标。如果负载平衡器管理了多个目标（例如，两个群集），请在所有目标上启用该应用程序。

有关更多信息，请参见 enable-http-lb-application 的联机帮助。

如果部署了新的应用程序，则还必须启用该应用程序以进行负载平衡并再次导出负载平衡器配置。

创建 HTTP 运行状况检查器

负载平衡器的运行状况检查器将定期检查所有标记为异常的已配置 Application Server 实例。运行状况检查器不是必需的，但如果没有运行状况检查器，或者禁用了运行状况检查器，则不会执行异常实例的定期运行状况检查。

负载平衡器的运行状况检查机制使用 HTTP 与应用程序服务器实例进行通信。运行状况检查器将 HTTP 请求发送给指定的 URL 并等待响应。HTTP 响应标题中的状态码在 100 到 500 之间时表示实例处于正常状态。

创建运行状况检查器

要创建运行状况检查器，请使用 asadmin 的 create-http-health-checker 命令。指定下列参数：

url

指定负载平衡器检查的侦听器的 URL 以确定其运行状况。默认值为 “/”。

interval

指定进行实例的运行状况检查的时间间隔（以秒为单位）。默认值为 30 秒。指定 0 将禁用运行状况检查器。

timeout

指定超时间隔（以秒为单位），必须在该时间间隔内获得响应才能认为侦听器运行正常。默认值为 10 秒。

如果应用程序服务器实例被标记为异常，运行状况检查器将轮询异常实例以确定实例的状态是否已变为正常。运行状况检查器使用指定的 URL 来检查所有异常的应用程序服务器实例，以确定这些异常的应用程序服务器实例是否已返回到正常状态。

如果运行状况检查器发现某个异常实例已变为正常，该实例将被添加到正常实例列表中。

有关更多信息，请参见 create-http-health-checker 和 delete-http-health-checker 的文档。

正常实例的附加运行状况检查属性

create-http-health-checker 创建的运行状况检查器仅检查异常实例。要定期检查正常实例，请在导出的 loadbalancer.xml 文件中设置某些附加属性。

注	只能在导出 loadbalancer.xml 之后对该文件进行手动编辑来设置这些属性。没有等效的 asadmin 命令可以使用。

要检查正常的实例，请设置以下属性：

表 3-2 运行状况检查器属性

属性	定义
active-healthcheck-enabled	True/False 标志，用于表示是否要对正常服务器实例执行 Ping 操作以确定这些实例是否正常。要对服务器实例执行 Ping 操作，请将标志设置为 True。
number-healthcheck-retries	指定在将未响应的服务器实例标记为异常之前，负载平衡器的运行状况检查器执行 Ping 操作的次数。有效范围在 1 到 1000 之间。默认设置值为 3。

通过编辑 loadbalancer.xml 文件来设置属性。例如：

<property name="active-healthcheck-enabled" value="true"/> <property name="number-healthcheck-retries" value="3"/>

如果添加了这些属性，随后编辑并再次导出了 loadbalancer.xml 文件，则必须再次将这些属性添加到该文件中，因为新导出的配置不会包含这些属性。

导出负载平衡器配置文件

Sun Java System Application Server 附带的负载平衡插件使用名为 loadbalancer.xml 的配置文件。使用 asadmin 工具可以在 domain.xml 文件中创建负载平衡器配置。配置了负载平衡环境后，请将其导出到文件中：

使用 asadmin 命令 export-http-lb-config 导出 loadbalancer.xml 文件。

导出用于特定负载平衡器配置的 loadbalancer.xml 文件。您可以指定路径和其他文件名。如果不指定文件名，则该文件将被命名为 loadbalancer.xml.load_balancer_config_name。如果不指定路径，则将在 application_server_install_dir/domains/domain_name/generated 目录中创建该文件。

要在 Windows 上指定路径，请用引号将路径引起来。例如，“c:\sun\AppServer\loadbalancer.xml”。

将已导出的负载平衡器配置文件复制到 Web 服务器的配置目录。

例如，对于 Sun Java System Web Server，该位置可能为 web_server_root/config。

Web 服务器配置目录中的负载平衡器配置文件名必须为 loadbalancer.xml。如果您的文件使用其他名称（例如 loadbalancer.xml.load_balancer_config_name），则必须进行重命名。

更改 HTTP 负载平衡器配置

如果您通过创建或删除对服务器的引用、部署新的应用程序、启用或禁用服务器或应用程序等方法来更改 HTTP 负载平衡器配置，请再次导出负载平衡器配置文件并将该文件复制到 Web 服务器的 config 目录。有关更多信息，请参见“导出负载平衡器配置文件”。

负载平衡器插件将根据在负载平衡器配置中指定的重新装入时间间隔定期检查已更新的配置。在指定的时间值后，如果负载平衡器发现新的配置文件，它将开始使用该配置。

启用动态重新配置

启用动态重新配置后，负载平衡器插件将定期检查已更新的配置。要启用动态重新配置，请执行以下步骤：

要在创建负载平衡器配置时启用动态重新配置，请在运行 asadmin create-http-lb-config 时使用 --reloadinterval 选项。

此选项用于设置检查负载平衡器配置文件 loadbalancer.xml的更改的时间间隔。0 值禁用重新装入。默认情况下，将启用动态重新装入，并且时间间隔设置为 60 秒。

要在禁用动态重新装入后将其启用，或更改重新装入间隔，请使用 asadmin set 命令。

在更改这些设置后，请再次导出负载平衡器配置文件并将其复制到 Web 服务器的 config 目录。

如果启用了先前已禁用的动态重新配置，您还必须重新启动 Web 服务器。

注	如果负载平衡器在尝试进行自我重新配置时遇到硬盘读取错误，它将使用内存中的当前配置。负载平衡器还确保了在覆写现有配置之前，已修改的配置数据符合 DTD。 遇到磁盘读取错误后，将在 Web 服务器的错误日志文件中记录一则警告消息。 Sun Java System Web Server 的错误日志位于：web_server_install_dir/webserver_instance/logs/。

禁用（停止）服务器实例或群集

在因任何原因停止应用程序服务器之前，您希望实例完成正在处理的请求。正常禁用服务器实例或群集的进程称为停止。

负载平衡器使用以下策略来停止应用程序服务器实例：

如果已禁用某个实例（独立实例或群集的一部分），并且超时尚未到期，粘性请求将继续发送到该实例。但是，新请求将不会发送到已禁用的实例。
超时到期后，该实例将被禁用。从负载平衡器到该实例的所有打开的连接将被关闭。即使并非所有粘连至该实例的会话均已失效，负载平衡器也不会将任何请求发送到该实例。负载平衡器会将粘性请求故障转移到另一个正常实例上。

要禁用某个服务器实例或群集，请执行以下步骤：

运行 asadmin disable-http-lb-server，设置超时值（以分钟为单位）。
使用 asadmin export-http-lb-config 导出负载平衡器配置文件。
将导出的配置复制到 Web 服务器的 config 目录。
停止该服务器实例或群集。

禁用（停止）应用程序

在取消部署 Web 应用程序之前，您希望该应用程序完成正在处理的请求。正常禁用应用程序的进程称为停止。

负载平衡器使用以下策略来停止应用程序：

如果禁用了某个应用程序，并且超时尚未到期，负载平衡器将不会转发对已禁用的应用程序的新请求。这些请求将被返回到 Web 服务器。粘性请求将被继续转发，直至超时到期。
超时到期后，该应用程序将被禁用。负载平衡器将不接受对该应用程序的任何请求（包括粘性请求）。

当您从负载平衡器引用的每个服务器实例或群集中禁用应用程序时，则在再次启用该应用程序之前，已禁用的应用程序的用户将遭受服务损失。

如果您从一个服务器实例或群集中禁用应用程序而使该应用程序在其他服务器实例或群集中保持启用状态，则用户仍可访问该应用程序。

要禁用某个应用程序，请执行以下步骤：

运行 asadmin disable-http-lb-application，指定超时值（以分钟为单位）、要禁用的应用程序的名称以及要禁用该应用程序的目标群集或实例。
使用 asadmin export-http-lb-config 导出负载平衡器配置文件。
将导出的配置复制到 Web 服务器的 config 目录。

配置 HTTP 和 HTTPS 会话故障转移

如果 HTTP/HTTPS 会话所连接的原始应用程序服务器实例变为不可用，负载平衡器插件会将这些会话故障转移到其他应用程序服务器实例上。本节介绍了如何配置负载平衡器插件以启用 HTTP/HTTPS 路由选择和会话故障转移。

有关配置 HTTP 会话持久性的信息，请参见“配置可用性和会话持久性”。

本节包括以下主题：

关于 HTTPS 路由选择
配置 HTTPS 路由选择
有关负载平衡 HTTP/HTTPS 请求的已知问题

关于 HTTPS 路由选择

所有收到的请求（无论是 HTTP 请求还是 HTTPS 请求）都是通过负载平衡器插件路由到应用程序服务器实例。但是，如果启用了 HTTPS 路由选择，则负载平衡器插件将仅把 HTTPS 请求转发给使用 HTTPS 端口的应用程序服务器。请注意，HTTPS 路由选择是针对新请求和粘性请求而执行的。

如果收到了 HTTPS 请求且没有正在进行的会话，负载平衡器插件将选择使用已配置的 HTTPS 端口的可用应用程序服务器实例，并将请求转发到该实例。

在正在进行的 HTTP 会话中，如果收到对同一个会话的新 HTTPS 请求，则将使用在 HTTP 会话期间保存的会话和粘性信息来路由 HTTPS 请求。新的 HTTPS 请求将被路由到处理上一个 HTTP 请求的同一服务器上，但是，是在 HTTPS 端口上进行。

配置 HTTPS 路由选择

create-http-lb-config 命令的 httpsrouting 选项用于控制是为正在参与负载平衡的所有应用程序服务器打开还是关闭 HTTPS 路由选择。如果此选项设置为 False，则所有 HTTP 和 HTTPS 请求都将作为 HTTP 请求进行转发。创建新的负载平衡器配置时，请将此选项设置为 True，或者以后使用 asadmin set 命令进行更改。

注	要使用 HTTPS 路由选择，必须配置一个或多个 HTTPS 侦听器。 如果 https-routing 被设置为 true，而新请求或粘性请求传入到没有正常 HTTPS 侦听器的群集中，该请求将生成一个错误。

有关负载平衡 HTTP/HTTPS 请求的已知问题

以下内容讨论了负载平衡器中有关 HTTP/HTTPS 请求处理的限制。

如果某个会话使用 HTTP 和 HTTPS 请求的组合，则第一个请求必须是 HTTP 请求。如果第一个请求是 HTTPS 请求，它后面将不能跟 HTTP 请求。这是因为与 HTTPS 会话关联的 Cookie 不是由浏览器返回的。浏览器将两个不同的协议解释为两个不同的服务器，并启动新的会话。

仅当 httpsrouting 被设置为 true 时，此限制才有效。

如果某个会话具有 HTTP 和 HTTPS 请求的组合，则必须将应用程序服务器实例配置为同时具有 HTTP 和 HTTPS 侦听器。

仅当 httpsrouting 被设置为 true 时，此限制才有效。

如果某个会话具有 HTTP 和 HTTPS 请求的组合，则必须将应用程序服务器实例配置为具有使用标准端口号（即，HTTP 为 80，HTTPS 为 443）的 HTTP 和 HTTPS 侦听器。

不管为 httpsrouting 设置了何值，此限制都有效。

配置幂等 URL

要增强已部署应用程序的可用性，请在负载平衡器所服务的所有应用程序服务器实例上将环境配置为重试失败的幂等 HTTP 请求。此选项用于只读请求（例如，重试搜索请求）。

幂等请求是一种在重试时不会在应用程序中造成任何更改或不一致的请求。在 HTTP 中，某些方法（例如 GET）是幂等的，而其他方法（例如 POST）则不是。重试幂等 URL 不能导致服务器或数据库中的值发生更改。唯一的区别在于用户收到的响应会有所不同。

幂等请求的示例包括搜索引擎查询和数据库查询。基本原则是重试不会导致数据的更新或修改。

请在 sun-web.xml 文件中配置幂等 URL。当您导出负载平衡器配置时，幂等 URL 信息将自动被添加到 loadbalancer.xml 文件中。

有关配置幂等 URL 的更多信息，请参见 Developer's Guide。

配置 HTML 错误页面

您可以将自己的错误页面或某个错误页面的 URL 指定为显示给最终用户。指定错误页面将会覆盖为错误报告配置的所有其他机制。

请在 sun-web.xml 文件中配置 HTML 错误页面。在导出负载平衡器配置时，系统会自动将 HTML 错误页面信息从 sun-web.xml 文件添加到 loadbalancer.xml 文件中。

有关配置 HTML 错误页面的更多信息，请参见 Developer's Guide。

---

监视 HTTP 负载平衡器插件

配置日志消息
日志消息类型
配置监视
了解监视消息

配置日志消息

负载平衡器插件使用 Web 服务器的日志机制来生成日志消息。Application Server 上的默认日志级别被设置为 Sun Java System Web Server (INFO)、Apache Web Server (WARN) 和 Microsoft IIS (INFO) 上的默认日志级别。应用程序服务器日志级别（FINE、FINER 和 FINEST）映射到 Web 服务器上的 DEBUG 级别。

这些日志消息将被写入 Web 服务器日志文件，其形式为可使用脚本进行解析或可被导入电子表格以计算所需的衡量标准的原始数据。

日志消息类型

负载平衡器插件生成以下三组不同的日志消息：

负载平衡器配置器日志消息
请求分发和运行时日志消息
配置器错误消息

负载平衡器配置器日志消息

使用幂等 URL 和错误页面设置时，将记录这些消息。

幂等 URL 模式配置的输出包含以下信息：

当日志级别被设置为详细时：

CONFxxxx: IdempotentUrlPattern configured <url-pattern> <no-of-retries> for web-module : <web-module>

当日志级别被设置为严重时：

CONFxxxx: Duplicate entry of Idempotent URL element <url-pattern> for webModule <web-module> in loadbalancer.xml."

当日志级别被设置为警告时：

CONFxxxx: Invalid IdempotentUrlPatternData <url-pattern> for web-module <web-module>

错误页面 URL 配置的输出包含以下信息（日志级别设置为警告）：

CONFxxxx: Invalid error-url for web-module <web-module>

请求分发和运行时日志消息

在对请求进行负载平衡和分发时，将生成这些日志消息。

每个方法开始的标准日志的输出均包含以下信息（日志级别设置为详细）：

ROUTxxxx: Executing Router method <method_name>

每个方法开始的路由器日志的输出均包含以下信息（日志级别设置为信息）：

ROUTxxxx: Successfully Selected another ServerInstance for idempotent request <Request-URL>

运行时日志的输出包含以下信息（日志级别设置为信息）：

RNTMxxxx: Retrying Idempotent <GET/POST/HEAD> Request <Request-URL>

配置器错误消息

如果存在配置问题（例如，缺少引用的自定义错误页面），将显示这些错误消息。

日志级别设置为信息：

ROUTxxxx: Non Idempotent Request <Request-URL> cannot be retried

Example :: ROUTxxxx: Non Idempotent Request http://sun.com/addToDB?x=11&abc=2 cannot be retried

日志级别设置为详细：

RNTMxxxx: Invalid / Missing Custom error-url / page:<error-url> for web-module:<web-module>

Example :: RNTMxxxx: Invalid / Missing Custom error-url / page:myerror1xyz for web-module: test

配置监视

执行以下步骤可以打开负载平衡器插件日志消息：

设置 Web 服务器中的日志选项。
从 Sun Java System Web Server 的管理控制台中，转到“Magnus 编辑器”选项卡。

将 Log Verbose 选项设置为 On。

对于 Apache Web Server，请将日志级别设置为 DEBUG。
对于 Microsoft IIS，请在 sun-passthrough.properties 文件中将日志级别设置为 FINE。
将负载平衡器配置的 monitor 选项设置为 true。

使用 asadmin create-http-lb-config 命令在最初创建负载平衡器配置时将监视设置为 true，也可以在以后使用 asadmin set 命令将其设置为 true。默认情况下，监视处于禁用状态。

负载平衡器插件记录以下信息：

每个请求的请求开始/停止信息。
当请求从异常实例故障转移到正常实例时的故障转移请求信息。
每个运行状况检查周期结束时的异常实例列表。

注	在负载平衡器插件上启用日志记录后，如果将 Web 服务器日志级别设置为 DEBUG 或设置为打印详细消息，负载平衡器会将 HTTP 会话 ID 写入 Web 服务器日志文件中。因此，如果托管负载平衡器插件的 Web 服务器位于 DMZ 中，请不要在生产环境中使用 DEBUG 或类似的日志级别。 如果必须使用 DEBUG 日志级别，请在 loadbalancer.xml 中将 require-monitor-data 属性设置为 false，以关闭负载平衡器日志记录。

了解监视消息

负载平衡器插件日志消息的格式如下所示：

HTTP 请求的开头处包含以下信息：

RequestStart Sticky(New) <req-id> <time-stamp> <URL>

时间戳值是从 1970 年 1 月 1 日开始的毫秒数。例如：

RequestStart New 123456 602983 http://austen.sun.com/Webapps-simple/servlet/Example1

HTTP 请求的结尾处包含 RequestExit 消息，如下所示：

RequestExit Sticky(New) <req-id> <time-stamp> <URL> <listener-id> <response-time> Failure-<reason for error>(incase of a failure)

例如：

RequestExit New 123456 603001 http://austen.sun.com/Webapps-simple/servlet/Example1 http://austen:2222 18

注	在 RequestExit 消息中，<response-time> 表示从负载平衡器插件方面，请求的往返总时间（以毫秒为单位）。

异常实例列表，如下所示：

UnhealthyInstances <cluster-id> <time-stamp> <listener-id>, <listener-id>...

例如：

UnhealthyInstances cluster1 701923 http://austen:2210, http://austen:3010

故障转移请求列表，如下所示：

FailedoverRequest <req-id> <time-stamp> <URL> <session-id> <failed-over-listener-id> <unhealthy-listener-id>

例如：

FailedoverRequest 239496 705623 http://austen.sun.com/Apps/servlet/SessionTest 16dfdac3c7e80a40 http://austen:4044 http://austen:4045

---

升级应用程序

关于滚动升级
在单个独立群集中进行升级
在两个群集中进行升级

关于滚动升级

要升级应用程序而不使用户遭受任何服务损失，请每次在一个服务器或群集上升级应用程序。群集以透明方式维护一个混合版本环境，用户不会察觉到正在进行升级。这种升级称为滚动升级。

只有在旧版本和新版本的应用程序兼容并且能够同时运行的情况下，才能执行滚动升级。会话信息必须兼容。可以在单个独立群集或在多个群集中执行混合模式的滚动升级。

如果应用程序发生重大更改（例如，对数据库模式的更改），则无法执行混合模式环境中的滚动升级。在这种情况下，升级时请关闭此应用程序。取消部署此应用程序，然后使用相同的名称重新部署已升级的应用程序。

在单个独立群集中进行升级

要在单个独立群集（即不与任何其他群集共享配置的群集）中升级应用程序，请执行以下步骤：

保存旧版本的应用程序或备份域。

要备份域，请使用 asadmin backup-domain 命令。

关闭群集的动态重新配置（如果已启用）。

通过管理控制台：

展开“配置”节点。
单击群集配置的名称。
在“配置系统属性”页面中，取消选中“已启用动态重新配置”框。
单击“保存”

等效的 asadmin 命令为 asadmin set。语法为：

asadmin set --user user --passwordfile password_file cluster_name-config.dynamic-reconfiguration-enabled=false

将已升级的应用程序重新部署到目标 domain 中。如果使用管理控制台进行重新部署，域将自动成为目标。由于已禁用动态重新配置，因此旧应用程序将继续在群集上运行。
使用 asadmin enable-http-lb-application 为实例启用已重新部署的应用程序。
使用 asadmin disable-http-lb-server 禁用一个服务器实例。
使用 asadmin export-http-lb-config 导出负载平衡器配置文件。
将已导出的配置文件复制到 Web 服务器实例的配置目录。例如，对于 Sun Java System Web Server，其位置为 web_server_install_dir/https-host-name/config/loadbalancer.xml
请等待，直至超时到期。监视负载平衡器的日志文件以确保实例已脱机。
在群集中的其他实例仍处于运行状态的情况下，重新启动已禁用的服务器实例。重新启动操作将使服务器与域同步，并更新应用程序。
测试重新启动的服务器上的应用程序，以确保应用程序运行正常。
使用 asadmin enable-http-lb-server 启用服务器实例。
使用 asadmin export-http-lb-config 导出负载平衡器配置文件。
将配置文件复制到 Web 服务器的配置目录。
对群集中的每个实例重复步骤 5 至步骤 13。
当所有服务器实例都包含新的应用程序并且处于运行状态时，请再次为群集启用动态重新配置。

在两个群集中进行升级

保存旧版本的应用程序或备份域。

要备份域，请使用 asadmin backup-domain 命令。

关闭两个群集的动态重新配置（如果已启用）。

通过管理控制台：

展开“配置”节点。
单击其中一个群集配置的名称。
在“配置系统属性”页面中，取消选中“已启用动态重新配置”框。
单击“保存”
对第二个群集重复此过程。

等效的 asadmin 命令为 asadmin set。语法为：

asadmin set --user user --passwordfile password_file cluster_name-config.dynamic-reconfiguration-enabled=false

将已升级的应用程序重新部署到目标 domain 中。如果使用管理控制台进行重新部署，域将自动成为目标。由于已禁用动态重新配置，因此旧应用程序将继续在群集上运行。
使用 asadmin enable-http-lb-application 为群集启用已重新部署的应用程序。
使用 asadmin disable-http-lb-server 从负载平衡器上禁用其中一个群集。
使用 asadmin export-http-lb-config 导出负载平衡器配置文件。
将已导出的配置文件复制到 Web 服务器实例的配置目录。例如，对于 Sun Java System Web Server，其位置为 web_server_install_dir/https-host-name/config/loadbalancer.xml
请等待，直至超时到期。监视负载平衡器的日志文件以确保群集已脱机。
在另一个群集仍处于运行状态的情况下，重新启动已禁用的群集。重新启动操作将导致群集与域同步，并更新应用程序。
测试重新启动的群集上的应用程序，以确保应用程序运行正常。
使用 asadmin enable-http-lb-server 启用群集。
使用 asadmin export-http-lb-config 导出负载平衡器配置文件。
将配置文件复制到 Web 服务器的配置目录。
对另一个群集重复步骤 5 至步骤 13。
当所有服务器实例都包含新的应用程序并且处于运行状态时，请再次为两个群集启用动态重新配置。

---

关于 RMI-IIOP 负载平衡和故障转移

RMI-IIOP 负载平衡和故障转移的要求
RMI-IIOP 负载平衡和故障转移算法

RMI-IIOP 负载平衡和故障转移的要求

Sun Java™ System Application Server 通过 RMI-IIOP 提供远程 EJB 引用和名称服务对象的高可用性。在使用这些功能之前，环境必须满足以下要求：

Sun Java System 已安装 Application Server Enterprise Edition。
存在一个至少包括两个应用程序服务器实例的群集。

有关群集的更多信息，请参见“配置群集”。

J2EE 应用程序已被部署到所有将参与负载平衡的应用程序服务器实例和群集。
已启用 RMI-IIOP 客户机应用程序以用于负载平衡。

系统支持以下两种 RMI/IIOP 客户机的负载平衡：

在应用程序客户机容器 (ACC) 中运行且访问部署在 Application Server 实例上的 EJB 的 Java 应用程序。
不在 ACC 中运行、但访问部署在 Application Server 实例上的 EJB 的 Java 应用程序。

启用基于 RMI-IIOP 的应用程序所需的配置设置取决于客户机的类型。有关配置用于负载平衡的 RMI-IIOP 客户机应用程序的更多信息，请参见《Sun Java System Application Server Developer's Guide》。

有关 RMI-IIOP 故障转移和负载平衡的其他信息，请参见《Sun Java System Application Server High Availability Administration Guide》。

注	不支持通过 SSL 进行 RMI-IIOP 故障转移。

RMI-IIOP 负载平衡和故障转移算法

Sun Java System Application Server 采用了随机算法和循环（共享）算法，用于 RMI-IIOP 路径上的远程 EJB 引用和名称服务对象的负载平衡。

在 RMI-IIOP 客户机首次创建新的 InitialContext 对象时，可用的 Application Server IIOP 端点的列表对于该客户机是随机的。对于该 InitialContext 对象，负载平衡器会将查找请求和其他 InitialContext 操作定向至列表中的第一个端点。如果第一个端点不可用，则使用列表中的第二个端点，依此类推。

随后每次客户机创建新的 InitialContext 对象时，将轮转端点列表，从而将不同的 IIOP 端点用于 InitialContext 操作。

当您从通过 InitialContext 对象获得的引用中获取或创建 Bean 时，将在服务于指定给 InitialContext 对象的 IIOP 端点的 Application Server 实例上创建这些 Bean。对这些 Bean 的引用包括群集中的所有 Application Server 实例的 IIOP 端点地址。

主端点是与用于查找或创建 Bean 的 InitialContext 端点相对应的 Bean 端点。群集中的其他 IIOP 端点将被指定为备用端点。如果 Bean 的主端点不可用，则该 Bean 上的其他请求将故障转移到其中一个备用端点。

RMI-IIOP 样例应用程序

以下目录包含用于演示通过和不通过 ACC 使用 RMI-IIOP 故障转移的样例应用程序。

install_dir/samples/ee-samples/sfsbfailover

有关通过和不通过 ACC 来运行应用程序的说明，请参见该样例附带的 index.html 文件。ee-samples 目录还包含有关设置运行样例的环境的信息。

上一页      目录      下一页

---

版权所有 2004 - 2005 Sun Microsystems, Inc. 保留所有权利。