Cosminexus V9 アプリケーションサーバ アプリケーション設定操作ガイド

[目次][索引][前へ][次へ]

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をインポートします。

(a) 実行形式

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

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

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

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

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

cjimportresコマンドの詳細については,マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjimportres(リソースのインポート)」を参照してください。

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

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

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

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

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

(凡例) ○:必須

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


プロパティの設定項目については,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1.1 Connector属性ファイルの指定内容」を参照してください。

(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コマンドの詳細については,マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjdeployrar(リソースアダプタのデプロイ)」を参照してください。

(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コマンドの詳細については,マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjtestres(リソースの接続テスト)」を参照してください。

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