wrapper.environment.dump.loglevel プロパティ
対応バージョン :3.5.36
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

Wrapper から見える全ての環境変数を、元の値と共に、ダンプすることが有用な場合があります。 このプロパティは、このダンプをログ化するログレベルを制限します。 デフォルト値は「DEBUG」で、デバッグ出力に含まれます。

予想外の環境が原因で起こる問題が圧倒的です。 このプロパティは、とても有力な機能であり、そのような問題の要因を突き詰めて見つけ出すのに役立ちます。

Windows XP、あるいは Windows Server 2003 上でサービスとして動作するとき、Wrapper は、最初の開始時に、 レジストリに保存されている宣言されたシステム全体の環境変数の全てを読み込みます。 もし「USERNAME」（ユーザー名）環境変数が定義されている場合、 Wrapper は同様にレジストリから、そのユーザー用に環境を読み込みます。 これは、システムリブートを必要とせず、設定された環境の変更を可能にするために、そうしています。

本来、このレジストリのリロード（再読み込み）はすべての Windows バージョンで行われていました。 Wrapper バージョン 3.5.5 より、Windows XP や Server 2003 以降のバージョンで無効にしました。 Wrapper バージョン 3.5.16で、 リロード（再読み込み）は Windows XP と Server 2003 で有効にしましたが、それより最新のバージョンでは必要がないため、そのまま無効にしています。

UNIX 上では、システムスタートアップで起動する時に、Wrapper がほとんど空の環境であるのが一般的です。

設定例： 
wrapper.environment.dump.loglevel=INFO

デバッグ出力は、環境が設定された場所を示すソース列で始まります。 値は、左から右へ、設定できるところからソースの順番を示し、最後の値が利用されます。

  • [P] - ペアレント（親）プロセスで定義されます。例： Wrapper 起動時に変数が設定されました。
  • [S] - システム全体レジストリで定義されます。（Windows XP と Server 2003 以前のバージョンのみ）
  • [A] - アカウント特定のレジストリで定義されます。（Windows XP と Server 2003 以前のバージョンのみ）
  • [W] - スタートアップ時に Wrapper によって定義されます。
  • [C] - Wrapper コンフィギュレーションファイル内部で定義されます。

次の例は、特定のユーザーとして Windows 上で動作するときの環境出力です。 いくつかの変数はシステムによって設定され、 その他の変数は、Wrapper や Wrapper コンフィギュレーションによって設定され、 システムユーザーや設定されたアカウント用に両方のレジストリから読み込まれています。

環境出力例： 
wrapper  | 環境変数（ソース｜名前＝値）開始：
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  | 環境変数:終了

注意

Wrapper バージョン 3.5.36 より、wrapper.restart.reload_configuration が『TRUE』に設定されている場合、環境変数のダンプはコンフィギュレーションがリロード（再読み込み）される度に発生します。 以前では、それは起動時のみに起きていました。

wrapper.environment.dump プロパティ
対応バージョン :3.5.0
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

警告

Wrapper バージョン 3.5.36 でこのプロパティの使用は非推奨にされ、その代わりに［wrapper.environment.dump.loglevel］プロパティが推奨されています。