上級者向けのコンフィギュレーション プロパティ

このセクションで説明しているプロパティは、 Wrapperのさらなる強力な機能を設定できる、上級者向けのコンフィギュレーションプロパティについて説明しています。 ここで紹介するプロパティは、Wrapperに同梱して提供しているデフォルトのコンフィギュレーションファイル 「wrapper.conf」に含まれていませんので、 必要に応じて、プロパティを追加していくことができます。

【デフォルト値】：

各プロパティのデフォルト値には、あらかじめ、主要なアプリケーションに適切な値が設定してあります。 ほとんどのケースでは、変更するべきではないでしょう。

ある特定のアプリケーションの必要性に応じて、設定を調整する必要があるケースもあります。 その場合には、じっくり時間をかけて、変更するプロパティの説明を全部、熟読してください。 自分が求めているものが、本当にそのプロパティの変更で良いのか十分に確認して上で操作してください。

警告

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

[一般／共通]

  • [ wrapper.backend.type ] (3.5.8)

    Wrapper プロセスと JVM 内部で動作しているクラスの間の通信を設定します。

  • [ wrapper.child.status.loglevel ] (3.4.0) ( プロフェッショナル版 )

    チャイルド（子）プロセスに関するメッセージのログレベルを設定します。

  • [ wrapper.console.quickedit ] (3.5.43)

    Wrapper プロセスが接続しているコンソールの簡易編集モードを有効／無効にします。

  • [ wrapper.console.quickedit.loglevel ] (3.5.37)

    コンソールのクイックエディットモード（QuickEdit Mode）が有効になっているときに出力される警告のログレベルを制御します。

  • [ wrapper.disable_console_input ] (3.3.2)

    Wrapper が JVM 内でコンソール入力を処理する機能を無効にします。

  • [ wrapper.disable_forced_shutdown ] (3.5.15)

    Windows コンソールや UNIX シェルでの強制終了を無効にします。

  • [ wrapper.forced_shutdown.delay ] (3.5.37)

    強制終了を開始するまでの二つの[ctrl]+[c]、或いは「TERM」信号の間の最短期間（秒数）を制限します。

  • [ wrapper.disable_restarts ] (3.2.0)

    Wrapper による全ての JVM の自動再起動を無効にします。これは、エラーによる再起動や JVM 内部からの再起動リクエストによる再起動を含みます。

  • [ wrapper.disable_restarts.automatic ] (3.3.4)

    JVM がクラッシュするときや予想外に終了したときなどを含む、Wrapper による JVM の自動再起動を無効にします。

  • [ wrapper.disable_shutdown_hook ] (1.0.0)

    ［System.exit()］へのコールの検知を無効にします。

  • [ wrapper.disable_tests ] (3.5.16)

    Wrapper 障害モードをテストする複数のメソッドを無効にします。

  • [ wrapper.environment.dump.loglevel ] (3.5.36)

    Wrapper から見える環境変数がログ化されるログレベルを制限します。

  • [ wrapper.exit_code.error ] (3.5.31)

    Wrapper がエラーで停止したときに使用される出力コードを設定します。

  • [ wrapper.ignore_sequence_gaps ] (3.3.6)

    ナンバリングコンポーネントを含むプロパティのシーケンス内でギャップ（途切れ）を許可するかを制限します。

  • [ wrapper.ignore_signals ] (3.0.5)

    Wrapper がシステムシグナルを無視するかどうかを制限します。

  • [ wrapper.java.detect_debug_jvm ] (3.3.6)

    コマンドラインのデバッガーの検知を有効にします。

  • [ wrapper.java.monitor_exit ] (3.5.42) ( スタンダード版/プロフェッショナル版 )

    イベントログからの Java プロセス終了の監視を有効にします。

  • [ wrapper.java.version.fallback ] (3.5.38)

    Java バージョンが解析できないときに使用する代替値を指定します。

  • [ wrapper.java.version.max ] (3.5.35)

    Wrapper が Java アプリケーションを起動できる Java の最大バージョンを指定します。

  • [ wrapper.java.version.min ] (3.5.35)

    Wrapper が Java アプリケーションを起動できる Java の最小バージョンを指定します。

  • [ wrapper.java.version.output ] (3.5.17)

    Wrapper が利用している JVM のバージョンを表示します。

  • [ wrapper.java.version.timeout ] (3.5.27)

    チャイルド（子）プロセスが終了する前に JVM バージョンを表示させるまでの秒数を設定します。

  • [ wrapper.jvm_detach_started ] (3.5.8)

    Wrapper が終了した後でも JVM をスタンドアロンプロセスとして実行できるようにします。

    • [ wrapper.java.errfile ] (3.5.8)

      切り離された JVM の「stderr」メッセージがリダイレクトされるファイルのパスを指定します。

    • [ wrapper.java.outfile ] (3.5.8)

      切り離された JVM の「stdout」メッセージがリダイレクトされるファイルのパスを指定します。

[スタートアップ遅延]

[開始／停止　タイムアウト]

  • [ wrapper.startup_thread.timeout ] (3.5.11)

    非同期スタートアップ処理を完了させるための待機時間（秒数）を設定します。

  • [ wrapper.startup.timeout ] (1.1.0)

    Wrapper が JVM プロセスを起動してから、JVM 側がアプリケーションのスタートアップが確立したと応答を返すまでの Wrapper の待機時間（秒数）を設定します。

  • [ wrapper.cpu.timeout ] (2.2.8)

    JVM が警告を発信してタイムアウト時間を延長する前の CPU を利用しない期間（秒数）を設定します。

  • [ wrapper.shutdown.timeout ] (2.2.7)

    Wrapper が JVM へシャットダウンするように指示を出してから、JVM 側がそれに応答して停止すると返事するまでの待機時間（秒数）を設定します。

  • [ wrapper.jvm_cleanup.timeout ] (3.4.0)

    JVM が完全にシャットダウンされた後、Wrapper がチャイルド（子）プロセスをクリーンアップする最大時間（秒数）を設定します。

  • [ wrapper.jvm_exit.timeout ] (2.2.8)

    「JVM が停止している」とレポートを受けてから、実際に JVM プロセスを終了するまでの待機時間（秒数）を設定します。

  • [ wrapper.jvm_kill.delay ] (3.5.6) ( プロフェッショナル版 )

    「JVM kill」イベントが発生してから、実際に JVM が強制終了されるまでの、ポーズ（一時停止）する時間（秒数）を設定します。

[プロセッサアフィニティ]

[Ping]

  • [ wrapper.ping.alert.loglevel ] (3.5.16)

    ping 警告メッセージをログ化するログレベルを設定します。

  • [ wrapper.ping.alert.threshold ] (3.5.16)

    ping 応答がしきい値（秒数）よりも長い時間がかかった場合、その警告メッセージをログ化します。

  • [ wrapper.ping.interval ] (3.0.5)

    JVM へ ping 要求を送信するインターバル（一定間隔）（秒数）を設定します。

  • [ wrapper.ping.interval.logged ] (3.2.4)

    ログ化する ping 要求のインターバル（一定間隔）（秒数）を設定します。

  • [ wrapper.ping.timeout ] (1.0.0)

    JVM から送信される ping 応答の最大間隔（秒数）を設定します。

  • [ wrapper.ping.timeout.action ] (3.5.16)

    ping タイムアウトが経過した時に動作するアクションを設定します。

[起動]

  • [ wrapper.max_failed_invocations ] (2.2.8)

    Wrapper が JVM の再起動を試みる最大回数を設定します。

  • [ wrapper.successful_invocation_time ] (2.2.8)

    正常に開始されたとみなされるためにアプリケーションが動作を継続しなければならない最低限の経過時間（秒数）を設定します。

[時間／時計]

    • [ wrapper.timer_fast_threshold ] (3.1.0)

      システム時刻が指定された秒数以上進むと警告メッセージを表示します。

    • [ wrapper.timer_slow_threshold ] (3.1.0)

      システム時刻が指定された秒数以上遅れると警告メッセージを表示します。

[ポート]

  • [ wrapper.port ] (1.0.0)

    Wrapper が JVM へ接続するときに利用するポートを設定します。

  • [ wrapper.port.address ] (3.5.18)

    Wrapper と JVM の間の通信に利用する IP アドレスを指定します。

  • [ wrapper.port.max ] (3.2.0)

    Wrapper が JVM へ接続するときに利用するポートの範囲の上限値を設定します。

  • [ wrapper.port.min ] (3.2.0)

    Wrapper が JVM へ接続するときに利用するポートの範囲の下限値を設定します。

  • [ wrapper.jvm.port ] (3.2.0)

    JVM が Wrapper へ通信するときに使用するポートを構成します。

  • [ wrapper.jvm.port.max ] (3.2.0)

    JVM が Wrapper へ通信するときに利用するポートの範囲の上限を指定します。

  • [ wrapper.jvm.port.min ] (3.2.0)

    JVM が Wrapper へ通信するときに利用するポートの範囲の下限を指定します。

[x ファイル]

  • [ wrapper.anchorfile ] (3.1.1)

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

  • [ wrapper.anchorfile.poll_interval ] (3.5.31)

    アンカーファイルの存在をテストするときのインターバル（一定間隔）を設定します。

  • [ wrapper.anchor.poll_interval ] (3.1.1 - 3.5.31で廃止)

    アンカーファイルの存在をテストするときのインターバル（一定間隔）を設定します。

  • [ wrapper.commandfile ] (3.2.0)

    実行するコマンドを含むファイルのパスを設定します。

  • [ wrapper.lockfile ] (3.2.0)

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

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

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

  • [ wrapper.pidfile.strict ] (3.5.14)

    スタートアップ時に PID ファイルが存在している場合、Wrapper を停止させます。

  • [ wrapper.statusfile ] (3.2.0)

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

  • [ wrapper.java.idfile ] (3.2.0)

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

  • [ wrapper.java.pidfile ] (3.0.5)

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

  • [ wrapper.java.statusfile ] (3.2.0)

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

[グループ]

[umask]

[表示]

  • [ wrapper.console.title ] (3.1.0)

    Wrapper が作動しているコンソールのタイトルバーに表示されるタイトルを設定します。

  • [ wrapper.console.title.<platform> ] (3.1.0)

    プラットフォームに基づくコンソールのタイトルを設定します。

  • [ wrapper.name ] (3.3.0)

    エラーメッセージやイベント時などのサービス名を設定します。

  • [ wrapper.displayname ] (3.3.0)

    エラーメッセージやイベントなどで利用されるサービス名の表示名を設定します。

  • [ wrapper.description ] (3.3.0)

    システムエラーメッセージやイベントなどのサービス説明を設定します。

[デッドロック]

[廃止]