8.8.3 リソースアダプタのインポートと開始

DB Connectorを使用する場合と,ほかのリソースアダプタを使用する場合で,Connector属性ファイルの取得方法が異なります。使用するリソースアダプタごとにインポートと開始について説明します。リソースアダプタのインポートと開始には,サーバ管理コマンドを使用します。サーバ管理コマンドについては,マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「2.4 J2EEサーバで使用するリソース操作コマンド」を参照してください。サーバ管理コマンドでのリソースアダプタの操作については,マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「4. リソースアダプタの設定」を参照してください。

参考
サーバ管理コマンドの指定値について
サーバ管理コマンドの引数に指定するサーバ名
サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。簡易構築定義ファイル作成時に実サーバ名を設定していない場合,実サーバ名は論理サーバ名と同じです。なお,論理サーバ名の設定を省略している場合,論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」の形式で定義されます。論理サーバの種類と<種別>との対応を次の表に示します。

表8-4 論理サーバの種類と<種別>との対応

論理サーバの種類<種別>
論理WebサーバHTTP
論理J2EEサーバJ2EE
論理パフォーマンストレーサPRF
論理SFOサーバSFO
論理CTMドメインマネジャCTMDM
論理CTMCTM
論理スマートエージェントSA
論理ユーザサーバUSER
なお,<通番>は,基本的に「01」が設定されます。ただし,CTMを使用するシステムのように論理サーバを複数配置する場合は,重複しない番号が割り振られます。
サーバ管理コマンドを使用する操作
ここで説明する操作のうち,サーバ管理コマンドを使用する操作は,サービスユニットごとに実行します。
なお,ここで示すサーバ管理コマンドの実行例は,すべてサービスユニット1を対象としています。サービスユニット2に対しても,コマンド実行例中の値を次のように読み替えて同じ操作をしてください。
J2EEサーバ名:cmx_MyWebSystem_unit2_J2EE_01
-nameserver指定値:corbaname::192.168.1.12:900
<この項の構成>
(1) DB Connectorのインポートと開始
(2) DB Connector以外のリソースアダプタのインポートと開始

(1) DB Connectorのインポートと開始

DB Connectorを使用する場合のインポートと開始について説明します。ここでは,次に示すリソースアダプタをインポートして開始する手順を例にして説明します。

表8-5 例で使用するリソースアダプタのファイル名と表示名

種別名前
ファイル名DBConnector_HiRDB_Type4_CP.rar
表示名DB_Connector_for_HiRDB_Type4
Connector属性ファイルのファイル名MyDBConnectorAttr.xml

注※ HiRDB Type4 JDBC Driverを使用して,ローカルトランザクションまたはトランザクション管理なしでHiRDBに接続する場合に使用するRARファイルです。


なお,「8.5 DB ConnectorのConnector属性ファイルの編集」でConnector属性ファイルの取得と編集が済んでいることを前提にしています。

DB Connectorを使用する場合のリソースアダプタのインポートと開始の手順を次に示します。なお,説明では「8.6 システムの一括構築」で構築したシステムを使用します。

  1. リソースアダプタをインポートします。
    サーバ管理コマンドを使用して,リソースアダプタをJ2EEサーバへインポートします。
    Windowsの場合

    <Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjimportres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -type rar -f <Cosminexusのインストールディレクトリ>¥CC¥DBConnector¥DBConnector_HiRDB_Type4_CP.rar

    UNIXの場合

    # /opt/Cosminexus/CC/admin/bin/cjimportres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -type rar -f /opt/Cosminexus/CC/DBConnector/DBConnector_HiRDB_Type4_CP.rar

  2. リソースアダプタをデプロイします。
    サーバ管理コマンドを使用して,J2EEサーバにリソースアダプタをデプロイします。
    Windowsの場合

    <Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjdeployrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

    UNIXの場合

    # /opt/Cosminexus/CC/admin/bin/cjdeployrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

  3. 編集したConnector属性ファイルをリソースアダプタに反映します。
    サーバ管理コマンドを使用して,Connector属性ファイルをリソースアダプタに反映します。-cオプションには,「8.5 DB ConnectorのConnector属性ファイルの編集」で編集したConnector属性ファイルを指定します。
    Windowsの場合

    <Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>¥MyDBConnectorAttr.xml

    UNIXの場合

    # /opt/Cosminexus/CC/admin/bin/cjsetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4 -c <任意のディレクトリ>/MyDBConnectorAttr.xml

  4. リソースアダプタの接続を確認します。
    サーバ管理コマンドを使用して,リソースアダプタの接続を確認します。
    Windowsの場合

    <Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjtestres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

    UNIXの場合

    # /opt/Cosminexus/CC/admin/bin/cjtestres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

  5. リソースアダプタを開始します。
    サーバ管理コマンドを使用して,リソースアダプタを開始します。
    Windowsの場合

    <Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

    UNIXの場合

    # /opt/Cosminexus/CC/admin/bin/cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname DB_Connector_for_HiRDB_Type4

(2) DB Connector以外のリソースアダプタのインポートと開始

DB Connector以外のリソースアダプタを使用する場合のインポートと開始について説明します。

ここでは,次に示すリソースアダプタをインポートして開始する手順を例にして説明します。

表8-6 例で使用するリソースアダプタのファイル名と表示名

種別名前
ファイル名MyResourceAdapter.rar
表示名MyResourceAdapter
Connector属性ファイルのファイル名MyResourceAdapter.xml

なお,提供されるRARファイルの種類や使い分けについては,マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.3.2 リソースアダプタの種類」を参照してください。

DB Connector以外のリソースアダプタを使用する場合のリソースアダプタのインポートと開始の手順を次に示します。なお,説明では「8.6 システムの一括構築」で構築したシステムを使用します。

  1. リソースアダプタをインポートします。
    サーバ管理コマンドを使用して,リソースアダプタをJ2EEサーバへインポートします。
    Windowsの場合

    <Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjimportres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -type rar -f <任意のディレクトリ>¥MyResourceAdapter.rar

    UNIXの場合

    # /opt/Cosminexus/CC/admin/bin/cjimportres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -type rar -f <任意のディレクトリ>/MyResourceAdapter.rar

  2. リソースアダプタをデプロイします。
    サーバ管理コマンドを使用して,J2EEサーバにリソースアダプタをデプロイします。
    Windowsの場合

    <Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjdeployrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter

    UNIXの場合

    # /opt/Cosminexus/CC/admin/bin/cjdeployrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter

  3. Connector属性ファイルを取得します。
    サーバ管理コマンドを使用して,Connector属性ファイルを取得します。ここでは,Connector属性ファイルを,MyResourceAdapter.xmlの名前で出力します。
    Windowsの場合

    <Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjgetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter -c <任意のディレクトリ>¥MyResourceAdapter.xml

    UNIXの場合

    # /opt/Cosminexus/CC/admin/bin/cjgetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900  -resname MyResourceAdapter -c <任意のディレクトリ>/MyResourceAdapter.xml

  4. Connector属性ファイルを編集します。
    取得したConnector属性ファイルで,データベースへの接続の設定など必要な項目を編集してください。Connector属性ファイルの詳細については,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「4.1 Connector属性ファイル」を参照してください。
  5. 編集したConnector属性ファイルをリソースアダプタに反映します。
    サーバ管理コマンドを使用して,Connector属性ファイルを各リソースアダプタに反映します。-cオプションには,手順4で編集したConnector属性ファイルを指定します。
    Windowsの場合

    <Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter -c <任意のディレクトリ>¥MyResourceAdapter.xml

    UNIXの場合

    # /opt/Cosminexus/CC/admin/bin/cjsetrarprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter -c <任意のディレクトリ>/MyResourceAdapter.xml

  6. リソースアダプタの接続を確認します。
    サーバ管理コマンドを使用して,リソースアダプタの接続を確認します。
    Windowsの場合

    <Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjtestres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter

    UNIXの場合

    # /opt/Cosminexus/CC/admin/bin/cjtestres cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter

  7. リソースアダプタを開始します。
    サーバ管理コマンドを使用して,リソースアダプタを開始します。
    Windowsの場合

    <Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter

    UNIXの場合

    # /opt/Cosminexus/CC/admin/bin/cjstartrar cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -resname MyResourceAdapter