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

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

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

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

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

[接続 URL] - 接続ファクトリおよび実際の送り先のルックアップに使用する JNDI プロバイダの URL。
[送り先の JNDI 名] - ソースブリッジ送り先にマップされた実際の送り先の JNDI 名。
[接続ファクトリの JNDI 名] - ソースブリッジ送り先にマップされた実際の送り先に対する接続を作成するために使用する接続ファクトリ。
[ユーザ名]/[パスワード] - 実際のソース送り先にアクセスするためのパーミッションを持つユーザ。

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

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

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

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

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

サポートされているアダプタは WL_HOME\server\lib ディレクトリにある。[必ず 1 回] の QOS を使用する場合は、ブリッジが動作しているドメインにトランザクションアダプタ jms-xa-adp.rar をデプロイする必要があります。デプロイするには、コンソールで [デプロイメント : Connector] ノードを選択します。
この jms-xa-adp.rar アダプタは、ソースブリッジ送り先および対象ブリッジ送り先の [JMS ブリッジ送り先 : コンフィグレーション] タブの [アダプタの JNDI 名] 属性で eis.jms.WLSConnectionFactoryJNDIXA として識別される必要もある。
WebLogic JMS の場合は、ソースブリッジ送り先および対象ブリッジ送り先の両方にマップされたキュー送り先またはトピック送り先で、トランザクション XAConnectionFactory を使用していることを確認する。これを確認するには、[JMS : 接続ファクトリ : コンフィグレーション : トランザクション] コンソールタブまたはコンフィグレーションファイル (config.xml) で、以下の属性が設定されている必要があります。
UserTransactionsEnabled=true
XAConnectionFactory=true
サードパーティ JMS ベンダの場合は、ソースブリッジ送り先および対象ブリッジ送り先の両方にマップされた送り先で、トランザクション接続ファクトリを使用していることを確認する。

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

はい。Administration Console の [メッセージングブリッジ : コンフィグレーション : 全般] ページで [QOS デグラデーション] チェックボックスを選択すれば可能です。

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

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

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

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

ソース送り先および対象送り先が両方とも 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"

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

Administration Console のメッセージングブリッジの概要ページでメッセージングブリッジのモニタ状態は何を意味しますか。

表 5-1 メッセージングブリッジのモニタ状態
説明	アクション
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	ソースブリッジ送り先および対象ブリッジ送り先が正常に動作しているかどうかを確認する。

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

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

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

『JMX によるカスタム管理ユーティリティの開発』
『WebLogic Scripting Tool ガイド』の「WebLogic Scripting Tool の使用」

メッセージングブリッジで、ソース送り先や対象送り先として分散送り先を使用できますか。

はい。メッセージングブリッジを使用して、分散送り先との間で送受信できます。以下のコンフィグレーションをお勧めします。

ソース送り先が分散送り先の場合、ブリッジは送り先に接続したときにいずれかの送り先メンバーに固定される。ブリッジは、再接続するまでそのメンバーのみに接続し続けます。つまり、分散送り先の他のメンバーからのメッセージは受信しません。そのため、メンバーの JNDIName を使用して、分散送り先の各メンバーに 1 つずつブリッジをコンフィグレーションするのが最適です。
対象送り先が分散送り先の場合、分散送り先の JNDIName を使用して分散送り先に対して送信し、サーバアフィニティを無効にしておくのが最適。こうすると、分散送り先で受信するメッセージをロードバランシングできます。

WebLogic メッセージング ブリッジのコンフィグレーションと管理

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

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

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

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

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

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

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

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

Administration Console のメッセージング ブリッジの概要ページでメッセージング ブリッジのモニタ状態は何を意味しますか。

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

メッセージング ブリッジで、ソース送り先や対象送り先として分散送り先を使用できますか。

WebLogic メッセージングブリッジのコンフィグレーションと管理