WebLogic Tuxedo Connector クイック スタート

     前  次    新しいウィンドウで目次を開く     
ここから内容の開始

WebLogic Tuxedo Connector クイック スタート

注意 : WebLogic Server のこのリリース向けに WebLogic Tuxedo Connector をコンフィグレーションする方法の詳細については、『WebLogic Tuxedo Connector 管理ガイド』を参照してください。

以下の節では、WebLogic Server と Tuxedo リリース 6.5 以降が相互運用できるように、WebLogic Server Administration Console を使用して WebLogic Tuxedo Connector をコンフィグレーションする方法について説明します。

 


WebLogic Tuxedo Connector サンプルの場所

このリリースの WebLogic Tuxedo Connector (WTC) のサンプルは、BEA dev2dev Web サイトの「CodeShare」ページで入手できます。WebLogic Server のインストール先の samples ディレクトリに wtc ディレクトリを作成し、そこに WTC のサンプルをダウンロードしてください。このドキュメントで参照されるサンプルを実行するには、WebLogic Server CodeShare から simpapp サンプルと simpserv サンプルをダウンロードする必要があります。


http://tuxedo-connector.projects.dev2dev.bea.com/

 


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

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

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

以下の各節では、Administration Console を使って WebLogic Tuxedo Connector をコンフィグレーションする方法について説明します。

simpapp サンプルのビルド

注意 : WebLogic Tuxedo Connector をモニタするためのトレースを有効にすることもできます。「WebLogic Tuxedo Connector のモニタ」を参照してください。

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

  1. 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 が WebLogic Server にデプロイされます。ant コマンドを入力します。
  5. simpserv サンプルをダウンロードした場所にディレクトリを変更します。例 : SAMPLES_HOME\server\examples\src\examples\wtc\atmi\simpserv ディレクトリ
  6. wtc_tolower.jar ファイルをビルドします。これにより、EJB が WebLogic Server にデプロイされます。ant コマンドを入力します。
  7. ブラウザで Administration Console を起動します。http://your_machine:7001/console という URL を使用します。ここで your_machine は、マシンの IP アドレスまたはマシン名で置き換えます。
  8. ナビゲーション ツリーで、[デプロイメント] をクリックし、wtc_tolower.jar および wtc_toupper.jar がデプロイされていることを確認します。

WTC サービスの作成

次の手順に従って、WebLogic Server Administration Console を使用して WTC サービスを作成しコンフィグレーションします。

  1. ナビゲーション ツリーで [相互運用性] を展開して [WTC サーバ] を選択します。
  2. [WTC サーバ] ページで、[新規作成] をクリックします。
  3. [新しい WTC サーバの作成] ページの [名前] フィールドに、WTC サービスの名前を入力します。例 : mySimpapp
  4. [完了] をクリックします。
  5. 新しい WTC サービスが WTC サーバのリストに表示されます。

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

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

次の手順に従って、ローカル Tuxedo アクセス ポイントをコンフィグレーションします。

  1. Administration Console で、[相互運用性] を展開して [WTC サーバ] を選択します。
  2. [WTC サーバ] ページで、mySimpapp などの WTC サービス名をクリックして、設定ページにアクセスします。
  3. [ローカル AP] タブをクリックします。
  4. [WTC ローカル アクセス ポイント] ページで、以下のフィールドに次のとおり、値を入力します。
  5. [アクセス ポイント] : myLocalAp

    [アクセス ポイント ID] : TDOM2

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

    例 : //123.123.123.123:5678

  6. [完了] をクリックします。
  7. Tuxedo 6.5 ドメインに接続する場合には、次の手順に従います。
    1. [接続] タブをクリックします。
    2. [相互運用] フィールドを [はい] に設定します。
    3. [保存] をクリックします。

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

次の手順に従って、リモート Tuxedo アクセス ポイントをコンフィグレーションします。

  1. Administration Console で、[相互運用性] を展開して [WTC サーバ] を選択します。
  2. [WTC サーバ] ページで、mySimpapp などの WTC サービス名をクリックします。
  3. [リモート AP] タブをクリックします。
  4. [WTC リモート アクセス ポイント] ページで、以下のフィールドに次のとおり、値を入力します。
  5. [アクセス ポイント] : myRemoteAP

    [アクセス ポイント ID] : TDOM1

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

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

    例 : //123.123.123.123:1234

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

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

次の手順に従って、エクスポートされたサービスをコンフィグレーションします。

  1. Administration Console で、[相互運用性] を展開して [WTC サーバ] を選択します。
  2. [WTC サーバ] ページで、mySimpapp などの WTC サービス名をクリックします。
  3. [エクスポート済み] タブをクリックします。
  4. [WTC エクスポート サービス] ページで、以下のフィールドに次のとおり、値を入力します。
  5. [リソース名] : TOLOWER

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

    [EJB 名] : tuxedo.services.TOLOWERHome

    [リモート名] : TOLOWER

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

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

次の手順に従って、インポートされたサービスをコンフィグレーションします。

  1. Administration Console で、[相互運用性] を展開して [WTC サーバ] を選択します。
  2. [WTC サーバ] ページで、mySimpapp などの WTC サービス名をクリックします。
  3. [インポート済み] タブをクリックします。
  4. [WTC インポート サービス] ページで、以下のフィールドに次のとおり、値を入力します。
  5. [リソース名] : TOUPPER

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

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

    [リモート名] : TOUPPER

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

mySimpapp の examplesServer への割り当て

  1. Administration Console で、[相互運用性] を展開して [WTC サーバ] を選択します。
  2. [WTC サーバ] ページで、mySimpapp などの WTC サービス名をクリックします。
  3. [対象とデプロイ] タブをクリックします。
  4. examplesServer のチェック ボックスをクリックします。
  5. [保存] をクリックします。

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

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

  1. ナビゲーション ツリーで、[セキュリティ レルム] をクリックします。
  2. [myRealm] をクリックします。
  3. [ユーザとグループ] タブをクリックします。
  4. [ユーザ] をクリックします。
  5. [ロックして編集] をクリックします。
  6. [新規作成] をクリックします。
  7. [新しいユーザの作成] ページで、以下の手順を行います。
    1. [名前] フィールドに TDOM1 を追加します。
    2. パスワードを入力し、確認用にもう一度入力します。
    3. [完了] をクリックします。
  8. [コンフィグレーションの解放] をクリックします。

 


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

次の手順に従って、Tuxedo ドメインをコンフィグレーションします。

  1. PATH 環境変数には、C コンパイラのパスが含まれている必要があります。set PATH を使用してそのことを調べ、必要ならそのパスを追加します。
  2. インストールされている Tuxedo から simpapp サンプルをコピーして、作業用 Tuxedo simpapp ディレクトリを作成します。
  3. 作業用 Tuxedo simpapp ディレクトリへ移動します。
  4. TUXDIR にある setEnv.cmd を使用して環境変数を設定します。以下のパラメータを更新します。
  5. TUXDIR - TUXEDO ソフトウェアの基本ディレクトリ
    APPDIR - サンプル プログラムの基本ディレクトリ

  6. 以下のコマンドで、クライアントをビルドします。
  7.      buildclient -o simpcl -f simpcl.c
         buildserver -o simpserv -f simpserv.c -s TOUPPER
  8. SAMPLES_HOME\server\examples\src\examples\wtc\atmi\simpapp ディレクトリにある ubbdomain および dom1config ファイルを Tuxedo simpapp ディレクトリにコピーします。
  9. SAMPLES_HOME\server\examples\src\examples\wtc\atmi\simpserv ディレクトリにある tolower.c ファイルを Tuxedo simpapp ディレクトリにコピーします。
  10. Tuxedo 環境に合わせて ubbdomain を変更します。変更には、APPDIRTUXCONFIG、および TUXDIR のパス名の設定や、マシン名の設定などがあります。山括弧 (< >) で囲まれたすべての項目を、使用している環境の情報で置き換えます。
  11. 例:

         APPDIR="\home\me\simpapp"
         TUXCONFIG="\home\me\simpapp\tuxconfig""
         TUXDIR="\usr\tuxedo"
  12. ubbdomain ファイルをロードします。tmloadcf -y ubbdomain
  13. Tuxedo 環境に合わせて dom1config を変更します。ログ デバイスの作成や、ネットワーク アドレスの更新などがあります。
  14. 例:

         DMTLOGDEV="d:\my_apps\tlog"
         AUDITLOG="d:\my_apps\aud"
         TDOM1 NWADDR="//TuxedoMachine:1234"
         TDOM2 NWADDR="//WTCMachine:5678"
  15. dom1config ファイルをロードします。
  16.      set BDMCONFIG=d:\mydomain\simpapp\bdmconfig
         dmloadcf -y dom1config
  17. tolower クライアントをビルドします。
  18.      buildclient -f tolower.c -o tolower
  19. Tuxedo ドメインを起動します。
  20.      tmboot -y

 


サンプルの実行

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

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

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

     ant simpapp

Tuxedo サービスから 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

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

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

     tolower ALLSMALL

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

     Returned string is: allsmall

  ページの先頭       前  次