Compatibilité :	3.5.36
Éditions :
Plateformes :

Il est parfois utile de dumper toutes les variables d'environnement visibles par le Wrapper, ainsi que l'origine de leurs valeurs. Cette propriété contrôle le niveau de log auquel ce dump sera journalisé. La valeur par défaut est DEBUG, ce qui signifie qu'il sera inclus dans la sortie de débogage.

Il est assez fréquent que les utilisateurs rencontrent des problèmes lorsque leur environnement n'est pas celui attendu. Cette propriété peut s'avérer très efficace pour identifier la source de tels problèmes.

Lorsqu'il s'exécute en tant que service sous Windows XP ou Windows Server 2003, le Wrapper charge toutes les variables d'environnement système déclarées et stockées dans le registre lors du premier démarrage du Wrapper. Si la variable d'environnement USERNAME est définie, le Wrapper charge ensuite également l'environnement de cet utilisateur depuis le registre. Cela permet d'apporter des modifications à l'environnement configuré puis de les utiliser sans nécessiter de redémarrage du système.

À l'origine, ce rechargement des registres était effectué sur toutes les versions de Windows. Depuis la version 3.5.5 du Wrapper, cela a été désactivé pour Windows XP/Server 2003 et versions ultérieures. Dans la version 3.5.16 du Wrapper, le rechargement a été réactivé pour Windows XP et Server 2003, mais est resté désactivé pour les versions plus récentes de Windows où il n'est plus nécessaire.

Sous UNIX, il est courant que le Wrapper dispose d'un environnement quasi vide lorsqu'il est lancé au démarrage du système.

wrapper.environment.dump.loglevel=INFO

La sortie de débogage commence par une colonne source indiquant où la variable d'environnement a été définie. Les valeurs, de gauche à droite, indiquent l'ordre des sources à partir desquelles elles peuvent être définies. La valeur finale sera utilisée.

• P - Définie dans le processus parent, c'est-à-dire que la variable a été définie au lancement du Wrapper.
• S - Définie dans le registre système. (Uniquement pour les versions de Windows antérieures à XP/Server 2003)
• A - Définie dans le registre spécifique au compte. (Uniquement pour les versions de Windows antérieures à XP/Server 2003)
• W - Définie par le Wrapper au démarrage.
• C - Définie dans le fichier de configuration du Wrapper.

Voici un exemple de la sortie d'environnement lors d'une exécution sous Windows en tant qu'utilisateur spécifié. Notez que certaines variables sont configurées par le système, d'autres par le Wrapper ou la configuration du Wrapper, et d'autres encore sont chargées depuis le registre à la fois pour l'utilisateur SYSTEM et le compte configuré.

wrapper  | Environment variables (Source | Name=Value) BEGIN:
wrapper  |   P---- | ALLUSERSPROFILE=C:\Documents and Settings\All Users
wrapper  |   P---- | ANT_HOME=C:\Apache\apache-ant-1.7.1
wrapper  |   P---- | APPDATA=C:\Documents and Settings\me\Application Data
wrapper  |   P---- | CommonProgramFiles=C:\Program Files\Common Files
wrapper  |   P---- | CommonProgramFiles(x86)=C:\Program Files (x86)\Common Files
wrapper  |   P---- | COMPUTERNAME=MYPC
wrapper  |   P---- | ComSpec=C:\WINDOWS\system32\cmd.exe
wrapper  |   ----C | FOO=Bar
wrapper  |   P---- | FP_NO_HOST_CHECK=NO
wrapper  |   P---- | J2D_D3D=false
wrapper  |   P---C | JAVA_HOME=Foobar
wrapper  |   P---- | LOGONSERVER=\\MYPC
wrapper  |   P---- | NUMBER_OF_PROCESSORS=1
wrapper  |   P---- | OS=Windows_NT
wrapper  |   P---- | Path=C:\Sun\jdk1.6.0_10_x64\bin\;C:\Apache\apache-ant-1.7.1\bin\;C:\WINDOWS\system32; ...
wrapper  |   P---- | PATHEXT=.COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH;.RB;.RBW
wrapper  |   P---- | PROCESSOR_ARCHITECTURE=AMD64
wrapper  |   P---- | PROCESSOR_IDENTIFIER=EM64T Family 6 Model 23 Stepping 6, GenuineIntel
wrapper  |   P---- | PROCESSOR_LEVEL=6
wrapper  |   P---- | PROCESSOR_REVISION=1706
wrapper  |   P---- | ProgramFiles=C:\Program Files
wrapper  |   P---- | ProgramFiles(x86)=C:\Program Files (x86)
wrapper  |   P---- | SESSIONNAME=Console
wrapper  |   P---- | SystemDrive=C:
wrapper  |   P---- | SystemRoot=C:\WINDOWS
wrapper  |   P---- | TEMP=C:\Documents and Settings\me\Local Settings\Temp
wrapper  |   P---- | TMP=C:\Documents and Settings\me\Local Settings\Temp
wrapper  |   P---- | USERDOMAIN=MYPC
wrapper  |   P---- | USERNAME=me
wrapper  |   P---- | USERPROFILE=C:\Documents and Settings\me
wrapper  |   P---- | windir=C:\WINDOWS
wrapper  |   ---W- | WRAPPER_ARCH=x86
wrapper  |   ---W- | WRAPPER_BIN_DIR=C:\myapp\bin
wrapper  |   ---W- | WRAPPER_BITS=64
wrapper  |   ---W- | WRAPPER_FILE_SEPARATOR=\
wrapper  |   ---W- | WRAPPER_HOST_NAME=MYPC
wrapper  |   ---W- | WRAPPER_HOSTNAME=MYPC
wrapper  |   ---W- | WRAPPER_OS=windows
wrapper  |   ---W- | WRAPPER_PATH_SEPARATOR=;
wrapper  |   ---W- | WRAPPER_PID=504
wrapper  |   ---W- | WRAPPER_WORKING_DIR=C:\myapp\bin
wrapper  | Environment variables END: