Übersicht

Bei manchen Installationen kann die Eigenschaft wrapper.java.command auf ein Skript oder eine ausführbare Datei verweisen, die zu einem anderen Prozess umleitet, nämlich dem, der Ihre Anwendung tatsächlich ausführt. Dies ist beispielsweise der Fall, wenn der Java-Befehl auf C:\Program Files\Common Files\Oracle\Java\javapath\java.exe zeigt (häufig, weil Oracle Java während der Installation die PATH-Umgebungsvariable mit diesem Eintrag konfiguriert). Je nachdem, wie Signale an den Java-Prozess weitergeleitet werden, kann diese Umleitung dazu führen, dass bestimmte Funktionen wie Thread-Dump-Anforderungen nicht korrekt funktionieren.

Um zu erkennen, wann dies geschieht, vergleicht der Wrapper die PID des Java-Prozesses unmittelbar nach dessen Start mit der PID des Prozesses, den er gestartet hat. Wenn sie sich unterscheiden, wird eine Warnung ausgegeben.

Unter Windows wechselt der Wrapper automatisch zur Überwachung des Java-Prozesses anstelle des gestarteten Prozesses, um eine korrekte Funktionsweise sicherzustellen. Wenn die Java-PID-Datei verwendet wird, wird die Datei mit der neuen PID aktualisiert.

Die Ausgabe sollte wie folgt aussehen:

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.

Dieses Verhalten kann mit den folgenden Eigenschaften konfiguriert werden:

wrapper.java.monitor

Kompatibel :3.5.46
Editionen :Professional EditionStandard EditionCommunity Edition
Betriebssysteme :WindowsMac OSX (Not Supported)Linux (Not Supported)Alpine Linux (Not Supported)FreeBSD (Not Supported)Solaris (Not Supported)IBM z/Linux (Not Supported)

Diese Eigenschaft wird unter Windows verwendet, um dem Wrapper mitzuteilen, ob er den von ihm gestarteten Prozess weiterhin überwachen oder bei einer Umleitung automatisch zum Java-Prozess wechseln soll. Auf UNIX-Systemen überwacht der Wrapper immer den Prozess, den er gestartet hat.

Der Standardwert ist JAVA, wodurch der Wrapper immer versucht, den Java-Prozess zu überwachen, der Ihre Anwendung ausführt.

Der Wert 'LAUNCHED' kann verwendet werden, um den vom Wrapper gestarteten Prozess weiterhin zu überwachen, wie es bei Wrapper-Versionen vor 3.5.46 der Fall war.

NOTE

Seit Version 3.7.0 hat der Wrapper eine strengere Überprüfung bezüglich der Prozessumleitung implementiert:

Zuvor überwachte der Wrapper im Modus LAUNCHED den Lebenszyklus des Java-Prozesses weiterhin über die Backend-Verbindung, auch wenn eine Umleitung stattfand. Während die Kernüberwachung funktionsfähig blieb, wurden bestimmte Funktionen (wie Thread-Dump-Anforderungen und Signalverarbeitung) deaktiviert, da sie speziell eine PID-Übereinstimmung erfordern. Dies war das Standardverhalten sowohl unter Windows als auch unter UNIX.

Version 3.7.0 führt mehrere Verbesserungen ein, um die Authentifizierung des Java-Prozesses zu stärken, der sich mit dem Wrapper verbindet. Eine davon ist die Überprüfung, dass die von Java gemeldete PID legitim ist.

Um optimal mit der PID-Überprüfung zusammenzuarbeiten und die sicherste Authentifizierung zu bieten, wurde der Modus LAUNCHED streng gestaltet und erzwingt PID-Stabilität. Dadurch kann der Wrapper überprüfen, dass der verbindende Prozess genau derjenige ist, den er gestartet hat, und andernfalls die eingehende Verbindung ablehnen.

Ein Modus LEGACY wurde hinzugefügt, um die Abwärtskompatibilität zu wahren, obwohl er für die meisten Szenarien weder erforderlich noch empfohlen ist.

Beachten Sie, dass eine Umleitung bei Verwendung des Modus JAVA (nur unter Windows verfügbar) weiterhin zulässig ist. Auch in diesem Modus sucht der Wrapper weiterhin die PID in seiner Prozesshierarchie und überprüft, ob sie dem Peer-Prozess entspricht. Dies bietet eine weniger strenge Authentifizierung als im Modus LAUNCHED, bleibt aber unter Windows der Standard, um die Kompatibilität mit dem Standard-Installer von Oracle Java zu wahren, der einen 'javapath'-Redirector zum Starten der JVM verwendet.

Für Umgebungen mit hohen Sicherheitsanforderungen wird empfohlen, den Modus LAUNCHED zu verwenden und sicherzustellen, dass wrapper.java.command (oder JAVA_HOME) direkt auf die tatsächliche Java-Executable und nicht auf einen Redirector zeigt.

Beispiel: (Den vom Wrapper gestarteten Prozess weiterhin überwachen)
wrapper.java.monitor=LAUNCHED

Die Ausgabe sollte wie folgt aussehen:

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.

NOTE

Einige Java-Installationen unter UNIX sind mit einem Shell-Skript eingerichtet, um den Wechsel zwischen JVMs zu erleichtern. Im Allgemeinen bleibt die PID zwischen dem Shell-Skript und dem Java-Prozess unverändert, da letzterer mit 'exec' gestartet wird. Wenn Sie planen, ein eigenes Skript zum Starten von Java zu schreiben, wird empfohlen, beim Aufruf von Java ebenfalls den exec-Befehl zu verwenden. Der Wrapper zeigt eine Warnung an, wenn er erkennt, dass sich die PID geändert hat, ändert den überwachten Prozess jedoch nicht.

wrapper.java.monitor.redirect.loglevel

Kompatibel :3.5.46
Editionen :Professional EditionStandard EditionCommunity Edition
Betriebssysteme :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

In manchen Fällen ist bekannt, dass das Verhalten, entweder zur Überwachung des Java-Prozesses zu wechseln oder den gestarteten Prozess weiterhin zu überwachen, keine unerwünschten Auswirkungen hat. Die Eigenschaft wrapper.java.monitor.redirect.loglevel ermöglicht es Ihnen, den Log-Level der Meldungen zu steuern, die der Wrapper ausgibt, wenn er erkennt, dass der Java-Prozess vom gestarteten Prozess abweicht, und kann auf DEBUG gesetzt werden, um Warnungen bei normalen Ausführungen zu unterdrücken.

Der Standardwert ist WARN.

Beispiel: (Meldung nur im Debug-Modus anzeigen)
wrapper.java.monitor.redirect.loglevel=DEBUG

Die Ausgabe sollte wie folgt aussehen:

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.