• wrapper.java.statusfile propriété
• wrapper.java.statusfile.group propriété
• wrapper.java.statusfile.umask propriété

Compatibilité :	3.2.0
Éditions :
Plateformes :

Fichier dans lequel écrire l'état actuel de Java. Cette propriété n'est pas définie par défaut.

Cette propriété n'est d'aucune utilité pour la plupart des applications. Elle peut toutefois être utile aux applications externes qui ont besoin de surveiller l'état du processus Java.

Si cette propriété est définie, un fichier contenant le dernier état du processus Java sera écrit à l'emplacement spécifié chaque fois que l'état interne du processus Java change. Le fichier est créé au démarrage du processus Wrapper et est supprimé lorsque celui-ci s'est terminé.

wrapper.java.statusfile=./myapp.java.status

Indication d'état :

Le fichier est formaté comme un fichier texte d'une seule ligne contenant un unique jeton indiquant l'état actuel du processus Java.

Les valeurs possibles sont :

• DOWN_CLEAN :

  Le processus Java est complètement arrêté. C'est l'état au premier démarrage du Wrapper, ainsi qu' après confirmation que le processus Java a été terminé. L'état doit toujours revenir à DOWN_CLEAN avant que le Wrapper lui-même soit autorisé à poursuivre son propre arrêt.

• LAUNCH(DELAY) :

  Le Wrapper attend de lancer une nouvelle JVM. C'est l'état lorsque le Wrapper attend de lancer un nouveau processus JVM. Cela peut se produire au démarrage si la propriété wrapper.startup.delay est définie, ou lors d'un redémarrage si la propriété wrapper.restart.delay a une valeur supérieure à « 0 » (zéro). Si le Wrapper lui-même est dans un état où il est possible de lancer une JVM, alors l'état passera à LAUNCH pour le démarrage (première JVM), et à RESTART pour les redémarrages (deuxième JVM et suivantes). Sinon, l'état revient à DOWN_CLEAN.

• RESTART :

  Le Wrapper tente de redémarrer la JVM. Si le Wrapper lui-même est dans un état où il est possible de lancer une JVM, alors l'état passera à LAUNCH. Sinon, l'état revient à DOWN_CLEAN.

• LAUNCH :

  Le Wrapper est prêt à lancer une nouvelle JVM. L'état passera normalement à STARTING. S'il y a eu des erreurs immédiates lors du lancement du processus, l'état reviendra à DOWN_CLEAN.

• LAUNCHING :

  Le Wrapper est en train de lancer la JVM mais l'existence du nouveau processus Java n'a pas encore été confirmée. La durée pendant laquelle le Wrapper est autorisé à rester dans cet état est contrôlée par la propriété wrapper.startup.timeout. Normalement, l'état passera à LAUNCHED. En cas de délai d'attente dépassé, l'état passera à KILLING.

• LAUNCHED :

  Le Wrapper a confirmé que le processus Java a été lancé en localisant son processus. L'état passera toujours à STARTING.

• STARTING :

  Le processus Java a été lancé. Il restera dans cet état jusqu'à ce que la classe WrapperManager dans la JVM ait ouvert une socket back-end avec le Wrapper puis ait notifié au Wrapper que l'application Java de l'utilisateur a été démarrée, ou que la JVM commence à s'arrêter. La durée pendant laquelle le Wrapper est autorisé à rester dans cet état est contrôlée par la propriété wrapper.startup.timeout. Normalement, l'état passera à STARTED. En cas de délai d'attente dépassé, l'état passera à KILLING.

• STARTED :

  La classe WrapperManager dans la JVM a notifié au Wrapper que l'application est opérationnelle. Le processus restera dans cet état jusqu'à ce que la JVM commence à s'arrêter. Une fois dans cet état, le Wrapper enverra un ping à la classe WrapperManager à un intervalle contrôlé par la propriété wrapper.ping.interval. La classe WrapperManager doit répondre dans un délai contrôlé par la propriété wrapper.ping.timeout. Normalement, le Wrapper restera dans cet état jusqu'à ce qu'on lui demande d'arrêter la JVM, auquel cas l'état passe à STOP. En cas de délai d'attente de ping dépassé, l'état passera à KILLING.

• STOP :

  Le Wrapper a reçu une demande ou a décidé que la JVM doit être arrêtée. Une demande sera faite pour que la JVM s'arrête proprement. L'état passera ensuite à STOPPING.

• STOPPING :

  La JVM a commencé à arrêter son application interne. Elle restera dans cet état jusqu'à ce que la classe WrapperManager dans la JVM ait notifié au Wrapper que l'application est arrêtée. La durée pendant laquelle le Wrapper est autorisé à rester dans cet état est contrôlée par la propriété wrapper.shutdown.timeout. Normalement, l'état passera à STOPPED. En cas de délai d'attente dépassé, l'état passera à KILLING.

• STOPPED :

  La classe WrapperManager dans la JVM a notifié au Wrapper que l'application s'est arrêtée. Le processus restera dans cet état jusqu'à ce que le processus Java se termine réellement. La durée pendant laquelle le Wrapper est autorisé à rester dans cet état est contrôlée par la propriété wrapper.jvm_exit.timeout. Normalement, l'état passera à DOWN_CHECK. En cas de délai d'attente dépassé, l'état passera à KILLING.

• KILLING :

  Le Wrapper a décidé que le processus Java doit être tué de force. Si la propriété wrapper.request_thread_dump_on_failed_jvm_exit a été définie, le Wrapper doit attendre suffisamment longtemps pour que Java termine son dump avant d'être tué. Ce délai est configuré avec la propriété wrapper.request_thread_dump_on_failed_jvm_exit.delay. Une fois terminé, l'état passera à KILL.

• KILL :

  Le Wrapper est prêt à tuer de force le processus Java. Une fois la demande effectuée, l'état passera à KILLED.

• KILLED (Depuis la ver. 3.5.18) :

  Une demande pour tuer de force le processus Java a été envoyée, mais le Wrapper attend la confirmation que le processus Java a disparu. La durée pendant laquelle le Wrapper est autorisé à rester dans cet état est contrôlée par la propriété wrapper.jvm_terminate.timeout. Une fois confirmé que le processus Java a disparu, l'état passera à DOWN_CHECK.

• DOWN_CHECK :

  Le Wrapper a vérifié que le processus JVM n'existe plus. Cet état est utilisé pour nettoyer tout processus enfant orphelin lancé par la méthode WrapperManager.exec dans l'édition Professional. Une fois que tout a été nettoyé, l'état passera à DOWN_FLUSH.

• DOWN_FLUSH :

  Le Wrapper a vérifié que le processus JVM n'existe plus, mais il peut encore y avoir des sorties non journalisées dans les tubes stdout et stderr du processus Java. Cet état est utilisé pour s'assurer que toutes les sorties de journal disponibles sont enregistrées avant de continuer. Une fois cela fait, l'état passera à DOWN_CLEAN.

Compatibilité :	3.5.38
Éditions :
Plateformes :

Vous pouvez définir « group » pour ce fichier. Voir la propriété wrapper.*.group.

wrapper.java.statusfile.group=jenkins

Compatibilité :	3.2.0
Éditions :
Plateformes :

Vous pouvez définir « umask » sur ce fichier. Voir la propriété wrapper.*.umask.

wrapper.java.statusfile.umask=0022

• wrapper.anchorfile (3.1.1)

  Définit le chemin d'un fichier d'ancrage créé au démarrage.

• wrapper.java.pidfile (3.0.5)

  Définit le chemin d'un fichier où le PID du processus Java sera écrit.

• wrapper.java.idfile (3.2.0)

  Définit le chemin d'un fichier où l'ID Java actuel généré par le Wrapper sera écrit.

• wrapper.java.statusfile (3.2.0)

  Définit le chemin d'un fichier où l'état actuel de la JVM sera écrit.

• wrapper.pidfile (Usage changed in 3.0.5)

  Définit le chemin d'un fichier où le PID du processus Wrapper sera écrit.

• wrapper.lockfile (3.2.0)

  Configure un fichier de verrouillage contenant l'identifiant de processus du Wrapper.

• wrapper.statusfile (3.2.0)

  Définit le chemin d'un fichier où l'état actuel du Wrapper sera écrit.

• wrapper.*.group (3.5.38)

  Spécifie le groupe à attribuer lors de la création de certains fichiers.

• wrapper.*.umask (3.2.0)

  Spécifie les permissions de certains fichiers créés par le Wrapper.