test

Sun GlassFish Enterprise Server 2.1 高可用性 (HA) 管理ガイド

第 8 章 Java Message Service 負荷分散とフェイルオーバー

この章では、Enterprise Server で使用するために Java Message Service (JMS) の負荷分散とフェイルオーバーを設定する方法について説明します。ここで説明する内容は次のとおりです。

Java Message Service の概要

Java Message Service (JMS) API は、Java EE アプリケーションおよびコンポーネントに対して、メッセージの作成、送信、受信、および読み取りを可能にするメッセージング標準です。この API によって、緩やかに結合され、信頼性が高く、非同期の分散通信が可能となります。Sun Java System Message Queue (MQ) は JMS を実装し、Enterprise Server と密接に統合されているため、MQ を使用してメッセージ駆動型 Bean (MDB) などのコンポーネントを作成できます。

MQ は「コネクタモジュール」を使用して Enterprise Server と統合されます。コネクタモジュールはリソースアダプタとしても知られており、Java EE Connector Architecture Specification 1.5 によって定義されています。Enterprise Server に配備された Java EE コンポーネントは、コネクタモジュールを介して統合された JMS プロバイダを使用して、JMS メッセージをやり取りします。Enterprise Server で JMS リソースを作成すると、バックグラウンドでコネクタリソースが作成されます。そのようにして、JMS 操作のたびにコネクタランタイムが呼び出され、バックグラウンドで MQ リソースアダプタが使用されます。

Java Message Service は、管理コンソールまたは asadmin コマンド行ユーティリティーから管理することができます。

詳細情報

JMS リソースの設定の詳細については、『Sun GlassFish Enterprise Server 2.1 管理ガイド』の第 4 章「Java Message Service (JMS) リソースの設定」を参照してください。JMS の詳細については、『Sun GlassFish Enterprise Server 2.1 Developer’s Guide』の第 18 章「Using the Java Message Service」を参照してください。コネクタ (リソースアダプタ) の詳細については、『Sun GlassFish Enterprise Server 2.1 Developer’s Guide』の第 12 章「Developing Connectors」を参照してください。

Sun GlassFish Message Queue の詳細については、 メッセージキュー ドキュメント を参照してください。JMS API の概要については、JMS Web ページを参照してください。

Java Message Service の設定

「Java Message Service」設定は、Sun GlassFish Enterprise Server クラスタまたはインスタンスへのすべてのインバウンドおよびアウトバウンド接続に使用できます。次にあげるものを使用して、Java Message Service を設定できます。

JMS 接続ファクトリの設定を使用して、Java Message Service の設定をオーバーライドできます。詳細については、『Sun GlassFish Enterprise Server 2.1 管理ガイド』の「JMS 接続ファクトリ」を参照してください。

注 –

Java Message Service の設定を変更したあとには、Enterprise Server インスタンスを再起動する必要があります。

JMS 管理の詳細については、『Sun GlassFish Enterprise Server 2.1 管理ガイド』の第 4 章「Java Message Service (JMS) リソースの設定」を参照してください。

Java Message Service の統合

MQ を Enterprise Server に統合する方法には、 LOCAL、REMOTE、および EMBEDDED の 3 通りがあります。管理コンソールでは、これらのモードは Java Message Service の「タイプ」属性で表されます。

LOCAL Java Message Service

「タイプ」属性が LOCAL (クラスタインスタンスのデフォルト) の場合、Enterprise Server はデフォルト JMS ホストとして指定された MQ ブローカを起動および停止します。MQ プロセスはアウトプロセスで (別個の VM 内で) アプリケーションサーバープロセスから起動されます。Enterprise Server は、追加のポートをブローカに提供します。このポートはブローカによって、RMI レジストリを起動するために使用されます。このポート番号は、そのインスタンス用に設定された JMS ポートの番号に 100 を足した数値になります。たとえば、JMS ポート番号が 37676 である場合、この追加ポートの番号は 37776 になります。

Enterprise Server インスタンスと Message Queue ブローカの間に 1 対 1 の関係を作成するには、タイプを LOCAL に設定し、各 Enterprise Server インスタンスに異なるデフォルト JMS ホストを指定します。この作業は、クラスタが Enterprise Server と MQ のどちらに定義されているかに関係なく行えます。

LOCAL タイプでは、「起動引数」属性を使用して MQ ブローカの起動パラメータを指定します。

REMOTE Java Message Service

「タイプ」属性が REMOTE の場合、MQ ブローカは別個に起動する必要があります。ブローカの起動については、『 Sun GlassFish Message Queue 管理ガイド』を参照してください。

この場合、Enterprise Server は外部的に設定されたブローカまたはブローカクラスタを使用します。また、MQ ブローカの起動と停止は Enterprise Server とは別個に行い、MQ ツールを使用してブローカまたはブローカクラスタを設定および調整する必要があります。REMOTE タイプは Enterprise Server クラスタに最適です。

REMOTE タイプでは、MQ ツールを使用して MQ ブローカ起動パラメータを指定する必要があります。「起動引数」属性は無視されます。

EMBEDDED Java Message Service

JMS の「タイプ」属性が EMBEDDED の場合、Enterprise Server と JMS ブローカが同じ VM 内に共存し、JMS サービスはインプロセスで起動され、Enterprise Server によって管理されます。このモードでは、JMS 操作はネットワークスタックを通して行われ、パフォーマンスの最適化につながります。

JMS ホストリスト

JMS ホストは MQ ブローカを表します。Java Message Service には「JMS ホストリスト」(AddressList とも呼ばれる) が含まれており、このリストには Enterprise Server が使用するすべての JMS ホストが含まれます。

JMS ホストリストには指定された MQ ブローカのホストとポートが取り込まれ、JMS ホスト設定が変更になるたびに更新されます。JMS リソースを作成するかまたは MDB を配備すると、JMS リソースや MDB は JMS ホストリストを継承します。

注 –

Sun GlassFish Message Queue ソフトウェアでは、AddressList プロパティーは imqAddressList と呼ばれています。

デフォルト JMS ホスト

JMS ホストリスト内のホストの 1 つが、Default_JMS_host という名前のデフォルト JMS ホストに指定されます。Enterprise Server インスタンスは、Java Message Service のタイプが LOCAL に設定されている場合に、デフォルト JMS ホストを起動します。

Sun GlassFish Message Queue ソフトウェア内にマルチブローカクラスタを作成してある場合は、デフォルト JMS ホストを削除してから、その Message Queue クラスタのブローカを JMS ホストとして追加します。この場合、デフォルト JMS ホストがJMS ホストリスト内の最初のホストになります。

Enterprise Server が Message Queue クラスタを使用する場合には、デフォルト JMS ホスト上で Message Queue 固有のコマンドが実行されます。たとえば、3 つのブローカを持つ Message Queue クラスタ用に物理送信先を作成する場合、物理送信先を作成するコマンドはデフォルトの JMS ホスト上で実行されますが、クラスタ内の 3 つのブローカすべてがその物理送信先を使用します。

JMS ホストの作成

追加の JMS ホストを、以下の方法で作成できます。

接続プールとフェイルオーバー

Enterprise Server は JMS 接続プールとフェイルオーバーをサポートします。Sun GlassFish Enterprise Server は JMS 接続を自動的にプールします。「アドレスリストの動作」属性が random (デフォルト) である場合、Enterprise Server は主ブローカを JMS ホストリストからランダムに選択します。フェイルオーバーが発生すると、MQ は負荷を別のブローカに透過的に転送し、JMS セマンティクスを保持します。JMS タイプが LOCAL タイプの場合、「アドレスリストの動作」属性のデフォルト値は priority です。

接続が失われたときに Enterprise Server が主ブローカへの再接続を試行するかどうかを指定するには、「再接続」チェックボックスを選択します。再接続を有効に設定した状態で、主ブローカが停止すると、Enterprise Server は JMS ホストリストにある別のブローカへの再接続を試みます。

「再接続」を有効にする場合には、以下の属性も指定します。

これらの設定は、JMS 接続ファクトリ設定を使用してオーバーライドできます。詳細については、『Sun GlassFish Enterprise Server 2.1 管理ガイド』の「JMS 接続ファクトリ」を参照してください。

負荷分散されたメッセージのインフロー

メッセージ駆動型 Bean の sun-ejb-jar.xml ファイル内の activation-config-property 要素を使用して、jmsra リソースアダプタの ActivationSpec プロパティーを設定できます。メッセージ駆動型 Bean (EndPointFactory) が配備されるたびに、コネクタランタイムエンジンがこれらのプロパティーを検出し、それに従ってリソースアダプタ内でそれらのプロパティーを設定します。『Sun GlassFish Enterprise Server 2.1 Application Deployment Guide』の「activation-config-property」を参照してください。

Enterprise Server はメッセージが同じ ClientID を持つメッセージ駆動型 Bean にランダムに配信されることを透過的に有効にします。ClientID は永続的なサブスクライバには必須です。

ClientID が設定されない非永続サブスクライバに対しては、同じトピックをサブスクライブする特定のメッセージ駆動型 Bean のすべてのインスタンスは同等であると見なされます。メッセージ駆動型 Bean が Enterprise Server の複数のインスタンスに配備される場合、メッセージ駆動型 Bean のうちの 1 つだけがメッセージを受信します。複数の異なるメッセージ駆動型 Bean が同じトピックをサブスクライブすると、メッセージ駆動型 Bean ごとに 1 つのインスタンスがメッセージのコピーを受信します。

同じキューを使用する複数のコンシューマをサポートするには、物理送信先の maxNumActiveConsumers プロパティーを大きい値に設定します。このプロパティーを設定すると、Sun メッセージキュー ソフトウェアは、プロパティーに設定した数までのメッセージ駆動型 Bean が同じキューからメッセージを消費することを許可します。メッセージはそれらのメッセージ駆動型 Bean にランダムに配信されます。maxNumActiveConsumers を -1 に設定した場合は、コンシューマの数に制限はありません。

ローカル配信が優先されることを保証するには、addresslist-behavior を priority に設定します。この設定は、AddressList 内の最初のブローカが最初に選択されることを指定します。この最初のブローカは、ローカルで共存する メッセージキュー インスタンスです。このブローカが利用できない場合、AddressList 内で列挙されている順序でブローカへの接続試行が行われます。この設定は、クラスタに属する Enterprise Server インスタンスに対するデフォルトです。

注 –

クラスタ化機能は開発者プロファイルでは利用できません。プロファイルの詳細については、『Sun GlassFish Enterprise Server 2.1 管理ガイド』の「プロファイル」を参照してください。

JMS サービスの高可用性

JMS コンポーネントには、次の2 つのレベルの可用性があります。

データ可用性は、Java Message Service (JMS) に準拠する Sun GlassFish メッセージキュー クラスタで有効にできます。メッセージは共通の持続性ストアに維持されます。高可用性データベース (HADB) がインストールされ、エンタープライズプロファイルが選択されている場合は、HADB からこれらのメッセージを利用できます。プロファイルの詳細については、『Sun GlassFish Enterprise Server 2.1 管理ガイド』の「プロファイル」を参照してください。対応するブローカに対してデータ可用性を有効にする前に、Enterprise Server インスタンスに対して可用性を有効にする必要があります。

注 –

個別のアプリケーションおよびモジュールは、JMS の可用性を制御またはオーバーライドできません。

データ可用性を有効にするには、管理コンソールの関連する設定下で「可用性サービス」コンポーネントを選択します。「可用性サービス」ボックスにチェックマークを付けます。JMS サービスの可用性を有効にするには、「JMS の可用性」タブを選択して「可用性サービス」ボックスにチェックマークを付けます。動作の一貫性を保証するために、Enterprise Server クラスタ内のすべてのインスタンスで、インスタンス可用性および JMS 可用性の設定を統一してください。詳細については、『Sun GlassFish Enterprise Server 2.1 高可用性 (HA) 管理ガイド』を参照してください。

注 –

クラスタ化機能は開発者プロファイルでは利用できません。プロファイルの詳細については、『Sun GlassFish Enterprise Server 2.1 管理ガイド』の「プロファイル」を参照してください。

MQ クラスタと Enterprise Server の併用

MQ Enterprise Edition は、ブローカクラスタと呼ばれる、相互に接続した複数のブローカインスタンスをサポートします。ブローカクラスタによって、クライアント接続はクラスタ内のすべてのブローカに分散されます。クラスタ化することで、水平方向のスケーラビリティーが提供され、可用性が向上します。

この節では、高可用性を備えた Sun Java System Message Queue クラスタを使用するために Enterprise Server を設定する方法を説明します。また、Message Queue クラスタを開始および設定する方法も解説します。

Enterprise Server および MQ 配備のトポロジの詳細については、『Sun GlassFish Enterprise Server 2.1 配備計画ガイド』の「Message Queue ブローカの配備の計画」を参照してください。

高可用性 MQ クラスタ

Sun Java System Message Queue 4.1 は、新しい「高可用性」クラスタタイプを通じて高可用性メッセージングサービスを提供します。このタイプの MQ クラスタでは、すべてのブローカインスタンスがピアツーピア関係を共有し、すべてのブローカインスタンスが共通の持続データストアを共有するため、データ可用性が提供されます。インスタンスでは、インスタンスで障害が発生したかどうかを自動的に検出し、障害が発生したブローカの持続メッセージのテイクオーバーを、テイクオーバー選出を通じて動的に実行できます。したがって、アプリケーションサーバーに配備されるアプリケーションコンポーネントはこれらの可用性機能を利用できます。

このクラスタタイプでは、キューまたは永続トピックサブスクリプションにトランザクション処理される持続メッセージの損失は一切ありません。永続的でないサブスクライバへの持続的でないメッセージまたは持続的メッセージは、クライアントランタイムが接続されているブローカが利用不能になったときに、失われる可能性があります。

ローカルモードでの高可用性ブローカクラスタの設定

  1. HADB を起動します。

  2. ドメインを作成して起動します。ドメインの作成には asadmin コマンドの create-domain を、そのドメインの起動には start-domain をそれぞれ使用します。これらのコマンドの詳細については、create-domain(1)およびstart-domain(1)を参照してください。

  3. ノードエージェントを作成して起動します。ノードエージェントの作成には asadmin コマンドの create-node-agent を、そのエージェントの起動には start-node-agent をそれぞれ使用します。これらのコマンドの詳細については、create-node-agent(1)およびstart-node-agent(1)を参照してください。

  4. クラスタを作成します。クラスタの作成は、asadmin コマンドの create-cluster、または管理コンソールを使用して行うことができます。create-cluster コマンドの詳細については、create-cluster(1) を参照してください。管理コンソールを使用してクラスタを作成する方法については、管理コンソールのオンラインヘルプを参照してください。

  5. クラスタ内にインスタンスを作成します。インスタンスの作成中に、リモートブローカによって使用されている JMS プロバイダのポート番号を指定します。このポート番号を指定しない場合、デフォルトの JMS プロバイダポート番号が使用されます。インスタンスの作成は、管理コンソール、または asadmin コマンドの create-instance を使用して行うことができます。管理コンソールを使用してインスタンスを作成する方法については、管理コンソールのオンラインヘルプを参照してください。create-instance コマンドの詳細については、create-instance(1) を参照してください。

  6. クラスタを起動します。これは管理コンソール、または asadmin コマンドの start-cluster を使用して行うことができます。管理コンソールを使用してクラスタを起動する方法については、管理コンソールのオンラインヘルプを参照してください。start-cluster コマンドの詳細については、start-cluster(1) を参照してください。

  7. asadmin コマンドの configure-ha-cluster を使用して HA クラスタを設定します。コマンドの詳細については、configure-ha-cluster(1) を参照してください。

リモートモードでの高可用性ブローカクラスタの設定

  1. HADB を起動します。

  2. データベース表を作成します。

  3. 高可用性ブローカクラスタを作成している場合、HA ドライバをコピーします。 

    cp $AS_HOME/hadb/4.4.3-6/lib/hadbjdbc4.jar $S1AS_HOME/imq/lib/ext

  4. ドメインを作成して起動します。これを行うには、コマンド asadmin create-domain および start-domain を使用します。これらのコマンドの詳細については、create-domain(1)およびstart-domain(1)を参照してください。

  5. ノードエージェントを作成して起動します。これを行うには、asadmin コマンド create-domain および start-node-agent を使用します。これらのコマンドの詳細については、create-node-agent(1)およびstart-node-agent(1)を参照してください。

  6. クラスタを作成します。クラスタの作成は、asadmin コマンドの create-cluster、または管理コンソールを使用して行うことができます。詳細については、create-cluster(1) を参照してください。管理コンソールを使用してクラスタを作成する方法については、管理コンソールのオンラインヘルプを参照してください。

  7. クラスタ内にインスタンスを作成します。インスタンスの作成中に、リモートブローカによって使用されている JMS プロバイダのポート番号を指定します。このポート番号を指定しない場合、デフォルトの JMS プロバイダポート番号が使用されます。

  8. デフォルトの JMS ホストを削除し、インスタンスが接続できる JMS ホストを作成します。必ず、各ブローカは独立した JMS ホストとして追加してください。JMS ホストの詳細については、「JMS ホストリスト」を参照してください。

  9. JMS タイプを Remote に設定します。これは asadmin コマンドの set を使用して、または管理コンソールの「JMS サービス」ページから行うことができます。

  10. 高可用性ブローカを設定している場合、「JMS の可用性」を true に設定します。これは asadmin コマンドの set を使用して、または管理コンソールの「JMS の可用性」ページから行うことができます。

  11. ブローカインスタンスを起動します。

  12. クラスタを起動します。詳細については、start-cluster(1) を参照してください。

非 HA クラスタの自動クラスタ化

これまでは、この節のあとの手順で説明されているように、「非高可用性」MQ クラスタ (マスターブローカを持つ MQ クラスタ) を管理者が個別に設定する必要がありました。このリリースでは、(REMOTE タイプの) 手動でのプロセスによる MQ クラスタの設定に加えて、Enterprise Server は「自動クラスタ化」を提供します。これは、ユーザーが Application Server クラスタを作成するときに、(LOCAL タイプの) 共存する非 HA クラスタが自動的に作成されることを意味します。これは MQ クラスタの作成のデフォルトモードになります。たとえば、3 つの Application Server インスタンスを持つ Application Server クラスタを管理者が作成すると、各 Application Server インスタンスは共存するブローカと連動するように設定され、結果的に MQ クラスタが透過的に 3 つの MQ ブローカインスタンスを形成します。最初の Application Server インスタンスの MQ ブローカがマスターブローカに設定されます。ただし、自動クラスタ化には短所もあります。管理者がクラスタにインスタンスを追加する場合、自動的に作成される MQ ブローカインスタンスはクラスタに参加できません。この動作は、インスタンスがクラスタから削除される場合にも適用されます。

ProcedureMQ クラスタ と Enterprise Server クラスタの併用を有効にする

始める前に

クラスタが REMOTE タイプの場合、次の手順を実行します。クラスタが LOCAL タイプの場合、手順 1 ～ 4 は該当しません。

  1. クラスタがまだない場合、クラスタを作成します。

    クラスタの作成については、「クラスタを作成する」を参照してください。

  2. MQ ブローカクラスタを作成します。

    まず、ドメイン管理サーバーによって起動されるブローカを参照するデフォルト JMS ホストを削除してから、MQ ブローカクラスタに 3 つの外部ブローカ (JMS ホスト) を作成します。

    JMS ホストの作成は、管理コンソールまたは asadmin コマンド行ユーティリティーのいずれかを使用して行います。

    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 ホストマシン上で起動する 3 つの外部ブローカに加えて、任意のマシン上で 1 つのマスターブローカを起動します。このマスターブローカは、ブローカクラスタの一部である必要はありません。次に例を示します。


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

  4. クラスタ内の インスタンスを起動します。

  5. クラスタ上に JMS リソースを作成します。

    1. JMS 物理送信先を作成します。

      たとえば、次の asadmin を使用します。


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

      管理コンソールを使用する場合は、次のようにします。

      1. 「物理送信先」ページに移動します (「設定」> 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. Enterprise 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

    管理コンソールを使用して、これに相当する操作を実行することもできます。

注意事項

問題が起きた場合は、次の点を考慮してください。