4.3.2 メンバリソースアダプタ用DB Connectorの設定

メンバリソースアダプタ用DB Connectorを,次の手順で設定します。

  1. メンバリソースアダプタ用のDB Connectorをインポートします。
  2. プロパティを定義します。
  3. メンバリソースアダプタ用のDB Connectorをデプロイします。
  4. 接続を確認します。
<この項の構成>
(1) メンバリソースアダプタ用のDB Connectorのインポート
(2) メンバリソースアダプタ用のDB Connectorのプロパティ定義
(3) メンバリソースアダプタ用のDB Connectorのデプロイ
(4) メンバリソースアダプタ用のDB Connectorの接続テスト

(1) メンバリソースアダプタ用のDB Connectorのインポート

次に示すコマンドを実行してメンバリソースアダプタ用のDB Connectorをインポートします。

実行形式

cjimportres [<サーバ名称>] [-nameserver <プロバイダURL>] [-nameserver <プロバイダURL>] -type rar -f <ファイルパス>

<ファイルパス>には,RARファイルを指定してください。

RARファイルは,次のディレクトリに格納されています。

メンバリソースアダプタとしてインポートするRARファイルについて説明します。

DBConnector_Oracle_CP_ClusterPool_Member.rar
クラスタコネクションプールのメンバリソースアダプタです。ローカルトランザクションまたはトランザクションなし(トランザクションサポートレベルにLocalTransactionまたはNoTransactionを指定する)で使用します。Oracle JDBC Thin DriverのConnectionPoolDataSourceを使用して,Oracleに接続します。
J2EEアプリケーションのリソースリファレンスに設定して使用することはできません。
実行例

cjimportres MyServer -type rar -f "c:¥Program Files¥Hitachi¥Cosminexus¥CC¥DBConnector¥ClusterPool¥DBConnector_Oracle_CP_ClusterPool_Member.rar"

cjimportresコマンドの詳細については,マニュアル「Cosminexus リファレンス コマンド編」を参照してください。

(2) メンバリソースアダプタ用のDB Connectorのプロパティ定義

メンバリソースアダプタ用のDB Connectorのプロパティを定義します。プロパティを定義する手順については,「4.2.2 DB Connectorのプロパティ定義」を参照してください。ここでは,メンバリソースアダプタ用のDB Connectorのプロパティの設定項目を説明します。

(a) メンバリソースアダプタ用DB Connectorの一般情報

設定できるDB Connectorの一般情報属性(<outbound-resourceadapter>タグ)の設定項目を次に示します。

項目必須対応するタグ
トランザクションサポートのレベル<transaction-support>
再認証のサポート有無<reauthentication-support>

(凡例) ○:必須

注※ 一つのクラスタコネクションプールを構成するメンバリソースアダプタのトランザクションサポートレベルは,すべて同じにしてください。


プロパティの設定項目の説明については,マニュアル「Cosminexus リファレンス 定義編」を参照してください。

(b) メンバリソースアダプタ用コンフィグレーションプロパティ

メンバリソースアダプタ用DB Connectorのコンフィグレーションプロパティ(<config-property>タグ)と設定内容は,対応するリソースアダプタ(DBConnector_Oracle_CP.rar)と同じです。対応するリソースアダプタのコンフィグレーションプロパティについては,「4.2.2 DB Connectorのプロパティ定義」を参照してください。

(c) 実行時プロパティ

メンバリソースアダプタ用DB Connectorの実行時プロパティ(<outbound-resourceadapter> - <connection-definition> - <connector-runtime>タグ)の設定項目を次に示します。

項目対応するタグ
プロパティ名<property-name>
プロパティのデータ型<property-type>
プロパティの値<property-value>

定義するプロパティの数だけ,上記の設定を繰り返してください。

プロパティ名(<property-name>)には,次の項目を設定します。

プロパティ項目プロパティ名(<property-name>)の設定項目
ユーザ名User
パスワードPassword
コネクションプールにプールするコネクションの最小値MinPoolSize
コネクションプールにプールするコネクションの最大値MaxPoolSize
ログを出力するかどうかの選択LogEnabled
コネクションの最終利用時刻から,コネクションを自動破棄(コネクションスイーパ)するかを判定するまでの時間ConnectionTimeout
コネクションの自動破棄(コネクションスイーパ)が動作する間隔SweeperInterval
コネクション枯渇時のコネクション取得要求をキューで管理する場合の待ち時間の最大値RequestQueueTimeout
コネクションプールを監視するかどうかの選択WatchEnabled
コネクションプールを監視する間隔WatchInterval
コネクションプール使用状態を監視するしきい値WatchThreshold
コネクションプール監視結果のファイルを出力するかどうかの選択WatchWriteFileEnabled
コネクション数調節機能が動作する間隔ConnectionPoolAdjustmentInterval
コネクションプールのウォーミングアップ機能を有効にするかどうかの選択Warmup

注※ 一つのクラスタコネクションプールを構成するメンバリソースアダプタのユーザ名は,すべて同じにしてください。


注意事項
メンバリソースアダプタでは,次の項目は設定の有無に関係なく,常に「有効」になります。
プロパティ項目有効値プロパティ名(<property-name>)の設定項目
コネクションプールにプールするコネクションの最小値コネクションプーリング機能は常に有効
「MinPoolSize」,「MaxPoolSize」に「0」を設定しても,デフォルト値の「10」が仮定されます。
MinPoolSize
コネクションプールにプールするコネクションの最大値MaxPoolSize
プール内のコネクションに障害が発生しているかどうかをチェックする方法の選択常に「1」(コネクション取得時の障害検知)ValidationType
コネクション枯渇時にコネクション取得要求をキューで管理するかどうかの選択常に「true」RequestQueueEnable
ネットワーク障害検知機能のタイムアウトを有効にするかどうかの選択常に「true」NetworkFailureTimeout
また,実行時プロパティのコネクションリトライ回数(「RetryCount」)とコネクションリトライ待ち時間(「RetryInterval」)の設定に関係なく,コネクション取得リトライ機能は,常に無効となります。

(3) メンバリソースアダプタ用のDB Connectorのデプロイ

メンバリソースアダプタ用のDB Connectorは,デプロイするとJ2EEリソースアダプタとして使用できます。なお,デプロイしたあとで,プロパティを定義することもできます。デプロイ後に定義する場合は,該当するメンバリソースアダプタ用のDB Connectorが所属するルートリソースアダプタと,メンバリソースアダプタ用のDB Connectorを停止した状態で実行してください。プロパティを定義する方法については,「(2) メンバリソースアダプタ用のDB Connectorのプロパティ定義」を参照してください。

次に示すコマンドを実行してメンバリソースアダプタ用のDB Connectorをデプロイします。

実行形式

cjdeployrar [<サーバ名称>] [-nameserver <プロバイダURL>] -resname <メンバリソースアダプタ用のDB Connector表示名>

実行例

cjdeployrar MyServer -resname DB_Connector_for_Oracle_ClusterPool_Member

cjdeployrarコマンドの詳細については,マニュアル「Cosminexus リファレンス コマンド編」を参照してください。

(4) メンバリソースアダプタ用のDB Connectorの接続テスト

メンバリソースアダプタ用のDB Connectorに設定した情報が正しいかどうか,接続テストで検証します。

次に示すコマンドを実行して,メンバリソースアダプタ用のDB Connectorの接続テストを実施します。

実行形式

cjtestres [<サーバ名称>] [-nameserver <プロバイダURL>] -type rar -resname <メンバリソースアダプタ用のDB Connectorの表示名>

実行例

cjtestres -type rar -resname DB_Connector_for_Oracle_ClusterPool_Member

cjtestresコマンドの詳細については,マニュアル「Cosminexus リファレンス コマンド編」を参照してください。

注意事項
一度接続テストをしたメンバリソースアダプタ用のDB Connectorは,J2EEサーバを再起動するまで削除できません。メンバリソースアダプタ用のDB Connectorを削除する場合は,そのメンバリソースアダプタ用のDB Connectorが所属するルートリソースアダプタとメンバリソースアダプタ用のDB Connectorを停止してから,J2EEサーバを再起動してください。