Fusion Middleware Oracle WebLogic Server WebLogic Tuxedo Connectorクイック・スタート・ガイド

11g リリース1 (10.3.6)

B61644-04(原本部品番号:E13756-05)

Oracle® Fusion Middleware

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

11g リリース1 (10.3.6)

B61644-04(原本部品番号:E13756-05)

2011年11月

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

このドキュメントでは、Oracle WebLogic ServerとTuxedoリリース6.5以降が相互運用できるように、Oracle WebLogic Serverコンソールを使用してOracle 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

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

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を参照してください。

Oracle WebLogic Server Tuxedo Connectorクイック・スタート・ガイド, 11g リリース1 (10.3.6)

B61644-04

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の登録商標です。

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

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