Index

wrapper.statusfile プロパティ

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

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

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

このプロパティを設定すると、プロセスが起動した時や、内部ステータスが変化した時はいつでも、 Wrapper プロセスの最新のステータスを含むファイルが、指定された配置場所へ書き込まれます。 Wrapper プロセスが終了すると、そのファイルは削除されます。

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

注意

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

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

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

可能な値は次のとおり:

  • [STARTING] :

    Wrapper がまだ開始中です。 最初の Java プロセスがスタートアップを完了するまで、あるいは、 Wrapper がシャットダウンを開始するまで、このステート(状態)が続きます。

  • [STARTED] :

    Wrapper が既に開始しています。 Wrapper が一時停止(ポーズ)しているとき、或いはシャットダウンを開始するまで、このステート(状態)が続きます。

  • [PAUSING] :

    Wrapper は、JVM を一時停止(ポーズ)プロセス中に、「STARTED」から「PAUSED」ステート(状態)へ移行しています。

  • [PAUSED] :

    Wrapper が、一時停止(ポーズ)しています。 Wrapper が再開する、或いはシャットダウンするまで、このステート(状態)が続きます。 詳しくは[wrapper.pausable]プロパティを参照ください。

  • [RESUMING] :

    Wrapper は、JVM を再開している途中で、「PAUSED」から「STARTED」ステートへ移行しています。

  • [STOPPING] :

    Wrapper がシャットダウンを開始しています。 Java プロセスが完全にシャットダウンするまで、このステート(状態)が続きます。

  • [STOPPED] :

    Wrapper が終了する準備ができています。 このステート(状態)は唯一、Wrapper プロセスが終了する前に、即座に終了します。

注意

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

wrapper.statusfile.group プロパティ

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

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

設定例:
wrapper.statusfile.group=jenkins

wrapper.statusfile.umask プロパティ

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

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

設定例:
wrapper.statusfile.umask=0022

参照: PID、ID、ステータスファイル