Index

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

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

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

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

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

注意

Wrapper は、ステータス（状況）が変わるたびに、このファイルを開き、書き込む必要があります。 Wrapper は、短時間であれば外部プロセスによってファイルをロックすることを許可します。 しかしながら、１秒間以上、ファイルのロックが解放されずに書き込めないと、 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/Linux

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

設定例： 
wrapper.statusfile.group=jenkins

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

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

設定例： 
wrapper.statusfile.umask=0022

参照： PID、ID、ステータスファイル
  • [ wrapper.anchorfile ] (3.1.1)

    スタートアップ時に作成されたアンカーファイルのパスを指定します。

  • [ wrapper.java.pidfile ] (3.0.5)

    Java プロセス ID を書き込むファイルのパスを設定します。

  • [ wrapper.java.idfile ] (3.2.0)

    Wrapper が生成した現在の Java ID を書き込むファイルのパスを設定します。

  • [ wrapper.java.statusfile ] (3.2.0)

    JVM の現在のステータスを書き込むファイルのパスを指定します。

  • [ wrapper.pidfile ] (Usage changed in 3.0.5)

    Wrapper プロセスの PID を書き込むファイルのパスを指定します。

  • [ wrapper.lockfile ] (3.2.0)

    Wrapper プロセス ID を含むロックファイルを設定します。

  • [ wrapper.statusfile ] (3.2.0)

    現在の Wrapper ステータスを書き込むファイルのパスを設定します。

  • [ wrapper.*.group ] (3.5.38)

    Wrapper が特定のファイルを作成するときに割り当てるグループを指定します。

  • [ wrapper.*.umask ] (3.2.0)

    Wrapper によって作成された特定のファイルに対するパーミッション（アクセス権限）を指定します。