この付録では、Oracle HTTP Serverで使用されるプロパティ・ファイルについて説明します。該当するファイルは次のとおりです。
ohs_admin.propertiesファイルは、Oracle HTTP Server管理サーバーのMBeansを構成するために使用されるドメイン・ファイルごとのファイルです。このファイルは手動で編集する必要があり、変更を有効にするために、管理サーバーを再起動する必要があります。
ファイル・パス: DOMAIN_HOME/config/fmwconfig/components/OHS/ohs_admin.properties
このファイルの編集可能なプロパティを次に示します。
プロパティ | 説明 |
---|---|
LogLevel |
OHSノード・マネージャ・プラグインのログ・レベル。 許容値:
デフォルト: INFO |
ohs_nm.propertiesファイルは、Oracle HTTP Serverのノード・マネージャのプラグインを構成するために使用されるドメイン・ファイルごとのファイルです。このファイルは手動で編集する必要があり、変更を有効にするためには、ノード・マネージャを再起動する必要があります。
ファイル・パス: DOMAIN_HOME/config/fmwconfig/components/OHS/ohs_nm.properties
プロパティ | 説明 |
---|---|
LogLevel |
OHSの必要性の低いプラグインのログ・レベル。 許容値:
デフォルト: INFO |
ohs.plugins.nodemanager.propertiesファイルは、構成済のOracle HTTP Serverごとに存在し、OHSプロセス管理用の構成済のパラメータを含んでいます。このファイルは手動で編集され、ランタイム領域に伝搬される必要があります。
ファイル・パス: DOMAIN_HOME/config/fmwconfig/components/OHS/ohs1/ohs.plugins.nodemanager.properties
次の表では、クロスプラットフォーム・プロパティについて説明します。
プロパティ | 説明 |
---|---|
|
初期Oracle HTTP Server構成ファイルのベースのファイル名。
注意: 指定した.confファイルには、デフォルトのhttpd.confと同じ方法でadmin.confが含まれている必要があります。 デフォルト: httpd.conf |
|
httpdの呼出しに追加される引数。
注意: これらは、通常の起動、停止および再起動のパラメータと競合することはできません。このプロパティには-Dと記号を使用できます。 デフォルト: なし |
|
Oracle HTTP Serverが起動および初期化するのを待機する最大時間(秒数)。
デフォルト: 120 |
|
Oracle HTTP Serverが終了するのを待機する最大時間(秒数)。
デフォルト: 60 |
|
Oracle HTTP Serverが再起動するのを待機する最大秒数。
デフォルト: 180 |
|
Oracle HTTP Serverへのノード・マネージャの1回のヘルス・チェックのpingの完了から次回の開始までの秒数。値を0にするとpingが無効になります。
デフォルト: 30 |
|
Oracle HTTP Serverのヘルス・チェックのpingが完了するのを待機する最大秒数。
デフォルト: 60 |
例:
config-file = httpd.conf command-line = -DSYMBOL start-timeout = 120 stop-timeout = 60 restart-timeout = 180 ping-interval = 30 ping-timeout = 60
環境プロパティを使用して、OHSサーバーのその他の環境変数を指定する場合があります。
環境プロパティの構文を次に示します。
environment[.append][.<order>].<name> = <value>
ここで:
オプションの.append
は、<
name
>
の既存の値に新しい<value>を追加します。<
name
>
が定義されていない場合は、<value>が新しい値になります。
オプションの.<
order
>
値は、環境変数内でこの定義の設定の順位を設定します(デフォルトは0)。順位によって、構成済の変数がプロセスの環境にいつ追加されるかが決まります(およびその評価された値)。低い順位の値を持つ環境プロパティは、高い順位の値を持つものより先に処理されます。順位の値は0以上の整数にする必要があります。
<
name
>
は、環境変数の名前で、文字またはアンダースコアで始まり、文字、数字またはアンダースコアで構成される必要があります。
<
value
>
は、環境変数<
name
>
の値です。値は、自身も含め他の環境変数名を参照できます。
この値には、次の特別な参照が含まれている場合があります。
パス・セパレータとして"$:"
ファイル・セパレータとして"$/"
'$'として"$$"
これらの特殊文字の例外を使用して、UNIX変数の構文の参照(「$name」または「${name}」)およびWindows変数の構文の参照(「%name%」)がサポートされています。
同じプロパティ・ファイル内の個々のプロパティの名前は一意である必要があるため(複数のプロパティを同じ名前で定義した場合の動作は未確定)、同じ環境変数<
name
>
内に複数の定義を指定する場合は、プロパティ名を一意に保持するために.<
order
>
フィールドを使用する必要があります。
次の環境変数は、Oracle HTTP Serverノード・マネージャ・プラグインによって設定されます。
SHELL: ノード・マネージャ環境から、またはデフォルトで/bin/shに設定、またはWindowsの場合はcmd.exe
ORA_NLS33: $ORACLE_HOME/nls/dataに設定
NLS_LANG: ノード・マネージャの環境から、それ以外はデフォルト
LANG: ノード・マネージャの環境から、それ以外はデフォルト
LC_ALL: 設定されている場合は、ノード・マネージャの環境から
TZ: 設定されている場合は、ノード・マネージャの環境から
ORACLE_HOME: Oracleホームへのフルパス
ORACLE_INSTANCE: ドメイン・ホームへのフルパス
INSTANCE_NAME: ドメインの名前
PRODUCT_HOME: OHSインストール: $ORACLE_HOME/ohsへのパス
PATH: デフォルトで次のように設定されます。
UNIXの場合:
$PRODUCT_HOME/bin:$ORACLE_HOME/bin:
$ORACLE_HOME/jdk/bin:/bin:/usr/bin:/usr/local/bin
Windowsの場合:
%PRODUCT_HOME%\bin;%ORACLE_HOME%\bin;
%ORACLE_HOME%\jdk\bin;%SystemRoot%;%SystemRoot%\system32
これらの変数はUNIXのみに適用されます。
TNS_ADMIN: ノード・マネージャの環境から、または$ORACLE_HOME/network/admin
LD_LIBRARY_PATH: $PRODUCT_HOME/lib:$ORACLE_HOME/lib:$ORACLE_HOME/jdk/lib
LIBPATH: LD_LIBARY_PATHと同じ
X_LD_LIBRARY_PATH_64: LD_LIBRARY_PATHと同じ
これらの変数はWindowsのみに適用されます。
ComSpec: デフォルトでシステムの%ComSpec%値に設定されます。
SystemRoot: デフォルトでシステムの%SystemRoot%値に設定されます。
SystemDrive: デフォルトでシステムの%SystemDrive%値に設定されます。
例
/oracleとしてインストールされたWeb層およびノード・マネージャの環境に設定された環境変数「MODX_RUNTIME=special」を使用するUNIX系のシステムでは、次の定義を使用します。
environment.MODX_RUNTIME = $MODX_RUNTIME environment.1.MODX_ENV = Value A environment.1.MODX_PATH = $PATH$:/opt/modx/bin environment.2.MODX_ENV = ${MODX_ENV}, Value B environment.append.2.MODX_PATH = /var/modx/bin MODX_ENV = Value A, Value B MODX_PATH = /oracle/ohs/bin:/oracle/bin:/oracle/jdk/bin:/bin:/usr/bin: /usr/local/bin:/opt/modx/bin:/var/modx/bin
前述の定義により、追加の環境変数がOracle HTTP Serverに設定されます。
MODX_RUNTIME = special
これらは、Linuxまたはその他のUNIX系のシステムで実行するインスタンスの場合にのみ構成する必要があります。
プロパティ | 説明 |
---|---|
|
構成の変更がアクティブ化された場合に、Oracle HTTP Serverに対して正常な再起動を使用するか、または強制的な再起動を使用するかを決定します。
デフォルト: graceful |
|
Oracle HTTP Serverを停止する場合、正常な停止を使用するか、または強制的な停止を使用するかを決定します。
デフォルト: stop |
|
Oracle HTTP Serverに対してプリフォークMPMを使用するか、またはワーカーMPMを使用するかを決定します。
デフォルト: worker |
allow- |
OHSサーバーがクラッシュした場合に、コア・ファイルが書き込まれることを許可するために、無制限に設定するかどうかを決定します。
デフォルト: no |
例
restart-mode = graceful stop-mode = stop mpm = worker allow-corefiles = no