概要

一部のインストールでは、wrapper.java.command プロパティが、実際にアプリケーションを実行している別のプロセスへリダイレクトするスクリプトまたは実行ファイルを指している場合があります。 これは、たとえば Java コマンドが C:\Program Files\Common Files\Oracle\Java\javapath\java.exe を指している場合です(多くの場合、Oracle Java がインストール時に PATH 環境変数へこのエントリを設定するためです)。 シグナルが Java プロセスへどのように転送されるかによって、このリダイレクトが原因でスレッドダンプ要求などの一部の機能が正しく動作しないことがあります。

これが起きていることを検出するため、Wrapper は起動直後のJava プロセスの PID と、自身が起動したプロセスの PID を比較します。 それらが異なる場合、警告が出力されます。

Windows では、適切な動作を確保するため、Wrapper は起動したプロセスではなく Java プロセスの監視へ自動的に切り替えます。Java PID ファイル が使用されている場合、ファイルは新しい PID で更新されます。

出力は次のようになります:

STATUS | ----- | wrapper  | Launching a JVM...
INFO   | 16960 | jvm 1    | WrapperManager: Initializing...
INFO   | 16960 | jvm 1    | TestWrapper: Initializing...
WARN   | 16960 | wrapper  | Detected that the Java process launched by the Wrapper (PID 16960) was redirected to C:\Program Files\Java\jdk-16.0.1\bin\java.exe (PID 1148).
WARN   | 16960 | wrapper  |  Switch to monitoring the Java process.
INFO   |  1148 | jvm 1    | TestWrapper: start()
INFO   |  1148 | jvm 1    | TestWrapper: ActionServer Enabled.
INFO   |  1148 | jvm 1    | TestWrapper:   Telnet localhost 9999
INFO   |  1148 | jvm 1    | TestWrapper:   Commands:
INFO   |  1148 | jvm 1    | TestWrapper:     S: Shutdown
INFO   |  1148 | jvm 1    | TestWrapper:     H: Expected Halt
INFO   |  1148 | jvm 1    | TestWrapper:     R: Restart
INFO   |  1148 | jvm 1    | TestWrapper:     D: Thread Dump
INFO   |  1148 | jvm 1    | TestWrapper:     U: Unexpected Halt (Simulate crash)
INFO   |  1148 | jvm 1    | TestWrapper:     V: Access Violation (Actual crash)
INFO   |  1148 | jvm 1    | TestWrapper:     G: Make the JVM appear to be hung.

この動作は、次のプロパティで設定できます:

wrapper.java.monitor

対応バージョン :3.5.46
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :WindowsMac OSX (未対応)Linux (未対応)Alpine Linux (未対応)FreeBSD (未対応)Solaris (未対応)IBM z/Linux (未対応)

このプロパティは Windows で、Wrapper が起動したプロセスの監視を継続するか、リダイレクトが発生した場合に Java プロセスへ自動的に切り替えるかを指定するために使用します。 UNIX システムでは、Wrapper は常に自身が起動したプロセスを監視します。

デフォルト値は JAVA であり、Wrapper は常にアプリケーションを実行している Java プロセスの監視を試みます。

値 'LAUNCHED' を使用すると、3.5.46 より前の Wrapper のバージョンと同様に、Wrapper が起動したプロセスの監視を継続できます。

注意

バージョン 3.7.0 以降、Wrapper はプロセスのリダイレクトに関してより厳格な検証を実装しています:

以前は、LAUNCHED モードを使用している場合、リダイレクトが発生しても、Wrapper はバックエンド接続を介して Java プロセスのライフサイクルの監視を継続していました。コアの監視は機能し続けていましたが、スレッドダンプ要求やシグナル処理など、PID の一致を特に必要とする一部の機能は無効化されていました。これは Windows と UNIX の両方における標準的な動作でした。

バージョン 3.7.0 では、Wrapper に接続する Java プロセスの認証を強化するためのいくつかの改善が導入されています。そのひとつは、Java が報告する PID が正当であることを検証することです。

PID 検証と最も安全な認証を最大限に活かすため、LAUNCHED モードは厳格化され、PID の安定性が強制されるようになりました。これにより Wrapper は、接続してくるプロセスがまさに自身が起動したプロセスであることを検証し、そうでなければ着信接続を拒否できます。

後方互換性を維持するために LEGACY モードが追加されていますが、ほとんどのシナリオでは必須ではなく、推奨もされません。

JAVA モード(Windows でのみ利用可能)を使用している場合でも、リダイレクトは引き続き許可される点に注意してください。このモードでも、Wrapper はプロセス階層内で PID を検索し続け、それがピアプロセスに対応することを検証します。これは LAUNCHED モードよりも緩やかな認証ですが、JVM の起動に 'javapath' リダイレクタを使用するデフォルトの Oracle Java インストーラとの互換性を維持するため、Windows ではデフォルトのままです。

高いセキュリティ要件のある環境では、LAUNCHED モードを使用し、wrapper.java.command(または JAVA_HOME)がリダイレクタではなく実際の Java 実行ファイルを直接指すようにすることを推奨します。

例:(Wrapper が起動したプロセスの監視を継続する)
wrapper.java.monitor=LAUNCHED

出力は次のようになります:

STATUS | ----- | wrapper  | Launching a JVM...
INFO   | 16960 | jvm 1    | WrapperManager: Initializing...
INFO   | 16960 | jvm 1    | TestWrapper: Initializing...
WARN   | 16960 | wrapper  | Detected that the Java process launched by the Wrapper (PID 16960) was redirected to C:\Program Files\Java\jdk-16.0.1\bin\java.exe (PID 1148).
WARN   | 16960 | wrapper  |  Switch to monitoring the Java process.
INFO   |  1148 | jvm 1    | TestWrapper: start()
INFO   |  1148 | jvm 1    | TestWrapper: ActionServer Enabled.
INFO   |  1148 | jvm 1    | TestWrapper:   Telnet localhost 9999
INFO   |  1148 | jvm 1    | TestWrapper:   Commands:
INFO   |  1148 | jvm 1    | TestWrapper:     S: Shutdown
INFO   |  1148 | jvm 1    | TestWrapper:     H: Expected Halt
INFO   |  1148 | jvm 1    | TestWrapper:     R: Restart
INFO   |  1148 | jvm 1    | TestWrapper:     D: Thread Dump
INFO   |  1148 | jvm 1    | TestWrapper:     U: Unexpected Halt (Simulate crash)
INFO   |  1148 | jvm 1    | TestWrapper:     V: Access Violation (Actual crash)
INFO   |  1148 | jvm 1    | TestWrapper:     G: Make the JVM appear to be hung.

注意

UNIX 上の一部の Java インストールは、JVM の切り替えを助けるシェルスクリプトで構成されています。一般に、シェルスクリプトと Java プロセスの間で PID は変わりません。後者が 'exec' で起動されるためです。独自のスクリプトで Java を起動する場合は、Java を呼び出す際にも exec コマンドを使用することを推奨します。Wrapper は PID の変更を検出すると警告を表示しますが、監視対象のプロセスは変更しません。

wrapper.java.monitor.redirect.loglevel

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

場合によっては、Java プロセスの監視へ切り替える、または起動したプロセスの監視を継続する動作が、望ましくない影響を引き起こさないことが分かっています。wrapper.java.monitor.redirect.loglevel プロパティでは、Wrapper が Java プロセスと自身が起動したプロセスが異なることを検出したときに出力するメッセージのログレベルを制御できます。通常の実行時に警告をスキップするには、DEBUG に設定できます。

デフォルト値は WARN です。

例:(デバッグモードでのみメッセージを表示する)
wrapper.java.monitor.redirect.loglevel=DEBUG

出力は次のようになります:

STATUS | ----- | wrapper  | Launching a JVM...
INFO   | 16960 | jvm 1    | WrapperManager: Initializing...
INFO   | 16960 | jvm 1    | TestWrapper: Initializing...
INFO   |  1148 | jvm 1    | TestWrapper: start()
INFO   |  1148 | jvm 1    | TestWrapper: ActionServer Enabled.
INFO   |  1148 | jvm 1    | TestWrapper:   Telnet localhost 9999
INFO   |  1148 | jvm 1    | TestWrapper:   Commands:
INFO   |  1148 | jvm 1    | TestWrapper:     S: Shutdown
INFO   |  1148 | jvm 1    | TestWrapper:     H: Expected Halt
INFO   |  1148 | jvm 1    | TestWrapper:     R: Restart
INFO   |  1148 | jvm 1    | TestWrapper:     D: Thread Dump
INFO   |  1148 | jvm 1    | TestWrapper:     U: Unexpected Halt (Simulate crash)
INFO   |  1148 | jvm 1    | TestWrapper:     V: Access Violation (Actual crash)
INFO   |  1148 | jvm 1    | TestWrapper:     G: Make the JVM appear to be hung.