wrapper.startup.timeout

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

ADVERTENCIA

NO modifique ninguno de estos parámetros a menos que haya leído esta descripción de la propiedad. Una configuración incorrecta puede hacer que el Wrapper no funcione como se espera.

Número de segundos permitidos entre el momento en que el Wrapper inicia el proceso de la JVM y el momento en que el lado JVM del Wrapper responde que la aplicación se ha iniciado. Establecer el valor de esta propiedad en "0" (cero) significa que nunca se agotará el tiempo de espera.

El valor predeterminado es "30 segundos".

Ejemplo:
wrapper.startup.timeout=30

¿Problemas?

Si experimenta problemas de tiempo de espera al iniciar su aplicación, la causa más común es una configuración incorrecta. Verifique que el WrapperManager se esté iniciando realmente. Debería ver la siguiente salida en la consola cuando inicie el Wrapper.

wrapper  | --> Wrapper Started as Console
wrapper  | Java Service Wrapper Professional Edition 64-bit 3.x.x
wrapper  |   Copyright (C) 1999-2010 Tanuki Software, Ltd.  All Rights Reserved.
wrapper  |     http://wrapper.tanukisoftware.org
wrapper  |   Licensed to Acme, Inc.
wrapper  |
wrapper  | Launching a JVM...
jvm 1    | WrapperManager: Initializing...

Si no ve la versión del Wrapper, entonces el WrapperManager no se está iniciando. Asegúrese de haber leído la sección Resumen de métodos de integración para comprobar la configuración correcta. Si la configuración parece correcta, intente habilitar la salida de registro de nivel DEBUG para intentar acotar el problema.

Si se muestra la versión del Wrapper, pero el Wrapper sigue agotando el tiempo de espera al iniciar, entonces es muy probable que se deba a una de estas dos razones.

La primera posibilidad es que la llamada al método start no esté retornando. Esto no debería ser un problema si está usando las clases WrapperSimpleApp, WrapperStartStopApp o WrapperJarApp para iniciar su aplicación. Sin embargo, si está implementando WrapperListener, verifique que el método start realmente retorne al completarse. Debería poder ver esto con la salida DEBUG habilitada.

La otra posibilidad es que el método de inicio simplemente tarde un tiempo en completarse. En este caso, puede ser necesario ampliar el tiempo de espera de inicio predeterminado. Intente establecerlo en "300 segundos" (5 minutos) y vea si eso hace desaparecer el problema.

Es mejor elegir un valor lo suficientemente largo para que la aplicación se inicie de forma fiable, pero lo suficientemente corto para que el Wrapper reaccione lo más rápido posible en caso de un cuelgue real de la JVM.

WrapperManager.signalStarting(n) :

Si el procedimiento de inicio a veces tarda mucho tiempo, una alternativa a establecer un tiempo de espera largo es llamar periódicamente al método WrapperManager.signalStarting(n). Este método informa al Wrapper de que la JVM está activa y que el inicio de la aplicación va bien. El informe se repetirá tantas veces como sea necesario. Por lo tanto, se requiere ese tiempo adicional, y el inicio puede tardar mucho más tiempo.

ADVERTENCIA

Aunque esta capacidad existe, tenga en cuenta que establecer el valor de esta propiedad en "0" (cero) (= deshabilitar el tiempo de espera) o en algún valor grande significará que la capacidad del Wrapper para detectar un cuelgue de la JVM durante la fase de inicio quedará deshabilitada.

Si la clase principal configurada con la propiedad wrapper.java.mainclass no inicializa correctamente la clase WrapperManager del Wrapper, entonces el inicio fallará con el siguiente mensaje aunque la aplicación parezca haberse iniciado:

------------------------------------------------------------------------
Advice:
The Wrapper consists of a native component as well as a set of classes
which run within the JVM that it launches.  The Java component of the
Wrapper must be initialized promptly after the JVM is launched or the
Wrapper will timeout, as just happened.  Most likely the main class
specified in the Wrapper configuration file is not correctly initializing
the Wrapper classes:
    com.myapp.Main
While it is possible to do so manually, the Wrapper ships with helper
classes to make this initialization processes automatic.
Please review the integration section of the Wrapper's documentation
for the various methods which can be employed to launch an application
within the Wrapper:
    http://wrapper.tanukisoftware.org/doc/english/integrate.html
------------------------------------------------------------------------

Como indica el mensaje, se trata de un problema de configuración y se puede resolver siguiendo las instrucciones de uno de los métodos de integración documentados.

ADVERTENCIA

Mientras la propiedad wrapper.java.detect_debug_jvm esté establecida en "TRUE" y la detección del depurador esté funcionando, esta propiedad de "tiempo de espera" se ignorará.

Referencia: Timeout

Referencia: Reinicio, Inicio