Oracle® Fusion Middleware Oracle WebLogic Server WLECのためのWebLogic Tuxedo Connector移行ガイド

11g リリース1 (10.3.6)

B61643-05(原本部品番号:E13755-06)

目次

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

はじめに

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

- 表記規則

1 WLECからOracle WebLogic Tuxedo Connector移行の概要

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

- 概要

- 前提条件

- Oracle WebLogic Tuxedo ConnectorとWLECの機能の比較

- WLECとOracle WebLogic Tuxedo Connectorの主な相違点

- 新機能と変更点

2 WLECアプリケーションをOracle WebLogic Tuxedo Connector用に変更する方法

- Tuxedo環境の変更方法

- Tuxedo dmconfigファイルの作成

- Tuxedo UBBCONFIGファイルの変更

- WebLogic Server環境の変更方法

- Oracle WebLogic Tuxedo Connectorの構成方法

- WTCサービスの作成

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

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

- インポートされたサービスの作成

- ejb-jar.xmlファイルの更新方法

- WLECアプリケーションの変更方法

- Oracle WebLogic Tuxedo Connectorで使用されるCORBAオブジェクトを参照するようにWLEC EJBを変更する方法

- WTC ORBの初期化

- ORBを使用してFactoryFinderオブジェクトの取得

- トランザクションの問題

- WLECからWTCへ移行するセキュリティ事項の管理方法

3 Tuxedo CORBA Simpappサンプルの変更方法

- Tuxedo環境の変更方法

- Tuxedo CORBA simpappサンプルの実行

- UBB構成ファイルの変更

- ドメイン構成の作成

- Tuxedo環境のテスト

- ejb-jar.xmlファイルの変更

- build.xmlファイルの更新

- WLEC ConverterBeanの変更

- Oracle WebLogic Tuxedo Connectorの構成

- WTCサービスの作成

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

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

- インポートされたサービスの作成

- simpappサンプルの実行

Oracle® Fusion Middleware

Oracle WebLogic Server WLECのためのWebLogic Tuxedo Connector移行ガイド

11g リリース1 (10.3.6)

B61643-05(原本部品番号:E13755-06)

2011年11月

このドキュメントでは、Oracle WebLogic Tuxedo Connectorを使用してOracle WebLogic ServerとOracle Tuxedoの間で相互運用するためにWLECアプリケーションを移行する方法について説明します。

Oracle Fusion Middleware Oracle WebLogic Server WLECのためのWebLogic Tuxedo Connector移行ガイド, 11g リリース1 (10.3.6)

B61643-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 WebLogic Server WLECのためのWebLogic Tuxedo Connector移行ガイド』で使用されるドキュメントのアクセシビリティ機能および表記規則について説明します。

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

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 WLECからOracle WebLogic Tuxedo Connectorへの移行の概要

以下の項では、WLECアプリケーションをOracle WebLogic Tuxedo Connectorに移行するための要件と手順について概説します。

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

- 概要

- 前提条件

- Oracle WebLogic Tuxedo ConnectorとWLECの機能の比較

- WLECとOracle WebLogic Tuxedo Connectorの主な相違点

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

このドキュメントでは、Oracle WebLogic Tuxedo Connectorアプリケーション開発環境について紹介します。このマニュアルでは、Oracle WebLogic Tuxedo Connectorアプリケーション開発環境について紹介するとともに、Oracle WebLogic Tuxedo Connectorを使用してOracle WebLogic ServerとOracle Tuxedoの間で相互運用するためにWLECアプリケーションを移行する方法について説明します。

このドキュメントの構成は次のとおりです。

- この第1章「WLECからOracle WebLogic Tuxedo Connectorへの移行の概要」では、WLECからOracle WebLogic Tuxedo Connectorへの移行の前提条件、Oracle WebLogic Tuxedo ConnectorとWLECの機能比較、および管理とプログラミングに関する主な相違点について説明します。

- 第2章「WLECアプリケーションをOracle WebLogic Tuxedo Connector用に変更する方法」では、Oracle WebLogic Tuxedo Connectorで使用するために、お使いのTuxedo環境、Oracle WebLogic Server環境、およびWLECアプリケーションを変更する方法について説明します。

- 第3章「Tuxedo CORBA Simpappサンプルの変更方法」では、Oracle WebLogic Tuxedo Connectorを使用するようにWLECアプリケーションを変換する例を示します。

概要

WLECは、WebLogic Server 8.1で非推奨になっているサービスです。WLECのユーザーは、WLECを使用するアプリケーションをOracle WebLogic Tuxedo Connectorへ移行することを検討する必要があります。

Oracle WebLogic Tuxedo Connectorを使用すると、WebLogic ServerアプリケーションとTuxedoサービスの双方向の相互運用が実現されます。コネクタでは、WebLogic ServerクライアントがTuxedoサービスを呼び出し、Tuxedoクライアントがサービス・リクエストに応じてWebLogic Server Enterprise JavaBeans (EJB)を呼び出すことができます。

WLECからOracle WebLogic Tuxedo Connectorへの移行には、アプリケーションの修正が若干必要です。

- WLECアプリケーションでは、アプリケーション・コードで、環境オブジェクトを使用または呼び出す部分の修正が必要です。

- 既存のCORBA C++サーバー・オブジェクトでは、サーバー・アプリケーションを変更する必要はありません。

前提条件

WLECアプリケーションからOracle WebLogic Tuxedo Connectorへの移行を始める前に、以下のアプリケーションがインストールされていることを確認します。

- Tuxedo
必要に応じて、TuxedoアプリケーションをTuxedo 8.1以降に移行します。詳細は、http://www.oracle.com/technetwork/middleware/tuxedo/overview/index.htmlを参照してください。

- WebLogic Server
必要に応じて、インストールされているWebLogic ServerをWebLogic Server 9.2に移行します。詳細は、『Oracle WebLogic Serverアップグレード・ガイド』を参照してください。

Oracle WebLogic Tuxedo ConnectorとWLECの機能の比較

表1-1では、Oracle WebLogic Tuxedo ConnectorとWLECでサポートされる機能を比較します。

表1-1 Oracle WebLogic Tuxedo ConnectorとWLECの機能

機能

WTC

WLEC

WLSからのアウトバウンドATMI相互運用性

はい

いいえ

TuxedoからのインバウンドATMI相互運用性

はい

いいえ

アウトバウンドCORBA相互運用性

はい

はい

インバウンドCORBA相互運用性

はい

いいえ

Tuxedoバッファのサポート

はい

いいえ

双方向セキュリティ・コンテキスト伝播

はい

いいえ

双方向トランザクション伝播

はい

いいえ

JMSと/QまたはTuxedoサービスの間の双方向ブリッジ

はい

いいえ

会話

はい

いいえ

VIEW

はい

いいえ

WLECとOracle WebLogic Tuxedo Connectorの主な相違点

表1-2では、管理、構成およびプログラミングに関するOracle WebLogic Tuxedo ConnectorとWLECの主な相違点を示します。

表1-2 WLECとOracle WebLogic Tuxedo Connectorの主な相違点

説明

Oracle WebLogic Tuxedo Connector

WLEC

接続性

Tuxedo /T Domainゲートウェイを使用します。ゲートウェイは、すべてのメソッド呼出しについて、WebLogic ServerインスタンスとTuxedoドメイン間の単一のネットワーク・リンクを作成します。

接続のプールを使用し、このプールから取得した接続を介して、各呼出しが送信されます。

フェイルオーバーの管理

Tuxedoドメインを使用します。

フェイルオーバー・リストを使用します。

オブジェクトのルーティング

WebLogic ServerアプリケーションからのCORBA呼出しは、TGIOP/TDOMAINSプロトコルを使用してTuxedo CORBA環境へ伝播されます。

WebLogic ServerアプリケーションからのCORBA呼出しは、CORBA APIを使用し、IIOP接続プールを介して伝播されます。

新機能と変更点

このリリースで導入されたWebLogic Serverの新機能の包括的なリストは、『Oracle WebLogic Serverの新機能』を参照してください。

2 WLECアプリケーションをOracle WebLogic Tuxedo Connector用に変更する方法

以下の項では、Oracle WebLogic Tuxedo Connector用にWLECアプリケーションを変換するために必要な手順について説明します。

- Tuxedo環境の変更方法

- WebLogic Server環境の変更方法

- WLECアプリケーションの変更方法

Tuxedo環境の変更方法

Tuxedoユーザーは、以下の項で説明されるように環境の変更を行う必要があります。

- Tuxedo dmconfigファイルの作成

- Tuxedo UBBCONFIGファイルの変更

Tuxedo dmconfigファイルの作成

新しいdmconfigファイルを作成して、TuxedoアプリケーションとWebLogic Serverアプリケーションの間の接続を提供する必要があります。Tuxedoドメインの作成方法については、http://www.oracle.com/technetwork/middleware/tuxedo/overview/index.htmlでCORBAドメインのプランニングと構成に関する説明を参照してください。

Tuxedo UBBCONFIGファイルの変更

アプリケーションはTuxedo/T Domainゲートウェイを使用するので、UBBCONFIGファイルを変更する必要があります。これを行うには、このファイルの*SERVERSセクションにTuxedoドメイン・サーバーを追加します。

例:

DMADM SRVGRP=SYS_GRP SRVID=7
GWADM SRVGRP=SYS_GRP SRVID=8
GWTDOMAIN SRVGRP=SYS_GRP SRVID=9

Oracle WebLogic Tuxedo ConnectorではISLは使用されません。ISLを必要とするその他のアプリケーションがない場合は、UBBCONFIGファイルの*SERVERSセクションからISLを削除できます。または、次の例に示すように、ISLをコメント・アウトすることができます。

#     ISL
#          SRVGRP  = SYS_GRP
#          SRVID   = 5
#           CLOPT   = "-A -- -n //lchp15:2468 -d /dev/tcp"

WebLogic Server環境の変更方法

以下の項では、WebLogic Server環境を変更する方法について説明します。

- Oracle WebLogic Tuxedo Connectorの構成方法

- ejb-jar.xmlファイルの更新方法

Oracle WebLogic Tuxedo Connectorの構成方法

注意:

Oracle WebLogic Tuxedo Connectorの構成方法の詳細は、『Oracle WebLogic Server Tuxedo Connector管理ガイド』のアプリケーション用のOracle WebLogic Tuxedo Connectorの構成に関する項を参照してください。

この項では、WebLogic Server管理コンソールを使用して、移行されたWLECアプリケーション用にWTCサービスを作成する基本的な方法について説明します。WTCサービスは、WebLogic ServerがTuxedoアプリケーションへの接続の作成に使用する構成情報を表します。移行されたWLECアプリケーション用のWTCサービスは通常、ローカルTuxedoアクセス・ポイント、リモートTuxedoアクセス・ポイント、およびインポートされたサービスで構成されます。

次の項で説明された手順に従って、アプリケーションを管理するための構成を作成します。

1. WTCサービスの作成

2. ローカルTuxedoアクセス・ポイントの作成

3. リモートTuxedoアクセス・ポイントの作成

4. インポートされたサービスの作成

WTCサービスの作成

WebLogic Server管理コンソールを使用して、WTCサービスを作成および構成するには:

1. 管理コンソールのナビゲーション・ツリーで、「相互運用性」を展開して「WTCサーバー」を選択します。

2. 「WTCサーバー」ページで、「新規作成」をクリックします。

3. 「新しいWTCサーバーの作成」ページの「名前」フィールドに、WTCサービスの名前を入力します。例: mySimpapp。

4. 「OK」をクリックします。

新しいWTCサービスがWTCサーバーのリストに表示されます。

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

注意:

ローカル・アクセス・ポイントのネットワーク・アドレスを構成する場合、使用するポート番号は、他のプロセスに割り当てられたポート番号とは異なる必要があります。たとえば、WebLogic Serverのリスニング・ポートが//mymachine:7001に割り当てられている場合、ネットワーク・アドレスを//mymachine:7001に設定すると無効になります。

ローカルTuxedoアクセス・ポイントを構成するには:

1. 管理コンソールで、「相互運用性」を展開して「WTCサーバー」を選択します。

2. 「WTCサーバー」ページで、mySimpappなどのWTCサービス名をクリックして、設定ページにアクセスします。

3. 「ローカルAP」タブをクリックします。

4. 「WTCローカル・アクセス・ポイント」ページで、以下のフィールドに次のとおり、値を入力します。

- 「アクセス・ポイント」に、このローカルTuxedoアクセス・ポイントをWTCサービスの構成内で一意に識別する名前を入力します。これにより、同じアクセス・ポイントIDを持つ複数のローカルTuxedoアクセス・ポイントの構成を作成できます。

- 「アクセス・ポイントID」に、リモートTuxedoアクセス・ポイントへのセッション接続を確立するときに使用する接続名を入力します。「アクセス・ポイントID」は、Tuxedo DMCONFIGファイルの*DM_REMOTE_DOMAINSセクションにある、対応するDOMAINIDに一致する必要があります。

- 「ネットワーク・アドレス」に、このローカルTuxedoアクセス・ポイントのネットワーク・アドレスとポートを入力します。例: //123.123.123.123:5678。

5. 「OK」をクリックします。

6. Tuxedo 6.5ドメインに接続する場合:

1. 「接続」タブをクリックします。

2. 「相互運用」フィールドを「はい」に設定します。

3. 「保存」をクリックします。

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

リモートTuxedoアクセス・ポイントを構成するには:

1. 管理コンソールで、「相互運用性」を展開して「WTCサーバー」を選択します。

2. 「WTCサーバー」ページで、mySimpappなどのWTCサービス名をクリックします。

3. 「リモートAP」タブをクリックします。

4. 「WTCリモート・アクセス・ポイント」ページで、次のフィールドに次の値を入力します:

- 「アクセス・ポイント」に、このリモートTuxedoアクセス・ポイントをWTCサービスの構成内で一意に識別する名前を入力します。これにより、同じアクセス・ポイントIDを持つ複数のリモートTuxedoアクセス・ポイントの構成を作成できます。

- 「アクセス・ポイントID」に、ローカルTuxedoアクセス・ポイントへの接続を確立するときにリモートTuxedoアクセス・ポイントを識別するために使用する接続名を入力します。リモートTuxedoアクセス・ポイントの「アクセス・ポイントID」は、Tuxedo DMCONFIGファイルの*DM_LOCAL_DOMAINSセクションにある、対応するDOMAINIDに一致する必要があります。

- 「ローカル・アクセス・ポイント」に、このリモート・ドメインのローカル・アクセス・ポイントの名前を入力します。

- 「ネットワーク・アドレス」に、このリモート・ドメインのネットワーク・アドレスとポートを入力します。例: //123.123.123.123:1234。

5. 「OK」をクリックします。

インポートされたサービスの作成

インポートされたサービスを構成するには:

1. 管理コンソールで、「相互運用性」を展開して「WTCサーバー」を選択します。

2. 「WTCサーバー」ページで、mySimpappなどのWTCサービス名をクリックします。

3. 「インポート済み」タブをクリックします。

4. 「WTCインポート・サービス」ページで、次のフィールドに次の値を入力します:

- 「リソース名」に、このインポートされたサービスの構成を識別するための名前を入力します。この名前により、WTCサービス内で同一のリモート名を持つ、一意の複数のインポート・サービス構成を作成できます。

- 「ローカル・アクセス・ポイント」を、サービスを使用するローカルTuxedoアクセス・ポイントの名前に設定します。

- 「リモート・アクセス・ポイント・リスト」に、このインポートされたサービスを提供するリモート・アクセス・ポイントの名前のリストを入力します。

- 「リモート名」に、//domain_idを入力します。domain_idは、Tuxedo UBBCONFIGファイルで指定されたDOMAINIDです。このCORBAドメインの一意の識別子の最大長は、//を含めて15文字です。たとえば、//simpappff。

5. 「OK」をクリックします。

ejb-jar.xmlファイルの更新方法

Oracle WebLogic Tuxedo Connectorでは、ドメイン・ゲートウェイを使用してWebLogicアプリケーションとTuxedoアプリケーションが接続されます。IIOP接続プールは使用されないので、記述子をejb-jar.xmlファイルから削除できます。以下は、wlec/ejb/simpappサンプルからのコード・スニペットです。

例2-1 wlec/ejb/simpappサンプルのIIOP接続プール記述子

.
.
.
<env-entry>
<env-entry-name>IIOPPoolName</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>simplepool</env-entry-value>
</env-entry>
.
.
.

WLECアプリケーションの変更方法

以下の項では、Oracle WebLogic Tuxedo Connectorを使用してWebLogic ServerオブジェクトとTuxedo CORBAオブジェクトを相互運用するために、WLECアプリケーションを変更する方法について説明します。

- Oracle WebLogic Tuxedo Connectorで使用されるCORBAオブジェクトを参照するようにWLEC EJBを変更する方法

- トランザクションの問題

Oracle WebLogic Tuxedo Connectorで使用されるCORBAオブジェクトを参照するようにWLEC EJBを変更する方法

以下の手順に従って、EJBを変更し、Oracle WebLogic Tuxedo Connectorを使用してTuxedoにデプロイされているCORBAオブジェクトを呼び出します。

- WTC ORBの初期化

- ORBを使用してFactoryFinderオブジェクトの取得

WTC ORBの初期化

WLECはweblogic.jndi.WLInitialContextFactoryを使用して、Tobj_Bootstrapオブジェクトによって使用されるコンテキストを返します。

Properties p = new Properties();
p.put(Context.INITIAL_CONTEXT_FACTORY,
"weblogic.jndi.WLInitialContextFactory");
InitialContext ic = new InitialContext(p);
rootCtx = (Context)ic.lookup("java:comp/env");

WLECコンテキストの参照を置き換えて、BeanのWTC ORBを初期化します。例:

// Initialize the ORB.
String args[] = null;
Properties Prop;
Prop = new Properties();
Prop.put("org.omg.CORBA.ORBClass",
"weblogic.wtc.corba.ORB");

orb = (ORB)new InitialContext().lookup("java:comp/ORB");

ORBを使用してFactoryFinderオブジェクトの取得

各WLEC接続プールには、Tuxedoドメインへのアクセスに使用されるTobj_Bootstrap FactoryFinderオブジェクトがあります。例:

Tobj_Bootstrap myBootstrap = Tobj_BootstrapFactory.getClientContext("myPool");
org.omg.CORBA.Object myFFObject =
myBootstrap.resolve_initial_references("FactoryFinder");

Tobj_Bootstrap FactoryFinderオブジェクトへの参照を削除します。次のメソッドで、ORBを使用してFactoryFinderオブジェクトを取得します。

// String to Object.
org.omg.CORBA.Object fact_finder_oref =               orb.string_to_
object("corbaloc:tgiop:simpapp/FactoryFinder");

// Narrow the factory finder.
FactoryFinder fact_finder_ref =
FactoryFinderHelper.narrow(fact_finder_oref);

// Use the factory finder to find the simple factory.
org.omg.CORBA.Object simple_fact_oref =
fact_finder_ref.find_one_factory_by_id(SimpleFactoryHelper.id());

トランザクションの問題

注意:

JTAトランザクションの実装方法の詳細は、『Oracle WebLogic Server JTAのプログラミング』を参照してください。

この項では、トランザクションを使用するWLECアプリケーションの変更方法について説明します。

- JTAトランザクションを使用するWLECアプリケーションの場合、変更は必要ありません。

- CosTransactionsを使用するWLECアプリケーションの場合、JTAに変換する必要があります。WLECクライアントがトランザクション内で実行中であり、新しいCosTransactionを呼び出す必要がある場合、新しいトランザクションは新しいトランザクション・コンテキストで実装されます。JTAで同じ動作を実装するには、次の手順に従います。

- 元のトランザクションを一時停止します。

- 新しいトランザクションを開始します。

- 新しいトランザクションが完了した後で、元のトランザクションを再開します。

WLECからWTCへ移行するセキュリティ事項の管理方法

次の表に、セキュリティ事項のWLECとWTCの間のマッピング・ガイドラインと、そのTuxedoとの関係を示します。

表2-1 WLECからWTCへ移行するセキュリティのマッピング・ガイドライン

WLECのセキュリティ事項

WTC/WLSでのマッピング

Tuxedo

ユーザー名

「WTCサーバー」ページにアクセスし、「ローカルAP」タブをクリックします。「アクセス・ポイントID」フィールドのユーザー名を使用します。

DMCONFIGファイルのDM_REMOTE_DOMAINSセクションにあるDOMAINID

ユーザー・パスワード

パスワードのペア(相互認証を形成するには、1つのパスワードではなく、ローカル・アクセス・ポイント用のパスワードと、リモート・アクセス・ポイント用のパスワードを定義する必要があります)。

weblogic.wtc.gwt.genpasswdユーティリティを使用して暗号化されたパスワードのペアを生成できます。それを切り取って、コンソールの「WTCパスワード」ページに貼り付けます。

dmadminを使用して、定義された各TDomainセッションにパスワードのペアを追加します。

ロール

サポートされていません。

WTCでは、なりすましユーザーが信され、Tuxedoで定義されている、なりすまされたユーザーのロールが使用されます。

非適用

アプリケーション・パスワード

「WTCリソース」ページのパスワード。weblogic.wtc.gwt.genpasswdユーティリティを使用して、暗号化されたアプリケーション・パスワードを生成します。

特別な構成は不要。

最小暗号化レベル

1. 「WTCサーバー」ページにアクセスし、WTCサービス名をクリックします。

2. 「リモートAP」タブをクリックします。

3. 「セキュリティ」タブをクリックし、必要な「最小暗号化レベル」を選択します。

DMCONFIGファイルのDM_TDOMAINセクションにあるMINENCRYPTBITS。

最大暗号化レベル

1. 「WTCサーバー」ページにアクセスし、WTCサービス名をクリックします。

2. 「リモートAP」タブをクリックします。

3. 「セキュリティ」タブをクリックし、必要な「最大暗号化レベル」を選択します。

DMCONFIGファイルのDM_TDOMAINセクションにあるMAXENCRYPTBITS。

証明書認証

サポートされていません。

非適用

セキュリティ・コンテキストの伝播

1. 「WTCサーバー」ページにアクセスし、WTCサービス名をクリックします。

2. 「リモートAP」タブをクリックします。

3. 「セキュリティ」タブをクリックし、「資格証明ポリシー」フィールドで「グローバル」を選択してTuxedoにユーザー資格証明を伝播します。

DMCONFIGファイルのDM_REMOTE_DOMAINSセクションにあるACL="GLOBAL"

以下の考慮事項に留意していただくと、現在お使いのWLECセキュリティをWTCおよびTuxedoセキュリティにマップする方法が理解しやすくなります。

- 証明書のWLECユーザー名は、「ローカルAP」ページのアクセス・ポイントIDとして使用できます。

- 「リモートAP」ページのアクセス・ポイントIDは、リモートTuxedoドメイン・ゲートウェイのDOMAINIDを使用して構成する必要があります。(このDOMAINIDはDMCONFIGファイルのDM_LOCAL_DOMAINSセクションのエントリのいずれかでなければなりません。)

- セキュリティ・コンテキストの伝播が必要な場合は、TuxedoとWTCの両方でユーザーを構成する必要があります。

- セキュリティ・コンテキストの伝播が不要な場合は、credential-policyを構成しないでください。デフォルトでは、credential-policyは、伝播しないことを意味する"LOCAL"に設定されています。また、TuxedoのACL_POLICYを構成しないでください。デフォルトでは、ACL_POLICYは、受信したリモート・セキュリティ・コンテキストを受け付けないことを意味する"LOCAL"に設定されています。この場合、Tuxedoのセキュリティ・レベルがUSER_AUTHより高いときは、DMCONFIGファイルのDM_REMOTE_DOMAINSセクションで構成されているWTC用のDOMAINIDが使用されます。

- 「ローカルAP」ページの「セキュリティ」タブで、「セキュリティ」フィールドを「ドメイン・パスワード」に設定します。TuxedoのDMCONFIGファイルにあるDM_LOCAL_DOMAINSセクションのいずれかのエントリで'SECURITY="DM_PW"'を構成する必要があります。この場合、WTCとTDomainゲートウェイの両方に対してパスワードを構成する必要があり、アプリケーション・パスワードは不要です。

- 「セキュリティ」を「ドメイン・パスワード」に設定しない場合は、「セキュリティ」を「アプリケーション・パスワード」に設定できます。この場合、「WTCパスワード構成」ページでパスワードのペアを構成する必要はありませんが、「WTCリソース」ページの「アプリケーション・パスワード」フィールドと「アプリケーション・パスワードIV」フィールドを構成する必要があります。

3 Tuxedo CORBA Simpappサンプルの変更方法

以下の項では、Oracle WebLogic Tuxedo Connectorを使用するようにWLECアプリケーションを変換する方法について説明します。この例では、Oracle WebLogic Tuxedo Connectorを使用して動作するようにWebLogic Server 6.1のexamples\wlec\ejb\simpappサンプルを変換する手順について説明します。

先に進む前に、「前提条件」を確認してください。

- Tuxedo環境の変更方法

- ejb-jar.xmlファイルの変更

- build.xmlファイルの更新

- WLEC ConverterBeanの変更

- Oracle WebLogic Tuxedo Connectorの構成

- simpappサンプルの実行

Tuxedo環境の変更方法

以下の項では、Oracle WebLogic Tuxedo Connectorで使用するためにTuxedo構成ファイルを変更する方法について説明します。

- Tuxedo CORBA simpappサンプルの実行

- UBB構成ファイルの変更

- ドメイン構成の作成

- Tuxedo環境のテスト

Tuxedo CORBA simpappサンプルの実行

Tuxedo環境を確認してWLEC simpappアプリケーションの実行を準備するには、Tuxedo CORBA simpappサンプルを実行する必要があります。

次の手順に従って、$TUXDIR/samples/corba/simpappにあるTuxedoサンプルを実行します。

1. Tuxedo CORBA simpappサンプルの作業用コピーを作成します。インストールされているTuxedoからTuxedo CORBA simpappサンプルをコピーし、作業用のsimpappディレクトリに格納します。

2. 作業用のsimpappディレクトリへ移動します。

3. サンプルをビルドして実行します。

1. Tuxedo環境を設定します。Windowsの場合は、シェル環境でset %TUXDIR%を実行します。Unixの場合は、$TUXDIR/tux.envを実行してTuxedo環境を設定する必要があります。

2. C++コンパイラがPATHに含まれていることを確認します。

3. JAVA_HOME環境変数をTuxedo Java JDKの場所に設定します。

4. runmeスクリプトを実行して環境を設定します。CORBAオブジェクト操作のプログラミング・インタフェースを提供するクライアント・スタブが作成されます。作業ディレクトリの中に、Tuxedo環境の構成に使用するファイルが格納されたresultsディレクトリが作成されます。

5. クライアントを実行します。

java -DTOBJADDR=%TOBJADDR% -classpath %CLASSPATH% SimpleClient

6. Tuxedoサーバーを停止します。

tmshutdown -y

UBB構成ファイルの変更

作業用のTuxedo simpappディレクトリで、次の手順に従ってUBB構成を変更します。

1. 作業ディレクトリのresults/ubbファイルの名前をresults/ubbdomainに変更します。

2. viやワードパッドなどのテキスト・エディタを使用してubbdomainファイルを編集します。

3. *SERVERSセクションにTuxedoゲートウェイ・サーバーを追加します。
例:次のサーバーを追加します。

DMADM SRVGRP=SYS_GRP SRVID=7
GWADM SRVGRP=SYS_GRP SRVID=8
GWTDOMAIN SRVGRP=SYS_GRP SRVID=9

4. ubbdomainファイルを保存します。

例3-1は、変更後のubbdomainファイルの例です。変更されたセクションは太字で示されています。

例3-1 変更後のUBBファイル

*RESOURCES
IPCKEY    55432
DOMAINID  simpapp
MASTER    SITE1
MODEL     SHM
LDBAL     N
*MACHINES
"balto"
LMID         = SITE1
APPDIR       = "/tux_apps/corba/simpapp"
TUXCONFIG    = "/tux_apps/corba/simpapp/results/tuxconfig"
TUXDIR       = "/my_machine/tux/tuxedo8.1"
MAXWSCLIENTS = 10
*GROUPS
SYS_GRP
LMID    = SITE1
GRPNO   = 1
APP_GRP
LMID    = SITE1
GRPNO   = 2
*SERVERS
DEFAULT:
RESTART = Y
MAXGEN  = 5
TMSYSEVT
SRVGRP  = SYS_GRP
SRVID   = 1
TMFFNAME
SRVGRP  = SYS_GRP
SRVID   = 2
CLOPT   = "-A -- -N -M"
TMFFNAME
SRVGRP  = SYS_GRP
SRVID   = 3
CLOPT   = "-A -- -N"
TMFFNAME
SRVGRP  = SYS_GRP
SRVID   = 4
CLOPT   = "-A -- -F"
simple_server
SRVGRP  = APP_GRP
SRVID   = 1
RESTART = N

# The ISL handler is not needed for WTC.
# If you do not need it for other WLEC applications,
# it can be removed.
ISL
SRVGRP  = SYS_GRP
SRVID   = 5
CLOPT   = "-A -- -n //mymachine:2468 -d /dev/tcp"
DMADM
SRVGRP       = SYS_GRP
SRVID       = 7
GWADM
SRVGRP       = SYS_GRP
SRVID       = 8
GWTDOMAIN
SRVGRP       = SYS_GRP
SRVID       = 9
*SERVICES

ドメイン構成の作成

作業用のTuxedo simpappディレクトリで、次の手順に従ってドメイン構成を作成します。

1. viやメモ帳などのテキスト・エディタを使用してドメイン構成ファイルを作成します。最も簡単な方法はDMCONFIGのサンプル・コードを切り取り、エディタに貼り付けることです。

2. 例3-2の太字山カッコ<>で囲まれたすべての項目を使用している環境の情報に置き換えます。

例3-2 dmconfigファイル

*DM_RESOURCES
VERSION=U22
*DM_LOCAL_DOMAINS
TUXDOM     GWGRP=SYS_GRP
TYPE=TDOMAIN
DOMAINID="TUXDOM"
BLOCKTIME=20
MAXDATALEN=56
MAXRDOM=89
DMTLOGDEV="<Path to domain TLOG device>"
DMTLOGNAME="DMTLOG_TUXDOM"
*DM_REMOTE_DOMAINS
examples TYPE=TDOMAIN DOMAINID="examples"
*DM_TDOMAIN
TUXDOM NWADDR="<network address of Tuxedo domain>"
examples NWADDR="<network address of WTC domain>"
*DM_REMOTE_SERVICES

3. ファイルにDMCONFIGという名前を付けて作業用のsimpapp/resultsディレクトリに保存します。

Tuxedo環境のテスト

次の手順に従ってTuxedo構成を確認します。

1. 新しいシェルで、作業用のsimpapp/resultsディレクトリに移動します。

2. ご使用のプラットフォームのsetenvスクリプトを使用して環境を設定します。

3. ubbdomainファイルをロードします。

tmloadcf -y ubbdomain

4. DMCONFIGファイルをロードします。

set BDMCONFIG=<path_to_your_working_simpapp_example>/simpapp/results/bdmconfig
dmloadcf -y dmconfig

5. Tuxedoドメインを起動します。

tmboot -y

6. Tuxedo環境を確認します。

java -DTOBJADDR=%TOBJADDR% -classpath %CLASSPATH% SimpleClient

7. Tuxedoサーバーを停止します。

tmshutdown -y

ejb-jar.xmlファイルの変更

viやメモ帳などのテキスト・エディタを使用して、接続プール記述子を削除し、trans-attributeを更新します。例3-3は、WLEC simpappサンプルのejb-jar.xmlで、IIOP接続プール記述子の参照を削除する方法を示したサンプル・コードです。このサンプルでは、

- env-entry属性を削除します。

- container-transactionのtrans-attributeをSupportsに設定します。サンプルにはトランザクションがないため、container-transactionをRequiredにすることはできません。

例3-3 CORBAサーバー・アプリケーションのサンプルXML構成ファイル

.
.
.
<ejb-jar>
<enterprise-beans>
<session>
<ejb-name>ejb</ejb-name>
<home>examples.wlec.ejb.simpapp.ConverterHome</home>
<remote>examples.wlec.ejb.simpapp.Converter</remote>
<ejb-class>examples.wlec.ejb.simpapp.ConverterBean</ejb-class>
<session-type>Stateless</session-type>
<transaction-type>Container</transaction-type>
<!-- Remove or comment out the following statements
<env-entry>
<env-entry-name>IIOPPoolName</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>simplepool</env-entry-value>
</env-entry>
-->
</session>
</enterprise-beans>
<assembly-descriptor>
<container-transaction>
<method>
<ejb-name>ejb</ejb-name>
<method-intf>Remote</method-intf>
<method-name>*</method-name>
</method>
<trans-attribute>Supports</trans-attribute>
</container-transaction>
</assembly-descriptor>
</ejb-jar>

build.xmlファイルの更新

移行したアプリケーションのWebLogic環境へのコンパイルとデプロイを容易にするために、build.xmlファイルを以下に示します。build.xmlファイルの内容を例3-4に示すコードに置き換えます。

例3-4 更新後のbuild.xmlファイル

<project name="wlec-ejb-simpapp" default="all" basedir=".">

<!-- set global properties for this build -->
<property environment="env"/>
<property file="../../../../examples.properties"/>
<property name="build.compiler" value="${compiler}"/>
<property name="source" value="."/>
<property name="build" value="${source}/build"/>
<property name="dist" value="${source}/dist"/>
<property name="ejb_classes" value="Converter.java, ConverterHome.java, ConverterResult.java,
ProcessingErrorException.java, ConverterBean.java"/>
<property name="ejb_jar" value="wlec_simpapp_corba.jar"/>
<property name="client_classes" value="Converter.java, ConverterHome.java, ConverterResult.java,
ProcessingErrorException.java, Client.java"/>

<target name="all" depends="clean, init, compile_idl, compile_ejb, jar_ejb, appc, compile_client"/>

<target name="init">
<!-- Create the time stamp -->
<tstamp/>
<!-- Create the build directory structure used by compile
and copy the deployment descriptors into it-->
<mkdir dir="${build}"/>
<mkdir dir="${build}/META-INF"/>
<mkdir dir="${dist}"/>
<copy todir="${build}/META-INF">
<fileset dir="${source}">
<include name="*.xml"/>
<exclude name="build.xml"/>
</fileset>
</copy>
</target>

<!-- Compile IDL stub classes into the build directory (jar preparation) -->
<target name="compile_idl">
<exec executable="idlj" dir=".">
<arg line="-td build -pkgPrefix Simple simple -pkgPrefix      SimpleFactory simple simple.idl" />
</exec>
<javac srcdir="${build}" destdir="${build}"
classpath="${CLASSPATH};${build}"/>
<delete>
<fileset dir="${build}">
<include name="*.java"/>
</fileset>
</delete>
</target>

<!-- Compile ejb classes into the build directory (jar preparation) -->
<target name="compile_ejb">
<javac srcdir="${source}" destdir="${build}"
includes="${ejb_classes}"
classpath="${CLASSPATH};${build}"/>
</target>

<!-- Make a standard ejb jar file, including XML deployment descriptors -->
<target name="jar_ejb" depends="compile_ejb">
<jar jarfile="${dist}/std_${ejb_jar}"
basedir="${build}">
</jar>
</target>

<!-- Run appc to create the deployable jar file -->
<target name="appc" depends="jar_ejb">
<echo message="Generating container classes in ${apps.dir}/${ejb_jar}"/>
<wlappc debug="${debug}"
iiop="true"
source="${dist}/std_${ejb_jar}"
output="${apps.dir}/${ejb_jar}"
/>
</target>

<!-- Compile EJB interfaces & client app into the clientclasses directory
-->
<target name="compile_client">
<javac srcdir="${source}"
destdir="${client.classes.dir}"
includes="${client_classes}"
/>
</target>

<target name="run">
<java classname="examples.wlec.ejb.simpapp.Client">
</java>
</target>

<target name="clean">
<delete dir="${build}"/>
<delete dir="${dist}"/>
</target>
</project>

WLEC ConverterBeanの変更

例3-5は、wlec/ejb/simpappサンプルのConverterBean.javaファイルを変更し、Oracle WebLogic Tuxedo Connectorを使用してTuxedoと相互運用する方法を示したサンプル・コードです。

- 変更箇所はすべて太字でnew codeのように強調表示されています。

- 不要になった文は//を使用して// old codeのようにコメント・アウトされています。

例3-5 変更後のConverterBean.javaファイル

package examples.wlec.ejb.simpapp;

import javax.ejb.*;
import java.io.Serializable;
import java.util.*;
import javax.naming.Context;
import javax.naming.InitialContext;
import javax.naming.NamingException;

import org.omg.CORBA.*;
import com.beasys.Tobj.*;
import com.beasys.*;

/*These come from WebLogic Enterprise Simpapp sample */
//import SimpleFactory;
//import SimpleFactoryHelper;
//import Simple;
import simple.SimpleFactory;
import simple.SimpleFactoryHelper;
import simple.Simple;

/**
* <font face="Courier New" size=-1>ConverterBean</font> is a stateless
* SessionBean.
* This bean illustrates:
* <ul>
* <li> Accessing ISL/ISH process and then a WebLogic Enterprise server
* <li> No persistence of state between calls to the SessionBean
* <li> Application-defined exceptions
* </ul>
*/
public class ConverterBean implements SessionBean {

static SimpleFactory simple_factory_ref;

// -----------------------------------------------------------------
// private variables
private SessionContext ctx;
private Context        rootCtx;
private ORB orb;

// -----------------------------------------------------------------
// SessionBean implementation

/**
* This method is required by the EJB Specification,
* but is not used by this example.
*
*/
public void ejbActivate()  {}

/**
* This method is required by the EJB Specification,
* but is not used by this example.
*
*/
public void ejbRemove() {}

/**
* This method is required by the EJB Specification,
* but is not used by this example.
*
*/
public void ejbPassivate() {}

/**
* Sets the session context.
*
* @param ctx               SessionContext context for session
*/
public void setSessionContext(SessionContext ctx) {
this.ctx = ctx;
}

// Interface exposed to EJBObject

/**
* This method corresponds to the <font face="Courier New" size=-1>create</font>
* method in the home interface <font
*face="CourierNew"size=-1>ConverterHome.java</font>.
* The parameter sets of these two methods are identical. When the client calls the
* <font face="Courier New" size=-1>ConverterHome.create</font> method, the
* container allocates an instance of the EJBean and calls the
* <font face="Courier New" size=-1>ejbCreate</font> method.
*
* @exception               CreateException
*                          if there is an error while initializing the IIOP pool
* @see                     examples.wlec.ejb.simpapp.Converter
*/
public void ejbCreate () throws CreateException {
try {
// try {
// Properties p = new Properties();
// p.put(Context.INITIAL_CONTEXT_FACTORY,
// "weblogic.jndi.WLInitialContextFactory");
// InitialContext ic = new InitialContext(p);
// rootCtx = (Context)ic.lookup("java:comp/env");
//  }
//catch (NamingException ne) {
//  throw new CreateException("Could not lookup context");
// }

// Initialize the ORB.
String args[] = null;
Properties Prop;
Prop = new Properties();
Prop.put("org.omg.CORBA.ORBClass",
"weblogic.wtc.corba.ORB");

orb = (ORB)new InitialContext().lookup("java:comp/ORB");

initIIOPpool();
}
catch (Exception e) {
throw new CreateException("ejbCreate called: " + e);
}
}

/**
* Converts the string to uppercase.
*
* @param mixed             string input data
* @return                  ConverterResult conversion result
* @exception               examples.wlec.ejb.simpapp.ProcessingErrorException
*                          if there is an error while converting the string
*/
public ConverterResult toUpper(String mixed)
throws ProcessingErrorException
{
return convert("UPPER", mixed);
}

/**
* Converts the string to lowercase.
*
* @param mixed             string input data
* @return                  ConverterResult conversion result
* @exception               examples.wlec.ejb.simpapp.ProcessingErrorException
*                          if there is an error while converting the string
*/
public ConverterResult toLower(String mixed)
throws ProcessingErrorException
{
return convert("LOWER", mixed);
}

protected ConverterResult convert (String changeCase, String mixed)
throws ProcessingErrorException
{
String result;
try {
// Find the simple object.
Simple simple = simple_factory_ref.find_simple();

if (changeCase.equals("UPPER")) {
// Invoke the to_upper opeation on M3 Simple object
org.omg.CORBA.StringHolder buf = new org.omg.CORBA.StringHolder(mixed);
simple.to_upper(buf);
result = buf.value;
}
else
{
result = simple.to_lower(mixed);
}

}
catch (org.omg.CORBA.SystemException e) {
throw new ProcessingErrorException("Converter error: Corba system exception: " + e);
}
catch (Exception e) {
throw new ProcessingErrorException("Converter error: " + e);
}
return new ConverterResult(result);
}

// Private methods

/**
* Returns the WebLogic Enterprise Connectivity pool name.
*
* @return                  String IIOP pool name
*/
// private String getIIOPPoolName() throws ProcessingErrorException {
// try {
// return (String) rootCtx.lookup("IIOPPoolName");
//}
// catch (NamingException ne) {
// throw new ProcessingErrorException ("IIOPPoolName not found in context");
//}
//}

/**
* Initializes an IIOP connection pool.
*/

private void initIIOPpool() throws Exception {
try {
// Create the bootstrap object,
// Tobj_Bootstrap bootstrap = // BootstrapFactory.getClientContext(getIIOPPoolName());

// Use the bootstrap object to find the factory finder.
// org.omg.CORBA.Object fact_finder_oref =
// bootstrap.resolve_initial_references("FactoryFinder") ;
org.omg.CORBA.Object fact_finder_oref =
orb.string_to_object("corbaloc:tgiop:simpapp/FactoryFinder");

// Narrow the factory finder.
FactoryFinder fact_finder_ref =
FactoryFinderHelper.narrow(fact_finder_oref);

// Use the factory finder to find the simple factory.
org.omg.CORBA.Object simple_fact_oref =
fact_finder_ref.find_one_factory_by_id(SimpleFactoryHelper.id());

// Narrow the simple factory.
simple_factory_ref =
SimpleFactoryHelper.narrow(simple_fact_oref);

}
catch (org.omg.CosLifeCycle.NoFactory e) {
throw new Exception("Can't find the simple factory: " +e);
}
catch (CannotProceed e) {
throw new Exception("FactoryFinder internal error: " +e);
}
catch (RegistrarNotAvailable e) {
throw new Exception("FactoryFinder Registrar not available: " +e);
}
//catch (InvalidName e) {
//   throw new Exception("Invalid name from resolve_initial_reference(): " +e);
//}
// catch (org.omg.CORBA.BAD_PARAM e) {
//   throw new Exception("Invalid TOBJADDR=//host:port property specified: " +e);
// }
catch (org.omg.CORBA.UserException e) {
throw new Exception("Unexpected CORBA user exception: " +e);
}
catch (org.omg.CORBA.SystemException e) {
throw new Exception("CORBA system exception: " +e);
}
}
}

Oracle WebLogic Tuxedo Connectorの構成

以下の項では、WebLogic Serverと変更済みのWLECアプリケーションを接続するようにWebLogic Tuxedo Connectorを構成する方法を説明します。

1. WTCサービスの作成

2. ローカルTuxedoアクセス・ポイントの作成

3. リモートTuxedoアクセス・ポイントの作成

4. インポートされたサービスの作成

WTCサービスの作成

WebLogic Server管理コンソールを使用して、WTCサービスを作成および構成するには:

1. 管理コンソールのナビゲーション・ツリーで、「相互運用性」を展開して「WTCサーバー」を選択します。

2. 「WTCサーバー」ページで、「新規作成」をクリックします。

3. 「新しいWTCサーバーの作成」ページの「名前」フィールドに、この構成を識別するMy_WLEC_Appを入力します。

4. 「OK」をクリックします。

新しいWTCサービスがWTCサーバーのリストに表示されます。

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

注意:

ローカル・アクセス・ポイントのネットワーク・アドレスを構成する場合、使用するポート番号は、他のプロセスに割り当てられたポート番号とは異なる必要があります。たとえば、WebLogic Serverのリスニング・ポートが//mymachine:7001に割り当てられている場合、ネットワーク・アドレスを//mymachine:7001に設定すると無効になります。

ローカルTuxedoアクセス・ポイントを構成するには:

1. 管理コンソールで、「相互運用性」を展開して「WTCサーバー」を選択します。

2. 「WTCサーバー」ページで、WTCサービス名をクリックして、設定ページにアクセスします。

3. 「ローカルAP」タブをクリックします。

4. 「WTCローカル・アクセス・ポイント」ページで、以下のフィールドに次のとおり、値を入力します。

- 「アクセス・ポイント」にMy_Local_WLS_Domを入力します。

- 「アクセス・ポイントID」にexamplesと入力します。

5. 「ネットワーク・アドレス」に、このローカル・ドメインをホストするWebLogic Server環境のネットワーク・アドレスとポートを入力します。たとえば、//my_WLS_machine:5678。

6. 「OK」をクリックします。

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

リモートTuxedoアクセス・ポイントを構成するには:

1. 管理コンソールで、「相互運用性」を展開して「WTCサーバー」を選択します。

2. 「WTCサーバー」ページで、WTCサービス名をクリックします。

3. 「リモートAP」タブをクリックします。

4. 「WTCリモート・アクセス・ポイント」ページで、次のフィールドに次の値を入力します:

- 「アクセス・ポイント」にMy_WLEC_Domと入力します。

- 「アクセス・ポイントID」にTUXDOMと入力します。

- 「ローカル・アクセス・ポイント」に、My_Local_WLS_Domと入力します。

5. 「ネットワーク・アドレス」に、このリモート・ドメインをホストするTuxedo環境のネットワーク・アドレスとポートを入力します。たとえば、//my_TUX_machine:5678。

6. 「OK」をクリックします。

インポートされたサービスの作成

インポートされたサービスを構成するには:

1. 管理コンソールで、「相互運用性」を展開して「WTCサーバー」を選択します。

2. 「WTCサーバー」ページで、WTCサービス名をクリックします。

3. 「インポート済み」タブをクリックします。

4. 「WTCインポート・サービス」ページで、次のフィールドに次の値を入力します:

- 「リソース名」に、//simpappと入力します。

- 「ローカル・アクセス・ポイント」に、My_Local_WLS_Domと入力します。

- 「リモート・アクセス・ポイント・リスト」に、My_WLEC_Domと入力します。

- 「リモート 名」に、//domain_idを入力します。domain_idは、Tuxedo UBBCONFIGファイルで指定されたDOMAINIDです。このCORBAドメインの一意の識別子の最大長は、//を含めて15文字です。たとえば、//simpappff。

5. 「OK」をクリックします。

simpappサンプルの実行

simpappサンプルを実行するには、次の手順を実行します。

1. 新しいシェルを開いて、作業用のTuxedo CORBA simpappサンプルに移動します。

2. 環境変数を設定します。

- Windows NTおよび2000システムの場合、次のコマンドを実行します。

results\setenv.cmd

- UNIXシステムの場合、次のコマンドを実行します。

results\setenv.sh

3. Tuxedoドメインを起動します。

tmboot -y

4. 新しいシェルを開いて、WebLogic Server WLEC simpappサンプルに移動します。

5. 環境変数を設定します。以下のパラメータを更新します。

注意:

Windows NTまたは2000システムでは、setExamplesEnv.cmd scriptを変更して実行します。UNIXシステムの場合、WLEC simpappディレクトリに./config/examples/setExamplesEnv.sh scriptをコピーしてから、setExamplesEnv.shスクリプトを変更して実行します。

6. simple.idlファイルをTuxedo CORBA simpappサンプルからWebLogic Server WLEC simpappサンプルにコピーします。

7. 以下のコマンドを使用して、wlec_simpapp_corba.jarファイルをビルドします。

ant

8. WLSコンソールを使用してMy_WLEC_Appをサーバーに割り当てます。

9. 以下のコマンドを入力して、クライアントを実行します。

ant run

Javaアプリケーションは次のような出力を生成します。

Beginning simpapp.Client...
Start of Conversion for: It Works
Converting to lower case: It Works
...Converted: it works
Converting to upper case: It Works
...Converted: IT WORKS
Removing Converter
End simpapp.Client...

サンプルの実行中に問題が発生する場合は、WTCのトレース機能を使用します。『Oracle WebLogic Server Tuxedo Connector管理ガイド』のWebLogic Tuxedo Connectorのトラブルシューティングに関する項を参照してください。

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