uCosminexus 電子フォームワークフロー システム構築ガイド

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

7.5.6　リソースアダプタの設定

Web帳票アプリケーションとCSCIWManagementServerそれぞれで使用するリソースアダプタに必要な設定をします。リソースアダプタの設定は，Connector属性ファイルと呼ばれる属性ファイルを使用します。

なお，開発クライアントを構築する場合，この項の作業は不要です。

使用しているデータベースによって，コマンドの指定内容および実行結果が異なります。HiRDB，Oracle，またはSQL Serverを使用する場合に分けて，リソースアダプタの設定方法を説明します。

＜この項の構成＞
(1)　HiRDBの場合
(2)　Oracleの場合
(3)　SQL Serverの場合

(1)　HiRDBの場合

HiRDBを使用している場合のリソースアダプタの設定方法について説明します。

(a)　Connector属性ファイルの取得

次に示すConnector属性ファイルのテンプレートファイルをコピーして，Web帳票アプリケーションとCSCIWManagementServerのリソースアダプタのConnector属性ファイルをカレントディレクトリに取得します。

Connector属性ファイルのテンプレートファイル
<Cosminexusのインストールディレクトリ>\CC\admin\templates\DBConnector_HiRDB_Type4_CP_cfg.xml
(b)　Connector属性ファイルの編集

取得したConnector属性ファイルを次のとおり編集します。

表7-9　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
添付ファイルを利用する場合の設定については，マニュアル「uCosminexus 電子フォームワークフロー 解説」を参照してください。
注※3
環境のシステムリソースに合わせて設定してください。
なお，コネクション枯渇時の動作は，リソースアダプタのConnector属性ファイルのpropertyタグの設定値に依存します。
コネクション枯渇時のコネクション取得待ち行列を有効にするかどうか
RequestQueueEnable（デフォルト：True）
コネクション枯渇時のコネクション取得待ち行列のとどまることのできる時間の最大値
RequestQueueTimeout（デフォルト：30秒）
　
デフォルトの設定では，データベースアクセス処理でコネクションが枯渇した場合，コネクションが取得できるまで最大30秒の待ちが発生します。30秒以内にコネクションが取得できない場合はSQLエラーが発生します。
設定値の詳細については，マニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の<property>タグに指定できるプロパティについて記載されている個所を参照してください。
また，Cosminexusの同時実行スレッド数についても適切に設定してください。
同時実行スレッド数の詳細については，マニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のusrconf.properties（J2EEサーバ用ユーザプロパティファイル）のwebserver.connector.ajp13.max_threadsについて記載されている個所を参照してください。

Connector属性ファイルの編集例については，「付録D.1(1)　Connector属性ファイル（HiRDB）」を参照してください。

(c)　リソースアダプタのインポート

次のコマンド（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])
(d)　Connector属性ファイルの反映

編集したConnector属性ファイルの内容をリソースアダプタに反映します。Connector属性ファイルの反映が一つ終わったら，リソースアダプタを再度インポートしてください。リソースアダプタのインポート手順については，「(c)　リソースアダプタのインポート」を参照してください。

(e)　リソースアダプタのデプロイ

リソースアダプタをそれぞれデプロイします。

(f)　リソースアダプタの接続テスト

リソースアダプタが正常に接続できるかテストします。

(g)　リソースアダプタの開始

接続テストまで完了したら，次のコマンド（cjstartrar）を実行して，リソースアダプタを開始します。

(2)　Oracleの場合

Oracleを使用している場合のリソースアダプタの設定方法について説明します。

(a)　Connector属性ファイルの取得

次に示すConnector属性ファイルのテンプレートファイルをコピーして，Web帳票アプリケーションとCSCIWManagementServerのリソースアダプタのConnector属性ファイルをカレントディレクトリに取得します。

Connector属性ファイルのテンプレートファイル
<Cosminexusのインストールディレクトリ>\CC\admin\templates\DBConnector_Oracle_CP_cfg.xml
(b)　Connector属性ファイルの編集

取得したConnector属性ファイルを次のとおり編集します。リソースアダプタにOracle Thin Driverを使用する場合の設定については，マニュアル「Cosminexus V9 アプリケーションサーバ システム構築・運用ガイド」を参照してください。

表7-10　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 V9 アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の<property>タグに指定できるプロパティについて記載されている個所を参照してください。
また，Cosminexusの同時実行スレッド数についても適切に設定してください。
同時実行スレッド数の詳細については，マニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のusrconf.properties（J2EEサーバ用ユーザプロパティファイル）のwebserver.connector.ajp13.max_threadsについて記載されている個所を参照してください。

Connector属性ファイルの編集例については，「付録D.1(2)　Connector属性ファイル（Oracle）」を参照してください。

(c)　リソースアダプタのインポート

次のコマンド（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])
(d)　Connector属性ファイルの反映

編集したConnector属性ファイルの内容をリソースアダプタに反映します。Connector属性ファイルの反映が一つ終わったら，リソースアダプタを再度インポートしてください。リソースアダプタのインポート手順については，「(c)　リソースアダプタのインポート」を参照してください。

(e)　リソースアダプタのデプロイ

リソースアダプタをそれぞれデプロイします。

(f)　リソースアダプタの接続テスト

リソースアダプタが正常に接続できるかテストします。

(g)　リソースアダプタの開始

接続テストまで完了したら，次のコマンド（cjstartrar）を実行して，リソースアダプタを開始します。

(3)　SQL Serverの場合

SQL Serverを使用している場合のリソースアダプタの設定方法について説明します。

(a)　Connector属性ファイルの取得

次に示すConnector属性ファイルのテンプレートファイルをコピーして，Web帳票アプリケーションとCSCIWManagementServerのリソースアダプタのConnector属性ファイルをカレントディレクトリに取得します。

Connector属性ファイルのテンプレートファイル
<Cosminexusのインストールディレクトリ>\CC\admin\templates\DBConnector_SQLServer_CP_cfg.xml
(b)　Connector属性ファイルの編集

取得したConnector属性ファイルを次のとおり編集します。

表7-11　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 V9 アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の<property>タグに指定できるプロパティについて記載されている個所を参照してください。
また，Cosminexusの同時実行スレッド数についても適切に設定してください。
同時実行スレッド数の詳細については，マニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のusrconf.properties（J2EEサーバ用ユーザプロパティファイル）のwebserver.connector.ajp13.max_threadsについて記載されている個所を参照してください。

Connector属性ファイルの編集例については，「付録D.1(3)　Connector属性ファイル（SQL Server）」を参照してください。

(c)　リソースアダプタのインポート

次のコマンド（cjimportres）を実行して，Microsoft SQL Server 2005 JDBC Driverに対応するリソースアダプタをインポートします。

"%COSMINEXUS_HOME%\CC\admin\bin\cjimportres" J2EE_SERV -type rar -f "%COSMINEXUS_HOME%\CC\DBConnector\DBConnector_SQLServer_CP.rar"

コマンドを実行すると，次の実行結果が表示され，リソースアダプタのインポートが完了します。

KDJE37400-I Connecting to J2EE_SERV...
KDJE37404-I Importing DBConnector_for_SQLServer...
KDJE37501-I RAR has been imported successfully. (name = [DBConnector_for_SQLServer])
(d)　Connector属性ファイルの反映

編集したConnector属性ファイルの内容をリソースアダプタに反映します。Connector属性ファイルの反映が一つ終わったら，リソースアダプタを再度インポートしてください。リソースアダプタのインポート手順については，「(c)　リソースアダプタのインポート」を参照してください。

(e)　リソースアダプタのデプロイ

リソースアダプタをそれぞれデプロイします。

(f)　リソースアダプタの接続テスト

リソースアダプタが正常に接続できるかテストします。

(g)　リソースアダプタの開始

接続テストまで完了したら，次のコマンド（cjstartrar）を実行して，リソースアダプタを開始します。

[目次][前へ][次へ]

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2010, 2014, Hitachi, Ltd.