20.3.2 メンバリソースアダプタ用DB Connectorの設定
メンバリソースアダプタ用DB Connectorを,次の手順で設定します。
-
メンバリソースアダプタ用のDB Connectorをインポートします。
-
プロパティを定義します。
-
メンバリソースアダプタ用のDB Connectorをデプロイします。
-
接続を確認します。
- 〈この項の構成〉
(1) メンバリソースアダプタ用のDB Connectorのインポート
次に示すコマンドを実行してメンバリソースアダプタ用のDB Connectorをインポートします。
(a) 実行形式
cjimportres [<サーバ名称>] [-nameserver <プロバイダURL>] -type rar -f <ファイルパス>
<ファイルパス>には,RARファイルを指定してください。
RARファイルは,次のディレクトリに格納されています。
-
Windowsの場合
<Application Serverのインストールディレクトリ>\CC\DBConnector\ClusterPool\
-
UNIXの場合
/opt/Cosminexus/CC/DBConnector/ClusterPool/
メンバリソースアダプタとしてインポートする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を停止した状態で実行してください。プロパティを定義する方法については,「20.3.2(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サーバを再起動してください。