Fusion Middleware Oracle WebLogic Serverメッセージング・ブリッジの構成と管理

11gリリース1 (10.3.6)

B55550-05(原本部品番号:E13741-05)

目次

タイトルおよび著作権情報

はじめに

- ドキュメントのアクセシビリティについて

- 表記規則

1 概要とロードマップ

- ドキュメントの内容と対象読者

- このドキュメントの手引き

- 関連ドキュメント

- JMS開発者向けのサンプルとチュートリアル

- Avitek Medical Recordsアプリケーション(MedRec)とチュートリアル

- このリリースでの新機能と変更点

2 メッセージング・ブリッジについて

- メッセージング・ブリッジとは

- メッセージング・ブリッジのコンポーネント

- リソース・アダプタ

- ソース・ブリッジ宛先とターゲット・ブリッジ宛先

- JMSブリッジ宛先

- メッセージング・ブリッジ・インスタンス

- メッセージング・ブリッジの構成と管理

- メッセージング・ブリッジ・インスタンスの作成

- メッセージング・ブリッジ・インスタンスの管理

3 メッセージング・ブリッジの設計

- メッセージング・ブリッジを使用すべき状況

- ストア・アンド・フォワード・メッセージングを使用する場合

- トピックをレプリケートする場合

- メッセージング・ブリッジの使用を避けるべき状況

- サービスの品質(QOS)レベルの選択

- メッセージングの永続性

- メッセージの順序

- 接続ファクトリ数の指定

- メッセージのプロパティの保持

- メッセージング・ブリッジでのJMSXUserIDプロパティの使用

- ソース宛先およびターゲット宛先としての分散宛先の使用

- WebLogicメッセージング・ブリッジのチューニング

4 WebLogic Serverの別のリリースや外部プロバイダとの相互運用

- WebLogic Serverの別のリリースとの相互運用

- サポートされている構成と互換性

- WebLogic Serverおよびドメインの命名ガイドライン

- 複数のWebLogicドメインの相互運用の構成

- 「必ず1回」のQOSでの相互運用の構成

- 「1回以上」または「最大1回」のQOSの構成

- 外部プロバイダとの相互運用

5 FAQ : WebLogicメッセージング・ブリッジ

- メッセージング・ブリッジによるソース・ブリッジ宛先への接続が失敗したのはなぜですか。

- 一部のメッセージが転送されないのはなぜですか。

- メッセージング・ブリッジで、別個のWeblogic Serverドメイン間または異なるリリース間の2フェーズ・トランザクションやグローバル・トランザクションを処理できますか。

- 2フェーズ・トランザクションで「必ず1回」サービス品質を使用するように、メッセージング・ブリッジを構成しました。サービスの質を確保できないというエラーが発生するのはなぜですか。

- 「必ず1回」サービスがソースまたはターゲット・ブリッジ宛先で利用できない場合、メッセージング・ブリッジで自動的にサービス品質をダウングレードできますか。

- メッセージング・ブリッジが動作するドメインにトランザクションjms-xa-adp.rarリソース・アダプタをデプロイしましたが、まだ「ブリッジ・アダプタが見つかりませんでした」というメッセージが表示されます。

- メッセージング・ブリッジのソース宛先または対象宛先を構成する際に、「アダプタ・クラス・パス」フィールドを設定する必要はありますか。

- メッセージング・ブリッジのデバッグを有効にするにはどうすればよいですか。

- 管理コンソールのメッセージング・ブリッジの概要ページでメッセージング・ブリッジのモニター状態は何を意味しますか。

- 管理コンソールを使用せずにメッセージング・ブリッジをモニターする方法はありますか。

- メッセージング・ブリッジで、ソース宛先やターゲット宛先として分散宛先を使用できますか。

Oracle® Fusion Middleware

Oracle WebLogic Serverメッセージング・ブリッジの構成と管理

11gリリース1 (10.3.6)

B55550-05(原本部品番号:E13741-05)

2011年11月

このドキュメントは、任意の2つのメッセージング製品間、つまりWebLogic JMSの個々の実装間やWebLogic JMSと別のメッセージング製品間で相互運用を実現するための転送メカニズムとして、WebLogicメッセージング・ブリッジを構成および管理する方法について説明します。

Oracle Fusion Middleware Oracle WebLogic Serverメッセージング・ブリッジの構成と管理, 11gリリース1 (10.3.6)

B55550-05

Copyright © 2007, 2011, Oracle and/or its affiliates.All rights reserved.

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

はじめに

ここでは、このガイド(『Oracle Fusion Middleware Oracle WebLogic Serverメッセージング・ブリッジの構成と管理』)で使用されるアクセシビリティ機能および表記規則について説明します。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

Oracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細情報はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoか、聴覚に障害のあるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

斜体

イタリックは、ユーザーが特定の値を指定するプレースホルダー変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 概要とロードマップ

この章では、このガイド(『WebLogicメッセージング・ブリッジの構成と管理』)の内容と構成について説明します。

- ドキュメントの内容と対象読者

- このドキュメントの手引き

- 関連ドキュメント

- JMS開発者向けのサンプルとチュートリアル

- このリリースでの新機能と変更点

ドキュメントの内容と対象読者

このドキュメントは、任意の2つのメッセージング製品間、つまりWebLogic JMSの個々の実装間やWebLogic JMSと別のメッセージング製品間で相互運用を実現するための転送メカニズムとして、WebLogicメッセージング・ブリッジを構成および管理するシステム管理者向けに書かれています。また、WebLogic Serverを評価するビジネス・アナリストや、特定のアプリケーション用にWebLogic Server JMSの使用を考えているシステム設計者にとって便利な情報も掲載しています。

ここでは、Java Platform, Enterprise Edition (Java EE)でのプログラミングおよびJMSの概念に精通している読者を対象としています。このドキュメントでは、WebLogic Serverで提供される付加価値の高い機能と、WebLogic Serverにおけるメッセージング・ブリッジの構成および管理機能の主な使い方を重点的に扱います。

このドキュメントの手引き

- この章、第1章「概要とロードマップ」では、このマニュアルの構成、新機能、および関連ドキュメントについて説明します。

- 第2章「メッセージング・ブリッジについて」では、リソース・アダプタ、宛先などの基本的なWebLogicメッセージング・ブリッジのリソースについて説明します。

- 第3章「メッセージング・ブリッジの設計」では、設計パターンとWebLogicメッセージング・ブリッジの他の構成要件について説明します。

- 第4章「WebLogic Serverの別のリリースや外部プロバイダとの相互運用」では、WebLogic Serverの別のリリースや他のWebLogic ServerドメインにあるJMS宛先へのメッセージング・ブリッジを使用したアクセスに適用される、相互運用のガイドラインについて説明します。

- 第5章「FAQ: WebLogicメッセージング・ブリッジ」では、WebLogicメッセージング・ブリッジに関するよくある質問(FAQ)に対する回答を紹介します。

関連ドキュメント

メッセージング・ブリッジの構成と管理に関連するトピックについては、以下のドキュメントを参照してください。

- 『Oracle WebLogic Server JMSの構成と管理』は、WebLogic JMSリソースの構成と管理についてのガイドです。

- 『Oracle WebLogic Server JMSのプログラミング』は、WebLogic JMSアプリケーションを開発するために使用するガイドです。

- 『Oracle WebLogic Serverパフォーマンスおよびチューニング』は、WebLogic Serverでのパフォーマンスの監視方法やコンポーネントのチューニング方法に関する情報を提供します。

- 『Oracle WebLogic Serverアプリケーションの開発』は、WebLogic Serverアプリケーションの開発ガイドです。

- 『Oracle WebLogic Serverへのアプリケーションのデプロイ』は、WebLogic Serverアプリケーションのデプロイメントについての主要な情報源です。

- 『Oracle WebLogic Serverリソース・アダプタのプログラミング』は、WebLogicリソース・アダプタとJava EEコネクタ・アーキテクチャのWebLogic Server実装についてのガイドです。

JMS開発者向けのサンプルとチュートリアル

このドキュメントの他にも、様々なサンプル・コードやチュートリアルがJMS開発者向けに用意されています。サンプルとチュートリアルではWebLogic Server JMSの動作が例示され、主要なJMS開発タスクを実行する実際的な手順が示されています。

独自のEJBを開発する前に、まずJMSサンプルの一部またはすべてを実行することをお薦めします。

Avitek Medical Recordsアプリケーション(MedRec)とチュートリアル

MedRecはWebLogic Serverに付属したエンドツーエンドのサンプルJava EEアプリケーションであり、一元的で独立した医療記録管理システムをシミュレートします。MedRecアプリケーションには、患者、医師、および管理者に対して、様々なクライアントを使用して患者のデータを管理するフレームワークが用意されています。

MedRecはWebLogic ServerとJava EEの機能を例示し、Oracle推奨のベスト・プラクティスを重要点として示します。MedRecはWebLogic Server配布キットに含まれており、Windowsマシンの「スタート」メニューからアクセスできます。Linuxなどのプラットフォームでは、WL_HOME\samples\domains\medrecディレクトリからMedRecを起動します。WL_HOMEは、WebLogic Platformの最上位のインストール・ディレクトリです。

MedRecには、Webアプリケーション、Webサービス、ワークフロー・アプリケーション、および将来のクライアント・アプリケーションからのリクエストを処理する複数のEnterprise Java Bean (EJB)で主に構成されるサービス層があります。このアプリケーションには、メッセージドリブンEJB、ステートレス・セッションEJB、ステートフル・セッションEJB、およびエンティティEJBが含まれます。

このリリースでの新機能と変更点

このリリースで導入されたWebLogic Serverの新機能の一覧については、『Oracle WebLogic Serverの新機能』を参照してください。

2 メッセージング・ブリッジについて

この章では、WebLogicメッセージング・ブリッジのコンポーネント、概念および機能について説明します。

- メッセージング・ブリッジとは

- メッセージング・ブリッジのコンポーネント

- メッセージング・ブリッジの構成と管理

メッセージング・ブリッジとは

WebLogicメッセージング・ブリッジとは、複数のWebLogic JMSの実装間、およびJMSと他のメッセージング製品間で相互運用できるようにするための転送メカニズムです。メッセージング・ブリッジを使用すると、以下の範囲に渡るメッセージング・アプリケーションを統合できます。

- WebLogic JMSの2つの実装(WebLogic Serverのリリースが異なる場合を含む)。

- 別々のWebLogicドメインにあるWebLogic JMSの複数の実装。

- WebLogic JMSとサード・パーティのJMS製品(MQSeriesなど)。

メッセージング・ブリッジ・インスタンスでは、対になったソース宛先とターゲット宛先の間でメッセージを転送します。これらの宛先は、ソース・ブリッジ宛先と対象ブリッジ宛先の対にマップされます。メッセージング・ブリッジにより、ソース・ブリッジ宛先からメッセージが読み取られ、ターゲット・ブリッジ宛先に転送されます。WebLogic JMSおよびサード・パーティのJMS製品間については、WebLogic Serverに用意されているJava EEコネクタ・アーキテクチャ(JCA)準拠のリソース・アダプタを使用して、ソース宛先およびターゲット宛先と通信します。図2-1を参照してください。

図2-1 Weblogicメッセージング・ブリッジ

「図2-1 WebLogicメッセージング・ブリッジ」の説明

『Oracle WebLogic Server JMSのプログラミング』の説明に従って、ソース・ブリッジ宛先およびターゲット・ブリッジ宛先としては、「キュー」、「トピック」、または「分散宛先」のいずれかを指定できます。メッセージ・フィルタ、トランザクション・セマンティクス、接続の再試行ポリシーなどのサービス品質(QOS)を任意で指定することもできます。メッセージング・ブリッジを構成すると、ブリッジのトラフィックを必要に応じて一時的に中断する、構成したすべてのブリッジの状態をモニターする、といった管理タスクを管理コンソールから簡単に行えます。

メッセージング・ブリッジのコンポーネント

以下の節では、メッセージング・ブリッジを使用するために必要なリソースについて説明します。

- リソース・アダプタ

- ソース・ブリッジ宛先とターゲット・ブリッジ宛先

- メッセージング・ブリッジ・インスタンス

リソース・アダプタ

メッセージング・ブリッジではJCAリソース・アダプタを使用して、構成済のソースJMS宛先およびターゲットJMS宛先と通信します。ブリッジでソースJMS宛先およびターゲットJMS宛先と通信できるようにするには、サポートされているリソース・アダプタをそれぞれの宛先に関連付けます。アダプタのJNDI名は、リソース・アダプタのデプロイメント記述子の一部として構成されています。表2-1を参照してください。

展開形式または.rarファイルの形で、様々なタイプのJMS宛先用リソース・アダプタが用意されています。展開形式では、リソース・アダプタのデプロイメント記述子のパラメータ(たとえば、ブリッジ・インスタンスで利用可能な接続の最大数を指定する、接続ファクトリのmax-capacityなど)を簡単に変更できます。

注意:
展開形式でリソース・アダプタのデプロイメント記述子を変更しても、.rarファイルにパッケージされている記述子は更新されません。「接続ファクトリ数の指定」を参照してください。

サポートされているリソース・アダプタは、WL_HOME\server\libディレクトリにあります。次の表2-1でこれらのアダプタについて説明します。

表2-1 メッセージング・ブリッジ・リソース・アダプタとJNDI名

アダプタ

JNDI名

説明

jms-xa-adp

eis.jms.WLSConnectionFactoryJNDIXA

トランザクション・セマンティクスにXAResourceを提供します。必要なQOSが「必ず1回」の場合に使用します。これにより、受信されたメッセージがエンベロープされ、ユーザー・トランザクション(XA/JTA)内で送信されます。このリソース・アダプタを使用する場合、次の要件が適用されます。

- ブリッジされているすべてのWebLogic Server実装がリリース7.0以降である必要があります。

- ソースおよびターゲットのJMS接続ファクトリでXAConnectionFactoryを使用するように構成する必要があります。

注意: このアダプタをデプロイする前に、「複数のWebLogicドメインの相互運用の構成」を参照して具体的なトランザクションの構成要件とガイドラインを確認してください。

jms-notran-adp

eis.jms.WLSConnectionFactoryJNDINoTX

トランザクション・セマンティクスは提供されません。必要なQOSが「最大1回」または「重複可」の場合に使用します。必要なQOSが「最大1回」の場合、AUTO_ACKNOWLEDGEモードが使用されます。必要なQOSが「重複可」の場合、CLIENT_ACKNOWLEDGEモードが使用されます。

注意: 非トランザクション・セッションで使用される確認応答モードの詳細は、『Oracle WebLogic Server JMSのプログラミング』のWebLogic JMSに関する項を参照してください。

ソース・ブリッジ宛先とターゲット・ブリッジ宛先

メッセージング・ブリッジは、ブリッジ宛先にマップされる2つの実際の宛先を接続します: メッセージの受信元であるソース宛先と、メッセージの送信先であるターゲット宛先です。

JMSブリッジ宛先

JMSメッセージング製品(WebLogic JMS実装またはサード・パーティのJMSプロバイダ)の場合、メッセージング・ブリッジにマップする実際のソースJMS宛先およターゲットJMS宛先ごとにJMSブリッジ宛先のインスタンスを構成します。JMSブリッジ宛先のインスタンスでは、WebLogicドメイン内のブリッジのソース宛先およびターゲット宛先に対してユニークな名前が付けられます。また、特定の宛先との通信に使われるアダプタの名前、そのアダプタに渡すプロパティ情報(「接続URL」、「接続ファクトリのJNDI名」など)も定義され、任意でユーザー名やパスワードを指定することもできます。Oracle WebLogic Server管理コンソール・ヘルプのJMSブリッジ宛先の作成に関する項を参照してください。次を参照してください:

- 具体的な構成要件とガイドラインについては、「WebLogic Serverの別のリリースとの相互運用」または「外部プロバイダとの相互運用」。

- サード・パーティ製JMSプロバイダのブリッジ宛先を構成する場合、外部JMSサーバー機能を使用すると複数のソース宛先またはターゲット宛先を速やかに構成できます。『Oracle WebLogic Server JMSの構成と管理』のサード・パーティJMSプロバイダにアクセスする外部サーバー・リソースの構成に関する項を参照してください。

メッセージング・ブリッジ・インスタンス

メッセージング・ブリッジ・インスタンスは、構成済みのソース・ブリッジ宛先およびターゲット・ブリッジ宛先と通信します。ソース宛先とターゲット宛先との各マッピングに対して、メッセージング・ブリッジ・インスタンスを構成する必要があります。これは、ターゲット宛先が別のWebLogic JMS実装であっても、サード・パーティ製JMSプロバイダであっても同様です。各メッセージング・ブリッジ・インスタンスは、マッピングするソース宛先とターゲット宛先、メッセージ・フィルタリング・セレクタ、サービスの品質(QOS)、トランザクション・セマンティクスおよび各種再接続パラメータを定義します。Oracle WebLogic Server管理コンソール・オンライン・ヘルプのメッセージング・ブリッジ・インスタンスの作成に関する項を参照してください。

メッセージング・ブリッジの構成と管理

以下の節では、管理コンソールを使用してメッセージング・ブリッジを構成および管理する方法について説明します。

- メッセージング・ブリッジ・インスタンスの作成

- メッセージング・ブリッジ・インスタンスの管理

メッセージング・ブリッジ・インスタンスを作成する

メッセージング・ブリッジの作成手順には以下のタスクがあります。

1. ソース・ブリッジ宛先とターゲット・ブリッジ宛先を作成します。

2. リソース・アダプタをデプロイします。

3. メッセージング・ブリッジ・インスタンスを作成します。

4. メッセージング・ブリッジの対象を指定します。

管理コンソールを使用すると、適切なリソース・アダプタをデプロイし、一部の属性値を設定して、メッセージング・ブリッジを作成できます。使用する環境に合うように、メッセージング・ブリッジの設定変更が必要な場合もあります。Oracle WebLogic Server管理コンソール・オンライン・ヘルプのメッセージング・ブリッジ・インスタンスの作成に関する項を参照してください。

メッセージング・ブリッジ・インスタンスの管理

管理コンソールを使用したメッセージング・ブリッジの管理で通常必要になるタスクは以下のとおりです。

- ドメインに構成されているすべてのメッセージング・ブリッジの状態のモニター。Oracle WebLogic Server管理コンソール・ヘルプのメッセージング・ブリッジ・インスタンスのモニターに関する項を参照してください。

- アクティブなメッセージング・ブリッジの中断と再起動。Oracle WebLogic Server管理コンソール・ヘルプのメッセージング・ブリッジの中断と再起動に関する項を参照してください。

- メッセージング・ブリッジのデフォルトの実行スレッド・プール・サイズの構成。Oracle WebLogic Server管理コンソール・ヘルプのメッセージング・ブリッジの実行スレッド・プール・サイズの構成に関する項を参照してください。

- リソース・アダプタのデプロイ。Oracle WebLogic Server管理コンソール・ヘルプのリソース・アダプタのデプロイに関する項を参照してください。

- セキュリティの信頼関係の作成。『Oracle WebLogic Server JTAのプログラミング』のドメイン間トランザクションに対するドメインの構成に関する項を参照してください。

3 メッセージング・ブリッジの設計

この章では、メッセージング・ブリッジを設計、構成およびチューニングする方法について説明します。

- メッセージング・ブリッジを使用すべき状況

- メッセージング・ブリッジの使用を避けるべき状況

- サービスの品質(QOS)レベルの選択

- メッセージングの永続性

- メッセージの順序

- 接続ファクトリ数の指定

- メッセージのプロパティの保持

- メッセージング・ブリッジでのJMSXUserIDプロパティの使用

- ソース宛先およびターゲット宛先としての分散宛先の使用

- WebLogicメッセージング・ブリッジのチューニング

メッセージング・ブリッジを使用すべき状況

以下の節では、メッセージング・ブリッジを使用すべき状況について説明します。

- ストア・アンド・フォワード・メッセージングを使用する場合

- トピックをレプリケートする場合

ストア・アンド・フォワード・メッセージングを使用する場合

メッセージング・ブリッジの使用により、リモートの宛先に対する高可用性が実現します。ストア・アンド・フォワード・メッセージング機能を使用すると、ローカル・クライアントでローカルの宛先を作成し、その宛先のメッセージをリモートの宛先が利用できるときに自動的にリモートの宛先に転送できます。そのため、リモートの宛先が利用できないときにもローカル・クライアントでメッセージの生成を続けられます。「メッセージングの永続性」を参照してください。

WebLogicメッセージング・ブリッジを使用して、以下の製品間のストア・アンド・フォワード・メッセージングに対する管理ソリューションを実現できます。

- WebLogic JMSの2つの実装(WebLogic Serverのリリースが異なる場合を含む)。

- 別々のWebLogicドメインにあるWebLogic JMSの複数の実装。

- WebLogic JMSとサード・パーティのJMS製品(MQSeriesなど)。

トピックをレプリケートする場合

メッセージング・ブリッジは、WebLogic Serverリリースで利用できる分散トピック機能のように、トピックをレプリケートできます。その結果、スケーラビリティが向上し、高可用性が実現する場合があります。(分散トピックの使用方法は、『Oracle WebLogic Server JMSのプログラミング』の分散宛先の使用に関する項を参照してください。)トピックのレプリケーションは、ブリッジで1つのトピックをサブスクライブしてそのトピックのメッセージを別のトピックに転送する、つまり実質的には同じメッセージ・ストリームを持つ2つのトピックを作成することによって実現されます。Oracle WebLogic Server管理コンソール・ヘルプのメッセージング・ブリッジ・インスタンスの作成に関する項を参照してください。

メッセージング・ブリッジの使用を避けるべき状況

以下に説明する状況では、メッセージング・ブリッジを使用しないようにします。

- リモートの宛先からメッセージを受信する場合 - メッセージドリブンEJBを使用するか、クライアント・コンシューマを直接実装してください。

- ローカルの宛先にメッセージを送信する場合 - ローカルの宛先に直接送信してください。

- メッセージのレイテンシに対する許容度が低い環境。メッセージング・ブリッジによってレイテンシが増大し、スループットが低下することもあります。メッセージング・ブリッジは、メッセージ・パスに特別な宛先を挿入するため、メッセージのレイテンシを増大させます。また、シングル・スレッドでメッセージを転送するため、スループットを低下させる可能性があります。

- WebLogic 9.0以降のドメイン間でメッセージを転送する場合 - WebLogicストア・アンド・フォワード機能を使用してください。

表3-1にWebLogicメッセージング・ブリッジを使用すべき状況と他の転送技術を使用すべき状況についてまとめます。

表3-1 メッセージ転送技術の比較

機能

メッセージング・ブリッジ

メッセージドリブンBean

WebLogicストア・アンド・フォワード

実装メカニズム

管理的

プログラム的

管理的

外部プロバイダおよびレガシー・プロバイダのサポート

はい

いいえ

いいえ - WebLogic 9.0以降のドメイン間のメッセージ転送に使用します。

サービスの品質(QOS)レベルの選択

WebLogicメッセージング・ブリッジでは、3種類のQOSレベルがサポートされます。

- 「必ず1回」 - もっとも高レベルのQOS。メッセージがリモートのエンド・ポイントに1回だけ送信されます。「必ず1回」を指定すると、サーバーのクラッシュ時やネットワークのダウン時にもメッセージは存続し、各メッセージがエンドポイントに1つだけ存在する状態にできます。

- 「1回以上」 - メッセージはリモートのエンド・ポイントに送信されますが、重複する可能性があります。「1回以上」を指定すると、メッセージの転送中に発生したネットワーク障害やサーバーのクラッシュにより、そのメッセージの複数のコピーがリモートのエンドポイントに現れることがあります。

- 「最大1回」 - もっとも低レベルのQOS。各メッセージがリモートのエンド・ポイントに(送信できた場合には) 1回だけ送信されます。このレベルでは、必ずメッセージがエンドポイントに送信されるとはかぎりません。「最大1回」を指定していると、ネットワーク障害やサーバーのクラッシュによってメッセージが失われることがあります。メッセージが重複してエンドポイントに届くことはありません。

場合によって、ブリッジに構成したサービス品質をターゲット宛先では提供できないことがあります。そのような場合、QOSDegradationAllowedフラグを指定して、サービス品質が低下できるようにブリッジ・インスタンスを構成します。Oracle WebLogic Server管理コンソール・ヘルプのメッセージング・ブリッジ・インスタンスの作成に関する項を参照してください。

メッセージングの永続性

ストア・アンド・フォワード・メッセージング機能を利用すると、ローカルJMSクライアントでローカルの宛先へのメッセージを作成し、それらのメッセージをリモートの宛先が利用できるときに自動的にリモートの宛先に転送できます。こうしたメッセージは、そのターゲット宛先が再起動されたときにブリッジによって転送されます。メッセージング・ブリッジでは次の場合に、ターゲット宛先へのメッセージが格納されてから転送(ストア・アンド・フォワード)されます。

- ソース宛先がキューです。

- ソース宛先がトピックであり、「恒久性の有効化」属性が設定されています。この場合、恒久サブスクリプションが作成されます。恒久トピック・サブスクライバの構成の詳細は、『Oracle WebLogic Server JMSのプログラミング』の恒久サブスクリプションの設定に関する項を参照してください。

メッセージの順序

アプリケーションのメッセージがトランザクション内にある場合、「必ず1回」のセマンティクスを保持するために、永続ストアへのメッセージの保存は必ずそのユーザー・トランザクションの一環として行われます。また特に、メッセージの永続ストアからの削除は、アプリケーションでトランザクションのロールバックが決定された場合にトランザクション・ロールバックの一環として行われます。一方、転送はアプリケーション・トランザクションの一環としては行われません。トランザクションがコミットされるまで、トランザクション・メッセージは送信エージェントによって転送されません。トランザクション内では、メッセージの順序はメッセージが送信された時間に基づいて保持されます。

メッセージの順序を確実に指定するには、メッセージ順序単位を構成します。『Oracle WebLogic Server JMSのプログラミング』のメッセージ順序単位の使用に関する項を参照してください。

接続ファクトリ数の指定

weblogic-ra.xml記述子ファイルのmax-capacity属性を調整して、各リソース・アダプタに関連付けられた接続ファクトリの容量を変更することを検討してください。通常、max-capacity属性の値は、少なくともブリッジ・インスタンス数の2倍にする必要があります。たとえば、割り当てられているメッセージング・ブリッジ・インスタンスが10個までの環境においては、max-capacity属性は20に設定されているのは適切な設定です。ブリッジ・インスタンスを15個に増やす場合には、max-capacity属性の値を30まで増やします。

注意:
メッセージ・ブリッジ・アダプタのinitial-capacity値を変更しないでください。ブリッジ・インスタンスがResourceAllocationエラーで機能しなくなることがあるため、initial-capacity値をゼロ(デフォルト)に設定することをお薦めします。

次の手順で、weblogic-ra.xml記述子ファイルを変更します。

1. 任意のエディタを使用して、属性値を目的の値に更新します。例3-1を参照してください。

2. 更新したアダプタをデプロイします。

3. 更新後の値を必要とするすべてのブリッジ・インスタンスを停止してから再起動します。

例3-1 weblogic-ra.xml記述子ファイルのサンプル

<weblogic-connection-factory-dd>

<connection-factory-name>WLSJMSConnectionFactoryLocal</connection-factory-name>
<jndi-name>eis/jms/WLSConnectionFactoryJNDILocal</jndi-name>
<pool-params>
<initial-capacity>0</initial-capacity>
<max-capacity>20</max-capacity>
</pool-params>

</weblogic-connection-factory-dd>

メッセージのプロパティの保持

PreserveMsgPropertyを設定すると、ブリッジ・インスタンスによってメッセージが転送されるときに、メッセージ・ヘッダー内にメッセージのプロパティを保持できます。旧リリースでは、ターゲット宛先へのメッセージの転送時に使用される接続ファクトリのデフォルト配信モード属性から、メッセージのプロパティが継承されます。デフォルト配信モードが「永続」に設定されていると、非永続メッセージが永続メッセージとして転送されて、パフォーマンスが大幅に低下します。

PreserveMsgPropertyを有効にすると、ブリッジによって、受信された非永続メッセージは非永続メッセージとして、永続メッセージは永続メッセージとしてターゲット宛先に転送されます。Oracle WebLogic Server管理コンソール・ヘルプのメッセージング・ブリッジ・インスタンスの構成に関する項を参照してください。

メッセージング・ブリッジ・インスタンスの動作は以下のガイドラインによって決まります。

- PreserveMsgPropertyが有効になっていません。この設定では、前のリリースと同じ転送動作が行われます。

- メッセージング・ブリッジ・インスタンスの構成時には、PreserveMsgPropertyはデフォルトで無効になっています。

- PreserveMsgPropertyが有効になっています。メッセージのプロパティは、表3-2のように保持されます。

表3-2 Weblogic Serverの各リリースにおけるターゲット宛先でのメッセージ・プロパティの保持

プロパティ

WebLogic Server 9.0以降

WebLogic Server 9.0よりも前

外部JMSサーバー

メッセージID

はい

いいえ

いいえ

タイムスタンプ

はい

いいえ

いいえ

ユーザーID

はい

いいえ

いいえ

配信モード

はい

はい

はい

優先順位

はい

はい

はい

期限切れ時間

はい

はい

はい

再配信の制限

はい

いいえ

いいえ

順序単位名

はい

いいえ

いいえ

メッセージング・ブリッジでのJMSXUserIDプロパティの使用

メッセージング・ブリッジでは、メッセージのJMSXUserIDがメッセージング・ブリッジの境界を越えて開示されることはありません。JMSXUserIDとは、メッセージの送信者であるユーザーを識別するシステム生成プロパティです。オラクル社が発行しているJMS仕様(http://www.oracle.com/technetwork/java/jms/index.html)を参照してください。

ソース宛先およびターゲット宛先としての分散宛先の使用

メッセージング・ブリッジを使用して、「分散宛先」との間で送受信できます。以下の構成をお薦めします。

- ソース宛先が分散宛先の場合、ブリッジは宛先に接続したときにいずれかの宛先メンバーに固定されます。接続を中断するイベントが発生するまで、ブリッジはそのメンバーに接続されています。再接続される際は、利用可能な次のメンバーが使用されます。一度接続されると、ブリッジでは分散宛先の他のメンバーからのメッセージが受信されません。そのため、メンバーのJNDI名を使用して、分散宛先の各メンバーに対し1つずつブリッジを構成することがベスト・プラクティスです。

- ターゲットが分散宛先の場合、ベスト・プラクティスは、分散宛先のJNDI名を使用して分散宛先に対して送信し、サーバー・アフィニティを無効にしておくことです。こうすると、分散宛先で受信するメッセージをロード・バランシングできます。『Oracle WebLogic Serverクラスタの使用』のJMSのロード・バランシングに関する項を参照してください。

WebLogicメッセージング・ブリッジのチューニング

メッセージング・ブリッジのチューニングの主な目的は、メッセージングの全体的なパフォーマンスの向上です。処理速度を高速に保つことも重要ですが、これは数あるパフォーマンス関連の要素の1つにすぎません。パフォーマンスには他にも、信頼性、スケーラビリティ、管理容易性、モニター、ユーザー・トランザクション、メッセージドリブンBeanのサポート、アプリケーション・サーバーとの統合などの要素が影響します。『Oracle WebLogic Serverパフォーマンスおよびチューニング』のWebLogicメッセージング・ブリッジのチューニングに関する項を参照してください。

4 WebLogic Serverの別のリリースや外部プロバイダとの相互運用

この章では、別のリリースのWebLogic Server上にあるJMS宛先へのWebLogicメッセージング・ブリッジを使用したアクセスや、外部プロバイダへのアクセス時に適用する相互運用のガイドラインについて説明します。

- WebLogic Serverの別のリリースとの相互運用

- 外部プロバイダとの相互運用

WebLogic Serverの別のリリースとの相互運用

メッセージング・ブリッジを使用して、WebLogic Serverの別のリリースおよび他のWebLogic ServerドメインにあるJMS宛先にアクセスするには、以下の相互運用に関するガイドラインを適用します。

- WebLogic Serverおよびドメインの命名ガイドライン

- 複数のWebLogicドメインの相互運用の構成

注意:
別のリリースのWebLogic Serverを実行する2つのドメイン間の通信にメッセージング・ブリッジを使用する場合、メッセージング・ブリッジは最新のリリースのWebLogic Serverを使用しているドメインで実行するように構成することをお薦めします。

サポートされている構成および互換性

サポートされている構成や、WebLogic Serverの現行バージョンと旧リリースとの間の互換性に関する最新情報は、『Oracle WebLogic Serverの新機能』のサポートされている構成およびWebLogic Serverの互換性に関する項を参照してください。

WebLogic Serverおよびドメインの命名ガイドライン

複数のドメインが関わる場合、1つの命名規則がすべてのWebLogic Serverデプロイメントに適用されます。詳細は、『Oracle WebLogic Server JMSの構成と管理』の統合とマルチドメインのベスト・プラクティスに関する項を参照してください。

複数のWebLogicドメインの相互運用の構成

ドメイン間の相互運用の構成は、QOSに基づきます。

- 「必ず1回」のQOSでの相互運用の構成

- 「1回以上」または「最大1回」のQOSの構成

「必ず1回」のQOSでの相互運用の構成

2つのWebLogicドメイン間のトランザクション・メッセージ(「必ず1回」のQOSを使用)を処理するには、次のガイドラインを使用して相互運用を構成します。

- すべての参加ドメインについて、クロス・ドメイン・セキュリティまたはセキュリティの相互運用モードのいずれかを適切に構成する必要があります。
プロセスで使用されるすべてのドメインに関して、クロス・ドメイン・セキュリティおよびセキュリティの相互運用モードの構成を統一します。どちらの設定もドメイン・レベルで設定されるため、ドメインがクロス・ドメイン・セキュリティとセキュリティの相互運用モードの両方が設定された混在モードになる可能性があります。詳細は、次を参照してください:

- 『Oracle WebLogic Server JTAのプログラミング』のドメイン間トランザクションに対するドメインの構成に関する項

- 『Oracle WebLogic Serverパフォーマンスおよびチューニング』の「非同期モードの有効化」属性の変更に関する項

- 2つのWebLogicドメインの間で相互運用する場合は、「WebLogic Serverおよびドメインの命名ガイドライン」を参照します。

- 「XA接続ファクトリの有効化」チェック・ボックスを選択して、確実にドメインのXA接続ファクトリを有効にします。Oracle WebLogic Server管理コンソール・ヘルプの接続ファクトリのトランザクション・パラメータの構成に関する項を参照してください。

- トランザクション・リソース・アダプタjms-xa-adp.rarは、Oracle WebLogic Server管理コンソール・ヘルプのリソース・アダプタのデプロイに関する項で説明されているように、メッセージング・ブリッジが実行されているドメインにデプロイします。

- JMSブリッジ宛先を構成する際には、Oracle WebLogic Server管理コンソール・ヘルプのJMSブリッジ宛先の作成に関する項で説明されているように、ソース宛先とターゲット宛先の両方で次のように設定します。

- 「アダプタのJNDI名」フィールドで、トランザクション・アダプタのJNDI名eis.jms.WLSConnectionFactoryJNDIXAを指定します。

- 「アダプタ・クラス・パス」フィールドには何も入力しません。

- サービス品質には、Oracle WebLogic Server管理コンソール・ヘルプのメッセージング・ブリッジ・インスタンスの構成に関する項で説明されているように、「必ず1回」を選択します。

「1回以上」または「最大1回」のQOSの構成

メッセージング・ブリッジで、2つのWebLogicドメイン間で相互運用するための特別なセキュリティの構成要件はありません。ただし、ドメイン間での通信をより安全にする必要がある場合、クロス・ドメイン・セキュリティを構成できます。

注意:
プロセスで使用されるすべてのドメインに関してクロス・ドメイン・セキュリティの構成を統一します。つまり、すべてのドメインがクロス・ドメイン・セキュリティを使用する(または、適切な例外リストに含まれる)か、どのドメインについてもクロス・ドメイン・セキュリティを有効にしないかのいずれかにします。詳細は、次を参照してください:

- 『Oracle WebLogic Serverの保護』のWebLogicドメインのセキュリティの構成に関する項

- 『Oracle WebLogic Serverパフォーマンスおよびチューニング』の「非同期モードの有効化」属性の変更に関する項

外部プロバイダとの相互運用

サード・パーティ製のメッセージング・プロバイダと相互運用するメッセージング・ブリッジを構成する際は、次のように構成する必要があります。

- WebLogic Serverの起動前に、以下のように構成します。

- WebLogic ServerのCLASSPATHにプロバイダのCLASSPATHを指定します。

- プロバイダのクライアント側のライブラリで必要なネイティブ・コードのPATHを、WebLogic ServerシステムのPATHに追加します。(この変数は、使用しているオペレーティング・システムによって異なる)。

- ブリッジングするサード・パーティ製メッセージング製品のJMSBridgeDestinationインスタンスの以下の属性に、ベンダー固有の情報を指定します。

- 接続URL

- 初期コンテキスト・ファクトリ

- 接続ファクトリのJNDI名

- 宛先のJNDI名

注意:
ソース・ブリッジ宛先およびターゲット・ブリッジ宛先が同じリソース・マネージャ上にある(つまり、リソース・マネージャのXAリソースを使用しているグローバル・トランザクションをブリッジで転送する)場合、メッセージング・ブリッジでは「必ず1回」のサービス品質は提供されません。たとえば、MQ Seriesの使用中は、ソース・ブリッジ宛先およびターゲット・ブリッジ宛先に対して同じキュー・マネージャを使用することはできません。

JMSブリッジ宛先に関する他の属性の構成については、Oracle WebLogic Server管理コンソール・ヘルプのJMSブリッジ宛先の作成に関する項を参照してください。

5 FAQ : WebLogicメッセージング・ブリッジ

この章では、WebLogicメッセージング・ブリッジに関するよくある質問(FAQ)に対する回答を紹介します。

- メッセージング・ブリッジによるソース・ブリッジ宛先への接続が失敗したのはなぜですか。

- 一部のメッセージが転送されないのはなぜですか。

- メッセージング・ブリッジで、別個のWeblogic Serverドメイン間または異なるリリース間の2フェーズ・トランザクションやグローバル・トランザクションを処理できますか。

- 2フェーズ・トランザクションで「必ず1回」サービス品質を使用するように、メッセージング・ブリッジを構成しました。サービスの質を確保できないというエラーが発生するのはなぜですか。

- 「必ず1回」サービスがソースまたはターゲット・ブリッジ宛先で利用できない場合、メッセージング・ブリッジで自動的にサービス品質をダウングレードできますか。

- メッセージング・ブリッジが動作するドメインにトランザクションjms-xa-adp.rarリソース・アダプタをデプロイしましたが、まだ「ブリッジ・アダプタが見つかりませんでした」というメッセージが表示されます。

- メッセージング・ブリッジのソース宛先または対象宛先を構成する際に、「アダプタ・クラス・パス」フィールドを設定する必要はありますか。

- メッセージング・ブリッジのデバッグを有効にするにはどうすればよいですか。

- 管理コンソールのメッセージング・ブリッジの概要ページでメッセージング・ブリッジのモニター状態は何を意味しますか。

- 管理コンソールを使用せずにメッセージング・ブリッジをモニターする方法はありますか。

- メッセージング・ブリッジで、ソース宛先やターゲット宛先として分散宛先を使用できますか。

メッセージング・ブリッジによるソース・ブリッジ宛先への接続が失敗したのはなぜですか。

ソース・ブリッジ宛先のパラメータの構成でエラーが発生したか、実際のソース宛先が動作しておらずメッセージング・ブリッジと通信できないかのいずれかと考えられます。

- ブリッジのソース宛先が正しく構成されているかどうかを確認してください。コンソールの「JMSブリッジ宛先:構成」ページで以下のフィールドを確認します。

- 「接続URL」 - 接続ファクトリおよび実際の宛先のルックアップに使用するJNDIプロバイダのURL。

- 「宛先のJNDI名」 - ソース・ブリッジ宛先にマップされた実際の宛先のJNDI名。

- 「接続ファクトリのJNDI名」 - ソース・ブリッジ宛先にマップされた実際の宛先に対する接続を作成するために使用する接続ファクトリ。

- 「ユーザー名」/「パスワード」 - 実際のソース宛先にアクセスするためのパーミッションを持つユーザー。

- ソース・ブリッジ宛先にマップされた実際のソース・キューまたはトピック宛先が正常に動作しているかどうかについて、次の点を確認します。

- ソース宛先をホストするWebLogic Serverインスタンスは動作しているか。

- ソース宛先をホストするJMSサーバーは正しくデプロイされているか。

注意:
ここではソース・ブリッジ宛先の接続障害を想定していますが、ターゲット・ブリッジ宛先の接続障害にもこの手順を適用できます。

一部のメッセージが転送されないのはなぜですか。

通常、メッセージング・ブリッジはすべてのメッセージを転送します。一部のメッセージが転送されない場合は次の理由が考えられます。

- 一部のメッセージに有効期限がある場合、ソース宛先またはターゲット宛先のJMSプロバイダによりメッセージが失効します。

- セレクタ・フィルタを指定するようにブリッジ・ソース宛先を構成した場合、フィルタ処理されたメッセージのみが転送されます。

- ブリッジでは、転送の制限回数を超えた場合、メッセージをエラー宛先に自動で移動したり、自動で削除したりするオプションは直接提供されません。ただし、JMSプロバイダには、ブリッジ・ソース宛先でメッセージに関する同様の機能をもたらすオプションがあります。ブリッジ・ソース宛先をホストするJMSプロバイダで再配信制限オプションが有効な場合、ブリッジの自動再試行メカニズムがメッセージの再配信制限を超えないようにプロバイダを再構成することを検討してください。

メッセージング・ブリッジで、別個のWebLogic Serverドメイン間または異なるリリース間の2フェーズ・トランザクションやグローバル・トランザクションを処理できますか。

はい - 「WebLogic Serverの別のリリースとの相互運用」を参照してください。

2フェーズ・トランザクションで「必ず1回」サービス品質を使用するように、メッセージング・ブリッジを構成しました。サービスの質を確保できないというエラーが発生するのはなぜですか。

メッセージング・ブリッジでWebLogicドメイン間のトランザクションを処理するには、以下を追加で構成する必要があります。

- サポートされているアダプタはWL_HOME\server\libディレクトリにあります。Exactly-once QOSについては、コンソールで「デプロイメント」>「コネクタ」ノードを選択して、トランザクション・アダプタjms-xa-adp.rarをブリッジが実行するドメインにデプロイする必要があります。

- このjms-xa-adp.rarアダプタは、ソース・ブリッジ宛先およびターゲット・ブリッジ宛先の「JMSブリッジ宛先」>「構成」タブの「アダプタのJNDI名」属性でeis.jms.WLSConnectionFactoryJNDIXAとして識別される必要もあります。

- WebLogic JMSの場合は、ソース・ブリッジ宛先およびターゲット・ブリッジ宛先の両方にマップされたキュー宛先またはトピック宛先で、トランザクションXAConnectionFactoryを使用していることを確認します。「JMS」→「接続ファクトリ」→「構成」→「トランザクション」コンソール・タブまたは構成ファイル(config.xml)で、次のエントリを確認します。

UserTransactionsEnabled=true
XAConnectionFactory=true

- サード・パーティJMSベンダーの場合は、ソース・ブリッジ宛先およびターゲット・ブリッジ宛先の両方にマップされた宛先で、トランザクション接続ファクトリを使用していることを確認します。

複数のリリース間で相互運用する場合の「必ず1回」のQOSの使用については、「WebLogic Serverの別のリリースとの相互運用」を参照してください。

「必ず1回」サービスがソースまたはターゲット・ブリッジ宛先で利用できない場合、メッセージング・ブリッジで自動的にサービス品質をダウングレードできますか。

はい - 管理コンソールの「メッセージング・ブリッジ」→「構成」→「全般」ページで「QOSデグラデーション」チェック・ボックスを選択すれば可能です。

メッセージング・ブリッジが動作するドメインにトランザクションjms-xa-adp.rarリソース・アダプタをデプロイしましたが、まだ「ブリッジ・アダプタが見つかりませんでした」というメッセージが表示されます。

ブリッジがソース・ブリッジ宛先およびターゲット・ブリッジ宛先と通信できるようにするには、それぞれの宛先を適切な.rarアダプタに関連付けます。jms-xa-adp.rarトランザクション・アダプタの場合は、ソース・ブリッジ宛先およびターゲット・ブリッジ宛先の「JMSブリッジ宛先:構成」タブの「アダプタのJNDI名」属性でeis.jms.WLSConnectionFactoryJNDIXAとして識別される必要があります。

注意:
「ブリッジ・アダプタが見つかりませんでした」のメッセージが1回だけ表示される場合、特に問題がないこともあります。しかし、このメッセージが繰返し表示される場合は、アダプタのデプロイメントと、ソース・ブリッジ宛先およびターゲット・ブリッジ宛先で使用されているアダプタのJNDI名を確認する必要があります。

ブリッジ・リソース・アダプタの詳細は、「リソース・アダプタ」を参照してください。

メッセージング・ブリッジのソース宛先またはターゲット宛先を構成する際に、「アダプタ・クラス・パス」フィールドを設定する必要はありますか。

ソース宛先およびターゲット宛先が両方ともWebLogic Serverインスタンスで動作している場合、「アダプタ・クラス・パス」フィールドは空白のままにします。サード・パーティのJMSプロバイダに接続する場合、ブリッジ宛先はWebLogic ServerのCLASSPATHにそのプロバイダのCLASSPATHを指定する必要があります。

メッセージング・ブリッジのデバッグを有効にするにはどうすればよいですか。

メッセージング・ブリッジのデバッグは、以下のいずれかの方法で有効にできます。

- WebLogic起動スクリプトに以下の行を追加する(weblogic.Server行の前)。

-Dweblogic.debug.DebugMessagingBridgeStartup=true
-Dweblogic.debug.DebugMessagingBridgeRuntime=true

- メッセージング・ブリッジが動作しているサーバーの構成ファイル(config.xml)で、ServerDebugエントリに以下の文を追加します。

DebugMessagingBridgeStartup="true"
DebugMessagingBridgeRuntime="true"

メッセージング・ブリッジのデバッグを有効にすると、デバッグ・メッセージはデフォルトではサーバー・ログに送信されます。デバッグ・メッセージを管理コンソールに表示する場合は、上記の文に「DumpToConsole」を追加します。例:

-Dweblogic.debug.DebugMessagingBridgeStartupDumpToConsole=true

管理コンソールのメッセージング・ブリッジの概要ページでメッセージング・ブリッジのモニター状態は何を意味しますか。

メッセージング・ブリッジの状態をモニターする際は、次の表5-1を参考にして対処方法を判断してください。詳細は、「メッセージング・ブリッジ・インスタンスの管理」を参照してください。

表5-1 メッセージング・ブリッジのモニター状態

説明

アクション

警告: ソース・アダプタが見つかりませんでした

アダプタがデプロイされているか、またはソースJMSBridgeDestinationインスタンスのJNDI名が正しいかどうかを確認します。

警告: ターゲット・アダプタが見つかりませんでした

アダプタがデプロイされているか、またはターゲットJMSBridgeDestinationインスタンスのJNDI名が正しいかどうかを確認します。

両方のアダプタが見つかりました - 接続を作成しています

なし

警告: 管理者によって停止されました

なし

警告: ソース・アダプタの検索に失敗しました

アダプタがデプロイされているか、またはソースJMSBridgeDestinationインスタンスのJNDI名が正しいかどうかを確認します。

警告: ターゲット・アダプタの検索に失敗しました

アダプタがデプロイされているか、またはターゲットJMSBridgeDestinationインスタンスのJNDI名が正しいかどうかを確認します。

2つのアダプタが見つかりました - 接続を作成します

なし

警告: ソースへの接続に失敗しました

- ソース・ブリッジ宛先に構成されているすべてのパラメータを確認します。

- ソース・サーバーが動作しているかどうか、および実際の宛先がアクティブかどうかを確認します。

ソースに接続しました

なし

警告: ターゲットへの接続に失敗しました

- ターゲット・ブリッジ宛先に構成されているすべてのパラメータを確認します。

- ターゲット・サーバーが動作しているかどうか、および実際の宛先がアクティブかどうかを確認します。

ターゲットに接続しました

なし

メッセージを転送しています

なし

警告: 接続に失敗しました - あとで再接続します

ソース・ブリッジ宛先およびターゲット・ブリッジ宛先が正常に動作しているかどうかを確認します。

管理コンソールを使用せずにメッセージング・ブリッジをモニターする方法はありますか。

各ブリッジ・インスタンスの実行時MBean (MessagingBridgeRuntimeMBean)を使用する方法があります。WebLogic Serverの実行時MBeanでは、ドメイン・リソースに関する特定の時点での情報が提供されます。ドメインの特定のリソース(メッセージング・ブリッジなど)がインスタンス化されると、そのリソースについての情報を収集するMBeanのインスタンスが作成されます。

MessagingBridgeRuntimeMBeanには、現時点でString (「Active」または「Inactive」)を返すgetState()メソッドと、より詳細な情報が格納されたStringを返すgetDescription()メソッドがあります。ブリッジ実行時MBeanの名前は、WebLogic Serverインスタンス名とブリッジ名で構成されます。mybridgeというブリッジがmyserverというWebLogic Serverインスタンスで実行されている場合、ブリッジ実行時MBeanの名前はmyserver.bridge.mybridgeとなります。

詳細は、次を参照してください:

- 『Oracle WebLogic Server JMXによるカスタム管理ユーティリティの開発』の「概要とロードマップ」

- 『Oracle WebLogic Scripting Tool』のWebLogic Scripting Toolの使用方法に関する項

メッセージング・ブリッジで、ソース宛先やターゲット宛先として分散宛先を使用できますか。

はい。メッセージング・ブリッジを使用して、分散宛先との間で送受信できます。以下の構成をお薦めします。

- ソース宛先が分散宛先の場合、ブリッジは宛先に接続したときにいずれかの宛先メンバーに固定されます。ブリッジは、再接続するまでそのメンバーのみに接続し続けます。分散宛先の他のメンバーからのメッセージは受信しません。そのため、メンバーのJNDINameを使用して、分散宛先の各メンバーに1つずつブリッジを構成するのが最適です。

- ターゲットが分散宛先の場合、ベスト・プラクティスは、分散宛先のJNDINameを使用して分散宛先に対して送信し、サーバー・アフィニティを無効にしておくことです。こうすると、分散宛先で受信するメッセージをロード・バランシングできます。

Copyright © 2007, 2011, Oracle and/or its affiliates. All rights reserved.