Oracle® Fusion Middleware Oracle WebLogic Server Tuxedo Connector管理ガイド 11gリリース1 (10.3.6) B55553-04 |
|
前 |
次 |
この章では、Oracle WebLogic Tuxedo Connectorの構成方法について説明します。
この節では、Oracle WebLogic Tuxedo Connectorを使用する前に、Oracle TuxedoおよびOracle WebLogic Server環境に行う必要のある変更の概要を示します。
Tuxedoユーザーは、次のような環境の変更を行う必要があります。
既存のTuxedoアプリケーションがすでにTuxedo /T DOMAINS
を使用している場合、Oracle WebLogic Tuxedo Connectorインスタンス化への接続ごとに、ドメイン構成ファイルへ新しいドメインを追加する必要があります。
既存のTuxedoアプリケーションがドメインを使用していない場合、アプリケーションのTUXCONFIG
にドメイン・サーバーを追加する必要があります。Oracle WebLogic Tuxedo Connectorインスタンス化に対応するTuxedo /T Domainエントリを使用して、新しいDMCONFIG
を作成する必要があります。
Oracle WebLogic Tuxedo Connectorは、Oracle Tuxedoドメインで常にエンコーディングが有効になっていることを要求します。DMCONFIG
ファイルのDM_LOCAL_DOMAINS
セクションには、MTYPE
を常に設定しないか、NULLに設定するか、またはMTYPE
とは異なる値を設定する必要があります。
Oracle Tuxedoドメインの詳細は、Tuxedo Domainsコンポーネントの使用に関する項を参照してください。
以下の節では、Oracle WebLogic Tuxedo Connectorを使用するために必要なWebLogic Serverの変更について説明します。
WebLogic Serverユーザーは、次のような環境の変更を行う必要があります。
Javaクライアントまたはサーバーを作成します。Oracle WebLogic Tuxedo Connectorクライアントまたはサーバーの作成の詳細は、『Oracle Fusion Middleware Oracle WebLogic Server Tuxedo Connectorプログラマーズ・ガイド』を参照してください。
WebLogic Serverコンソール、コマンド・ライン・インタフェース、またはWLSTを使って、Oracle WebLogic Tuxedo Connectorを構成します。Oracle WebLogic Tuxedo Connectorの構成方法の詳細は、「アプリケーション用のOracle WebLogic Tuxedo Connectorの構成」を参照してください。
Oracle WebLogic Tuxedo ConnectorのACLポリシーが「Local」
に設定されている場合、ローカル・サービスへのアクセスは、CredentialPolicy
には依存しません。Tuxedoリモート・ドメインのDOMAINID
は、ローカルなWebLogic Serverユーザーとして認証される必要があります。詳細は、「ユーザー認証」を参照してください。
ゲートウェイからサービスをディスパッチするときに利用可能なクライアント・スレッド数によって、同時に実行しているサービス数が制限される場合があります。このリリースのOracle WebLogic Tuxedo Connectorでは、利用可能なスレッドの数を増やすためのOracle WebLogic Tuxedo Connector属性はありません。サービスEJBを呼び出すときは、適切なスレッド・モデルを使用します。場合によっては、利用可能なWebLogic Serverスレッドの数を大きな値に増やす必要があります。
注意: WTCサーバーでは、3つのスレッドに加えて、定義されているローカル・アクセス・ポイントごとに1つのスレッドが使用されます。 |
この節では、WebLogic ServerアプリケーションとTuxedoアプリケーションの相互運用を可能にするためにOracle WebLogic Tuxedo Connectorを構成する方法について説明します。
注意: WTCサービスをいつ割り当てるかは非常に重要です。ランタイムMBeanのサポートが存在するため、デプロイエント後に構成を変更できます。tBridgeの例外があります。tBridgeグローバルおよびtBridgeリダイレクトの変更は、WTCをアンデプロイしてから再デプロイするまで有効になりません。 |
Oracle WebLogic Tuxedo Connectorは、MBeanを使用して、WebLogic ServerとTuxedoとの間のサービス・リクエストを処理するための接続情報とセキュリティ・プロトコルを記述します。これらの構成パラメータは、Tuxedoドメイン間の通信に必要な相互運用属性に似ています。構成パラメータは、WebLogic Serverのconfig.xml
ファイルに格納されます。表2-1に、Oracle WebLogic Tuxedo Connectorの構成に使用されるMBeanのタイプを示します。
表2-1 Oracle WebLogic Tuxedo Connectorの構成に使用されるMBeanのタイプ
MBeanのタイプ | 説明 |
---|---|
WTCServer |
WebLogic ServerとTuxedoとの間の接続に必要な相互運用属性を持つ親MBean。管理コンソールを使用して構成する場合に、WTCサービスを定義します。 |
WTCLocalTuxDom |
使用可能なリモートTuxedoドメインをWTCサービスに接続するための構成情報を提供します。最低1つのローカルTuxedoアクセス・ポイントを構成する必要があります。管理コンソールを使用して構成する場合に、ローカルTuxedoアクセス・ポイントを定義します。 注意:動的な構成のため、空のWTCサービスを作成してデプロイできます。 |
WTCRemoteTuxDom |
使用可能なTuxedoリモート・ドメインにWTCサービスを接続するための構成情報を提供します。複数のリモート・ドメインを構成してもよい。管理コンソールを使用して構成する場合に、Tuxedoリモート・アクセス・ポイントを定義します。 |
WTCExport |
ローカルTuxedoアクセス・ポイントによってエクスポートされるサービス情報を提供します。管理コンソールを使用して構成する場合に、エクスポートされるサービスを定義します。 |
WTCImport |
インポートされたサービスおよびリモート・ドメインで使用可能なサービスに関する情報を提供します。管理コンソールを使用して構成する場合に、インポートされるサービスを定義します。 |
WTCResources |
ドメインのグローバル・フィールド表クラス、ビュー表クラスおよびアプリケーション・パスワードを指定します。管理コンソールを使用して構成する場合に、リソースを定義します。 MBSTRINGのサポートは、 |
WTCPassword |
相互ドメイン認証に構成情報を指定します。管理コンソールを使用して構成する場合に、パスワードを定義します。 |
WTCtBridgeGlobal |
WebLogic ServerとTuxedoの間のメッセージ転送に関するグローバル構成情報を指定します。管理コンソールを使用して構成する場合に、Tuxedoキュー・ブリッジを定義します。 |
WTCtBridgeRedirect |
WebLogic ServerとTuxedoの間のメッセージのソース、ターゲット、方向および転送を指定します。管理コンソールを使用して構成する場合に、Tuxedoキュー・ブリッジ・リダイレクトを定義します。 |
Oracle WebLogic Server管理とconfig.xml
ファイルの詳細は、Oracle WebLogic Server MBeanリファレンスを参照してください。
管理コンソールにより、Oracle WebLogic Tuxedo Connector接続の構成、管理、モニターを行うことができます。これらのタスクに使用するタブを表示するには、次の操作を行います。
管理コンソールを起動します。
左ペインで「相互運用性」ノードを選択し、「WTCサービス」を展開します。
構成するWTCサーバーを作成または変更します。
オンライン・ヘルプの指示に従います。オンライン・ヘルプへのリンクについては、表2-2を参照してください。
表2-2では、接続タスクを一般的な実行順序で示します。この順序は変更してもかまいません。ただし、オブジェクトは関連付けおよび割当ての前に構成する必要があります。
表2-2 Oracle WebLogic Tuxedo Connector構成タスク
タスク番号 | タスク | 説明 |
---|---|---|
1 |
右ペインの「全般」タブで、「名前」および「デプロイ順序」の属性を設定します。 |
|
2 |
「全般」、「接続」、「セキュリティ」の各タブで、ローカルTuxedoアクセス・ポイントを記述する属性を設定します。最低1つのローカルTuxedoアクセス・ポイントを構成する必要があります。 注意:動的な構成のため、空のWTCサービスを作成してデプロイできます。 |
|
3 |
「リモートAP」タブで、リモートTuxedoドメインを記述する属性を設定します。 |
|
4 |
「エクスポート済み」タブで、エクスポートされたWebLogic Serverサービスを記述する属性を設定します。 |
|
5 |
「インポート済み」タブで、インポートされたTuxedoサービスを記述する属性を設定します。 |
|
6 |
「パスワード」タブで、パスワードを記述する属性を設定します。 |
|
7 |
「リソース」タブで、WebLogic Tuxedo Connectorのリソースを記述する属性を設定します。 |
|
8 |
WebLogic ServerとTuxedoの間のメッセージ転送に関するグローバル構成情報を設定します。 |
|
9 |
WebLogic ServerとTuxedoの間のメッセージのソース、ターゲット、方向、および転送の指定に使われる属性を設定します。 |
|
10 |
WTCサービスの対象サーバーを選択します。 |
コマンド・ライン・インタフェースは、Oracle WebLogic Tuxedo Connector接続を作成し管理する方法を提供します。コマンド・ライン・インタフェースの使用方法については、『Oracle Fusion Middleware Oracle WebLogic Scripting Toolガイド』を参照してください。
WL_HOME\samples\domains\examples
にあるsetExamplesEnv
スクリプトを実行して、WebLogic Serverアプリケーションの環境を設定する必要があります。
Windowsユーザーの場合は、setExamplesEnv.cmd
を実行します。
UNIXユーザーの場合は、setExamplesEnv.sh
を実行します。
環境を初めて設定する場合は、スクリプトの設定をチェックする必要があります。必要に応じて、次の手順に従ってアプリケーション環境の設定を修正します。
コマンド・ラインで、WebLogic Serverアプリケーションの場所にディレクトリを変更します。WL_HOME\samples\domains\examples
にあるsetExamplesEnv
スクリプトをアプリケーション・ディレクトリにコピーします。
vi
などのテキスト・エディタを使用して、setExamplesEnv
スクリプトを編集します。
Windowsユーザーの場合は、setExamplesEnv.cmd
を編集します。
UNIXユーザーの場合は、setExamplesEnv.sh
を編集します。
ファイルを保存します。
WebLogic Serverのプロパティを設定する必要がある場合、サーバー起動スクリプトの中のJAVA_OPTIONS
変数を更新します。例:
JAVA_OPTIONS=-Dweblogic.wtc.PasswordKey=mykey
PasswordKey
を使って、weblogic.wtc.gwt.genpasswd
ユーティリティがパスワードの暗号化に使用するキーを指定します。
JAVA_OPTIONS=-Dweblogic.wtc.PasswordKey=mykey
ここで、mykey
はキー値です。
PasswordKey
の詳細は、「パスワード構成の構成」を参照してください。
WebLogic ServerアプリケーションとTuxedoアプリケーションの間で非ASCII (マルチバイト)文字列を転送する場合、文字セットを変換できるようOracle WebLogic Tuxedo Connectorを構成する必要があります。Oracle WebLogic Tuxedo Connectorでは、Oracle WebLogic Serverのプロパティを使用して、Oracle WebLogic Tuxedo Connectorサービスで指定したすべてのTuxedoリモート・ドメインで使用されるエンコーディングを一致させます。複数のコーディング・セットを同時に実行する必要がある場合、WebLogic ServerインスタンスごとにOracle WebLogic Tuxedo Connectorサービスを実行する必要があります。
文字セット変換を有効にするには、サーバー起動スクリプトにあるJAVA_OPTIONS
変数を更新します。例:
JAVA_OPTIONS=-Dweblogic.wtc.encoding=codesetname
ここで、codesetname
は、リモートTuxedoドメインでサポートされており、使用されるコード・セットの名前です。サポートされている基本コーディング・セットおよび拡張コーディング・セットについては、『Supported Encodings』(http://download.oracle.com/javase/1.3/docs/guide/intl/encoding.doc.html
)を参照してください。
リモート・ドメインで使用されるエンコーディングと一致する正確なエンコーディング名を選択することができない場合があります。このような場合、リモート・ドメインと同等のエンコーディング名を選択する必要があります。
例:
サポートされているエンコーディングのリストにはEUC_JP
があります。
リモート・ドメインではSolarisオペレーティング・システムが動作し、eucJP
がサポートされています。
名前は完全には一致していませんが、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
が非推奨になったため、システム・デバッグを使用してください。デフォルトではすべてのデバッグ・トレースは無効になっています。デバッグ・トレースを有効にするには、以下の設定を使用します。
WTC-CORBA実行時トレースを行う場合
-Dweblogic.debug.DebugWTCCorbaEx=true
WTC-GWT実行時トレースを行う場合
-Dweblogic.debug.DebugWTCGwtEx=true
WTC-JATMI実行時トレースを行う場合
-Dweblogic.debug.DebugWTCJatmiEx=true
WTC-tBridge実行時トレースを行う場合
-Dweblogic.debug.DebugWTCtBridgeEx=true
WTC構成実行時トレースを行う場合
-Dweblogic.debug.DebugWTCConfig=true
Oracle WebLogic Tuxedo Connectorの構成を行う際には、以下のガイドラインに従ってください。
構成には複数のWTCサービスを設定できます。
2つ以上のWTCサービスを同じサーバーに割り当てることはできません。1つのサーバーは、1つのWTCサービスの対象にしかなれません。
ターゲット・サーバーが選択された後で、WTCサービスに実装された構成の変更の中には、そのターゲット・サーバー・インスタンス内では更新されないものもあります。サーバーからWTCサービスを削除した後に、更新後のWTCサービスをターゲット・サーバーに追加する必要があります。たとえば、tBridgeを変更した場合は、WTCサーバーをアンデプロイしてからデプロイして、構成の変更を有効にする必要があります。ただし、KeepAlive
、KeepAliveWait
、RetryInterval
などの一部の構成の変更は、変更をアクティブ化すると有効になります。ターゲット・サーバーの選択の詳細は、Oracle Fusion Middleware Oracle WebLogic Server管理コンソール・オンライン・ヘルプの「WTCサービスの割当て」を参照してください。