Cosminexus 簡易構築・運用ガイド

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

7.3.2 J2EEアプリケーションの入れ替え

J2EEアプリケーションを入れ替える手順には,リデプロイによる入れ替えと通常の入れ替えの2種類があります。ここでは,それぞれの手順について,次のJ2EEアプリケーションを使用する場合を例にして説明します。

表7-1 例で使用するJ2EEアプリケーションのファイル名と表示名

種別 名前
入れ替え前のファイル名 MyApp.ear
入れ替え後のファイル名 MyApp-1_1.ear
表示名 MyApp
アプリケーション統合属性ファイルのファイル名 MyAppprop.xml
参考
サーバ管理コマンドの指定値について

サーバ管理コマンドの引数に指定するサーバ名
サーバ管理コマンドの引数に指定するサーバ名は実サーバ名です。「6.8 システムの構成定義」で,実サーバ名を設定していない場合,実サーバ名は論理サーバ名と同じです。なお,論理サーバ名の設定を省略している場合,論理サーバ名は「cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>」となります。論理サーバ名の定義ルールについては,「12.3 コマンドの詳細」の「cmx_build_system」を参照してください。

サーバ管理コマンドを使用する操作
ここで説明する操作のうち,サーバ管理コマンドを使用する操作は,サービスユニットごとに実行します。
なお,ここで示すサーバ管理コマンドの実行例は,すべてサービスユニット1を対象としています。サービスユニット2に対しても,コマンド実行例中の値を次のように読み替えて同じ操作をしてください。
J2EEサーバ名:cmx_MyWebSystem_unit2_J2EE_01
-nameserver指定値:corbaname::192.168.1.12:900
参考
リロードによる入れ替え
入れ替えの対象となるJ2EEアプリケーションが展開ディレクトリ形式の場合,リロードによる入れ替えができます。
リロードによる入れ替えの方法については,マニュアル「Cosminexus システム運用ガイド」のJ2EEアプリケーションの入れ替えと保守に関する説明を参照してください。また,リロードによる入れ替えを実行するには,事前に設定が必要です。設定方法の詳細は,マニュアル「Cosminexus システム構築ガイド」のJ2EEアプリケーションの更新検知とリロードの設定に関する説明を参照してください。
<この項の構成>
(1) リデプロイによる入れ替え
(2) 通常の入れ替え

(1) リデプロイによる入れ替え

アーカイブ形式のJ2EEアプリケーションを入れ替える場合には,リデプロイによる入れ替えが実行できます。リデプロイによる入れ替えを実行すると,少ない手順でJ2EEアプリケーションを入れ替えられます。

リデプロイによるJ2EEアプリケーションの入れ替えには,実施する際の注意事項や条件があります。詳細については,マニュアル「Cosminexus システム運用ガイド」のリデプロイによるJ2EEアプリケーションの入れ替えに関する説明を参照してください。

J2EEアプリケーションのリデプロイによる入れ替えの手順を次に示します。

  1. システムの状態に応じて,システムを起動または閉塞します。
    システムが停止している場合は,システム全体を起動します。システムが稼働している場合はシステム全体を閉塞します。
    • システムが停止している場合
      cmx_start_targetコマンドを使用して一括起動します。このとき,コマンドの-modeオプションに「READY」を指定して,サービスユニットを準備状態にします。
      Windowsの場合
       
      <Cosminexusインストールディレクトリ>\manager\bin\cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem
       
      UNIXの場合
       
      # /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem
       
    • システムが稼働している場合
      cmx_stop_targetコマンドを使用して一括停止します。このとき,コマンドの-modeオプションに「HOLD」を指定して,サービスユニットを閉塞状態にします。
      Windowsの場合
       
      <Cosminexusインストールディレクトリ>\manager\bin\cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode HOLD -s MyWebSystem
       
      UNIXの場合
       
      # /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode HOLD -s MyWebSystem
       
    注※
    どちらも負荷分散機からのリクエストの振り分けが抑止されている状態になります。準備状態と閉塞状態の差異は,論理Webサーバが停止しているかどうかだけとなります。閉塞状態のときは論理Webサーバが停止しています。
  2. 入れ替えるEARファイルのパスを指定して,リデプロイします。
    Windowsの場合
     
    <Cosminexusのインストールディレクトリ>\CC\admin\bin\cjreplaceapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -f MyApp-1_1.ear
     
    UNIXの場合
     
    # /opt/Cosminexus/CC/admin/bin/cjreplaceapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -f MyApp-1_1.ear
     
  3. 手順2.をサービスユニット1およびサービスユニット2で実施したあとで,システム全体を一括起動します。
    cmx_start_targetコマンドを使用して,システムを一括起動します。
    Windowsの場合
     
    <Cosminexusインストールディレクトリ>\manager\bin\cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem
     
    UNIXの場合
     
    # /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem
     
    参考
    CTMを使用する構成のシステムでは,システムを閉塞しないでバックシステムのアプリケーションを入れ替えることができます。そのため,CTMを使用する構成のシステムでは,手順1.と手順3.が不要です。

(2) 通常の入れ替え

J2EEアプリケーションの通常の入れ替えとは,変更前のJ2EEアプリケーションを削除し,変更後のJ2EEアプリケーションをインポートすることです。J2EEアプリケーションの通常の入れ替えの手順を次に示します。

  1. システムの状態に応じて,システムを起動または閉塞します。
    システムが停止している場合は,システム全体を起動します。システムが稼働している場合はシステム全体を閉塞します。
    • システムが停止している場合
      cmx_start_targetコマンドを使用して一括起動します。このとき,コマンドの-modeオプションに「READY」を指定して,サービスユニットを準備状態にします。
      Windowsの場合
       
      <Cosminexusインストールディレクトリ>\manager\bin\cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem
       
      UNIXの場合
       
      # /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode READY -s MyWebSystem
       
    • システムが稼働している場合
      cmx_stop_targetコマンドを使用して一括停止します。このとき,コマンドの-modeオプションに「HOLD」を指定して,サービスユニットを閉塞状態にします。
      Windowsの場合
       
      <Cosminexusインストールディレクトリ>\manager\bin\cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode HOLD -s MyWebSystem
       
      UNIXの場合
       
      # /opt/Cosminexus/manager/bin/cmx_stop_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode HOLD -s MyWebSystem
       
    注※
    どちらも負荷分散機からのリクエストの振り分けが抑止されている状態になります。準備状態と閉塞状態の差異は,論理Webサーバが停止しているかどうかだけとなります。閉塞状態のときは論理Webサーバが停止しています。
  2. J2EEアプリケーションを停止します。
    サーバ管理コマンドを使用して,J2EEアプリケーションを停止します。-nameオプションには,J2EEアプリケーション名を指定します。
    Windowsの場合
     
    <Cosminexusのインストールディレクトリ>\CC\admin\bin\cjstopapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp
     
    UNIXの場合
     
    # /opt/Cosminexus/CC/admin/bin/cjstopapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp
     
  3. 入れ替え前のJ2EEアプリケーションを削除します。
    サーバ管理コマンドを使用して,J2EEアプリケーションを削除します。-nameオプションには,削除するJ2EEアプリケーション名を指定します。
    Windowsの場合
     
    <Cosminexusのインストールディレクトリ>\CC\admin\bin\cjdeleteapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp
     
    UNIXの場合
     
    # /opt/Cosminexus/CC/admin/bin/cjdeleteapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp
     
  4. 入れ替え後のJ2EEアプリケーションをインポートします。
    サーバ管理コマンドを使用して,入れ替え後のJ2EEアプリケーションをインポートします。-fオプションには,入れ替え後のJ2EEアプリケーションのパスを指定します。
    Windowsの場合
     
    <Cosminexusのインストールディレクトリ>\CC\admin\bin\cjimportapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -f MyApp-1_1.ear
     
    UNIXの場合
     
    # /opt/Cosminexus/CC/admin/bin/cjimportapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -f MyApp-1_1.ear
     
  5. J2EEアプリケーションに必要な情報を設定,およびカスタマイズします。
    サーバ管理コマンドを使用して,J2EEアプリケーションに必要な情報を設定,およびカスタマイズします。cjgetapppropコマンドでアプリケーション統合属性ファイルを取得して,ファイルを編集してから,cjsetapppropコマンドを実行して設定します。-nameオプションには,J2EEアプリケーション名を指定します。
    Windowsの場合
     
    <Cosminexusのインストールディレクトリ>\CC\admin\bin\cjgetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>\MyAppprop.xml
     
    <Cosminexusのインストールディレクトリ>\CC\admin\bin\cjsetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>\MyAppprop.xml
     
    UNIXの場合
     
    # /opt/Cosminexus/CC/admin/bin/cjgetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>/MyAppprop.xml
     
    # /opt/Cosminexus/CC/admin/bin/cjsetappprop cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp -type all -c <任意のディレクトリ>/MyAppprop.xml
     
  6. J2EEアプリケーションを開始します。
    サーバ管理コマンドを使用して,J2EEアプリケーションを開始します。-nameオプションには,J2EEアプリケーション名を指定します。
    Windowsの場合
     
    <Cosminexusインストールディレクトリ>\CC\admin\bin\cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name Myapp
     
    UNIXの場合
     
    # /opt/Cosminexus/CC/admin/bin/cjstartapp cmx_MyWebSystem_unit1_J2EE_01 -nameserver corbaname::192.168.1.11:900 -name MyApp
     
  7. 手順2.から6.までをサービスユニット1およびサービスユニット2で実施したあとで,システム全体を一括起動します。
    cmx_start_targetコマンドを使用して,システムを一括起動します。
    Windowsの場合
     
    <Cosminexusインストールディレクトリ>\manager\bin\cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem
     
    UNIXの場合
     
    # /opt/Cosminexus/manager/bin/cmx_start_target -m 192.168.100.100 -u cosmi_admin -p cosmi_admin_passwd -mode ALL -s MyWebSystem
     
    参考
    CTMを使用する構成のシステムでは,システムを閉塞しないでバックシステムのアプリケーションを入れ替えることができます。そのため,CTMを使用する場合の構成のシステムでは,手順1.と手順7.が不要です。