Descripción general de las propiedades de recuperación de servicios de Windows

El Java Service Wrapper hace un muy buen trabajo al supervisar y recuperarse de los errores en el proceso Java. Aunque el Wrapper en sí es muy estable, es conveniente evitar cualquier punto de fallo. El Wrapper permite aprovechar la capacidad del Administrador de servicios de Windows para reiniciar automáticamente un servicio que se ha bloqueado. Que el Wrapper devuelva un código de salida distinto de cero no se considera un fallo.

Las propiedades wrapper.ntservice.recovery.<n> permiten configurar estas funciones de recuperación desde la configuración del Wrapper. A continuación se muestra un ejemplo de configuración.

NOTA

Estas propiedades se utilizan al instalar el Wrapper como servicio de Windows. Los cambios en cualquiera de estas propiedades no tendrán efecto hasta que se reinstale el servicio de Windows, pero puede editar la configuración de un servicio instalado desde la pestaña Recuperación del cuadro de diálogo Propiedades del Panel de control de servicios.

wrapper.ntservice.recovery.reset

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

El Administrador de control de servicios de Windows mantiene un recuento de fallos para cada servicio instalado. Cada vez que el servicio finaliza de forma inesperada, el contador se incrementará y se activará la acción de fallo registrada para ese recuento.

Esta propiedad se utiliza para configurar el tiempo en segundos, sin ningún error, transcurrido el cual el Administrador de servicios restablecerá este contador a "0" (cero). El valor predeterminado de esta propiedad es 3600 (= 1 hora). Si se establece "-1", esto significa que el Administrador de control de servicios nunca restablecerá el contador.

Ejemplo, establecer el tiempo de restablecimiento en 86400 segundos (=1 día):
wrapper.ntservice.recovery.reset=86400

NOTA

Para evitar confusiones, tenga en cuenta que la pestaña Recuperación del cuadro de diálogo Propiedades del Panel de control de servicios muestra el tiempo de restablecimiento en días en lugar de segundos. Esto significa que los valores mostrados se redondearán a la baja a días. Por ejemplo, un valor de 3600 segundos (1 hora) se mostrará como "0" (cero) días.

wrapper.ntservice.recovery.command

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

Una de las cosas que el Administrador de control de servicios le permite hacer es ejecutar un comando externo en respuesta a un fallo. Esto se puede utilizar para realizar tareas como una limpieza o el envío de una notificación externa.

Aunque es posible especificar una propiedad wrapper.ntservice.recovery.<n>.failure diferente para cada evento de recuperación, la API del Administrador de control de servicios solo permite especificar un único comando, que luego se puede referenciar como la acción de fallo para uno o más eventos de recuperación.

Esta propiedad no tiene un valor predeterminado y debe especificarse si una o más "acciones de fallo" (propiedad wrapper.ntservice.recovery.<n>.failure) se establecen en COMMAND.

Ejemplo:
wrapper.ntservice.recovery.command=C:\cleanup.bat

wrapper.ntservice.recovery.reboot_msg

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

Si se especifica REBOOT para una propiedad wrapper.ntservice.recovery.<n>.failure, el Administrador de control de servicios registrará un evento del sistema que describe "por qué se reinició el sistema". Esta propiedad se utiliza para definir el texto de ese mensaje.

El mensaje predeterminado está localizado en el idioma que utiliza el Wrapper. En inglés, el mensaje predeterminado es: "System will be rebooted now due to an error in the wrapped service."

Ejemplo:
wrapper.ntservice.recovery.reboot_msg=System will reboot now.

wrapper.ntservice.recovery.<n>.failure

Compatibilidad :3.5.5
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
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 establece la acción de fallo que debe ocurrir si el servicio del Wrapper se bloquea. El componente "<n>" del nombre de la propiedad indica el número del recuento de fallos.

El Administrador de control de servicios cuenta el número de veces que cada servicio ha fallado desde que se inició el sistema. El recuento se restablece a "0" (cero) si el servicio no ha fallado durante al menos el número de segundos especificado en la propiedad wrapper.ntservice.recovery.reset. Cuando el servicio falla, el recuento de fallos (N) se utiliza para decidir qué acción de fallo tomar. Estas acciones se definen con la propiedad wrapper.ntservice.recovery.<n>.failure, donde 'N' es el recuento de fallos. Si N es mayor que la última acción configurada, se utilizará la acción de fallo con el N más alto (índice <n>).

Las acciones posibles son:

  • NONE :

    El Administrador de servicios no hará nada. Esto es lo mismo que si no se especificaran propiedades de recuperación. El servicio se detendrá y permanecerá detenido. Las acciones de fallo definidas con valores de N más altos nunca se alcanzarán.

  • RESTART :

    El Administrador de servicios reiniciará el servicio. Si desea realizar un reinicio de la aplicación Java con determinados códigos de salida que devuelve la JVM, también puede utilizar la propiedad wrapper.on_exit.<n>.

  • COMMAND :

    El Administrador de servicios ejecutará el comando especificado con la propiedad wrapper.ntservice.recovery.command. Si desea que el servicio se reinicie después de ejecutar el comando, esto debe hacerse dentro del comando.

  • REBOOT :

    El Administrador de servicios reiniciará la máquina. Si el modo de "inicio" del servicio está establecido en AUTO_START, el servicio se iniciará de nuevo después del reinicio. Consulte la propiedad wrapper.ntservice.starttype para obtener más información.

Ejemplo:
wrapper.ntservice.recovery.1.failure=RESTART
wrapper.ntservice.recovery.2.failure=COMMAND
wrapper.ntservice.recovery.3.failure=REBOOT

Aunque la API permite especificar una acción de fallo después de NONE o REBOOT, nunca se utilizarán.

NOTA

La pestaña Recuperación del cuadro de diálogo Propiedades del Panel de control de servicios ([Panel de control] - [Herramientas administrativas] - [Servicios]) solo mostrará las 3 primeras acciones de fallo configuradas. Sin embargo, la API permite definir más. Tenga en cuenta que el uso de más de 3 acciones de fallo podría resultar confuso para un usuario que consulte el cuadro de diálogo.

wrapper.ntservice.recovery.<n>.delay

Compatibilidad :3.5.5
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
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 establece el tiempo en segundos que el Administrador de control de servicios esperará hasta que realmente realice la acción correspondiente especificada en wrapper.ntservice.recovery.<n>.failure.

El valor de esta propiedad no puede ser menor que "0" (cero). El valor predeterminado es 3 veces el valor de la propiedad wrapper.ping.timeout.

Aunque en teoría sería posible establecer un retraso para la acción de fallo "NONE", el Administrador de control de servicios ignoraría el retraso en este caso.

Ejemplo, establecer el retraso en 90 segundos (1,5 min):
wrapper.ntservice.recovery.1.delay=90

NOTA

Para evitar confusiones al comprobar el servicio en el cuadro de diálogo de servicios en la pestaña Recuperación, tenga en cuenta que el tiempo de retraso se muestra en minutos. Esto significa que los valores mostrados se redondearán a la baja a minutos. Por ejemplo, un valor de 90 segundos (1,5 min) se mostrará como 1 minuto.

Poniéndolo todo junto

El siguiente ejemplo hará lo siguiente:

  • establecer el tiempo de restablecimiento en 86400 segundos (1 día)
  • 1.er fallo: indicar al Administrador de control de servicios que espere 90 segundos (1,5 min) antes de realizar la acción de fallo 1
  • 1.er fallo: especificar la acción de fallo 1 como RESTART, lo que reiniciará el servicio
  • 2.º fallo: indicar al Administrador de control de servicios que espere 180 segundos (3 min) antes de realizar la acción de fallo 2
  • 2.º fallo: especificar la acción de fallo 2 como COMMAND, lo que ejecutará un comando externo
  • 2.º fallo: establecer el comando externo en "C:\cleanup.bat"
  • 3.er fallo: indicar al Administrador de control de servicios que espere 600 segundos (10 min) antes de realizar la acción de fallo 3
  • 3.er fallo: especificar la acción de fallo 3 como REBOOT, lo que reiniciará la máquina
  • 3.er fallo: establecer el mensaje que se registra con el reinicio en los eventos del sistema en "System will reboot now."
Ejemplo:
wrapper.ntservice.recovery.reset=86400

wrapper.ntservice.recovery.1.delay=90
wrapper.ntservice.recovery.1.failure=RESTART

wrapper.ntservice.recovery.2.delay=180
wrapper.ntservice.recovery.2.failure=COMMAND
wrapper.ntservice.recovery.command=C:\cleanup.bat

wrapper.ntservice.recovery.3.delay=600
wrapper.ntservice.recovery.3.failure=REBOOT
wrapper.ntservice.recovery.reboot_msg=System will reboot now.

Comprobación del resultado en la pestaña Recuperación del servicio de Windows:

Inicio-Reinicio: Retrasos