運用管理コマンド（mngsvrutil）では，テストモードで動作しているJ2EEアプリケーションを操作できません。テストモードでJ2EEアプリケーションを操作したい場合は，サーバ管理コマンドを実行してください。ただし，テストモードの場合も，運用管理コマンドで稼働情報を出力できます。

なお，J2EEアプリケーションのモードが，サーバ管理コマンドでテストモードに変更された場合，運用管理コマンドにサブコマンド「get」を指定して取得したJ2EEアプリケーションの稼働情報のfullyQualifiedNameに，「_TEST」という文字列が付いて出力されます。

J2EEアプリケーションを入れ替えるときに，J2EEアプリケーションをテストモードで開始する手順の例を示します。なお，この手順では，入れ替え元のJ2EEアプリケーションは，J2EEサーバ上で開始されていることを前提としています。

準備

Webアプリケーションを含むJ2EEアプリケーションをテストモードで運用する場合，あらかじめ次の作業が必要です。

• リダイレクタの設定（URLのマッピング）
  通常モードのコンテキストルートを含むURLのマッピングに加えて，テストモードのコンテキストルートを含むURLのマッピングを設定してください。Webアプリケーションを含むJ2EEアプリケーションをテストモードで運用する場合，Webアプリケーションのコンテキストルートにプリフィックス「_test_」を付けたものが，コンテキストルートとして使用されます。例えば，通常モードのコンテキストルートが「/jsptobean」の場合，テストモードのコンテキストルートは「/_test_/jsptobean」になります。
  URLパターンでのリクエスト振り分けの設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。
  
• Webサーバの再起動
  Webサーバを再起動して，リダイレクタの設定を有効にしてください。
  

手順

1. J2EEアプリケーションをテストモードでインポートします。
   J2EEアプリケーションのインポートには，サーバ管理コマンド（cjimportapp）を使用します。
   実行形式と実行例を次に示します。
   

   実行形式

   cjimportapp <J2EEサーバ名> -test -f <EARファイルのパス>

   実行例

   cjimportapp MyServer -test -f App1.ear

   　

2. インポートしたJ2EEアプリケーションのプロパティ設定とカスタマイズを実行します。
   サーバ管理コマンド（cjgetapppropおよびcjsetappprop）を使用して実行します。それぞれのコマンドには-testオプションを指定して，テストモードで実行します。
   cjgetapppropコマンドの実行形式と実行例を次に示します。
   

   実行形式

   cjgetappprop <J2EEサーバ名> -test -name <J2EEアプリケーション名> -type all -c <アプリケーション統合属性ファイルの出力先パス>

   実行例

   cjgetappprop MyServer -test -name App1 -type all -c App1Prop.xml

   　

   属性ファイルはテキストエディタなどで編集します。
   cjsetapppropコマンドの実行形式と実行例を次に示します。
   

   実行形式

   cjsetappprop <J2EEサーバ名> -test -name <J2EEアプリケーション名> -type all -c <編集したアプリケーション統合属性ファイルのパス>

   実行例

   cjsetappprop MyServer -test -name App1 -type all -c App1Prop.xml

3. J2EEアプリケーションをテストモードで開始します。
   cjstartappコマンドの実行形式と実行例を次に示します。
   

   実行形式

   cjstartapp <J2EEサーバ名> -test -name <J2EEアプリケーション名>

   実行例

   cjstartapp MyServer -test -name App1

4. テストを実施します。
   テスト用のクライアントから適宜操作を実行して，テストします。問題ないことが確認できたら，手順5.に進みます。
   テスト結果に問題があった場合は，J2EEアプリケーションを修正して，手順1.からもう一度実行してください。なお，同じ名称のJ2EEアプリケーションは同じモードで登録できません。このため，テストが失敗したテストモードのJ2EEアプリケーションは削除してください。テストモードのJ2EEアプリケーションの削除は，サーバ管理コマンド（cjdeleteapp）に-testオプションを付けた形式で実行してください。
   

   ポイント

   • テストモードで動作しているJ2EEアプリケーションは，テストモード用に設定した特定のクライアントからだけ利用できます。Webアプリケーションを含むJ2EEアプリケーションをテストモードで運用する場合，Webアプリケーションのコンテキストルートにプリフィックス「_test_」を付けたものが，コンテキストルートとして使用されます。例えば，コンテキストルートが「/jsptobean」で，本番運用でのURLが「http://www.hitachi.co.jp/jsptobean/account.jsp」の場合，テストモードでのURLは，「http://www.hitachi.co.jp/_test_/jsptobean/account.jsp」になります。テスト用のクライアントからはこのURLを使用してJ2EEアプリケーションに対して操作を実行してください。
   • EJBを含むJ2EEアプリケーションをテストモードで運用する場合，EJBはテスト用の名前空間に登録されます。EJBクライアントアプリケーションからEJBを呼び出す場合には，通常モード用の名前空間のルートコンテキスト名で始まる検索文字列「HITACHI_EJB/…」ではなく，テストモード用の名前空間のルートコンテキスト名で始まる検索文字列「$HITACHI_TEST/…」を指定してlookupを実行してください。

5. テストモードで運用しているJ2EEアプリケーションを停止します。
   

   実行形式

   cjstopapp <J2EEサーバ名> -test -name <J2EEアプリケーション名>

   実行例

   cjstopapp MyServer -test -name App1

6. 通常モードで運用しているJ2EEアプリケーションを停止します。
   なお，J2EEアプリケーションを入れ替えではなく新規にインポートした場合，この操作は不要です。
   

   実行形式

   cjstopapp <J2EEサーバ名> -name <J2EEアプリケーション名>

   実行例

   cjstopapp MyServer -name App1

7. 通常モードで運用していたJ2EEアプリケーションの名称を変更します。
   なお，J2EEアプリケーションを入れ替えではなく新規にインポートした場合，この操作は不要です。
   また，この操作は，インポートしたファイルの世代を管理したい場合などに，必要に応じて実行してください。例えば，「App1」というJ2EEアプリケーションの場合，「App1_bak」などに変更します。
   

   実行形式

   cjrenameapp <J2EEサーバ名> -name <変更前のJ2EEアプリケーション名> -newname <変更後のJ2EEアプリケーション名>

   実行例

   cjrenameapp MyServer -name App1 -newname App1_bak

8. テストモードで運用していたJ2EEアプリケーションのモードを通常モードに変更します。
   

   実行形式

   cjchmodapp <J2EEサーバ名> -test -name <テストモードで動作を確認したJ2EEアプリケーション名> -mode normal

   実行例

   cjchmodapp MyServer -test -name App1 -mode normal

9. 手順8.でモードを変更したJ2EEアプリケーションを開始します。
   

   実行形式

   cjstartapp <J2EEサーバ名> -name <J2EEアプリケーション名>

   実行例

   cjstartapp MyServer -name App1

テストモードで実行できるサーバ管理コマンドを示します。

それぞれのコマンドの詳細については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

表4-16　テストモードで実行できるサーバ管理コマンド