Oracle® Fusion Middleware

Oracle WebLogic Server Tuxedo Connector管理ガイド

11gリリース1 (10.3.6)

B55553-05(原本部品番号:E13744-06)

2015年4月

Oracle WebLogic ServerとOracle Tuxedoの間で相互運用するためにOracle WebLogic Tuxedo Connectorを構成および管理する方法について説明します。

Oracle Fusion Middleware Oracle WebLogic Server Tuxedo Connector管理ガイド, 11gリリース1 (10.3.6)

B55553-05

Copyright © 2007, 2015, Oracle and/or its affiliates.All rights reserved.

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- ドキュメントのアクセシビリティについて

- 表記規則

1 Oracle WebLogic Tuxedo Connectorの概要

- ドキュメントの内容

- このドキュメントの手引き

- 関連ドキュメント

- Oracle WebLogic Tuxedo Connectorの概要

- 主要な機能と管理機能

- 確認済みの制限事項

- Oracle WebLogic Tuxedo ConnectorとJoltの相違点

- プラットフォームのサポート

- このリリースでの新機能と変更された機能

2 Oracle WebLogic Tuxedo Connectorの構成

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

- Oracle Tuxedoの変更

- WebLogic Serverの変更

- 管理とプログラミング

- WebLogic Serverのスレッド

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

- Oracle WebLogic Tuxedo Connector MBeanクラス

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

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

- WebLogic Server環境の設定

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

- PasswordKeyの設定

- encodingの設定

- ユーザー・データのダンプの設定

- SDPトランスポートに対するIPv4の有効化

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

- Oracle WebLogic Tuxedo Connectorの構成ガイドライン

3 Oracle WebLogic Tuxedo Connectorの管理

- アクセス・ポイント間の接続の構成

- 起動時に接続を要求する方法(On Startup)

- RetryIntervalの構成方法

- MaxRetriesの構成方法

- クライアント要求によって接続を要求する方法(On Demand)

- 受信時接続の受け付け(Incoming Only)

- LOCAL接続ポリシーの使用方法

- フェイルオーバーとフェイルバックの構成

- フェイルオーバーおよびフェイルバックを使用するための要件

- フェイルオーバーの構成方法

- フェイルバックの仕組み

- リンク・レベルのフェイルオーバーの構成方法

- サンプル:リンク・レベルのフェイルオーバーの構成

- TypedMBStringをサポートするための構成

- リモート・アクセス・ポイントの認証

- パスワード構成の構成

- AESで暗号化されたパスワードの使用

- 暗号化されたパスワードの生成

- 適用

- 例

- ローカル・パスワード

- リモート・パスワード

- アプリケーション・パスワード

- ユーザー認証

- ACLポリシーがLOCALの場合

- ACLポリシーがGLOBALの場合

- リモート・アクセス・ポイント資格証明ポリシーがGLOBALの場合

- リモート・アクセス・ポイント資格証明ポリシーがLOCALの場合

- Tuxedo 6.5のユーザー認証

- Oracle TuxedoとOracle WebLogic Serverの間でセキュリティを提供するようにOracle WebLogic Tuxedo Connectorを構成する方法

- TpUsrFileプラグイン

- TpUsrFileプラグイン用ローカルTuxedoアクセス・ポイントの構成

- TpUsrFileプラグイン用リモートTuxedoアクセス・ポイントの構成

- LDAPプラグイン

- シングル・ポイント・セキュリティ管理の実装

- LDAPプラグイン用ローカルTuxedoアクセス・ポイントの構成

- LDAPプラグイン用リモートTuxedoアクセス・ポイントの構成

- カスタム・プラグイン

- カスタム・プラグイン用ローカルTuxedoアクセス・ポイントの構成

- カスタム・プラグイン用リモートTuxedoアクセス・ポイントの構成

- 匿名ユーザー

- 匿名ユーザーおよびCORBAサービス

- リンク・レベルの暗号化

- セキュア・ソケット・レベルの暗号化

4 Oracle WebLogic Tuxedo Connectorの接続とサービスの制御

- 接続の動的な管理

- WebLogic Server管理コンソールの使用

- WebLogic Scripting Tool (WLST)の使用

- 接続の表示

- 接続の開始

- 接続の停止

- 構成属性の変更

- WTCサービスの中断と再開

- WebLogic Server管理コンソールの使用

- WebLogic Scripting Tool (WLST)の使用

- WTCサービスのステータス・チェック

- WTCサービスの中断

- WTCサービスの再開

- WTCサービスの動的な中断と再開

5 CORBAアプリケーションの管理

- CORBAサービス・アプリケーション用Oracle WebLogic Tuxedo Connectorの構成方法

- WTCサービスおよびTuxedo UBBファイルの例

- 着信RMI-IIOPのOracle WebLogic Tuxedo Connectorを管理および構成する方法

- 着信RMI-IIOP用のWTCサービスの構成

- Tuxedoアプリケーション環境の管理

- オブジェクト参照としてのサーバー名使用に関するガイドライン

- 送信RMI-IIOPのOracle WebLogic Tuxedo Connectorを構成する方法

- 送信RMI-IIOP構成例

6 クラスタ環境におけるOracle WebLogic Tuxedo Connectorの管理方法

- クラスタ環境におけるOracle WebLogic Tuxedo Connectorのガイドライン

- クラスタリングされたノードの場合の構成方法

- クラスタリングされたノードに対する制限

- Tuxedoドメインに対する送信リクエストの構成方法

- クラスタリングされたOracle WebLogic Tuxedo Connectorの構成例

- Tuxedoドメインからの着信リクエストの構成方法

- ロード・バランシング

- フェイルオーバー

7 Oracle Tuxedoキュー・ブリッジの構成方法

- Tuxedoキュー・ブリッジの概要

- Tuxedoキュー・ブリッジによるJMSからTuxedoへの接続

- Tuxedoキュー・ブリッジによるTuxedoからJMSへの接続

- Tuxedoキュー・ブリッジの制限

- Tuxedoキュー・ブリッジの構成

- Tuxedoキュー・ブリッジを動的に追加または変更する

- Tuxedoキュー・ブリッジのインスタンス化

- Tuxedoキュー・ブリッジの起動

- エラーのロギング

- Tuxedoキュー・ブリッジの接続性

- 接続タイプの構成の例

- JmsQ2TuxQ構成の例

- TuxQ2JmsQ構成の例

- JmsQ2TuxS構成の例

- 優先度のマッピング

- エラー・キュー

- WLSエラー宛先

- サポートされていないメッセージ・タイプ

- Tuxedoエラー・キュー

- 制限事項

8 WebLogic IntegrationとTuxedoアプリケーションの接続

- WebLogic IntegrationとTuxedoの同期接続

- ビジネス操作の定義

- eLinkアダプタの呼出し

- 例外ハンドラの定義

- WebLogic IntegrationとTuxedoの同期非ブロッキング接続

- WebLogic IntegrationとTuxedoの非同期接続

- 非同期Tuxedo /QとWebLogic Integrationの接続

- TuxedoとWebLogic Integrationの双方向非同期接続

9 WebLogic Tuxedo Connectorのトラブルシューティング

- WebLogic Tuxedo Connectorのモニター

- トレース・レベルの設定(非推奨)

- デバッグ・モードの有効化

- ユーザー・データのダンプの有効化

- よくある質問

- このEJBデプロイメント・メッセージはどういう意味ですか?

- コネクタはどのように起動するのですか?

- Tuxedoキュー・ブリッジはどのように起動するのですか?

- WTCサービスをサーバーに割り当てるにはどのようにするのですか?

- 接続の問題はどのように解決するのですか?

- 旧リリースからの移行はどのように行いますか?

はじめに

「はじめに」では、このガイド『Oracle WebLogic Server Tuxedo Connector管理ガイド』で使用されるアクセシビリティ機能および表記規則について説明します。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

サポートをご購入のOracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細情報はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoか、聴覚に障害のあるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

斜体

イタリックは、ユーザーが特定の値を指定するプレースホルダー変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 Oracle WebLogic Tuxedo Connectorの概要

この章では、このリリースのWebLogic ServerのOracle WebLogic Tuxedo Connectorの概念と機能について説明します。

- ドキュメントの内容

- Oracle WebLogic Tuxedo Connectorの概要

- 主要な機能と管理機能

- 確認済みの制限事項

- Oracle WebLogic Tuxedo ConnectorとJoltの相違点

- プラットフォームのサポート

- このリリースでの新機能と変更された機能

ドキュメントの内容

このドキュメントでは、Oracle WebLogic Tuxedo Connectorアプリケーション開発環境を紹介します。Oracle WebLogic ServerとOracle Tuxedoの間で相互運用するためにOracle WebLogic Tuxedo Connectorを構成および管理する方法について説明します。

このドキュメントの手引き

このドキュメントの構成は次のとおりです。

- 第1章「Oracle WebLogic Tuxedo Connectorの概要」では、Oracle WebLogic Tuxedo Connectorの概要について説明します。

- 第2章「Oracle WebLogic Tuxedo Connectorの構成」では、Oracle WebLogic Tuxedo Connectorの構成方法について説明します。

- 第3章「Oracle WebLogic Tuxedo Connectorの管理」では、Oracle WebLogic Tuxedo Connectorに関する構成情報を提供します。

- 第4章「Oracle WebLogic Tuxedo Connectorの接続とサービスの制御」では、Oracle WebLogic Tuxedo Connector接続の開始と停止、およびサービスの中断と再開について説明します。

- 第5章「CORBAアプリケーションの管理」では、CORBAアプリケーションの管理方法について説明します。

- 第6章「クラスタ環境におけるOracle WebLogic Tuxedo Connectorの管理方法」では、クラスタ環境でのOracle WebLogic Tuxedo Connectorの使い方について説明します。

- 第7章「Oracle Tuxedoキュー・ブリッジの構成方法」では、tBridgeの機能と構成について説明します。

- 第8章「WebLogic IntegrationとTuxedoアプリケーションの接続」では、Oracle WebLogic Tuxedo Connectorを使用してWebLogic IntegrationとTuxedoを統合する方法について説明します。

- 第9章「WebLogic Tuxedo Connectorのトラブルシューティング」では、Oracle WebLogic Tuxedo Connectorのトラブルシューティング情報を提供します。

関連ドキュメント

OracleのWebサイトでは、WebLogic ServerおよびTuxedoに関するすべてのドキュメントを提供しています。

JavaおよびJava CORBAアプリケーションの詳細は、次のサイトを参照してください。

- OMGのWebサイト(http://www.omg.org/)

- Javaサイト(http://www.oracle.com/technetwork/java/index.html)。

Oracle WebLogic Tuxedo Connectorの概要

Oracle WebLogic Tuxedo Connectorを使用すると、WebLogic ServerアプリケーションとTuxedoサービスの相互運用が実現されます。コネクタでは、WebLogic ServerクライアントがTuxedoサービスを呼び出し、Tuxedoクライアントがサービス・リクエストに応じてWebLogic Server Enterprise JavaBeans (EJB)を呼び出すことができます。

主要な機能と管理機能

Oracle WebLogic Tuxedo Connectorは、Tuxedo ATMIとほぼ同じJava Application-to-Transaction Monitor Interface (JATMI)を使用することで、WebLogic ServerとTuxedoを相互運用するアプリケーションの開発とサポートを可能にします。Oracle WebLogic Tuxedo ConnectorのtBridge機能には、高度なTuxedo /QおよびJMSメッセージ・サービスが用意されています。

Oracle WebLogic Tuxedo Connectorによって、以下のような双方向の相互運用性が実現します。

- TuxedoアプリケーションからのWebLogic Serverアプリケーションの呼び出し、およびその逆

- 既存のTuxedo環境へのWebLogic Serverアプリケーションの統合

- トランザクション・サポート

- CORBA JavaとCORBA C++サーバー・アプリケーション間の相互運用性を提供する機能

- Remote Method Invocation (RMI) over Internet Inter-ORB Protocol (IIOP)アプリケーションとTuxedo CORBAリモート・オブジェクト間の相互運用性を提供する機能

- WebLogic Integrationを使用した、Tuxedo ATMIサービス全体にわたるワークフローの管理

- WebLogic ServerとTuxedoの間の複数接続の定義

Oracle WebLogic Tuxedo Connectorの主要な管理機能を次に示します。

- 簡単な実装。Oracle WebLogic Tuxedo Connectorでは、既存のTuxedoアプリケーション・コードを修正する必要がありません。

- 既存のTuxedoクライアントは、Oracle WebLogic Tuxedo Connectorを使用してWebLogic Server EJBを呼び出します。

- 新規または修正されたWebLogic Serverクライアントは、Oracle WebLogic Tuxedo Connectorを使用してTuxedoサービスを呼び出します。

- ドメインおよびACLセキュリティを含む、双方向のセキュリティ伝播

- ドメイン・レベルのフェイルオーバーおよびフォールバック

- Tuxedo /QおよびJMSが提供する高度なメッセージング・サービス

- eLinkを使用した、メインフレームと他の従来のアプリケーションとの相互運用

確認済みの制限事項

Oracle WebLogic Tuxedo Connectorには以下の制限があります。

- ランタイムMBeanのサポートが存在するため、デプロイエント後に構成を変更できます。tBridgeの例外があります。tBridgeグローバルおよびtBridgeリダイレクトの変更は、WTCをアンデプロイしてから再デプロイするまで有効になりません。

- クラスタリングされた環境での着信TGIOPはサポートされていません。

- Oracle WebLogic Tuxedo Connectorは、OS/390プラットフォームで実行されているTuxedo 6.5ではサポートされていません。

Oracle WebLogic Tuxedo ConnectorとJoltの相違点

Oracle WebLogic Tuxedo Connectorは、Joltの代替機能ではありません。それは、次の点でJoltと異なっています:

- Oracle WebLogic Tuxedo Connectorは、Joltと似てはいるが異なるAPIを提供します。

- Joltは汎用的なJavaクライアントおよび他のWebサーバー・アプリケーションの開発が可能だが、Oracle WebLogic Tuxedo Connectorにはできません。

- Joltは、統合されたWebLogic Server-Tuxedoトランザクションのメカニズムを提供しません。

汎用的なJavaクライアントまたは他のWebサーバー・アプリケーションが必要で、WebLogic Serverがソリューションの一部ではない場合は、ソリューションとしてOracle WebLogic Tuxedo ConnectorではなくJoltを使用してください。

プラットフォームのサポート

詳しいプラットフォーム・サポートの最新情報については、Oracle Fusion Middlewareのサポートされるシステム構成のページ(http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html)を参照してください。

このリリースでの新機能と変更された機能

このリリースで導入されたWebLogic Serverの新機能の一覧については、『Oracle Fusion Middleware Oracle WebLogic Serverの新機能』を参照してください。

2 Oracle WebLogic Tuxedo Connectorの構成

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

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

- アプリケーション用の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のスレッド

管理とプログラミング

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ユーザーとして認証される必要があります。詳細は、「ユーザー認証」を参照してください。

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の構成

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

- WebLogic Server環境の設定

- 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のタイプ

説明

WTCServer

WebLogic ServerとTuxedoとの間の接続に必要な相互運用属性を持つ親MBean。管理コンソールを使用して構成する場合に、WTCサービスを定義します。

WTCLocalTuxDom

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

注意:動的な構成のため、空のWTCサービスを作成してデプロイできます。

WTCRemoteTuxDom

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

WTCExport

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

WTCImport

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

WTCResources

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

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

WTCPassword

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

WTCtBridgeGlobal

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

WTCtBridgeRedirect

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

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

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

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

1. 管理コンソールを起動します。

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

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

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

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

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

タスク番号

タスク

説明

1

WTCサービスの作成

右ペインの「全般」タブで、「名前」および「デプロイ順序」の属性を設定します。

2

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

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

注意:動的な構成のため、空のWTCサービスを作成してデプロイできます。

3

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

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

4

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

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

5

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

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

6

パスワード構成の作成

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

7

リソースの作成

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

8

キュー・ブリッジの優先度マッピングの構成

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

9

tBridgeリダイレクトの作成

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

10

WTCサービスの割当て

WTCサービスの対象サーバーを選択します。

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

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

WebLogic Server環境の設定

WL_HOME\samples\domains\examplesにあるsetExamplesEnvスクリプトを実行して、WebLogic Serverアプリケーションの環境を設定する必要があります。

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

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

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

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

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

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

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

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

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

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/1.5.0/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 +++++

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サービスを設定できます。

- 2つ以上のWTCサービスを同じサーバーに割り当てることはできません。1つのサーバーは、1つのWTCサービスの対象にしかなれません。

- 対象サーバーが選択された後で、WTCサービスに実装された構成の変更の中には、その対象サーバー・インスタンス内では更新されないものもあります。サーバーからWTCサービスを削除した後に、更新後のWTCサービスを対象サーバーに追加する必要があります。たとえば、tBridgeを変更した場合は、WTCサーバーをアンデプロイしてからデプロイして、構成の変更を有効にする必要があります。ただし、KeepAlive、KeepAliveWait、RetryIntervalなどの一部の構成の変更は、変更をアクティブ化すると有効になります。ターゲット・サーバーの選択の詳細は、Oracle Fusion Middleware Oracle WebLogic Server管理コンソール・オンライン・ヘルプの「WTCサービスの割当て」を参照してください。

3 Oracle WebLogic Tuxedo Connectorの管理

この章では、Oracle WebLogic Tuxedo Connectorを構成して接続を確立する方法、およびWebLogic ServerアプリケーションとTuxedo環境の間にセキュリティを提供する方法について説明します。Oracle WebLogic Tuxedo Connectorでは、Tuxedoアクセス・ポイント間の通信に必要な相互運用属性に類似した属性を使用します。

- アクセス・ポイント間の接続の構成

- フェイルオーバーとフェイルバックの構成

- TypedMBStringをサポートするための構成

- リモート・アクセス・ポイントの認証

- ユーザー認証

- Oracle TuxedoとOracle WebLogic Serverの間でセキュリティを提供するようにOracle WebLogic Tuxedo Connectorを構成する方法

- リンク・レベルの暗号化

- セキュア・ソケット・レベルの暗号化

Oracle WebLogic Tuxedo Connectorを含むOracle WebLogic Server管理の詳細は、Oracle WebLogic Server MBeanリファレンスを参照してください。

アクセス・ポイント間の接続の構成

アクセス・ポイントがリモート・アクセス・ポイントとの接続を確立する条件を指定できるオプションがいくつかあります。これらの条件は、WTCサービスのローカルTuxedoアクセス・ポイントおよびリモートTuxedoアクセス・ポイントの構成で「接続」タブのConnectionPolicy属性を使用して指定します。次の接続ポリシーのいずれかを選択できます。

- 起動時に接続を要求する方法(On Startup)

- クライアント要求によって接続を要求する方法(On Demand)

- 受信時接続の受け付け(Incoming Only)

- LOCAL接続ポリシーの使用方法

On StartupおよびIncoming Onlyの接続ポリシーでは、動的ステータスが呼び出されます。動的ステータスは、各リモート・アクセス・ポイントに関連してインポートされたサービスのステータスをチェックして、レポートします。

WTCローカル・アクセス・ポイントには、ON_DEMAND、INCOMING_ONLY、およびON_STARTUPの3種類の接続ポリシーがあります。デフォルトはON_DEMANDです。

WTCリモート・アクセス・ポイントには、ON_DEMAND、INCOMING_ONLY、ON_STARTUP、およびLOCALの4種類の接続ポリシーがあります。デフォルトはLOCALです。リモート・アクセス・ポイントの接続ポリシー設定にLOCALを指定すると、ローカル・アクセス・ポイントの接続ポリシーが使用されます。リモート・アクセス・ポイントの接続ポリシーは、ローカル・アクセス・ポイントの接続ポリシーよりも優先されます。

ローカル・アクセス・ポイントの接続ポリシーは、リモート・アクセス・ポイントの接続ポリシーのバックアップとして機能します。WTCの起動時に、WTCはすべてのリモート・アクセス・ポイント定義を処理し、次の表に示されているように実際の接続ポリシーを決定します。

表3-1 アクセス・ポイントの接続ポリシー設定

ローカル・アクセス・ポイント設定

リモート・アクセス・ポイント設定

実際の接続ポリシー

ON_DEMAND

ON_DEMAND

ON_DEMAND

ON_DEMAND

ON_STARTUP

ON_STARTUP

ON_DEMAND

INCOMING_ONLY

INCOMING_ONLY

ON_DEMAND

LOCAL

ON_DEMAND

ON_STARTUP

ON_DEMAND

ON_DEMAND

ON_STARTUP

ON_STARTUP

ON_STARTUP

ON_STARTUP

INCOMING_ONLY

INCOMING_ONLY

ON_STARTUP

LOCAL

ON_STARTUP

INCOMING_ONLY

ON_DEMAND

ON_DEMAND

INCOMING_ONLY

ON_STARTUP

ON_STARTUP

INCOMING_ONLY

INCOMING_ONLY

INCOMING_ONLY

INCOMING_ONLY

LOCAL

INCOMING_ONLY

次の表に、ローカル・アクセス・ポイントの接続ポリシー、リモート・アクセス・ポイントの接続ポリシー、およびリモート・ドメインにおけるこれらのパラメータの設定の明確な相互関係を示します。

表3-2 ローカルおよびリモート・アクセス・ポイントの接続ポリシーの相互関係

ローカル・システムの有効な接続ポリシー

リモート・システムの有効な接続ポリシー

リモート・ドメインにおけるパラメータの設定

ON_DEMAND

ON_DEMAND

ON_DEMAND

(いずれか一方に基づく)

ON_DEMAND

ON_STARTUP

ON_STARTUP

(両方とも動作している場合)

ON_DEMAND

INCOMING_ONLY

ON_DEMAND

(ローカルに基づく)

ON_STARTUP

ON_DEMAND

ON_STARTUP

(両方とも動作している場合)

ON_STARTUP

ON_STARTUP

ON_STARTUP

(両方とも動作している場合)

ON_STARTUP

INCOMING_ONLY

ON_STARTUP

(両方とも動作している場合)

INCOMING_ONLY

ON_DEMAND

ON_DEMAND

(リモートに基づく)

INCOMING_ONLY

ON_STARTUP

ON_STARTUP

(両方とも動作している場合)

INCOMING_ONLY

INCOMING_ONLY

手動接続(両方とも動作している場合のみ)

起動時に接続を要求する方法(On Startup)

On Startupのポリシーは、ゲートウェイ・サーバーの初期化時に、アクセス・ポイントがリモート・アクセス・ポイントを使用して接続を確立することを示します。この接続ポリシーは、RetryIntervalパラメータとMaxRetriesパラメータで指定された一定の間隔で、エラーとなった接続を再試行します。起動時に接続を要求するには、ローカルTuxedoアクセス・ポイントの「接続」タブでConnectionPolicy属性をOn Startupに設定します。

RetryIntervalの構成方法

自動接続の試行の頻度は、接続を再試行する前にアクセス・ポイントが待機する間隔(秒)を指定することによって制御できます。最小値は0、デフォルト値は60、そして最大値は2147483647です。

MaxRetriesの構成方法

MaxRetriesパラメータに値を割り当てることによって、アクセス・ポイントが終了するまでにリモート・アクセス・ポイントへの接続を試行する回数を指定します。最小値は0、デフォルトおよび最大値は2147483647です。

- MaxRetriesを0に設定すると、自動接続の再試行処理はオフになります。サーバーは、リモート・アクセス・ポイントに自動接続しません。

- MaxRetriesに数値を設定すると、アクセス・ポイントは指定された回数だけ接続を再試行してから終了します。

- MaxRetriesを2147483647に設定すると、再試行処理は無期限でまたは接続が確立するまで繰り返されます。

この設定は、ConnectionPolicyがOn Startupに設定されているときだけ使用してください。他の接続ポリシーの場合、再試行処理は無効になります。

表3-3 MaxRetriesパラメータおよびRetryIntervalパラメータの設定例

設定

処理

ConnectionPolicy: On Startup
RetryInterval: 30
MaxRetries: 3

アクセス・ポイントは、接続の確立を30秒間隔で3回試行してから終了します。

ConnectionPolicy: On Startup
MaxRetries: 0

アクセス・ポイントは初期化時に接続の確立を試行するが、最初の試行がエラーとなった場合は再試行しません。

ConnectionPolicy: On Startup
RetryInterval: 30

アクセス・ポイントは、接続が確立されるまで、30秒おきに接続の確立を試行します。

クライアント要求によって接続を要求する方法(On Demand)

On Demandの接続ポリシーは、リモート・サービスに対するクライアント・リクエスト、または管理接続開始コマンドのいずれかによって要求されたときのみに、接続が試行されることを示します。

注意:
ローカル・アクセス・ポイントのConnectionPolicyを指定しない場合、Oracle WebLogic Tuxedo ConnectorはOn DemandのConnectionPolicyを使用します。

受信時接続の受け付け(Incoming Only)

Incoming Onlyの接続ポリシーは、アクセス・ポイントが起動時にリモート・アクセス・ポイントへの接続を確立しないことを示します。アクセス・ポイントは、リモート・アクセス・ポイントからの接続リクエストの受信時に使用できます。

LOCAL接続ポリシーの使用方法

LOCALの接続ポリシーは、リモート・ドメインの接続ポリシーが明示的にローカル・ドメインのConnectionPolicy属性値にデフォルト設定されることを示します。リモート・アクセス・ポイントのConnectionPolicyが定義されていない場合、システムは関連するローカル・アクセス・ポイントで指定されている設定を使用します。

注意:
LOCALのConnectionPolicyは、ローカル・アクセス・ポイントでは無効です。

フェイルオーバーとフェイルバックの構成

Oracle WebLogic Tuxedo Connectorが提供するフェイルオーバーは、プライマリ・リモート・アクセス・ポイントでエラーが発生したとき、代替リモート・アクセス・ポイントにリクエストを転送するメカニズムです。このフェイルオーバーは、アクセス・ポイントが復元されると、プライマリ・リモート・アクセス・ポイントにフェイルバックします。このレベルのフェイルオーバーおよびフェイルバックは、接続ステータスに依存します。フェイルオーバーとフェイルバックを有効にするには、アクセス・ポイントがOn StartupまたはIncoming Onlyの接続ポリシーで構成されている必要があります。

注意:
Tuxedo T/ Domainでは、バックアップ・リモート・アクセス・ポイントは2つに制限されています。Oracle WebLogic Tuxedo Connectorには、サービスに構成できるバックアップ・アクセス・ポイントの数に制限はありません。

フェイルオーバーおよびフェイルバックを使用するための要件

フェイルオーバーまたはフェイルバックを使用するには、Connection Policyパラメータの値にON_STARTUPまたはINCOMING_ONLYを指定する必要があります。

On Demandの接続ポリシーは、リモート・アクセス・ポイントが常に使用可能であることを想定して動作するため、フェイルバックには適しません。接続ポリシーとしてON_STARTUPまたはINCOMING_ONLYを指定しないと、サーバーはTuxedoのRDOMパラメータを使用して指定した代替リモート・アクセス・ポイントにフェイルオーバーできません。

注意:
リモート・アクセス・ポイントはそれに対するネットワーク接続があれば「使用可能」であり、それに対するネットワーク接続がなければ「使用不可能」です。

フェイルオーバーの構成方法

フェイルオーバーをサポートするには、特定のサービスを実行する責任を持つリモート・アクセス・ポイントを指定する必要があります。WTCサービスで、以下の項目を指定する必要があります。

- リモート・アクセス・ポイントごとに、リモートTuxedoアクセス・ポイント構成を作成します。

- 各リモート・アクセス・ポイントが提供するサービスを指定する、インポートされたサービス構成を作成します。

TOUPPERというサービスが、TDOM1とTDOM3という2つのリモート・アクセス・ポイントから使用可能であるとします。使用するWTCサービスには2つのリモートTuxedoアクセス・ポイント構成と2つのインポートされたサービス構成が含まれています。config.xmlファイルに定義されているWTCサービスの内容は次のとおりです。

<wtc-server>
<name>WTCsimpapp</name>
<wtc-local-tux-dom>
<access-point>TDOM2</access-point>
<access-point-id>TDOM2</access-point-id>
<connection-policy>ON_DEMAND</connection-policy>
<interoperate>no</interoperate>
<nw-addr>//123.123.123.123:5678</nw-addr>
<name>myLoclTuxDom</name>
<security>NONE</security>
</wtc-local-tux-dom>
<wtc-remote-tux-dom>
<access-point>TDOM1</access-point>
<access-point-id>TDOM1</access-point-id>
<local-access-point>TDOM2</local-access-point>
<nw-addr>//123.123.123.123:1234</nw-addr>
<name>myRTuxDom</name>
</wtc-remote-tux-dom>
<wtc-remote-tux-dom>
<access-point>TDOM3</access-point>
<access-point-id>TDOM3</access-point-id>
<local-access-point>TDOM2</local-access-point>
<nw-addr>//234.234.234.234:5555</nw-addr>
<name>2ndRemoteTuxDom</name>
</wtc-remote-tux-dom>
<wtc-export>
<ejb-name>tuxedo.services.TOLOWERHome</ejb-name>
<local-access-point>TDOM2</local-access-point>
<name>myExportedResources</name>
<resource-name>TOLOWER</resource-name>
</wtc-export>
<wtc-import>
<name>imp0</name>
<resource-name>TOUPPER</resource-name>
<local-access-point>TDOM2</local-access-point>
<remote-access-point-list>TDOM1,TDOM3</remote-access-point-list>
<remote-name>TOUPPER</remote-name>
</wtc-import>
<wtc-import>
<name>imp1</name>
<resource-name>TOUPPER</resource-name>
<local-access-point>TDOM2</local-access-point>
<name>2ndImportedResources</name>
<remote-access-point-list>TDOM3,TDOM1</remote-access-point-list>
<remote-name>TOUPPER</remote-name>
</wtc-import>
</wtc-server>

フェイルバックの仕組み

フェイルバックは、プライマリ・リモート・アクセス・ポイントへのネットワーク接続が、次の理由で再確立された場合に発生します。

- 自動再試行(On Startupのみ)

- 受信時接続

リンク・レベルのフェイルオーバーの構成方法

リンク・レベルのフェイルオーバーをサポートするには、WTCRemoteTuxDomMBeanおよびWTCLocalTuxDomMBean定義で、カンマで区切られた構文<nw-addr> XMLタグで正しいフェイルオーバー・シーケンス情報を指定する必要があります。ネットワーク・アドレスの順序によって、フェイルオーバーの優先順位が決まります。

注意:
XMLタグの値は、正しい構文であるかどうかチェックされます。構文が正しくない場合、InvalidAttributeExceptionが送出されます。

リンク・レベルのフェイルオーバーのセマンティックは、レイト・バインディングです。つまり、MBean作成時に、有無や可用性はチェックされません。これは、WTC構成の作成後、かつTDomainセッション接続の作成前に、ユーザーがDNSをマシンに追加できるようにするためです。

config.xmlでの正しい構文は、次のように<nw-addr> XMLタグのカンマで区切られた構文を使用します。

<nw-addr>//host1:4001</nw-addr> --> only one host, no link-level failover
<nw-addr>//host1:4001,//host2:4001</nw-addr> --> can failover to host2 <nw-addr>//host1:4001,//host2:4001,//host3:4001</nw-addr> --> can failover from host 1 to host2, and if host2 still not available then failover to host3

サンプル:リンク・レベルのフェイルオーバーの構成

次の例では、WDOMというWTCローカル・アクセス・ポイントと、TDOMというTDomainセッションを構成します。このTDomainセッションは、DOM1というリモート・アクセス・ポイントも定義します。この場合、TDomainセッションは、WDOMとTDOMの間のセッションです。ローカル・アクセス・ポイントはまず、エンド・ポイント「//pluto:4100」をリスニングしようとします。リスニング・エンド・ポイントの作成に失敗した場合、セッションは「//saturn:4101」にリスニング・エンド・ポイントを作成しようとします。plutoからsaturnにWTCが移行した場合、リモート・アクセス・ポイントDOM1は「//saturn:4101」を使用してWDOMにアクセスできます。

リモート・アクセス・ポイントDOM1がホストmercuryからホストmarsに移行した場合、WDOMは「//mars:4001」のDOM1にアクセスできます。

リストに指定されたネットワーク・アドレスの順序によって、優先順位が決まります。WDOMでは、「//pluto:4100」がリスニング・エンド・ポイントを作成する最初の候補であり、「//saturn:4101」が2番目の候補です。リモート・アクセス・ポイントDOM1では、「//mercury:4001」がWDOMとDOM1の間の接続を作成する最初の候補であり、「//mars:4001」が2番目の候補です。

例3-1 リンク・レベルのフェイルオーバーの構成

<wtc-server>
<name>myWTCserver</name>
....
<wtc-local-tux-dom>
<name>WDOM</name>
<access-point>WDOM</access-point>
<access-point-id>WDOM</access-point-id>
<nw-addr>//pluto:4100,//saturn:4101</nw-addr>
</wtc-local-tux-dom>
<wtc-remote-tux-dom>
<name>TDOM</name>
<access-point>DOM1</access-point>
<access-point-id>DOM1</access-point-id>
<local-access-point>WDOM</local-access-point>
<nw-addr>//mercury:4001,//mars:4001</nw-addr>
</wtc-remote-tux-dom>
.....
</wtc-server>

TypedMBStringをサポートするための構成

MBSTRINGバッファをサポートするようにWTCを構成するには、WTCResources定義のRemoteMBEncoding属性に、使用するエンコーディングを指定する必要があります。この属性は省略可能であり、指定されていない場合や無効な場合は、Javaのデフォルト・エンコーディングが使用されます。

TypedMBStringは、Unicodeと外部エンコーディングの間の変換に変換関数java.lang.Stringクラスを使用します。TypedMBStringはマップ・ファイルを使用してJavaとGNUのiconv間のエンコーディング名をマップします(これは、MBSTRINGのC言語APIによって使用されます)。マップ・ファイルは、デフォルトでは$WL_HOME/server/libディレクトリにあるmbencmapというテキスト・ベースのファイルです。このマップ・ファイルでは、各「user_name java_name」のペアを含むハッシュ・マップが作成されます。このマップ・ファイルはカスタマイズできます。

エンコーディング・マップ・ファイルには、次の構文に従う1つまたは複数の行が含まれます。

<user_name> <java_name1>[,<java_name2>,[java_name3,...]]

1行に複数のjava_nameを指定することにより、複数のJavaエンコーディング名が1つのuser_nameにマップされます。user_nameは常に、その行の最初のjava_nameにマップされます。

リモート・アクセス・ポイントの認証

注意:
Tuxedo 6.5ユーザーは、InteroperateパラメータをYesに設定します。

ドメイン・ゲートウェイは、リモート・アクセス・ポイントから要求された受信時接続、およびローカル・アクセス・ポイントから要求された送信時接続を認証するように設定できます。アプリケーション管理者は、リモート・アクセス・ポイントからの受信時接続のセキュリティを強化する必要のある場合を定義できます。WTCサービスのローカルTuxedoアクセス・ポイント構成の「セキュリティ」タブでSecurity属性を設定すると、特定のローカル・アクセス・ポイントで使用するセキュリティのレベルを指定できます。パスワード・セキュリティには次のような3つのレベルがあります。

- なし - リモート・アクセス・ポイントからの受信時接続は認証されません。

- アプリケーション・パスワード - WTCサービスのリソース構成に定義されているアプリケーション・パスワードを使用して、リモート・アクセス・ポイントからの受信時接続が認証されます。暗号化されたアプリケーション・パスワードを作成するには、weblogic.wtc.gwt.genpasswdユーティリティを使用します。

- ドメイン・パスワード - 2つ以上のアクセス・ポイント間のセキュリティが強化されます。ローカルおよびリモートのアクセス・ポイント間の接続は、WTCサービスのパスワード構成に定義されているパスワードのペアを使用して、認証されます。暗号化されたローカルおよびリモートのドメイン・パスワードを作成するには、weblogic.wtc.gwt.genpasswdユーティリティを使用します。

WTCサービスのローカルTuxedoアクセス・ポイントの「セキュリティ」タブのSecurity属性は、Tuxedoドメイン構成ファイルの*DM_LOCAL_DOMAINSセクションのSECURITY属性と一致していなければなりません。

- 認証が必要な場合、ローカル・アクセス・ポイントとリモート・アクセス・ポイント間で接続が確立されるたびに認証が行われます。

- WTCサービスのローカルTuxedoアクセス・ポイントのセキュリティ・タイプが*DM_LOCAL_DOMAINSのセキュリティ・タイプと一致しない場合、またはパスワードが一致しない場合、接続は失敗します。

パスワード構成の構成

SECURITY=DM_PWの/Domainアーキテクチャでは、接続プリンシパルごとにパスワードが必要になります。2つのTDomainゲートウェイ間の各TDomainセッションには、関連付けられている独自の2つの接続プリンシパルがあります。それらはデフォルトではドメインIDで表されます。DM_PWを使用するデフォルトのセッション認証では、接続の両サイドで両方の接続プリンシパルに対して2つの秘密を構成することが必要になります。これにより、両サイドが相互に認証できます。次の例では、WTCおよびTuxedo両方の構成を示します。

- WTCは次で構成されます:

- DOMAIN ID WDOM1を持つローカル・アクセス・ポイントWDOM1

- DOMAIN ID TDOM1を持つリモート・アクセス・ポイントTDOM1

- セキュリティはDM_PW

- Tuxedoは次で構成されます:

- DOMAIN ID TDOM1を持つ独自のローカル・アクセス・ポイントTDOM1

- DOMAIN ID WDOM1を持つリモート・アクセス・ポイントWDOM1

- セキュリティはDM_PW

WTCで、TDOMAINセッション(WDOM1, TDOM1)に対するパスワードのペアを構成する必要があります。たとえば、TDOMAINセッション(WDOM1, TDOM1)に対するパスワードのペアは(pWDOM1, pTDOM1)のように表されます。Tuxedo TDOMAINで、TDOMAINセッション(TDOM1, WDOM1)に対するパスワードのペアを構成する必要があります。この場合、パスワードのペアは(pTDOM1, pWDOM1)となります。

PasswordKeyの割当て方法については、「Oracle WebLogic Tuxedo Connectorプロパティの設定方法」を参照してください。

AESで暗号化されたパスワードの使用

このリリースのWebLogic Serverでは、必要に応じて、パスワードを256ビットのAESで暗号化できます。暗号化は、weblogic.wtc.gwt.genpasswdユーティリティの-Daesフラグを設定して行います(「暗号化されたパスワードの生成」を参照)。これは、TuxedoのGWTDOMAINプロセスでGWT_SNP_MINCRYPT環境変数をAESに設定するのと同じことです。

注意:
Tuxedo 10におけるGWTDOMAINのAESサポートでは、tpusrファイルのパスワードは引続き元の暗号化方式で暗号化されます。tpusrファイルは通常、Tuxedoのネイティブ・ドメインで生成され、その後WTC (WLSドメインを経由)がアクセスできる場所にコピーされます。

暗号化されたパスワードの生成

暗号化されたパスワードの生成方法は以下のとおりです。

- weblogic.wtc.gwt.genpasswdを使用して、ローカル・パスワード、リモート・パスワード、およびアプリケーション・パスワードの属性の暗号パスワードを生成します。このユーティリティは、キーを使用してWTCサービスのパスワード構成またはリソース構成にコピーされるパスワードを暗号化します。

- WTCサービスのパスワード構成には、クリア・テキスト形式のパスワードは保存されません。

- キー値は、WebLogic Serverプロパティです。

- PasswordKey属性を使用してキーを割り当てます。

-Dweblogic.wtc.PasswordKey=mykey

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

- PasswordKey属性は、1つのキー値にのみ割り当てられます。このキー値は、指定されたWebLogic Serverで使用するため、生成されるすべてのOracle WebLogic Tuxedo Connector (ローカル、リモート、アプリケーション)パスワードに対して使用されます。

適用

引数なしでユーティリティを呼び出し、コマンド・ライン・オプションを表示します。

例:

$ java weblogic.wtc.gwt.genpasswd
Usage: genpasswd [-Daes] Key <LocalPassword|RemotePassword|AppPassword> <local|remote|application>

キー値、暗号化するパスワード、およびパスワード・タイプを指定してこのユーティリティを呼び出します。256ビットのAESでエンコードされたパスワードおよびパスワードIVを生成するには、-Daesフラグを含めます。

例:

$ java weblogic.wtc.gwt.genpasswd Key1 LocalPassword1 local

このユーティリティは、エンコードされたパスワードとパスワードIVを返します。返された結果を切り取り、WTCサービスのパスワード構成の適切なフィールドに貼り付けます。

Local Password   : my_password
Local Password IV: my_passwordIV

説明:

- my_passwordで表された文字列を切り取り、Passwordフィールドに貼り付けます。

- my_passwordIVで表された文字列を切り取り、PasswordIVフィールドに貼り付けます。

例

この節では、各パスワード要素タイプの例を紹介します。

ローカル・パスワード

次の例では、ローカル・アクセス・ポイントのパスワードとして「LocalPassword1」を暗号化するためにkey1を使用します。

$ java weblogic.wtc.gwt.genpasswd key1 LocalPassword1 local
Local Password : FMTCg5Vi1mTGFds1U4GKIQQj7s2uTlg/ldBfy6Kb+yY=
Local Password IV : NAGikshMiTE=

使用するパスワード属性は、次のとおりです。

Local Password: FMTCg5Vi1mTGFds1U4GKIQQj7s2uTlg/ldBfy6Kb+yY=
Local Password IV: NAGikshMiTE=

次の例では、ローカル・アクセス・ポイントのパスワードとして「LocalPassword1」をエンコードするためにAES暗号化を使用します。

$ java weblogic.wtc.gwt.genpasswd -Daes LocalPassword1 local
Local Password   : 71Im/Y4VcuhInuN1My5wWRjIneu+KPR0aN1WBliwIq4=
Local Password IV: a9qAjBpYExA=

使用するパスワード属性は、次のとおりです。

Local Password: 71Im/Y4VcuhInuN1My5wWRjIneu+KPR0aN1WBliwIq4=
Local Password IV: a9qAjBpYExA=

リモート・パスワード

次の例では、リモート・アクセス・ポイントのパスワードとして「RemotePassword1」を暗号化するためにmykeyを使用します。

$ java weblogic.wtc.gwt.genpasswd mykey RemotePassword1 remote
Remote Password : A/DgdJYOJunFUFJa62YmPgsHan8pC02zPT0T7EigaVg=
Remote Password IV : ohYHxzhYHP0=

使用するパスワード属性は、次のとおりです。

Remote Password: A/DgdJYOJunFUFJa62YmPgsHan8pC02zPT0T7EigaVg=
Remote Password IV: ohYHxzhYHP0=

アプリケーション・パスワード

次の例では、アプリケーション・パスワードとして「test123」を暗号化するためにmykeyを使用します。

$ java weblogic.wtc.gwt.genpasswd mykey test123 application
App Password : uou2MALQEZgNqt8abNKiC9ADN5gHDLviqO+Xt/VjakE=
App Password IV : eQuKjOaPfCw=

使用するリソース属性は、次のとおりです。

Application Password: uou2MALQEZgNqt8abNKiC9ADN5gHDLviqO+Xt/VjakE=
Application Password IV: eQuKjOaPfCw=

ユーザー認証

アクセス制御リスト(ACL)は、サービスを実行できるリモートTuxedoアクセス・ポイントを制限することによって、ローカル・アクセス・ポイントの内部にあるローカル・サービスへのアクセスを制限します。リモートTuxedoアクセス・ポイントからの着信ポリシーは、AclPolicy属性を使用して指定します。リモートTuxedoドメインへの発信ポリシーは、CredentialPolicy属性を使用して指定します。これによって、WebLogic ServerとTuxedoアプリケーションは同じセットのユーザーを共有でき、ユーザーはあるシステムから別のシステムへユーザーの資格証明を伝播できます。

AclPolicyおよびCredentialPolicyの有効な値は次のとおりです。

- LOCAL

- GLOBAL

ACLポリシーがLOCALの場合

Oracle WebLogic Tuxedo ConnectorのACLポリシーがLocalに設定されている場合、ローカル・サービスへのアクセスは、リモート・ユーザー資格証明には依存しません。Tuxedoリモート・アクセス・ポイントIDは、ローカルなWebLogic Serverユーザーとして認証されます。Oracle WebLogic Tuxedo ConnectorでDOMAINIDがローカル・ユーザーとして認証されるようにするには、WebLogic Serverコンソールを使用して、以下の手順を実行します。

1. WebLogic管理コンソールで、「セキュリティ・レルム」を選択します。

2. デフォルトのセキュリティ・レルムを選択します。

3. 「レルム」設定ページで、「ユーザーとグループ」>「ユーザー」を選択します。
「ユーザー」表が表示されます。「ユーザー」表には、認証プロバイダで定義されているすべてのユーザーの名前が表示されます。

4. 「新規作成」をクリックして、新しいユーザーを構成します。「新しいユーザーの作成」ページが表示されます。

5. 「新しいユーザーの作成」ページで、以下の手順を行います。

1. 「名前」フィールドにTuxedoのDOMAINIDを追加します。

2. パスワードを入力し、確認用にもう一度入力します。

3. 「OK」をクリックします。「ユーザー」表にユーザー名が表示されます。

ACLポリシーがGLOBALの場合

Oracle WebLogic Tuxedo ConnectorのACLポリシーがGLOBALになっている場合、ローカル・サービスへのアクセスは、リモート・ユーザー資格証明によって異なります。

リモート・アクセス・ポイント資格証明ポリシーがGLOBALの場合

CredentialPolicyがGLOBALに設定された状態でリモート・ドメインが実行されている場合、リクエストにはリモート・ユーザーの資格証明があります。そのため、ローカル・サービスにアクセスできるかどうかは、この資格証明によって異なります。

WTCのCredentialPolicyがGLOBALに設定されていると、WLSユーザーの資格証明はWTCからリモートTuxedoドメインに伝播されます。リモートTuxedoドメインでACL_POLICYがGLOBALに設定されている場合、リモートTuxedoドメインではWLSユーザーの資格証明が受け付けられ、Tuxedoサービスへのアクセスにはその資格証明が使用されます。リモートTuxedoドメインでACL_POLICYがLOCALに設定されている場合、リモートTuxedoドメインでは受信したWLSユーザーの資格証明は破棄され、TuxedoサービスへのアクセスにはWTC DOMAINIDが使用されます。

リモート・アクセス・ポイント資格証明ポリシーがLOCALの場合

WTCのCredentialPolicyがLOCALに設定されていると、WLSユーザーの資格証明はリモートTuxedoドメインに伝播されません。リモートTuxedoアクセス・ポイントは、WTCドメインから受信したサービス要求のIDを、リモートTuxedoドメインのローカル・プリンシパル名で指定されたプリンシパル名に設定します。

Tuxedo 6.5のユーザー認証

Tuxedo 6.5ユーザーは、InteroperateパラメータをYesに設定します。AclPolicy要素とCredentialPolicy要素は無視され、Tuxedoリモート・アクセス・ポイントIDは、ローカルWebLogic Serverユーザーとして認証されます。ユーザー・セキュリティ機能が必要で、かつOracle WebLogic Tuxedo Connectorを使用する場合は、Tuxedo 7.1以上にアップグレードする必要があります。

Oracle TuxedoとOracle WebLogic Serverの間でセキュリティを提供するようにOracle WebLogic Tuxedo Connectorを構成する方法

以下の節では、Tuxedoにセキュリティ情報を提供するようにWebLogic Tuxedoを構成する方法について説明します。

- TpUsrFileプラグイン

- LDAPプラグイン

- カスタム・プラグイン

- 匿名ユーザー

TpUsrFileプラグイン

TpUsrFileプラグインでは、シングル・ポイント・セキュリティ管理またはカスタム・セキュリティ認証を必要としないユーザー向けに、従来のTuxedo TpUsrFile機能が提供されます。TuxedoアプリケーションとWebLogic Serverアプリケーションの間でTpUsrFileプラグインのAppKeyジェネレータを使用してセキュリティを提供するようにOracle WebLogic Tuxedo Connectorを構成するには、次の手順に従います。

- TpUsrFileプラグイン用ローカルTuxedoアクセス・ポイントの構成

- TpUsrFileプラグイン用リモートTuxedoアクセス・ポイントの構成

TpUsrFileプラグイン用ローカルTuxedoアクセス・ポイントの構成

WTCサービスのローカルTuxedoアクセス・ポイントの「セキュリティ」タブのsecurity属性を、Tuxedoドメイン構成ファイルの*DM_LOCAL_DOMAINSセクションのSECURITYパラメータと一致するように設定します。

TpUsrFileプラグイン用リモートTuxedoアクセス・ポイントの構成

WTCサービスのリモートTuxedoアクセス・ポイントの「セキュリティ」タブを、着信および発信のアクセス制御リスト(ACL)ポリシーを確立するように構成します。

WebLogic Server環境を準備するには、次の手順を実行します。

1. AclPolicy属性をGLOBALに設定します。

2. CredentialPolicy属性をGLOBALに設定します。

3. 環境の「匿名を許可」属性を設定します。匿名ユーザーによるTuxedoへのアクセスを許可する場合は、匿名ユーザーが使用する「デフォルトAppKey」の値を設定する必要があります。匿名ユーザーの詳細は、「匿名ユーザー」を参照してください。

4. 「AppKeyジェネレータ」ドロップダウン・ボックスから「TpUsrFile」を選択します。

5. 「TPユーザー・ファイル」属性の値をユーザー・パスワード・ファイルの絶対パスに設定します。
WebLogic Server環境にTuxedo tpusrファイルのコピーが必要です。TUXEDOからWebLogic Serverアプリケーション環境にtpusrファイルをコピーするか、独自のtpusrファイルを生成します。Tuxedo tpusrファイル作成方法の詳細は、「ユーザー・レベルの認証によるセキュリティを有効にする方法」を参照してください。

リソースTpUsrFile属性の使用

TpUsrFileの場所は、リモートTuxedoアクセス・ポイント構成またはリソース構成から指定できます。TpUsrFile属性の値の割当ては、リモートTuxedoアクセス・ポイントのすべての構成で個別に行うよりも、WTCサービス・レベルでグローバルに行う方が簡単です。TpUsrFile属性の構成に最も適した場所を決定するには、次のガイドラインに従ってください。

- AppKeyジェネレータとしてTpUsrFileプラグインが選択されていないと、場所とは無関係にTpUsrFile属性の値はすべて無視されます。

- リソース構成にTpUsrFile属性の値がない場合は、リモートTuxedoアクセス・ポイントの構成にTpUsrFile属性の値を指定する必要があります。キャッシュされたユーザー・レコード情報は無視されます。

- リソースとリモートTuxedoアクセス・ポイントの両方の構成にTpUsrFile属性の値が含まれている場合は、リモートTuxedoアクセス・ポイントにある属性値が使用されます。キャッシュされたユーザー・レコード情報は無視されます。

- リモートTuxedoアクセス・ポイントの構成にTpUsrFile属性の値がない場合は、リソース構成にTpUsrFile属性の値を指定する必要があります。キャッシュされたユーザー・レコードが使用され、システムのパフォーマンスが向上します。ただし、その場合、すべてのリモートTuxedoアクセス・ポイントでユーザーが同じIDを持つように制限されます。

LDAPプラグイン

LDAPプラグインではシングル・ポイント・セキュリティ管理が提供され、WebLogic Server組込みLDAPサーバーでのユーザー・セキュリティ情報の管理、およびWebLogic Serverコンソールを使用した単一システムからのセキュリティ情報の管理が可能になります。Tuxedo 8.1以降が必要です。TuxedoアプリケーションとWebLogic Serverアプリケーションの間でLDAPプラグインのAppKeyジェネレータを使用してセキュリティを提供するようにOracle WebLogic Tuxedo Connectorを構成するには、次の手順に従います:

- シングル・ポイント・セキュリティ管理の実装

- LDAPプラグイン用ローカルTuxedoアクセス・ポイントの構成

- LDAPプラグイン用リモートTuxedoアクセス・ポイントの構成

シングル・ポイント・セキュリティ管理の実装

シングル・ポイント・セキュリティ管理の実装方法の詳細は、「シングル・ポイント・セキュリティ管理の実装」を参照してください。WebLogicセキュリティの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverセキュリティの理解』を参照してください。

LDAPプラグイン用ローカルTuxedoアクセス・ポイントの構成

WTCサービスのローカルTuxedoアクセス・ポイントの「セキュリティ」タブのsecurity属性を、Tuxedoドメイン構成ファイルの*DM_LOCAL_DOMAINSセクションのSECURITYパラメータと一致するように設定します。

LDAPプラグイン用リモートTuxedoアクセス・ポイントの構成

WTCサービスのリモートTuxedoアクセス・ポイントの「セキュリティ」タブを、着信および発信のアクセス制御リスト(ACL)ポリシーを確立するように構成します。

WebLogic Server環境を準備するには、次の手順を実行します。

1. AclPolicy属性をGLOBALに設定します。

2. CredentialPolicy属性をGLOBALに設定します。

3. 環境の「匿名を許可」属性を設定します。匿名ユーザーによるTuxedoへのアクセスを許可する場合は、匿名ユーザーが使用する「デフォルトAppKey」の値を設定する必要があります。匿名ユーザーの詳細は、「匿名ユーザー」を参照してください。

4. 「AppKeyジェネレータ」ドロップダウン・ボックスから「LDAP」を選択します。

5. 必要に応じて、「Tuxedo UIDキーワード」属性および「Tuxedo GIDキーワード」属性の値を設定します。これらの値には、デフォルト値が提供されています。TuxedoユーザーID (UID)のこれらのキーワードは、組込みLDAPデータベースのユーザー・レコードにあるTuxedo UIDおよびTuxedo GIDを抽出するために使用されます。

カスタム・プラグイン

カスタム・プラグインを使用すると、カスタマイズされたセキュリティ認証を作成できます。TuxedoアプリケーションとWebLogic Serverアプリケーションの間でカスタム・プラグインのAppKeyジェネレータを使用してセキュリティを提供するようにOracle WebLogic Tuxedo Connectorを構成するには、次の手順に従います:

- カスタム・プラグイン用ローカルTuxedoアクセス・ポイントの構成

- カスタム・プラグイン用リモートTuxedoアクセス・ポイントの構成

カスタム・プラグインの作成方法については、『Oracle Fusion Middleware Oracle WebLogic Server Tuxedo Connectorプログラマーズ・ガイド』の「カスタムAppKeyプラグインの作成方法」を参照してください。

カスタム・プラグイン用ローカルTuxedoアクセス・ポイントの構成

WTCサービスのローカルTuxedoアクセス・ポイントの「セキュリティ」タブのsecurity属性を、Tuxedoドメイン構成ファイルの*DM_LOCAL_DOMAINSセクションのSECURITYパラメータと一致するように設定します。

カスタム・プラグイン用リモートTuxedoアクセス・ポイントの構成

WTCサービスのリモートTuxedoアクセス・ポイントの「セキュリティ」タブを、着信および発信のアクセス制御リスト(ACL)ポリシーを確立するように構成します。

WebLogic Server環境を準備するには、次の手順を実行します。

1. AclPolicy属性をGLOBALに設定します。

2. CredentialPolicy属性をGLOBALに設定します。

3. 環境の「匿名を許可」属性を設定します。匿名ユーザーによるTuxedoへのアクセスを許可する場合は、匿名ユーザーが使用する「デフォルトAppKey」の値を設定する必要があります。匿名ユーザーの詳細は、「匿名ユーザー」を参照してください。

4. 「AppKeyジェネレータ」ドロップダウン・ボックスから「Custom」を選択します。

5. 「カスタムAppKeyクラス」属性の値を、カスタムAppKeyジェネレータ・クラスの絶対パスに設定します。このクラスは、WTCサービスの開始時にロードされます。

6. WTCサービスの開始時、AppKeyクラスが初期化されるときにカスタムAppKeyクラスを使用するには、「カスタムAppKeyパラメータ」属性の値を、必要なパラメータ(オプション)に設定します。

匿名ユーザー

リモートTuxedoアクセス・ポイントの「セキュリティ」タブの「匿名を許可」属性では、匿名ユーザーによるTuxedoへのアクセスを許可するかどうかを指定します。匿名ユーザーによるTuxedoへのアクセスを許可する場合、TpUsrFileとLDAPのAppKeyプラグインには「デフォルトAppKey」属性の値が使用されます。TpUsrFileプラグインとLDAPプラグインでは、「匿名を許可」属性が有効な場合以外は、ユーザー・データベースに定義されていないユーザーによるTuxedoへのアクセスが許可されません。カスタムAppKeyプラグインとの対話は、カスタムAppKeyジェネレータの設計に応じて異なります。

「デフォルトAppKey」のデフォルト値は -1です。この値を使用する場合は、このキー値に割り当てられているユーザーがTuxedo環境に存在することを確認する必要があります。「デフォルトAppKey」の値を0にしないでください。一部のシステムでは、0はユーザーをルートに指定します。

匿名ユーザーおよびCORBAサービス

ATMIサービスとCORBAサービスによる匿名ユーザーの認証方法の違いを理解しておく必要があります。ATMIサービスは、メッセージと共に送信される「デフォルトAppKey」の値を使用します。CORBAサービスは、デフォルトのWebLogic Server匿名ユーザー名である<anonymous>を使用して、Tuxedo tpusrファイルに定義されているユーザーの資格証明を識別します。CORBAを使用する場合に、認証されたユーザーになるには次のいずれかの方法を使用して匿名ユーザーを構成する必要があります。

- Tuxedo tpusrファイルに「anonymous」を追加します。

- WebLogic認証プロバイダにanonymousをユーザーとして定義します。WebLogic Serverのインスタンスを起動するときに、以下の引数を設定して定義します。

-Dweblogic.security.anonymousUserName=anonymous

リンク・レベルの暗号化

データの機密性を守るために暗号化を使用できます。これによって、ネットワーク・ベースの傍受者は、あるドメイン・ゲートウェイから別のドメイン・ゲートウェイに送信されるメッセージやアプリケーション生成メッセージの内容を知ることができなくなります。このセキュリティ・メカニズムを構成するには、WTCサービスのリモートTuxedoアクセス・ポイント構成の「セキュリティ」タブでMINENCRYPTBITS属性およびMAXENCRYPTBITS属性を設定します。

セキュア・ソケット・レベルの暗号化

このリリースのWebLogic Serverでは、信頼性のある認証局や秘密鍵の利用など、ドメイン間通信のセキュリティを実現するセキュア・ソケット・レベル(SSL)の暗号化がサポートされています。このセキュリティ・メカニズムを構成するには、WTCサービスのリモートTuxedoアクセス・ポイント構成およびローカルTuxedoアクセス・ポイント構成で、「セキュリティ」タブのMINENCRYPTBITS属性およびMAXENCRYPTBITS属性を設定し、またSSL構成およびKeyStore構成の属性を設定します。Oracle Fusion Middleware Oracle WebLogic Server管理コンソール・オンライン・ヘルプにある以下のトピックを参照してください。

- 「ローカルTuxedoアクセス・ポイント:セキュリティ」

- 「リモートTuxedoアクセス・ポイント:セキュリティ」

- このリリースのWTCでは、SSLの再ネゴシエーションはサポートされていません。WTCと通信するすべてのTUXEDOリモート・アクセス・ポイントでは、再ネゴシエーション機能を無効にする必要があります。デフォルトでは、GWTDOMAINのSSL再ネゴシエーションは無効になっています。

4 Oracle WebLogic Tuxedo Connectorの接続とサービスの制御

この章では、WebLogic ServerアプリケーションとTuxedo環境の間の接続とサービスの管理方法について説明します。Oracle WebLogic Tuxedo Connectorでは、Tuxedoアクセス・ポイント間の通信に必要な相互運用属性に類似した属性を使用します。

- 接続の動的な管理

- WTCサービスの中断と再開

接続の動的な管理

管理コンソールまたはWLSTスクリプト言語を使用して、個々の接続を動的に表示、開始、および停止できます。提供されているツールを使用してWTCサーバー接続を開始および停止する方法については、以下の節を参照してください。

- WebLogic Server管理コンソールの使用

- WebLogic Scripting Tool (WLST)の使用

WebLogic Server管理コンソールの使用

管理コンソールを使用して、Oracle WebLogic Tuxedo Connector接続を開始および停止できます。WTCサーバー接続を開始および停止する方法については、管理コンソール・ヘルプを参照してください。

WebLogic Scripting Tool (WLST)の使用

listConnectionsConfigured()属性を使用して構成された接続を表示したり、startConnection()属性を使用して個々の接続を開始したり、stopConnection()属性を使用して個々の接続を停止したりできます。個々の接続を動的に管理する方法については、『Oracle Fusion Middleware Oracle WebLogic Scripting Toolガイド』を参照してください。

接続の表示

WebLogic Scripting Tool (WLST)でlistConnectionsConfigured()属性を使用して、ドメインの接続を動的に表示できます。cmo.listConnectionsConfigured()を実行すると、DSessConnInfo構造の配列への参照が返されます。これは、次のようにローカルのWLST変数に格納するのが便利です。

wls:/mydomain/serverRuntime/WTCRuntime/WTCService> r=cmo.listConnectionsConfigured()

各DSessConnInfoインスタンスには、ローカル・アクセス・ポイントID、リモート・アクセス・ポイントID、およびステータス(ブール型、true = 接続、false = 非接続)があります。例:

wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].getLocalAccessPointId()
WLSDOM
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].getRemoteAccessPointId()
TUXDOM
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].isConnected()
0

接続の開始

WebLogic Scripting Tool (WLST)でstartConnection()属性を使用して、アクセス・ポイントの個々の接続を動的に開始できます。

1つのローカル・アクセス・ポイントと1つのリモート・アクセス・ポイントの間の接続を開始するには、引数に両方のアクセス・ポイントIDを指定します。例:

cmo.startConnection('WLSDOM','TUXDOM')

1つのローカル・アクセス・ポイントとすべての関連するリモート・アクセス・ポイントの間の接続を開始するには、引数にローカル・アクセス・ポイントIDを指定します。例:

cmo.startConnection('WLSDOM')

接続の停止

WebLogic Scripting Tool (WLST)でstopConnection()属性を使用して、アクセス・ポイントの個々の接続を動的に停止できます。

1つのローカル・アクセス・ポイントと1つのリモート・アクセス・ポイントの間の接続を停止するには、引数に両方のアクセス・ポイントIDを指定します。例:

cmo.stopConnection('WLSDOM','TUXDOM')

所定のローカル・アクセス・ポイントに関連するすべての接続を停止するには、引数にローカル・アクセス・ポイントIDを指定します。例:

cmo.stopConnection('WLSDOM')

次のコード・リストは、WLSTを使用して接続を動的に表示、開始、および停止する例です。

例4-1 接続の動的な表示、開始、および停止

java weblogic.WLST
wls:/offline> connect('weblogic','weblogic')
wls:/mydomain/serverConifg> cd('WTCServers')
wls:/mydomain/serverConfig/WTCServers> cd('myWTC')
wls:/mydomain/serverConfig/WTCServers/myWTC> cd('LocalTuxDoms')
wls:/mydomain/serverConfig/WTCServers/myWTC/LocalTuxDoms> ls()
dr--   TDOM2
wls:/mydomain/serverConfig/WTCServers/myWTC/LocalTuxDoms> cd('../../..')
wls:/mydomain/serverConfig> serverRuntime()
wls:/mydomain/serverRuntime> cd('WTCRuntime')
wls:/mydomain/serverRuntime/WTCRuntime> cd('WTCService')
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> r=cmo.listConnectionsConfigured()
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].getLocalAccessPointId()
TDOM2
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].getRemoteAccessPointId()
TDOM1
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].isConnected()
0
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> cmo.startConnection('TDOM2','TDOM1')
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> r=cmo.listConnectionsConfigured()
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].isConnected()
1
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> cmo.stopConnection('TDOM2','TDOM1')
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> r=cmo.listConnectionsConfigured()
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print r[0].isConnected()
0
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> disconnect()
wls:/offline> exit()

構成属性の変更

WebLogic Scripting Tool (WLST)を使用して、構成属性を動的に変更できます。

次のコード・リストは、setInteroperate()属性を変更する例です。

例4-2 構成属性の変更

java weblogic.WLST
wls:/offline> connect('weblogic','weblogic')
wls:/mydomain/serverConifg> edit()
wls:/mydomain/edit> startEdit()
wls:/mydomain/edit> cd("WTCServers/myWTC")
wls:/mydomain/edit/WTCServers/myWTC> cd("LocalTuxDoms")
wls:/mydomain/edit/WTCServers/myWTC/LocalTuxDoms> cd("TDOM2")
wls:/mydomain/edit/WTCServers/myWTC/LocalTuxDoms/TDOM2> cmo.setInteroperate("Yes")
wls:/mydomain/edit/WTCServers/myWTC/LocalTuxDoms/TDOM2> validate()
wls:/mydomain/edit/WTCServers/myWTC/LocalTuxDoms/TDOM2> showChanges()

Changes that are in memory and saved to disc but not yet activated are:

MBean Changed           : mydomain:Name=TDOM2,Type=WTCLocalTuxDom,WTCServer=myWTC
Operation Invoked       : modify
Attribute Modified      : Interoperate
Attributes Old Value    : No
Attributes New Value    : Yes
Server Restart Required : false

wls:/mydomain/edit/WTCServers/myWTC/LocalTuxDoms/TDOM2> save()
wls:/mydomain/edit/WTCServers/myWTC/LocalTuxDoms/TDOM2> activate(block="true")
wls:/mydomain/edit/WTCServers/myWTC/LocalTuxDoms/TDOM2> disconnect()
wls:/offline> exit()

WTCサービスの中断と再開

WebLogic Server管理コンソールまたはWLSTを使用して、特定のWTCサーバー上のサービスを中断および再開できます。WTCサーバー上でインポートされたサービスが中断されると、WTCサーバーに送信された、そのサービスに対するすべてのJATMIクライアント・リクエストは、TPException.TPENOENTを送出して即座に返されます。明示的に再開されるまで、そのサービスは使用可能になりません。

中断されているエクスポートされたサービスに割り当てられた、TuxedoクライアントからWTCへのサービス・リクエストの場合、そのサービス・リクエストは実際のサービスを呼び出すことなくTPENOENTを出して返されます。すでに受信されたサービス・リクエストや処理中のサービス・リクエストは引続き処理され、中断操作の影響を受けません。

WTCサービスを動的に中断および再開する方法については、「WTCサービスの動的な中断と再開」を参照してください。

提供されているツールを使用してWTCサービスを中断および再開する方法については、以下の節を参照してください。

- WebLogic Server管理コンソールの使用

- WebLogic Scripting Tool (WLST)の使用

WebLogic Server管理コンソールの使用

管理コンソールを使用して、Oracle WebLogic Tuxedo Connectorサービスを中断および再開できます。WTCサービスを中断および再開する方法については、管理コンソール・オンライン・ヘルプを参照してください。

WebLogic Scripting Tool (WLST)の使用

WLSTでWTCRuntimeMBeanを介して、Oracle WebLogic Tuxedo Connectorサービスを中断および再開できます。サービスのステータスをチェックすることもできます。

WTCサービスのステータス・チェック

サービスのステータスを判別するには、引数にSvcName、LDOM、またはRDomListを指定します。例:

int WTCService.getServiceStatus(String SvcName)

この場合、対象となるWTCサーバーのSvcNameという名前を持つすべてのインポートされたサービスおよびエクスポートされたサービスのステータスが返されます。'SvcName'という同じリソース名を持つインポートされたサービスまたはエクスポートされたサービスが複数ある場合、そのうち少なくとも1つのサービスが使用可能であれば、ステータスはAVAILABLEが返されます。'SvcName'という同じリソース名を持つインポートされたサービスまたはエクスポートされたサービスが複数あり、中断されているサービスと使用不能なサービスが混在している場合、ステータスはSUSPENDEDが返されます。すべてのサービスが使用不能の場合、ステータスはUNAVAILABLEが返されます。一致するサービスが見つからない場合は、TPException.TPENOENTが送出されます。

返されるステータスの有効な値を表4-1に示します。

表4-1 サービスのステータス値

ステータス値

説明

WTCServiceStatus.SUSPENDED

サービスは管理者によって中断されています。

WTCServiceStatus.AVAILABLE

サービスは中断されておらず、アクセス可能です。

WTCServiceStatus.UNAVAILABLE

サービスは中断されていないが、このサービスを提供するリモートTuxedo GWTDomainゲートウェイで使用可能な接続がないためアクセスできません。

WTCサービスの中断

WTCサーバーによって公開されているインポートされたサービスまたはエクスポートされたサービスを中断できます。管理者によって中断されているサービスは、WTCサーバーが再デプロイされるか、WLSサーバーが再起動されるか、またはサービスが管理者によって再開されるときにのみ使用可能になります。

使用可能なサービスを中断するには、引数にSvcName、LDOM、またはRDomListを指定します。例:

Void WTCRuntimeMBean.suspendService(String SvcName, boolean isImported)

この場合、指定された名前を持つすべてのインポートされたサービスまたはエクスポートされたサービスが中断されます。isImportedがtrueの場合はインポートされたサービスのみが中断され、falseの場合はエクスポートされたサービスのみが中断されます。一致するサービスが見つからない場合は、TPException.TPENOENTが送出されます。

WTCサービスの再開

WTCサーバーによって公開されている、ステータスがSUSPENDEDのインポートされたサービスまたはエクスポートされたサービスを再開できます。管理者によって中断されているサービスは、WTCサーバーが再デプロイされるか、WLSサーバーが再起動されるか、またはサービスが管理者によって再開されるときにのみ使用可能になります。

中断されているサービスを再開するには、引数にSvcName、LDOM、またはRDomListを指定します。例:

void WTCRuntimeMBean.resumeService(String SvcName)

この場合、対象となるWTCサーバーのSvcNameという名前を持つすべてのインポートされたサービスおよびエクスポートされたサービスが再開されます。一致するサービスが見つからない場合は、TPException.TPENOENTが送出されます。

WTCサービスの動的な中断と再開

WebLogic Server管理コンソールまたはWLSTを使用して、特定のWTCサーバー上のサービスを中断および再開できます。WTCサーバー上でインポートされたサービスが中断されると、WTCサーバーに送信された、そのサービスに対するすべてのJATMIクライアント・リクエストは、TPException.TPENOENTを送出して即座に返されます。明示的に再開されるまで、そのサービスは使用可能になりません。

動的なステータスはインポートされたサービスのみに適用されます。使用可能な、またはその可能性のあるTDomainセッションが少なくとも1つあれば、インポートされたサービスはAVAILABLEになります。使用可能なTDomainセッションがない場合にのみ、SUSPENDEDになります。WTCRemoteTuxDomの接続ポリシー解決がON_DEMANDの場合、TDomainセッションは存在しなくても常に使用可能です。WTCRemoteTuxDomの接続ポリシー解決がINCOMING_ONLYまたはON_STARTUPの場合、TDomainセッションは、接続が確立され、そのTDomainセッションが存在するときのみ使用可能になります。

次のコード・リストは、WLSTを使用して接続を動的に表示、開始、および停止する例です。

例4-3 サービスの動的な中断および再開

java weblogic.WLST
wls:/offline> connect('weblogic','weblogic','t3://localhost:7001')
wls:/mydomain/serverConfig> serverRuntime()
wls:/mydomain/serverRuntime> cd('WTCRuntime/WTCService')
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> ls()
-r-- Name WTCService
-r-- ServiceStatus weblogic.wtc.gwt.DServiceInfo[weblogic.wtc.gwt.DServiceInfo@1947a96]
-r-- Type WTCRuntime
-r-x getServiceStatus Integer :
String(java.lang.String),String(java.lang.String),String(java.lang.String)
-r-x getServiceStatus Integer : String(localAccessPoint),String(svcName)
-r-x getServiceStatus Integer : String(localAccessPoint),String(svcName),Boolean(isImport)
-r-x getServiceStatus Integer : String(svcName)
-r-x getServiceStatus Integer : String(svcName),Boolean(isImport)
-r-x listConnectionsConfigured weblogic.wtc.gwt.DSessConnInfo[] :
-r-x resumeService Void : String(localAccessPoint),String(remoteAccessPointList),String(svcName)
-r-x resumeService Void : String(localAccessPoint),String(svcName)
-r-x resumeService Void : String(localAccessPoint),String(svcName),Boolean(isImport)
-r-x resumeService Void : String(svcName)
-r-x resumeService Void : String(svcName),Boolean(isImport)
-r-x startConnection Void : String(LDomAccessPointId)
-r-x startConnection Void : String(LDomAccessPointId),String(RDomAccessPointId)
-r-x stopConnection Void : String(LDomAccessPointId)
-r-x stopConnection Void : String(LDomAccessPointId),String(RDomAccessPointId)
-r-x suspendService Void : String(localAccessPoint),String(remoteAccessPointList),String(svcName)
-r-x suspendService Void : String(localAccessPoint),String(svcName)
-r-x suspendService Void : String(localAccessPoint),String(svcName),Boolean(isImport)
-r-x suspendService Void : String(svcName)
-r-x suspendService Void : String(svcName),Boolean(isImport)
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> status=cmo.getServiceStatus()
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print status[0].getServiceName()
TOUPPER
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print
weblogic.wtc.gwt.WTCServiceStatus.svcTypeToString(status[0].getServiceType())
IMPORT
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print
weblogic.wtc.gwt.WTCServiceStatus.statusToString(status[0].getStatus())
AVAILABLE
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> cmo.suspendService('TOUPPER')
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> status=cmo.getServiceStatus()
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print
weblogic.wtc.gwt.WTCServiceStatus.statusToString(status[0].getStatus())
SUSPENDED
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> cmo.resumeService('TOUPPER')
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> status=cmo.getServiceStatus()
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print
weblogic.wtc.gwt.WTCServiceStatus.statusToString(status[0].getStatus())
AVAILABLE
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print status[0].getServiceName()
TOUPPER
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> cmo.suspendService('TDOM1','TOUPPER')
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> status=cmo.getServiceStatus()
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print status[0].getServiceName()
TOUPPER
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print
weblogic.wtc.gwt.WTCServiceStatus.statusToString(status[0].getStatus())
SUSPENDED
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> cmo.resumeService('TDOM1','TOUPPER')
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> status=cmo.getServiceStatus()
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print status[0].getServiceName()
TOUPPER
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> print
weblogic.wtc.gwt.WTCServiceStatus.statusToString(status[0].getStatus())
AVAILABLE
wls:/mydomain/serverRuntime/WTCRuntime/WTCService>
wls:/mydomain/serverRuntime/WTCRuntime/WTCService> disconnect()
wls:/offline> exit()

5 CORBAアプリケーションの管理

この章では、Tuxedo CORBAクライアントおよびサービスをサポートするOracle WebLogic Tuxedo Connectorの管理および構成方法について説明します。

- CORBAサービス・アプリケーション用Oracle WebLogic Tuxedo Connectorの構成方法

- 着信RMI-IIOPのOracle WebLogic Tuxedo Connectorを管理および構成する方法

- 送信RMI-IIOPのOracle WebLogic Tuxedo Connectorを構成する方法

CORBAアプリケーションの詳細は、「CORBAのトピック」を参照してください。

CORBAサービス・アプリケーション用Oracle WebLogic Tuxedo Connectorの構成方法

この節では、WebLogic Server EJBからTuxedo CORBAサーバーへの呼出しをサポートするWTCサービスの構成方法について説明します。以下の手順に従って、WTCサービスを構成します。

1. WebLogic ServerアプリケーションのローカルTuxedoアクセス・ポイントを構成します。

2. Tuxedo CORBAドメインのリモートTuxedoアクセス・ポイントを構成します。

3. インポートされたサービスを構成します。

- リソース名を「//domain_id」に設定します。「domain_id」は、オブジェクトがデプロイされるリモートTuxedoドメインのTuxedo UBBCONFIGファイルで指定されているDOMAINIDです。このCORBAドメインのユニークな識別子の最大長は、//を含めて15文字です。

- 「ローカル・アクセス・ポイント」を、リモートTuxedoアクセス・ポイントの「ローカル・アクセス・ポイント」属性の値に設定します。

- リモート・アクセス・ポイント・リストを、リモートTuxedoアクセス・ポイントの「アクセス・ポイントID」属性の値に設定します。

WebLogic Server EJBを使用してTuxedo CORBAサービスを呼び出すクライアント・アプリケーションの開発方法については、『Oracle Fusion Middleware Oracle WebLogic Server Tuxedo Connectorプログラマーズ・ガイド』を参照してください。

WTCサービスの構成方法の詳細は、「アプリケーション用のOracle WebLogic Tuxedo Connectorの構成」を参照してください。

WTCサービスおよびTuxedo UBBファイルの例

次のWTCサービス(config.xmlファイルのWTCServer MBeanで表現)には、TUXEDO CORBAサーバー用のインポートされたサービス構成を構成する方法の例が適用されています。

例5-1 CORBAサーバー・アプリケーションのサンプルWTCServer MBean

<wtc-server>
<name>WTCsimpappCNS</name>
<wtc-local-tux-dom>
<access-point>examples</access-point>
<access-point-id>examples</access-point-id>
<connection-policy>ON_DEMAND</connection-policy>
<nw-addr>//123.123.123.123:5678</nw-addr>
<name>myLoclTuxDom</name>
<security>NONE</security>
</wtc-local-tux-dom>
<wtc-remote-tux-dom>
<access-point>TUXDOM</access-point>
<access-point-id>TUXDOM</access-point-id>
<local-access-point>examples</local-access-point>
<nw-addr>//123.123.123.123:1234</nw-addr>
<name>myRTuxDom</name>
</wtc-remote-tux-dom>
<wtc-import>
<local-access-point>examples</local-access-point>
<name>myImportedResources</name>
<remote-access-point-list>TUXDOM</remote-access-point-list>
<remote-name>//simpapp</remote-name>
</wtc-import>
</wtc-server>

以下のサンプルTuxedo UBB構成ファイルには、simpappというDOMAINID名が定義されています。DOMAINID名は、WTCサービスのインポートされたサービス構成のリソース名属性で使用されます。

例5-2 CORBAサーバー・アプリケーションのサンプルTuxedo UBBファイル

*RESOURCES
IPCKEY     55432
DOMAINID   simpapp
MASTER     SITE1
MODEL      SHM
LDBAL      N
*MACHINES
"YODA"
LMID=SITE1
APPDIR="your APPDIR"
TUXCONFIG="APPDIR\tuxconfig"
TUXDIR="your TUXDIR"
MAXWSCLIENTS=10
*GROUPS
SYS_GRP
LMID=SITE1
GRPNO=1
APP_GRP
LMID=SITE1
GRPNO=2
*SERVERS
DEFAULT:
RESTART=Y
MAXGEN=5
TMSYSEVT
SRVGRP=SYS_GRP
SRVID=1
TMFFNAME
SRVGRP=SYS_GRP
SRVID=2
CLOPT="-A -- -N -M"
TMFFNAME
SRVGRP=SYS_GRP
SRVID=3
CLOPT= "-A -- -N"
TMFFNAME
SRVGRP=SYS_GRP
SRVID=4
CLOPT="-A -- -F"
ISL
SRVGRP=SYS_GRP
SRVID=5
CLOPT="-A -- -n <//your tux machine:2468>"
cns
SRVGRP=SYS_GRP
SRVID=6
CLOPT="-A --"
DMADM SRVGRP=SYS_GRP SRVID=7
GWADM SRVGRP=SYS_GRP SRVID=8
GWTDOMAIN SRVGRP=SYS_GRP SRVID=9
simple_server
SRVGRP=APP_GRP
SRVID=1
RESTART = N
*SERVICES

着信RMI-IIOPのOracle WebLogic Tuxedo Connectorを管理および構成する方法

この節では、アプリケーション環境の管理方法およびTuxedo CORBAオブジェクトがRMI-IIOP APIを使用してWebLogic ServerにデプロイしたEJBを呼び出すことを可能にするWTCサービスの構成方法について説明します。

- 着信RMI-IIOP用のWTCサービスの構成

- Tuxedoアプリケーション環境の管理

着信RMI-IIOP用のWTCサービスの構成

使用する環境に合わせて、ローカルTuxedoアクセス・ポイントおよびリモートTuxedoアクセス・ポイントを構成します。RMI-IIOP APIを使用して、Tuxedo CORBAオブジェクトがWebLogic ServerにデプロイしたEJBを呼び出すことを可能にするための特別な管理手順は必要ありません。

WTCサービスの構成方法の詳細は、「アプリケーション用のOracle WebLogic Tuxedo Connectorの構成」を参照してください。

Tuxedoアプリケーション環境の管理

Tuxedoアプリケーション環境を構成する場合は、さらに次の手順を実行する必要があります。

1. 環境のTOBJADDRを設定します。例:

//<hostname>:2468

2. 次のコマンドを入力して、TuxedoドメインのCosNamingネームスペースにWebLogic Server (WLS)ネーミング・サービスを登録します。

cnsbind -o ior.txt your_bind_name

ここで、your_bind_nameは、使用するTuxedoアプリケーションから得たCosNamingサービス・オブジェクト名です。

ior.txtファイルには、WebLogic Serverのドメイン・ネーミング・サービスのURLが含まれています。例:

corbaloc:tgiop:myServer/NameService

ここで、myServerはサーバー名です。

3. Tuxedoドメイン構成ファイルの*DM_REMOTE_SERVICESを変更します。以前はDOMAINIDであったWebLogic Serverサービス名を、使用しているWebLogic Serverの名前で置き換えます。

*DM_REMOTE_SERVICES
"//myServer"

ここで、myServerは、WTCサービスを実行しているサーバー名です。

4. dmloadcfを使用して、修正したドメイン構成ファイルをロードします。

Tuxedoアプリケーション環境の構成方法の詳細は、「管理」を参照してください。

オブジェクト参照としてのサーバー名使用に関するガイドライン

この節では、オブジェクト参照として使用するサーバー名を作成する際に、覚えておく必要のあるガイドラインを示します。

- *DM_REMOTE_SERVICESセクション内で、Tuxedoが受け入れる最大フィールド長は、//を含めて15文字。たとえば、サーバー名がexamplesServerの場合、*DM_REMOTE_SERVICESオブジェクト参照は//examplesServeとなります。

- 複数のサーバーが必要な場合、サーバー名は最初の13文字がユニークにならなければなりません。

- ior.txtファイルにあるサーバー名の完全な名前が13文字を超えている場合には、それを使用できます。例: corbaloc:tgiop:examplesServer/NameService

送信RMI-IIOPのOracle WebLogic Tuxedo Connectorを構成する方法

この節では、RMI-IIOP APIを使用してWebLogic Server EJBがTuxedo CORBAオブジェクトを呼び出すことを可能にする方法について説明します。以下の手順に従って、WTCサービスを変更します。

1. ローカルTuxedoアクセス・ポイントを構成します。

- リモートTuxedoアクセス・ポイントを構成します。送信RMI-IIOPでは、フェデレーションURLおよびフェデレーション名という2つの要素を追加する必要があります。

- 「フェデレーションURL」に、JNDIに結合する外部ネーム・サービスのURLを設定します。これは、EJBがリモートTuxedo CORBAオブジェクトへのアクセスに使用する初期コンテキストを取得するために使用するURLと同じでなければなりません。

- 「フェデレーション名」に、結合ポイントの識別名を設定します。

2. インポートされたサービスを構成します。

- リソース名を「//domain_id」に設定します。「domain_id」は、オブジェクトがデプロイされるリモートTuxedoドメインのTuxedo UBBCONFIGファイルで指定されているDOMAINIDです。このCORBAドメインのユニークな識別子の最大長は、//を含めて15文字です。

- 「ローカル・アクセス・ポイント」を、リモートTuxedoアクセス・ポイントの「ローカル・アクセス・ポイント」属性の値に設定します。

- 「リモート・アクセス・ポイント・リスト」を、リモートTuxedoアクセス・ポイントの「アクセス・ポイントID」属性の値に設定します。

WebLogic Server EJBを使用してTuxedoサービスを呼び出すRMI-IIOPを使用するアプリケーションの開発方法については、『Oracle Fusion Middleware Oracle WebLogic Server Tuxedo Connectorプログラマーズ・ガイド』を参照してください。

WTCサービスの構成方法の詳細は、「アプリケーション用のOracle WebLogic Tuxedo Connectorの構成」を参照してください。

送信RMI-IIOP構成例

config.xmlファイルにある次のWTCServer MBeanには、送信RMI-IIOP用に構成されているWTCサービスの例が提供されています。

例5-3 送信RMI-IIOPのサンプルWTCServer MBean

.
.
.
<wtc-server>
<name>WTCtrader</name>
<wtc-local-tux-dom>
<access-point>TDOM2</access-point>
<access-point-id>TDOM2</access-point-id>
<connection-policy>ON_DEMAND</connection-policy>
<nw-addr>//123.123.123.123:5678</nw-addr>
<name>myLoclTuxDom</name>
<scurity>NONE</security>
</wtc-local-tux-dom>
<wtc-remote-tux-dom>
<access-point>TDOM1</access-point>
<access-point-id>TDOM1</access-point-id>
<federation-name>tuxedo.corba.remote</federation-name>
<federation-url>corbaloc:tgiop:simpapp/NameService</federation-url>
<local-access-point>TDOM2</local-access-point>
<nw-addr>//123.123.123.123:1234</nw-addr>
<name>myRTuxDom</name>
</wtc-remote-tux-dom>
<wtc-import>
<local-access-point>TDOM2</local-access-point>
<name>myImportedResources</name>
<remote-access-point-list>TDOM1</remote-access-point-list>
<remote-name>//simpapp</remote-name>
</wtc-import>
</wtc-server>
.
.
.

6 クラスタ環境におけるOracle WebLogic Tuxedo Connectorの管理方法

この章では、クラスタ環境で使用するOracle WebLogic Tuxedo Connectorの管理および構成方法について説明します。

- クラスタ環境におけるOracle WebLogic Tuxedo Connectorのガイドライン

- Tuxedoドメインに対する送信リクエストの構成方法

- Tuxedoドメインからの着信リクエストの構成方法

WebLogic Serverクラスタの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverクラスタの使用』を参照してください。

クラスタ環境におけるOracle WebLogic Tuxedo Connectorのガイドライン

クラスタ環境でOracle WebLogic Tuxedo Connectorをデプロイする際は、以下のガイドラインに従ってください。

- バインドはクラスタ内の他のサーバーではレプリケートされないため、クラスタ内のすべてのWebLogic Serverには、構成済みのOracle WebLogic Tuxedo Connectorが必要です。WebLogic Tuxedo Connectorには必要なインポートされたサービスを定義する「インポート済み」タブがあります。クラスタ内の1つのサーバーにデプロイ済みのOracle WebLogic Tuxedo Connectorがない場合、Enterprise JavaBeans (EJB)またはメッセージドリブンBean (MDB)は、その接続に対するTuxedo接続ファクトリを見つけられません。

- 管理者は、クラスタリングされたノードに対する着信呼出しのロード・バランシングとフェイルオーバーが適切に行われるように、TUXEDO DMCONFIGを正しく構成する責任があります。

- Oracle WebLogic Tuxedo Connectorはクラスタ環境での着信TGIOPをサポートしません。

クラスタリングされたノードの場合の構成方法

クラスタリングされたWebLogic Server (WLS)環境でのWTCサーバーの構成は、クラスタリングされていないWLS環境でのWTCサーバーの構成とまったく同じです。JATMIベースのEJBをデプロイする予定の、クラスタ内の各ノードに対してWTCサーバーを構成します。その後、各WTCサーバーを目的のWebLogic Serverに割り当てます。WTCサーバーは、WebLogic Serverノードごとに1つしか割り当てられません。

クラスタリングされたノードに対する制限

JATMIベースのEJBがデプロイされるすべてのWebLogic Serverに対して、WTCサーバーを構成する必要があります。高可用性は、WebLogic Serverクラスタ自体の高可用性に依存します。WTCサーバー間のフェイルオーバーやフェイルバックを行うための特別な機能はありません。

Tuxedoドメインに対する送信リクエストの構成方法

WebLogic Serverからの送信リクエストのロード・バランシングとフェイルオーバーは、WebLogic Server EJBおよびMDBによって異なります。

WebLogic Serverクラスタの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverクラスタの使用』の「クラスタでの通信」を参照してください。Oracle WebLogic Tuxedo Connectorは、ドメイン・レベルのフェイルオーバーおよびフェイルバック機能も提供します。詳細は、「フェイルオーバーとフェイルバックの構成」を参照してください。

クラスタリングされたOracle WebLogic Tuxedo Connectorの構成例

以下の構成は、クラスタ環境にあるOracle WebLogic Tuxedo Connectorの例です。このクラスタは、1つの管理サーバー(wtcAServer)と、3つの管理対象サーバー(wtcMServer1、wtcMServer2、wtcMServer3)から構成されています。管理対象サーバーにはそれぞれ、構成済みのWTCサービスがあり、インポートされたサービスとして同じサービス(TOUPPER)が含まれています。

例6-1 クラスタリングされたOracle WebLogic Tuxedo Connectorの構成例

<name>mydomain</name>
<security-configuration>
<name>mydomain</name>
<realm>
<sec:authentication-provider
xsi:type="wls:default-authenticatorType"></sec:authentication-provider>
<sec:authentication-provider xsi:type="wls:default-identity-asserterType">
<sec:active-type>AuthenticatedUser</sec:active-type>
</sec:authentication-provider>
<sec:role-mapper xsi:type="wls:default-role-mapperType"></sec:role-mapper>
<sec:authorizer xsi:type="wls:default-authorizerType"></sec:authorizer>
<sec:adjudicator xsi:type="wls:default-adjudicatorType"></sec:adjudicator>
<sec:credential-mapper xsi:type="wls:default-credential-mapperType"></sec:credential-mapper>
<sec:cert-path-provider
xsi:type="wls:web-logic-cert-path-providerType"></sec:cert-path-provider>
<sec:cert-path-builder>WebLogicCertPathProvider</sec:cert-path-builder>
<sec:user-lockout-manager></sec:user-lockout-manager>
<sec:security-dd-model>Advanced</sec:security-dd-model>
<sec:combined-role-mapping-enabled>false</sec:combined-role-mapping-enabled>
<sec:name>myrealm</sec:name>
</realm>
<default-realm>myrealm</default-realm>
<credential-encrypted>{3DES}O0Qw7QBG3+cmemXbtKhHPJL2QLw7tqSYkoWqBtU17W+IoPebpoNai/T3SdtxBOwVHOJJPi
/sA8JMJ9MAM4i3KqVgd26A311z</credential-encrypted>
<web-app-files-case-insensitive>os</web-app-files-case-insensitive>
<compatibility-connection-filters-enabled>true</compatibility-connection-filters-enabled>
<node-manager-username>weblogic</node-manager-username>
<node-manager-password-encrypted>{3DES}37KMzVTzxZ9VFxCFSVGWzA==</node-manager-password-encrypted>
<enforce-strict-url-pattern>false</enforce-strict-url-pattern>
</security-configuration>
<security>
<realm>wl_default_realm</realm>
<password-policy>wl_default_password_policy</password-policy>
</security>
<wtc-server>
<name>WTCServer1</name>
<target>wtcMServer1</target>
<wtc-local-tux-dom>
<name>ltd0</name>
<access-point>WDOM1</access-point>
<access-point-id>WDOM1</access-point-id>
<security>NONE</security>
<connection-policy>ON_STARTUP</connection-policy>
<block-time>30000</block-time>
<nw-addr>//mymachine:20401</nw-addr>
</wtc-local-tux-dom>
<wtc-remote-tux-dom>
<name>rtd0</name>
<access-point>TDOM1</access-point>
<access-point-id>TDOM1</access-point-id>
<local-access-point>WDOM1</local-access-point>
<nw-addr>//123.123.123.123:20301</nw-addr>
</wtc-remote-tux-dom>
<wtc-remote-tux-dom>
<name>rtd1</name>
<access-point>TDOM2</access-point>
<access-point-id>TDOM2</access-point-id>
<local-access-point>WDOM1</local-access-point>
<nw-addr>//123.123.123.123:20302</nw-addr>
</wtc-remote-tux-dom>
<wtc-export>
<name>exp0</name>
<resource-name>TOLOWER</resource-name>
<local-access-point>WDOM1</local-access-point>
<ejb-name>tuxedo.services.TOLOWERHome</ejb-name>
<remote-name>TOLOWER</remote-name>
</wtc-export>
<wtc-export>
<name>exp1</name>
<resource-name>EJBLSleep</resource-name>
<local-access-point>WDOM1</local-access-point>
<ejb-name>tuxedo.services.TOLOWERHome</ejb-name>
<remote-name>EJBLSleep</remote-name>
</wtc-export>
<wtc-import>
<name>imp0</name>
<resource-name>TOUPPER</resource-name>
<local-access-point>WDOM1</local-access-point>
<remote-access-point-list>TDOM2,TDOM1</remote-access-point-list>
</wtc-import>
<wtc-import>
<name>imp1</name>
<resource-name>LSleep</resource-name>
<local-access-point>WDOM1</local-access-point>
<remote-access-point-list>TDOM2,TDOM1</remote-access-point-list>
</wtc-import>
</wtc-server>
<wtc-server>
<name>WTCServer2</name>
<target>wtcMServer2</target>
<wtc-local-tux-dom>
<name>ltd0</name>
<access-point>WDOM2</access-point>
<access-point-id>WDOM2</access-point-id>
<security>NONE</security>
<connection-policy>ON_STARTUP</connection-policy>
<block-time>30000</block-time>
<nw-addr>//mymachine:20402</nw-addr>
</wtc-local-tux-dom>
<wtc-remote-tux-dom>
<name>rtd0</name>
<access-point>TDOM1</access-point>
<access-point-id>TDOM1</access-point-id>
<local-access-point>WDOM2</local-access-point>
<nw-addr>//123.123.123.123:20301</nw-addr>
</wtc-remote-tux-dom>
<wtc-remote-tux-dom>
<name>rtd1</name>
<access-point>TDOM2</access-point>
<access-point-id>TDOM2</access-point-id>
<local-access-point>WDOM2</local-access-point>
<nw-addr>//123.123.123.123:20302</nw-addr>
</wtc-remote-tux-dom>
<wtc-export>
<name>exp0</name>
<resource-name>TOLOWER</resource-name>
<local-access-point>WDOM2</local-access-point>
<ejb-name>tuxedo.services.TOLOWERHome</ejb-name>
<remote-name>TOLOWER</remote-name>
</wtc-export>
<wtc-export>
<name>exp1</name>
<resource-name>EJBLSleep</resource-name>
<local-access-point>WDOM2</local-access-point>
<ejb-name>tuxedo.services.TOLOWERHome</ejb-name>
<remote-name>EJBLSleep</remote-name>
</wtc-export>
<wtc-import>
<name>imp0</name>
<resource-name>TOUPPER</resource-name>
<local-access-point>WDOM2</local-access-point>
<remote-access-point-list>TDOM2,TDOM1</remote-access-point-list>
</wtc-import>
<wtc-import>
<name>imp1</name>
<resource-name>LSleep</resource-name>
<local-access-point>WDOM2</local-access-point>
<remote-access-point-list>TDOM2,TDOM1</remote-access-point-list>
</wtc-import>
</wtc-server>
<wtc-server>
<name>WTCServer3</name>
<target>wtcMServer3</target>
<wtc-local-tux-dom>
<name>ltd0</name>
<access-point>WDOM3</access-point>
<access-point-id>WDOM3</access-point-id>
<security>NONE</security>
<connection-policy>ON_STARTUP</connection-policy>
<block-time>30000</block-time>
<nw-addr>//mymachine:20403</nw-addr>
</wtc-local-tux-dom>
<wtc-remote-tux-dom>
<name>rtd0</name>
<access-point>TDOM1</access-point>
<access-point-id>TDOM1</access-point-id>
<local-access-point>WDOM3</local-access-point>
<nw-addr>//123.123.123.123:20301</nw-addr>
</wtc-remote-tux-dom>
<wtc-remote-tux-dom>
<name>rtd1</name>
<access-point>TDOM2</access-point>
<access-point-id>TDOM2</access-point-id>
<local-access-point>WDOM3</local-access-point>
<nw-addr>//123.123.123.123:20302</nw-addr>
</wtc-remote-tux-dom>
<wtc-export>
<name>exp0</name>
<resource-name>TOLOWER</resource-name>
<local-access-point>WDOM3</local-access-point>
<ejb-name>tuxedo.services.TOLOWERHome</ejb-name>
<remote-name>TOLOWER</remote-name>
</wtc-export>
<wtc-export>
<name>exp1</name>
<resource-name>EJBLSleep</resource-name>
<local-access-point>WDOM3</local-access-point>
<ejb-name>tuxedo.services.TOLOWERHome</ejb-name>
<remote-name>EJBLSleep</remote-name>
</wtc-export>
<wtc-import>
<name>imp0</name>
<resource-name>TOUPPER</resource-name>
<local-access-point>WDOM3</local-access-point>
<remote-access-point-list>TDOM2,TDOM1</remote-access-point-list>
</wtc-import>
<wtc-import>
<name>imp1</name>
<resource-name>LSleep</resource-name>
<local-access-point>WDOM3</local-access-point>
<remote-access-point-list>TDOM2,TDOM1</remote-access-point-list>
</wtc-import>
</wtc-server>
<server>
<name>wtcAServer</name>
<native-io-enabled>true</native-io-enabled>
<ssl>
<name>wtcAServer</name>
<identity-and-trust-locations>FilesOrKeyStoreProviders</identity-and-trust-locations>
</ssl>
<listen-port>5472</listen-port>
<tunneling-enabled>true</tunneling-enabled>
</server>
<server>
<name>wtcMServer1</name>
<native-io-enabled>true</native-io-enabled>
<ssl>
<name>wtcMServer1</name>
<identity-and-trust-locations>FilesOrKeyStoreProviders</identity-and-trust-locations>
</ssl>
<listen-port>7701</listen-port>
<cluster>wtcCluster</cluster>
<listen-address>mymachine</listen-address>
<tunneling-enabled>true</tunneling-enabled>
<jta-migratable-target>
<user-preferred-server>wtcMServer1</user-preferred-server>
<cluster>wtcCluster</cluster>
</jta-migratable-target>
</server>
<server>
<name>wtcMServer2</name>
<native-io-enabled>true</native-io-enabled>
<ssl>
<name>wtcMServer2</name>
<identity-and-trust-locations>FilesOrKeyStoreProviders</identity-and-trust-locations>
</ssl>
<listen-port>7702</listen-port>
<cluster>wtcCluster</cluster>
<listen-address>mymachine</listen-address>
<tunneling-enabled>true</tunneling-enabled>
<jta-migratable-target>
<user-preferred-server>wtcMServer2</user-preferred-server>
<cluster>wtcCluster</cluster>
</jta-migratable-target>
</server>
<server>
<name>wtcMServer3</name>
<native-io-enabled>true</native-io-enabled>
<ssl>
<name>wtcMServer3</name>
<identity-and-trust-locations>FilesOrKeyStoreProviders</identity-and-trust-locations>
</ssl>
<listen-port>7703</listen-port>
<cluster>wtcCluster</cluster>
<listen-address>mymachine</listen-address>
<tunneling-enabled>true</tunneling-enabled>
<jta-migratable-target>
<user-preferred-server>wtcMServer3</user-preferred-server>
<cluster>wtcCluster</cluster>
</jta-migratable-target>
</server>
<cluster>
<name>wtcCluster</name>
<multicast-address>239.0.0.20</multicast-address>
<multicast-port>7700</multicast-port>
<multicast-ttl>1</multicast-ttl>
</cluster>
<configuration-version>9.0.0.0</configuration-version>
<file-realm>
<name>wl_default_file_realm</name>
</file-realm>
<realm>
<name>wl_default_realm</name>
<file-realm>wl_default_file_realm</file-realm>
</realm>
<password-policy>
<name>wl_default_password_policy</name>
</password-policy>
<migratable-target>
<name>wtcMServer1 (migratable)</name>
<user-preferred-server>wtcMServer1</user-preferred-server>
<cluster>wtcCluster</cluster>
</migratable-target>
<migratable-target>
<name>wtcMServer2 (migratable)</name>
<user-preferred-server>wtcMServer2</user-preferred-server>
<cluster>wtcCluster</cluster>
</migratable-target>
<migratable-target>
<name>wtcMServer3 (migratable)</name>
<user-preferred-server>wtcMServer3</user-preferred-server>
<cluster>wtcCluster</cluster>
</migratable-target>
<web-app-container>
<relogin-enabled>true</relogin-enabled>
<allow-all-roles>true</allow-all-roles>
<filter-dispatched-requests-enabled>true</filter-dispatched-requests-enabled>
<rtexprvalue-jsp-param-name>true</rtexprvalue-jsp-param-name>
<jsp-compiler-backwards-compatible>true</jsp-compiler-backwards-compatible>
</web-app-container>
<admin-server-name>wtcAServer</admin-server-name>
</domain>

Tuxedoドメインからの着信リクエストの構成方法

Tuxedoからの着信リクエストのロード・バランシングとフェイルオーバーは、TuxedoドメインのDMCONFIG構成によって異なります。

ロード・バランシング

TuxedoからクラスタリングされたWTCまでのロード・バランシングを行うTuxedo DMCONFIGの例を以下に示します。この構成では、WebLogic Serverクラスタ内に3つのノードがあります。各ノードには、正しく構成されたOracle WebLogic Tuxedo Connectorインスタンスが1つあり、エクスポートされたサービスを提供し、そのサービスからTuxedoクライアントへのアクセスが可能です。

*DM_IMPORT
TOUPPER LDOM=tuxedo_dom RDOM=WDOM1 LOAD=50
TOUPPER LDOM=tuxedo_dom RDOM=WDOM2 LOAD=50
TOUPPER LDOM=tuxedo_dom RDOM=WDOM3 LOAD=50

Tuxedo環境でのロード・バランシングの詳細は、「ロード・バランシング」を参照してください。

フェイルオーバー

以下に、Tuxedoフェイルオーバー機能で示したのと同様に、WebLogic Serverノード間のロード・バランシングを行う、より洗練された構成を使用するTuxedo DMCONFIGの例を示します。ドメイン・レベルのフェイルオーバーおよびフェイルバックを有効にするには、接続ポリシーをOn StartupまたはIncoming Onlyに設定してTuxedoドメインを構成する必要があります。

*DM_IMPORT
TOUPPER LDOM=tuxedo_dom RDOM=WDOM1,WDOM2,WDOM3 LOAD=50
TOUPPER LDOM=tuxedo_dom RDOM=WDOM2,WDOM3,WDOM1 LOAD=50
TOUPPER LDOM=tuxedo_dom RDOM=WDOM3,WDOM1,WDOM2 LOAD=50

Tuxedoドメインでのフェイルオーバーの詳細は、「Domainsのフェイルオーバーとフェイルバックの指定」を参照してください。

7 Oracle Tuxedoキュー・ブリッジの構成方法

この章では、Tuxedoキュー・ブリッジの機能と構成について説明します。

- Tuxedoキュー・ブリッジの概要

- Tuxedoキュー・ブリッジの構成

- Tuxedoキュー・ブリッジの接続性

- 接続タイプの構成の例

- 優先度のマッピング

- エラー・キュー

Tuxedoキュー・ブリッジの概要

Tuxedoキュー・ブリッジはOracle WebLogic Tuxedo Connectorの一部であり、Tuxedoアプリケーション環境と通信するWebLogic Serverアプリケーションのために双方向JMSインタフェースを提供します。環境間でのメッセージングの転送は、クライアント・アプリケーションのかわりにサービスを呼び出すのに使用するテキスト、Byte、またはXMLデータ・ストリームを含むJMSベースのメッセージで構成されます。

図7-1 キュー・ブリッジによるWebLogic ServerとTuxedoの対話

Tuxedoキュー・ブリッジの機能は以下のように決定されます。

- 接続性は、「WTCサービス」の「Tuxedoキュー・ブリッジ」ページの「リダイレクト」タブにある属性の構成によって決定されます。

- Tuxedoキュー・ブリッジは、Java Messaging Service (JMS)を使用してTuxedo /QまたはTuxedoサービスへのインタフェースを提供します。

- Tuxedoキュー・ブリッジは、既存のTuxedoシステムに接続性を提供するために、XMLとFML32間においてシンプルな変換を提供します。

Tuxedoキュー・ブリッジによるJMSからTuxedoへの接続

この節では、JMSのメッセージがTuxedoキュー・ブリッジを介してTuxedoキューおよびサービスに渡されるまでの流れを説明します。

注意:
メッセージは、確認応答されるまでJMSキューに保持されます。

1. Webが有効化されたWLPIアプリケーションなどのJMSクライアントにより、Tuxedoで処理されるメッセージがJMSキューに配置されます。このメッセージがトランザクションの一部だった場合、トランザクションがコミットされます。

2. メッセージがJMSキューから移動し、Tuxedoキュー・ブリッジ・コンバータで処理されます。

3. Tuxedoキュー・ブリッジ・コンバータによりメッセージ・タイプがチェックされ、サポートされているJMSメッセージ・タイプがJATMIのバッファ・タイプに変換されます。

1. BytesMessage、TextMessage、XMLが、それぞれTypedCArray、TypedString、TypedFML32に変換されます。TranslateFML属性の値に従って、XML/FML変換が実行されます。

2. 変換エラーが発生した場合、エラーはwlsServerErrorDestinationキューに送られ、メッセージはJMSセッションで確認応答されます。

3. 認識されないJMSメッセージを受信した場合、適宜エラー・メッセージがログされ、そのメッセージは確認応答された後、破棄されます。これは構成エラーと解釈され、Tuxedoキュー・ブリッジはメッセージをエラー・キューにリダイレクトしません。

4. 変換されたメッセージが、T/Domainゲートウェイを使用してTuxedoに送られます。

1. JmsQ2TuxQのリダイレクト・セットを利用し、JATMIのtpenqueueを使用して、メッセージがTuxedoキューに送られます。

2. JmsQ2TuxSのリダイレクト・セットを利用し、JATMIのtpcallを使用して、メッセージがTuxedoサービスに送られます。

5. tpenqueueまたはtpcallが成功した場合、戻り値がReplyQに置かれます。メッセージがJMSセッションで確認応答されます。
tpenqueueまたはtpcallが失敗した場合、メッセージはTuxedoキュー・ブリッジによりwlsServerErrorDestinationキューに送られ、JMSセッションで確認応答されます。wlsServerErrorDestinationキューが構成されていない場合、メッセージは破棄され、Tuxedoキュー・ブリッジは応答確認されていない次のメッセージを処理します。

Tuxedoキュー・ブリッジによるTuxedoからJMSへの接続

この節では、TuxQ2JmsQリダイレクトを利用して、TuxedoのメッセージがTuxedoキュー・ブリッジを介してJMSキューに渡されるまでの流れを説明します。

注意:
Tuxedoキュー・ブリッジはトランザクションを使用して、Tuxedo /QからJMSキューへの転送中にメッセージが失われないようにします。

1. Tuxedoキュー・ブリッジにより、Tuxedoキューの使用可能なメッセージがポーリングされます。

2. Tuxedoサービスにより、メッセージがTuxedoキューに配置されます。

3. Tuxedoキュー・ブリッジでは、JATMIのtpdequeueを使用して、Tuxedoからメッセージを転送し、JMSキューに配置します。

- 何らかの理由で、指定された再試行回数を使い果たしてもメッセージがJMSキューにリダイレクトされない場合、メッセージはTuxedoキューと同じキュー・スペースにあるtuxErrorDestinationキューに配置されます。

- Tuxedoキュー・ブリッジがメッセージをtuxErrorDestinationキューに配置できなかった場合は、エラー・ログが記録されて、メッセージは失われます。

- tuxErrorDestinationキューが指定されていない場合、メッセージは失われます。

Tuxedoキュー・ブリッジの制限

Tuxedoキュー・ブリッジには、次のような制限があります。

- JMSからメッセージを取り出してTuxedoキューに配置する場合や、Tuxedoサービスを呼び出す場合には、トランザクションは使用されません。

- Tuxedoキュー・ブリッジは、スレッド・インテンシブです。JMSキューからTuxedoへメッセージが転送されるたびに、スレッドが使用されます。構成されているTuxedoキューをモニターするには、ポーリング・スレッドが必要になります。

- XML/FML変換は、簡単なメッセージ構造の構築のために行われます。XMLからFMLへの変換の詳細は、『Oracle Fusion Middleware Oracle WebLogic Server Tuxedo Connectorプログラマーズ・ガイド』の「FML32の考慮事項」を参照してください。

Tuxedoキュー・ブリッジの構成

Tuxedoキュー・ブリッジの接続性は、「WTCサービス」の「Tuxedoキュー・ブリッジ」ページの「リダイレクト」タブにある属性の構成によって決定されます。これらの属性には、Tuxedoへの接続を確立するために必要な情報が含まれています。

完全なTuxedoキュー・ブリッジの構成には、次の条件が必要です。

- 1つのキュー・ブリッジが構成されていること

- 1つまたは複数のリダイレクトが構成されていること

Tuxedoキュー・ブリッジを動的に追加または変更する

通常、Tuxedoキュー・ブリッジは、完全なTuxedoキュー・ブリッジの構成が存在し、WTCをデプロイした後にアクティブ化します。Tuxedoキュー・ブリッジがアクティブになったら、WTCキュー・ブリッジを停止するまで構成に対して追加や変更はできません。

WTCがアクティブ化され、Tuxedoキュー・ブリッジが非アクティブ化されている場合、以下のような追加と変更が可能です。

- WTCキュー・ブリッジの追加(WTCキュー・ブリッジ構成がない場合)

- WTCキュー・ブリッジの変更

- WTCキュー・ブリッジの削除

- WTCリダイレクトの追加

- WTCリダイレクトの変更

- WTCリダイレクトの削除

WTCキュー・ブリッジの構成を変更したら、変更をアクティブ化する必要があります。

注意:
Tuxedoキュー・ブリッジを動的に追加または変更できるのは、キュー・ブリッジがアクティブ化されていない場合のみです。WTCはアクティブ化されていてもかまいませんが、キュー・ブリッジは非アクティブ化されている必要があります。WTCキュー・ブリッジを停止するには、WTCサーバーを非アクティブ化する必要があります。

Tuxedoキュー・ブリッジのインスタンス化

Tuxedoキュー・ブリッジは、アクティブ化の時点で完全なWTCキュー・ブリッジの構成が利用できる場合にのみ起動されます。

WTCキュー・ブリッジの構成が完全でない場合は、Tuxedoキュー・ブリッジのインスタンスは利用できません。

Tuxedoキュー・ブリッジの起動

WTCサービスのTuxedoキュー・ブリッジおよびリダイレクトが構成されており、対象サーバーにWTCサービスがデプロイされている場合、Tuxedoキュー・ブリッジは、WebLogic Serverアプリケーション環境の一部として起動されます。Tuxedoキュー・ブリッジが起動できないような構成条件が発生した場合は、エラーがログされます。

エラーのロギング

Oracle WebLogic Tuxedo Connectorエラーは、WebLogic Serverエラー・ログにログされます。

Tuxedoキュー・ブリッジの接続性

Tuxedoキュー・ブリッジは、JMSキューとTuxedo /QまたはJMSキューとTuxedoサービスのインスタンス間で、一方向のデータ接続を確立します。この接続は、WTCサービスのTuxedoキュー・ブリッジのリダイレクト構成で表され、識別されたポイント間に1対1の接続を提供します。3つのタイプの接続が構成できます。次に、各接続タイプについて説明します。

- JmsQ2TuxQ : JMSキューから読取りを行い、指定されたTuxedo /Qにメッセージを転送します。

- TuxQ2JmsQ : Tuxedo /Qから読取りを行い、JMSにメッセージを転送します。

- JmsQ2TuxS : JMSキューから読取りを行い、同時に指定されたTuxedoサービスを呼び出し、指定されたJMSキューに応答を返します。

注意:
MapMessage、ObjectMessage、StreamMessageのJMSメッセージ・タイプは、Oracle WebLogic Tuxedo Connectorでは無効です。これらのメッセージ・タイプの1つがTuxedoキュー・ブリッジによって受信された場合は、サポートされていないタイプであることを示すログ・エントリが作成され、メッセージが破棄されます。

接続タイプの構成の例

以下に、各接続タイプの構成の例を紹介します。

JmsQ2TuxQ構成の例

以下の節では、JMSキューから読取りを行い、Tuxedo /Qに送信する、config.xmlファイルの構成の例を示します。

<wtc-tbridge-redirect>
<direction>JmsQ2TuxQ</direction>
<name>redir0</name>
<reply-q>RPLYQ</reply-q>
<source-name>weblogic.jms.Jms2TuxQueue</source-name>
<target-access-point>TDOM2</target-access-point>
<target-name>STRING</target-name>
<target-qspace>QSPACE</target-qspace>
<translate-fml>NO</translate-fml>
</wtc-tbridge-redirect>

次に、JmsQ2TuxQ構成の各コンポーネントを説明します。

- Direction接続タイプはJmsQ2TuxQです。

- Source Nameは、読み取るJMSキューの名前がweblogic.jms.Jms2TuxQueueであることを指定します。Tuxedoキュー・ブリッジは、CLIENT_ACKNOWLEDGEセマンティクスを使用して、このキューにJMSクライアント・セッションを確立します。

- Target Access Pointは、アクセス・ポイントの名前がTDOM2であることを指定します。

- Target Qspaceは、Qspaceの名前がQspaceであることを指定します。

- Target Nameは、キューの名前がSTRINGであることを指定します。

- ReplyQは、JMS応答キューの名前がRPLYQであることを指定します。このキューを使用すると、tpenqueueはTMFORWARD機能を提供します。

- TranslateFMLがNOになっていると、Tuxedoキュー・ブリッジがデータ変換を提供しないことを指定します。

表7-1に、JmsQ2TuxQメッセージ・マッピングの情報を示します。

表7-1 JmsQ2TuxQメッセージ・マッピング

マッピング元: JMSメッセージ・タイプ

マッピング先: Oracle WebLogic Tuxedo Connector JATMI (Tuxedo)

BytesMessage

TypedCArray

TextMessage (translateFML = NONE)

TypedString

TextMessage (translateFML = FLAT)

TypedFML32

TuxQ2JmsQ構成の例

以下に、Tuxedo /Qから読取りを行い、JMSキューに送信する、config.xmlファイルの構成の例を示します。

<wtc-tbridge-redirect>
<direction>TuxQ2JmsQ</direction>
<name>redir1</name>
<source-access-point>TDOM2</source-access-point>
<source-name>STRING</source-name>
<source-qspace>QSPACE</source-qspace>
<target-name>weblogic.jms.Tux2JmsQueue</target-name>
<translate-fml>NO</translate-fml>
</wtc-tbridge-redirect>

次に、TuxQ2JmsQ構成の各コンポーネントを説明します。

- Direction接続タイプはTuxQ2JmsQです。

- Target Nameは、読み取るJMSキューの名前がweblogic.jms.Tux2JmsQueueであることを指定します。

- Source Access Pointは、アクセス・ポイントの名前がTDOM2であることを指定します。

- Source Qspaceは、Qspaceの名前がQspaceであることを指定します。

- Source Nameは、キューの名前がSTRINGであることを指定します。

- TranslateFMLがNOになっていると、Tuxedoキュー・ブリッジがデータ変換を提供しないことを指定します。

- TranslateFMLがFlatになっていると、Tuxedoキュー・ブリッジがそのデータをFMLからXMLに変換することを指定します。

表7-2に、TuxQ2JmsQメッセージ・マッピングの情報を示します。

表7-2 TuxQ2JmsQメッセージ・マッピング

マッピング元: Oracle WebLogic Tuxedo Connector JATMI (Tuxedo)

マッピング先: JMSメッセージ・タイプ

TypedCArray

BytesMessage

TypedString (translateFML = NO)

TextMessage

TypedFML32 (translateFML = FLAT)

TextMessage

TypedFML (translateFML = FLAT)

TextMessage

TypedXML

TextMessage

JmsQ2TuxS構成の例

次に、JMSキューから読取りを行い、Tuxedoサービスを呼び出して、結果をJMSキューに返す、config.xmlファイルの構成の例を示します。

<wtc-tbridge-redirect>
<direction>JmsQ2TuxS</direction>
<name>redir0</name>
<replyq>weblogic.jms.Tux2JmsQueue</replyq>
<source-name>weblogic.jms.Jms2TuxQueue</source-name>
<target-access-point>TDOM2</target-access-point>
<target-name>TOUPPER</target-name>
<translate-fml>FLAT</translate-fml>
</wtc-tbridge-redirect>

次に、JmsQ2TuxS構成の各コンポーネントを説明します。

- Direction接続タイプはJmsQ2TuxSです。

- Source Nameは、読み取るJMSキューの名前がweblogic.jms.Jms2TuxQueueであることを指定します。

- Target Access Pointは、アクセス・ポイントの名前がTDOM2であることを指定します。

- Target Nameは、キューの名前がTOUPPERであることを指定します。

- ReplyQは、JMS応答キューの名前がweblogic.jms.Tux2JmsQueueであることを指定します。

- TranslateFMLがFLATになっていると、JMSメッセージの受信時に、メッセージがXMLフォーマットで、対応するFML32データ・バッファに変換されることを指定します。メッセージはその後、引数TDOM2およびTOUPPERによりtpcallに置かれます。結果として生じたメッセージはその後、FML32からXMLに変換され、weblogic.jms.Tux2JmsQueueに置かれます。

表7-3に、JMSQ2TuxXメッセージ・マッピングの情報を示します。

表7-3 JMSQ2TuxXメッセージ・マッピング

JMSメッセージ・タイプ

Oracle WebLogic Tuxedo Connector JATMI (Tuxedo)

JMSメッセージ・タイプ

BytesMessage

TypedCArray

BytesMessage

TextMessage (translateFML = NONE)

TypedString

TextMessage

TextMessage (translateFML = FLAT)

TypedFML32

TextMessage

注意:
Tuxedoからの応答が戻され、translateFMLパラメータに効果がないシナリオが存在する場合があります。変換が自動的に発生する場合があります。

XML/FML変換の詳細は、『Oracle Fusion Middleware Oracle WebLogic Server Tuxedo Connectorプログラマーズ・ガイド』の「WebLogic Tuxedo ConnectorでのFMLの使用」を参照してください。

優先度のマッピング

Oracle WebLogic Tuxedo Connectorでは、複数のTuxedoキュー・ブリッジ・リダイレクト・インスタンスがサポートされています。リダイレクト・インスタンスを複数使用すると、多くの環境下でアプリケーションのスケーラビリティおよびパフォーマンスが著しく向上します。ただし、その場合メッセージが処理される順序がランダムになります。優先度のマッピングをしても順序は保証されませんが、割り当てられた重要度に従ってメッセージに対応するメカニズムが提供されます。配信の順序を確実にしたい場合は、Tuxedoキュー・ブリッジ・リダイレクト・インスタンスを1つだけ使用してください。

JMSおよびTuxedo間で優先度をマップするには、優先度マッピングを使用します。

- JMSには10の優先度があります(0 - 9)。

- Tuxedo/Qには100の優先度があります(1 - 100)。

この節では、TuxedoおよびJMSサブシステム間で優先度をマップするメカニズムについて説明します。2つのマッピング方向があります。

- JmstoTux

- TuxtoJms

次のvalue:rangeの組合せで示すように、すべての値にデフォルトが提供されています。

- valueは入力優先度を指定します。

- rangeは結果出力優先度のシーケンシャル・グループを指定します。

JmstoTux- 0:1 | 1:12 | 2:23 | 3:34 | 4:45 | 5:56 | 6:67 | 7:78 | 8:89 | 9:100
TuxtoJms- 0:1-10|1:11-20|2: 21-30|3: 31-40|4: 41-50|5:51-60|6: 61-70|7:71-80|8:81-90|9:91-100

この構成では、優先度7のJMSメッセージがTuxedo /Qの優先度78に割り当てられます。優先度47のTuxedo /Qは、優先度4のJMSに割り当てられます。

エラー・キュー

Tuxedoキュー・ブリッジがTuxedoキューまたはJMSキューからメッセージを受信したときに問題を検出した場合、再試行間隔の後に次の処理が行われます。

- 情報がログされます。

- 構成されている場合は、メッセージがエラー・キューに保存されます。

「WLSエラー宛先」

WLSエラー宛先キューは、JMSメッセージがTuxedoエラーまたは変換エラーにより適切に送信できない場合に使用されます。

サポートされていないメッセージ・タイプ

認識できないJMSメッセージを受信した場合、適切なエラー・メッセージがログされ、そのメッセージは破棄されます。これは構成エラーと解釈され、Tuxedoキュー・ブリッジはメッセージをエラー・キューにリダイレクトしません。

Tuxedoエラー・キュー

Tuxedoエラー・キューは、TuxQ2JmsQのリダイレクト中のJATMIプリミティブtpdequeueのエラー・キューです。

制限事項

Tuxedoキュー・ブリッジのエラー・キューには、次のような制限があります。

- Tuxedoエラー宛先は一度だけ指定できます。ErrorDestinationに関連するエラー・キュー名は、すべてのQSPACEが使用可能な同じエラー・キュー名を持っていることを示します。

- エラーが発生した場合、メッセージはソースQSPACEに返されます。QSPACEが破損している、またはいっぱいであると判断されると、後続のメッセージは消失します。

- エラー時にメッセージを破棄するよう指定する方法はありません。すべてのメッセージが受信されるか、まったく受信されません。

- エラーに関する情報は、サーバー・ログでのみ提供されます。

8 WebLogic IntegrationとTuxedoアプリケーションの接続

この章では、Oracle WebLogic Tuxedo Connector Tuxedoキュー・ブリッジが、Tuxedoアプリケーションをビジネス・ワークフローに統合するために必要なインフラストラクチャをWebLogic Integrationユーザーに提供する方法について説明します。

- WebLogic IntegrationとTuxedoの同期接続

- WebLogic IntegrationとTuxedoの同期非ブロッキング接続

- WebLogic IntegrationとTuxedoの非同期接続

- 非同期Tuxedo /QとWebLogic Integrationの接続

- TuxedoとWebLogic Integrationの双方向非同期接続

アプリケーションの統合方法の詳細は、BEA WebLogic統合を参照してください。

WebLogic IntegrationとTuxedoの同期接続

WebLogic Integrationは、JATMI EJBを使用してTuxedoに対してブロッキング呼出しを実行します。このプロセスは、次の3つの部分で構成されます。

- WebLogic Integrationビジネス操作の定義

- eLinkアダプタの呼出し

- WebLogic Integration例外ハンドラの定義

ビジネス操作の定義

使用するJATMIメソッドのWebLogic Integrationビジネス操作を定義します。

- TypedFML32バッファ操作メソッド。

- JATMI tpcall()メソッドを使用します。
例: out_buffer = tpcall (service_name, in_buffer, flags)

eLinkアダプタの呼出し

WebLogic Integrationプロセス・フローからeLinkアダプタを呼び出します。

- 定義されたビジネス操作を使用して、TypedFML32リクエスト・バッファを構築します。

- 定義されたビジネス操作を使用して、サービス名を指定するJATMI tpcall()メソッドを呼び出します。

- 定義されたビジネス操作を使用して、TypedFML32応答バッファを処理します。

例外ハンドラの定義

例外を処理するために、WebLogic Integration例外ハンドラを定義します。

WebLogic IntegrationとTuxedoの同期非ブロッキング接続

WebLogic Integrationは、Tuxedoサービスを同期的に呼び出すためにメッセージを送信します。

- JMSキューとTuxedoサービスへの呼出し間の1対1の関係。

- Tuxedoサービスからの応答とJMSキュー間の1対1の関係。

- WebLogic Integrationは、メッセージをJMSキューに書き込みます。

- メッセージがJMSキューに入ると、Tuxedoキュー・ブリッジは対象Tuxedoサービスにメッセージを移動します。

- メッセージは、XMLとFML32間で変換されます。

- 応答は、指定されたJMS応答キューに書き込まれます。

- WebLogic Integrationイベント・ノードは、応答メッセージの応答キューを待機します。

WebLogic IntegrationとTuxedoの非同期接続

WebLogic Integrationは、確認された非同期メッセージをTuxedo /Qに送信します。

- JMSキューとTuxedo /Q間の1対1の関係。

- WebLogic Integrationは、メッセージをJMSキューに書き込みます。

- メッセージがJMSキューに入ると、Tuxedoキュー・ブリッジはメッセージごとに対象Tuxedo /Qにメッセージを移動します。

- 次のようなエラー・メッセージは、指定したJMSエラー・キューに転送されます。

- インフラストラクチャ・エラー。

- XML/FML32変換エラー。

非同期Tuxedo /QとWebLogic Integrationの接続

Tuxedo /Qは、確認された非同期メッセージをWebLogic Integrationに送信します。

- JMSキューとTuxedo /Q間の1対1の関係。

- Tuxedoは、メッセージをTuxedo /Qに書き込みます。

- メッセージがTuxedo /Qでコミットされると、そのメッセージはTuxedo /T Domainゲートウェイを介してWebLogic Tuxedo Connector Tuxedoキュー・ブリッジおよび対象JMSキューに転送されます。

- Tuxedoから転送できないメッセージは、Tuxedo /Qエラー・キューに入れられます。

- 次のようなエラーのメッセージは、指定したTuxedo /Qエラー・キューに転送されます。

- インフラストラクチャ・エラー。

- FML32/XML変換エラー。

- JMSキューのメッセージを待機するワークフローが作成されます。これは、既存のワークフロー・インスタンスのStartワークフロー・ノードまたはEventノードで定義されます。

TuxedoとWebLogic Integrationの双方向非同期接続

Tuxedoは、WebLogic Integrationプロセス・フローのブロッキング呼出しを実行します。JMSからTuxedo /Qへ、およびTuxedo /QからJMSへ接続するには、2つの非同期インスタンスを使用します。

9 WebLogic Tuxedo Connectorのトラブルシューティング

この章では、WebLogic Tuxedo Connectorのトラブルシューティング情報について説明します。

- WebLogic Tuxedo Connectorのモニター

- よくある質問

WebLogic Tuxedo Connectorのモニター

WebLogic Tuxedo Connectorは、WebLogic Serverログ・ファイルを使用してログ情報を記録します。ログ情報を記録するには、次のことを行ってください。

- トレース・レベルの設定(非推奨)

- デバッグ・モードの有効化

- ユーザー・データのダンプの有効化

トレース・レベルの設定(非推奨)

TraceLevelがサポートされなくなったため、システム・デバッグを使用してください。デフォルトではすべてのデバッグ・トレースは無効になっています。デバッグの設定方法については、「システム・レベルのデバッグ設定」を参照してください。

WebLogic Serverのプロパティ設定の詳細は、「Oracle WebLogic Tuxedo Connectorプロパティの設定方法」を参照してください。

デバッグ・モードの有効化

ログ・ファイルにトレース情報を書き込む指定は、以下の手順で行います。

1. 左ペイン内で「サーバー」のノードをクリックします。

2. 左ペイン内で使用するサーバーを選択します。

3. 「ロギング」タブを選択します。

4. 「全般」タブをクリックします。

1. 「標準出力のロギングのリダイレクトを有効化」をクリックします。

2. 「標準出力」の「重大度」しきい値を「Info」に設定します。

ユーザー・データのダンプの有効化

ユーザー・データのダンプを有効化するには、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) +++++
......

よくある質問

この節では、よくあるユーザーからの質問に対する解決策について説明します。

このEJBデプロイメント・メッセージはどういう意味ですか?

simpservサンプルを構築すると、次のようなエラーが表示されます。

<date> <Error> <EJB> <EJB Deployment: Tolower has a class weblogic.wtc.jatmi.tpserviceHome which is in the classpath. This class should only be located in the ejb-jar file.>

このエラー・メッセージは、このリリースのWebLogic Tuxedo Connectorでは無視できます。EJBは、EJB jarファイルのEJB呼出しにすべてのインタフェースを要求します。しかし、WebLogic Tuxedo ConnectorのインタフェースのいくつかはCLASSPATHで実装されるため、コンパイラが例外を発生します。EJBをデプロイするとき、コンパイラはクラスのいくつかがCLASSPATHで検出されるために再デプロイできないことを示します。

コネクタはどのように起動するのですか?

WebLogic Server 7.0より前のリリースでは、WebLogic Tuxedo Connectorのセッションの開始にWebLogic Serverの起動クラスを、またセッションの終了にWebLogic Serverの停止クラスを使用していました。WebLogic Server 8.1以降では、WTCサービスを使用してWebLogic Tuxedo Connectorセッションが管理されます。

- WebLogic Tuxedo Connectorセッションは、構成済みのWTCサービスが、選択されたサーバーに割り当てられたときに開始します。

- WebLogic Tuxedo Connectorセッションは、WTCサービスがWebLogic Serverから削除されたとき、またはWebLogic Serverがシャットダウンされたときに終了します。

Tuxedoキュー・ブリッジはどのように起動するのですか?

Tuxedoキュー・ブリッジは、WTCサービスにTuxedoキュー・ブリッジおよびリダイレクトの構成が存在し、選択したサーバーにWTCサービスを割り当てる場合に開始されます。

WTCサービスをサーバーに割り当てるにはどのようにするのですか?

WTCサービスをサーバーに割当てようとすると、コンソールに例外メッセージが表示されます。どうすればよいでしょうか。

構成済みの有効なWTCサービスがあることを確認します。WTCサービスをサーバーに割り当てるには、各WTCサービスに1つ以上のローカルTuxedoアクセス・ポイントが構成されている必要があります。サーバーのログに、次のように表示されます。

<Apr 22, 2002 4:21:35 PM EDT> <Error> <WTC> <180101> <At least one local domain has to be defined.>

接続の問題はどのように解決するのですか?

Oracle WebLogic Tuxedo ConnectorとTuxedo間で接続の確立中に問題が発生します。どうすればよいでしょうか。

- Tuxedoサーバーが起動されていることを確認します。

- TraceLevelを設定し、デバッグ・モードを有効にします。接続テストを再度行い、WebLogic Tuxedo ConnectorとTuxedoログ・ファイルにエラー・メッセージがないかチェックします。

- マシン名やlocalhostの使用は避けます。ネットワークの位置を指定する場合には、必ずIPアドレスを使用します。

- AclPolicy属性とCredentialPolicy属性をチェックします。AclPolicyがLOCALなら、リモート・ドメインDOMAINIDをWebLogic Serverユーザーとして登録する必要があります。詳細は、第3.5項「ユーザー認証」を参照してください。

- WebLogic Server 6.xからの移行で、使用していたアプリケーションでセキュリティ機能を使用していた場合、PasswordKeyをWebLogic Serverプロパティとして設定する必要があります。詳細は、第2.2.5項「Oracle WebLogic Tuxedo Connectorプロパティの設定方法」を参照してください。

- Tuxedoリモート・ドメインに対するWebLogic Tuxedo Connector構成をチェックします。リモート・ドメインは、Oracle WebLogic Tuxedo Connectorで構成されたリモート・ドメインの名前と一致している必要があります。
たとえば、Tuxedo DMCONFIG *DM_LOCAL_DOMAINSセクションでsimpappという名前が構成されている場合、この名前はリモートTuxedoアクセス・ポイントのアクセス・ポイントID属性内の名前と一致している必要があります。

- BEAカスタマ・サポートに問い合わせます。

旧リリースからの移行はどのように行いますか?

詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverアップグレード・ガイド』を参照してください。

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2015, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

制限付権利

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。