cjreloadapp(アプリケーションのリロード)
形式
cjreloadapp [<サーバ名称>] [-nameserver <プロバイダURL>] -name <アプリケーション名> [-t <強制リロード開始までのタイムアウト時間>]
機能
アプリケーションを停止しないで,構成するクラスおよびJSPを入れ替えます。
入れ替え後のアプリケーションに引き継がれるセッション情報の詳細については,マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「18.8.8 Webアプリケーションのリロード」を参照してください。
展開ディレクトリを使用し,開始状態およびリロードに失敗して停止状態にあるアプリケーションだけに実行できます。
このコマンドを実行する場合は,J2EEサーバ側のユーザプロパティファイル(usrconf.properties)にejbserver.deploy.context.reload_scopeプロパティを指定しておく必要があります。ユーザプロパティファイル(usrconf.properties)の詳細については,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3 usrconf.properties(J2EEサーバ用ユーザプロパティファイル)」を参照してください。
引数
- <サーバ名称>
-
接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは,ホスト名称がサーバ名称として使用されます。
- -nameserver <プロバイダURL>
-
CORBAネーミングサービスへのアクセスプロトコル,CORBAネーミングサービスが稼働しているホスト名,およびそれが使用しているポート番号を次に示す形式で指定します。
<プロトコル名称>::<ホスト名称>:<ポート番号>
指定内容の詳細については,「2.1.2 プロバイダURLについて」を参照してください。
- -name <アプリケーション名>
-
アプリケーション名を指定します。
- -t <強制リロード開始までのタイムアウト時間>
-
コマンドを実行してから強制リロード開始までの待ち時間(秒)を指定します。
0〜2147483647の整数です。
0を指定した場合は,構成するクラスおよびJSPの入れ替え処理が終了するまでクライアントへ応答は返りません。強制リロード開始までの待ち時間(秒)を指定しなかった場合は,強制リロードを実行しません。
入力例
cjreloadapp MyServer -name App1
戻り値
- 0:
-
正常終了しました。
- 1:
-
異常終了しました。
- 2:
-
排他エラーによってコマンドが実行できません。
- 3:
-
タイムアウトエラーが発生しました。
- 4:
-
閉塞失敗しました。
- 9:
-
管理者特権がないため,コマンドが実行できません(Windowsの場合)。
注意事項
-
コマンドの引数にサーバ名称を指定する場合,コマンド名の直後にする必要があります。そのほかの引数は,サーバ名称より後ろ(サーバ名称を省略した場合はコマンド名の後ろ)にあれば順序は任意です。ただし,オプション名と値の順序の入れ替え(例:<アプリケーション名> -name)やオプション名と値を非対応にすること(例:-nameserver <アプリケーション名> -name <プロバイダURL>)はできません。
-
コマンドの引数にサーバ名称を指定する場合,cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。
-
J2EEアプリケーションの停止処理が-tオプションで指定した時間内に終了しなかった場合,サーバ管理コマンド用システムプロパティファイルのejbserver.rmi.request.timeoutキーで指定した時間で強制終了します。
-
J2EEアプリケーションにcosminexus.xmlが含まれている場合,cosminexus.xmlの定義情報は読み込まれません。