Le Wrapper est très flexible et peut être configuré pour fonctionner avec n'importe quelle structure de répertoires. Pour cet exemple, nous suggérons une structure de répertoires claire, réutilisable même pour des applications assez complexes. Veuillez recréer la structure de répertoires suivante sous un répertoire de votre choix. Nous appellerons ce répertoire racine $(EXAMPLE_HOME). Il s'agit d'une extension de la structure de répertoires décrite dans la présentation de HelloWorldServer.

$(EXAMPLE_HOME)/
$(EXAMPLE_HOME)/bin/
$(EXAMPLE_HOME)/conf/
$(EXAMPLE_HOME)/lang/
$(EXAMPLE_HOME)/lib/
$(EXAMPLE_HOME)/lib/classes/
$(EXAMPLE_HOME)/logs/

Veuillez télécharger la dernière version du Java Service Wrapper pour votre OS depuis la page Téléchargement, et extraire l'archive dans un répertoire de votre choix. Nous appellerons le répertoire extrait $(WRAPPER_HOME).

Le Java Service Wrapper sous UNIX se compose de quatre composants principaux : le binaire Wrapper, un fichier jar, une bibliothèque native utilisée par le fichier jar, et un script shell utilisé pour lancer le Wrapper et effectuer des actions telles que le contrôler en tant que démon. Veuillez copier ces fichiers comme suit :

cp $(WRAPPER_HOME)/bin/wrapper $(EXAMPLE_HOME)/bin/wrapper
cp $(WRAPPER_HOME)/lib/wrapper.jar $(EXAMPLE_HOME)/lib/wrapper.jar
cp $(WRAPPER_HOME)/lib/libwrapper.so $(EXAMPLE_HOME)/lib/libwrapper.so
cp $(WRAPPER_HOME)/src/bin/App.sh.in $(EXAMPLE_HOME)/bin/helloworldserver

Ensuite, vous devez rendre le fichier de script exécutable :

chmod +x helloworldserver

Clé de licence :

Les éditions Standard et Professional du Java Service Wrapper nécessitent une clé de licence pour pouvoir s'exécuter. Le Wrapper est livré avec une clé de licence simple qui vous permettra d'exécuter le Wrapper pendant 15 minutes. Veuillez la copier pour le moment. Vous pouvez obtenir une licence d'essai longue durée en cliquant sur le bouton Essai gratuit en haut de la page.

cp $(WRAPPER_HOME)/src/conf/wrapper-license-time.conf $(EXAMPLE_HOME)/conf/wrapper-license.conf

Fichier de configuration du Wrapper :

Enfin, copiez le fichier de configuration par défaut du Wrapper. Nous l'éditerons dans la section suivante.

cp $(WRAPPER_HOME)/src/conf/wrapper.conf.in $(EXAMPLE_HOME)/conf/wrapper.conf

Ouvrez le fichier $(EXAMPLE_HOME)/conf/wrapper.conf dans l'éditeur de texte de votre choix.

Veuillez localiser et modifier les propriétés suivantes.

wrapper.java.command=java
wrapper.java.command.loglevel=INFO

wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperSimpleApp
wrapper.app.parameter.1=HelloWorldServer

wrapper.java.classpath.1=../lib/wrapper.jar
wrapper.java.classpath.2=../lib/classes

wrapper.java.library.path.1=../lib

wrapper.logfile=../logs/wrapper.log

• La propriété wrapper.java.command est utilisée pour spécifier l'emplacement de la commande Java qui sera utilisée. La valeur que nous avons spécifiée sera recherchée dans le chemin système. Il est également possible de spécifier un chemin absolu.

• La propriété wrapper.java.command.loglevel est facultative, mais elle est utile pour déboguer la ligne de commande Java générée par le Wrapper. Nous recommandons de l'inclure au début, mais elle peut être commentée une fois que votre application fonctionne.

• La propriété wrapper.java.mainclass est utilisée pour spécifier la classe principale transmise à Java lors de son lancement. C'est un point de confusion pour les nouveaux utilisateurs, mais dans la plupart des cas, il s'agira d'une des classes d'aide du Wrapper plutôt que de la classe principale de votre application. Le Wrapper prend en charge plusieurs méthodes d'intégration, mais pour cet exemple, nous utilisons la méthode la plus simple appelée Méthode d'intégration n°1 (WrapperSimpleApp).
  Cette méthode utilise la classe d'aide org.tanukisoftware.wrapper.WrapperSimpleApp pour gérer le cycle de vie de la JVM et la communication avec le Wrapper. Pour l'instant, ne vous préoccupez pas de ce point.

• La classe principale réelle de notre application HelloWorldServer est transmise comme premier paramètre à l'aide de la propriété wrapper.app.parameter.1. Il est possible de transmettre des paramètres supplémentaires à HelloWorldServer en ajoutant des propriétés supplémentaires avec des index croissants, par exemple wrapper.app.parameter.2=P1.

  Nous ne les montrons pas ici, mais il est également possible d'ajouter des paramètres Java supplémentaires à l'aide des propriétés wrapper.java.additional.<n>.

• L'étape suivante consiste à spécifier le classpath. Cela se fait à l'aide des propriétés wrapper.java.classpath.<n>. Nous avons besoin de deux entrées de classpath pour notre application. La première consiste à inclure le fichier wrapper.jar requis, qui contient les classes d'aide du Wrapper. La seconde inclut le répertoire lib/classes où se trouve notre classe HelloWorldServer.

• Le Wrapper utilise une bibliothèque native, libwrapper.so, pour implémenter certaines de ses fonctionnalités. Les bibliothèques natives ne sont pas utilisées par de nombreuses applications Java, vous ne les avez donc peut-être jamais rencontrées. Les propriétés wrapper.java.library.path.<n> sont utilisées pour spécifier l'emplacement de ces bibliothèques. Pour l'instant, ne vous préoccupez pas de ce point.

• La propriété wrapper.logfile est utilisée pour indiquer au Wrapper où écrire son fichier journal.

Nous avons maintenant indiqué au Wrapper comment exécuter notre application Java.

Un point important à noter concernant toutes les valeurs de propriétés est qu'elles sont toujours spécifiées avec des valeurs de chemin qui sont relatives à l'emplacement du binaire Wrapper.

Ouvrez le fichier de script shell $(EXAMPLE_HOME)/bin/helloworldserver dans l'éditeur de texte de votre choix.

Quelque part près du début du fichier, vous verrez deux variables : APP_NAME et APP_LONG_NAME. Veuillez remplacer les valeurs par le nom de votre application.

# Application
APP_NAME="helloworldserver"
APP_LONG_NAME="Hello World Server"

Il existe quelques autres variables utiles pour configurer le Wrapper en tant que démon, mais nous les verrons un peu plus loin dans ce tutoriel.