3.7.2 オンライン状態でのJ2EEアプリケーションの入れ替え
J2EEアプリケーションを入れ替える場合に，オンライン状態でJ2EEアプリケーションを入れ替えられます。
ここでは，入れ替えの概要と入れ替え手順について説明します。
- 〈この項の構成〉
(1) 入れ替えの概要
J2EEアプリケーションを入れ替える場合には，CTMデーモンによって，スケジュールキューの出口を閉じてから，入れ替えを実行します。出口を閉じている間もクライアントからのリクエストはスケジュールキューに登録し続けることができます。このため，該当アプリケーションに対するリクエストもエラーにしないでシステムを運用し続けられます。ただし，スケジュールキューの最大リクエスト登録数を超えた場合は，クライアントにエラーが返却されます。
オンライン状態でのJ2EEアプリケーションの入れ替えの概要を，次の図に示します。
|
|
![[図データ]](GRAPHICS/ZU031600.GIF)
(2) 入れ替えの手順
オンライン状態でJ2EEアプリケーションを入れ替える場合，J2EEアプリケーションのスケジュールキューの出口を閉じたあと，入れ替えを実行します。この操作は，運用管理コマンド（mngsvrutil）で実行できます。
J2EEアプリケーションの入れ替えは，J2EEアプリケーション単位，ホスト単位，または運用管理ドメイン単位で実行できます。
スケジュールキューの出口を閉じるには，mngsvrutilコマンドにサブコマンド「hold」を指定して実行します。mngsvrutilコマンドを実行してスケジュールキューの出口を閉塞している間も，クライアントからのリクエストはスケジュールキューに登録し続けられます。ただし，スケジュールキューの最大リクエスト登録数を超えた場合，クライアントにエラーが返却されます。
J2EEアプリケーションの入れ替えが終了したら，スケジュールキューの閉塞を解除します。スケジュールキューの閉塞解除は，mngsvrutilコマンドにサブコマンド「release」を指定して実行します。スケジュールキューの閉塞を解除すると，J2EEアプリケーションで，スケジュールキューに保持されていたリクエストの処理を再開します。
CTMを使用したオンライン状態でのJ2EEアプリケーションの入れ替え手順を次に示します。
-
入れ替えるJ2EEアプリケーションに対応するCTMのスケジュールキューの出口を閉じます。
J2EEアプリケーションを入れ替える場合のmngsvrutilコマンドの実行形式と実行例を次に示します。
- 実行形式
mngsvrutil -m <Management Serverのホスト名>［:<ポート番号>］ -u <管理ユーザID> -p <管理パスワード> -t <CTMの名称> hold queue <キューの名称> out
- 実行例
mngsvrutil -m mnghost -u user01 -p pw1 -t ctm01 hold queue App1 out
-
J2EEアプリケーションを入れ替えます。
J2EEアプリケーションを停止して，新しいアプリケーションに入れ替えます。そのあとで，J2EEアプリケーションを再開始します。
J2EEアプリケーションの入れ替え方法については，マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「5.6.3 J2EEアプリケーションの入れ替えと保守」を参照してください。
-
CTMのスケジュールキューの閉塞を解除するときは，mngsvrutilコマンドにサブコマンド「release」を指定して実行します。
この場合のmngsvrutilコマンドの実行形式と実行例を次に示します。
- 実行形式
mngsvrutil -m <Management Serverのホスト名>［:<ポート番号>］ -u <管理ユーザID> -p <管理パスワード> -t <CTMの名称> release queue <キューの名称>
- 実行例
mngsvrutil -m mnghost -u user01 -p pw1 -t ctm01 release queue App1
mngsvrutilコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「mngsvrutil（Management Serverの運用管理コマンド）」を参照してください。