3.1.2 実行環境に必要なソフトウェアを設定する
実行環境をセットアップする前に,実行環境に必要なソフトウェアの設定が必要です。実行環境に必要なソフトウェアの設定は,データベースとReliable Messagingの使用有無によって,次のように設定内容が異なります。
-
データベースを使用してReliable Messagingを使用しない場合
実行環境に必要なソフトウェアの設定の流れと,参照先を次の図に示します。
図3‒2 実行環境に必要なソフトウェアの設定(データベースを使用してReliable Messagingを使用しない場合) -
データベースとReliable Messagingの両方を使用する場合
実行環境に必要なソフトウェアの設定の流れと,参照先を次の図に示します。
図3‒3 実行環境に必要なソフトウェアの設定(データベースとReliable Messagingの両方を使用する場合) -
データベースとReliable Messagingの両方を使用しない場合
実行環境に必要なソフトウェアの設定の流れと,参照先を次の図に示します。
図3‒4 実行環境に必要なソフトウェアの設定(データベースとReliable Messagingの両方を使用しない場合)
実行環境のセットアップ前に実施するソフトウェアの設定について,次に説明します。
- 〈この項の構成〉
-
(1) データベースのサーバ側のセットアップ
データベースのセットアップとして,DBサーバおよびDBクライアントの両方をセットアップします。
(a) DBサーバ側の設定(HiRDBの場合)
次の作業を実施します。
- HiRDBサーバの文字コードの設定
-
文字コードにシフトJIS漢字コード,EUC日本語漢字コード,UTF-8,または単一バイト文字コードのどれかを設定してください。文字コードの変更方法は,マニュアル「HiRDB システム導入・設計ガイド」の文字コードの指定,または文字コードの選択に関する内容を参照してください。
- 注意事項
-
HCSCサーバをUNIXで稼働させる場合は,HCSCサーバとHiRDBサーバの文字コードを合わせる必要があります。
- 環境設定
-
HiRDBの環境設定についてはマニュアル「HiRDB システム導入・設計ガイド」を参照してください。
- ユーザ権限の設定
-
最初に,接続するユーザの名称を決定します。そのあと,HiRDBに管理情報を格納するため,HiRDBに接続するユーザに権限を設定します。HiRDBでは,ユーザにCONNECT権限を設定することでユーザが作成されます。
- 設定する権限
-
-
CONNECT権限
HiRDBを利用するために必要な権限です。データベースに接続(CONNECT)できるようになります。CONNECT権限を持たないユーザがHiRDBを利用しようとするとエラーになります。
-
スキーマ定義権限
スキーマを定義するために必要な権限です。スキーマ定義権限を設定すると,スキーマ,表,ビュー表,インデクス,抽象データ型を定義できます。また,ストアドプロシジャやストアドファンクションを登録できます。
-
- 権限の設定方法
-
データベース定義ユティリティ(pddef),HiRDB SQL Executerを使用して権限を設定します。権限の設定方法の詳細については,マニュアル「HiRDB システム運用ガイド」を参照してください。データベース定義ユティリティの使用方法の詳細については,マニュアル「HiRDB コマンドリファレンス」を参照してください。
データベース定義ユティリティを使用して権限を設定する場合の手順を次に示します。
-
次の環境変数を設定します。
Windowsの場合
SET PDHOST=<HiRDBサーバのホスト名またはIPアドレス> SET PDNAMEPORT=<HiRDBサーバのポート番号> SET PDUSER=<DBA権限を持つユーザ名>/<パスワード>
UNIX(Bourneシェル)の場合
export PDHOST=<HiRDBサーバのホスト名またはIPアドレス> export PDNAMEPORT=<HiRDBサーバのポート番号> export PDUSER=<DBA権限を持つユーザ名>/<パスワード>
-
次のコマンドでデータベース定義ユティリティ(pddef)を実行します。
pddef
-
次のSQLを実行します。
GRANT CONNECT TO <ユーザ名>※ IDENTIFIED BY <パスワード>; GRANT SCHEMA TO <ユーザ名>※;
注※
権限を設定するユーザは,メッセージング基盤が使用する接続ユーザの名前です。HiRDBのクライアント環境変数グループに登録したPDUSER環境変数と同じ値になります。
PDUSER環境変数については,「表3-5 環境変数グループで設定する環境変数」を参照してください。
-
Windowsの場合は[Ctrl]キー+[Z]キーを押したあと,[Enter]キーを押してデータベース定義ユティリティ(pddef)を終了します。
UNIXの場合は[Ctrl]キー+[D]キーを押したあと,[Enter]キーを押してデータベース定義ユティリティ(pddef)を終了します。
-
- スキーマの定義
-
HiRDBに管理情報を格納するため,スキーマを定義します。
- スキーマの定義方法
-
データベース定義ユティリティ(pddef),HiRDB SQL Executerを使用してスキーマを定義します。スキーマを定義する方法の詳細については,マニュアル「HiRDB SQLリファレンス」を参照してください。データベース定義ユティリティの使用方法の詳細については,マニュアル「HiRDB コマンドリファレンス」を参照してください。
データベース定義ユティリティを使用してスキーマを定義する場合の手順を次に示します。
-
次の環境変数を設定します。
Windowsの場合
SET PDHOST=<HiRDBサーバのホスト名またはIPアドレス> SET PDNAMEPORT=<HiRDBサーバのポート番号> SET PDUSER=<ユーザ名>※/<パスワード>
注※
指定するユーザ名は,権限を設定したユーザのユーザ名です。
UNIX(Bourneシェル)の場合
export PDHOST=<HiRDBサーバのホスト名またはIPアドレス> export PDNAMEPORT=<HiRDBサーバのポート番号> export PDUSER=<ユーザ名>※/<パスワード>
注※
指定するユーザ名は,権限を設定したユーザのユーザ名です。
-
次のコマンドでデータベース定義ユティリティ(pddef)を実行します。
pddef
-
次のSQLを実行します。
CREATE SCHEMA;
-
Windowsの場合は[Ctrl]キー+[Z]キーを押したあと,[Enter]キーを押してデータベース定義ユティリティ(pddef)を終了します。
UNIXの場合は[Ctrl]キー+[D]キーを押したあと,[Enter]キーを押してデータベース定義ユティリティ(pddef)を終了します。
-
- RDエリアの準備
-
メッセージング基盤の管理情報テーブルを格納するため,必要に応じてRDエリアを作成します。RDエリアの作成方法の詳細については,マニュアル「HiRDB システム運用ガイド」を参照してください。
- pd_max_users(同時実行可能ユーザ数)の設定
-
HiRDBのシステム共通定義のオペランドpd_max_users(同時実行可能ユーザ数)には,実行環境が使用するDBコネクション数の最大値を設定してください。実行環境が使用するDBコネクション数の最大値については,「表3-4 実行環境が使用するDBコネクションの数」を参照してください。
pd_max_usersの詳細については,マニュアル「HiRDB システム定義」を参照してください。
(b) DBサーバ側の設定(Oracleの場合)
次の作業を実施します。
- 環境設定
-
Oracleの環境設定方法の詳細については,Oracle Corporationが発行するドキュメントを参照してください。
- 接続ユーザの作成と権限の設定
-
Oracleに管理情報を格納するため,Oracleに接続ユーザを作成し,権限を設定する必要があります。
- 設定する権限
-
システム権限として,次の権限を設定します。
-
CREATE ANY INDEXシステム権限
-
CREATE SESSIONシステム権限
-
CREATE TABLEシステム権限
-
CREATE VIEWシステム権限
-
FORCE ANY TRANSACTIONシステム権限
オブジェクト権限として,次の権限を設定します。
-
SYS.DBA_PENDING_TRANSACTIONSのSELECT権限
-
SYS.DBMS_SYSTEMのEXECUTE権限
また,次のロールを設定します。
-
SELECT_CATALOG_ROLE
-
- 接続ユーザと権限の設定方法
-
Oracle Enterprise Managerコンソール,またはsqlplusを使用してユーザを作成し,権限を設定します。Oracle Enterprise Managerコンソールとsqlplusを使用した場合の設定例を次に示します。
Oracle Enterprise Managerコンソールを使用する場合の設定例
-
sysユーザでデータベースに接続します。
-
ナビゲータ・ツリーの[セキュリティ]−[ユーザ]を右クリックして,[作成]を選択します。
-
[一般]タブを開き,名前とパスワードを入力します。
-
[ロール]タブを開き,CONNECTロールを削除して,SELECT_CATALOG_ROLEを追加します。
-
[システム]タブを開き,システム権限を設定します。
-
[オブジェクト]タブを開き,[SYS]−[ビュー]−[DBA_PENDING_TRANSACTIONS]を選択して,SELECT権限を設定します。
-
[SYS]−[パッケージ]−[DBMS_SYSTEM]を選択して,EXECUTE権限を設定します。
-
[割当て制限]タブを開き,表領域の割り当て制限サイズを設定します。
-
[作成]ボタンをクリックします。
sqlplusを使用する場合の設定例
-
sysユーザでデータベースに接続します。
-
次のSQL文を発行します(QUOTA句の指定値は例です)。
CREATE USER <権限を付与するユーザ名> PROFILE "DEFAULT" IDENTIFIED BY <パスワード> DEFAULT TABLESPACE "USERS" TEMPORARY TABLESPACE "TEMP" QUOTA 10 M ON "USERS" ACCOUNT UNLOCK; GRANT CREATE ANY INDEX TO <権限を付与するユーザ名>; GRANT CREATE SESSION TO <権限を付与するユーザ名>; GRANT CREATE TABLE TO <権限を付与するユーザ名>; GRANT CREATE VIEW TO <権限を付与するユーザ名>; GRANT FORCE ANY TRANSACTION TO <権限を付与するユーザ名>; GRANT SELECT ON "SYS"."DBA_PENDING_TRANSACTIONS" TO <権限を付与するユーザ名>; GRANT EXECUTE ON "SYS"."DBMS_SYSTEM" TO <権限を付与するユーザ名>; GRANT SELECT_CATALOG_ROLE TO <権限を付与するユーザ名>;
-
(2) Management Serverのセットアップ
Management Serverをセットアップし,環境設定をします。詳細については,マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.15 Management Serverを使用するために設定する情報」のManagement Serverの動作環境に関する説明を参照してください。また,HCSC-Managerを使用するための設定については,このマニュアルの「2.1.6 HCSC-Managerを使用するためのManagement Serverの設定」を参照してください。
なお,Management Serverと運用管理エージェントは,HCSCサーバを運用するための基盤となります。そのため,OSの起動と同時にManagement Serverと運用管理エージェントを自動起動するように設定してください。
設定方法については,マニュアル「アプリケーションサーバ リファレンス コマンド編」の「mngautorun(自動起動および自動再起動の設定/設定解除)」を参照してください。
作業フォルダまたは共通フォルダを利用する場合,Management Serverのメモリ使用量が増大する可能性があります。次の計算式をもとにメモリ使用量を拡張してください。
- Javaヒープサイズ
-
↑Max( (200MB+A),256MB)↑
A:cscfscls,cscfswlsコマンドで表示する最大ファイル数×5000バイト
- メタスペースサイズ
-
128MB以上
(3) PRFのセットアップ
PRFのセットアップは,Smart Composer機能,または運用管理ポータルを使用して実施してください。
Smart Composer機能を使用したPRFのセットアップについては,マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.8 その他の機能を使用したシステムの構築」を参照してください。
また,運用管理ポータルを使用したPRFのセットアップについては,マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「3. J2EEアプリケーションを実行するシステムの構築と削除」を参照してください。
(4) J2EEサーバのセットアップ
次の作業を実施します。
(a) J2EEサーバの構築
J2EEサーバは,Smart Composer機能または運用管理ポータルを使用して構築してください。また,J2EEサーバの互換モードが推奨モードかV9互換モードかによって,構築に必要な作業が異なります。構築に必要な作業を次に示します。
- Smart Composer機能を使用して構築する場合
-
推奨モードの場合,簡易構築定義ファイルに次に示すパラメタを追加してください。
- 論理J2EEサーバのconfiguration要素に追加するパラメタ
<param> <param-name>manager.j2ee.compat</param-name> <param-value>none</param-value> </param>
- 論理Webサーバのconfiguration要素に追加するパラメタ
<param> <param-name>manager.web.send_request_method</param-name> <param-value>reverseproxy</param-value> </param>
V9互換モードの場合,簡易構築定義ファイルに次に示すパラメタを追加してください。
- 論理J2EEサーバのconfiguration要素に追加するパラメタ
<param> <param-name>manager.j2ee.compat</param-name> <param-value>V9</param-value> </param>
- 論理Webサーバのconfiguration要素に追加するパラメタ
<param> <param-name>manager.web.send_request_method</param-name> <param-value>redirector</param-value> </param>
- サーバ管理コマンド(cjsetup)で構築する場合
-
推奨モードの場合,cjsetupコマンドに「-compat」オプションを付けないで実行してください。
V9互換モードの場合,cjsetupコマンドに次のように「-compat V9」オプションを付けて実行してください。
cjsetup <J2EEサーバ名> -compat V9
V9互換モードの指定方法については,マニュアル「アプリケーションサーバ 機能解説 互換編」の「3. V9互換モードの使用方法」を参照してください。
Smart Composer機能を使用したJ2EEサーバの構築については,マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.8 その他の機能を使用したシステムの構築」を参照してください。
また,運用管理ポータルを使用したJ2EEサーバの構築については,マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「3. J2EEアプリケーションを実行するシステムの構築と削除」を参照してください。
- 注意事項
-
構築時には,論理サーバ名と実サーバ名を同一にしてください。異なる場合,HCSCサーバのセットアップに失敗するおそれがあります。
J2EEサーバ名は110バイト以内を推奨します。ローカルマシンにIPv6アドレスを使用している環境では,111バイト以上のJ2EEサーバ名を指定すると,プロセスインスタンスの生成でエラーが発生するおそれがあります。その場合は,HCSCサーバランタイム定義のshort-processidプロパティにONを指定してください。
(b) J2EEサーバのシステム環境変数の設定
J2EEサーバのシステム環境変数の設定方法については,OSのドキュメントを参照してください。システムの環境変数の設定時の確認事項については,マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.13 論理サーバの環境変数を設定するときの確認事項」を参照してください。
(c) SOAP通信基盤およびJAX-WSエンジンの初期設定
選択したSOAPモードに応じて,次の初期設定が必要になります。
-
SOAP1.1モードを利用する場合:SOAP通信基盤
J2EEサーバの互換モードで推奨モードを選択した場合は,SOAP1.1モードは使用できません。
-
SOAP1.1/1.2併用モードを利用する場合:JAX-WSエンジン
それぞれの初期設定手順について説明します。
- ●SOAP1.1モードを利用する場合の初期設定
-
SOAP1.1モードを利用する場合,次の手順でSOAP通信基盤の初期設定をします。
-
Common Public License Version 1.0に基づいて配布されているWSDL4Jを利用するため,「wsdl4j.jar」ファイルを入手し,次のディレクトリにコピーします。
<サービスプラットフォームのインストールディレクトリ>\c4web\lib以下
-
サーバ定義ファイル(c4websv.cfg)を設定します。
HCSCサーバが動作するJ2EEサーバでのSOAP通信基盤のサーバ定義ファイルに指定する内容を次の表に示します。サーバ定義ファイルの作成については,マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「10.2 サーバ定義ファイルの設定」を参照してください。
- ポイント
-
HCSCサーバでの識別子とは,サーバ定義ファイル中から動作中のサーバの情報を取得するためのキーのことです。サーバに配備したSOAPアプリケーションのコンテキストルートから先頭の「/」を除いた名称を使用しています。このため,HCSC-Messagingでは次のようになります。
-
標準受付の識別子:クラスタ名
(例)クラスタ名が「cluster1」の場合
標準受付の識別子:「cluster1」
-
ユーザ定義受付の識別子:ユーザ定義受付の受付ID
-
-
共通定義ファイル(c4webcom.cfg)を設定します。
HCSCサーバが動作するJ2EEサーバでのSOAP通信基盤の共通定義ファイルに指定する内容を次の表に示します。共通定義ファイルの作成については,マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「10.4 共通定義ファイルの設定」を参照してください。
表3‒2 共通定義ファイルの設定項目(SOAP通信基盤) 設定項目
キー名称
設定値(デフォルト)
説明
トレースファイル出力の重要度
c4web.logger.log_level
WARN
このプロパティにDEBUGを指定しないでください。DEBUGを指定した場合は,ほかの値を指定したときに比べてより多くのメモリが消費され,スループットに影響が出ます。
-
- ●SOAP1.1/1.2併用モードを利用する場合の初期設定
-
SOAP1.1/1.2併用モードを利用する場合,次の手順でJAX-WSエンジンの初期設定をします。
-
共通定義ファイル(cjwconf.properties)を設定します。
HCSCサーバが動作するJ2EEサーバでのJAX-WSエンジンの共通定義ファイルに指定する内容を次の表に示します。共通定義ファイルの作成については,マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「10.1.2 共通定義ファイルの設定項目」を参照してください。
表3‒3 共通定義ファイルの設定項目(JAX-WSエンジン) 設定項目
キー名称
設定値(デフォルト)
説明
HTTPセッションの維持の有無
javax.xml.ws.session.maintain
false
trueを指定した場合の動作は保証しません。
-
サーバ単位にプロキシの設定をします。
プロキシの設定方法については,マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「10.10 プロキシサーバ経由の接続」を参照してください。
-
(d) HCSCサーバをセットアップするための固有設定
プロパティファイルで次のように指定します。
-
J2EEサーバ用ユーザプロパティファイル(usrconf.properties)
プロパティ
指定内容
ejbserver.rmi.localinvocation.scope
「app」を指定します。
ejbserver.jndi.global.enabled
「false」を指定します。
「true」の場合,Component Containerのメッセージログに「KDJE47722-W」が出力されますが,Service Coordinatorは,Portable Global JNDI名を使用していない(使用できない)ため,アプリケーションの開始は続行されますので,問題ありません。
ejbserver.distributedtx.XATransaction.enabled
「true」または「false」を指定します。
HCSCサーバが複数のリソース(DBサーバなど)へアクセスするどうかを検討して,ライトトランザクション機能を無効にする場合は「true」,有効にする場合は「false」を指定します。
oracle.jdbc.autoCommitSpecCompliant
Oracle 12c以降のバージョンに接続する場合,「false」を指定します。
なお,ejbserver.DynamicStubLoading.Enabledには「true」を指定しないでください。
-
サーバ管理コマンド用システムプロパティファイル(usrconf.properties)
プロパティ
指定内容
ejbserver.cui.optionalname.enabled
「true」を指定します。
「false」の場合,クライアントからのリクエスト送信時にエラーが発生します。
(e) コンテナ拡張ライブラリの設定
コンテナ拡張ライブラリとして,次の設定をします。コンテナ拡張ライブラリの設定方法については,マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「19. コンテナ拡張ライブラリ」を参照してください。
-
SOAP1.1モードを利用する場合
<Reliable Messagingのインストールディレクトリ>\lib\reliablemessaging-api.jar <サービスプラットフォームのインストールディレクトリ>\c4web\lib\hitsaaj.jar
cjjaxws.jarを無効にするため,cjjaxws.jarの行をコメントアウトするか削除してください。
-
SOAP1.1/1.2併用モードを利用する場合
<Reliable Messagingのインストールディレクトリ>\lib\reliablemessaging-api.jar <サービスプラットフォームのインストールディレクトリ>\jaxws\lib\cjjaxws.jar
hitsaaj.jarを無効にするため,hitsaaj.jarの行をコメントアウトするか削除してください。
このとき,「add.class.path=<jarのパス>」の形式で指定してください。
この定義は,運用管理ポータルからも設定できます。運用管理ポータルの「論理サーバの環境設定」にある論理J2EEサーバの[J2EEコンテナの設定]画面の拡張パラメタにクラスパスを指定します。ここでの設定値は,J2EEサーバ用オプション定義ファイル(usrconf.cfg)に反映されます。
J2EEサーバ用オプション定義ファイルについては,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2 usrconf.cfg(J2EEサーバ用オプション定義ファイル)」を参照してください。また,「論理サーバの環境設定」での設定については,マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10. 論理サーバの環境設定」を参照してください。
(5) Webサーバ(HTTPサーバ)のセットアップ
Webサーバ(HTTPサーバ)をセットアップするには次の2とおりの方法があります。
-
J2EEサーバに含まれるサーバを使用する方法
推奨モードの場合は,NIO HTTPサーバを使用します。
V9互換モードの場合は,インプロセスHTTPサーバを使用します。
-
HTTP Serverを使用する方法
これらの方法について次に説明します。
(a) NIO HTTPサーバまたはインプロセスHTTPサーバを使用する方法
次の作業を実施します。
- NIO HTTPサーバのセットアップ(推奨モードの場合)
-
NIO HTTPサーバを使用する場合のシステム構築の詳細については,マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「7. NIO HTTPサーバ」を参照してください。
- インプロセスHTTPサーバのセットアップ(V9互換モードの場合)
-
インプロセスHTTPサーバを使用する場合のシステム構築の詳細については,マニュアル「アプリケーションサーバ 機能解説 互換編」の「6. インプロセスHTTPサーバ」を参照してください。
- NIO HTTPサーバまたはインプロセスHTTPサーバのコネクションタイムアウト値の設定
-
サービスリクエスタ側にあるSOAP通信基盤でコネクションプーリング機能を使用している場合,サービスリクエスタ側のコネクション保持の時間と,HCSCサーバ稼働マシンでのコネクションタイムアウト値の整合性をとる必要があります。
コネクションタイムアウト値の設定手順を次に示します。
-
運用管理ポータルから,[論理サーバの環境設定]を選択します。
-
サーバビューから,[論理J2EEサーバ]−[J2EEサーバ]−[<J2EEサーバ名>]を選択します。
-
[HTTPサーバ]タブの[通信・スレッド制御]タブを選択します。
[通信・スレッド制御設定]画面が表示されます。
-
[Webクライアントとの接続設定]−[Persistentコネクション]−[タイムアウト]に,SOAP通信基盤(Web Services)の共通定義ファイルのc4web.common.connection_pool.timeoutプロパティの設定値以上の値を設定します。
c4web.common.connection_pool.timeoutプロパティを設定していない場合はデフォルト値の1800(単位:秒)で動作するため,その倍の値である3600をタイムアウト値に設定します。
なお,タイムアウト値に設定できる範囲は0〜3600です。そのため,c4web.common.connection_pool.timeoutプロパティの設定が1800よりも大きい場合は,0を設定してください。
-
(b) HTTP Serverを使用する方法
次の作業を実施します。
- HTTP Serverのセットアップ
-
セットアップ方法の詳細については,マニュアル「HTTP Server」を参照してください。
- HTTP ServerとJ2EEサーバを連携する設定
-
J2EEサーバと連携するためには,簡易構築定義ファイルでWebサーバ連携のためのパラメタの設定が必要です。パラメタの詳細については,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.10 論理Webサーバで指定できるパラメタ」を参照してください。
- HTTP ServerのKeepAliveTimeout値の設定
-
サービスリクエスタ側にあるSOAP通信基盤でコネクションプーリング機能を使用している場合,サービスリクエスタ側のコネクション保持の時間と,HCSCサーバ稼働マシンのKeepAliveTimeout値の整合性をとる必要があります。
HTTP Serverの環境設定ファイルであるhttpsd.confのKeepAliveTimeoutに,SOAP通信基盤(Web Services)の共通定義ファイルのc4web.common.connection_pool.timeoutプロパティに指定した値の倍以上の値を設定します。例えば,c4web.common.connection_pool.timeoutプロパティを設定していない場合はデフォルト値の1800で動作するため,その倍の値である3600をKeepAliveTimeoutに設定します。
なお,指定できる値の範囲は0〜65535です。詳細は,マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「7.4.2 コネクションプーリングに関する設定」を参照してください。
(6) データベースのクライアント側のセットアップ
(a) DBクライアント側の設定(HiRDBの場合)
実行環境のマシンで,次の作業を実施します。
- 環境変数の設定
-
Windowsの場合は,次の環境変数を設定します。
UNIXの場合は,HCSCサーバが稼働しているJ2EEサーバ起動時とManagement Server実行時の環境変数に,次の環境変数を設定します。
HCSCサーバが稼働しているJ2EEサーバ起動時の環境変数の設定方法は,マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.8.27 J2EEサーバの環境変数の設定」を参照してください。
Management Server実行時の環境変数の設定方法は,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.8 mserverenv.cfg(Management Server用環境変数定義ファイル)」を参照してください。
- PDXAMODE
-
1を指定します。
ただし,ライトトランザクション機能を利用する場合はPDXAMODEの設定は必要ありません。
- PDTXACANUM
-
サービスプラットフォームが使用するDBコネクション数の最大値を指定します。
ただし,ライトトランザクション機能を利用する場合はPDTXACANUMの設定は必要ありません。
DBコネクション数の最大値は,利用する実行環境に応じて見積もる必要があります。実行環境がDBコネクションを使用する契機と数を次の表に示します。
表3‒4 実行環境が使用するDBコネクションの数 DBコネクションの使用先
DBコネクションの使用の契機
DBコネクションの使用数
使用するコネクション
メッセージング基盤
起動時
1
HCSCサーバセットアップ定義ファイルのdbcon-nodisplaynameに指定したDBコネクタから取得する
コマンド実行時
1
- [HCSCサーバ停止状態]
-
コマンド実行時にJDBCドライバを使用してコネクションを取得する
- [HCSCサーバ起動状態]
-
HCSCサーバセットアップ定義ファイルのdbcon-nodisplaynameに指定したDBコネクタから取得する
ビジネスプロセス基盤
ビジネスプロセス実行要求受付時
ビジネスプロセスの同時実行数
HCSCサーバセットアップ定義ファイルのdbcon-xadisplaynameに指定したDBコネクタから取得する
DBアダプタ
サービス部品実行要求受付時
サービス部品の同時実行数
SQLオペレーション定義ファイルのデータベース参照名で参照されるDBコネクタから取得する
Reliable Messaging
マニュアル「Reliable Messaging」の「3.4.1 DBMSの設定(HiRDBを使用する場合)」を参照してください。
DBコネクション使用数の和が最大値となります。
- PDLANGまたはLANG
-
HCSCサーバをUNIXで稼働させる場合,HiRDBサーバの文字コードに応じて,PDLANGかLANGのどちらかにHiRDBサーバと同じ文字コードを指定します。詳細は,マニュアル「HiRDB UAP開発ガイド」のPDLANGに関する内容を参照してください。
HCSCサーバをWindowsで稼働させる場合は,設定は不要です。
- LC_CTYPE
-
HCSCサーバをUNIXで稼働させる場合,HiRDBサーバと同じ文字コードを指定します。
HCSCサーバをWindowsで稼働させる場合は,設定は不要です。
- LD_LIBRARY_PATH
-
HCSCサーバをLinuxで稼働させる場合,下記のパスを追加します。
-
<HiRDB運用ディレクトリ>/client/lib
HiRDB/Single Server,HiRDB/Parallel ServerまたはHiRDB Serverインストール時に指定します。
-
<HiRDBのインストールディレクトリ>/client/lib
HiRDB/Run Time,またはHiRDB/Developer's Kitインストール時に指定します。
HCSCサーバをWindowsで稼働させる場合は,設定は不要です。
-
- LIBPATH
-
HCSCサーバをAIXで稼働させる場合,下記のパスを追加します。
-
<HiRDBの運用ディレクトリ>/client/lib
HiRDB/Single Server,HiRDB/Parallel ServerまたはHiRDB Serverインストール時に指定します。
-
<HiRDBのインストールディレクトリ>/client/lib
HiRDB/Run Time,またはHiRDB/Developer's Kitインストール時に指定します。
HCSCサーバをWindowsで稼働させる場合は,設定は不要です。
-
- 環境変数グループの設定
-
環境変数グループを次の方法で登録します。
- Windowsの場合
-
HiRDBのクライアント環境変数登録ツールで「システムグループ」を選択して,環境変数グループを登録します。この場合,DB Connectorのプロパティ定義では,ここで登録した環境変数グループ名を指定してください。
- UNIXの場合
-
HiRDBのクライアント環境変数グループの設定ファイルに登録します。この場合,DB Connectorのプロパティ定義では,ここで登録した環境変数グループの設定ファイルのパスを指定してください。
環境変数グループを登録する方法の詳細については,マニュアル「HiRDB UAP開発ガイド」の環境変数のグループ登録に関する内容を参照してください。
DB Connectorのプロパティについては,マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.2.2 DB Connectorのプロパティ定義」を参照してください。
環境変数グループで設定する環境変数を次の表に示します。
表3‒5 環境変数グループで設定する環境変数 環境変数名
設定する内容
PDHOST
データベースのホスト名またはIPアドレスを指定します。
PDUSER
データベースのユーザ名およびデータベースのパスワードを指定します。
PDNAMEPORT
データベースのポート番号を指定します。
PDSWAITTIME
Component Containerのトランザクションタイムアウトの値※よりも大きな値を指定します。
PDCWAITTIME
Component Containerのトランザクションタイムアウトの値※よりも大きな値を指定します。
PDSWATCHTIME
0を指定します。
- 注※
-
Component Containerのトランザクションタイムアウトの値は,J2EEサーバ用ユーザプロパティファイルで指定します。Component Containerのトランザクションタイムアウトの値については,マニュアル「アプリケーションサーバ システム設計ガイド」の「8.6.4 トランザクションタイムアウトを設定する」を参照してください。
(b) DBクライアント側の設定(Oracleの場合)
Oracle JDBC Thin Driverをセットアップします。Oracle JDBC Thin Driverのセットアップについては,「3.1.2(7)(b) Oracle JDBC Thin Driverのセットアップ」を参照してください。
(7) JDBCドライバのセットアップ
使用するJDBCドライバは,利用条件を考慮して選択する必要があります。
使用するJDBCドライバの選択方法を次の表に示します。
利用するDBMS |
使用するJDBCドライバ |
JDBCドライバのパッケージ |
---|---|---|
HiRDB |
HiRDB TYPE4 JDBC Driver |
JP.co.Hitachi.soft.HiRDB.JDBC.HiRDBDriver |
Oracle |
Oracle JDBC Thin Driver |
oracle.jdbc.OracleDriver |
(a) HiRDB Type4 JDBC Driverのセットアップ
HiRDB Type4 JDBC Driverのセットアップについては,マニュアル「HiRDB UAP開発ガイド」のHiRDB Type4 JDBC Driverに関する内容を参照してください。
なお,HCSCサーバを使用するために,次の設定をする必要があります。
-
<サービスプラットフォームのインストールディレクトリ>/manager/config/mserver.cfgファイルに,HiRDB Type4 JDBC DriverのJARファイル(pdjdbc2.jar)をクラスパスとして指定します。このとき,「web.add.class.path=<pdjdbc2.jarのパス>」の形式で指定してください。
- 例1(HiRDB/Run Timeの場合)
-
web.add.class.path=<HiRDB/Run Timeのインストールディレクトリ>/client/lib/pdjdbc2.jar
- 例2(HiRDB/Single Serverの場合)
-
web.add.class.path=<HiRDB/Single Serverのインストールディレクトリ>※/client/lib/pdjdbc2.jar
注※
<HiRDBのインストールディレクトリ>は,hirdb_sというディレクトリになります。
-
J2EEサーバ用オプション定義ファイル(usrconf.cfg)に,HiRDB Type4 JDBC DriverのJARファイル(pdjdbc2.jar)をクラスパスとして指定します。このとき,「add.class.path=<pdjdbc2.jarのパス>」の形式で指定してください。
- 例1(HiRDB/Run Timeの場合)
-
add.class.path=<HiRDB/Run Timeのインストールディレクトリ>/client/lib/pdjdbc2.jar
- 例2(HiRDB/Single Serverの場合)
-
add.class.path=<HiRDB/Single Serverのインストールディレクトリ>※/client/lib/pdjdbc2.jar
注※
<HiRDBのインストールディレクトリ>は,hirdb_sというディレクトリになります。
この定義は,運用管理ポータルからも設定できます。運用管理ポータルの「論理サーバの環境設定」にある論理J2EEサーバの[J2EEコンテナの設定]画面の拡張パラメタにクラスパスを指定します。ここでの設定値は,J2EEサーバ用オプション定義ファイル(usrconf.cfg)に反映されます。
J2EEサーバ用オプション定義ファイルについては,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2 usrconf.cfg(J2EEサーバ用オプション定義ファイル)」を参照してください。また,「論理サーバの環境設定」での設定については,マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10. 論理サーバの環境設定」を参照してください。
-
HCSC-Messagingコマンド共通定義ファイルのHCSC_ADDCLASSPATHに,HiRDB Type4 JDBC DriverのJARファイル(pdjdbc2.jar)をクラスパスとして指定します。
HCSC-Messagingコマンド共通定義ファイルの詳細については,マニュアル「サービスプラットフォーム リファレンス」の「6.5.4 HCSC-Messagingコマンド共通定義ファイル」を参照してください。
(b) Oracle JDBC Thin Driverのセットアップ
Oracle JDBC Thin Driverのセットアップについては,マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.7 データベース接続環境を設定する(Oracleの設定)」または,使用しているデータベースのマニュアルを参照してください。
なお,HCSCサーバを使用するために,次の設定をする必要があります。使用するOracleのバージョンによって,Oracle JDBC Thin Driverの種類が異なりますので,Oracle JDBC Thin DriverのJARファイルのクラスパスを指定する際は注意してください。
-
<サービスプラットフォームのインストールディレクトリ>/manager/config/mserver.cfgファイルに,Oracle JDBC Thin DriverのJARファイルをクラスパスとして指定します。このとき,「web.add.class.path=<Oracle JDBC Thin Driverのパス>」の形式で指定してください。
- 例(Oracle 12cの場合)
-
web.add.class.path=<Oracle Clientのインストールディレクトリ>/jdbc/lib/ojdbc7.jar
-
J2EEサーバ用オプション定義ファイル(usrconf.cfg)に,Oracle JDBC Thin DriverのJARファイルをクラスパスとして指定します。このとき,「add.class.path=<Oracle JDBC Thin Driverのパス>」の形式で指定してください。
- 例(Oracle 12cの場合)
-
add.class.path=<Oracle Clientのインストールディレクトリ>/jdbc/lib/ojdbc7.jar
この定義は,運用管理ポータルからも設定できます。運用管理ポータルの「論理サーバの環境設定」にある論理J2EEサーバの[J2EEコンテナの設定]画面の拡張パラメタにクラスパスを指定します。ここでの設定値は,J2EEサーバ用オプション定義ファイル(usrconf.cfg)に反映されます。
J2EEサーバ用オプション定義ファイルについては,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2 usrconf.cfg(J2EEサーバ用オプション定義ファイル)」を参照してください。また,「論理サーバの環境設定」での設定については,マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10. 論理サーバの環境設定」を参照してください。
-
HCSC-Messagingコマンド共通定義ファイルのHCSC_ADDCLASSPATHに,Oracle JDBC Thin DriverのJARファイルをクラスパスとして指定します。
HCSC-Messagingコマンド共通定義ファイルの詳細については,マニュアル「サービスプラットフォーム リファレンス」の「6.5.4 HCSC-Messagingコマンド共通定義ファイル」を参照してください。
(8) DB Connectorのセットアップ(Reliable Messagingを使用する場合)
HCSCサーバは,データベースと接続するためにDB Connectorを利用します。処理のタイミングやテーブル種別に応じて,データベースアクセスをトランザクション管理する場合と管理しない場合があるため,トランザクションサポート種別がXATransactionまたはLocalTransactionのDB Connectorと,トランザクションサポート種別がNoTransactionであるDB Connectorの,2つのDB Connectorを準備する必要があります。
なお,トランザクションサポート種別がXATransactionまたはLocalTransactionのDB Connectorは,処理性能を向上させるため,Reliable Messagingと連携できるDB Connectorを利用します。
それぞれのDB Connectorの表示名は,HCSCサーバセットアップ定義ファイルの「dbcon-xadisplayname」と「dbcon-nodisplayname」に指定します。HCSCサーバセットアップ定義ファイルの詳細については,マニュアル「サービスプラットフォーム リファレンス」の「6.4.3 HCSCサーバセットアップ定義ファイル」を参照してください。
(a) DB Connectorのインポート
インポートするDB Connectorは,利用条件を考慮して選択する必要があります。インポートするRARファイルの選択方法を次の表に示します。
HCSCサーバセットアップ定義ファイルのプロパティ |
利用するデータベース |
ライトトランザクション機能の利用の有無 |
|
---|---|---|---|
利用する |
利用しない |
||
dbcon-xadisplayname |
HiRDB |
DBConnector_HiRDB_ Type4_CP_Cosminexus_RM.rar |
DBConnector_HiRDB_Type4_ XA_Cosminexus_RM.rar |
Oracle |
DBConnector_Oracle_CP_ Cosminexus_RM.rar |
DBConnector_Oracle_XA_ Cosminexus_RM.rar |
|
dbcon-nodisplayname |
HiRDB |
DBConnector_HiRDB_Type4_CP.rar |
|
Oracle |
DBConnector_Oracle_CP.rar |
DB Connectorのインポート方法については,マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.2 データベースと接続するための設定」を参照してください。また,プロパティ定義については,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1 Connector属性ファイル」を参照してください。
ライトトランザクションについては,マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.14.5 ライトトランザクション」を参照してください。また,設定方法については,マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.8.6 トランザクションの設定」を参照してください。
また,DBアダプタを利用する場合は,DBアダプタが利用するDB Connectorをインポートします。インポートするRARファイルの選択方法を次の表に示します。
利用するJDBCドライバ |
利用するデータベース |
ライトトランザクション機能の利用の有無 |
|
---|---|---|---|
利用する |
利用しない |
||
HiRDB Type4 JDBC Driver |
HiRDB |
DBConnector_HiRDB_Type4_CP.rar |
DBConnector_HiRDB_Type4_XA.rar |
Oracle JDBC Thin Driver |
Oracle |
DBConnector_Oracle_CP.rar |
DBConnector_Oracle_XA.rar |
(b) プロパティの定義
DB Connectorをインポートしたあと,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1 Connector属性ファイル」を参照して,プロパティを定義してください。ただし,次の表に示す内容をプロパティに設定する必要があります。
- 注意事項
-
Reliable Messagingと連携できるDB Connectorと,DBアダプタで利用するDB Connectorで,トランザクションサポート種別(<transaction-support>タグに指定する値)を同じにする必要があります。
また,<transaction-support>タグに指定する値は,ライトトランザクションを適用するか,グローバルトランザクションを適用するかで次のように異なります。
-
J2EEサーバにライトトランザクションを適用する場合
LocalTransaction
-
J2EEサーバにグローバルトランザクションを適用する場合
XATransaction
-
設定項目 |
設定値 |
---|---|
<display-name>タグ |
DB Connector表示名 |
<config-property>タグに設定するdatabaseNameプロパティ |
データベース名※1 |
<config-property>タグに設定するbufSizeプロパティ |
システムで利用する最大の電文長よりも大きな値※2 |
<transaction-support>タグ |
XATransaction※3 |
LocalTransaction※4 |
|
<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ |
ビジネスプロセスの最大同時実行数以上の値※5 |
- 注※1
-
使用するDB Connectorによって設定値が異なります。設定値については,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1 Connector属性ファイル」を参照してください。また,データベースに接続するために必要な情報もあわせて設定してください。
- 注※2
-
使用するDB Connectorが次のDB Connectorで,LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。
・DBConnector_DABJ_XA_Cosminexus_RM.rar
・DBConnector_DABJ_CP_Cosminexus_RM.rar
- 注※3
-
ライトトランザクション機能を利用しない場合に,次のDB Connectorに対して指定してください。
・DBConnector_DABJ_XA_Cosminexus_RM.rar
・DBConnector_Oracle_XA_Cosminexus_RM.rar
- 注※4
-
ライトトランザクション機能を利用する場合に,次のDB Connectorに対して指定してください。
・DBConnector_DABJ_CP_Cosminexus_RM.rar
・DBConnector_Oracle_CP_Cosminexus_RM.rar
- 注※5
-
他の機能でdbcon-xadisplaynameに設定したDB Connectorを使用する場合は,その機能の同時実行数を含めた値を指定してください。
設定項目 |
設定値 |
---|---|
<display-name>タグ |
DB Connector表示名 |
<config-property>タグに設定するmaxBinarySizeプロパティ |
システムで利用する最大の電文長よりも大きな値※1 |
<transaction-support>タグ |
XATransaction※2 |
LocalTransaction※3 |
|
<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ |
ビジネスプロセスの最大同時実行数以上の値※4 |
- 注※1
-
LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。また,必ず0以外の値を指定してください。
- 注※2
-
ライトトランザクション機能を利用しない場合に,次のDB Connectorに対して指定してください。
・DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rar
- 注※3
-
ライトトランザクション機能を利用する場合に,次のDB Connectorに対して指定してください。
・DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rar
- 注※4
-
他の機能でdbcon-xadisplaynameに設定したDB Connectorを使用する場合は,その機能の同時実行数を含めた値を指定してください。
- 注意
-
データベースに接続するために必要な情報を設定してください。設定値については,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1 Connector属性ファイル」を参照してください。
設定項目 |
設定値 |
---|---|
<display-name>タグ |
DB Connector表示名 |
<config-property>タグに設定するdatabaseNameプロパティ |
データベース名※1 |
<config-property>タグに設定するbufSizeプロパティ |
システムで利用する最大の電文長よりも大きな値※2 |
<transaction-support>タグ |
NoTransaction※3 |
<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ |
1以上の値※4 |
- 注※1
-
使用するデータベースによって設定値が異なります。設定値については,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1 Connector属性ファイル」を参照してください。また,データベースに接続するために必要な情報もあわせて設定してください。
- 注※2
-
使用するDB Connectorが次のDB Connectorで,LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。
・DBConnector_DABJ_CP.rar
- 注※3
-
使用するDB Connectorが次のDB Connectorに対して指定してください。
・DBConnector_DABJ_CP.rar
・DBConnector_Oracle_CP.rar
- 注※4
-
他の機能でdbcon-nodisplaynameに設定したDB Connectorを使用する場合は,その機能の同時実行数を含めた値を指定してください。
設定項目 |
設定値 |
---|---|
<display-name>タグ |
DB Connector表示名 |
<config-property>タグに設定するmaxBinarySizeプロパティ |
システムで利用する最大の電文長よりも大きな値※1 |
<transaction-support>タグ |
NoTransaction※2 |
<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ |
1以上の値※3 |
- 注※1
-
LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。また,必ず0以外の値を指定してください。
- 注※2
-
使用するDB Connectorが次のDB Connectorに対して指定してください。
・DBConnector_HiRDB_Type4_CP.rar
- 注※3
-
他の機能でdbcon-nodisplaynameに設定したDB Connectorを使用する場合は,その機能の同時実行数を含めた値を指定してください。
- 注意
-
データベースに接続するために必要な情報を設定してください。設定値については,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1 Connector属性ファイル」を参照してください。
設定項目 |
設定値 |
---|---|
<display-name>タグ |
DB Connector表示名※1 |
<config-property>タグに設定するdatabaseNameプロパティ |
データベース名※2 |
<transaction-support>タグ |
XATransaction |
LocalTransaction |
|
<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ |
DBアダプタの最大同時実行数以上の値※3 |
- 注※1
-
この値は,DBアダプタのアプリケーション統合属性ファイルの<linked-to>タグにも設定します。アプリケーション統合属性ファイルについては,マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.5 DBアダプタを定義する」を参照してください。
- 注※2
-
使用するDB Connectorによって設定値が異なります。設定値については,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1 Connector属性ファイル」を参照してください。
- 注※3
-
他の機能でDBアダプタに指定したDBコネクタを使用する場合,その機能の同時実行数を含めた値を指定してください。
(9) Reliable Messagingのセットアップ
Reliable Messagingをセットアップします。作業の詳細については,マニュアル「Reliable Messaging」の「3. システム構築」を参照してください。セットアップ作業のうちプロパティのカスタマイズについては,次に示す方法で実施します。
(a) Reliable Messagingのコンフィグレーションプロパティの設定
設定するコンフィグレーションプロパティと指定する値を次の表に示します。なお,認証情報(UserおよびPassword)には,Reliable MessagingがHiRDBまたはOracleにアクセスするために利用する接続ユーザのユーザ名およびパスワードを指定してください。
プロパティ名 |
設定内容 |
設定値 |
---|---|---|
RMSystemName |
システム名 |
連携するシステム全体で一意なシステム名を指定します。 |
RMLinkedDBConnectorName |
連携するDB Connectorの表示名 |
連携するDB Connectorの表示名を指定します。 |
RMSHConnectFlag |
共用キューを使用して複数システム間でのアプリケーション連携をする場合の受信用共用キューの有無 |
標準の非同期受付(MDB(DBキュー))を使用する場合,「true」を指定します。 標準の非同期受付(MDB(DBキュー))を使用しない場合,またはDBキューを使用できないデータベース(Oracle)を使用している場合「false」を指定します。 |
RMTRConnectFlag |
キュー間転送の使用有無 |
「true」を指定します。 |
RMMaxDeliveryNum |
配送回数の最大値 |
0以外(1〜512)を設定します(推奨値:10)。 |
RMDeadMessageQueueName |
デッドメッセージキュー名 |
1〜20文字の識別子を設定します。 なお,必ずデッドメッセージキューを使用してください。 また,デッドメッセージキューはローカルキューとしてください。 |
(b) 注意事項
-
コンフィグレーションプロパティ「RMWaitRestoration」の値は変更しないでください。Reliable Messagingのデフォルト値「true」で動作します。
-
デッドメッセージキュー名「RMDeadMessageQueueName」に指定するデッドメッセージキューは,非同期の標準受付(MDB(WS-R),MDB(DBキュー))や非同期のサービスアダプタ(MDB(WS-R)アダプタ,MDB(DBキュー)アダプタ)を使用している場合に,配送回数が最大値に達してサービス部品が呼び出されなかったメッセージが移動される特別なキューです。
デッドメッセージキュー名を設定していない場合,およびデッドメッセージキューを作成していない場合,無限にサービス部品を呼び出す処理が再実行されるため,注意してください。
なお,デッドメッセージキューとして使用するキューは,Reliable Messagingの設定後,最初に開始したあとに作成してください。
-
データベースにOracleを使用する場合,非同期の標準受付(MDB(DBキュー)),および非同期のMDB(DBキュー)アダプタは使用できません。
(10) TP1インバウンドアダプタのセットアップ
TP1/RPC受付を使用する場合は,TP1インバウンドアダプタをセットアップします。J2EEサーバがセットアップされていれば,任意のタイミングでセットアップできます。
TP1インバウンドアダプタのセットアップについては,マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「4.12.2 リソースアダプタの設定」に関する説明を参照してください。なお,TP1インバウンドアダプタをセットアップするには,Connector属性定義ファイルを必ず設定してください。
(11) Kafkaインバウンドアダプタのセットアップ
Kafka受付を使用する場合は,Kafkaインバウンドアダプタをセットアップします。Kafkaインバウンドアダプタをセットアップするには,HCSCサーバが起動している必要があります。HCSCサーバの状態の確認方法については,「5.3.16 HCSCサーバの情報を確認する」を参照してください。
Kafkaインバウンドアダプタのセットアップの流れを次に示します。
|
(a) Kafkaインバウンドアダプタのインポート
Kafkaインバウンドアダプタをインポートする場合の実行形式を次に示します。
<サービスプラットフォームのインストールディレクトリ>\CC\admin\bin\cjimportres <J2EEサーバ名> -type rar -f "<サービスプラットフォームのインストールディレクトリ>\CSC\inbound-adapter\kafka\rar\kafka_inbound_adapter.rar"
cjimportresコマンドの詳細は,マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4 J2EEサーバで使用するリソース操作コマンド」を参照してください。
(b) Kafkaインバウンドアダプタのデプロイ
Kafkaインバウンドアダプタをデプロイする場合の実行形式を次に示します。
<サービスプラットフォームのインストールディレクトリ>\CC\admin\bin\cjdeployrar <J2EEサーバ名> -resname Kafka_Inbound_Resource_Adapter
cjdeployrarコマンドの詳細は,マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4 J2EEサーバで使用するリソース操作コマンド」を参照してください。
(c) Kafkaインバウンドアダプタの設定
Kafkaインバウンドアダプタを設定する手順,およびプロパティファイルの内容を次に示します。
- 参考
-
初期状態の設定のままでKafkaインバウンドアダプタを運用する場合,ここでの設定は省略できます。
- 設定手順
-
-
KafkaインバウンドアダプタのRARファイルから属性を取得して,属性ファイルを作成します。
KafkaインバウンドアダプタのRARファイルから属性ファイルを作成する場合の実行形式を次に示します。
<サービスプラットフォームのインストールディレクトリ>\CC\admin\bin\cjgetrarprop <J2EEサーバ名> -resname Kafka_Inbound_Resource_Adapter -c <属性ファイルのファイルパス>
cjgetrarpropコマンドの詳細は,マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4 J2EEサーバで使用するリソース操作コマンド」を参照してください。
-
属性ファイルを編集します。
属性ファイルの詳細は,「プロパティの内容」を参照してください。
-
定義項目を編集した属性ファイルに指定された値をKafkaインバウンドアダプタのRARファイルへ反映します。
属性ファイルをKafkaインバウンドアダプタへ反映する場合の実行形式を次に示します。
<サービスプラットフォームのインストールディレクトリ>\CC\admin\bin\cjsetrarprop <J2EEサーバ名> -resname Kafka_Inbound_Resource_Adapter -c <属性ファイルのファイルパス>
cjsetrarpropコマンドの詳細は,マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4 J2EEサーバで使用するリソース操作コマンド」を参照してください。
-
- プロパティの内容
-
- 属性ファイルの定義
-
属性ファイルにある定義のタグを次に示します。
<hitachi-connector-property> <display-name>Kafka_Inbound_Resource_Adapter</display-name> : <resourceadapter> <config-property> <config-property-name> :定義の名称 <config-property-type> :定義の型 <config-property-value> :定義の値 </config-property> :(以降,定義の数分,繰り返される) <resourceadapter-runtime> <property> <property-name> :定義の名称 <property-type> :定義の型 <property-value> :定義の値 </property> :(以降,定義の数分,繰り返される)
定義を編集する場合は,編集する「定義の名称」を検索して,対応する「定義の値」を書き替えます。編集できる項目については,「属性ファイルの定義項目」を参照してください。
属性ファイルを編集する際の注意事項を次に示します。
-
「定義項目」に示している定義項目の値だけを書き替えてください。ほかの項目や値を変更しないでください。
-
属性ファイルの内容はアプリケーション属性ファイル(cosminexus.xml)には記載しないでください。
-
属性ファイル内にある<display-name>タグのリソースアダプタの名称を変更しないでください。
-
ログ出力に関する設定で,各ログのログファイル1面当たりのファイルサイズ,およびログファイルのバックアップファイルの面数を変更した場合は,Kafkaインバウンドアダプタを起動する前に,ログファイルをバックアップしておいてください。
-
- 属性ファイルの定義個所
-
属性ファイルの定義個所を次の図に示します。
図3‒6 属性ファイルの内容および定義の設定個所 - 属性ファイルの定義項目
-
属性ファイルの定義項目のうち編集できる項目を次に示します。
-
ログ出力に関する設定
<resourceadapter>タグの<config-property>タグに設定します。
設定内容を次の表に示します。
表3‒15 属性ファイルの定義項目一覧(ログ出力に関する設定) 定義項目
定義の名称
定義の値(指定できる内容)
デフォルト値
メッセージログ
ログ出力レベル
server_message_logLevel
次のどちらかを指定してください。
-
info
通常の運用時に使用し,運用時に必要な情報を出力します。
-
debug
テストや障害が発生した場合の調査時に使用し,infoの情報に加えて,デバッグ用の情報を出力します。
info
ログファイル1面当たりのファイルサイズ
server_message_maxFileSize
1MB〜2048MB
(単位の文字列「MB」も指定)
10MB
ログファイルのバックアップファイルの面数
server_message_maxBackupIndex
1〜16
4
保守用ログ
ログ出力レベル
server_maintenance_logLevel
次のどれかを指定してください。
-
error
エラー発生時に出力します。
-
info
メッセージログの「ログ出力レベル」と同じです。
-
debug
メッセージログの「ログ出力レベル」と同じです。
error
ログファイル1面当たりのファイルサイズ
server_maintenance_maxFileSize
1MB〜2048MB
(単位の文字列「MB」も指定)
5MB
ログファイルのバックアップファイルの面数
server_maintenance_maxBackupIndex
1〜16
4
データトレース
出力有無
server_datatrace_enabled
次のどちらかを指定してください。
-
true
トレースを出力します。
-
false
トレースを出力しません。
false
出力契機
server_datatrace_trigger
次の値のどちらかを指定することも,両方指定することもできます。
-
normal
正常終了時に出力します。
-
error
例外時に出力します。
error
ログファイル1面当たりのファイルサイズ
server_datatrace_maxFileSize
1MB〜2048MB
(単位の文字列「MB」も指定)
10MB
ログファイルのバックアップファイルの面数
server_datatrace_maxBackupIndex
1〜16
4
-
-
スレッドプールに関する設定
<resourceadapter-runtime>タグの<property>タグに設定します。
設定内容を次の表に示します。
表3‒16 属性ファイルの定義項目一覧(スレッドプールに関する設定) 定義項目
定義の名称
値の範囲
デフォルト値
スレッドプールで同時に実行される最大スレッド数
MaxTPoolSize
1〜2147483647
設定値は次に示す値以上にしてください。
-
HCSCサーバ内のKafka受付のインスタンスプールの最大数の合計
10※
スレッドプールに存在する最小スレッド数
MinTPoolSize
0〜1024
10※
スレッドプールのスレッド解放までのタイムアウト値
TPoolKeepalive
1〜2147483647
(単位:秒)
300※
- 注※
-
デフォルト値は,アプリケーションサーバのデフォルト値です。
-
-
(12) gRPCインバウンドアダプタのセットアップ
gRPC受付を使用する場合は,gRPCインバウンドアダプタをセットアップします。gRPCインバウンドアダプタをセットアップするには,HCSCサーバが起動している必要があります。HCSCサーバの状態の確認方法については,「5.3.16 HCSCサーバの情報を確認する」を参照してください。
gRPCインバウンドアダプタのセットアップの流れを次に示します。
|
(a) gRPCインバウンドアダプタのインポート
gRPCインバウンドアダプタをインポートする場合の実行形式を次に示します。
<サービスプラットフォームのインストールディレクトリ>\CC\admin\bin\cjimportres <J2EEサーバ名> -type rar -f "<サービスプラットフォームのインストールディレクトリ>\CSC\inbound-adapter\grpc\rar\grpc_inbound_adapter.rar"
cjimportresコマンドの詳細は,マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4 J2EEサーバで使用するリソース操作コマンド」を参照してください。
(b) gRPCインバウンドアダプタのデプロイ
gRPCインバウンドアダプタをデプロイする場合の実行形式を次に示します。
<サービスプラットフォームのインストールディレクトリ>\CC\admin\bin\cjdeployrar <J2EEサーバ名> -resname gRPC_Inbound_Resource_Adapter
cjdeployrarコマンドの詳細は,マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4 J2EEサーバで使用するリソース操作コマンド」を参照してください。
(c) gRPCインバウンドアダプタの設定
gRPCインバウンドアダプタでは,HTTP/2を使用してgRPC電文の送受信を実行します。HTTP/2の設定可能なパラメタは,gRPCインバウンドアダプタのRAR属性ファイルから設定できます。
gRPCインバウンドアダプタを設定する手順,およびプロパティファイルの内容を次に示します。
- 参考
-
初期状態の設定のままでgRPCインバウンドアダプタを運用する場合,ここでの設定は省略できます。
- 設定手順
-
-
gRPCインバウンドアダプタのRARファイルから属性を取得して,属性ファイルを作成します。
gRPCインバウンドアダプタのRARファイルから属性ファイルを作成する場合の実行形式を次に示します。
<サービスプラットフォームのインストールディレクトリ>\CC\admin\bin\cjgetrarprop <J2EEサーバ名> -resname gRPC_Inbound_Resource_Adapter -c <属性ファイルのファイルパス>
cjgetrarpropコマンドの詳細は,マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4 J2EEサーバで使用するリソース操作コマンド」を参照してください。
-
属性ファイルを編集します。
属性ファイルの詳細は,「プロパティの内容」を参照してください。
-
定義項目を編集した属性ファイルに指定された値をgRPCインバウンドアダプタのRARファイルへ反映します。
属性ファイルをgRPCインバウンドアダプタへ反映する場合の実行形式を次に示します。
<サービスプラットフォームのインストールディレクトリ>\CC\admin\bin\cjsetrarprop <J2EEサーバ名> -resname gRPC_Inbound_Resource_Adapter -c <属性ファイルのファイルパス>
cjsetrarpropコマンドの詳細は,マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4 J2EEサーバで使用するリソース操作コマンド」を参照してください。
-
- プロパティの内容
-
- 属性ファイルの定義
-
属性ファイルにある定義のタグを次に示します。
<hitachi-connector-property> <display-name>gRPC_Inbound_Resource_Adapter</display-name> : <resourceadapter> <resourceadapter-class>com.cosminexus.csc.grpc.resourceadapter.GRPCInboundResourceAdapter</resourceadapter-class> <config-property> <config-property-name> :定義の名称 <config-property-type> :定義の型 <config-property-value> :定義の値 </config-property> :(以降,定義の数分,繰り返される) <inbound-resourceadapter> : </inbound-resourceadapter> </resourceadapter> </hitachi-connector-property>
定義を編集する場合は,編集する「定義の名称」を検索して,対応する「定義の値」を書き替えます。編集できる項目については,「属性ファイルの定義項目」を参照してください。
属性ファイルを編集する際の注意事項を次に示します。
-
「定義項目」に示している定義項目の値だけを書き替えてください。ほかの項目や値を変更しないでください。
-
属性ファイルの内容はアプリケーション属性ファイル(cosminexus.xml)には記載しないでください。
-
属性ファイル内にある<display-name>タグのリソースアダプタの名称を変更しないでください。
-
ログ出力に関する設定で,各ログのログファイル1面当たりのファイルサイズ,およびログファイルのバックアップファイルの面数を変更した場合は,gRPCインバウンドアダプタを起動する前に,ログファイルをバックアップしておいてください。
-
- 属性ファイルの定義個所
-
属性ファイルの定義個所を次の図に示します。
図3‒8 属性ファイルの内容および定義の設定個所 - 属性ファイルの定義項目
-
属性ファイルの定義項目のうち編集できる項目を次に示します。これらは<resourceadapter>タグの<config-property>タグに設定します。
列「定義の値(指定できる内容)」に該当しない値を設定した場合,gRPCインバウンドアダプタの起動でエラーとなります。
表3‒17 属性ファイルの定義項目一覧 定義項目
定義の名称
定義の値(指定できる内容)
デフォルト値
gRPCサーバ
gRPCサーバ機能で使用するネットワークインターフェースのアドレス
bindAddress
任意のIPアドレス※1
*
gRPCサーバ機能で使用するネットワークのポート番号
port
1〜65535
28500
gRPCサーバのシャットダウン要求からgRPCサーバのシャットダウン終了までの待機時間
serverShutdownTimeout
0〜8640000000
(単位:ミリ秒)
0を指定した場合,サービスの終了を待たないでシャットダウンされます。
60000
認証機能
証明書チェーンファイルの絶対パス
certChainFile
任意のパス
(なし)
秘密鍵ファイル(PKCS #8フォーマット)の絶対パス
privateKeyFile
任意のパス
(なし)
認証局証明書ファイルの絶対パス(独自の認証局を使用しクライアント認証を実施する場合に設定)
caCertFile
任意のパス
(なし)
クライアント認証の方法
clientAuth
次のどれかを指定してください。大文字・小文字は区別されません。
-
none
クライアント認証を実施しません。
-
optional
クライアント側から証明書が提示された場合に認証を実施します。
-
require
必ずクライアント認証を実施します。
none
フロー制御
フローコントロールウィンドウのサイズ
(指定すると自動フロー制御チューニング機能が無効になる)
flowControlWindow
1〜2147483647
(単位:バイト)
(なし)
初期フローコントロールウィンドウサイズ
(指定すると自動フロー制御チューニング機能が有効になる。flowControlWindowと同時に指定した場合,flowControlWindowの設定は無効になる。flowControlWindowとinitialFlowControlWindowのどちらも指定しなかった場合,initialFlowControlWindowのデフォルト値が適用される)
initialFlowControlWindow
1〜2147483647
(単位:バイト)
1048576
キープアライブ
PINGフレームの送信間隔
keepAliveTime
10000〜8640000000
(単位:ミリ秒)
7200000
PINGフレームの送信からAcknowledgeを受信するまでの待機時間
keepAliveTimeout
10〜9223372036854
(単位:ミリ秒)
20000
接続相手からのPINGコントロールフレーム受信の最小間隔
permitKeepAliveTime
0〜9223372036854
(単位:ミリ秒)
0を指定した場合,接続相手からのPINGコントロールフレーム受信の送信間隔制限がなくなります。
300000
クライアント側で未実行のgRPC要求が存在しない場合に,PINGフレームの送信を許可するか
permitKeepAliveWithoutCalls
次のどちらかを指定してください。大文字・小文字は区別されません。
-
true
許可します。
-
false
許可しません。
false
同時に作成できるストリーム数
接続相手が同時に作成できる最大ストリーム数
(上限値を設定すると最大ストリーム数は無制限となる)
maxConcurrentCallsPerConnection
1〜2147483647
2147483647
コネクション切断
コネクションの最大接続時間
(コネクション確立からこの最大接続時間が経過した場合,実行中のサービス終了をmaxConnectionAgeGraceで指定した猶予期間だけ待機し,その後コネクションが切断される。指定しなかった場合または8640000000を設定した場合は,接続時間は無制限となる)
maxConnectionAge
60000〜8640000000
(単位:ミリ秒)
8640000000
コネクションを切断するまでの猶予期間
(この猶予期間内は未完了のサービスの終了を待機し,猶予期間内に終了しなかったサービスは強制切断される。指定しなかった場合または8640000000を設定した場合は,猶予期間は無制限となる)
maxConnectionAgeGrace
0〜8640000000
(単位:ミリ秒)
0を指定した場合,サービスの終了を待たないでコネクションが強制切断されます。
8640000000
コネクションの最大アイドル時間
(コネクション上の最後のメッセージ交換から,この最大アイドル時間を経過したコネクションは,maxConnectionAgeGraceで指定した猶予期間を経たあと切断される。指定しなかった場合または8640000000を設定した場合は,最大アイドル時間は無制限となる)
maxConnectionIdle
60000〜8640000000
(単位:ミリ秒)
8640000000
メッセージサイズ
gRPC要求電文の最大サイズ
maxInboundMessageSize
1〜2147483647
(単位:バイト)
4194304
gRPC要求電文(メタデータ)の最大サイズ
maxInboundMetadataSize
1〜2147483647
(単位:バイト)
8192
流量制御
リクエストを処理するスレッドプールのスレッド数(gRPCクライアントの同時実行数)
(指定したスレッド数を超えるリクエストを受信した場合,実行待ちキューにリクエストが追加される。スレッドに空きが発生すると,キューからリクエストが取り出されて処理される)
threadPoolSize
1〜2147483647
10
ログ出力
メッセージログの出力レベル
messagelogLevel
次のどれかを指定してください。※2
-
0
-
10
-
20
10
メソッドトレースの出力レベル
methodtraceLevel
1〜5※3
3
メソッドトレースの面数
methodtraceFilenum
1〜16
4
メソッドトレースのサイズ
methodtraceFilesize
1〜2147483647
(単位:バイト)
10485760
例外ログのログファイルの面数
exceptionlogFilenum
1〜16
4
例外ログのログファイル1面当たりのファイルサイズ
exceptionlogFilesize
1〜2147483647
(単位:バイト)
10485760
データトレースの出力有無
datatraceEnable
次のどちらかを指定してください。大文字・小文字は区別されません。
-
true
トレースを出力します。
-
false
トレースを出力しません。
false
データトレースの面数
datatraceFilenum
1〜16
4
データトレースの1面当たりのファイルサイズ
datatraceFilesize
1〜2147483647
(単位:バイト)
10485760
-
- 注※1
-
gRPCサーバ機能がgRPCクライアントからの接続要求を受け付けるネットワークインターフェースのIPアドレスを次のどれかの形式で指定します。
IPアドレスの指定方法
受け付けられるTCP/IP接続
「*」の場合
実行環境のすべてのネットワークインターフェース上にあるIPv4とIPv6の両方の接続を許可します。
なお,実行環境がIPv6アドレスをサポートしない場合は,すべてのIPv4アドレスのTCP/IP接続を受け付けます。
「0.0.0.0」の場合
すべてのIPv4ネットワークインターフェース上のTCP/IP接続を受け付けます。
「::」の場合
すべてのIPv6ネットワークインターフェース上のTCP/IP接続を受け付けます。
IPv4にマップ済みのIPv6アドレスの場合
IPv4またはIPv6のどちらかの形式で,そのアドレスのTCP/IP接続を受け付けます。
IPv4またはIPv6アドレスの場合(「127.0.0.1」や「::1」など)
該当するネットワークインターフェース上のTCP/IP接続を受け付けます。
- 注※2
-
メッセージログの出力レベルと,出力される情報を次に示します。
情報種別
出力レベル
0
10
20
エラーメッセージ
(例外や障害の発生を通知)
○
○
○
警告メッセージ
(システムを運用する上で確認が必要なものを通知)
△
○
○
インフォメーションメッセージ
(gRPCインバウンドアダプタに関する操作の実行結果を通知。起動・停止に対する応答など)
△
△
○
(凡例)
○:すべて出力されます。
△:重要なメッセージだけ出力されます。
- 注※3
-
メソッドトレースの出力レベルと,出力される情報を次に示します。
情報種別
出力レベル
1
2
3
4
5
メソッド内のエラー情報
○
○
○
○
○
外部から呼び出されるメソッド情報と,ファイル入出力メソッドの開始・終了情報
×
○
○
○
○
ほかのコンポーネントから参照するpublicメソッドの開始・終了情報
×
×
○
○
○
ほかのコンポーネントから参照しない内部メソッド(public以外のメソッド)の開始・終了情報
×
×
×
○
○
デバッグ情報
×
×
×
×
○
(凡例)
○:出力されます。
×:出力されません。
(13) Service Coordinator-Managerのセットアップ
必要に応じて,「2.4 運用環境に関する設定」を参照し,設定してください。
(14) DB Connectorのセットアップ(Reliable Messagingを使用しない場合)
HCSCサーバは,データベースと接続するためにDB Connectorを利用します。処理のタイミングやテーブル種別に応じて,データベースアクセスをトランザクション管理する場合と管理しない場合があるため,トランザクションサポート種別がXATransactionまたはLocalTransactionのDB Connectorと,トランザクションサポート種別がNoTransactionであるDB Connectorの,2つのDB Connectorを準備する必要があります。
なお,トランザクションサポート種別がXATransactionまたはLocalTransactionのDB Connectorは,処理性能を向上させるため,Reliable Messagingと連携できるDB Connectorを利用します。
それぞれのDB Connectorの表示名は,HCSCサーバセットアップ定義ファイルの「dbcon-xadisplayname」と「dbcon-nodisplayname」に指定します。HCSCサーバセットアップ定義ファイルの詳細については,マニュアル「サービスプラットフォーム リファレンス」の「6.4.3 HCSCサーバセットアップ定義ファイル」を参照してください。
(a) DB Connectorのインポート
インポートするDB Connectorは,利用条件を考慮して選択する必要があります。インポートするRARファイルの選択方法を次の表に示します。
HCSCサーバセットアップ定義ファイルのプロパティ |
利用するデータベース |
インポートするRARファイル |
---|---|---|
dbcon-xadisplayname |
HiRDB |
|
Oracle |
|
|
dbcon-nodisplayname |
HiRDB |
DBConnector_HiRDB_Type4_CP.rar |
Oracle |
DBConnector_Oracle_CP.rar |
また,DBアダプタを利用する場合は,DBアダプタが利用するDB Connectorをインポートします。インポートするRARファイルの選択方法を次の表に示します。
DB Connectorのインポート方法については,マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.2 データベースと接続するための設定」を参照してください。また,プロパティ定義については,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1 Connector属性ファイル」を参照してください。
ライトトランザクション機能については,マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.14.5 ライトトランザクション」を参照してください。また,設定方法については,マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.8.6 トランザクションの設定」を参照してください。
(b) プロパティの定義
DB Connectorをインポートしたあと,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1 Connector属性ファイル」を参照して,プロパティを定義してください。ただし,次の表に示す内容をプロパティに設定する必要があります。
設定項目 |
設定値 |
|
---|---|---|
<display-name>タグ |
DB Connector表示名 |
|
<config-property>タグに設定するdatabaseNameプロパティ |
データベース名※1 |
|
<config-property>タグに設定するbufSizeプロパティ |
システムで利用する最大の電文長よりも大きな値※2 |
|
<transaction-support>タグ |
ライトトランザクション機能を利用しない場合 |
XATransaction※3 |
ライトトランザクション機能を利用する場合 |
LocalTransaction※4 |
|
<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ |
ビジネスプロセスの最大同時実行数以上の値※5 |
- 注※1
-
使用するDB Connectorによって設定値が異なります。設定値については,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1 Connector属性ファイル」を参照してください。また,データベースに接続するために必要な情報もあわせて設定してください。
- 注※2
-
次のDB Connectorを使用し,LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。
・DBConnector_DABJ_XA.rar
・DBConnector_DABJ_CP.rar
- 注※3
-
次のDB Connectorに対して指定してください。
・DBConnector_DABJ_XA.rar
・DBConnector_Oracle_XA.rar
- 注※4
-
次のDB Connectorに対して指定してください。
・DBConnector_DABJ_CP.rar
・DBConnector_Oracle_CP.rar
- 注※5
-
他の機能でdbcon-xadisplaynameに設定したDB Connectorを使用する場合は,その機能の同時実行数を含めた値を指定してください。
設定項目 |
設定値 |
|
---|---|---|
<display-name>タグ |
DB Connector表示名 |
|
<config-property>タグに設定するmaxBinarySizeプロパティ |
システムで利用する最大の電文長よりも大きな値※1 |
|
<transaction-support>タグ |
ライトトランザクション機能を利用しない場合 |
XATransaction※2 |
ライトトランザクション機能を利用する場合 |
LocalTransaction※3 |
|
<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ |
ビジネスプロセスの最大同時実行数以上の値※4 |
- 注※1
-
LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。また,必ず0以外の値を指定してください。
- 注※2
-
次のDB Connectorに対して指定してください。
・DBConnector_HiRDB_Type4_XA.rar
- 注※3
-
次のDB Connectorに対して指定してください。
・DBConnector_HiRDB_Type4_CP.rar
- 注※4
-
他の機能でdbcon-xadisplaynameに設定したDB Connectorを使用する場合は,その機能の同時実行数を含めた値を指定してください。
- 注意
-
データベースに接続するために必要な情報を設定してください。設定値については,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1 Connector属性ファイル」を参照してください。
設定項目 |
設定値 |
---|---|
<display-name>タグ |
DB Connector表示名 |
<config-property>タグに設定するdatabaseNameプロパティ |
データベース名※1 |
<config-property>タグに設定するbufSizeプロパティ |
システムで利用する最大の電文長よりも大きな値※2 |
<transaction-support>タグ |
NoTransaction※3 |
<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ |
1以上の値※4 |
- 注※1
-
使用するデータベースによって設定値が異なります。設定値については,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1 Connector属性ファイル」を参照してください。また,データベースに接続するために必要な情報もあわせて設定してください。
- 注※2
-
次のDB Connectorを使用し,LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。
・DBConnector_DABJ_CP.rar
- 注※3
-
次のDB Connectorを使用する場合に指定してください。
・DBConnector_DABJ_CP.rar
・DBConnector_Oracle_CP.rar
- 注※4
-
他の機能でdbcon-nodisplaynameに設定したDB Connectorを使用する場合は,その機能の同時実行数を含めた値を指定してください。
設定項目 |
設定値 |
---|---|
<display-name>タグ |
DB Connector表示名 |
<config-property>タグに設定するmaxBinarySizeプロパティ |
システムで利用する最大の電文長よりも大きな値※1 |
<transaction-support>タグ |
NoTransaction※2 |
<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ |
1以上の値※3 |
- 注※1
-
LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。また,必ず0以外の値を指定してください。
- 注※2
-
次のDB Connectorを使用する場合に指定してください。
・DBConnector_HiRDB_Type4_CP.rar
- 注※3
-
他の機能でdbcon-nodisplaynameに設定したDB Connectorを使用する場合は,その機能の同時実行数を含めた値を指定してください。
- 注意
-
データベースに接続するために必要な情報を設定してください。設定値については,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1 Connector属性ファイル」を参照してください。
設定項目 |
設定値 |
---|---|
<display-name>タグ |
DB Connector表示名※1 |
<config-property>タグに設定するdatabaseNameプロパティ |
データベース名※2 |
<transaction-support>タグ |
XATransaction |
LocalTransaction |
|
<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ |
DBアダプタの最大同時実行数以上の値※3 |
- 注※1
-
この値は,DBアダプタのアプリケーション統合属性ファイルの<linked-to>タグにも設定します。アプリケーション統合属性ファイルについては,マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.5 DBアダプタを定義する」を参照してください。
- 注※2
-
使用するDB Connectorによって設定値が異なります。設定値については,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1 Connector属性ファイル」を参照してください。
- 注※3
-
他の機能でDBアダプタに指定したDBコネクタを使用する場合,その機能の同時実行数を含めた値を指定してください。