Propriétés wrapper.ntservice.preshutdown.*

Compatibilité :3.5.30
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :WindowsMac OSX (Non pris en charge)Linux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

Lorsque le système s'arrête, il attend un court instant (généralement entre 5 et 20 secondes) que les services se terminent proprement. Au-delà de cette limite, tous les services qui continuent de s'exécuter seront tués. Dans la plupart des cas, les services ont suffisamment de temps pour s'arrêter normalement, mais certains peuvent avoir besoin de plus de temps pour effectuer des tâches de nettoyage.

Avant de s'arrêter, le système envoie une notification « preshutdown ». Un service qui a besoin de temps supplémentaire peut gérer cette notification en définissant wrapper.ntservice.preshutdown à TRUE. Cela bloquera l'arrêt du système jusqu'à ce que le service s'arrête ou que le délai d'attente preshutdown expire.

La valeur par défaut est « FALSE ».

AVERTISSEMENT

Bloquer l'arrêt du système peut affecter l'expérience utilisateur. Cette propriété ne doit être définie à TRUE que si les tâches de nettoyage du processus en cours d'arrêt sont absolument nécessaires.

NOTE

Ces propriétés ne sont utilisées que sur les plates-formes Windows. Elles sont ignorées sur Windows Itanium, Windows XP et versions inférieures. Pour ces versions de Windows, une solution de contournement possible consiste à modifier la clé de registre « WaitToKillServiceTimeout », mais cela n'est pas vraiment recommandé car cela s'appliquerait à tous les services du système.

NOTE

La propriété wrapper.ntservice.preshutdown peut être modifiée sans réinstaller le service. Cependant, à partir de la version 3.5.37 du Wrapper, les modifications de wrapper.ntservice.preshutdown.timeout ne prendront effet qu'une fois le service Windows réinstallé.

wrapper.ntservice.preshutdown

Compatibilité :3.5.30
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :WindowsMac OSX (Non pris en charge)Linux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

Si elle est définie à TRUE, le service gérera la notification « preshutdown » envoyée par le système. Cela bloquera l'arrêt du système jusqu'à ce que le service s'arrête ou que le délai d'attente spécifié par wrapper.ntservice.preshutdown.timeout expire.

Exemple :
wrapper.ntservice.preshutdown=TRUE

wrapper.ntservice.preshutdown.timeout

Compatibilité :3.5.30
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :WindowsMac OSX (Non pris en charge)Linux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

Cette propriété spécifie la durée pendant laquelle le Gestionnaire de services Windows attendra après l'envoi de la notification preshutdown. Lorsque le délai d'attente expire, le système démarre son processus d'arrêt et attend un délai d'arrêt supplémentaire (non configurable depuis le Wrapper) avant de tuer les services encore en cours d'exécution.

Les valeurs valides sont comprises entre « 1 » et « 3600 » secondes. La valeur par défaut est 180 secondes (3 minutes).

NOTE

Les modifications de cette propriété ne prendront effet qu'une fois le service Windows réinstallé avec wrapper.ntservice.preshutdown défini à TRUE.

Exemple (le système attendra jusqu'à 5 min que le service s'arrête) :
wrapper.ntservice.preshutdown.timeout=300

AVERTISSEMENT

Ce délai d'attente n'est pas utilisé directement par le Wrapper, mais est transmis au Gestionnaire de services Windows. Pour garantir que le Gestionnaire de services n'interrompra pas un processus avant le Wrapper, il est conseillé de choisir une valeur supérieure à la somme des délais d'attente du Wrapper qui s'appliquent à l'arrêt. Ces délais d'attente sont wrapper.shutdown.timeout, wrapper.jvm_exit.timeout, wrapper.jvm_cleanup.timeout (lors de la gestion des processus enfants) et wrapper.request_thread_dump_on_failed_jvm_exit.delay (lors de l'utilisation d'un Thread Dump si la JVM ne se termine pas sur demande).

Dans les cas où le délai d'arrêt du système est critique, le Wrapper n'imposera pas que wrapper.ntservice.preshutdown.timeout soit plus long que les délais d'attente précédemment listés, cependant, la valeur par défaut de 3 min est définie bien plus longue que la somme de leurs valeurs par défaut.