Descripción general

En algunas instalaciones, la propiedad wrapper.java.command puede apuntar a un script o a un ejecutable que redirigirá a un proceso diferente, el que realmente ejecuta su aplicación. Este es el caso, por ejemplo, cuando el comando Java apunta a C:\Program Files\Common Files\Oracle\Java\javapath\java.exe (a menudo porque Oracle Java configura la variable de entorno PATH con esta entrada durante la instalación). Dependiendo de cómo se reenvíen las señales al proceso Java, esta redirección puede hacer que ciertas funciones, como las solicitudes de volcado de hilos, no funcionen correctamente.

Para detectar cuándo ocurre esto, el Wrapper comparará el PID del proceso Java justo después de iniciarse y el PID del proceso que lanzó. Si difieren, se imprimirá una advertencia.

En Windows, el Wrapper cambiará automáticamente a monitorizar el proceso Java en lugar del proceso lanzado para garantizar un funcionamiento correcto. Si se utiliza el archivo PID de Java, el archivo se actualizará con el nuevo PID.

La salida debería verse así:

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.

Este comportamiento se puede configurar con las siguientes propiedades:

wrapper.java.monitor

Compatibilidad :3.5.46
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :WindowsMac OSX (No Compatible)Linux (No Compatible)Alpine Linux (No Compatible)FreeBSD (No Compatible)Solaris (No Compatible)IBM z/Linux (No Compatible)

Esta propiedad se utiliza en Windows para indicar al Wrapper si debe seguir monitorizando el proceso que lanzó o cambiar automáticamente al proceso Java en caso de que se produzca una redirección. En sistemas UNIX, el Wrapper siempre monitorizará el proceso que lanzó.

El valor predeterminado es JAVA, lo que hace que el Wrapper siempre intente monitorizar el proceso Java que ejecuta su aplicación.

El valor 'LAUNCHED' se puede utilizar para seguir monitorizando el proceso lanzado por el Wrapper, como ocurría con las versiones del Wrapper anteriores a 3.5.46.

NOTA

Desde la versión 3.7.0, el Wrapper ha implementado una verificación más estricta con respecto a la redirección de procesos:

Anteriormente, al utilizar el modo LAUNCHED, el Wrapper continuaba monitorizando el ciclo de vida del proceso Java a través de la conexión backend incluso si se producía una redirección. Aunque la monitorización principal seguía funcionando, ciertas funciones (como las solicitudes de volcado de hilos y el manejo de señales) se deshabilitaban porque requieren específicamente una coincidencia de PID. Este era el comportamiento estándar tanto en Windows como en UNIX.

La versión 3.7.0 introduce varias mejoras para fortalecer la autenticación del proceso Java que se conecta al Wrapper. Una de ellas es verificar que el PID informado por Java sea legítimo.

Para funcionar de la mejor manera con la verificación de PID y ofrecer la autenticación más segura, el modo LAUNCHED se ha vuelto estricto, imponiendo la estabilidad del PID. Esto permite al Wrapper verificar que el proceso que se conecta es exactamente el que lanzó, rechazando la conexión entrante en caso contrario.

Se ha añadido un modo LEGACY para mantener la compatibilidad hacia atrás, aunque no es necesario ni recomendado para la mayoría de los escenarios.

Tenga en cuenta que la redirección sigue permitida al utilizar el modo JAVA (disponible solo en Windows). Incluso en este modo, el Wrapper continúa buscando el PID dentro de su jerarquía de procesos y verifica que corresponda al proceso par. Esto proporciona una autenticación menos estricta que en el modo LAUNCHED, pero sigue siendo el valor predeterminado en Windows para mantener la compatibilidad con el instalador predeterminado de Oracle Java, que utiliza un redireccionador 'javapath' para lanzar la JVM.

Para entornos con requisitos de alta seguridad, se recomienda utilizar el modo LAUNCHED y asegurarse de que wrapper.java.command (o JAVA_HOME) apunte directamente al ejecutable Java real en lugar de a un redireccionador.

Ejemplo: (Seguir monitorizando el proceso lanzado por el Wrapper)
wrapper.java.monitor=LAUNCHED

La salida debería verse así:

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.

NOTA

Algunas instalaciones de Java en UNIX están configuradas con un script de shell para ayudar a cambiar de JVM. Por lo general, el PID entre el script de shell y el proceso Java no cambia porque este último se lanza con 'exec'. Si planea escribir su propio script para lanzar Java, se recomienda utilizar también el comando exec al llamar a Java. El Wrapper mostrará una advertencia si detecta que el PID cambió, pero no cambiará el proceso monitorizado.

wrapper.java.monitor.redirect.loglevel

Compatibilidad :3.5.46
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

En algunos casos, se sabe que el comportamiento de cambiar a monitorizar el proceso Java o de seguir monitorizando el proceso lanzado no causará ningún efecto no deseado. La propiedad wrapper.java.monitor.redirect.loglevel le permite controlar el nivel de registro de los mensajes que el Wrapper imprime cuando detecta que el proceso Java difiere del proceso que lanzó, y se puede establecer en DEBUG para omitir las advertencias durante las ejecuciones normales.

El valor predeterminado es WARN.

Ejemplo: (Mostrar el mensaje solo en modo de depuración)
wrapper.java.monitor.redirect.loglevel=DEBUG

La salida debería verse así:

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.