Configuration depuis la ligne de commande

Le Wrapper permet de définir n'importe quelle propriété de configuration depuis la ligne de commande. Cela peut être utile dans les situations où les valeurs de configuration ne peuvent être définies qu'à l'exécution. Un exemple peut être consulté dans le script shell (sh) fourni avec le Wrapper.

Les propriétés de configuration peuvent être définies sur la ligne de commande en les incluant après le chargement du fichier de configuration lors du lancement du Wrapper. Chaque propriété se présente sous la forme « un nom de propriété = la valeur de la propriété ». La syntaxe est exactement la même que dans le fichier wrapper.conf.

Exemple :

Dans cet exemple, une application Java est lancée à l'aide du Wrapper avec la journalisation de débogage activée.

Windows NT/2000 : 
wrapper.exe -c ..\conf\wrapper.conf wrapper.java.command=java wrapper.debug=TRUE
Linux / Solaris : 
./wrapper ../conf/wrapper.conf wrapper.java.command=java wrapper.debug=TRUE

Priorité :

Les propriétés définies sur la ligne de commande ont la priorité sur les autres propriétés par défaut, et remplaceront toute valeur de propriété par défaut définie dans le fichier de configuration ou tout « fichier d'inclusion » (style en cascade).

Les propriétés peuvent être spécifiées depuis la ligne de commande lors de l'utilisation de n'importe quelle commande du Wrapper, y compris la commande -i, utilisée pour installer l'application en tant que service sur les systèmes Windows.

Lors de l'exécution du Wrapper et de sa JVM en tant qu'application console à l'aide de la commande -c, les propriétés spécifiées remplaceront toutes les valeurs du fichier wrapper.conf et seront utilisées lors du lancement de la JVM.

De même, la commande -i, qui est utilisée pour installer le Wrapper en tant que service, mémorisera les propriétés spécifiées et les utilisera ensuite lorsque le service sera réellement démarré. De même, les propriétés spécifiées seront utilisées pour remplacer les valeurs du fichier wrapper.conf lors de l'installation du service.

Toutes les autres commandes utiliseront les propriétés de la ligne de commande pour remplacer les valeurs du fichier de configuration. Celles-ci affecteront la journalisation ou la façon dont le service est référencé. Elles n'auront aucun effet sur la JVM en cours d'exécution. Il n'est pas possible, par exemple, de transmettre une valeur de propriété à un service lors de son démarrage avec la commande -t.

Espaces entre guillemets :

NOTE

Les propriétés spécifiées sur la ligne de commande ne peuvent pas contenir d'espaces non quotés. Si vous devez inclure des espaces dans la valeur de la propriété, incluez simplement l'ensemble de la paire « nom de propriété et valeur » entre guillemets :

Exemple (inclure des espaces non quotés) : 
wrapper.exe -c ..\conf\wrapper.conf "wrapper.java.command=C:\My App\jre\bin\java.exe"

Mise entre guillemets sous Windows :

NOTE

Lors de la mise entre guillemets des valeurs de chemin sous Windows, veuillez garder à l'esprit un problème lié à la façon dont Windows analyse les valeurs entre guillemets. Il traite tous les antislashs de la valeur entre guillemets normalement, SAUF un antislash final. Dans l'exemple suivant, vous verrez que l' antislash final échappe le guillemet lui-même, ce qui entraîne le passage d'arguments non intentionnels au Wrapper.

Exemple : 
wrapper.exe -c ..\conf\wrapper.conf "wrapper.working.dir=C:\" wrapper.debug=TRUE"

L'opération prévue consiste à appeler le Wrapper avec les arguments ( [-c], [..\conf\wrapper.conf], [wrapper.working.dir=C:\] et [wrapper.debug=TRUE]). Ce qui se passe réellement, cependant, c'est que le second guillemet est échappé, ce qui donne les 3 arguments suivants : [-c], [..\conf\wrapper.conf], [wrapper.working.dir=C:" wrapper.debug=TRUE].

La première solution consiste à ne jamais avoir d' antislash final. Cela n'est toutefois pas possible avec l'exemple « C:\ » ci-dessus. Une autre bonne solution que nous avons trouvée consiste à ajouter un point final après l'antislash. Cela donne un répertoire « C:\. », qui a la même signification que « C:\ » mais qui est analysé correctement par Windows.

Exemple : 
wrapper.exe -c ..\conf\wrapper.conf "wrapper.working.dir=C:\." wrapper.debug=TRUE"

Référence : Lancement de votre application avec le Wrapper

[Windows]

[Linux / Unix]

[Commun]