uCosminexus Message Service Server Light for ebXML サーバ構築・運用ガイド

[目次][用語][索引][前へ][次へ]

4.5.9 J2EEアプリケーションのデプロイ

CMS Lightサーバが提供するJ2EEアプリケーションのデプロイについて説明します。J2EEアプリケーションのデプロイには,Cosminexusのサーバ管理コマンドを使用します。サーバ管理コマンドの操作方法については,マニュアル「Cosminexus アプリケーション設定操作ガイド」を参照してください。コマンドおよび属性ファイルの詳細については,マニュアル「Cosminexus リファレンス コマンド編」,およびマニュアル「Cosminexus リファレンス 定義編」を参照してください。

<この項の構成>
(1) J2EEアプリケーションのインポート
(2) J2EEアプリケーションとリソースアダプタのマッピング定義
(3) J2EEアプリケーションのデプロイと開始

(1) J2EEアプリケーションのインポート

J2EEアプリケーションのインポートコマンド(cjimportapp)を実行し,uCosminexus Application ServerにCMS LightサーバのJ2EEアプリケーションをインポートしてください。

インポートするJ2EEアプリケーションは,次の場所にあります。

インポートするJ2EEアプリケーションを,次に示します。

【例】
J2EEサーバ"mssl"にJ2EEアプリケーション"HSRSapp.ear"と"HSRSgui.ear"をインポートする場合の実行例を次に示します。
  • Windowsの場合
    C:\>cd C:\Program Files\Hitachi\Cosminexus\CC\admin\bin
    C:\Program Files\Hitachi\Cosminexus\CC\admin\bin>cjimportapp mssl -f "C:\Program Files\Hitachi\ebxml\mssl\lib\HSRSapp.ear" -f "C:\Program Files\Hitachi\ebxml\mssl\lib\HSRSgui.ear"
  • UNIXの場合
    # cd /opt/Cosminexus/CC/admin/bin
    # ./cjimportapp mssl -f "/opt/ebxml/mssl/lib/HSRSapp.ear" -f "/opt/ebxml/mssl/lib/HSRSgui.ear"

(2) J2EEアプリケーションとリソースアダプタのマッピング定義

インポートしたJ2EEアプリケーションそれぞれとリソースアダプタのマッピングを定義します。マッピング定義の手順を次に示します。

  1. J2EEアプリケーションの属性ファイル(WAR属性ファイル)を取得します。
    J2EEアプリケーションのプロパティを定義するために,アプリケーションの属性取得コマンド(cjgetappprop)を実行し,各J2EEアプリケーションのWAR属性ファイルを取得してください。
    【例】
    J2EEサーバ"mssl"のJ2EEアプリケーション"HSRSapp.ear"と"HSRSgui.ear"のWAR属性ファイルを取得する場合の実行例を次に示します。
    Windowsの場合で"HSRSapp.ear"のWAR属性ファイルを取得するとき
    ここでは,属性ファイルのパスに"C:\prop\HSRSapp_Prop.xml"を指定しています。
    C:\>cd C:\Program Files\Hitachi\Cosminexus\CC\admin\bin
    C:\Program Files\Hitachi\Cosminexus\CC\admin\bin>cjgetappprop mssl -name HSRSapp -type war -resname HSRSapp -c C:\prop\HSRSapp_Prop.xml
    Windowsの場合で"HSRSgui.ear"のWAR属性ファイルを取得するとき
    ここでは,属性ファイルのパスに"C:\prop\HSRSgui_Prop.xml"を指定しています。
    C:\>cd C:\Program Files\Hitachi\Cosminexus\CC\admin\bin
    C:\Program Files\Hitachi\Cosminexus\CC\admin\bin>cjgetappprop mssl -name HSRSgui -type war -resname HSRSgui -c C:\prop\HSRSgui_Prop.xml
    UNIXの場合で"HSRSapp.ear"のWAR属性ファイルを取得するとき
    ここでは,属性ファイルのパスに"/prop/HSRSapp_Prop.xml"を指定しています。
    # cd /opt/Cosminexus/CC/admin/bin
    # ./cjgetappprop mssl -name HSRSapp -type war -resname HSRSapp -c /prop/HSRSapp_Prop.xml
    UNIXの場合で"HSRSgui.ear"のWAR属性ファイルを取得するとき
    ここでは,属性ファイルのパスに"/prop/HSRSgui_Prop.xml"を指定しています。
    # cd /opt/Cosminexus/CC/admin/bin
    # ./cjgetappprop mssl -name HSRSgui -type war -resname HSRSgui -c /prop/HSRSgui_Prop.xml
  2. WAR属性ファイルを編集し,J2EEアプリケーションのプロパティを定義します。
    取得した各J2EEアプリケーションのWAR属性ファイルをテキストエディタで編集し,プロパティを定義してください。
    WAR属性ファイルの<resource-ref>タグ下の<linked-to>タグで,J2EEアプリケーションが使用するリソースアダプタを指定し,マッピングを定義します。なお,CMS Lightサーバでは,HSRSapp.earとHSRSgui.earで,同じリソースアダプタを使用します。
    【例】
    編集例を次に示します。
    データベース接続にCosminexus DABroker Libraryを使用する場合
           :
      <resource-ref>
        <description></description>
        <res-ref-name>jdbc/HSRSDB</res-ref-name>
        <res-type>javax.sql.DataSource</res-type>
        <res-auth>Container</res-auth>
        <res-sharing-scope></res-sharing-scope>
        <linked-to>DB_Connector_for_Cosminexus_Driver</linked-to>
      </resource-ref>
           :
    データベース接続にHiRDB Type4 JDBC Driverを使用する場合
           :
      <resource-ref>
          <description xml:lang="en"></description>
          <res-ref-name>jdbc/HSRSDB</res-ref-name>
          <res-type>javax.sql.DataSource</res-type>
          <res-auth>Container</res-auth>
          <res-sharing-scope></res-sharing-scope>
          <linked-to>DB_Connector_for_HiRDB_Type4</linked-to>
      </resource-ref>
           :
  3. WAR属性ファイルに定義したプロパティを,J2EEアプリケーションに設定します。
    アプリケーションの属性設定コマンド(cjsetappprop)を実行し,WAR属性ファイルに定義したプロパティを各J2EEアプリケーションに反映させてください。
    【例】
    J2EEサーバ"mssl"のJ2EEアプリケーション"HSRSapp.ear"と"HSRSgui.ear"にプロパティを反映させる場合の実行例を次に示します。
    Windowsの場合で"HSRSapp.ear"にプロパティを反映させるとき
    C:\>cd C:\Program Files\Hitachi\Cosminexus\CC\admin\bin
    C:\Program Files\Hitachi\Cosminexus\CC\admin\bin>cjsetappprop mssl -name HSRSapp -type war -resname HSRSapp -c C:\prop\HSRSapp_Prop.xml
    Windowsの場合で"HSRSgui.ear"にプロパティを反映させるとき
    C:\>cd C:\Program Files\Hitachi\Cosminexus\CC\admin\bin
    C:\Program Files\Hitachi\Cosminexus\CC\admin\bin>cjsetappprop mssl -name HSRSgui -type war -resname HSRSgui -c C:\prop\HSRSgui_Prop.xml
    UNIXの場合で"HSRSapp.ear"にプロパティを反映させるとき
    # cd /opt/Cosminexus/CC/admin/bin
    # ./cjsetappprop mssl -name HSRSapp -type war -resname HSRSapp -c /prop/HSRSapp_Prop.xml
    UNIXの場合で"HSRSgui.ear"にプロパティを反映させるとき
    # cd /opt/Cosminexus/CC/admin/bin
    # ./cjsetappprop mssl -name HSRSgui -type war -resname HSRSgui -c /prop/HSRSgui_Prop.xml

(3) J2EEアプリケーションのデプロイと開始

J2EEアプリケーションの開始コマンド(cjstartapp)を実行し,インポートした各J2EEアプリケーションを正しく開始できるか確認してください。

【例】
J2EEサーバ"mssl"のJ2EEアプリケーション"HSRSapp.ear"と"HSRSgui.ear"を開始する場合の実行例を次に示します。
  • Windowsの場合で"HSRSapp.ear"を開始するとき
    C:\>cd C:\Program Files\Hitachi\Cosminexus\CC\admin\bin
    C:\Program Files\Hitachi\Cosminexus\CC\admin\bin>cjstartapp mssl -name HSRSapp
  • Windowsの場合で"HSRSgui.ear"を開始するとき
    C:\>cd C:\Program Files\Hitachi\Cosminexus\CC\admin\bin
    C:\Program Files\Hitachi\Cosminexus\CC\admin\bin>cjstartapp mssl -name HSRSgui
  • UNIXの場合で"HSRSapp.ear"を開始するとき
    # cd /opt/Cosminexus/CC/admin/bin
    # ./cjstartapp mssl -name HSRSapp
  • UNIXの場合で"HSRSgui.ear"を開始するとき
    # cd /opt/Cosminexus/CC/admin/bin
    # ./cjstartapp mssl -name HSRSgui