Descripción general de las propiedades wrapper.java.version.*

El Java Service Wrapper tiene la capacidad de imprimir la versión de Java especificada con wrapper.java.command, y de impedir que la aplicación se inicie si la versión de Java no se encuentra dentro de un rango configurado.

NOTA

Cuando se utilizan jdb o javaw como comando de Java, su salida no puede usarse para analizar información como la versión o el proveedor de Java. Desde la versión 3.5.45, el Wrapper intenta encontrar el comando 'java' en el mismo directorio (o simplemente 'java' si el comando debe resolverse mediante el PATH del sistema) y lo utiliza para consultar la información. Si esto falla, aún puede usar la propiedad wrapper.java.version.fallback para especificar la versión de forma manual.

wrapper.java.version.output

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

A veces puede dar lugar a comportamientos inesperados o sorprendentes al ejecutar una aplicación Java con una versión de Java distinta de la prevista para el programa.

Por lo tanto, puede resultar útil ver la versión exacta de la JVM que se está utilizando antes de que se inicie la aplicación.

El Wrapper imprimirá la versión exacta de la JVM si la propiedad wrapper.java.version.output se establece en TRUE.

A partir de la versión 3.5.55, el valor predeterminado se basa en el valor de wrapper.java.query.loglevel:
 - Si wrapper.java.query.loglevel se establece en DEBUG, wrapper.java.version.output toma el valor predeterminado FALSE.
 - Si wrapper.java.query.loglevel se establece en INFO o cualquier nivel superior, wrapper.java.version.output toma el valor predeterminado TRUE.

Antes de la versión 3.5.55, el valor predeterminado era "FALSE".

El Wrapper también mostrará automáticamente la versión de la JVM si se ejecuta en modo de depuración.

Ejemplo de registro:
wrapper  | Launching a JVM...
jvm 1    | java version "1.6.0_24"
jvm 1    | OpenJDK Runtime Environment (IcedTea6 1.11.5) (6b24-1.11.5-0ubuntu1~10.04.2)
jvm 1    | OpenJDK 64-Bit Server VM (build 20.0-b12, mixed mode)
jvm 1    | WrapperManager: Initializing...

NOTA

A partir de la versión 3.5.35, la salida del registro utiliza un origen diferente 'JVM ver.' (en lugar de 'JVM 1', 'JVM 2', etc.) al mostrar la versión de Java. Esto se hace para evitar confusiones con la salida de la aplicación Java.

wrapper.java.version.info.loglevel

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

Controla el nivel de registro de la información del entorno de ejecución de Java analizada por el Wrapper al ejecutar 'java --version'. Esta propiedad puede usarse de forma independiente o combinada con wrapper.java.version.output.

A partir de la versión 3.7.2, se imprimen los siguientes detalles:

  • Proveedor
  • Versión
  • Arquitectura
  • Modelo de datos

Los niveles de registro válidos incluyen:

  • NONE para no registrar nunca,
  • FATAL para registrar en el nivel FATAL,
  • ERROR para registrar en el nivel ERROR,
  • WARN para registrar en el nivel WARN,
  • STATUS para registrar en el nivel STATUS,
  • INFO para registrar en el nivel INFO,
  • DEBUG para registrar en el nivel DEBUG.

El valor predeterminado es "DEBUG". Esto significa que estos detalles solo se mostrarán cuando el nivel de registro del Wrapper general esté establecido en "DEBUG".

Ejemplo: (Configuración)
wrapper.java.version.info.loglevel=STATUS

Ejemplo: (Salida)
STATUS | wrapper  | Java Runtime Info:
STATUS | wrapper  |   Vendor       : Eclipse Adoptium
STATUS | wrapper  |   Version      : 25.0.4
STATUS | wrapper  |   Architecture : amd64
STATUS | wrapper  |   Data Model   : 64-Bit
STATUS | wrapper  |

wrapper.java.version.timeout

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

Número de segundos que el Wrapper esperará a que se imprima la versión de Java. Si se supera este tiempo de espera, el Wrapper finalizará el proceso hijo y resolverá la versión de Java al valor mínimo admitido.

Para la mayoría de los usuarios, este tiempo de espera nunca se alcanzará porque imprimir la versión de la JVM es rápido. Sin embargo, en máquinas lentas puede ocurrir que la JVM tarde mucho en iniciarse. Si el retraso alcanza el tiempo de espera, el proceso hijo se finaliza y no se imprimirá la versión de la JVM.

El valor predeterminado es 30 segundos. Si establece el valor en 0, el Wrapper esperará indefinidamente a que el proceso hijo termine.

Tarda demasiado en imprimir la versión de la JVM:
wrapper  | Launching a JVM...
wrapper  | Child process: Java version: timed out
jvm 1    | WrapperManager: Initializing...

wrapper.java.version.fallback

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

Esta propiedad se utiliza en caso de que el Wrapper no consiga analizar la salida de 'java -version'.

Si no se establece, la versión de Java se resolverá a la versión admitida más baja, pero el Wrapper se detendrá cuando se utilicen las siguientes propiedades:

Sin embargo, cuando se utiliza wrapper.java.version.fallback, todas las propiedades anteriores pueden usarse incluso si no se consigue analizar la salida de 'java -version'.

Usar Java 1.8 de forma predeterminada en caso de que no se pudiera analizar la versión de Java:
wrapper.java.version.fallback=1.8

wrapper.java.version.min

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

Especifica la versión mínima de Java con la que se permite al Wrapper iniciar la aplicación Java.

El valor predeterminado es '1.4', que es la versión de JVM más antigua admitida por el Wrapper. Cualquier valor inferior no es válido y hará que el Wrapper se detenga.

El valor puede estar en el formato '1.major[.minor[_revision]]' o 'major[.minor[.revision]]', independientemente de la versión de Java. Esto se hace para admitir ambos esquemas de numeración que devuelve 'java -version': antes de Java 9 se utilizaba el primer formato, mientras que Java 9 y posteriores utilizan el segundo formato.

Los corchetes indican que los componentes minor y revision son opcionales. Si se deja uno o ambos sin especificar, estos marcadores de posición aceptarán cualquier número.

Se permite Java 1.7 o superior:
wrapper.java.version.min=1.7
Se permite Java 8.0.40 o superior:
wrapper.java.version.min=8.0.40

ADVERTENCIA

wrapper.java.version.max

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

Especifica la versión máxima de Java con la que se permite al Wrapper iniciar la aplicación Java.

El valor predeterminado es 'UNLIMITED', que permite al Wrapper iniciar la aplicación Java con las versiones más recientes de Java. Por lo general, se espera que esto funcione gracias a la compatibilidad hacia atrás garantizada a través de las versiones de Java. Sin embargo, en la práctica a veces es diferente, y se recomienda usar una versión del Wrapper publicada después (o cerca) de la fecha de lanzamiento de Java, ya que la compatibilidad puede probarse y confirmarse.

El valor puede estar en el formato '1.major[.minor[_revision]]' o 'major[.minor[.revision]]', independientemente de la versión de Java. Esto se hace para admitir ambos esquemas de numeración que devuelve 'java -version': antes de Java 9 se utilizaba el primer formato, mientras que Java 9 y posteriores utilizan el segundo formato.

Los corchetes indican que los componentes minor y revision son opcionales. Si se deja uno o ambos sin especificar, estos marcadores de posición aceptarán cualquier número.

Se permite Java 9.0.1 e inferior:
wrapper.java.version.max=9.0.1
Se permiten todas las revisiones y versiones menores de Java 9, e inferiores:
wrapper.java.version.max=9

ADVERTENCIA