World Map
Java Service Wrapperは、御社Javaアプリケーション製品の安定した信頼性を高める最短最善の方法です。
  • Free Trial
  • Buy Now
wrapper.java.statusfile プロパティ

インデックス

wrapper.java.statusfile プロパティ

対応バージョン :3.2.0
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

警告

このプロパティの説明を読まずに、パラメーターを変更することは絶対にしないで下さい。 設定を間違えると、期待どおりに動作せず、Wrapperの動作不良や不具合の原因となります。

このプロパティには、現在のJavaステータスを書き込むファイルを設定します。 このプロパティは、デフォルトで設定されません。

このプロパティは、ほとんどのアプリケーションに使いません。 しかしながら、 Javaプロセスのステート(状態)をモニタリング(監視)する必要がある外部アプリケーションに便利に使えることでしょう。

このプロパティを設定すると、最初のJavaプロセスが起動して、内部ステータスが変化した時はいつでも、 Javaプロセスの最新のステータスを含むファイルが、指定された配置場所へ書き込まれます。 Wrapperプロセスが終了すると、そのファイルは削除されますが、 Javaプロセスが再起動されると、再度、ステータス・ファイルが作成され、 [DOWN](ダウン)ステータスを反映します。

設定例:
wrapper.java.statusfile=./myapp.java.status

注意

Wrapperは、ステータス(状況)が変わるたびに、このファイルを開き、書き込むことができる必要があります。 Wrapperは、短時間であれば外部プロセスによってロックされるファイルの余裕を認めるコードを含みます。 しかしながら、1秒間以上、ファイルのロックが解放されないと、 Wrapperは失敗して、ログに警告メッセージが表示されます。 これは、Wrapperの運用には影響ありません。

ステータス(状況)の表記:

このファイルの書き込み形式は、単一のトークン表記された一行のテキストファイルで、 現在のJavaプロセスのステータス(状況)を示します。

可能な値は次のとおり:

  • [DOWN] :

    Javaプロセスは完全にダウンしています。 これは、Wrapperが最初に起動するとき、また同様に、 Javaプロセスが終了していると確認した後、 のステート(状態)です。

  • [LAUNCH(DELAY)] :

    Wrapperが新しいJVMの起動待ちです。 これは、Wrapperが新しいJVMプロセス起動を待機している時のステート(状態)です。 [wrapper.startup.delay] プロパティが設定されている場合でのスタートアップ時や、 あるいは、 [wrapper.restart.delay] プロパティが「0 (ゼロ)」より大きい値が設定されている場合での再起動中に、 このステート(状態)が発生します。

  • [LAUNCHING] :

    WrapperはJVM起動プロセス中ですが、 新しいJavaプロセスの存在はまだ確認できていません。 Wrapperがこのステート(状態)のまま継続が許可されている経過時間は、 [wrapper.startup.timeout] プロパティでコントロールすることができます。

  • [LAUNCHED] :

    Wrapperが、Javaプロセスの配置によりJavaプロセスが起動したことを確認しました。 このステート(状態)は、ほとんど即座に常に[STARTING]へ変化します。

  • [STARTING] :

    Javaプロセスが起動しました。 JVMの[WrapperManager] クラスが、Wrapperでバックエンド・ソケットを開き、ユーザーのJavaアプリケーションが開始したことを Wrapperへ通知するまで、あるいは、JVMがシャットダウンを開始するまで、 このステート(状態)が続きます。 Wrapperがこのステート(状態)のまま継続が許可されている経過時間は、 [wrapper.startup.timeout] プロパティでコントロールすることができます。

  • [STARTED] :

    JVMの[WrapperManager] クラスが、アプリケーションが立ち上がり動作していることを、Wrapperへ通知しました。 JVMがシャットダウンを開始するまで、このステート(状態)が続きます。 一旦、このステート(状態)になると、Wrapperは、 [wrapper.ping.interval] プロパティで指定されいるインターバル(一定周期)で、 [WrapperManager]クラスにpingを送信します。 [WrapperManager]クラスは、 [wrapper.ping.timeout] プロパティで指定されている時間以内に、応答しなければなりません。

  • [STOPPING] :

    JVMは内部アプリケーションの停止を開始しました。 JVMの[WrapperManager] クラスが、アプリケーションが停止したことを、 Wrapperへ通知するまで、このステート(状態)が続きます。 Wrapperがこのステート(状態)のまま継続が許可されている経過時間は、 [wrapper.shutdown.timeout] プロパティでコントロールすることができます。

  • [STOPPED] :

    JVMの[WrapperManager] クラスが、アプリケーションが停止したことを、Wrapperへ通知しました。 Javaプロセスが実際に終了するまで、このステート(状態)が続きます。 Wrapperがこのステート(状態)のまま継続が許可されている経過時間は、 [wrapper.jvm_exit.timeout] プロパティでコントロールすることができます。

注意

このプロパティは、 コンフィギュレーションのリロード(再読み込み) で、プロパティ値を有効にすることはできません。 変更したプロパティ値を有効にするためには、Wrapperを再起動してください。

wrapper.java.statusfile.umask プロパティ

対応バージョン :3.2.0
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

このファイルに「umask」を設定することができます。 詳しくは[wrapper.*.umask]プロパティを参照ください。

設定例:
wrapper.java.statusfile.umask=0022

参照: PID, ID, Status ファイル