7.3.5 stop
指定した論理サーバ,J2EEアプリケーションまたはJ2EEリソースを停止します。
サブコマンドstopに指定できる引数を次に示します。
stopでは,次の2種類の操作を実行できます。
-
引数に"allServers"を指定して,指定された論理サーバを停止します。
運用管理ドメインに定義された論理サーバを,定義された起動順序の逆順で停止します。引数に"server"が指定された場合,"-t"オプションで指定された論理サーバ(スマートエージェント,ネーミングサービス,J2EEサーバ,J2EEサーバクラスタ,CTM,CTMドメインマネジャ,パフォーマンストレーサ,Webサーバ,Webサーバクラスタ,およびユーザサーバ)を停止します。
一つ目の引数に"server"が指定された場合,二つ目の引数に"graceful"を指定できます。"graceful"が指定された場合,"-t"オプションで指定された論理サーバがWebサーバまたはWebサーバクラスタの場合,論理サーバを計画停止します。計画停止とは,現在受け付けているすべてのリクエストの処理終了を待って論理サーバを停止させることです。"-t"オプションで指定された論理サーバがWebサーバおよびWebサーバクラスタ以外の場合,または"-t"オプションにホスト名を指定した場合は,引数"graceful"は無視されます。また,引数"graceful"では":<waitTime>"を指定して停止までの待ち時間を指定できます。"<waitTime>"には,60〜1800(単位:秒)の値を指定します。指定した待ち時間の間にリクエストが終了しなかった場合,論理サーバを強制停止します。":<waitTime>"を省略した場合は,運用管理ポータルの「論理サーバの起動/停止」で設定した「停止監視時間」が設定されます。
-
引数にstopサブコマンドに対する引数を二つ指定して,指定されたJ2EEアプリケーション/J2EEリソースアダプタ/JavaBeansリソースを停止します。
一つ目の引数に"app"/"resAdapter"/"resJavaBeans"が指定された場合,"-t"オプションで指定されたJ2EEサーバで,二つ目の引数で指定された表示名(displayname)の開始しているJ2EEアプリケーション/リソースアダプタ/JavaBeansリソースを停止します。J2EEサーバクラスタの場合はメンバとなるJ2EEサーバに操作を展開します。
"-t"オプションにJ2EEサーバ(J2EEサーバクラスタのメンバも含む)またはJ2EEサーバクラスタ以外の論理サーバが指定された場合は,エラーになります。また,"-t"オプションにホスト名は指定できません。
一つ目の引数に"app"が指定された場合,三つ目の引数に"force"を指定できます。引数"force"が指定された場合,J2EEアプリケーションがリクエスト処理の実行中であっても,その終了を待たないでJ2EEアプリケーションを強制停止します。
- 注意事項
-
-
start/stopサブコマンドを実行した直後に,同一論理サーバに対して同様の処理を実行する場合には,まず-sオプションを指定してstart/stopを実行し,その処理の完了を待ってから次のコマンドを実行してください。
-
listサブコマンドで取得されるステータスは,start,stopなどの他のサブコマンドの処理の実行状態に関係なく,呼び出し時点での情報を返します。そのため,startコマンドによる起動処理が完了する前に"working"のステータスを返したり,stopコマンドによる停止処理が完了する前に"stopped"のステータスを返したりすることがあります。
-
停止対象の論理サーバのうち,異常停止ステータスの論理サーバは停止済みとし,該当論理サーバを停止処理のリトライ対象としません。09-70以前では,異常停止ステータスの論理サーバに対して停止処理のリトライを行います。そのため,異常停止ステータスの論理サーバに対して停止処理を行うと,最大監視時間(-lオプションの値(デフォルトは60秒))によるタイムアウトまで待ち,戻り値1で終了します。
-
論理J2EEサーバの接続するCTMに設定している論理CTMサーバを停止する場合,論理J2EEサーバを先に停止し,論理J2EEサーバの停止処理が完了したことを確認してから論理CTMサーバを停止してください。論理J2EEサーバの停止処理が完了していない状態で論理CTMサーバを停止したとき,論理CTMサーバの停止に失敗することがあります。論理J2EEサーバの停止処理が完了したことはJ2EEサーバのプロセス(cjstartsv)の停止で確認してください。
-