• 環境変数の展開
• 環境変数の定義
  • "set[.<platform>].<X>"
  • "set[.<platform>].default.<X>"
• デフォルト環境変数の定義
  • ［WRAPPER_ARCH］変数
  • ［WRAPPER_BASE_NAME］変数
  • ［WRAPPER_BIN_DIR］変数
  • ［WRAPPER_BITS］変数
  • ［WRAPPER_CONF_DIR］変数
  • ［WRAPPER_EDITION］変数
  • ［WRAPPER_FILE_SEPARATOR］変数
  • ［WRAPPER_HOSTNAME］変数
  • ［WRAPPER_INIT_DIR］変数
  • ［WRAPPER_JAVA_HOME］変数
  • ［WRAPPER_JAVA_VENDOR］変数
  • ［WRAPPER_JAVA_VERSION］変数
  • ［WRAPPER_JAVA_VERSION_MAJOR］変数
  • ［WRAPPER_JAVA_VERSION_MINOR］変数
  • ［WRAPPER_JAVA_VERSION_REVISION］変数
  • ［WRAPPER_LANG］変数
  • ［WRAPPER_OS］変数
  • ［WRAPPER_OS_FAMILY］変数
  • ［WRAPPER_PATH_SEPARATOR］変数
  • ［WRAPPER_PID］変数
  • ［WRAPPER_RUN_MODE］変数
  • ［WRAPPER_VERSION］変数
  • ［WRAPPER_WORKING_DIR］変数
• 擬似環境変数の定義
  • ［WRAPPER_PERCENTAGE］変数
  • ［WRAPPER_RAND_NNNNNN］変数
  • ［WRAPPER_SYSMEM_PP.P］変数
  • ［WRAPPER_TIME_YYYYMMDDHHIISS］変数
• イベントハンドラ変数の定義
  • ［WRAPPER_NAME］変数
  • ［WRAPPER_DISPLAYNAME］変数
  • ［WRAPPER_DESCRIPTION］変数
  • ［WRAPPER_EVENT_JVM_ID］変数
  • ［WRAPPER_EVENT_JVM_PID］変数
  • ［WRAPPER_EVENT_NAME］変数
  • ［WRAPPER_EVENT_RAND_NNNNNN］変数
  • ［WRAPPER_EVENT_TIME_YYYYMMDDHHIISS］変数
  • ［WRAPPER_EVENT_WRAPPER_PID］変数
• 機密データのマスキング

Wrapper は、いかなるプロパティ値でもランタイム時に、環境変数の展開をサポートしています。 コンフィギュレーションファイル 「wrapper.conf」の本質を活かし、 プラットフォームに依存しない独立型を意識して整備しておけば、 Windows のシンタックス（構造文法ルール）は、全てのプラットフォームに利用することができます。

Wrapper がサービスとして動かされる時、環境からではなく、 システムレジストリから環境変数がロード（読み込み）されます。 これは、Windows がマシンを起動するときに、サービスが利用する環境変数をロード（読み込み）するために必要です。 レジストリにあるシステム環境変数が変更（直に設定の変更やコントロールパネルを通しての変更）された場合、 マシンを再起動するまでサービスへ有効になりませんが、 レジストリから環境変数をロード（読み込み）することで、同じ機能を提供している間は、 再起動の必要性を避けることができます。

wrapper.java.command=%JAVA_HOME%/bin/java

これは、［JAVA_HOME］環境変数を定義する、 いかなるシステム上においても、完全に適切なパスへ、ランタイムで展開します。

wrapper.java.command=C:\Sun\jdk1.3\bin\java

wrapper.java.command=/opt/IBMJava2-131/bin/java

Wrapper は、コンフィギュレーションファイル 「wrapper.conf」 内部から、あるいは、 コマンドラインから、環境変数を定義する機能を備えています。 一旦、定義されれば、その環境変数は他の環境変数と同様に参照が可能です。 これは、上記で述べている変数の展開での利用も含みます。

set.EXTERN_APP=C:/ExternAppHome

set.default.EXTERN_APP=C:/ExternAppHome

set.EXTERN_APP=C:/ExternAppHome

wrapper.java.classpath.1=../lib/wrapper.jar
wrapper.java.classpath.2=%EXTERN_APP%/lib/jar1.jar
wrapper.java.classpath.3=%EXTERN_APP%/lib/jar2.jar
wrapper.java.classpath.4=%EXTERN_APP%/lib/ext/jar3.jar
wrapper.java.classpath.5=%EXTERN_APP%/lib/ext/jar4.jar

set.windows.APP_HOME=C:\Program Files\MyApp

set.unix.APP_HOME=/opt/myapp

# default value for all systems
set.default.MAX_MEMORY=512M

# default values specifically for Linux and freeBSD
set.linux.default.MAX_MEMORY=1024M
set.freebsd.default.MAX_MEMORY=1024M

wrapper.exe -c ..\conf\wrapper.conf "set.EXTERN_APP=C:\Program Files\ExternAppHome"

wrapper ../conf/wrapper.conf set.EXTERN_APP=/usr/lib/externapphome

set.PATH=my_path%WRAPPER_PATH_SEPARATOR%%PATH%.

set.default.MYPATH=my_path%WRAPPER_PATH_SEPARATOR%%PATH%.
set.PATH=%MYPATH%

Wrapper 起動時に、次の環境変数を設定します。 これらの変数は、コンフィギュレーションファイル 「wrapper.conf」 内部で使われたり、JVM の環境へアクセス、あるいは、その子プロセスへアクセスしたりして使われます。

• [WRAPPER_ARCH] 変数は、 現在動作中の Wrapper がビルドされた構造名に設定されます。 （Wrapper ver. 3.3.0 から）

• [WRAPPER_BASE_NAME] 変数は、 拡張子を除いたバイナリーファイル名に設定されます。 もし、ファイル名に OS、アーキテクチャー、ビット数が含まれている場合、そちらも環境変数空除かれます。 （Wrapper ver. 3.5.41 から）

• [WRAPPER_BIN_DIR] 変数は、 スタートアップ時の Wrapper バイナリの配置場所に設定されます。 たとえカレント（現在の）作業ディレクトリーが変更されていたとしても、それとは関係なく、 その場所への相対パスを定義するために使われます。 （Wrapper ver. 3.3.0 から）

• [WRAPPER_BITS] 変数は、 現在動作中の Wrapper がビルドされた、32 ビットや 64 ビットの深さに設定されます。 （Wrapper ver. 3.3.0 から）

• [WRAPPER_CONF_DIR] 変数は、 スタートアップ時の Wrapper コンフィギュレーションファイルの配置場所に設定されます。 たとえカレント（現在の）作業ディレクトリーが変更されていたとしても、それとは関係なく、 その場所への相対パスを定義するために使われます。 （Wrapper ver. 3.5.8 から）

• [WRAPPER_EDITION] 変数は、 現在動作中の Wrapper のエディションに設定されます。 有効な値は、「Community」、「Standard」と「Professional」です。 （Wrapper ver. 3.5.36 から）

• [WRAPPER_FILE_SEPARATOR] 変数は、 ファイルセパレーターとして、Windows 上で「\」、 Linux/UNIX プラットフォーム上で「/」に設定されます。 その変数は、追加の環境変数やプロパティのために、 プラットフォームに依存しない独立型の値を設定するために利用されます。 （Wrapper ver. 3.1.0 から）

  一般的に、安全をみて、 Java 内部で使われるパスのファイルセパレーターとして、 常に「/（スラッシュ）」を使うことをお薦めします。 Java では、「/」 を使えば、全てのプラットフォーム上で正しく動くように設計されています。

• [WRAPPER_HOSTNAME] 変数と [WRAPPER_HOST_NAME] 変数は、 Wrapper が現在動作しているマシンの解決した名前に設定されます。 （WRAPPER_HOST_NAME： Wrapper ver. 3.3.2 からで、 WRAPPER_HOSTNAME： Wrapper ver. 3.3.6 から）

• [WRAPPER_INIT_DIR] 変数は、 Wrapper プロセスを起動するプロセスの作業ディレクトリーに設定されます。 Wrapper は常に最初に、コンフィギュレーションファイルの読み込み中、 作業ディレクトリーを Wrapper バイナリがある場所に強制設定します。 （参照： WRAPPER_BIN_DIR 変数） その後、もしユーザーが他の作業ディレクトリーを設定していた場合、 ［wrapper.working.dir］ プロパティで指定された場所へ変更されます。 これは、どこから Wrapper が起動されたかに関わらず、 与えられたコンフィギュレーションを１００％信頼して、 確実に Wrapper が動作することを実現させるために必要です。 一部のアプリケーションでは、Wrapper を起動する時、ユーザーがどこに居るのか知る必要があります。 そのようなケースで、この変数が利用されます。 （Wrapper ver. 3.5.6 から）

  コンフィギュレーションファイルの設定例：

  wrapper.java.additional.1=-myinit.working.dir=%WRAPPER_INIT_DIR%

• [WRAPPER_JAVA_HOME] 変数は、 システムレジストリを使って Java コマンドが配置される時、Windows プラットフォーム上で、設定されます。 その他のケースでは、［JAVA_HOME］変数を設定することをお薦めします。 （Wrapper ver. 3.3.0 から）

• [WRAPPER_JAVA_VENDOR] 変数は、 コンフィギュレーションがロード（読込み）され、JVM に「java -version」コマンドの出力が解釈された後に設定されます。 この値は、現在使用されている Java ベンダーを表す文字列です。 （Wrapper ver. 3.5.37 から）

  この変数は、Java バージョンが解析された後にロードされる任意のプロパティ値で使用できます。 それは、イベントプロパティ、wrapper.java.additional_file と wrapper.app.parameter_file を含みます。

• [WRAPPER_JAVA_VERSION] 変数は、 コンフィギュレーションがロード（読込み）され、JVM に「java -version」コマンドの出力が解釈された後に設定されます。 この値は、現在使用されている Java バージョンを表す文字列です。 （Wrapper ver. 3.5.36 から）

  この変数は、Java バージョンが解析された後にロードされる任意のプロパティ値で使用できます。 それは、イベントプロパティ、wrapper.java.additional_file と wrapper.app.parameter_file を含みます。

• [WRAPPER_JAVA_VERSION_MAJOR] 、 [WRAPPER_JAVA_VERSION_MINOR] と [WRAPPER_JAVA_VERSION_REVISION] 変数は、 コンフィギュレーションがロード（読込み）され、JVM に「java -version」コマンドの出力が解釈された後に設定されます。 現在使用されている Java バージョンの「major」、「minor」と「revision」番号を含みます。 （Wrapper ver. 3.5.36 から）

  この変数は、Java バージョンが解析された後にロードされる任意のプロパティ値で利用できます。 それは、イベントプロパティ、wrapper.java.additional_file と wrapper.app.parameter_file を含みます。

• [WRAPPER_LANG] 変数は、 Wrapper で利用する言語を表す小文字を 2 文字のコードに設定されます。 コミュニティー版では、その値は常に「en」です。 その言語用に、値をローカライズした コンフィギュレーションファイル の一部として含めることができます。 （Wrapper ver. 3.5.5 から）

  次の例では、Windows サービス表示名や説明をローカライズする方法を示しています。 最初に、確実に英語が常にロード（読み込み）される（或いは最初に英語プロパティが定義される） ことに注目してください。 これは、英語の値がデフォルトとして存在することを明確にするためです。 その後、Wrapper は、その英語の値をローカライズされた インクルードファイル（カスケード形式）の値で上書きします。

  例（wrapper.conf）：

  @encoding=UTF-8 @include ../conf/wrapper-en.conf @include ../conf/wrapper-%WRAPPER_LANG%.conf ... wrapper.ntservice.name=myapp ...

  例（wrapper-ja.conf）：

  @encoding=UTF-8 wrapper.ntservice.displayname=My App Server wrapper.ntservice.description=すごいことができるアプリケーションサーバー

  例（wrapper-en.conf）：

  @encoding=UTF-8 wrapper.ntservice.displayname=My App Server wrapper.ntservice.description=Application Server that does cool stuff.

• [WRAPPER_OS] 変数は、 現在動作している Wrapper がビルドされた OS 名に設定されます。 （Wrapper ver. 3.3.0 から）

  コンフィギュレーションファイルの設定例：

  wrapper.java.library.path.1=../lib wrapper.java.library.path.2=../lib/native/%WRAPPER_OS%-%WRAPPER_ARCH%-%WRAPPER_BITS%

  上記の例では、以下のように解決されます：

  Windows の場合：

  wrapper.java.library.path.1=../lib wrapper.java.library.path.2=../lib/native/windows-x86-32

  Linux の場合：

  wrapper.java.library.path.1=../lib wrapper.java.library.path.2=../lib/native/linux-x86-32

  Solaris の場合：

  wrapper.java.library.path.1=../lib wrapper.java.library.path.2=../lib/native/solaris-sparc-32

• 「 [WRAPPER_OS_FAMILY] 」変数には、実行中の Wrapper がビルドされた OS ファミリーが設定されます。 （Wrapper ver. 3.7.0 以降）

  設定ファイルの例：

  @include ../conf/wrapper-%WRAPPER_OS_FAMILY%.conf

  上記の例は、以下のように解決されます。

  Windows：

  @include ../conf/wrapper-windows.conf

  Linux：

  @include ../conf/wrapper-unix.conf

  Solaris：

  @include ../conf/wrapper-unix.conf

• [WRAPPER_PATH_SEPARATOR] 変数は、 Windows 上で「;」、 Linux/UNIX プラットフォーム上で、「:」に設定されます。 この変数は、プラットフォームに依存しない独立型のパスをビルドするために使われます。 （Wrapper ver. 3.1.0 から）

  コンフィギュレーションファイルの設定例：

  set.PATH=..%WRAPPER_FILE_SEPARATOR%lib%WRAPPER_PATH_SEPARATOR%%PATH%

  上記の例では、以下のように解決されます：

  Windows の場合：

  set.PATH=..\lib;%PATH%

  UNIX の場合：

  set.PATH=../lib:%PATH%

• [WRAPPER_PID] 変数は、 起動時に、Wrapper プロセスの PID に設定されます。 同じコンフィギュレーションファイルを使って複数のアプリケーションを起動するときに、 固有のファイル名を取得していることを確認するために、 PID ファイルや ログファイルのようなファイル名の中で使われます。 （Wrapper ver. 3.3.7 から）

  コンフィギュレーションファイルの設定例：

  wrapper.logfile=../logs/wrapper-%WRAPPER_PID%.log

• [WRAPPER_RUN_MODE] 変数は、 コンソールとして作動するときに「console」に設定され、Windows サービスや Unix デーモンとして作動した場合は「service」に設定されます。 （Wrapper ver. 3.5.41 から）

• [WRAPPER_VERSION] 変数は、 現在作動されている Wrapper のバージョンに設定されます。 （Wrapper ver. 3.5.36 から）

• [WRAPPER_WORKING_DIR] 変数は、 スタートアップ時に Wrapper バイナリの配置場所に設定されますが、 子プロセスによって参照されるとき、 Wrapper のカレント作業ディレクトリーを反映して変更されます。 （Wrapper ver. 3.3.0 から）

  Wrapper の作業ディレクトリーは、 ［wrapper.working.dir］プロパティを使って変更することができます。 その使い方は少しヤヤコシイので必ず説明を読んでください。

  しかしながら、このプロパティが設定されるこの方法ゆえに、次の点に注目してください。 Wrapper コンフィギュレーションファイル内で参照されるとき、 それは常に［WRAPPER_BIN_DIR］変数と同等です。 この変数は、環境内部で正確に設定されますが、どの子プロセスも、 ［wrapper.working.dir］ プロパティで設定されたディレクトリーを参照します。

上記環境変数に加え、次の変数は Wrapper に作成されますが、環境に格納されません。

「WRAPPER_RAND_NNNNNN」と「WRAPPER_TIME_YYYYMMDDHHIISS」変数は、 コンフィギュレーションファイル内に数回参照することが出来て、各参照に異なる値を生成することが出来ます。 そのため、環境に格納されません。 「"set.<X>"」シンタックスを利用することで1つの参照に対して生成された値を 自分の環境変数に格納することはできますが、環境変数の値が変更される度、基礎となるシステム関数を呼び出すと、 わずかなメモリリークが発生します。 これらの変数の値は再生成され、毎回変更されるため、コンフィギュレーションファイルを複数回再ロードできる場合は、 これを考慮する必要があります。

set.RAND_NNNNNN=%WRAPPER_RAND_NNNNNN%

• 「WRAPPER_PERCENTAGE」変数は、一つの「%」文字に設定されます。 その利用は、プロパティ値に2つの「%」文字が含まれる場合の構文上のあいまいさを避けるために推奨されています。 その場合は、存在しない環境変数についての警告が報告されるでしょう （二つの「」の間のコンテンツは変数の名前として考えられている） （Wrapper ver. 3.3.38 から）

  例：（gc ログファイル名は 'gc_%t_%p.log' に正しく展開されます）

  wrapper.java.additional.1=-Xloggc:C:\logs\gc_%WRAPPER_PERCENTAGE%t_%WRAPPER_PERCENTAGE%p.log

• [WRAPPER_RAND_NNNNNN] 変数には、 Wrapper コンフィギュレーションファイル内部で使われる各配置場所で、ランダムな数字が設定されます。 （Wrapper ver. 3.3.4 から）

  コンフィギュレーションファイルの設定例：

  wrapper.app.parameter.1=mytempfile-%WRAPPER_RAND_NNNNNN%.txt

  一旦、コンフィギュレーションファイルがロード（読み込み）されて、 その内容が取り込まれ解釈される時、この値が設定されます。 もし、JVM の起動毎に、この値が設定されるべきならば、 コンフィギュレーションファイルが、各 JVM の「起動の試み（invocation）」よりも前に再読み込みされるように、 ［wrapper.restart.reload_configuration=TRUE］ コンフィギュレーションプロパティを指定する必要があります。

  変数が指定されている、それぞれの場所で、異なるランダムな数字が１つ生成されます。 もし、複数の配置場所で、同じランダムな数字を参照することが必要ならば、 まず、ローカル変数の中に値を保存して、必要に応じて参照するようにしてください。 例：

  コンフィギュレーションファイルの設定例：

  set.RNUM=%WRAPPER_RAND_NNNNNN% wrapper.java.additional.1=-Dtempid=%RNUM% wrapper.app.parameter.1=mytempfile-%RNUM%.txt

  さらに、追加的な形式として、１桁から６桁のランダムな数字で存在します： ［WRAPPER_RAND_N］、 ［WRAPPER_RAND_NN］、 ［WRAPPER_RAND_NNN］、 ［WRAPPER_RAND_NNNN］、 ［WRAPPER_RAND_NNNNN］、 ［WRAPPER_RAND_NNNNNN］

• [WRAPPER_SYSMEM_PP.P] 変数は、 システム上で利用可能な物理メモリの量のパーセンテージから計算された値に設定されます。 （Wrapper ver. 3.5.29 から）

  「PP.P」は、システムメモリーのパーセンテージを参照します。値は、０より大きくて、 １００以内ではければなりません。その範囲外に設定されると、この変数は無視されます。 パーセンテージは、小数点以下を含むことができますが、計算された値は 次に近いメガバイトに四捨五入されます。

  この変数は、［wrapper.java.additional.<n>］プロパティで使用することで 次の JVM オプションを設定することが出来ます：

  • -Xms
  • -Xmx
  • -Xmn
  • -XX:PermSize or XX:MaxPermSize (Java<8)
  • -XX:MetaspaceSize or -XX:MaxMetaspaceSize (Java>=8)
  • ...

• [WRAPPER_TIME_YYYYMMDDHHIISS] 変数には、 Wrapper コンフィギュレーションファイル内部で使われる各配置場所で、タイムスタンプが設定されます。 返される時間は、コンフィギュレーションファイルがロード（読み込み）された時間です。 同じコンフィギュレーションファイルの中で、複数回の参照があったとき、 その変数は、その同じ値を返します。 （Wrapper ver. 3.3.4 から）

  下記の例では、 どのようにタイムスタンプを引用したファイル名を生成し、JVM へ引き渡す実例です：

  コンフィギュレーションファイルの設定例

  wrapper.app.parameter.1=mytempfile-%WRAPPER_TIME_YYYYMMDDHHIISS%.txt

  上記の例では、結果として、以下のような値になります：

  結果としての解釈内容：

  wrapper.app.parameter.1=mytempfile-20090409124532.txt

  一旦、コンフィギュレーションファイルがロード（読み込み）されて、その内容が取り込まれ解釈される時、 この値が設定されます。 もし、JVM の起動毎に、この値が設定されるべきならば、 コンフィギュレーションファイルが、各 JVM の「起動の試み（invocation）」よりも前に再読み込みされるように、 ［wrapper.restart.reload_configuration=TRUE］ コンフィギュレーションプロパティを指定することが必要です

  さらに、追加的な形式として、参照されるもの： ［WRAPPER_TIME_YYYYMMDD_HHIISS］、 ［WRAPPER_TIME_YYYYMMDDHHII］、 ［WRAPPER_TIME_YYYYMMDDHH］、 ［WRAPPER_TIME_YYYYMMDD］

上記の環境変数に加え、イベントプロパティの中で以下の変数も参照され、イベントが発生するときに使用されます。 これらの変数は、Wrapper コンフィギュレーションで使用され、環境に格納されませんので注意してください。

• [WRAPPER_NAME] 変数は、 ［wrapper.name］プロパティの値に設定されます。 （Wrapper ver. 3.3.0 から）

• [WRAPPER_DISPLAYNAME] 変数は、 ［wrapper.displayname］プロパティの値に設定されます。 （Wrapper ver. 3.3.0 から）

• [WRAPPER_DESCRIPTION] 変数は、 ［wrapper.description］プロパティの値に設定されます。 （Wrapper ver. 3.3.0 から）

• [WRAPPER_EVENT_JVM_ID] 変数は、 JVM が再起動した回数を示し、１で始まる１つのインテージャー値（整数値）に設定されます。 ［jvm_*］イベントのためだけに設定されます。 （Wrapper ver. 3.3.0 から）

• [WRAPPER_EVENT_JVM_PID] 変数は、 JVM プロセスの PID を含む１つのインテージャー値（整数値）に設定されます。 ［jvm_prelaunch］イベント以外の ［jvm_*］イベントのためだけに設定されます。 （Wrapper ver. 3.3.0 から）

• [WRAPPER_EVENT_NAME] 変数には、 発生したイベント名が設定されます。 （Wrapper ver. 3.3.0 から）

• [WRAPPER_EVENT_RAND_NNNNNN] 変数には、 イベントが発生する度にランダムな数字が設定されます。 （Wrapper ver. 3.5.25 から）

  設定例：

  wrapper.event.default.message=Event: %WRAPPER_EVENT_NAME% %WRAPPER_RAND_NNNNNN% %WRAPPER_EVENT_RAND_NNNNNN%

  上記の例では、２つのランダムな数字が生成されます。 最初の数字［WRAPPER_RAND_NNNNNN］は、Wrapper コンフィギュレーションファイルがロードされる都度に設定されます。 ２つ目［WRAPPER_EVENT_RAND_NNNNNN］は、イベント毎に変更されます。 ［WRAPPER_EVENT_RAND_NNNNNN］ の値は動的に解決されるため、再利用することが出来ません。

  さらに、追加的な形式として、１桁から６桁のランダムな数字で存在します： ［WRAPPER_EVENT_RAND_N］、 ［WRAPPER_EVENT_RAND_NN］、 ［WRAPPER_EVENT_RAND_NNN］、 ［WRAPPER_EVENT_RAND_NNNN］、 ［WRAPPER_EVENT_RAND_NNNNN］、 WRAPPER_EVENT_RAND_NNNNNN

• [WRAPPER_EVENT_TIME_YYYYMMDDHHIISS] 変数には、 イベントが発生する度にタイムスタンプが設定されます。 （Wrapper ver. 3.5.25 から）

  設定例：

  wrapper.event.default.message=Event: %WRAPPER_EVENT_NAME% %WRAPPER_TIME_YYYYMMDDHHIISS% %WRAPPER_EVENT_TIME_YYYYMMDDHHIISS%

  上記の例では、２つのタイムスタンプが参照されます。 ［WRAPPER_TIME_YYYYMMDDHHIISS］は、Wrapper コンフィギュレーションファイルがロードされる都度に設定され、 ［WRAPPER_EVENT_TIME_YYYYMMDDHHIISS］は、イベント毎に変更されます。 同じ時間がイベントの実行中に使用されますので、複数の時間参照を使用できます。

  さらに、追加的な形式として、参照されるもの： ［WRAPPER_EVENT_TIME_YYYYMMDD_HHIISS］、 ［WRAPPER_EVENT_TIME_YYYYMMDDHHII］、 ［WRAPPER_EVENT_TIME_YYYYMMDDHH］、 ［WRAPPER_EVENT_TIME_YYYYMMDD］

• [WRAPPER_EVENT_WRAPPER_PID] 変数は、 Wrapper プロセスの PID を含む１つのインテージャー値（整数値）に設定されます。 （この環境変数は、［WRAPPER_PID］環境変数のエイリアスであり、 互換性の都合上の理由のためだけに利用されています） （Wrapper ver. 3.3.0 から）

対応バージョン :	3.5.57
対応エディション :
対応プラットフォーム :

%...|mask%」を使用して ログ出力内のコンフィギュレーションファイルのテキストの一部をマスキングすることができます。 構文「%...|mask%」を使用して ログ出力内のコンフィギュレーションファイルのテキストの一部をマスキングすることができます。

この表記法を変数定義と混同しないでください。 変数と同じ「%」区切り文字を使用して、コンフィギュレーションファイルの処理時に展開されることを示すだけです。

ログ出力でマスキングされる機密テキストまたはデータは、開始区切り文字「%」と「|」文字の間に書き込む必要があります。 Wrapper または Java アプリケーションの内部使用の場合、この表記は区切り文字「%」と「|mask」部分を削除して機密データのみに拡張されます。 ログ出力では、機密データは「*」文字に置き換えられます。

この表記は、特に［wrapper.app.property.<n>］プロパティの値などでパスワードをマスキングする場合に役立ちます。

wrapper.app.property.1=mypassword=secretpassword
wrapper.app.property.2=mysecret=this is a %secret|mask%!

［wrapper.properties.dump.loglevel］を「INFO」に設定すると、上記のコンフィギュレーションで以下のログ出力が生成されます。

INFO   | wrapper  |   F |   | wrapper.app.property.1 | mypassword=**************
INFO   | wrapper  |   F |   | wrapper.app.property.2 | mysecret=this is a ******!