wrapper.event.<event_name>.command.on_exit.<n>

Compatibilité :3.3.0
Éditions :Édition ProfessionnelleÉdition Standard (non prise en charge)Édition Community (non prise en charge)
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Cette propriété contrôle ce que le Wrapper fera en réponse à des codes de sortie spécifiques des commandes d'événements. Elle permet de réagir de différentes manières selon que la commande a rencontré des problèmes ou non.

Comme plusieurs des propriétés de commandes d'événements, elle peut être définie :

  • Globalement pour tous les événements : propriété wrapper.event.default.command.on_exit.<n>, ou
  • Pour un événement spécifique : propriété wrapper.event.<event_name>.command.on_exit.<n>.

Le composant « <event_name> » du nom de la propriété peut être soit le mot-clé « default », soit l'un des types d'événements. En définissant la propriété par défaut, tous les types d'événements qui ne sont pas définis explicitement prendront cette valeur. Le composant « <n> » du nom de la propriété est un code de sortie.

L'action peut être l'une des suivantes :

  • SHUTDOWN - procédera à l'arrêt du Wrapper.

  • CONTINUE ou IGNORE - indiquera au Wrapper de poursuivre le fonctionnement normal.

  • USER_<n> (depuis 3.7.0, Professional Edition) - déclenchera un événement utilisateur et poursuivra. Le composant « <n> » est un entier quelconque dans la plage 1-32767.

La valeur par défaut est CONTINUE.

Exemple :
wrapper.event.jvm_prelaunch.command.block=TRUE
wrapper.event.jvm_prelaunch.command.on_exit.0=CONTINUE

NOTE

Si le Wrapper n'est pas configuré pour bloquer en attendant la fin de la commande, alors cette propriété sera ignorée et le Wrapper continuera toujours.

Exemple :

L'exemple suivant exécutera un script de nettoyage immédiatement avant le lancement de toute instance JVM. Il attendra jusqu'à 30 secondes que le script se termine. Ensuite, si le script se termine avec un code de sortie de « 0 » (zéro), le Wrapper continuera. Tout autre code de sortie sera traité comme une erreur et le Wrapper s'arrêtera sans lancer la JVM.

Exemple :
wrapper.event.jvm_prelaunch.command.argv.1=/usr/bin/mycleanup
wrapper.event.jvm_prelaunch.command.argv.2=parameter1
wrapper.event.jvm_prelaunch.command.block=TRUE
wrapper.event.jvm_prelaunch.command.block.timeout=30
wrapper.event.jvm_prelaunch.command.on_exit.default=SHUTDOWN
wrapper.event.jvm_prelaunch.command.on_exit.0=CONTINUE

Ordre de recherche :

Lors de la définition de cette propriété, il est possible de définir une action par défaut, non seulement pour le code de sortie, mais aussi pour le type d'événement. Lors de la recherche d'une action pour un code de sortie et un événement donnés, le Wrapper recherchera dans l'ordre suivant :

  • wrapper.event.<event_name>.command.on_exit.<n>,
  • wrapper.event.<event_name>.command.on_exit.default,
  • wrapper.event.default.command.on_exit.<n>, puis
  • wrapper.event.default.command.on_exit.default.

Référence : Commandes d'événements

Le Java Service Wrapper fournit un ensemble complet de propriétés de configuration qui vous permettent d'adapter le Wrapper à vos besoins exacts. Veuillez consulter la documentation des propriétés individuelles pour découvrir toutes les possibilités au-delà des exemples présentés ci-dessus.