test

Sun Java System Application Server Enterprise Edition 8.1 2005Q2 高可用性管理指南

第 9 章 Java 消息服务的负载平衡和故障转移

本章介绍了如何配置 Java 消息服务 (Java Message Service, JMS) 的负载平衡和故障转移以与 Application Server 一起使用。本章包含以下主题：

Java 消息服务概述

Java 消息服务 (JMS) API 是一种通讯标准，使 J2EE 应用程序和组件可以创建、发送、接收和读取消息。并启用了松散耦合的可靠异步分布式通信。Sun Java System Message Queue 3 2005Q1 (MQ)（实现了 JMS）与 Application Server 紧密集成，使您可以创建诸如消息驱动 bean (Message-Driven Bean, MDB) 之类的组件。

MQ 使用连接器模块（也称为资源适配器，由 J2EE 连接器体系结构规范 1.5 定义）与 Application Server 集成。部署到 Application Server 的 J2EE 组件使用通过连接器模块集成的 JMS 提供者交换 JMS 消息。在 Application Server 中创建 JMS 资源将会在后台创建连接器资源。因此，每个 JMS 操作将调用连接器运行时并在后台使用 MQ 资源适配器。

您可以通过管理控制台或 asadmin 命令行实用程序管理 Java 消息服务。

样例应用程序

mqfailover 样例应用程序通过消息驱动 Bean（接收来自 JMS 主题的传入消息）演示 MQ 故障转移。样例包含 MDB 和应用程序客户机。Application Server 使 MDB 具有高可用性。如果一个代理出现故障，会话状态（MDB 接收的消息）将被透明地迁移到群集中的另一个可用代理实例中。

样例安装在以下位置：

install_dir/samples/ee-samples/failover/apps/mqfailover

更多信息

有关 JMS 的更多信息，请参见《Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Developer’s Guide》中的第 14  章 “Using the Java Message Service”。有关连接器（资源适配器）的更多信息，请参见《Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Developer’s Guide》中的第 9  章 “Developing Connectors”。

有关 Sun Java System Message Queue 的更多信息，请参见 Sun Java System Message Queue 文档。有关 JMS API 的常规信息，请参见 JMS Web 页。

配置 Java 消息服务

Java 消息服务配置可用于到 Sun Java System Application Server 群集或实例的所有入站和出站连接。您可以使用以下方法配置 Java 消息服务：

您可以使用 JMS 连接工厂设置覆盖 Java 消息服务配置。有关详细信息，请参见《Sun Java System Application Server Enterprise Edition 8.1 2005Q2 管理指南》中的“有关 JMS 连接工厂的管理控制台任务”。

注 –

更改 Java 消息服务的配置之后，您必须重新启动 Application Server 实例。

有关 JMS 管理的更多信息，请参见《Sun Java System Application Server Enterprise Edition 8.1 2005Q2 管理指南》中的第 4  章 “配置 Java 消息服务资源”。

Java 消息服务集成

MQ 可以通过两种方法与 Application Server 集成：LOCAL 和 REMOTE，在管理控制台中由 Java 消息服务的“类型”属性表示。

LOCAL Java 消息服务

“类型”属性为 LOCAL（独立 Application Server 实例的默认值）时，Application Server 将启动和停止指定为默认 JMS 主机的 MQ 代理。LOCAL 类型是适用于独立 Application Server 实例的最佳类型。

要在 Application Server 实例和 Message Queue 代理之间创建一对一关系，请将类型设置为 LOCAL 并为每个 Application Server 实例提供一个不同的默认 JMS 主机。无论是否已在 Application Server 或 MQ 中定义了群集，都可以进行此操作。

在类型为 LOCAL 的情况下，请使用“启动参数”属性指定 MQ 代理的启动参数。

REMOTE Java 消息服务

“类型”属性为 REMOTE 时，必须单独启动 MQ 代理。如果已在 Application Server 中定义了群集，这将是默认值。有关启动代理的信息，请参见 Sun Java System Message Queue Administration Guide。

在此情况下，Application Server 将使用从外部配置的代理或代理群集。另外，您必须从 Application Server 单独启动和停止 MQ 代理，并使用 MQ 工具配置和调整代理或代理群集。REMOTE 类型是适用于 Application Server 群集的最佳类型。

在类型为 REMOTE 的情况下，您必须使用 MQ 工具指定 MQ 代理启动参数。忽略“启动参数”属性。

JMS 主机列表

JMS 主机用于表示 MQ 代理。Java 消息服务包含 JMS 主机列表（也称为 AddressList），该主机列表包含 Application Server 使用的所有 JMS 主机。

JMS 主机列表包含指定的 MQ 代理的主机和端口，并且在 JMS 主机配置更改后随时更新。当您创建 JMS 资源或部署 MDB 时，它们将继承 JMS 主机列表。

注 –

在 Sun Java System Message Queue 软件中，AddressList 属性被称为 imqAddressList。

缺省 JMS 主机

JMS 主机列表中的一个主机被指定为默认 JMS 主机，命名为 Default_JMS_host。当 Java 消息服务类型配置为 LOCAL 时，Application Server 实例将启动默认 JMS 主机。

如果您已在 Sun Java System Message Queue 软件中创建了多代理群集，则删除默认 JMS 主机，然后将 Message Queue 群集的代理添加为 JMS 主机。在此情况下，默认 JMS 主机将成为 JMS 主机列表中的第一个主机。

Application Server 使用 Message Queue 群集时，将在默认 JMS 主机上执行 Message Queue 特定命令。例如，为三个代理的 Message Queue 群集创建物理目标时，将在默认 JMS 主机上执行创建物理目标的命令，但是该物理目标将被群集中的全部三个代理使用。

创建 JMS 主机

您可以使用以下方法创建其他 JMS 主机：

连接池和故障转移

Application Server 支持 JMS 连接池和故障转移。Sun Java System Application Server 将自动实现 JMS 连接池。“地址列表行为”属性为 random（默认值）时，Application Server 将从 JMS 主机列表中随机选择其主代理。发生故障转移时，MQ 会将负载透明地转移到另一个代理，并维持 JMS 语义。

要指定连接丢失时 Application Server 是否尝试重新连接到主代理，请选择“重新连接”复选框。如果已启用，则当主代理出现故障时，Application Server 将尝试重新连接到 JMS 主机列表中的另一个代理。

启用“重新连接”时，也同时指定以下属性：

您可以使用 JMS 连接工厂设置覆盖这些设置。有关详细信息，请参见《Sun Java System Application Server Enterprise Edition 8.1 2005Q2 管理指南》中的“有关 JMS 连接工厂的管理控制台任务”。

负载平衡的消息流入

Application Server 将消息随机传送到具有相同 ClientID 的 MDB。持久订阅者需要 ClientID。

对于没有配置 ClientID 的非持久订阅者，特定 MDB 中订阅同一主题的所有实例均认为是等效的。当 MDB 部署到 Application Server 的多个实例时，只有一个 MDB 接收消息。如果多个不同的 MDB 订阅了同一主题，则每个 MDB 的一个实例将接收消息的副本。

要使用同一队列支持多个使用者，请将物理目标的 maxNumActiveConsumers 属性设置为较大值。如果已设置此属性，MQ 将最多允许这些数量的 MDB 使用同一队列中的消息。消息将被随机传送至 MDB。如果将 maxNumActiveConsumers 设置为 -1，将不限制使用者的数目。

结合使用 Application Server 与 MQ 群集

MQ 企业版支持多个互连代理实例（称为代理群集）。使用代理群集的情况下，客户机连接将分布在群集的所有代理中。群集可以提供水平可伸缩性并提高可用性。

本节介绍了如何配置 Application Server 以使用高可用性 Sun Java System Message Queue 群集。还介绍了如何启动和配置 Message Queue 群集。

有关 Application Server 和 MQ 部署拓扑的更多信息，请参见《Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Deployment Planning Guide》中的“Planning Message Queue Broker Deployment”。

Procedure使用 Application Server 群集启用 MQ 群集

  1. 如果尚不存在 Application Server 群集，请先创建一个。

    有关创建群集的信息，请参见创建群集。

  2. 创建 MQ 代理群集。

    首先，删除涉及由域管理服务器启动的代理的默认 JMS 主机，然后创建三个将位于 MQ 代理群集中的外部代理（JMS 主机）。

    使用管理控制台或 asadmin 命令行实用程序创建 JMS 主机。

    要使用 asadmin，请参见以下命令示例：


    asadmin delete-jms-host --target cluster1 default_JMS_host
asadmin create-jms-host --target cluster1
     --mqhost myhost1 --mqport 6769
     --mquser admin --mqpassword admin broker1
asadmin create-jms-host --target cluster1
     --mqhost myhost2 --mqport 6770
     --mquser admin --mqpassword admin broker2
asadmin create-jms-host --target cluster1
     --mqhost myhost3 --mqport 6771
     --mquser admin --mqpassword admin broker3

    要使用管理控制台创建主机，请执行以下操作：

    1. 导航到“JMS 主机”节点（“配置”> "config-name" >“Java 消息服务”>“JMS 主机”）。

    2. 删除默认代理 (default_JMS_host)。

      选择其旁边的复选框，然后单击“删除”。

    3. 单击“新建”以创建每一台 JMS 主机并输入其属性值。

      填写主机名称、DNS 名称或 IP 地址、端口号、管理用户名和密码。

  3. 启动 MQ 主代理和其他 MQ 代理。

    除了 JMS 主机上启动的三个外部代理外，请在任一计算机上启动一个主代理。此主代理不需要是代理群集的一部分。例如：


    /usr/bin/imqbrokerd -tty -name brokerm -port 6772
 -cluster myhost1:6769,myhost2:6770,myhost2:6772,myhost3:6771
 -D"imq.cluster.masterbroker=myhost2:6772"

  4. 启动群集中的 Application Server 实例。

  5. 在群集上创建 JMS 资源：

    1. 创建 JMS 物理目标。

      例如，使用 asadmin：


      asadmin create-jmsdest --desttype queue --target cluster1 MyQueue
asadmin create-jmsdest --desttype queue --target cluster1 MyQueue1

      要使用管理控制台，请执行以下操作：

      1. 导航到“JMS 主机”页面（“配置”> "config-name" >“Java 消息服务”>“物理目标”）。

      2. 单击“新建”以创建每个 JMS 物理目标。

      3. 对于每个目标，输入其名称和类型（队列）。

    2. 创建 JMS 连接工厂。

      例如，使用 asadmin：


      asadmin create-jms-resource --target cluster1
--restype javax.jms.QueueConnectionFactory jms/MyQcf
asadmin create-jms-resource --target cluster1
--restype javax.jms.QueueConnectionFactory jms/MyQcf1

      要使用管理控制台，请执行以下操作：

      1. 导航到“JMS 连接工厂”页面（“资源”>“JMS 资源”>“连接工厂”）。

      2. 要创建每个连接工厂，请单击“新建”。

        将打开“创建 JMS 连接工厂”页面。

      3. 对于每个连接工厂，请输入 JNDI 名称（例如 jms/MyQcf）和类型 (javax.jms.QueueConnectionFactory)。

      4. 从页面底部的可用目标列表中选择群集，然后单击“添加”。

      5. 单击“确定”以创建连接工厂。

    3. 创建 JMS 目标资源。

      例如，使用 asadmin：


      asadmin create-jms-resource --target cluster1
     --restype javax.jms.Queue
     --property imqDestinationName=MyQueue jms/MyQueue
asadmin create-jms-resource --target cluster1
     --restype javax.jms.Queue
     --property imqDestinationName=MyQueue1 jms/MyQueue1

      要使用管理控制台，请执行以下操作：

      1. 导航到“JMS 目标资源”页面（“资源”>“JMS 资源”>“连接工厂”）。

      2. 要创建每个目标资源，请单击“新建”。

        将打开“创建 JMS 目标资源”页面。

      3. 对于每个目标资源，请输入 JNDI 名称（例如 jms/MyQueue）和类型 (javax.jms.Queue)。

      4. 从页面底部的可用目标列表中选择群集，然后单击“添加”。

      5. 单击“确定”创建目标资源。

  6. 使用 –retrieve 选项为应用程序客户机部署应用程序。例如：


    asadmin deploy --target cluster1 
--retrieve /opt/work/MQapp/mdb-simple3.ear

  7. 访问应用程序并进行测试以确保其按预期运行。

  8. 如果要将 Application Server 返回到其默认 JMS 配置，请删除您创建的 JMS 主机并重新创建默认值。例如：


    asadmin delete-jms-host --target cluster1 broker1
asadmin delete-jms-host --target cluster1 broker2
asadmin delete-jms-host --target cluster1 broker3
asadmin create-jms-host --target cluster1
 --mqhost myhost1 --mqport 7676
 --mquser admin --mqpassword admin
 default_JMS_host

    您还可以使用管理控制台执行等效操作。

故障排除

如果出现问题，请考虑以下操作：