リソースアダプタのプロパティ設定

Cosminexus アプリケーションサーバ V8　アプリケーション開発ガイド

インポートしたリソースアダプタをJ2EEアプリケーションで使用するためには，リソースアダプタのプロパティを設定する必要があります。ここでは，デプロイされたリソースアダプタの設定手順を説明します。リソースアダプタのプロパティ設定には，サーバ管理コマンド（cjgetrarpropおよびcjsetrarprop）を使用します。

注意: リソースアダプタのプロパティを編集する前に，必ずJ2EEアプリケーションを停止してください。

次の手順でリソースアダプタのプロパティを設定してください。

なお，リソースアダプタのプロパティを設定するためには，次の条件を満たしている必要があります。

Management Serverリモート管理にログインしていること。
J2EEサーバが開始していること。
リソースアダプタが停止していること。

Connector属性ファイルを取得します。
cjgetrarprop <J2EEサーバ名> -resname <リソースアダプタの表示名> -c <Connector属性ファイルのパス>
cjgetrarpropコマンドの詳細は，マニュアル「Cosminexus アプリケーションサーバリファレンスコマンド編」の「cjgetrarprop（RARファイルの属性の取得）」を参照してください。

取得したConnector属性ファイルをテキストエディタで編集します。
設定する項目と設定例を次に示します。

<hitachi-connector-property>
  (略)
  <resourceadapter>
    <outbound-resourceadapter>
      <connection-definition>
        (略)
        <config-property>
          <description xml:lang="en"/>
          <config-property-name>networkProtocol</config-property-name>
          <config-property-type>java.lang.String</config-property-type>
          <config-property-value>lib</config-property-value> … Cosminexus DABroker Libraryとの接続種別を設定します。
        </config-property>
        <config-property>
          <description xml:lang="en"/>
          <config-property-name>databaseName</config-property-name>
          <config-property-type>java.lang.String</config-property-type>
          <config-property-value>HIRDB</config-property-value> … 接続するデータベースの種別を設定します。
        </config-property>
        <config-property>
          <description xml:lang="en"/>
          <config-property-name>description</config-property-name>
          <config-property-type>java.lang.String</config-property-type>
          <config-property-value>22200</config-property-value> … 組み込みデータベースのポート番号を指定します。
        </config-property>
        <config-property>
          <description xml:lang="en"/>
          <config-property-name>DBHostName</config-property-name>
          <config-property-type>java.lang.String</config-property-type>
          <config-property-value>localhost</config-property-value> … 接続する組み込みデータベースのホスト名を設定します。
        </config-property>
        (略)
        <connector-runtime>
          <property>
            <property-name>User</property-name>
            <property-type>String</property-type>
            <property-value>USER1</property-value> … ユーザ名を設定します。^※¹
          </property>
          <property>
            <property-name>Password</property-name>
            <property-type>String</property-type>
            <property-value>PSWD</property-value> … パスワードを設定します。^※¹
          </property>
          <property>
            <property-name>MaxPoolSize</property-name>
            <property-type>int</property-type>
            <property-value>8</property-value> … コネクション・プールの最小値を設定します。^※²
          </property>

          <property>
            <property-name>MinPoolSize</property-name>
            <property-type>int</property-type>
            <property-value>1</property-value> … コネクション・プールの最大値を設定します。^※²
          </property>
        </connector-runtime>
        (略)
      </connection-definition>
      (略)
    </outbound-resourceadapter>
  </resourceadapter>

</hitachi-connector-property>

注※1: 「付録B.3(1)　組み込みデータベースの構築手順」で設定したユーザ名とパスワードを入力してください。

注※2: リソースアダプタの開始時にコネクションプールの最小値および最大値を指定していない場合は，メッセージ（KDJE49513-W）が［コンソール］ビューに出力されます。

Connector属性ファイルの詳細は，マニュアル「Cosminexus アプリケーションサーバリファレンス定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

Connector属性を設定します。
cjsetrarprop <J2EEサーバ名> -resname <リソースアダプタの表示名> -c <Connector属性ファイルのパス>
cjsetrarpropコマンドの詳細は，マニュアル「Cosminexus アプリケーションサーバリファレンスコマンド編」の「cjsetrarprop（RAR属性設定）」を参照してください。
リソースアダプタの接続テストを実施します。
cjtestres <J2EEサーバ名> -type rar -resname <リソースアダプタの表示名>
接続できない場合は，手順2からやり直してください。
cjtestresコマンドの詳細は，マニュアル「Cosminexus アプリケーションサーバリファレンスコマンド編」の「cjtestres（リソースの接続テスト）」を参照してください。
J2EEアプリケーションをデプロイしたあとに編集した場合は，MyEclipseからJ2EEアプリケーションを開始します。
MyEclipseからのJ2EEアプリケーションの開始は，プロジェクトの入れ替え機能を使用します。
MyEclipseを使用した入れ替えの手順については，「8.4　プロジェクトの入れ替え」を参照してください。MyEclipseのリデプロイでは，プロジェクトの入れ替えおよびJ2EEアプリケーションの開始を実施します。

付録B.4 リソースアダプタのプロパティ設定

付録B.4　リソースアダプタのプロパティ設定