相互運用性ソリューションガイド

BEA Tuxedo との相互運用性

概要

BEA AquaLogic Service Bus と BEA Tuxedo を相互運用して、各製品に用意されているサービスを使用できます。

AquaLogic Service Bus で BEA Tuxedo に用意されているサービスを使用する場合、Tuxedo サービスに対する要求を JMS キューに入れ、その要求に対する応答を別の JMS キューから受信できる。「発信」という用語はこのシナリオを表します。
BEA Tuxedo で AquaLogic Service Bus に用意されているサービスを使用する場合、BEA Tuxedo サービスは EJB を、もう 1 つの BEA Tuxedo アプリケーションのように呼び出すことができる。「着信」という用語はこのシナリオを表します。

以下の関連ドキュメントに、この環境について詳しく記載されています。

AquaLogic Service Bus 環境の設定については、『AquaLogic Service Bus Console の使い方』を参照。
BEA Tuxedo 環境の設定については、BEA Tuxedo ドキュメントの『Tuxedo アプリケーションの設定』を参照。
WebLogic Tuxedo Connector については、WebLogic Server の WebLogic Tuxedo Connector のドキュメントを参照。
この相互運用性シナリオの実例を設定および使用する場合は、dev2dev Web サイトの「Interoperability with AquaLogic Service Bus and Tuxedo」を参照。

次の図に、このメッセージ処理プロセスをまとめます。

メッセージ処理プロセス

この章の内容は以下のとおりです。

AquaLogic Service Bus での BEA Tuxedo サービスの使用 (発信の例)

以下の節では、AquaLogic Service Bus から BEA Tuxedo サービスを使用する方法を説明します。

実装の概要

AquaLogic Service Bus では、WebLogic Tuxedo Connector を使用して、BEA Tuxedo に用意されているサービスを利用できます。WebLogic Tuxedo Connector には、Tuxedo サービスを直接呼び出すことのできる JMS ブリッジ (tBridge) が用意されています。

WebLogic Tuxedo Connector および Tuxedo キューブリッジをコンフィグレーションした後、Tuxedo サービスに対する要求を JMS キューに入れ、その要求に対する応答を別の JMS キューから受信できます。tBridge は、JMS メッセージから Tuxedo バッファタイプへの変換を処理し、インポートされた Tuxedo サービスを呼び出し、応答バッファを再び JMS メッセージタイプに変換し、変換された応答を JMS キューに入れます。Tuxedo に対する要求は、サービスに対して直接行うか、または Tuxedo /Q キューに入れることができます。

始める前に

AquaLogic Service Bus で使用する Tuxedo アプリケーションに関する以下の情報を収集します。

Tuxedo ローカルアクセスポイントの ID。
Tuxedo ローカルアクセスポイントのネットワークアドレス。
エクスポートされた Tuxedo サービスの名前。
サービスで XML から FML および FML から XML の変換が必要かどうか。

XML から FML および FML から XML への変換が必要な場合は、1 つまたは複数のフィールドテーブルクラスを WebLogic Tuxedo Connector コンフィグレーションのリソースセクションに追加する必要があります。このタスクについては、「フィールドテーブルクラスの作成 (必要な場合)」で説明します。
以降の節で説明する例では、FML/FML32 バッファタイプの使用を前提とします。

Tuxedo ドメインゲートウェイでこの WebLogic Tuxedo Connector インスタンスを表すために使用するアクセスポイントの ID。
Tuxedo ドメインゲートウェイがこの WebLogic Tuxedo Connector ローカルアクセスポイントに対して定義したネットワークアドレス。

Tuxedo キューブリッジをコンフィグレーションする前に、JMS キューをいくつか作成する必要があります (ない場合)。以下の用途のキューが必要です。

Tuxedo サービスへの要求を入れる 1 つまたは複数のキュー
Tuxedo サービスからの応答を取り出すキュー
Tuxedo への配信に失敗したメッセージを受信するキュー
呼び出されたサービスからのエラー応答を受信するキュー

WebLogic Tuxedo Connector と Tuxedo キューブリッジのコンフィグレーション

WebLogic Tuxedo Connector と Tuxedo キューブリッジ (tBridge) は、WebLogic Server Administration Console でコンフィグレーションします。WebLogic Tuxedo Connector の詳細については、WebLogic Server の WebLogic Tuxedo Connector のドキュメントを参照してください。

WebLogic Server Administration Console にログインします。以下の節の指示に従って、コンフィグレーション手順を順番に実行します。

新しい WTC サーバの作成

以下の手順に従います。

[相互運用性] の [WTC サーバ] をクリックします。

[ロックして編集] をクリックします。これにより、変更を行えるようになります。図 2-1 のような画面が表示されます。

図 2-1 WTC サーバ画面

WTC サーバ画面

[新規作成] をクリックして新しい WTC サーバを追加します。図 2-2 のような画面が表示されます。

図 2-2 新しい WTC サーバのデータ入力画面

新しい WTC サーバのデータ入力画面

WTC サーバの名前を入力し、[OK] をクリックします。

ページ上部に、サーバが正常に追加されたことを示すメッセージが表示されます。

新しく作成した WTC サーバをクリックして、その設定を表示します。

ローカルアクセスポイントの作成

以下の手順に従います。

[コンフィグレーション] タブで [ローカル AP] をクリックします。

[新規作成] をクリックして、新しい WTC ローカルアクセスポイントを作成します。図 2-3 のような画面が表示されます。

図 2-3 新しいローカルアクセスポイントのデータ入力画面

新しいローカルアクセスポイントのデータ入力画面

以下の値を入力します。

[アクセスポイント] - このアクセスポイントの名前。
[アクセスポイント ID] - WebLogic Server がアクセスポイントを表すために使用する名前。この値は、Tuxedo ドメインゲートウェイがこの WTC インスタンスで使用するためにコンフィグレーションしたリモートアクセスポイント ID と一致している必要があります。
[ネットワークアドレス] - この値は、Tuxedo ドメインゲートウェイがこの WTC インスタンスで使用するためにコンフィグレーションしたリモートネットワークアドレスと一致している必要があります。

[OK] をクリックします。

リモートアクセスポイントの作成

以下の手順に従います。

[コンフィグレーション] タブで [リモート AP] をクリックします。

[新規作成] をクリックして、新しい WTC リモートアクセスポイントを作成します。図 2-4 のような画面が表示されます。

図 2-4 新しいリモートアクセスポイントのデータ入力画面

新しいリモートアクセスポイントのデータ入力画面

以下の値を入力します。

[アクセスポイント] - このアクセスポイントの名前。
[アクセスポイント ID] - WebLogic Server がアクセスポイントを表すために使用する名前。この値は、Tuxedo ドメインゲートウェイがこの WTC インスタンスで使用するためにコンフィグレーションしたローカルアクセスポイント ID と一致している必要があります。
[ローカルアクセスポイント] - WTC ローカルアクセスポイントの名前。
[ネットワークアドレス] - この値は、Tuxedo ドメインゲートウェイがこの WTC インスタンスで使用するためにコンフィグレーションしたローカルネットワークアドレスと一致している必要があります。

[OK] をクリックします。

WTC インポートサービスの作成

以下の手順に従います。

[コンフィグレーション] タブの [インポート済み] をクリックします。

[新規作成] をクリックして、新しい WTC インポートサービスを作成します。図 2-5 のような画面が表示されます。

図 2-5 新しい WTC インポートサービスのデータ入力画面

新しい WTC インポートサービスのデータ入力画面

以下の値を入力します。

[リソース名] - WebLogic Server がサービス (tBridge を含む) を表すために使用する名前
[ローカルアクセスポイント] - 作成したローカルアクセスポイントの名前
[リモートアクセスポイントリスト] - 新しく作成したリモートアクセスポイントの名前
[リモート名] - リモート Tuxedo システムでエクスポートされたときのサービスの名前

[OK] をクリックします。

フィールドテーブルクラスの作成 (必要な場合)

Tuxedo サービスで FML または FML32 バッファが必要な場合は、1 つまたは複数のフィールドテーブルクラスを WebLogic Tuxedo Connector コンフィグレーションのリソースセクションに追加する必要があります。クラスを作成するには、FML フィールドテーブルの場合は weblogic.wtc.jatmi.mkfldclass ユーティリティ、FML32 フィールドテーブルの場合は weblogic.wtc.jatmi.mkfldclass32 ユーティリティを使用します。

フィールドテーブルクラスの作成が不要な場合は、「キューブリッジの作成」に進みます。

フィールドテーブルクラスを作成するには、以下の手順を実行します。

[コンフィグレーション] タブの [リソース] をクリックします。

[新規作成] をクリックして、新しい WTC リソースコンフィグレーションを作成します。図 2-6 のような画面が表示されます。

図 2-6 新しいフィールドテーブルクラスのデータ入力画面

新しいフィールドテーブルクラスのデータ入力画面

完全クラス名を [FldTbl クラス] または [FldTbl32 クラス] フィールドに追加します。クラスは WebLogic Server クラスパス上にある必要があります。WebLogic Server クラスパスの変更が必要な場合があります。WebLogic Server クラスパスの設定については、『WebLogic Server コマンドリファレンス』の「クラスパスの変更」を参照してください。

キューブリッジの作成

以下の手順に従います。

[コンフィグレーション] タブの [キューブリッジ] をクリックします。

[新規作成] をクリックして、新しいキューブリッジを作成します。図 2-7 のような画面が表示されます。

図 2-7 新しい WTC キューブリッジのデータ入力画面

新しい WTC キューブリッジのデータ入力画面

以下の値を入力します。

[WLS エラー送り先] - メッセージが Tuxedo に正常に配信できなかったときにそのメッセージを受信する JMS キューの JNDI 名を入力します。
[Tuxedo エラーキュー] - Tuxedo からのエラー応答を受信する JMS キューの JNDI 名を入力します。

[OK] をクリックします。

リダイレクトの作成

以下の手順に従います。

[コンフィグレーション] タブの [リダイレクト] をクリックします。

[新規作成] をクリックして、Tuxedo で呼び出すサービスのリダイレクトを作成します。図 2-8 のような画面が表示されます。

図 2-8 新しい WTC リダイレクトのデータ入力画面

新しい WTC リダイレクトのデータ入力画面

以下の値を入力します。

[方向] - [JMS キューから Tuxedo サービス] を指定します。
[FML 変換] - Tuxedo サービスに XML から FML および FML から XML への変換が必要な場合は、[フラット] を選択します。
[応答キュー] - Tuxedo サービスからの応答を受信する JMS キューの JNDI 名を入力します。
[ソース名] - Tuxedo サービスへの要求を受信する JMS キューの JNDI 名を入力します。
[対象のアクセスポイント] - 前に作成したリモートアクセスポイントの名前を入力します。
[対象の名前] - 前に作成した、インポートされた Tuxedo サービスの名前を入力します。

[OK] をクリックします。

変更のアクティブ化

変更内容を有効にするには、WebLogic Server Administration Console で [変更のアクティブ化] をクリックします。

新しいビジネスサービスのコンフィグレーション

Tuxedo サービスを AquaLogic Service Bus から利用するには、AquaLogic Service Bus Console で新しいビジネスサービスをコンフィグレーションする必要があります。ビジネスサービスの詳細については、『AquaLogic Service Bus Console の使い方』の「ビジネスサービス」を参照してください。

AquaLogic Service Bus Console にログインします。以下の節の指示に従って、コンフィグレーション手順を順番に実行します。

新しいプロジェクトの追加

以下の手順に従います。

[作成] をクリックして新しいコンソールセッションを開始します。

リソースの編集はセッション内で行う必要があります。

[プロジェクトエクスプローラ] をクリックします。

新しいプロジェクトの名前を入力し、[プロジェクトの追加] をクリックします。

ページ上部に、サーバが正常に追加されたことを示すメッセージが表示されます。

ビジネスサービスの追加

以下の手順に従います。

新しく作成したプロジェクトをクリックします。

[リソース] 領域の [リソースの作成] ドロップダウンメニューで、[ビジネスサービス] を選択します。

図 2-9 に示すような [ビジネスサービスの編集 - 全般的なコンフィグレーション] ページが表示されます。

図 2-9 新しいビジネスサービスのページ 1

以下の値を入力します。

[サービス名] - サービスの名前。
[サービスの種類] - [任意の XML サービス] を選択します (デフォルト)。
[次へ] をクリックして、図 2-10 に示す [ビジネスサービスの編集 - 転送コンフィグレーション] ページを表示します。

図 2-10 新しいビジネスサービスのページ 2

以下の値を入力します。

[プロトコル] - [jms] を選択します。
[ロードバランシングアルゴリズム] - デフォルトのままにするか、別のアルゴリズムを選択します。
[エンドポイント URI] - サービスがデプロイされたサーバ上のエンドポイント URI に対応する JMS URI を入力します。

[次へ] をクリックして次に進みます。

以下の値を入力します。

[応答が必要] - チェックボックスを選択します。
[応答 URI] - 有効な応答 URI を入力します。
[応答のタイムアウト] - 30。
[メッセージの種類] - [テキスト]。

[完了] をクリックします。

[概要] ページで、[保存] をクリックします。

プロキシサービスの追加

テストの目的でプロキシサービスを作成します。プロキシサービスの詳細については、『AquaLogic Service Bus Console の使い方』の「プロキシサービス」を参照してください。

以下の手順に従います。

[リソース] 領域の [リソースの作成] ドロップダウンメニューで、[プロキシサービス] を選択します。

図 2-11 に示すような [プロキシサービスの編集 - 全般的なコンフィグレーション] ページが表示されます。

図 2-11 新しいプロキシサービスのデータ入力ページ 1

以下の値を入力します。

[サービス名] - サービスの名前。
[サービスの種類] - [任意の SOAP サービス] を選択します。
[次へ] をクリックして、図 2-12 に示す [プロキシサービスの編集 - 転送コンフィグレーション] ページを表示します。

図 2-12 新しいプロキシサービスのデータ入力ページ 2

以下の必須の値を入力します。

[プロトコル] - [http] を選択します。
[エンドポイント URI] - URI フィールドに、プロキシサービス名に対応する URI が自動的に表示されます。このフィールドはそのままにするか、別の URI を入力できます。

[完了] をクリックします。

[概要] ページで、[保存] をクリックします。

プロキシサービスのコンフィグレーション

AquaLogic Service Bus のメッセージフローは、プロキシサービスの実装を定義します。メッセージフローには、パイプラインペア (プロキシサービス、またはサービスの処理用の要求パイプラインと応答パイプライン) と、ステージ、パイプライン、およびプロキシサービスに対して定義できるエラーハンドラパイプラインをゼロ個以上入れることができます。パイプラインには、1 つまたは複数のステージを入れることができ、ステージにはアクションを入れることができます。プロキシサービスのルーティング動作を変更するには、このメッセージフローを次のように編集します。

ルートノードを追加する
前に作成したビジネスサービスリソースにプロキシサービスをルーティングするアクションをコンフィグレーションする

以下の手順に従います。

AquaLogic Service Bus Console ナビゲーションパネルで、選択項目のリストから [リソースブラウザ] を選択します (まだ選択されていない場合)。

ナビゲーションパネルに [リソースブラウザ] ペインが開き、コンソールに [プロキシサービスの概要] プロジェクトページが表示されます。

[オプション] の [メッセージフローの編集] アイコン [メッセージフローの編集] アイコン

をクリックします。図 2-13 のような画面が表示されます。

図 2-13 メッセージフローのデフォルト画面

メッセージフローのデフォルト画面

前に作成したプロキシサービスの [メッセージフローの編集] ページが表示されます。このページには、デフォルトのメッセージフローコンフィグレーションが表示されます。デフォルトコンフィグレーションは、1 つの開始ノードで構成されています。これはメッセージフローの最小コンフィグレーションです。メッセージフローの動作は順番に行われます。

開始ノードをクリックします。図 2-14 に示すように、ポップアップメニューから [ルートノードの追加] リンクを選択します。

図 2-14 ルートノードへの変換の画面

ルートノードへの変換の画面

コンフィグレーションのダイアログで、ルートノードに任意の名前を付け、[保存] をクリックします。

メッセージフローで、ノードの名前が変更され、ルートノード名が表示されます。

図 2-15 に示すように、ルートノードをクリックし、ポップアップメニューから [編集｜ルートノード] を選択します。

図 2-15 ルートノードの編集画面

ルートノードの編集画面

[ステージコンフィグレーションの編集] ページが表示されます。このページには、[アクションの追加] という 1 つのリンクがあります。
ステージはパイプラインの要素であり、パイプラインに定義されたアクションのコンテナです。アクションとは、プロキシサービスを通過するメッセージの処理を定義するパイプラインステージの要素です。

図 2-16 に示すように、[アクションの追加] リンクをクリックし、ポップアップメニューから [ルーティング] を選択します。

図 2-16 メッセージフローのルーティングの画面

メッセージフローのルーティングの画面

[ステージコンフィグレーションの編集] ページが変更され、アクションの内容が表示されます。アクションの内容は、作成したノードの種類 (ルートノード) によって定義されます。

図 2-17 に示すように、[<サービス> にルーティングする] の [<サービス>] をクリックします。

図 2-17 [<サービス> にルーティングする] 画面

[<サービス> にルーティングする] 画面

[サービスブラウザ] に、作成したプロキシサービスとビジネスサービスの名前が表示されます。

「ビジネスサービスの追加」で作成したビジネスサービスを選択します。

[送信] をクリックします。

画面が更新され、ビジネスサービスへのルーティングが表示されます。

コンフィグレーションが完了し、テストの準備が整いました。

コンフィグレーションのテスト

AquaLogic Service Bus を BEA Tuxedo と共に使用するようコンフィグレーションしたので、アプリケーションをテストできます。コンフィグレーションをテストする 1 つの方法は、Web サービスプロキシを設定し、デフォルトパイプラインを使用してそれを呼び出すことにより、WebLogic Workshop ベースのアプリケーションを使用することです。

次のタスクリストは、AquaLogic Service Bus による BEA Tuxedo の発信での使用をテストするプロセスをまとめたものです。

Tuxedo サーバおよび WebLogic Workshop アプリケーションを構築して起動します。

AquaLogic Service Bus プロキシを呼び出すように WebLogic Workshop アプリケーションを設定します。

要求を入力して、WebLogic Workshop アプリケーションで Web サービスを実行します。要求に対して応答が返されたら、正しくコンフィグレーションされています。

BEA Tuxedo での AquaLogic Service Bus のサービスの使用 (着信の例)

以下の節では、BEA Tuxedo から AquaLogic Service Bus サービスを使用する方法を説明します。

実装の概要

WebLogic Tuxedo Connector を使用すると、BEA Tuxedo アプリケーションは EJB を、もう 1 つの BEA Tuxedo アプリケーションのように呼び出すことができます。このシナリオでは、JMS キューで Tuxedo サービス要求を受信し、必要に応じてバッファを変換し、結果のメッセージを配置する機能を実行する特定の EJB の例を使用します。このドキュメントで説明する方法は、デプロイメント記述子を使用した EJB の設定に基づきます。この方法では、Tuxedo バッファと JMS メッセージ間の変換も行います。

始める前に

BEA Tuxedo で使用する AquaLogic Service Bus アプリケーションに関する以下の情報を収集します。

Tuxedo ローカルアクセスポイントの ID。この ID を WLS ユーザとして追加します。
Tuxedo ローカルアクセスポイントのネットワークアドレス。
エクスポートされた Tuxedo サービスの名前。
サービスで XML から FML および FML から XML の変換が必要かどうか。

XML から FML および FML から XML への変換が必要な場合は、1 つまたは複数のフィールドテーブルクラスを追加する必要があります。これらのクラスは、EJB の jar にバンドルされ、EJB の jar から動的にロードされます。

Tuxedo ドメインゲートウェイでこの WebLogic Tuxedo Connector インスタンスを表すために使用するアクセスポイントの ID。
Tuxedo ドメインゲートウェイがこの WebLogic Tuxedo Connector ローカルアクセスポイントに対して定義したネットワークアドレス。

以下の JMS キューを作成する必要があります (ない場合)。

AquaLogic Service Bus サービスへの要求を入れる 1 つまたは複数のキュー
AquaLogic Service Bus サービスからの応答を取得するキュー

サンプル EJB ToQSBean のコンフィグレーション

ejb-jar.xml ファイルに環境エントリを設定し、他のドメインが WebLogic Tuxedo Connector を通じて呼び出すことができるようにする、エクスポートされたサービスの名前を設定します。以下の節では、これらのタスクの手順を説明します。

ejb-jar.xml ファイルの編集

ejb-jar.xml ファイルで、以下の環境エントリを設定します。

JMSConnectionFactory - EJB で使用する JMS 接続ファクトリの JNDI 名を設定します。
ToQueueName - EJB が受信要求を入れる JMS キューの JNDI 名を設定します。この文字列には、実際のサービス名で置換されるインジケータ「%s」を含めることができます。たとえば、CREDITCHECK ATMI サービスを提供するために EJB をデプロイする場合は、この文字列を weblogic.jms.%sServiceRequestQ に設定すると、JNDI 名は weblogic.jms.CREDITCHECKServiceRequestQ になります。
ReplyQueueName - AquaLogic Service Bus が応答を入れる JMS キューの JNDI 名を設定します。この文字列に「%s」を含めて、この設定を汎用的にすることができます。
FieldTables - FML/XML 変換に必要な FML/FML32 フィールドテーブルクラスのカンマ区切りのリスト。

weblogic-ejb-jar.xml ファイルの編集

weblogic-ejb-jar.xml ファイルで、EJB の JNDI 名を tuxedo.services.svcnameHome に設定します。svcname は、デプロイメントでサポートされる ATMI サービス名です。これは、他のドメインが WTC を通じて呼び出すことができる、エクスポートされたサービスの名前です。

weblogic-ejb-jar.xml ファイルの構造のリファレンス情報については、『WebLogic エンタープライズ JavaBeans (EJB) プログラマーズガイド』の「weblogic-ejb-jar.xml デプロイメント記述子のリファレンス」を参照してください。

EJB の JAR ファイルへのフィールドクラスの追加

「フィールドテーブルクラスの作成 (必要な場合)」で説明したようにフィールドクラスを設定する場合は、このタスクは省略可能です。XML から FML および FML から XML への変換に必要なフィールドテーブルクラスファイルを EJB の JAR ファイルに含める必要があります。このタスクの実行手順については、WebLogic Server の Javadoc を参照してください。

EJB のビルドおよびデプロイ

EJB をデプロイすると、WebLogic Server のクライアントで EJB のコンポーネントを使用できるようになります。EJB のデプロイ手順はいくつかあり、ユーザの環境と、EJB のデプロイ先がプロダクション環境かどうかに応じて異なります。

EJB を含む、WebLogic Server アプリケーションおよびモジュールをデプロイする一般的な手順については、WebLogic Server ドキュメントの『WebLogic Server 9.0 アプリケーションのデプロイメント』を参照してください。EJB 固有のデプロイメントの問題と手順については、『WebLogic エンタープライズ JavaBeans (EJB) プログラマーズガイド』の「エンタープライズ JavaBean のデプロイメントガイドライン」を参照してください。

WebLogic Tuxedo Connector のコンフィグレーション

WebLogic Server Administration Console を使用して、WebLogic Tuxedo Connector をコンフィグレーションします。WebLogic Tuxedo Connector の詳細については、WebLogic Server の WebLogic Tuxedo Connector のドキュメントを参照してください。

WebLogic Server Administration Console にログインし、以下の手順を順番に実行します。

注意 : 「WebLogic Tuxedo Connector と Tuxedo キューブリッジのコンフィグレーション」で説明している WTC の設定を実行した場合は、ここで説明する該当タスクを省略できます。必要なタスクは WTC エクスポートサービスの作成だけです。

このコンフィグレーションを完了するには、以下の節で説明するタスクを実行します。