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