付録C.1 環境構築のサンプル手順

SessionBean1を動作させるためのCosminexus RMの環境構築のサンプル手順について説明します。

なお,J2EEサーバやリソースアダプタの操作では,Cosminexus Management Serverから行う方法とコマンドを使用して行う方法がありますが,ここではコマンドを使用して行う方法について説明します。

<この項の構成>
(1) 前提となるマシンとソフトウェア構成
(2) 事前準備
(3) 環境構築手順

(1) 前提となるマシンとソフトウェア構成

ここで説明するサンプル手順は,次に示すマシンとソフトウェア構成を前提として,Cosminexus RMの環境を構築します。

図C-1 前提となるマシンとソフトウェア構成

[図データ]

各構成要素の項目について次の表に説明します。

表C-1 構成要素の項目

構成要素名項目項目情報
Cosminexus稼働マシンOSWindows
Cosminexus(J2EEサーバ)インストールディレクトリC:¥Program Files¥Hitachi¥Cosminexus
J2EEサーバ名称MyServer
CORBAネーミングサービス(nameserv)のポート番号900
Cosminexus RM表示名Cosminexus_Reliable_Messaging
リソースアダプタ種別永続版リソースアダプタ
Cosminexus RMのシステム名CRM
利用トランザクション種別ローカルトランザクション
コネクションプール利用数2(最大/最小)
作成するキューキュー種別:ローカルキュー
キューの永続性:永続
キュー名:localq1
表示名:QUEUE1
DB Connector for Cosminexus RM表示名DB_Connector_for_HiRDB_Type4_Cosminexus_RM
種別HiRDB Type4 JDBC Driver用(ローカルトランザクション)
JDBCドライバドライバ種別HiRDB Type4 JDBCドライバ
DBMSDB種別HiRDB Single Server Version8
ポート番号22200
Cosminexus RM用の管理情報テーブルを作成するRDエリア名RDDATA10

(2) 事前準備

サンプル手順を利用してCosminexus RMの環境を構築する前に,次の作業を実施しておく必要があります。

(a) インストール

Cosminexus RMおよびCosminexus RMの前提製品をすべてインストールします。詳細については,「3.2 Cosminexus RMのインストール」を参照してください。

(b) 環境変数の設定

Cosminexus RMが動作するマシンで,次に示す環境変数を設定します。詳細については,「3.3.2 環境変数の設定」を参照してください。

表C-2 設定する環境変数

環境変数設定値説明
HRMDIRC:¥Program Files¥Hitachi¥Cosminexus¥RM
HRM_SYSTEM_NAMECRM
HRM_CMD_PORT900CORBAネーミングサービス(nameserv)のポート番号です。
HRM_CMD_HOSTlocalhost
PATH%PATH%;%HRMDIR%¥binコマンドが格納されたディレクトリです。
(凡例)
-:特にありません。

(c) DBMS(HiRDB)のインストールと初期設定

HiRDBサーバ,HiRDBクライアント,およびSQL Executerをインストールして,初期設定します。詳細については,「3.4.1(1)(a) HiRDBの初期設定」および「3.4.1(2) DBクライアントの設定」を参照してください。

(d) DBMS(HiRDB)のユーザ権限の付与とスキーマの定義

HiRDBサーバで,ユーザ権限の付与とスキーマの定義を実施します。詳細については,「3.4.1(1)(b) HiRDBのユーザ権限の付与」および「3.4.1(1)(c) HiRDBのスキーマの定義」を参照してください。

(e) HiRDB Type4 JDBC Driverの設定

HiRDB Type4 JDBC Driverの設定をします。詳細については,「3.4.7(3) HiRDB Type4 JDBC Driverの設定」を参照してください。

(f) J2EEサーバ(Cosminexus)の設定

J2EEサーバ(Cosminexus)をセットアップします。詳細については,「3.4.3 J2EEサーバ(Cosminexus)の設定」を参照してください。

(g) その他の設定

環境構築のための作業ディレクトリとして「D:¥work」を作成します。作成したディレクトリには,読み取り権限および書き込み権限を設定します。

(3) 環境構築手順

Cosminexus RMの環境構築のサンプル手順を次に示します。

(a) Cosminexus RMの管理情報テーブルの作成
  1. 次のコマンドを実行して,テーブル作成用SQLファイルを作業ディレクトリにコピーします。

    copy "C:¥Program Files¥Hitachi¥Cosminexus¥RM¥sql¥createtableshirdb.sql" D:¥work

  2. コピーしたSQLファイル(D:¥work¥createtableshirdb.sql)をテキストエディタで開き,ファイル中の次の記述を置き換えて保存します。
    <RMSystemName> → CRM
    <RMAREA> → RDDATA10
  3. 次のコマンドを実行して,HiRDB SQL Executerを開始します。

    pdsqlw -u <DBへの接続ユーザ名>/<パスワード> -h localhost -n 22200

  4. HiRDB SQL Executerの[ファイル]メニューから[ファイルから実行]を選択し,「D:¥work¥createtableshirdb.sql」を指定して実行します。
(b) J2EEサーバの起動

次のコマンドを実行して,J2EEサーバを起動します。

cjstartsv MyServer

(c) Cosminexus RMのプロパティ定義
  1. 次のコマンドを実行して,作業ディレクトリにCosminexus RMのConnector属性ファイルのテンプレートをコピーします。

    copy "C:¥Program Files¥Hitachi¥Cosminexus¥RM¥conf¥rm_prop.xml" D:¥work

  2. コピーしたConnector属性ファイルのテンプレート(D:¥work¥rm_prop.xml)をテキストエディタで開き,次のように設定します。
    コンフィグレーションプロパティ(<config-property-name>タグ)
    プロパティ名設定値
    RMSystemNameCRM
    RMLinkedDBConnectorNameDB_Connector_for_HiRDB_Type4_Cosminexus_RM
    実行時プロパティ(<property>タグ)
    プロパティ名設定値
    MaxPoolSize2
    MinPoolSize2
    User<DBユーザ>
    Password<DBパスワード>
    トランザクションサポートレベル(<transaction-support>タグ)
    タグ名設定値
    <transaction-support>LocalTransaction
(d) DB Connector for Cosminexus RMのプロパティ定義
  1. 次のコマンドを実行して,作業ディレクトリにDB Connector for Cosminexus RMのConnector属性ファイルのテンプレートをコピーします。

    copy "C:¥Program Files¥Hitachi¥Cosminexus¥CC¥admin¥templates¥DBConnector_HiRDB_Type4_CP_Cosminexus_RM_cfg.xml"  D:¥work

  2. コピーしたConnector属性ファイルのテンプレート(D:¥work¥DBConnector_HiRDB_Type4_CP_Cosminexus_RM_cfg.xml)をテキストエディタで開き,次のように設定します。
    コンフィグレーションプロパティ(<config-property-name>タグ)
    プロパティ名設定値
    linkedResourceAdapterNameCosminexus_Reliable_Messaging
    description22200
    DBHostNamelocalhost
    environmentVariablesPDSWAITTIME=600;PDCWAITTIME=600;PDSWATCHTIME=0
    実行時プロパティ(<property>タグ)
    プロパティ名設定値
    MaxPoolSize2
    MinPoolSize2
    User<DBユーザ>
    Password<DBパスワード>
    トランザクションサポートレベル(<transaction-support>タグ)
    タグ名設定値
    <transaction-support>LocalTransaction
(e) DB Connector for Cosminexus RMのインポート

次のコマンドを実行して,DB Connector for Cosminexus RMをインポートします。

cjimportres MyServer -type rar -f "C:¥Program Files¥Hitachi¥Cosminexus¥CC¥DBConnector¥ReliableMessaging¥DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rar"

(f) Cosminexus RMのインポート

次のコマンドを実行して,Cosminexus RMをインポートします。

cjimportres MyServer -type rar -f "C:¥Program Files¥Hitachi¥Cosminexus¥RM¥lib¥reliablemessaging.rar"

(g) DB Connector for Cosminexus RMのプロパティ設定

次のコマンドを実行して,DB Connector for Cosminexus RMのプロパティを設定します。

cjsetresprop MyServer -type rar -resname DB_Connector_for_HiRDB_Type4_Cosminexus_RM -c D:¥work¥DBConnector_HiRDB_Type4_CP_Cosminexus_RM_cfg.xml

(h) Cosminexus RMのプロパティ設定

次のコマンドを実行して,Cosminexus RMのプロパティを設定します。

cjsetresprop MyServer -type rar -resname Cosminexus_Reliable_Messaging -c D:¥work¥rm_prop.xml

(i) DB Connector for Cosminexus RMのデプロイ

次のコマンドを実行して,DB Connector for Cosminexus RMをデプロイします。

cjdeployrar MyServer -resname DB_Connector_for_HiRDB_Type4_Cosminexus_RM

(j) Cosminexus RMのデプロイ

次のコマンドを実行して,Cosminexus RMをデプロイします。

cjdeployrar MyServer -resname Cosminexus_Reliable_Messaging

(k) DB Connector for Cosminexus RMの開始

次のコマンドを実行して,DB Connector for Cosminexus RMを開始します。

cjstartrar MyServer -resname DB_Connector_for_HiRDB_Type4_Cosminexus_RM

(l) Cosminexus RMの接続テスト

次のコマンドを実行して,Cosminexus RMの接続テストを実施します。

cjtestres MyServer -type rar -resname Cosminexus_Reliable_Messaging

接続テストに失敗した場合は,出力されるメッセージに従って対処し,再度接続テストを実施してください。

(m) Cosminexus RMの開始

次のコマンドを実行して,Cosminexus RMを開始します。

cjstartrar MyServer -resname Cosminexus_Reliable_Messaging

(n) キューの作成

次のコマンドを実行して,Cosminexus RMのキューを作成します。

hrmmkque -t local -x QUEUE1 localq1

(o) Cosminexus RMの状態遷移

次のコマンドを実行して,Cosminexus RMを実行状態にします。

hrmstart