WebLogic Tuxedo Connector 管理ガイド
![]() |
![]() |
![]() |
![]() |
以下の節では、WebLogic Tuxedo Connector のコンフィグレーションの方法について説明します。
この節では、WebLogic Tuxedo Connector を使用する前に、Tuxedo および WebLogic Server 環境に行う必要のある変更の概要を示します。
注意 : Tuxedo ドメインの詳細については、『Tuxedo Domains コンポーネント』を参照してください。
Tuxedo ユーザは、次のような環境の変更を行う必要があります。
DM_LOCAL_DOMAINS
セクションには、MTYPE
を常に設定しないか、NULL に設定するか、または MTYPE
とは異なる値を設定する必要があります。以下の節では、WebLogic Tuxedo Connector を使用するために必要な WebLogic Server の変更について説明します。
WebLogic Server ユーザは、次のような環境の変更を行う必要があります。
Local
」に設定されている場合、ローカル サービスへのアクセスは、CredentialPolicy
には依存しません。Tuxedo リモート ドメインの DOMAINID
は、ローカルな WebLogic Server ユーザとして認証される必要があります。詳細については、「ユーザ認証」を参照してください。ゲートウェイからサービスをディスパッチするときに使用できるクライアント スレッドの数によって、同時に実行できるサービスの数が制限されることがあります。このリリースの WebLogic Tuxedo Connector では、利用可能なスレッドの数を増やすための WebLogic Tuxedo Connector 属性はありません。サービス EJB を呼び出すときは、適切なスレッド モデルを使用します。場合によっては、利用可能な WebLogic Server スレッドの数を大きな値に増やす必要があります。
注意 : WTC サーバでは、3 つのスレッドに加えて、定義されているローカル アクセス ポイントごとに 1 つのスレッドが使用されます。
注意 : WTC サービスを割り当てるタイミングが非常に重要です。実行時 MBean に対するサポートがあるため、デプロイメント後にコンフィグレーションを変更できますが、tBridge では例外があります。tBridge グローバルおよび tBridge リダイレクトの変更は、WTC をアンデプロイしてから再デプロイするまで有効になりません。
この節では、WebLogic Server アプリケーションと Tuxedo アプリケーションの相互運用を可能にするために WebLogic Tuxedo Connector をコンフィグレーションする方法について説明します。
注意 : WebLogic Server 管理と config.xml
ファイルの詳細については、『WebLogic Server MBean リファレンス』を参照してください。
WebLogic Tuxedo Connector は、MBean を使用して、WebLogic Server と Tuxedo との間のサービス リクエストを処理するための接続情報とセキュリティ プロトコルを記述します。これらのコンフィグレーション パラメータは、Tuxedo ドメイン間の通信に必要な相互運用属性に似ています。コンフィグレーション パラメータは、WebLogic Server の config.xml
ファイルに格納されます。以下の表に、WebLogic Tuxedo Connector のコンフィグレーションに使用される MBean のタイプを示します。
Administration Console により、WebLogic Tuxedo Connector 接続のコンフィグレーション、管理、モニタを行うことができます。これらのタスクに使用するタブを表示するには、次の操作を行います。
次の表では、接続タスクを一般的な実行順序で示します。この順序は変更してもかまいません。ただし、オブジェクトは関連付けおよび割り当ての前にコンフィグレーションする必要があります。
コマンドライン インタフェースは、WebLogic Tuxedo Connector 接続を作成し管理する方法を提供します。コマンドライン インタフェースの使用方法については、『WebLogic Scripting Tool ガイド』を参照してください。
WL_HOME\samples\domains\examples
にある setExamplesEnv
スクリプトを実行して、WebLogic Server アプリケーションの環境を設定する必要があります。
環境を初めて設定する場合は、スクリプトの設定をチェックする必要があります。必要に応じて、次の手順に従ってアプリケーション環境の設定を修正します。
PasswordKey
および encoding
は WebLogic Server のプロパティです。これらのプロパティの設定が必要であれば、サーバ起動スクリプトの中の JAVA_OPTIONS
変数を更新します。次に例を示します。
JAVA_OPTIONS=-Dweblogic.wtc.PasswordKey=
mykey
注意 : PasswordKey
の詳細については、「パスワード コンフィグレーションのコンフィグレーション」を参照してください。
PasswordKey
を使って、weblogic.wtc.gwt.genpasswd
ユーティリティがパスワードの暗号化に使用するキーを指定します。
JAVA_OPTIONS=-Dweblogic.wtc.PasswordKey=
mykey
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
と eucJP
はエンコーディング セットとして等価なので、WebLogic Server とリモート ドメイン間で文字列変換が正しく行われます。したがって、この場合は EUC_JP
のエンコーディング プロパティを次のように設定します。
JAVA_OPTIONS=-Dweblogic.wtc.encoding=EUC_JP
ユーザ データのダンプを有効化するには、java.weblogic.Server
コマンドに次の行を追加します。
JAVA_OPTIONS=-Dweblogic.debug.DebugWTCUData=true
ダンプを有効化すると、接続の確立後にユーザ データがダンプされます。他のデバッグ プロパティが有効化されていない場合、通常の WTC エラー メッセージと情報メッセージ以外では、このデータが唯一のダンプされる WTC 情報になります。ダンプは WLS のサーバ ログ ファイルで使用できます。
Outbound UDATA: buffer type (<type>, <subtype>)
+++++ User Data(size) +++++
......
Inbound UDATA: buffer type (<type>, <subtype>)
+++++ User Data(size) +++++
......
たとえば、WLS クライアントが STRING
型のバッファでデータ "strings" を送信し、Tuxedo TOUPPER
サービスがそれを "STRINGS" に変換する場合、WLS のサーバ ログには、次のダンプが示されます。
Outbound UDATA: buffer type (STRING, null)
+++++ User Data(16) +++++
00 00 00 07 73 74 72 69 6E 67 73 00 00 00 00 00 ....strings.....
+++++ END +++++
Outbound UDATA: buffer type (String, null)
+++++ User Data(12) +++++
00 00 00 07 53 54 52 49 4E 47 53 00 ....STRINGS.
+++++ END +++++
TraceLevel
が非推奨になったため、システム デバッグを使用してください。デフォルトではすべてのデバッグ トレースは無効になっています。デバッグ トレースを有効にするには、以下の設定を使用します。
-Dweblogic.debug.DebugWTCCorbaEx=true
-Dweblogic.debug.DebugWTCGwtEx=true
-Dweblogic.debug.DebugWTCJatmiEx=true
-Dweblogic.debug.DebugWTCtBridgeEx=true
-Dweblogic.debug.DebugWTCConfig=true
WebLogic Tuxedo Connector のコンフィグレーションを行う際には、以下のガイドラインに従ってください。
KeepAlive
、KeepAliveWait
、RetryInterval
などの一部のコンフィグレーションの変更は、変更をアクティブ化すると有効になります。対象サーバの選択の詳細については、「WTC サービスの割り当て」を参照してください。
![]() ![]() |
![]() |
![]() |