Compatibilité :	3.5.0
Éditions :
Plateformes :

Cette propriété définit le comportement du Wrapper en cas d'erreur générale. À l'exception de l'erreur de pré-mappage (voir ci-dessous).

L'utilisateur peut spécifier que le Wrapper doit :

• SHUTDOWN : s'arrêter si le lecteur réseau n'a pas pu être monté
• BACKGROUND (depuis la ver. 3.5.52) : poursuivre son processus et démarrer la JVM, tout en continuant d'essayer de monter en arrière-plan
• ou CONTINUE : poursuivre son processus et démarrer la JVM, mais cesser d'essayer de monter.

La valeur par défaut est BACKGROUND.

wrapper.share.1.startup.failure=CONTINUE

Compatibilité :	3.5.0
Éditions :
Plateformes :

Cette propriété spécifie ce que le Wrapper fera si un partage n'a pas pu être monté parce que la ressource réseau existait déjà.

Veuillez noter que le comportement du Wrapper pour cette erreur n'est pas couvert par les propriétés wrapper.share.<n>.startup.failure. Cela a été fait exprès afin de permettre d'exécuter le Wrapper en tant que console et en tant que service avec le même fichier de configuration.

Depuis la version 3.5.52, si la cible sur la machine locale existe déjà et est mappée vers le même emplacement que celui spécifié avec wrapper.share.<n>.location, le Wrapper considérera le montage comme effectué et continuera, quelle que soit la valeur de wrapper.share.<n>.startup.premapped.

À l'inverse, si la cible est la même, mais que l'emplacement réseau est différent, il y a de fortes chances que le partage ait été mappé vers une ressource réseau différente (sauf si l'emplacement utilisait un alias). Dans de tels cas, il est généralement plus sage de s'arrêter, car cela pourrait conduire à des situations où l'application pourrait lire ou écrire à un mauvais emplacement. Parallèlement à ce changement, il a donc été décidé de modifier la valeur par défaut en SHUTDOWN.

L'utilisateur peut spécifier que le Wrapper doit :

• SHUTDOWN : s'arrêter si le lecteur réseau existe déjà
• ou CONTINUE : poursuivre son processus et démarrer la JVM.

La valeur par défaut est SHUTDOWN.

wrapper.share.1.startup.premapped=CONTINUE

Compatibilité :	3.5.0
Éditions :
Plateformes :

Cette propriété définit le nombre de fois que le Wrapper doit essayer de monter un lecteur réseau si une erreur liée au réseau s'est produite.

Si le Wrapper n'a pas pu monter le lecteur réseau après le nombre maximal de tentatives, la propriété wrapper.share.<n>.startup.failure spécifiera comment le Wrapper procédera.

La valeur par défaut est « 5 fois ». Le Wrapper essaiera 5 fois de monter un lecteur réseau avant d'abandonner.

wrapper.share.1.startup.max_retries=5

Compatibilité :	3.5.0
Éditions :
Plateformes :

Cette propriété spécifie l'intervalle en secondes que le Wrapper attendra avant de réessayer de monter un lecteur réseau.

La valeur par défaut est « 10 secondes ». Le Wrapper attendra 10 secondes avant de réessayer de monter.

wrapper.share.1.startup.retry_interval=10

Compatibilité :	3.5.52
Éditions :
Plateformes :

Cette propriété spécifie l'intervalle en secondes que le Wrapper attendra avant de réessayer de monter un lecteur réseau en arrière-plan après le démarrage. Il s'agit de l'intervalle pendant lequel le Wrapper continuera d'essayer même après le démarrage de l'application. Il continuera d'essayer jusqu'à ce que le mappage réussisse, ou qu'un échec permanent soit détecté.

Parfois, le serveur hébergeant le partage n'est pas accessible au démarrage du service. Continuer d'essayer de monter en arrière-plan peut être utile si le partage n'est pas critique pour l'application.

La valeur par défaut est « 60 secondes ». Le Wrapper attendra 60 secondes avant de réessayer de monter.

wrapper.share.1.background.retry_interval=60

Compatibilité :	3.5.52
Éditions :
Plateformes :

Cette propriété permet de spécifier une certaine action à effectuer chaque fois qu'un partage est monté avec succès après le démarrage de l'application.

Cela peut être utile pour déclencher un redémarrage de la JVM, par exemple, lorsque l'application a besoin de se réinitialiser maintenant que le partage est disponible.

L'action par défaut est spécifiée comme NONE pour ne rien faire.

wrapper.share.1.background.success.action=RESTART

La liste complète des actions peut être consultée sur cette page, mais les plus couramment utilisées sont les suivantes :

• DEBUG :

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

• RESTART :

  arrêtera la JVM actuelle, puis relancera une nouvelle invocation.

• USER_<n> (édition Professional) :

  provoquera le déclenchement d'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 à l'émission d'un trap SNMP.

• NONE :

  ne fera rien (aucune action supplémentaire une fois le partage monté avec succès).

Compatibilité :	3.5.52
Éditions :
Plateformes :

Cette propriété permet de spécifier une certaine action à effectuer chaque fois qu'un partage échoue à être monté de manière permanente après le démarrage de l'application. Cela inclut des identifiants ou des points de montage incorrects. Les problèmes temporaires, comme un échec de résolution du nom d'hôte ou de connexion au serveur, continueront d'être réessayés en arrière-plan.

Cette propriété contrôle ce qui se passe lorsqu'un échec survient en mode arrière-plan. À ce stade, l'application a déjà été démarrée malgré l'échec du mappage du partage pendant le démarrage. Il n'est donc généralement pas recommandé d'utiliser SHUTDOWN ou d'entreprendre une autre action fatale à ce moment-là. Cette propriété peut être utile pour exécuter des actions USER_<n> ou journaliser un message.

L'action par défaut est spécifiée comme NONE pour ne rien faire.

wrapper.share.1.background.failure.action=USER_1

La liste complète des actions peut être consultée sur cette page, mais les plus couramment utilisées sont les suivantes :

• DEBUG :

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

• SHUTDOWN :

  arrêtera la JVM ainsi que le Wrapper. Soyez prudent lors de l'utilisation de cette valeur, car un échec de montage d'un partage en arrière-plan peut se produire à tout moment alors que l'application est déjà en cours d'exécution. Si cela se produisait, cela entraînerait l'arrêt de votre application et du Wrapper.

• USER_<n> :

  provoquera le déclenchement d'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 à l'émission d'un trap SNMP.

• NONE :

  ne fera rien (l'échec ne sera suivi d'aucune action, et le Wrapper continuera).