• Propriété wrapper.ping.timeout
• Propriété wrapper.ping.timeout.action

Compatibilité :	1.0.0
Éditions :
Plateformes :

Nombre de secondes à autoriser entre deux réponses de ping provenant de la JVM.

La valeur par défaut est "30 secondes".

wrapper.ping.timeout=30

Définir la valeur de cette propriété à "0" (zéro) signifie ne jamais expirer. Le délai d'expiration du ping doit être au moins 5 secondes plus long que la valeur de wrapper.ping.interval. Le Wrapper modifiera la valeur à l'exécution si nécessaire pour éviter les problèmes.

En fonctionnement normal, le Wrapper envoie un ping à la JVM toutes les 5 secondes pour s'assurer que son processus n'est pas figé. Le délai d'expiration du ping est le temps accordé pour 2 réponses de la JVM avant que le Wrapper ne considère qu'elle est bloquée et ne la redémarre.

Cette propriété contrôle également le temps que la JVM autorisera à s'écouler sans recevoir de ping du Wrapper. Si le Wrapper n'envoie pas de ping à la JVM pendant une durée supérieure au délai spécifié, celle-ci se terminera, permettant au Wrapper de se resynchroniser en lançant une nouvelle JVM. Cela garantit également que la JVM se terminera si le processus Wrapper est arrêté de manière anormale. (En tuant le processus Wrapper dans le Gestionnaire des tâches Windows, ou en utilisant le signal "kill -9" sur les systèmes UNIX.)

À partir de la version 3.5.21 du Wrapper, l'édition Professional du Wrapper déclenchera également un événement jvm_ping_timeout chaque fois que ce seuil aura été dépassé.

Avec l'ajout de la propriété wrapper.cpu.timeout, il n'y a désormais presque aucune raison de modifier cette propriété. Les seules raisons pour lesquelles vous obtiendriez des délais d'expiration de ping sont si le système est sous une charge élevée ou si la JVM est réellement bloquée. Le délai d'expiration CPU devrait maintenant détecter tout problème lié au CPU.

Compatibilité :	3.5.16
Éditions :
Plateformes :

Cette propriété permet de spécifier une action particulière à effectuer chaque fois qu'un délai d'expiration de ping se produit après les secondes spécifiées dans la propriété wrapper.ping.timeout ci-dessus.

Par souci de cohérence et de rétrocompatibilité, l'action par défaut est spécifiée comme RESTART.

wrapper.ping.timeout.action=RESTART

Les actions possibles sont :

• DEBUG (Depuis la ver. 3.5.0) :

  entraînera l'enregistrement d'un message de débogage. Ceci n'est vraiment utile que pour aider à comprendre quand l'action est déclenchée.

• STATS (Depuis la ver. 3.5.52, Édition Standard / Professional) :

  affichera les statistiques de performances.

• DUMP (Depuis la ver. 3.3.6) :

  invoquera un dump de threads.

• GC (Depuis la ver. 3.5.7) :

  invoquera un cycle complet de ramasse-miettes (garbage collection) dans la JVM. Sachez que le faire fréquemment peut affecter les performances de la JVM, car un cycle complet gèlera souvent tous les threads pendant toute la durée du GC.

• RESTART :

  arrêtera la JVM actuelle puis redémarrera une nouvelle invocation.

• SHUTDOWN :

  arrêtera la JVM ainsi que le Wrapper.

• USER_<n> (Depuis la ver. 3.5.0, Édition Professional) :

  déclenchera un événement défini par l'utilisateur. Cela peut être soit l'envoi d'un e-mail, soit l'exécution d'une commande système externe. La commande peut aller de l'exécution d'opérations de nettoyage jusqu'à l'émission d'un trap SNMP.

• PAUSE (Depuis la ver. 3.5.0) :

  mettra en pause l'application Java si la pause est activée et que la JVM est en cours d'exécution. Consultez la propriété wrapper.pausable pour plus de détails.

• RESUME (Depuis la ver. 3.5.0) :

  reprendra l'application Java si elle est dans un état de pause. Cela peut être utilisé si la JVM n'est pas arrêtée lorsqu'elle est en pause. Consultez la propriété wrapper.pausable pour plus de détails.

• SUSPEND_TIMEOUTS_<n> (Depuis la ver. 3.5.40, Édition Standard / Professional) :

  Indique au Wrapper de suspendre tous les délais d'expiration utilisés lorsque la JVM ne répond pas. <n> spécifie le nombre de secondes pendant lesquelles suspendre les délais d'expiration, et doit être compris dans la plage 1-3600 (1 h). Cela peut être utilisé si l'application Java doit effectuer une longue tâche bloquante et éviter que le Wrapper ne considère l'application comme ne répondant pas.

  Les délais d'expiration peuvent également être suspendus via d'autres propriétés d'action, le fichier de commandes ou la méthode Java WrapperManager.suspendTimeouts().

  Si plusieurs demandes de suspension des délais d'expiration sont effectuées, le nombre de secondes spécifié par chaque demande ne sera pas additionné. Au lieu de cela, le temps nouvellement spécifié remplacera le temps de suspension restant s'il est plus long, et sera ignoré dans le cas contraire.

• RESUME_TIMEOUTS (Depuis la ver. 3.5.40, Édition Standard / Professional) :

  Indique au Wrapper de reprendre tous les délais d'expiration précédemment suspendus.

  Les délais d'expiration peuvent également être repris via d'autres propriétés d'action, le fichier de commandes ou la méthode Java WrapperManager.resumeTimeouts().

• SUCCESS (Depuis la ver. 3.5.5) :

  indiquera au Wrapper de réinitialiser son compteur interne d'invocations échouées et de compter l'invocation actuelle de la JVM comme « réussie ». Cela peut être utile dans les applications conçues pour redémarrer avec une fréquence assez élevée.

• NONE :

  est utile car elle empêchera tout déclencheur avec un numéro plus élevé d'être déclenché.

Enchaînement de plusieurs actions :

Il est possible de spécifier plus d'une action en les séparant par un espace ou une virgule. Lorsque plusieurs actions sont spécifiées, elles seront exécutées en succession rapide dans l'ordre spécifié.

L'exemple suivant tentera d'effectuer un dump de threads puis de redémarrer la JVM. Le dump de threads n'aura lieu que si la JVM n'est pas complètement figée.

wrapper.ping.timeout.action=DUMP,RESTART

• wrapper.ping.alert.loglevel (3.5.16)

  Contrôle le niveau de journalisation auquel les messages d'alerte de ping seront journalisés.

• wrapper.ping.alert.threshold (3.5.16)

  Affiche un avertissement chaque fois qu'une réponse de ping prend plus de temps que le nombre de secondes spécifié.

• wrapper.ping.interval (3.0.5)

  Configure le nombre de secondes entre deux requêtes de ping vers la JVM.

• wrapper.ping.interval.logged (3.2.4)

  Configure le nombre de secondes entre deux requêtes de ping qui doivent être journalisées.

• wrapper.ping.timeout (1.0.0)

  Configure le nombre de secondes autorisées entre deux réponses de ping provenant de la JVM.

• wrapper.ping.timeout.action (3.5.16)  ⇧

  Configure les actions à effectuer chaque fois que le délai d'attente du ping a expiré.

• wrapper.cpu.timeout (2.2.8)

  Configure le nombre de secondes sans CPU avant que la JVM n'envoie un avertissement et n'étende les délais d'attente.

• wrapper.max_hostid_timeout (3.4.0) ( Standard/Professionnel )

• wrapper.logfile.close.timeout (3.5.21)

  Contrôle le nombre de secondes au bout desquelles le fichier journal doit se fermer après la dernière entrée de journal.

• wrapper.logfile.flush.timeout (3.5.21)

  Configure l'intervalle en secondes auquel le Wrapper vide toutes les sorties vers le fichier journal.

• wrapper.logfile.inactivity.timeout (3.2.0, obsolète depuis 3.5.21)

  Contrôle le nombre de secondes au bout desquelles le fichier journal doit se fermer après la dernière entrée de journal.

• wrapper.ping.timeout (1.0.0)

  Configure le nombre de secondes autorisées entre deux réponses de ping provenant de la JVM.

• wrapper.startup_thread.timeout (3.5.11)

  Configure le nombre de secondes accordées pour que les opérations de démarrage asynchrones se terminent.

• wrapper.startup.timeout (1.0.0)

  Configure le nombre de secondes autorisées entre le moment où le Wrapper lance la JVM et le moment où la JVM répond que l'application a démarré.

• wrapper.shutdown.timeout (2.2.7)

  Configure le nombre de secondes autorisées entre le moment où le Wrapper demande à la JVM de s'arrêter et le moment où la JVM répond qu'elle est en train de s'arrêter.

• wrapper.jvm_exit.timeout (2.2.8)

  Configure le nombre de secondes autorisées entre le moment où la JVM signale qu'elle est arrêtée et le moment où le processus JVM se termine réellement.

• wrapper.jvm_cleanup.timeout (3.4.0)

  Configure le nombre de secondes accordées au Wrapper pour nettoyer les processus enfants après l'arrêt de la JVM.

• wrapper.jvm_terminate.timeout (3.5.18)

  Configure le nombre de secondes autorisées à partir du moment où le Wrapper demande au système de terminer de force la JVM jusqu'à ce qu'il confirme que le processus s'est réellement arrêté.

• wrapper.event.<event_name>.command.block.timeout (3.3.0) ( Professionnel )

  Configure la durée pendant laquelle le Wrapper attendra qu'un événement configuré se termine.

• wrapper.event.<event_name>.email.receive.timeout (3.3.2) ( Professionnel )
• wrapper.event.<event_name>.email.send.timeout (3.3.2) ( Professionnel )