2 WebLogic Tuxedo Connectorクイック・スタート・ガイド

この章では、Oracle WebLogic ServerとTuxedoリリース6.5以降が相互運用できるように、Oracle WebLogic Serverコンソールを使用してOracle WebLogic Tuxedo Connectorを構成する方法について説明します。

注意: Oracle WebLogic Serverのこのリリース向けにOracle WebLogic Tuxedo Connectorを構成する方法の詳細は、Oracle WebLogic Server WebLogic Tuxedo Connector管理ガイドを参照してください。

この章には次の項が含まれます:

• Oracle WebLogic Tuxedo Connectorサンプルの場所

• Oracle WebLogic Tuxedo Connectorの構成

• Oracle Tuxedoの構成

• サンプルの実行

Oracle WebLogic Tuxedo Connectorサンプルの場所

このリリースのOracle WebLogic Tuxedo Connector (WTC)のサンプルは、Oracle Technology Network Webサイトで入手できます。WebLogic Serverインストールのサンプル・ディレクトリ内にwtcディレクトリを作成します。このディレクトリにWTCのサンプルをダウンロードします。このドキュメントで参照されるサンプルを実行するには、simpappサンプルとsimpservサンプルをダウンロードする必要があります。

Oracle WebLogic Tuxedo Connectorの構成

注意: この節では、Windowsプラットフォーム上でOracle WebLogic Tuxedo Connectorを構成する方法について概説します。UNIXユーザーの場合には、「\」を「/」に、あるいは「.cmd」を「.sh」に置き換えるなど、読み替えを適切に行えば、説明はそのまま当てはまります。

このサンプルは、Oracle Tuxedoドメイン(Tドメイン)を越えて実行できるようにOracle Tuxedo simpappアプリケーションを拡張しています。このため、TOUPPERサービスのクライアントは、Oracle TuxedoサーバーでもOracle WebLogic Server examplesServerでも実行できます。このサンプルでは、以下のサービスが提供されます。

• TOUPPER :文字列を大文字に変換するOracle Tuxedoサービス。Oracle WebLogic Serverクライアントは、TOUPPER EJBを呼び出して、Oracle Tuxedo TOUPPERサービスに接続します。

• Tolower : Oracle WebLogic ServerのEJBによって実装されるサービス。TolowerサービスのクライアントはOracle Tuxedoで実行されます。

以下の各節では、管理コンソールを使ってOracle WebLogic Tuxedo Connectorを構成する方法について説明します。

• simpappサンプルのビルド

• WTCサービスの作成

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

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

• エクスポートされたサービスの作成

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

• mySimpappのexamplesServerへの割当て

• Oracle WebLogic ServerユーザーとしてのTDOM1の登録

simpappサンプルのビルド

注意: Oracle WebLogic Tuxedo Connectorを監視するためのトレースを有効にすることもできます。Oracle WebLogic Server WebLogic Tuxedo Connector管理ガイドのWebLogic Tuxedo Connectorの監視に関する項を参照してください。

次の手順に従って、simpappサンプルをビルドします。

1. Oracle WebLogic examplesServerを起動します。

2. 新しいシェル・ウィンドウを開き、SAMPLES_HOME\domains\examples\setExamplesEnv.cmdファイルを使用して環境変数を設定します。

3. simpappサンプルをダウンロードした場所にディレクトリを変更します。例: SAMPLES_HOME\server\examples\src\examples\wtc\atmi\simpappディレクトリ

4. antを使用してwtc_toupper.jarファイルをビルドします。これにより、EJBがOracle WebLogic Serverにデプロイされます。antコマンドを入力します。

5. simpservサンプルをダウンロードした場所にディレクトリを変更します。例: SAMPLES_HOME\server\examples\src\examples\wtc\atmi\simpservディレクトリ

6. wtc_tolower.jarファイルをビルドします。これにより、EJBがOracle WebLogic Serverにデプロイされます。antコマンドを入力します。

7. ブラウザでWebLogic Server管理コンソールを起動します。その際、http://your_machine:7001/consoleという形式のURLを使用します。ただし、your_machineの部分は、使用しているマシンのIPアドレスまたは名前に置き換えます。

8. ナビゲーション・ツリーで、「デプロイメント」をクリックし、wtc_tolower.jarおよびwtc_toupper.jarがデプロイされていることを確認します。

WTCサービスの作成

Oracle WebLogic Server 管理コンソールから、次の手順に従ってWTCサービスの作成および構成を行います。

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

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

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

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

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

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

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

次の手順に従って、ローカルOracle Tuxedoアクセス・ポイントを構成します。

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

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

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

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

   アクセス・ポイント: myLocalAp

   アクセス・ポイントID: TDOM2

   ネットワーク・アドレス: ローカル・アクセス・ポイントのネットワーク・アドレスとポート

   例: //123.123.123.123:5678

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

6. Tuxedo 6.5ドメインに接続する場合の手順は次のとおりです。

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

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

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

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

次の手順に従って、リモートOracle Tuxedoアクセス・ポイントを構成します。

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

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

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

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

   アクセス・ポイント: myRemoteAP

   アクセス・ポイントID: TDOM1

   ローカル・アクセス・ポイント: myLocalAp

   ネットワーク・アドレス: リモート・アクセス・ポイントのネットワーク・アドレスとポート

   例: //123.123.123.123:1234

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

エクスポートされたサービスの作成

次の手順に従って、エクスポートされたサービスを構成します。

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

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

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

4. 「WTCエクスポート・サービス」ページで、以下のフィールドに次のとおり、値を入力します。

   リソース名: TOLOWER

   ローカル・アクセス・ポイント: myLocalAp

   EJB名: tuxedo.services.TOLOWERHome

   リモート名: TOLOWER

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

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

次の手順に従って、インポートされたサービスを構成します。

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

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

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

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

   リソース名: TOUPPER

   ローカル・アクセス・ポイント: myLocalAp

   リモート・アクセス・ポイント・リスト: myRemoteAP

   リモート名: TOUPPER

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

mySimpappのexamplesServerへの割当て

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

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

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

4. examplesServerのチェック・ボックスをクリックします。

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

Oracle WebLogic ServerユーザーとしてのTDOM1の登録

次の手順に従って、TDOM1をOracle WebLogic Serverユーザーとして登録します。

1. ナビゲーション・ツリーで、「セキュリティ・レルム」をクリックします。

2. 「myRealm」をクリックします。

3. 「ユーザーとグループ」タブをクリックします。

4. 「ユーザー」をクリックします。

5. 「ロックして編集」をクリックします。

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

7. 「新しいユーザーの作成」ページで、以下の操作を行います。

   1. 「名前」フィールドにTDOM1を追加します。

   2. パスワードを入力し、確認用にもう一度入力します。

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

8. 「構成の解放」をクリックします。

Oracle Tuxedoの構成

次の手順に従って、Oracle Tuxedoドメインを構成します。

1. PATH環境変数には、Cコンパイラのパスが含まれている必要があります。set PATHを使用してそのステータスを調べ、必要ならそのパスを追加します。

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

3. 作業用Oracle Tuxedo simpappディレクトリへ移動します。

4. TUXDIRにあるsetEnv.cmdを使用して環境変数を設定します。以下のパラメータを更新します。

   TUXDIR : TUXEDOソフトウェアのベース・ディレクトリ

   APPDIR - サンプル・プログラムのベース・ディレクトリ

5. 次のコマンドで、クライアントをビルドします。

   buildclient -o simpcl -f simpcl.c 
   buildserver -o simpserv -f simpserv.c -s TOUPPER 
   

6. SAMPLES_HOME\server\examples\src\examples\wtc\atmi\simpappディレクトリにあるubbdomainおよびdom1configファイルをOracle Tuxedo simpappディレクトリにコピーします。

7. SAMPLES_HOME\server\examples\src\examples\wtc\atmi\simpservディレクトリにあるtolower.cファイルをOracle Tuxedo simpappディレクトリにコピーします。

8. Oracle Tuxedo環境に合わせてubbdomainを変更します。変更には、APPDIR、TUXCONFIG、およびTUXDIRのパス名の設定や、マシン名の設定などがあります。山カッコ(< >)で囲まれたすべての項目を、使用している環境の情報で置き換えます。

   例:

   APPDIR="\home\me\simpapp" 
   TUXCONFIG="\home\me\simpapp\tuxconfig"" 
   TUXDIR="\usr\tuxedo" 
   

9. tmloadcf -y ubbdomainと入力して、ubbdomainファイルをロードします。

10. Oracle Tuxedo環境に合わせてdom1configを変更します。ログ・デバイスの作成や、ネットワーク・アドレスの更新などがあります。

    例:

    DMTLOGDEV="d:\my_apps\tlog" 
    AUDITLOG="d:\my_apps\aud" 
    TDOM1 NWADDR="//TuxedoMachine:1234" 
    TDOM2 NWADDR="//WTCMachine:5678" 
    

11. dom1configファイルをロードします。

    set BDMCONFIG=d:\mydomain\simpapp\bdmconfig 
    dmloadcf -y dom1config 
    

12. tolowerクライアントをビルドします。

    buildclient -f tolower.c -o tolower 
    

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

    tmboot -y 
    

サンプルの実行

各クライアントを実行して、Oracle TuxedoとOracle WebLogic Serverとの相互運用性を実際に示します。

Oracle WebLogic ServerからOracle Tuxedoへの相互運用性

サンプルをダウンロードしたディレクトリの場所からOracle WebLogic Serverクライアントを起動します。たとえば、SAMPLES_HOME\server\examples\src\examples\wtc\atmi\simpappディレクトリからTOUPPER EJBを起動して、Oracle Tuxedo TOUPPERサービスに接続します。以下のコマンドを使用します。

ant simpapp 

Oracle TuxedoサービスからOracle WebLogic Serverアプリケーションに以下の応答が返されます。

Buildfile: build.xml 
simpapp: 
run_client: 
     [java] Beginning statefulSession.Client... 
     [java] Creating Toupper 
     [java] converting HelloWorld 
     [java] converted to: HELLOWORLD 
     [java] End statefulSession.Client... 
BUILD SUCCESSFUL

Oracle TuxedoからOracle WebLogic Serverへの相互運用性

Oracle Tuxedo simpappディレクトリからtolowerクライアントを実行して、Tolower EJBを呼び出し、クライアントに結果を返します。以下のコマンドを使用します。

tolower ALLSMALL

Oracle WebLogic ServerサービスからOracle Tuxedoクライアントに以下の応答が返されます。

Returned string is: allsmall