2 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
とは異なる値を設定する必要があります。
「Tuxedoドメイン・コンポーネントの使用」を参照してください。
WebLogic Serverの変更
以下の節では、Oracle WebLogic Tuxedo Connectorを使用するために必要なWebLogic Serverの変更について説明します。
管理とプログラミング
WebLogic Serverユーザーは、次のような環境の変更を行う必要があります。
-
Javaクライアントまたはサーバーを作成します。『Oracle WebLogic Server Oracle WebLogic Tuxedo Connectorアプリケーションの開発』を参照してください。
-
WebLogic Server管理コンソール、コマンド・ライン・インタフェースまたはWLSTを使用して、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を構成する方法について説明します。
-
ノート:
WTCサーバーをいつ割り当てるかは非常に重要です。ランタイムMBeanのサポートが存在するため、デプロイエント後に構成を変更できます。tBridgeの例外があります。tBridgeグローバルおよびtBridgeリダイレクトの変更は、WTCをアンデプロイしてから再デプロイするまで有効になりません。
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のタイプ | 説明 |
---|---|
WebLogic ServerとTuxedoとの間の接続に必要な相互運用属性を持つ親MBean。WebLogic Server管理コンソールを使用して構成する場合に、WTCサーバーを定義します。 |
|
使用可能なリモートTuxedoドメインをWTCサーバーに接続するための構成情報を提供します。最低1つのローカルTuxedoアクセス・ポイントを構成する必要があります。WebLogic Server管理コンソールを使用して構成する場合に、ローカルTuxedoアクセス・ポイントを定義します。 ノート: 動的構成のため、空のWTCサーバーの作成およびデプロイが可能です。 |
|
使用可能なリモートTuxedoドメインにWTCサーバーを接続するための構成情報を提供します。複数のリモート・ドメインを構成してもよい。WebLogic Server管理コンソールを使用して構成する場合に、リモートTuxedoアクセス・ポイントを定義します。 |
|
ローカルTuxedoアクセス・ポイントによってエクスポートされるサービス情報を提供します。WebLogic Server管理コンソールを使用して構成する場合に、エクスポートされるサービスを定義します。 |
|
インポートされたサービスおよびリモート・ドメインで使用可能なサービスに関する情報を提供します。WebLogic Server管理コンソールを使用して構成する場合に、インポートされるサービスを定義します。 |
|
ドメインのグローバル・フィールド表クラス、ビュー表クラスおよびアプリケーション・パスワードを指定します。WebLogic Server管理コンソールを使用して構成する場合に、リソースを定義します。 MBSTRINGのサポートは、 |
|
相互ドメイン認証に構成情報を指定します。WebLogic Server管理コンソールを使用して構成する場合に、パスワードを定義します。 |
|
WebLogic ServerとTuxedoの間のメッセージ転送に関するグローバル構成情報を指定します。WebLogic Server管理コンソールを使用して構成する場合に、Tuxedoキュー・ブリッジを定義します。 |
|
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接続の構成、管理、モニターを行うことができます。これらのタスクに使用するページを表示するには、次の操作を行います。
-
WebLogic Server管理コンソールを開始します。
-
左ペインで「相互運用性」ノードを選択し、「WTCサーバー」を展開します。
-
構成するWTCサーバーを作成または変更します。
-
Oracle WebLogic Server管理コンソール・オンライン・ヘルプの手順に従います。Oracle WebLogic Server管理コンソール・オンライン・ヘルプへのリンクは、表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 |
リソース・ページで、Oracle WebLogic Tuxedo Connectorのリソースを記述する属性を設定します。 |
|
8 |
WebLogic ServerとTuxedoの間のメッセージ転送に関するグローバル構成情報を設定します。 |
|
9 |
WebLogic ServerとTuxedoの間のメッセージのソース、ターゲット、方向、および転送の指定に使われる属性を設定します。 |
|
10 |
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
を実行します。
環境を初めて設定する場合は、スクリプトの設定をチェックする必要があります。必要に応じて、次のステップに従ってアプリケーション環境の設定を修正します。
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
はキー値です。
「パスワード構成の構成」を参照してください。
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/8/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 +++++
システム・レベルのデバッグ設定
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サーバーのターゲット設定に関する項を参照してください。