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

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

• 環境の変更と考慮事項の概要

• アプリケーション用の WebLogic Tuxedo Connector のコンフィグレーション

 

---

環境の変更と考慮事項の概要

この節では、WebLogic Tuxedo Connector を使用する前に、Tuxedo および WebLogic Server 環境に行う必要のある変更の概要を示します。

Tuxedo の変更

注意: Tuxedo ドメインの詳細については、「omains について」ページを参照してください。

Tuxedo ユーザは、次のような環境の変更を行う必要があります。

• 既存の Tuxedo アプリケーションがすでに Tuxedo /T DOMAINS を使用している場合、WebLogic Tuxedo Connector インスタンス化への接続ごとに、ドメイン コンフィグレーション ファイルへ新しいドメインを追加する必要があります。

• 既存の Tuxedo アプリケーションがドメインを使用していない場合、アプリケーションの TUXCONFIG にドメイン サーバを追加する必要があります。WebLogic Tuxedo Connector インスタンス化に対応する Tuxedo /T Domain エントリを使用して、新しい DMCONFIG を作成する必要があります。

• WebLogic Tuxedo Connector は、Tuxedo ドメインで常にエンコーディングが有効になっていることを要求します。DMCONFIG ファイルで MTYPE を設定しないか、NULL に設定する必要があります。

WebLogic Server の変更

以下の節では、WebLogic Tuxedo Connector を使用するために必要な WebLogic Server の変更について説明します。

• 管理とプログラミング

• WebLogic Server のスレッド

管理とプログラミング

WebLogic Server ユーザは、次のような環境の変更を行う必要があります。

• Java クライアントまたはサーバを作成する。WebLogic Tuxedo Connector クライアントまたはサーバの作成の詳細については、『WebLogic Tuxedo Connector プログラマーズ ガイド』を参照してください。

• WebLogic Server コンソールまたはコマンドライン インタフェースを使って、WebLogic Tuxedo Connector をコンフィグレーションします。WebLogic Tuxedo Connector のコンフィグレーション方法の詳細については、アプリケーション用の WebLogic Tuxedo Connector のコンフィグレーションを参照してください。

• [Local WLS Domain] の [ACL ポリシー] が「Local」に設定されている場合、Tuxedo リモート ドメイン DOMAINID はローカル ユーザとして、認証されなければなりません。 詳細については、ユーザ認証を参照してください。

WebLogic Server のスレッド

注意: WebLogic Server のパフォーマンスおよびチューニングの詳細については、『BEA WebLogic Server パフォーマンス チューニング ガイド』を参照してください。

ゲートウェイからサービスをディスパッチするときに使用できるクライアント スレッドの数によって、同時に実行できるサービスの数が制限されることがあります。このリリースの WebLogic Tuxedo Connector では、利用可能なスレッドの数を増やすための WebLogic Tuxedo Connector 属性はありません。サービス EJB を呼び出すときは、適切なスレッド モデルを使用します。場合によっては、利用可能な WebLogic Server スレッドの数を大きな値に増やす必要があります。

 

---

アプリケーション用の WebLogic Tuxedo Connector のコンフィグレーション

注意: このリリースの WebLogic Tuxedo Connector では、静的なコンフィグレーションのみを提供します。WebLogic Tuxedo Connector のコンフィグレーションに使われたパラメータを変更しなければならない場合は、WebLogic Server を再起動してその変更を有効にする必要があります。たとえば、ドメイン ネットワーク リンクの追加や削除、ネットワーク アドレスの変更、および新しいサービスのインポートやエクスポートは実行できません。

この節では、WebLogic Server アプリケーションと Tuxedo アプリケーションの相互運用を可能にするために WebLogic Tuxedo Connector をコンフィグレーションする方法について説明します。

• WebLogic Tuxedo Connector MBean クラス

• Administration Console を使用したWebLogic Tuxedo Connector のコンフィグレーション

• コマンドライン インタフェースを使った WebLogic Tuxedo Connector のコンフィグレーション

• WebLogic Server 環境の設定

• WebLogic Tuxedo Connector プロパティの設定方法

• WebLogic Tuxedo Connector のコンフィグレーション ガイドライン

WebLogic Tuxedo Connector MBean クラス

注意: MBean パラメータの詳細については、WebLogic Tuxedo Connector MBean 属性を参照してください。

WebLogic Tuxedo Connector は、MBean を使用して、WebLogic Server と Tuxedo との間のサービス リクエストを処理するための接続情報とセキュリティ プロトコルを記述します。これらのコンフィグレーション パラメータは、Tuxedo ドメイン間の通信に必要な相互運用属性に似ています。コンフィグレーション パラメータは、WebLogic Server の config.xml ファイルに格納されます。以下の表に、WebLogic Tuxedo Connector のコンフィグレーションに使用される MBean のタイプを示します。

MBean のタイプ	説明
WTCServerMBean	WebLogic Server と Tuxedo との間の接続に必要な相互運用属性を持つ親 MBean。
WTCLocalTuxDomMBean	他のドメインで認識されるローカル ドメインのビューを提供する。ローカル ドメインを少なくとも 1 つはコンフィグレーションする必要がある。
WTCRemoteTuxDomMBean	ローカル ドメインで認識されるリモート ドメインのビューを提供する。複数のリモート ドメインをコンフィグレーションしてもよい。
WTCExportMBean	ローカル ドメインによってエクスポートされるサービス情報を提供する。
WTCImportMbean	インポートされたサービスおよびリモート ドメインで使用可能なサービスに関する情報を提供する。
WTCResourcesMBean	ドメインのグローバル フィールド テーブル クラス、ビュー テーブル クラスおよびアプリケーション パスワードを指定する。
WTCPasswordMbean	相互ドメイン認証にコンフィグレーション情報を指定する。
WTCtBridgeGlobalMBean	WebLogic Server と Tuxedo の間のメッセージ転送に関するグローバル コンフィグレーション情報を指定する。
WTCtBridgeRedirectMBean	WebLogic Server と Tuxedo の間のメッセージのソース、ターゲット、方向および転送を指定する。

 

Administration Console を使用したWebLogic Tuxedo Connector のコンフィグレーション

Administration Console により、WebLogic Tuxedo Connector 接続のコンフィグレーション、管理、モニタを行うことができます。これらのタスクに使用するタブを表示するには、次の操作を行います。

1. Administration Console を起動します。

2. 左ペインで [サービス] ノードを選択し、[WebLogic Tuxedo Connector] ノードを展開します。

3. コンフィグレーションしたいコンポーネント固有のツリー内でノードを作成または変更します。

4. オンライン ヘルプの指示に従います。オンライン ヘルプへのリンクについては、表 2-1を参照してください。

次の表では、接続タスクを一般的な実行順序で示します。この順序は変更してもかまいません。ただし、オブジェクトは関連付けおよび割り当ての前にコンフィグレーションする必要があります。

表2-1 WebLogic Tuxedo Connector コンフィグレーション タスク

タスク番号	タスク	説明
1	WTCServer の作成	右ペインの [一般] タブで、[名前] および [デプロイ順] の属性を設定する。
2	ローカル WLS ドメインの作成	[一般]、[接続]、[セキュリティ] の各タブで、ローカル ドメインを記述する属性を設定する。ローカル ドメインを少なくとも 1 つはコンフィグレーションする必要がある。
3	リモート Tuxedo ドメイン の作成	[一般]、[接続]、[セキュリティ] の各タブで、リモート Tuxedo ドメインを記述する属性を設定する。
4	エクスポートされたサービスの作成	[一般] タブで、エクスポートされた WebLogic Server サービスを記述する属性を設定する。
5	インポートされたサービスの作成	[一般] タブで、インポートされた Tuxedo サービスを記述する属性を設定する。
6	パスワード コンフィグレーションの作成	[接続] タブで、パスワードを記述する属性を設定する。
7	リソースの作成	[接続] タブで、WebLogic Tuxedo Connector のリソースを記述する属性を設定する。
8	tBridge 接続の作成	WebLogic Server と Tuxedo との間のメッセージ転送に関するグローバル コンフィグレーション情報を指定する。
9	tBridge リダイレクションの作成	WebLogic Server と Tuxedo の間のメッセージのソース、ターゲット、方向および転送の指定に使われる属性を設定する。
10	サーバに対する WTCServer の割り当て	WTCServer MBean の対象サーバを選択する。

 

コマンドライン インタフェースを使った WebLogic Tuxedo Connector のコンフィグレーション

コマンドライン インタフェースは、 WebLogic Tuxedo Connector 接続を作成し管理する方法を提供します。コマンドライン インタフェースの使い方については、「Mbean 管理コマンド リファレンス」を参照してください。

WebLogic Server 環境の設定

WebLogic Server アプリケーションの環境は、setEnv スクリプトを実行して設定します。

- NT/2000 ユーザの場合は、setEnv.cmd を実行します。

- UNIX ユーザの場合は、setEnv.sh を実行します。

環境を初めて設定する場合は、スクリプトの設定をチェックする必要があります。必要に応じて、次の手順に従ってアプリケーション環境の設定を修正します。

1. コマンドラインで、WebLogic Server アプリケーションの場所にディレクトリを変更します。

2. vi. などのテキスト エディタを使用して、setEnv スクリプトを編集します。

   - NT/2000 ユーザの場合は、setEnv.cmd を編集します。

   - UNIX ユーザの場合は、setEnv.sh を編集します。

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

注意: setExamplesEnv ファイルは、配布キットで提供されている WebLogic Server サンプルの環境を設定するために使用します。

WebLogic Tuxedo Connector プロパティの設定方法

注意: WebLogic Server プロパティの設定に関する詳細は、「WebLogic Server の起動と停止」を参照してください。

TraceLevel、PasswordKey、および encoding は、WebLogic Server のプロパティです。これらのプロパティの設定が必要であれば、サーバ起動スクリプトの中の JAVA_OPTIONS 変数を更新します。

例 :

JAVA_OPTIONS=-Dweblogic.wtc.TraceLevel=100000

TraceLevel の設定

注意: TraceLevel の詳細については、WebLogic Tuxedo Connector のモニタを参照してください。

TraceLevel を使って、メッセージ のトレース レベルを指定し、それに従って WebLogic Tuxedo Connector がログ ファイルにトレースを送ります。

JAVA_OPTIONS= -Dweblogic.wtc.TraceLevel=tracelevel

ここで、tracelevel は、10,000 〜 100,000 の WebLogic Tuxedo Connector のトレース レベルを指定する数字です。

PasswordKey の設定

注意: PasswordKey の詳細については、WTCPassword MBean のコンフィグレーションを参照してください。

PasswordKey を使って、weblogic.wtc.gwt.genpassword ユーティリティがパスワードの暗号化に使用するキーを指定します。

JAVA_OPTIONS=-Dweblogic.wtc.PasswordKey=mykey

ここで、mykey はキー値です。

encoding の設定

WebLogic Server アプリケーションと Tuxedo アプリケーションの間で非 ASCII (マルチバイト) 文字列を転送する場合、文字セットを転送できるよう WebLogic Tuxedo Connector をコンフィグレーションする必要があります。WebLogic Tuxedo Connector では、WebLogic Server のプロパティを使用して、WebLogic Tuxedo Connector サービスで指定したすべての Tuxedo リモート ドメインで使用されるエンコーディングを一致させます。複数のコーディング セットを同時に実行する必要がある場合、WebLogic Server インスタンスごとに WebLogic Tuxedo Connector サービスを実行する必要があります。

文字セット転送を有効にするには、サーバ起動スクリプトにある JAVA_OPTIONS 変数を更新します。

例 :

JAVA_OPTIONS=-Dweblogic.wtc.encoding=codesetname

ここで、codesetname は、リモート Tuxedo ドメインでサポートされおり、使用されるコードセットです。サポートされている基本コーディング セットおよび拡張コーディング セットについては、「Supported Encodings」を参照してください。

リモート ドメインで使用されるエンコーディングと一致する正確なエンコーディング名を選択することができない場合があります。このような場合、リモート ドメインと同等のエンコーディング名を選択する必要があります。

例 :

• サポートされているエンコーディングのリストには EUC_JP がある。

• リモート ドメインでは Solaris オペレーティング システムが動作し、eucJP がサポートされている。

名前は完全には一致していませんが、EUC_JP と eucJP はエンコーディング セットとして等価なので、WebLogic Server とリモート ドメイン間で文字列転送が正しく行われます。したがって、この場合は EUC_JP のエンコーディング プロパティを次のように設定します。

JAVA_OPTIONS=-Dweblogic.wtc.encoding=EUC_JP

WebLogic Tuxedo Connector のコンフィグレーション ガイドライン

WebLogic Tuxedo Connector のコンフィグレーションを行う際には、以下のガイドラインに従ってください。

• ローカル TDOMは、コンフィグレーションのなかに少なくとも 1 つは入れなければなりません。

• config.xml ファイル内に、 1 つ以上の WTCServer MBeans を作成してもかまいません。

• 2 つ以上の WTCServer MBeans を同じサーバに対してターゲットにしてはいけません。1 つのサーバは、1 つの WTCServer MBean のターゲットにしかなれません。

• 対象サーバが選択された後で、WTCServer MBean に実装されたコンフィグレーションの変更はすべて、その対象サーバ インスタンス内では更新されません。 WTCServer MBean をサーバから削除してから、更新済みの WTCServer Mbean を対象サーバに追加する必要があります。 対象サーバの選択の詳細については、「サーバへの WTC サーバの割り当て」を参照してください。