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

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

• 2 フェーズ トランザクションで「かならず 1 回」のサービスの品質を使用するようメッセージング ブリッジをコンフィグレーションしたにもかかわらず、「quality of service is unreachable」エラーが発生するのはなぜですか。

• メッセージング ブリッジをコンフィグレーションして、ソース ブリッジ送り先または対象ブリッジ送り先で「かならず 1 回」サービスが使用できない場合にサービスの品質が自動的にダウングレードされるようにできますか。

• WebLogic Server 7.0 GA、SP01、または SP02 の送り先からリリース 6.1 の送り先にメッセージを転送しようとするとセキュリティ認可例外が発生するのはなぜですか。

• メッセージング ブリッジのソース送り先または対象送り先をコンフィグレーションする際に、[アダプタ クラスパス] フィールドを設定する必要はありますか。

• メッセージング ブリッジを使用して、WebLogic Server 6.1 のドメインとリリース 7.0 以降のドメインの間で恒久サブスクリプション メッセージを転送できますか。

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

• [Monitor Messaging Bridge] コンソール ページのメッセージング ブリッジのモニタ状態は何を意味しますか。

• Administration Console を使用せずにメッセージング ブリッジをモニタする方法はありますか。

• 実行時 MBean 管理コマンドの使用については、『管理者ガイド』の「WebLogic Server コマンドライン インタフェース リファレンス」を参照してください。 MBean モニタ通知のプログラミングについては、『WebLogic JMX サービス プログラマーズ ガイド』の「WebLogic Server MBean 通知およびモニタの使い方」を参照してください。メッセージング ブリッジで、ソース送り先および対象送り先として分散送り先を使用できますか。

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

A. ソース ブリッジ送り先のパラメータのコンフィグレーションでエラーが発生したか、実際のソース送り先が動作しておらずメッセージング ブリッジと通信できないかのいずれかと考えられます。

• ブリッジのソース送り先が正しくコンフィグレーションされているかどうかを確認してください。[|コンフィグレーション|一般] コンソール ページで以下のフィールドを確認します。

  • [接続 URL]-接続ファクトリおよび実際の送り先のルックアップに使用する JNDI プロバイダの URL。

  • [送り先 JNDI 名]-ソース ブリッジ送り先にマップされた実際の送り先の JNDI 名。

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

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

• 以下に従って、ソース ブリッジ送り先にマップされた実際のソース キューまたはトピック送り先が正常に動作しているかどうかを確認します。

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

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

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

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

A. はい。リリース 6.1 SP03 以降が動作するソースおよび対象 WebLogic ドメイン間の通信で、ブリッジが「かならず 1 回」のサービスの品質を使用するようにコンフィグレーションされていれば可能です。

また、以下のように、リリース 7.0 のどのサービス パックで動作しているかによって、リリース 6.1 と 7.0 の間に信頼関係を確立しなければならない場合もあります。

• リリース 7.0 GA、SP01、および SP02 のブリッジでリリース 6.1 のドメインと通信するには、リリース 6.1 と 7.0 のドメイン間に信頼関係を確立する必要があります。詳細については、WebLogic Server 7.0 GA、SP01、または SP02 の送り先からリリース 6.1 の送り先にメッセージを転送しようとするとセキュリティ認可例外が発生するのはなぜですか。を参照してください。

• リリース 7.0 SP03 以降の場合は、リリース 6.1 と 7.0 のドメイン間に信頼関係を確立する必要はありません。

リリース 6.1 とリリース 7.0 のドメインを相互運用する場合の「かならず 1 回」 QOS の使用については、『管理者ガイド』の「メッセージング ブリッジを使用してのリリース 6.1 以降のドメインにおける送り先へのアクセス」を参照してください。

Q. 2 フェーズ トランザクションで「かならず 1 回」のサービスの品質を使用するようメッセージング ブリッジをコンフィグレーションしたにもかかわらず、「quality of service is unreachable」エラーが発生するのはなぜですか。

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

• サポートされているアダプタは WL_HOME¥server¥lib ディレクトリに格納されています。 「かならず 1 回」の QOS を使用する場合は、ブリッジが動作しているリリース 7.0 のドメインにトランザクション アダプタ jms-xa-adp.rar をデプロイする必要があります。デプロイするには、コンソールで[デプロイメント|アプリケーション] ノードを選択します。

• この jms-xa-adp.rar アダプタは、ソース ブリッジ送り先および対象ブリッジ送り先の [JMS ブリッジ送り先|コンフィグレーション] タブの [JNDI アダプタ名] 属性で eis.jms.WLSConnectionFactoryJNDIXA として識別される必要もあります。

• WebLogic JMS の場合は、ソース ブリッジ送り先および対象ブリッジ送り先の両方にマップされたキュー送り先およびトピック送り先で、トランザクション XAConnectionFactory を使用していることを確認してください。 これを確認するには、[JMS|接続ファクトリ|コンフィグレーション|トランザクション] コンソール タブまたはコンフィグレーション ファイル (config.xml) で、以下の属性が設定されている必要があります。

  UserTransactionsEnabled=true

  XAConnectionFactory=true

• サードパーティ JMS の場合は、ソースブリッジ送り先および対象ブリッジ送り先の両方にマップされた送り先で、トランザクション接続ファクトリを使用していることを確認してください。

リリース 6.1 とリリース 7.0 以降のドメインを相互運用する場合の「かならず 1 回」 QOS の使用については、『管理者ガイド』の「メッセージング ブリッジを使用してのリリース 6.1 以降のドメインにおける送り先へのアクセス」を参照してください。

Q. メッセージング ブリッジをコンフィグレーションして、ソース ブリッジ送り先または対象ブリッジ送り先で「かならず 1 回」サービスが使用できない場合にサービスの品質が自動的にダウングレードされるようにできますか。

A. はい。Administration Console の [メッセージング ブリッジ|コンフィグレーション|一般] ページで、[QOS デグラデーション] チェック ボックスがチェックされていることを確認してください。

Q. WebLogic Server 7.0 GA、SP01、または SP02 の送り先からリリース 6.1 の送り先にメッセージを転送しようとするとセキュリティ認可例外が発生するのはなぜですか。

java.lang.SecurityException: Invalid Subject: principals=[user1]

A. WebLogic Server 6.1 では、2 つの WebLogic Server ドメイン間の信頼関係は、両ドメインのシステム パスワードが同じであるときに確立されます。 リリース 7.0 GA、SP01、および SP02 のメッセージング ブリッジでリリース 6.1 のドメインと通信するには、リリース 6.1 と 7.0 のドメイン間に信頼関係を確立する必要があります。 信頼関係は、あるドメインの資格属性が別のドメインの資格属性と一致したときに確立されます。 したがって、リリース 6.1 のドメインをリリース 7.0 SP02 以降のドメインと相互運用するには、両方のドメインの資格属性をリリース 6.1 ドメインの「system」ユーザのパスワードに変更する必要があります。

ただし、リリース 7.0 SP03 以降の場合は、リリース 6.1 と 7.0 のドメイン間に信頼関係を確立する必要はありません。

• リリース 7.0 とリリース 6.1 のドメイン間におけるメッセージング ブリッジのための信頼関係の確立については、『管理者ガイド』の「WebLogic ドメインのセキュリティ相互運用性の有効化」を参照してください。

• 相互運用性のセキュリティの詳細については、『WebLogic Security の管理』の「互換性セキュリティの使い方」を参照してください。

• WebLogic Server 7.0 ドメインの相互運用性のセキュリティについては、『WebLogic Security の管理』の「WebLogic ドメイン間の信頼関係の有効化」を参照してください。

Q. メッセージング ブリッジが動作する WebLogic 7.0 ドメインにトランザクション jms-xa-adp.rar リソース アダプタをデプロイしましたが、まだ「failed to find bridge adapter」というメッセージが表示されます。

A. ブリッジがソース ブリッジ送り先および対象ブリッジ送り先と通信できるようにするには、それぞれの送り先を適切な .rar アダプタに関連付ける必要があります。 jms-xa-adp.rar トランザクション アダプタの場合は、ソース ブリッジ送り先および対象ブリッジ送り先の [JMS ブリッジ送り先|コンフィグレーション] タブの [JNDI アダプタ名] 属性で eis.jms.WLSConnectionFactoryJNDIXA として識別される必要があります。

注意: 「failed to find bridge adapter」メッセージが 1 回しか表示されなければ、特に問題にならない場合もあります。 しかし、このメッセージが繰り返し表示される場合は、アダプタのデプロイメントと、ソース ブリッジ送り先および対象ブリッジ送り先で使用されているアダプタの JNDI 名を確認する必要があります。

ブリッジ リソース アダプタの詳細については、『管理者ガイド』の「ブリッジのリソース アダプタについて」を参照してください。

Q. メッセージング ブリッジのソース送り先または対象送り先をコンフィグレーションする際に、[アダプタ クラスパス] フィールドを設定する必要はありますか。

A. ソース送り先および対象送り先が両方ともリリース 7.0 以降で動作している場合、[アダプタ クラスパス] フィールドは空白のままにします。 リリース 6.0 以前で動作しているソース送り先または対象送り先に接続する場合は、[アダプタ クラスパス] フィールドにそれ以前の WebLogic Server リリースのクラスの格納場所を指定する必要があります。 サードパーティの JMS プロバイダに接続する場合は、WebLogic Server の CLASSPATH でプロバイダの CLASSPATH をブリッジ送り先に指定する必要があります。

Q. メッセージング ブリッジを使用して、WebLogic Server 6.1 のドメインとリリース 7.0 以降のドメインの間で恒久サブスクリプション メッセージを転送できますか。

A. はい。ブリッジをホストするドメインが WebLogic 7.0 サービス パック 1 以降を使用していれば可能です。 Administration Console を使用してメッセージング ブリッジを介した恒久メッセージの転送を有効にするには、[|コンフィグレーション|一般] タブで [永続性を有効化] 属性を選択します。

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

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

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

  -Dweblogic.Debug.DebugMessagingBridgeStartup=true

  -Dweblogic.Debug.DebugMessagingBridgeRuntime=true

• メッセージング ブリッジが動作しているサーバのコンフィグレーション ファイル (config.xml) で、ServerDebug エントリに以下の文を追加する。

  DebugMessagingBridgeStartup="true"

  DebugMessagingBridgeRuntime="true"

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

-Dweblogic.Debug.DebugMessagingBridgeStartupDumpToConsole=true

Q. [Monitor Messaging Bridge] コンソール ページのメッセージング ブリッジのモニタ状態は何を意味しますか。

A. [サーバ|サービス|モニタ|メッセージング ブリッジ] ページでメッセージング ブリッジの状態をモニタする際は、次の表を参考にして対処方法を判断してください。

説明	アクション
WARN: Failed to find the source adapter	アダプタがデプロイされているか、またはソース JMSBridgeDestination インスタンスの JNDI 名が正しいかどうかを確認する。
WARN: Failed to find the target adapter	アダプタがデプロイされているか、または対象 JMSBridgeDestination インスタンスの JNDI 名が正しいかどうかを確認する。
Found both of the adapters and making connections	なし。
WARN: Stopped by the administrator	なし。
WARN: Failed to look up the source adapter	アダプタがデプロイされているか、またはソース JMSBridgeDestination インスタンスの JNDI 名が正しいかどうかを確認する。
WARN: Failed to look up the target adapter	アダプタがデプロイされているか、または対象 JMSBridgeDestination インスタンスの JNDI 名が正しいかどうかを確認する。
Found two adapters and about to make connections	なし。
WARN: Failed to connect to the source	ソース ブリッジ送り先にコンフィグレーションされているすべてのパラメータを確認する。 ソース サーバが動作しているかどうか、および実際の送り先がアクティブかどうかを確認する。
Connected to the source	なし。
WARN: Failed to connect to the target	対象ブリッジ送り先にコンフィグレーションされているすべてのパラメータを確認する。 対象サーバが動作しているかどうか、および実際の送り先がアクティブかどうかを確認する。
Connected to the target	なし。
Forwarding messages	なし。
WARN: Failed to connect and will reconnect later	ソース ブリッジ送り先および対象ブリッジ送り先が正常に動作しているかどうかを確認する。

Q. Administration Console を使用せずにメッセージング ブリッジをモニタする方法はありますか。

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

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

Q. 実行時 MBean 管理コマンドの使用については、『管理者ガイド』の「WebLogic Server コマンドライン インタフェース リファレンス」を参照してください。 MBean モニタ通知のプログラミングについては、『WebLogic JMX サービス プログラマーズ ガイド』の「WebLogic Server MBean 通知およびモニタの使い方」を参照してください。メッセージング ブリッジで、ソース送り先および対象送り先として分散送り先を使用できますか。

A. はい。メッセージング ブリッジでは分散送り先との間の送信および受信が可能です。 次のようなコンフィグレーションをお勧めします。

• ソースが分散送り先の場合、ブリッジは送り先への接続時に分散送り先のメンバーの 1 つに固定されます。 再接続するまでの間、ブリッジはそのメンバーにのみ接続された状態になり、 分散送り先の他のメンバーからはメッセージを受信しません。 そのため、1 つのブリッジを分散送り先の各メンバーに対して、メンバーの JNDIName を使用してコンフィグレーションするのが最良の方法です。

• 対象が分散送り先の場合、分散送り先の JNDIName を使用して分散送り先に対して送信し、サーバ アフィニティを無効にするのが最良の方法です。 そうすることで、受信メッセージが分散送り先でロード バランシングされるようになります。