プライマリ・コンテンツに移動
Oracle® Fusion Middleware Oracle WebLogic Server 12.1.3 WebLogic Tuxedo Connectorの管理
12c (12.1.3)
E59428-03
  目次へ移動
目次
前
前 		 次
次		  

2 Oracle WebLogic Tuxedo Connectorの構成

この章では、WebLogic Server 12.1.3のOracle WebLogic Tuxedo Connectorの構成方法について説明します。

この章の内容は以下のとおりです。

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

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

Oracle Tuxedoの変更

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コンポーネントの使用に関する項を参照してください。

WebLogic Serverの変更

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

管理とプログラミング

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

  • Javaクライアントまたはサーバーを作成します。Oracle WebLogic Tuxedo Connectorクライアントまたはサーバーの作成の詳細は、『Oracle WebLogic Server Oracle WebLogic 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ユーザーとして認証される必要があります。詳細は、「ユーザー認証」を参照してください。

WebLogic Serverのスレッド

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


注意:

WTCサーバーでは、3つのスレッドに加えて、定義されているローカル・アクセス・ポイントごとに1つのスレッドが使用されます。

アプリケーション用のOracle WebLogic Tuxedo Connectorの構成

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

Oracle WebLogic Tuxedo Connector MBeanクラス

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。WebLogic Server管理コンソールを使用して構成する場合に、WTCサーバーを定義します。

 
WTCLocalTuxDom

使用可能なリモートTuxedoドメインをWTCサーバーに接続するための構成情報を提供します。最低1つのローカルTuxedoアクセス・ポイントを構成する必要があります。WebLogic Server管理コンソールを使用して構成する場合に、ローカルTuxedoアクセス・ポイントを定義します。

注意: 動的構成のため、空のWTCサーバーの作成およびデプロイが可能です。

 
WTCRemoteTuxDom

使用可能なリモートTuxedoドメインにWTCサーバーを接続するための構成情報を提供します。複数のリモート・ドメインを構成してもよい。WebLogic Server管理コンソールを使用して構成する場合に、リモートTuxedoアクセス・ポイントを定義します。

 
WTCExport

ローカルTuxedoアクセス・ポイントによってエクスポートされるサービス情報を提供します。WebLogic Server管理コンソールを使用して構成する場合に、エクスポートされるサービスを定義します。

 
WTCImport

インポートされたサービスおよびリモート・ドメインで使用可能なサービスに関する情報を提供します。WebLogic Server管理コンソールを使用して構成する場合に、インポートされるサービスを定義します。

 
WTCResources

ドメインのグローバル・フィールド表クラス、ビュー表クラスおよびアプリケーション・パスワードを指定します。WebLogic Server管理コンソールを使用して構成する場合に、リソースを定義します。

MBSTRINGのサポートは、RemoteMBEncoding属性およびMBEncodingMapFile属性を使用して提供されます。

 
WTCPassword

相互ドメイン認証に構成情報を指定します。WebLogic Server管理コンソールを使用して構成する場合に、パスワードを定義します。

 
WTCtBridgeGlobal

WebLogic ServerとTuxedoの間のメッセージ転送に関するグローバル構成情報を指定します。WebLogic Server管理コンソールを使用して構成する場合に、Tuxedoキュー・ブリッジを定義します。

 
WTCtBridgeRedirect

WebLogic ServerとTuxedoの間のメッセージのソース、ターゲット、方向および転送を指定します。WebLogic Server管理コンソールを使用して構成する場合に、Tuxedoキュー・ブリッジ・リダイレクトを定義します。

Oracle WebLogic Server管理とconfig.xmlファイルの詳細は、Oracle WebLogic Server MBeanリファレンスを参照してください。

管理コンソールを使用したOracle WebLogic Tuxedo Connectorの構成

WebLogic Server管理コンソールにより、Oracle WebLogic Tuxedo Connector接続の構成、管理、モニターを行うことができます。これらのタスクに使用するページを表示するには、次の操作を行います。

  1. WebLogic Server管理コンソールを開始します。

  2. 左ペインで「相互運用性」ノードを選択し、「WTCサーバー」を展開します。

  3. 構成するWTCサーバーを作成または変更します。

  4. Oracle WebLogic Server管理コンソール・オンライン・ヘルプの手順に従います。Oracle WebLogic Server管理コンソール・オンライン・ヘルプへのリンクは、表2-2を参照してください。

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

表2-2 Oracle WebLogic Tuxedo Connector構成タスク

タスク番号 タスク 説明

1

WTCサーバーの作成

名前属性を設定します。

2

ローカル・アクセス・ポイントの作成

「全般」、「接続」、「セキュリティ」の各ページで、ローカルTuxedoアクセス・ポイントを記述する属性を設定します。最低1つのローカルTuxedoアクセス・ポイントを構成する必要があります。

注意: 動的構成のため、空のWTCサーバーの作成およびデプロイが可能です。

3

リモート・アクセス・ポイントの作成

「リモートAP」ページで、リモートTuxedoドメインを記述する属性を設定します。

4

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

「エクスポート済み」ページで、エクスポートされたWebLogic Serverサービスを記述する属性を設定します。

5

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

「インポート済み」ページで、インポートされたTuxedoサービスを記述する属性を設定します。

6

パスワード構成の作成

「パスワード」ページで、パスワードを記述する属性を設定します。

7

リソースの作成

「リソース」ページで、WebLogic Tuxedo Connectorのリソースを記述する属性を設定します。

8

キュー・ブリッジ接続の作成

WebLogic ServerとTuxedoの間のメッセージ転送に関するグローバル構成情報を設定します。

9

Tuxedoキュー・ブリッジ・リダイレクトの作成

WebLogic ServerとTuxedoの間のメッセージのソース、ターゲット、方向、および転送の指定に使われる属性を設定します。

10

WTCサーバーのターゲット設定

WTCサーバーのターゲット・サーバー・インスタンスを選択します。

コマンド・ライン・インタフェースを使用したOracle WebLogic Tuxedo Connectorの構成

コマンド・ライン・インタフェースは、Oracle WebLogic Tuxedo Connector接続を作成し管理する方法を提供します。コマンド・ライン・インタフェースの使用方法の詳細は、『WebLogic Scripting Toolの理解』を参照してください。

WebLogic Server環境の設定

WebLogic Serverアプリケーションの環境は、ORACLE_HOME/user_projects/domains/wl_serverにあるsetExamplesEnvスクリプトを実行して設定する必要があります。ここでORACLE_HOMEは、Oracle WebLogicのインストール時にOracleホームとして指定したディレクトリです。

  • Windowsユーザーの場合は、setExamplesEnv.cmdを実行します。

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

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

  1. コマンド・ラインで、WebLogic Serverアプリケーションの場所にディレクトリを変更します。ORACLE_HOME/user_projects/domains/wl_serverにある、setExamplesEnvスクリプトをアプリケーション・ディレクトリにコピーします。

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

    • Windowsユーザーの場合は、setExamplesEnv.cmdを編集します。

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

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

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

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

JAVA_OPTIONS=-Dweblogic.wtc.PasswordKey=mykey

PasswordKeyの設定

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

JAVA_OPTIONS=-Dweblogic.wtc.PasswordKey=mykey

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

PasswordKeyの詳細は、「パスワード構成の構成」を参照してください。

encodingの設定

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://docs.oracle.com/javase/7/docs/technotes/guides/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 +++++
SDPトランスポートでのIPv4の有効化

ソケット・ダイレクト・プロトコル(SDP)を使用するには、システム・プロパティ-Djava.net.preferIPv4Stack=trueをサーバー起動スクリプトのJAVA_OPTIONS変数に設定します。

SDPを使用してTuxedoと相互運用するようにWTCを構成する方法の詳細は、Oracle Tuxedo/Oracle Exalogic環境デプロイメント・ガイド, 11gR1PS2を参照してください。

システム・レベルのデバッグ設定

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の構成ガイドライン

Oracle WebLogic Tuxedo Connectorの構成を行う際には、以下のガイドラインに従ってください。

  • 構成には、複数のWTCサーバーを設定できます。

  • 同一のサーバー・インスタンスに対しては、複数のWTCサーバーをターゲットに指定できません。1つのサーバー・インスタンスは、1つのWTCサーバーに対してのみ、ターゲットに指定できます。

  • ターゲット・サーバー・インスタンスが選択された後で、WTCサーバーに実装された構成の変更の中には、そのターゲット・サーバー・インスタンス内では更新されないものもあります。サーバー・インスタンスからWTCサーバーを削除してから、更新されたWTCサーバーをターゲット・サーバー・インスタンスに追加する必要があります。

    たとえば、tBridgeを変更した場合は、WTCサーバーをアンデプロイしてからデプロイして、構成の変更を有効にする必要があります。ただし、KeepAlive、KeepAliveWait、RetryIntervalなどの一部の構成の変更は、変更をアクティブ化すると有効になります。ターゲット・サーバーの選択の詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのWTCサーバーのターゲット設定に関する項を参照してください。

  前
前 		 次
次
  目次へ移動
目次