3.4.1 DBMSの設定(HiRDBを使用する場合)

HiRDBを使用する場合のDBMSの設定について説明します。説明する以外の設定内容や手順については,HiRDBのマニュアルを参照してください。

<この項の構成>
(1) DBMSの初期設定(HiRDBを使用する場合)
(2) DBクライアントの設定
(3) Cosminexus RMの管理情報テーブルの作成

(1) DBMSの初期設定(HiRDBを使用する場合)

(a) HiRDBの初期設定

HiRDBをインストールしたら,環境設定をします。Cosminexus RMの管理情報テーブルを格納するためのRDエリアを作成してください。HiRDBの環境設定については,マニュアル「HiRDB システム導入・設計ガイド」を参照してください。

なお,HiRDBを環境設定するときに使用する文字コードは,Cosminexus DABroker Libraryに設定した漢字コードセットに合わせてください。文字コードの選択については,マニュアル「HiRDB システム導入・設計ガイド」を参照してください。

(b) HiRDBのユーザ権限の付与

HiRDBでは"ユーザの作成"という操作がなく,ユーザ権限の一つであるCONNECT権限をユーザに付与することによってユーザが作成されます。ユーザ権限については,マニュアル「HiRDB システム運用ガイド」を参照してください。

Cosminexus RMはHiRDBの接続ユーザを使用してHiRDBにアクセスします。Cosminexus RMで使用する接続ユーザには,次に示すユーザ権限を付与してください。

ユーザ権限を付与するには,データベース定義ユティリティ(pddef)またはHiRDB SQL Executerを使用します。ここでは,データベース定義ユティリティ(pddef)を使用してユーザ権限を付与する場合の手順を説明します。Cosminexus RMが動作するマシンまたはHiRDBが動作するマシンで,次に示す手順を実行してください。データベース定義ユティリティ(pddef)の使用方法については,マニュアル「HiRDB コマンドリファレンス」を参照してください。

  1. 環境変数の設定
    次に示す環境変数を設定します。
    Windowsの場合

    SET PDHOST = <HiRDBサーバのホスト名またはIPアドレス>
    SET PDNAMEPORT = <HiRDBサーバのポート番号>
    SET PDUSER = <DBA権限を持つユーザ名>/<パスワード>

    UNIX(csh)の場合

    setenv PDHOST <HiRDBサーバのホスト名またはIPアドレス>
    setenv PDNAMEPORT <HiRDBサーバのポート番号>
    setenv PDUSER <DBA権限を持つユーザ名>/<パスワード>

    UNIX(sh)の場合

    PDHOST=<HiRDBサーバのホスト名またはIPアドレス>
    PDNAMEPORT=<HiRDBサーバのポート番号>
    PDUSER=<DBA権限を持つユーザ名>/<パスワード>
    export PDHOST
    export PDNAMEPORT
    export PDUSER

  2. データベース定義ユティリティ(pddef)の開始
    次に示すとおりコマンドを入力して,データベース定義ユティリティ(pddef)を開始します。

    pddef

  3. SQL文の実行
    次に示すSQL文を実行します。

    GRANT  CONNECT  TO  <権限を付与する接続ユーザ名>
                 IDENTIFIED  BY  <パスワード>;
    GRANT  SCHEMA   TO  <権限を付与する接続ユーザ名>;

    注※
    Cosminexus RMが使用する接続ユーザの名前です。HiRDBのクライアント環境変数グループに登録したPDUSER環境変数と同じ値になります。PDUSER環境変数については,「(2)(b) HiRDBの環境変数グループの登録」を参照してください。
     
  4. データベース定義ユティリティ(pddef)の終了
    データベース定義ユティリティ(pddef)を終了するには,
    Windowsの場合
    CtrlキーとZキーを同時に押したあと,Enterキーを押してください。
    UNIXの場合
    CtrlキーとDキーを同時に押してください。
(c) HiRDBのスキーマの定義

Cosminexus RMの管理情報テーブル用のスキーマを定義します。

スキーマを定義するには,データベース定義ユティリティ(pddef)またはHiRDB SQL Executerを使用します。ここでは,データベース定義ユティリティ(pddef)を使用してスキーマ定義する場合の手順を説明します。Cosminexus RMが動作するマシンまたはHiRDBが動作するマシンで,次に示す手順を実行してください。データベース定義ユティリティ(pddef)の使用方法については,マニュアル「HiRDB コマンドリファレンス」を参照してください。

  1. 環境変数の設定
    次に示す環境変数を設定します。
    Windowsの場合

    SET PDHOST = <HiRDBサーバのホスト名またはIPアドレス>
    SET PDNAMEPORT = <HiRDBサーバのポート番号>
    SET PDUSER = <接続ユーザ名>/<パスワード>

    UNIX(csh)の場合

    setenv PDHOST <HiRDBサーバのホスト名またはIPアドレス>
    setenv PDNAMEPORT <HiRDBサーバのポート番号>
    setenv PDUSER <接続ユーザ名>/<パスワード>

    UNIX(sh)の場合

    PDHOST=<HiRDBサーバのホスト名またはIPアドレス>
    PDNAMEPORT=<HiRDBサーバのポート番号>
    PDUSER=<接続ユーザ名>/<パスワード>
    export PDHOST
    export PDNAMEPORT
    export PDUSER

    注※
    接続ユーザ名には,権限を付与した接続ユーザ名を指定します。詳細については,「(1)(b) HiRDBのユーザ権限の付与」を参照してください。
     
  2. データベース定義ユティリティ(pddef)の開始
    次に示すとおりコマンドを入力して,データベース定義ユティリティ(pddef)を開始します。

    pddef

  3. SQL文の実行
    次に示すSQL文を実行します。

    CREATE SCHEMA;

  4. データベース定義ユティリティ(pddef)の終了
    データベース定義ユティリティ(pddef)を終了するには,
    Windowsの場合
    CtrlキーとZキーを同時に押したあと,Enterキーを押してください。
    UNIXの場合
    CtrlキーとDキーを同時に押してください。
(d) HiRDBのRDエリアの準備

Cosminexus RMの管理情報テーブルを格納するために,必要に応じてRDエリアを作成します。RDエリアの作成方法については,マニュアル「HiRDB システム運用ガイド」を参照してください。

複数のユーザでCosminexus RMにアクセスする際にアプリケーション認証を使用する場合は,公用RDエリアを作成し,その公用RDエリアにCosminexus RMの管理情報テーブルを作成します。

(e) HiRDBの排他資源と同時アクセス可能実表数の見積もり

HiRDBの排他資源および同時アクセス可能実表数の見積もりについては,「付録F HiRDBの見積もり」を参照してください。

(2) DBクライアントの設定

次に示す製品をインストールしたら,Cosminexus RMが動作するマシンで設定をします。

(a) HiRDBの環境変数の設定

次に示す環境変数を設定します。

上記の表に示したとおり,Cosminexus RMのDBコネクション使用数は次の値になります。

6+送信スレッドの起動数+メッセージ受信リクエスト数

なお,CosminexusのJ2EEコンポーネントからHiRDBにアクセスする場合は,J2EEコンポーネントが利用するコネクション数に,Cosminexus RMのDBコネクション使用数を加えた値を指定します。

 

注意
HiRDBのクライアント環境定義PDDBLOGには,NOを指定しないでALLを指定してください。
(b) HiRDBの環境変数グループの登録

HiRDBの環境変数グループの登録方法を次に示します。

Windowsの場合
DABroker対応のDB Connector for Cosminexus RMを使用するときは,HiRDBクライアント環境変数登録ツールを使用して環境変数のグループを登録します。[システムグループ]ラジオボタンを選択して環境変数グループ名を登録してください。
HiRDB Type4 JDBCドライバ対応のDB Connector for Cosminexus RMを使用するときは,環境変数のグループは,HiRDBのクライアント環境変数グループの設定ファイルに登録します。
UNIXの場合
環境変数のグループは,HiRDBのクライアント環境変数グループの設定ファイルに登録します。

登録方法については,マニュアル「HiRDB UAP開発ガイド」を参照してください。

ここで登録した環境変数グループ名は,DB Connector for Cosminexus RMのコンフィグレーションプロパティで,XAOpen文字列として設定する必要があります。DB Connector for Cosminexus RMのコンフィグレーションプロパティについては,「6.3 DB Connector for Cosminexus RMのコンフィグレーションプロパティの一覧」を参照してください。

HiRDBのクライアント環境変数グループに登録する内容について,次の表に示します。

表3-3 HiRDBのクライアント環境変数グループに登録する内容

項番環境変数名設定内容
1PDHOSTHiRDBサーバのホスト名またはIPアドレスを指定します。
2PDUSERHiRDBサーバのユーザ名※1およびパスワードを指定します。
3PDNAMEPORTHiRDBサーバのポート番号を指定します。
4PDSWAITTIME※2Cosminexus Component Containerのトランザクションタイムアウトの値※3よりも大きな値を指定します。
5PDCWAITTIME※2Cosminexus Component Containerのトランザクションタイムアウトの値※3よりも大きな値を指定します。
6PDSWATCHTIME0を指定します。
注※1
Cosminexus RMがHiRDBの管理するDBにアクセスするために使用する接続ユーザの名前です。
共用キューを使用して複数システム間でのアプリケーション連携をする場合は,送信側システムと受信側システムで同じ接続ユーザ名を指定します。
注※2
HiRDBを使用する場合,Cosminexus RMのトランザクション決着中に,HiRDBの設定値であるPDSWAITTIMEおよびPDCWAITTIMEに指定した値によってタイムアウトが発生しDBがロールバックすると,Cosminexus RMは閉塞することがあります。このため,PDSWAITTIMEおよびPDCWAITTIMEには,適切な値を設定してください。PDSWAITTIMEおよびPDCWAITTIMEについては,マニュアル「HiRDB システム導入・設計ガイド」を参照してください。なお,Cosminexus RMが閉塞した場合は,Cosminexusを強制停止したあと,再起動してください。
注※3
Cosminexus Component Containerのトランザクションタイムアウト値はJ2EEサーバ用ユーザプロパティファイルまたはUserTransaction.setTransactionTimeout()メソッドで指定します。J2EEサーバ用ユーザプロパティファイルについては,マニュアル「Cosminexus リファレンス 定義編(サーバ定義)」を参照してください。UserTransaction.setTransactionTimeout()メソッドについては,Javaのドキュメントを参照してください。

(3) Cosminexus RMの管理情報テーブルの作成

DBMSとしてHiRDBを使用する場合,次に示す手順で管理情報テーブルを作成します。HiRDB SQL Executerの使用方法については,HiRDB SQL Executerのドキュメントを参照してください。

  1. コンフィグレーションプロパティのRMSystemNameに指定する値(3文字以内の英数字)の決定
    RMSystemNameについては,「6.2 Cosminexus RMのコンフィグレーションプロパティの詳細説明」を参照してください。
  2. SQLファイルの編集
    テーブル作成用SQLファイル(%HRMDIR%¥sql¥createtableshirdb.sql)を任意の場所にコピーしてから,このファイルをテキストエディタで開き,ファイル中の5か所の"<RMSystemName>"の部分を手順1.で決定したRMSystemNameの指定値で置き換えて,ファイルを保存します。
    また,必要に応じて"<RMAREA>"の部分を表の行を格納するRDエリア名に変更します。または"IN <RMAREA>"の部分を削除します。"IN <RMAREA>"の部分を削除した場合は,格納するRDエリアをHiRDBが決定します。HiRDBが決定するRDエリアについては,マニュアル「HiRDB SQLリファレンス」を参照してください。
  3. SQLファイルの実行
    Windowsの場合
    次に示すコマンドでHiRDB SQL Executerを開始します。

    pdsqlw -u <接続ユーザ名>/<パスワード>
          -h <HiRDBサーバのホスト名またはIPアドレス>
          -n <HiRDBサーバのポート番号>

    HiRDB SQL Executerの[ファイル]メニューから[ファイルから実行]を選択し,手順2.で編集したSQLファイルを指定して実行します。
     
    UNIXの場合
    環境変数PDUSER,PDHOST,PDNAMEPORTを設定し,次に示すコマンドでHiRDB SQL ExecuterからSQLファイルを実行します。

    pdsql  <  <手順2.で編集したSQLスクリプトファイルのパス>

     
    注※
    接続ユーザ名には,権限を付与した接続ユーザ名を指定します。詳細については,「(1)(b) HiRDBのユーザ権限の付与」を参照してください。
    共用キューを使用して複数システム間でのアプリケーション連携をする場合には,送信側システムと受信側システムで同じ接続ユーザ名を使用します。