4.6.10 リソースアダプタの設定
Web帳票アプリケーションとCSCIWManagementServerそれぞれで使用するリソースアダプタに必要な設定をします。リソースアダプタの設定は,Connector属性ファイルと呼ばれる属性ファイルを使用します。
使用しているデータベースによって,コマンドの指定内容および実行結果が異なります。HiRDB,Oracle,またはSQL Serverを使用する場合に分けて,リソースアダプタの設定方法を説明します。
- <この項の構成>
- (1) HiRDBの場合
- (2) Oracleの場合
- (3) SQL Serverの場合
(1) HiRDBの場合
HiRDBを使用している場合のリソースアダプタの設定方法について説明します。
(a) リソースアダプタのインポート
次のコマンド(cjimportres)を実行して,HiRDB Type4 Driverに対応するリソースアダプタをインポートします。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjimportres" J2EE_SERV -type rar -f "%COSMINEXUS_HOME%¥CC¥DBConnector¥DBConnector_HiRDB_Type4_CP.rar" |
コマンドを実行すると,次の実行結果が表示され,リソースアダプタのインポートが完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37404-I Importing DB_Connector_for_HiRDB_Type4...
KDJE37501-I RAR has been imported successfully. (name = [DB_Connector_for_HiRDB_Type4]) |
(b) Connector属性ファイルの取得
次に示すConnector属性ファイルをカレントディレクトリに取得します。
- Web帳票アプリケーション用リソースアダプタのConnector属性ファイル
- 名称
- 次に示す名称で取得します。
- MyDBConnector_Executer_Attr.xml
- コマンドの実行例
- 次のコマンド(cjgetresprop)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjgetresprop" J2EE_SERV -type rar -resname DB_Connector_for_HiRDB_Type4 -c MyDBConnector_Executer_Attr.xml |
- コマンドの実行結果
- コマンドを実行すると,次の実行結果が表示され,Connector属性ファイルの取得が完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_HiRDB_Type4...
KDJE37408-I Acquiring DB_Connector_for_HiRDB_Type4...
KDJE37505-I RAR has been obtained successfully. (name = [DB_Connector_for_HiRDB_Type4]) |
- CSCIWManagementServer用リソースアダプタのConnector属性ファイル
取得したWeb帳票アプリケーション用リソースアダプタのConnector属性ファイル(MyDBConnector_Executer_Attr.xml)をコピーして,次の名称に変更します。
- 名称
- MyDBConnector_Manager_Attr.xml
(c) Connector属性ファイルの編集
取得したConnector属性ファイルを次のとおり編集します。
表4-11 Connector属性ファイルの設定値(HiRDB)
設定項目 | 設定値 | 設定内容 |
---|
Web帳票アプリケーション用リソースアダプタの場合 | CSCIWManagementServer用リソースアダプタの場合 |
---|
display-name | DB_Connector_for_Executer | DB_Connector_for_Manager | リソースアダプタの表示名 |
description | <HiRDBのポート番号> | HiRDBのポート番号 |
DBHostName | <HiRDBのホスト名> | HiRDBのホスト名 |
encodeLang | -※1 | 文字コード |
LONGVARBINARY_Access | LOCATOR※2 | データベースアクセスの型 |
User | BLC | ユーザ名 |
Password | BLC | パスワード |
MinPoolSize | 20※3 | 1 | コネクションプールの最小値 |
MaxPoolSize | 20※3 | 1 | コネクションプールの最大値 |
- 注※1
- データベースでUTF-8を使用する場合は,UTF-8を指定します。
- 注※2
- 添付ファイルを利用する場合の設定については,マニュアル「Hitachi Business Logic - Container 2」を参照してください。
- 注※3
- 環境のシステムリソースに合わせて設定してください。
- なお,コネクション枯渇時の動作は,リソースアダプタのConnector属性ファイルのpropertyタグの設定値に依存します。
- コネクション枯渇時のコネクション取得待ち行列を有効にするかどうか
- RequestQueueEnable(デフォルト:True)
- コネクション枯渇時のコネクション取得待ち行列のとどまることのできる時間の最大値
- RequestQueueTimeout(デフォルト:30秒)
- デフォルトの設定では,データベースアクセス処理でコネクションが枯渇した場合,コネクションが取得できるまで最大30秒の待ちが発生します。30秒以内にコネクションが取得できない場合はSQLエラーが発生します。
- 設定値の詳細については,マニュアル「Cosminexus リファレンス 定義編」の<property>タグに指定できるプロパティについて記載されている個所を参照してください。
- また,Cosminexusの同時実行スレッド数についても適切に設定してください。
- 同時実行スレッド数の詳細については,マニュアル「Cosminexus リファレンス 定義編」のusrconf.properties(J2EEサーバ用ユーザプロパティファイル)のwebserver.connector.ajp13.max_threadsについて記載されている個所を参照してください。
Connector属性ファイルの編集例については,「付録D.1(1) Connector属性ファイル(HiRDB)」を参照してください。
(d) Connector属性ファイルの反映
編集したConnector属性ファイルの内容をリソースアダプタに反映します。Connector属性ファイルの反映が一つ終わったら,リソースアダプタを再度インポートしてください。リソースアダプタのインポート手順については,「(a) リソースアダプタのインポート」を参照してください。
- Web帳票アプリケーション用リソースアダプタのConnector属性ファイル
- コマンドの実行例
- 次のコマンド(cjsetresprop)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjsetresprop" J2EE_SERV -type rar -resname DB_Connector_for_HiRDB_Type4 -c MyDBConnector_Executer_Attr.xml |
- コマンドの実行結果
- コマンドを実行すると,次の実行結果が表示され,リソースアダプタへの反映が完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_HiRDB_Type4...
KDJE37409-I Setting DB_Connector_for_HiRDB_Type4...
KDJE37506-I RAR has been set successfully. (name = [DB_Connector_for_HiRDB_Type4]) |
- CSCIWManagementServer用リソースアダプタのConnector属性ファイル
- コマンドの実行例
- 次のコマンド(cjsetresprop)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjsetresprop" J2EE_SERV -type rar -resname DB_Connector_for_HiRDB_Type4 -c MyDBConnector_Manager_Attr.xml |
- コマンドの実行結果
- コマンドを実行すると,次の実行結果が表示され,リソースアダプタへの反映が完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_HiRDB_Type4...
KDJE37409-I Setting DB_Connector_for_HiRDB_Type4...
KDJE37506-I RAR has been set successfully. (name = [DB_Connector_for_HiRDB_Type4]) |
(e) リソースアダプタのデプロイ
リソースアダプタをそれぞれデプロイします。
- Web帳票アプリケーション用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjdeployrar)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjdeployrar" J2EE_SERV -resname DB_Connector_for_Executer |
- コマンドの実行結果
- コマンドを実行すると,次の実行結果が表示され,デプロイが完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Executer...
KDJE37421-I Deploying DB_Connector_for_Executer...
KDJE37521-I RAR has been deployed successfully. (name = [DB_Connector_for_Executer]) |
- CSCIWManagementServer用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjdeployrar)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjdeployrar" J2EE_SERV -resname DB_Connector_for_Manager |
- コマンドの実行結果
- コマンドを実行すると,次の実行結果が表示され,デプロイが完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Manager...
KDJE37421-I Deploying DB_Connector_for_Manager...
KDJE37521-I RAR has been deployed successfully. (name = [DB_Connector_for_Manager]) |
(f) リソースアダプタの接続テスト
リソースアダプタが正常に接続できるかテストします。
- Web帳票アプリケーション用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjtestres)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjtestres" J2EE_SERV -type rar -resname DB_Connector_for_Executer |
- コマンドの実行結果
- コマンド実行後,次のように表示されれば,正常に接続できています。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Executer...
KDJE37411-I Testing RAR of DB_Connector_for_Executer...
KDJE37510-I RAR of DB_Connector_for_Executer has been tested successfully. Name= [DB_Connector_for_Executer] |
- CSCIWManagementServer用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjtestres)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjtestres" J2EE_SERV -type rar -resname DB_Connector_for_Manager |
- コマンドの実行結果
- コマンド実行後,次のように表示されれば,正常に接続できています。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Manager...
KDJE37411-I Testing RAR of DB_Connector_for_Manager...
KDJE37510-I RAR of DB_Connector_for_Manager has been tested successfully. Name= [DB_Connector_for_Manager] |
(g) リソースアダプタの開始
接続テストまで完了したら,次のコマンド(cjstartrar)を実行して,リソースアダプタを開始します。
- Web帳票アプリケーション用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjstartrar)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjstartrar" J2EE_SERV -resname DB_Connector_for_Executer |
- コマンドの実行結果
- コマンド実行後,次のように表示されれば,正常に接続できています。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Executer...
KDJE37423-I Starting DB_Connector_for_Executer...
KDJE37523-I RAR has started successfully. (name = [DB_Connector_for_Executer]) |
- CSCIWManagementServer用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjstartrar)実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjstartrar" J2EE_SERV -resname DB_Connector_for_Manager |
- コマンドの実行結果
- コマンド実行後,次のように表示されれば,正常に接続できています。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Manager...
KDJE37423-I Starting DB_Connector_for_Manager...
KDJE37523-I RAR has started successfully. (name = [DB_Connector_for_Manager]) |
(2) Oracleの場合
Oracleを使用している場合のリソースアダプタの設定方法について説明します。
(a) リソースアダプタのインポート
次のコマンド(cjimportres)を実行して,Oracle JDBC Thin Driverに対応するリソースアダプタをインポートします。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjimportres" J2EE_SERV -type rar -f "%COSMINEXUS_HOME%¥CC¥DBConnector¥DBConnector_Oracle_CP.rar" |
コマンドを実行すると,次の実行結果が表示され,リソースアダプタのインポートが完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37404-I Importing DB_Connector_for_Oracle...
KDJE37501-I RAR has been imported successfully. (name = [DB_Connector_for_Oracle]) |
(b) Connector属性ファイルの取得
次に示すConnector属性ファイルをカレントディレクトリに取得します。
- Web帳票アプリケーション用リソースアダプタのConnector属性ファイル
- 名称
- 次に示す名称で取得します。
- MyDBConnector_Executer_Attr.xml
- コマンドの実行例
- 次のコマンド(cjgetresprop)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjgetresprop" J2EE_SERV -type rar -resname DB_Connector_for_Oracle -c MyDBConnector_Executer_Attr.xml |
- コマンドの実行結果
- コマンドを実行すると,次の実行結果が表示され,Connector属性ファイルの取得が完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Oracle...
KDJE37408-I Acquiring DB_Connector_for_Oracle...
KDJE37505-I RAR has been obtained successfully. (name = [DB_Connector_for_Oracle]) |
- CSCIWManagementServer用リソースアダプタのConnector属性ファイル
- 取得したWeb帳票アプリケーション用リソースアダプタのConnector属性ファイル(MyDBConnector_Executer_Attr.xml)をコピーして,次の名称に変更します。
- 名称
- MyDBConnector_Manager_Attr.xml
(c) Connector属性ファイルの編集
取得したConnector属性ファイルを次のとおり編集します。リソースアダプタにOracle Thin Driverを使用する場合の設定については,マニュアル「Cosminexus 簡易構築・運用ガイド」を参照してください。
表4-12 Connector属性ファイルの設定値(Oracle)
設定項目 | 設定値 | 設定内容 |
---|
Web帳票アプリケーション用リソースアダプタの場合 | CSCIWManagementServer用リソースアダプタの場合 |
---|
display-name | DB_Connector_for_Executer | DB_Connector_for_Manager | リソースアダプタの表示名 |
databaseName | BLCDB | データベース名 |
serverName | <Oracleのホスト名またはIPアドレス> | Oracleのホスト名 |
portNumber | 1521 | Oracleのポート番号 |
User | BLC | ユーザ名 |
Password | BLC | パスワード |
MinPoolSize | 20※ | 1 | コネクションプールの最小値 |
MaxPoolSize | 20※ | 1 | コネクションプールの最大値 |
- 注※
- 環境のシステムリソースに合わせて設定してください。
- なお,コネクション枯渇時の動作は,リソースアダプタのConnector属性ファイルのpropertyタグの設定値に依存します。
- コネクション枯渇時のコネクション取得待ち行列を有効にするかどうか
- RequestQueueEnable(デフォルト:True)
- コネクション枯渇時のコネクション取得待ち行列のとどまることのできる時間の最大値
- RequestQueueTimeout(デフォルト:30秒)
- デフォルトの設定では,データベースアクセス処理でコネクションが枯渇した場合,コネクションが取得できるまで最大30秒の待ちが発生します。30秒以内にコネクションが取得できない場合はSQLエラーが発生します。
- 設定値の詳細については,マニュアル「Cosminexus リファレンス 定義編」の<property>タグに指定できるプロパティについて記載されている個所を参照してください。
- また,Cosminexusの同時実行スレッド数についても適切に設定してください。
- 同時実行スレッド数の詳細については,マニュアル「Cosminexus リファレンス 定義編」のusrconf.properties(J2EEサーバ用ユーザプロパティファイル)のwebserver.connector.ajp13.max_threadsについて記載されている個所を参照してください。
Connector属性ファイルの編集例については,「付録D.1(2) Connector属性ファイル(Oracle)」を参照してください。
(d) Connector属性ファイルの反映
編集したConnector属性ファイルの内容をリソースアダプタに反映します。Connector属性ファイルの反映が一つ終わったら,リソースアダプタを再度インポートしてください。リソースアダプタのインポート手順については,「(a) リソースアダプタのインポート」を参照してください。
- Web帳票アプリケーション用リソースアダプタのConnector属性ファイル
- コマンドの実行例
- 次のコマンド(cjsetresprop)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjsetresprop" J2EE_SERV -type rar -resname DB_Connector_for_Oracle -c MyDBConnector_Executer_Attr.xml |
- コマンドの実行結果
- コマンドを実行すると,次の実行結果が表示され,リソースアダプタへの反映が完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Oracle...
KDJE37409-I Setting DB_Connector_for_Oracle...
KDJE37506-I RAR has been set successfully. (name = [DB_Connector_for_Oracle]) |
- CSCIWManagementServer用リソースアダプタのConnector属性ファイル
- コマンドの実行例
- 次のコマンド(cjsetresprop)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjsetresprop" J2EE_SERV -type rar -resname DB_Connector_for_Oracle -c MyDBConnector_Manager_Attr.xml |
- コマンドの実行結果
- コマンドを実行すると,次の実行結果が表示され,リソースアダプタへの反映が完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Oracle...
KDJE37409-I Setting DB_Connector_for_Oracle...
KDJE37506-I RAR has been set successfully. (name = [DB_Connector_for_Oracle]) |
(e) リソースアダプタのデプロイ
リソースアダプタをそれぞれデプロイします。
- Web帳票アプリケーション用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjdeployrar)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjdeployrar" J2EE_SERV -resname DB_Connector_for_Executer |
- コマンドの実行結果
- コマンドを実行すると,次の実行結果が表示され,デプロイが完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Executer...
KDJE37421-I Deploying DB_Connector_for_Executer...
KDJE37521-I RAR has been deployed successfully. (name = [DB_Connector_for_Executer]) |
- CSCIWManagementServer用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjdeployrar)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjdeployrar" J2EE_SERV -resname DB_Connector_for_Manager |
- コマンドの実行結果
- コマンドを実行すると,次の実行結果が表示され,デプロイが完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Manager...
KDJE37421-I Deploying DB_Connector_for_Manager...
KDJE37521-I RAR has been deployed successfully. (name = [DB_Connector_for_Manager]) |
(f) リソースアダプタの接続テスト
リソースアダプタが正常に接続できるかテストします。
- Web帳票アプリケーション用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjtestres)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjtestres" J2EE_SERV -type rar -resname DB_Connector_for_Executer |
- コマンドの実行結果
- コマンド実行後,次のように表示されれば,正常に接続できています。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Executer...
KDJE37411-I Testing RAR of DB_Connector_for_Executer...
KDJE37510-I RAR of DB_Connector_for_Executer has been tested successfully. Name= [DB_Connector_for_Executer] |
- CSCIWManagementServer用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjtestres)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjtestres" J2EE_SERV -type rar -resname DB_Connector_for_Manager |
- コマンドの実行結果
- コマンド実行後,次のように表示されれば,正常に接続できています。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Manager...
KDJE37411-I Testing RAR of DB_Connector_for_Manager...
KDJE37510-I RAR of DB_Connector_for_Manager has been tested successfully. Name= [DB_Connector_for_Manager] |
(g) リソースアダプタの開始
接続テストまで完了したら,次のコマンド(cjstartrar)を実行して,リソースアダプタを開始します。
- Web帳票アプリケーション用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjstartrar)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjstartrar" J2EE_SERV -resname DB_Connector_for_Executer |
- コマンドの実行結果
- コマンド実行後,次のように表示されれば,正常に接続できています。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Executer...
KDJE37423-I Starting DB_Connector_for_Executer...
KDJE37523-I RAR has started successfully. (name = [DB_Connector_for_Executer]) |
- CSCIWManagementServer用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjstartrar)実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjstartrar" J2EE_SERV -resname DB_Connector_for_Manager |
- コマンドの実行結果
- コマンド実行後,次のように表示されれば,正常に接続できています。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Manager...
KDJE37423-I Starting DB_Connector_for_Manager...
KDJE37523-I RAR has started successfully. (name = [DB_Connector_for_Manager]) |
(3) SQL Serverの場合
SQL Serverを使用している場合のリソースアダプタの設定方法について説明します。
(a) リソースアダプタのインポート
次のコマンド(cjimportres)を実行して,Microsoft SQL Server 2005 JDBC Driverに対応するリソースアダプタをインポートします。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjimportres" J2EE_SERV -type rar -f "%COSMINEXUS_HOME%¥CC¥DBConnector¥DBConnector_SQLServer2005_CP.rar" |
コマンドを実行すると,次の実行結果が表示され,リソースアダプタのインポートが完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37404-I Importing DBConnector_for_SQLServer2005...
KDJE37501-I RAR has been imported successfully. (name = [DBConnector_for_SQLServer2005]) |
(b) Connector属性ファイルの取得
次に示すConnector属性ファイルをカレントディレクトリに取得します。
- Web帳票アプリケーション用リソースアダプタのConnector属性ファイル
- 名称
- 次に示す名称で取得します。
- MyDBConnector_Executer_Attr.xml
- コマンドの実行例
- 次のコマンド(cjgetresprop)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjgetresprop" J2EE_SERV -type rar -resname DB_Connector_for_SQLServer2005 -c MyDBConnector_Executer_Attr.xml |
- コマンドの実行結果
- コマンドを実行すると,次の実行結果が表示され,Connector属性ファイルの取得が完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DBConnector_for_SQLServer2005...
KDJE37408-I Acquiring DBConnector_for_SQLServer2005...
KDJE37505-I RAR has been obtained successfully. (name = [DB_Connector_for_SQLServer2005]) |
- CSCIWManagementServer用のリソースアダプタのConnector属性ファイル
- 取得したWeb帳票アプリケーション用リソースアダプタのConnector属性ファイル(MyDBConnector_Executer_Attr.xml)をコピーして,次の名称に変更します。
- 名称
- MyDBConnector_Manager_Attr.xml
(c) Connector属性ファイルの編集
取得したConnector属性ファイルを次のとおり編集します。
表4-13 Connector属性ファイルの設定値(SQL Server)
設定項目 | 設定値 | 設定内容 |
---|
Web帳票アプリケーション用リソースアダプタの場合 | CSCIWManagementServer用リソースアダプタの場合 |
---|
display-name | DB_Connector_for_Executer | DB_Connector_for_Manager | リソースアダプタの表示名 |
databaseName | BLCDB | データベース名 |
serverName | <SQL Serverのホスト名またはIPアドレス> | SQL Serverのホスト名 |
portNumber | 1433 | SQL Serverのポート番号 |
User | BLC | ユーザ名 |
Password | BLC | パスワード |
MinPoolSize | 20※ | 1 | コネクションプールの最小値 |
MaxPoolSize | 20※ | 1 | コネクションプールの最大値 |
- 注※
- 環境のシステムリソースに合わせて設定してください。
- なお,コネクション枯渇時の動作は,リソースアダプタのConnector属性ファイルのpropertyタグの設定値に依存します。
- コネクション枯渇時のコネクション取得待ち行列を有効にするかどうか
- RequestQueueEnable(デフォルト:True)
- コネクション枯渇時のコネクション取得待ち行列のとどまることのできる時間の最大値
- RequestQueueTimeout(デフォルト:30秒)
- デフォルトの設定では,データベースアクセス処理でコネクションが枯渇した場合,コネクションが取得できるまで最大30秒の待ちが発生します。30秒以内にコネクションが取得できない場合はSQLエラーが発生します。
- 設定値の詳細については,マニュアル「Cosminexus リファレンス 定義編」の<property>タグに指定できるプロパティについて記載されている個所を参照してください。
- また,Cosminexusの同時実行スレッド数についても適切に設定してください。
- 同時実行スレッド数の詳細については,マニュアル「Cosminexus リファレンス 定義編」のusrconf.properties(J2EEサーバ用ユーザプロパティファイル)のwebserver.connector.ajp13.max_threadsについて記載されている個所を参照してください。
Connector属性ファイルの編集例については,「付録D.1(3) Connector属性ファイル(SQL Server)」を参照してください。
(d) Connector属性ファイルの反映
編集したConnector属性ファイルの内容をリソースアダプタに反映します。Connector属性ファイルの反映が一つ終わったら,リソースアダプタを再度インポートしてください。リソースアダプタのインポート手順については,「(a) リソースアダプタのインポート」を参照してください。
- Web帳票アプリケーション用リソースアダプタのConnector属性ファイル
- コマンドの実行例
- 次のコマンド(cjsetresprop)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjsetresprop" J2EE_SERV -type rar -resname DB_Connector_for_SQLServer2005 -c MyDBConnector_Executer_Attr.xml |
- コマンドの実行結果
- コマンドを実行すると,次の実行結果が表示され,リソースアダプタへの反映が完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_SQLServer2005...
KDJE37409-I Setting DB_Connector_for_SQLServer2005...
KDJE37506-I RAR has been set successfully. (name = [DB_Connector_for_SQLServer2005]) |
- CSCIWManagementServer用リソースアダプタのConnector属性ファイル
- コマンドの実行例
- 次のコマンド(cjsetresprop)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjsetresprop" J2EE_SERV -type rar -resname DB_Connector_for_SQLServer2005 -c MyDBConnector_Manager_Attr.xml |
- コマンドの実行結果
- コマンドを実行すると,次の実行結果が表示され,リソースアダプタへの反映が完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_SQLServer2005...
KDJE37409-I Setting DB_Connector_for_SQLServer2005...
KDJE37506-I RAR has been set successfully. (name = [DB_Connector_for_SQLServer2005]) |
(e) リソースアダプタのデプロイ
リソースアダプタをそれぞれデプロイします。
- Web帳票アプリケーション用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjdeployrar)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjdeployrar" J2EE_SERV -resname DB_Connector_for_Executer |
- コマンドの実行結果
- コマンドを実行すると,次の実行結果が表示され,デプロイが完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Executer...
KDJE37421-I Deploying DB_Connector_for_Executer...
KDJE37521-I RAR has been deployed successfully. (name = [DB_Connector_for_Executer]) |
- CSCIWManagementServer用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjdeployrar)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjdeployrar" J2EE_SERV -resname DB_Connector_for_Manager |
- コマンドの実行結果
- コマンドを実行すると,次の実行結果が表示され,デプロイが完了します。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Manager...
KDJE37421-I Deploying DB_Connector_for_Manager...
KDJE37521-I RAR has been deployed successfully. (name = [DB_Connector_for_Manager]) |
(f) リソースアダプタの接続テスト
リソースアダプタが正常に接続できるかテストします。
- Web帳票アプリケーション用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjtestres)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjtestres" J2EE_SERV -type rar -resname DB_Connector_for_Executer |
- コマンドの実行結果
- コマンド実行後,次のように表示されれば,正常に接続できています。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Executer...
KDJE37411-I Testing RAR of DB_Connector_for_Executer...
KDJE37510-I RAR of DB_Connector_for_Executer has been tested successfully. Name= [DB_Connector_for_Executer] |
- CSCIWManagementServer用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjtestres)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjtestres" J2EE_SERV -type rar -resname DB_Connector_for_Manager |
- コマンドの実行結果
- コマンド実行後,次のように表示されれば,正常に接続できています。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Manager...
KDJE37411-I Testing RAR of DB_Connector_for_Manager...
KDJE37510-I RAR of DB_Connector_for_Manager has been tested successfully. Name= [DB_Connector_for_Manager] |
(g) リソースアダプタの開始
接続テストまで完了したら,次のコマンド(cjstartrar)を実行して,リソースアダプタを開始します。
- Web帳票アプリケーション用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjstartrar)を実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjstartrar" J2EE_SERV -resname DB_Connector_for_Executer |
- コマンドの実行結果
- コマンド実行後,次のように表示されれば,正常に接続できています。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Executer...
KDJE37423-I Starting DB_Connector_for_Executer...
KDJE37523-I RAR has started successfully. (name = [DB_Connector_for_Executer]) |
- CSCIWManagementServer用リソースアダプタ
- コマンドの実行例
- 次のコマンド(cjstartrar)実行します。
"%COSMINEXUS_HOME%¥CC¥admin¥bin¥cjstartrar" J2EE_SERV -resname DB_Connector_for_Manager |
- コマンドの実行結果
- コマンド実行後,次のように表示されれば,正常に接続できています。
KDJE37400-I Connecting to J2EE_SERV...
KDJE37401-I Searching DB_Connector_for_Manager...
KDJE37423-I Starting DB_Connector_for_Manager...
KDJE37523-I RAR has started successfully. (name = [DB_Connector_for_Manager]) |