ヘッダーをスキップ
Oracle® Fusion Middleware Oracle WebLogic Server Tuxedo Connector クイック スタート
11g リリース 1 (10.3.1)
B55564-01
 

 

Oracle® Fusion Middleware

Oracle WebLogic Server Tuxedo Connector クイック スタート

11g リリース 1 (10.3.1)

B55564-01

2009 年 5 月


注意 :

このリリースの Oracle WebLogic Server 用に Oracle WebLogic Tuxedo Connector をコンフィグレーションする方法については、『Oracle Fusion Middleware Oracle WebLogic Server Tuxedo Connector 管理ガイド』を参照してください。

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

目次

このドキュメントでは、次のトピックについて説明します。

Oracle WebLogic Tuxedo Connector サンプルの場所

このリリースの Oracle WebLogic Tuxedo Connector (WTC) のサンプルは、Oracle Technology Network Web サイトで入手できます。WebLogic Server のインストール先の samples ディレクトリに 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 でも実行できます。このサンプルでは、以下のサービスが提供されます。

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

simpapp サンプルのビルド


注意 :

Oracle WebLogic Tuxedo Connector をモニタするためのトレースを有効にすることもできます。『Oracle Fusion Middleware Oracle WebLogic Server 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 Administration Console を起動します。その際、http://your_machine:7001/console という形式の URL を使用します。ただし、your_machine の部分は、使用しているマシンの IP アドレスまたは名前に置き換えます。

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

WTC サービスの作成

Oracle WebLogic Server Administration Console から、次の手順に従って 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 Administration Console で、[相互運用性] を展開し、[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 Administration Console で、[相互運用性] を展開し、[WTC サーバ] を選択します。

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

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

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

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

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

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

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

    例 : //123.123.123.123:1234

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

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

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

  1. WebLogic Server Administration Console で、[相互運用性] を展開し、[WTC サーバ] を選択します。

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

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

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

    [リソース名] : TOLOWER

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

    [EJB 名] : tuxedo.services.TOLOWERHome

    [リモート名] : TOLOWER

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

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

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

  1. WebLogic Server Administration Console で、[相互運用性] を展開し、[WTC サーバ] を選択します。

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

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

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

    [リソース名] : TOUPPER

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

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

    [リモート名] : TOUPPER

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

mySimpapp の examplesServer への割り当て

  1. WebLogic Server Administration Console で、[相互運用性] を展開し、[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

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

オラクル社は、障害のあるお客様を含む、すべてのお客様にオラクル社の製品、サービスおよびサポート・ドキュメントをご利用いただけることを目標としています。オラクル社のドキュメントには、ユーザーが障害支援技術を使用して情報を利用できる機能が組み込まれています。HTML形式のドキュメントで用意されており、障害のあるお客様が簡単にアクセスできるようにマークアップされています。標準規格は改善されつつあります。オラクル社はドキュメントをすべてのお客様がご利用できるように、市場をリードする他の技術ベンダーと積極的に連携して技術的な問題に対応しています。オラクル社のアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト http://www.oracle.com/accessibility/を参照してください。

ドキュメント内のサンプル・コードのアクセシビリティについて

スクリーン・リーダーは、ドキュメント内のサンプル・コードを正確に読めない場合があります。コード表記規則では閉じ括弧だけを行に記述する必要があります。しかし一部のスクリーン・リーダーは括弧だけの行を読まない場合があります。

外部Webサイトのドキュメントのアクセシビリティについて

このドキュメントにはオラクル社およびその関連会社が所有または管理しないWebサイトへのリンクが含まれている場合があります。オラクル社およびその関連会社は、それらのWebサイトのアクセシビリティに関しての評価や言及は行っておりません。

聴覚に障害があるお客様のOracleサポート・サービスへのアクセス

Oracleサポート・サービスに連絡するには、テレコミュニケーション・リレー・サービス（TRS）を使用してOracleサポート（+1-800-223-1711）までお電話ください。Oracleサポート・サービスの技術者が、Oracleサービス・リクエストのプロセスに従って、技術的な問題を処理し、お客様へのサポートを提供します。TRSの詳細は、http://www.fcc.gov/cgb/consumerfacts/trs.htmlを参照してください。電話番号の一覧は、http://www.fcc.gov/cgb/dro/trsphonebk.htmlを参照してください。

サポートおよびサービス

次の各項に、各サービスに接続するためのURLを記載します。

Oracleサポート・サービス

オラクル製品サポートの購入方法、およびOracleサポート・サービスへの連絡方法の詳細は、次のURLを参照してください。

http://www.oracle.com/lang/jp/support/index.html

製品マニュアル

製品のマニュアルは、次のURLにあります。 

http://www.oracle.com/technology/global/jp/documentation/index.html

研修およびトレーニング

研修に関する情報とスケジュールは、次のURLで入手できます。 

http://education.oracle.com/pls/web_prod-plq-dad/db_pages.getpage?page_id=3

その他の情報

オラクル製品やサービスに関するその他の情報については、次のURLから参照してください。 

http://www.oracle.com/lang/jp/index.html 
http://www.oracle.com/technology/global/jp/index.html
注意:

ドキュメント内に記載されているURLや参照ドキュメントには、Oracle Corporationが提供する英語の情報も含まれています。日本語版の情報については、前述のURLを参照してください。 

Tuxedo Connector クイック スタート 11g リリース 1 (10.3.1)

B55564-01

Copyright © 2007, 2009, 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 USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアを危険が伴うアプリケーションで使用する際、このソフトウェアを安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

Oracle は Oracle Corporation およびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

このソフトウェアおよびドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。