7 Webサーバー・プラグインのパラメータ

この章では、Oracle HTTP Server、Apache HTTPサーバー、Microsoft IISおよびOracle iPlanet Web Serverのプラグインの構成に使用できるパラメータについて説明します。次の項で構成されます。

• 第7.1項「Webサーバー・プラグインの一般パラメータ」

• 第7.2項「Webサーバー・プラグインのSSLパラメータ」

注意: Webサーバー・プラグインのパラメータは、Webサーバーごとに一意に名前を付けてフォーマット設定した、専用の構成ファイルにおいて指定する必要があります。Apache HTTPサーバー、Oracle HTTP Server、Microsoft IISおよびOracle iPlanet Web Server用のプラグインに固有の構成ファイルの詳細は、次の各章を参照してください。 第4章「Apache HTTP Serverプラグインのインストールと構成」 第2章「Oracle HTTP Server用のmod_wl_ohsプラグインの構成」 第5章「Microsoft IISプラグインのインストールと構成」 第3章「Oracle iPlanet Web Serverプラグインのインストールと構成」

7.1 Webサーバー・プラグインの一般パラメータ

表7-1に、Webサーバー・プラグインの一般パラメータを示します。パラメータでは、大文字と小文字が区別されます。

表7-1 Webサーバー・プラグインの一般パラメータ

パラメータ名	デフォルト値	説明	適用対象
WebLogicHost (単一のWebLogic Serverにプロキシする場合は必須)	なし	HTTPリクエストの転送先となるWebLogic Serverホスト(または、WebLogic Serverで定義されている仮想ホスト名)。WebLogicクラスタを使用している場合は、WebLogicHostではなくWebLogicClusterパラメータを使用します。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
WebLogicPort (単一のWebLogic Serverにプロキシする場合は必須)	なし	WebLogic Serverホストでプラグイン(または他のサーバー)からの接続リクエストをリスニングするポート(プラグインとWebLogic Serverとの間でSSLを使用している場合は、このパラメータをSSLリスニング・ポートに設定し、SecureProxyパラメータをONに設定します)。 WebLogic Clusterを使用している場合は、WebLogicPortではなくWebLogicClusterパラメータを使用します。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
WebLogicCluster (WebLogic Serverの1つのクラスタ、またはクラスタ化されていない複数のサーバーにプロキシする場合は必須)	なし	WebLogicClusterパラメータは、クラスタ化されたバックエンド・サーバーのリストにプロキシしたり、クラスタ化されていない管理対象サーバー・インスタンス間でのロード・バランシングを実行するために必要となります。 ロード・バランシングに使用可能なWebLogic Serverのリスト。サーバーまたはクラスタのリストは、host:portエントリのリストです。クラスタとシングル・サーバーを組み合せて指定した場合、このパラメータに対して返される動的リストには、クラスタ化されたサーバーのみが含まれます。 このパラメータの値を指定するための構文は、プラグインの構成対象となるWebサーバーに応じて異なります。詳細は、次を参照してください。 第4章「Apache HTTP Serverプラグインのインストールと構成」 第2章「Oracle HTTP Server用のmod_wl_ohsプラグインの構成」 第5章「Microsoft IISプラグインのインストールと構成」 第3章「Oracle iPlanet Web Serverプラグインのインストールと構成」 プラグインとWebLogic Serverの間にSSLを使用している場合は、ポート番号をSSLリスニング・ポートに設定して、SecureProxyパラメータをONに設定します。 このプラグインは、すべての使用可能なサーバーの間の単純なラウンドロビンを実行します。このプロパティで指定したサーバー・リストが、サーバーとプラグインが保持する動的サーバー・リストの開始点となります。WebLogic Serverとこのプラグインの連携により、クラスタに発生した新規のクラスタ・メンバー、失敗したクラスタ・メンバーおよびリカバリしたクラスタ・メンバーを反映してサーバーのリストが自動的に更新されます。 動的クラスタ・リストの使用を無効にするには、DynamicServerListパラメータをOFFに設定します。 このプラグインはCookie、URLエンコード済セッション、またはPOSTデータに格納されたセッションを含むHTTPリクエストを、最初にCookieを作成したクラスタ内のサーバーに送信します。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
PathTrim	null	RFC仕様のとおり、URLの一般的な構文は次のようになります。 [PROTOCOL]://[HOSTNAME]:{PORT}/{PATH}/{FILENAME};{PATH_PARAMS}/{QUERY_STRING}... PathTrimは、リクエストがWebLogic Serverに転送される前にプラグインによって元のURLの{PATH}/{FILENAME}部分から切り捨てられる文字列を指定します。たとえば、次のようなURLは、 http://myWeb.server.com/weblogic/foo 解析のためにプラグインに渡され、PathTrimがURLをWebLogic Serverに渡す前に/weblogicを切り捨てるように設定されている場合、WebLogic Serverには次のURLが転送されます。 http://myWeb.server.com:7001/foo 既存のサード・パーティ製サーバーを新しく変更しており、プラグインを使用してWebLogic Serverにリクエストをプロキシする場合は、weblogic/fooを含むように/fooへのアプリケーション・パスを変更する必要があります。PathTrimとPathPrependを併用することで、このパスを変更できます。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
PathPrepend	null	RFC仕様のとおり、URLの一般的な構文は次のようになります。 [PROTOCOL]://[HOSTNAME]:{PORT}/{PATH}/{FILENAME};{PATH_PARAMS}/{QUERY_STRING}... PathPrependは、PathTrimの値が切り捨てられてからリクエストがWebLogic Serverに転送されるまでの間に、プラグインによって元のURLの{PATH}部分の先頭に付加されるパスを指定します。 ファイル名を付加する必要がある場合はPathPrependではなくDefaultFileNameパラメータを使用してください。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
ConnectTimeoutSecs	10	プラグインがWebLogic Serverホストへの接続を試行する最大時間(秒)。この値はConnectRetrySecsより大きくしてください。指定どおりに再試行されたが(ConnectRetrySecsを参照)、接続に成功せずにConnectTimeoutSecsの秒数が経過した場合は、クライアントにHTTP 503/Service Unavailableというレスポンスが送信されます。 エラー・レスポンスは、ErrorPageパラメータを使用してカスタマイズできます。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
ConnectRetrySecs	2	WebLogic Serverホスト(またはクラスタ内のすべてのサーバー)への接続試行の間にプラグインがスリープする間隔(秒)。この値はConnectTimeoutSecsより小さくします。クライアントにHTTP 503/Service Unavailableというレスポンスを返す前にプラグインが接続を試みる回数は、ConnectTimeoutSecsをConnectRetrySecsで除算することで算出されます。 再試行しないようにするには、ConnectRetrySecsをConnectTimeoutSecsと同じ値に設定します。ただし、プラグインは最低でも2回の接続を試みます。 エラー・レスポンスは、ErrorPageパラメータを使用してカスタマイズできます。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
Debug	OFF	デバッグ操作で実行するロギングのタイプを設定します。UNIXシステムの場合、デバッグ情報は/tmp/wlproxy.logファイルに書き込まれ、Windows NT/2000システムの場合は、c:\TEMP\wlproxy.logに書き込まれます。 この場所とファイル名をオーバーライドするには、WLLogFileパラメータを別のディレクトリおよびファイルに設定します。(この場所を変更する別の方法は、WLTempDirパラメータを参照してください。) サーバーにログインするユーザーに対してtmpまたはTEMPディレクトリへの書込み権限が割り当てられていることを確認してください。次のいずれかのロギング・オプションを設定します(HFC、HTW、HFWおよびHTCオプションは、たとえばHFC,HTWのようにカンマ区切りにすることで組み合せて入力できます): ON - プラグインは、情報メッセージおよびエラー・メッセージを記録します。 OFF - デバッグ情報は記録されません。 HFC - プラグインは、クライアントからのヘッダー、情報メッセージおよびエラー・メッセージを記録します。 HTW - プラグインは、WebLogic Serverに送信されたヘッダー、情報メッセージおよびエラー・メッセージを記録します。 HFW - プラグインは、WebLogic Serverから送信されたヘッダー、情報メッセージ、およびエラー・メッセージを記録します。 HTC - プラグインは、クライアントに送信されたヘッダー、情報メッセージおよびエラー・メッセージを記録します。 ERR - プラグインのエラー・メッセージのみを出力します。 ALL - プラグインは、クライアントに送信されたヘッダー、クライアントから送信されたヘッダー、WebLogic Serverに送信されたヘッダー、WebLogic Serverから送信されたヘッダー、情報メッセージおよびエラー・メッセージを記録します。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
WLLogFile	「Debug」パラメータを参照	DebugパラメータがONに設定されている場合に生成されるログ・ファイルのパスとファイル名を指定します。このディレクトリは、このパラメータを設定する前に作成する必要があります。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
WLDNSRefreshInterval	0 (起動時に1回のみルックアップ)	プロキシ構成で定義されている場合、WebLogic ServerがサーバーのDNS名とIPとの間のマッピングをリフレッシュする間隔を秒数で指定します。WebLogic Serverインスタンスを別のIPアドレスに移行する場合に使用できますが、そのサーバーのIPのDNS名は変更されません。この場合、指定したリフレッシュ間隔で、DNSとIPとの間のマッピングが更新されます。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー
WLTempDir	「Debug」パラメータを参照	wlproxy.logを作成するディレクトリを指定します。場所が見つからない場合、Windowsの場合はC:/tempに、Unixの場合はすべてのプラットフォームで/tmpにログ・ファイルが作成されます。 POSTデータ・ファイルの_wl_proxyディレクトリの場所も指定します。 WLTempDirおよびWLLogFileの両方を設定した場合、wlproxy.logの場所についてはWLLogFileが優先します。_wl_proxyディレクトリの場所は、依然としてWLTempDirによって決まります。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
DebugConfigInfo	OFF	特殊な問合せパラメータ「__WebLogicBridgeConfig」を有効にします。プラグインから構成パラメータに関する詳細を取得するために使用します。 たとえば、DebugConfigInfoを設定して__WebLogicBridgeConfigを有効にしてから、?__WebLogicBridgeConfigという問合せ文字列を含むリクエストを送信すると、プラグインによって、構成情報と実行時統計が収集され、その情報がブラウザに戻されます。この場合、プラグインはWebLogic Serverに接続しません。 このパラメータはデバッグにのみ使用するもので、出力メッセージの形式はリリースによって異なります。セキュリティのため、本番システムではこのパラメータをOFFにしてください。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
ErrorPage	なし	WebサーバーからWebLogic Serverにリクエストを転送できなかった場合に表示される、ユーザー独自のエラー・ページを作成できます。 バックエンド・サーバーが「HTTP 503: サービスが使用できません」レスポンスを返し、フェイルオーバー用のサーバーがない場合、プラグインはエラー・ページにリダイレクトします。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
WLSocketTimeoutSecs	2 (必ず0より大きい値)	ソケットの接続時のタイムアウトを秒単位で設定します。詳細は、ConnectTimeoutSecsおよびConnectRetrySecsを参照してください。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
WLIOTimeoutSecs (HungServerRecoverSecsの新しい名称)	300	WebLogic Serverからのリクエストへのレスポンスに対するプラグインの待機時間を定義します。プラグインは、WLIOTimeoutSecsで指定されている秒数までサーバーからのレスポンスを待機した後、サーバー無応答を宣言し、次のサーバーにフェイルオーバーします。この値は、大きな値にしておく必要があります。この値をサーブレットの処理時間より短くした場合は、予期しない結果が発生する場合があります。 最小値: 10 最大値: 2147483647	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
Idempotent	ON	ONに設定されている状態で、サーバーがWLIOTimeoutSecsの時間内に応答しない場合、プラグインはフェイルオーバーします(メソッドが同等の場合)。 IdempotentをONに設定してある場合も、プラグインによってフェイルオーバーされるため、サーバーからREAD_ERROR_FROM_SERVERなどのエラーが返されます。 「OFF」に設定した場合、プラグインはフェイルオーバーしません。Apache HTTP Serverを使用している場合は、複数のURLまたはMIMEタイプに対してこのパラメータを別々に設定できます。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
WLCookieName (CookieNameは非推奨です。)	JSESSIONID	WebLogic Server WebアプリケーションのWebLogic ServerセッションCookieの名前を変更する場合は、プラグインのWLCookieNameパラメータを同じ値に変更する必要があります。WebLogicセッションCookie名は、WebLogic固有のデプロイメント記述子の<session-descriptor>要素で設定されます。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
DefaultFileName	なし	URIが「/」の場合、プラグインは次の手順を実行します。 PathTrimパラメータで指定されたパスを取り除きます。 DefaultFileNameの値を末尾に付加します。 PathPrependで指定された値を先頭に付加します。 これによって、WebLogic Serverからリダイレクトされなくなります。 DefaultFileNameには、リクエストをプロキシするWebLogic Server上のWebアプリケーションのデフォルト・ウェルカム・ページを設定します。たとえば、DefaultFileNameをwelcome.htmlに設定した場合、HTTPリクエストが「http://somehost/weblogic」であれば、「http://somehost/weblogic/welcome.html」になります。このパラメータが機能するためには、リクエストが転送されるすべてのWebアプリケーションで同じウェルカム・ファイルを指定する必要があります。詳細は、ウェルカム・ページの構成に関する項を参照してください。 Apacheユーザー向けの注意: StrongholdバージョンまたはRavenバージョンを使用する場合は、このパラメータをIfModuleブロック内ではなくLocationブロック内で定義します。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
MaxPostSize	0	POSTデータの最大許容サイズ(バイト単位)。コンテンツ長がMaxPostSizeを超えている場合は、プラグインによってエラー・メッセージが返されます。0に設定した場合、POSTデータのサイズはチェックされません。これは、POSTデータを使用してサーバーを過負荷状態にしようとするサービス拒否攻撃を防ぐために役立ちます。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
MatchExpression	なし	MIMEタイプによるプロキシを行う場合、MatchExpressionパラメータを使用してIfModuleブロック内にファイル名のパターンを設定します。 MIMEタイプによるプロキシの場合の例: <IfModule weblogic_module> MatchExpression *.jsp WebLogicHost=myHost|paramName=value </IfModule> パスによるプロキシの場合の例: <IfModule weblogic_module> MatchExpression /weblogic WebLogicHost=myHost|paramName=value </IfModule> 次の構文を使用して、MatchExpressionの新しいパラメータを定義することもできます。 MatchExpression *.jsp PathPrepend=/test PathTrim=/foo	Oracle HTTP Server Apache HTTPサーバー
FileCaching	ON	ONに設定すると、リクエストのPOSTデータのサイズが2048バイトより大きい場合に、POSTデータが、まずディスク上の一時ファイルに読み込まれ、次に8192バイトのチャンク単位でWebLogic Serverに転送されます。これにより、フェイルオーバーの間もPOSTデータが保持され、プライマリがダウンしても、必要なすべてのデータをセカンダリにコピーすることができます。 FileCachingがONになっていると、WebサーバーとWebLogicとの間でデータがまだ転送中でも、POSTの進行状況を追跡するクライアントは、転送が完了したと認識することに注意してください。したがって、WebLogic Server上で実際にデータが使用可能になったタイミングが示されるよう、アップロード中にブラウザに進行状況バーを表示する必要がある場合は、FileCachingをONにしないでおくこともできます。 OFFに設定すると、リクエストのPOSTデータのサイズが2048バイトより大きい場合、リクエストを処理するWebLogic Serverクラスタ・メンバーが特定されるまで、POSTデータの読込みが延期されます。その後、プラグインがPOSTデータを読み込み、ただちに8192バイトのチャンク単位でWebLogic Serverに送信します。 FileCachingをOFFすると、フェイルオーバーが制限されることに注意してください。リクエストの処理中にWebLogic Serverプライマリ・サーバーがダウンした場合、すでにプライマリに送信されたPOSTデータはセカンダリに複写できません。 なお、POSTデータのサイズが2048バイト以下の場合は、FileCachingの設定に関係なく、プラグインによってデータがメモリーに読み込まれ、必要に応じて、フェイルオーバー時にセカンダリへの複写に使用されます。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
WLExcludePathOrMimeType	なし	このパラメータによって、プロキシ設定から一定のリクエストを除外できます。 このパラメータは、グローバルに定義することも、「場所」タグ・レベルでローカルに定義することもできます。このプロパティをローカルに定義した場合、グローバルなプロパティがオーバーライドされるのではなく、2つのパラメータの集合が定義されます。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
KeepAliveSecs	20	プラグインとWebLogic Serverとの間のアクティブでない接続が閉じられるまでの時間。このパラメータを有効にするには、KeepAliveEnabledをtrue (Apache HTTPサーバーを使用している場合はON)に設定する必要があります。 このパラメータの値は、管理コンソールの「サーバー/HTTP」タブで設定される「期間」フィールドの値以下、またはサーバーMBeanでKeepAliveSecs属性によって設定される値以下である必要があります。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
KeepAliveEnabled	true (Microsoft IISプラグイン) ON (Oracle HTTP ServerおよびApache HTTPサーバー) ON (Oracle iPlanet Web Server)	プラグインとWebLogic Serverの間の接続のプールを有効化します。 Microsoft IISプラグイン用の有効な値は、trueおよびfalseです。 Apache HTTPサーバー用の有効な値は、ONおよびOFFです。 Apache prefork mpmの使用中に、Apache Webサーバーがクラッシュする可能性があります。Apacheでprefork mpmまたはworker mpmを使用する場合は、KeepAliveEnabledをOFFにしてください。 Oracle iPlanet Web Server用の有効な値は、ONおよびOFFです。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
QueryFromRequest	OFF	ONに設定すると、Apache HTTPサーバーで次のコマンドが使用されます。 (request_rec *)r->the_ request 問合せ文字列をWebLogic Serverに渡します。(詳細は、Apacheドキュメントを参照してください。)この動作は、Netscapeバージョン4.xブラウザで、問合せ文字列にスペースのあるリクエストを行う場合に役立ちます。 OFFに設定すると、Apache HTTPサーバーで(request_rec *)r->argsが使用され、WebLogic Serverに問合せ文字列が渡されます。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー
MaxSkipTime	10	WebLogicClusterパラメータか、WebLogic Serverから戻される動的クラスタ・リストのどちらかにリストされているWebLogic Serverで障害が発生した場合、障害の発生したサーバーはbadとしてマークされ、プラグインによって、リスト内の次のサーバーへの接続が試みられます。 MaxSkipTimeには、プラグインがbadとしてマークされたサーバーへの接続を再試行するまでの時間を設定します。プラグインは、一意のリクエスト(つまり、Cookieのないリクエスト)を受信するたびにリスト内の新しいサーバーに接続しようとします。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
DynamicServerList	ON	OFFに設定すると、プラグインはプロキシされたロード・バランシング・リクエストに使用される動的クラスタ・リストを無視し、WebLogicClusterパラメータで指定された静的リストのみを使用します。通常は、このパラメータをONに設定したままにしてください。 このパラメータをOFFに設定した場合は、次のような影響があります。 静的リスト内の1つ以上のサーバーが失敗した場合、プラグインは機能していないサーバーへの接続を試行し無駄な時間を費やすことがあるため、パフォーマンスが低下します。 クラスタに新しいサーバーを追加した場合、このパラメータを再定義しないかぎりプラグインは新しいサーバーへリクエストをプロキシ設定できません。WebLogicサーバーは、新しいサーバーがクラスタの一部になると、これらのサーバーを動的サーバー・リストへ自動的に追加します。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
WLProxySSL	OFF	次の条件に該当する場合にプラグインとWebLogic Serverとの間のSSL通信を維持するには、このパラメータをONに設定します。 HTTPクライアントのリクエストでHTTPSプロトコルが指定されています。 1つ以上のプロキシ・サーバー(WebLogic Serverプロキシ・プラグインを含む)を経由してリクエストが渡されています。 プラグインとWebLogic Serverとの間の接続でHTTPプロトコルが使用されています。 WLProxySSLをONにすると、WebLogic Serverからクライアントに戻されるロケーション・ヘッダーでHTTPSプロトコルが指定されます。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
WLProxyPassThrough	OFF	プロキシの連鎖が設定されており、プロキシ・プラグインまたはHttpClusterServletが他のプロキシまたはロード・バランサの背後で実行されている場合は、WLProxyPassThroughパラメータを明示的に有効にする必要があります。このパラメータによって、ヘッダーはプロキシの連鎖に渡されるようになります。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
WLLocalIP	なし	プラグインがマルチホーム・マシン上で実行されているWebLogic Serverインスタンスに接続する際の、バインド先(プラグインのシステム上)となるIPアドレスを定義します。 WLLocalIPが設定されていない場合は、TCP/IPスタックによってソースIPアドレスが選択されます。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
WLSendHdrSeparately	ON	このパラメータをONに設定すると、ヘッダーとレスポンス本文が別々のパケットで送信されます。 注意: ヘッダーとレスポンス本文を2つのコールで送信する必要がある場合(たとえば、他のISAPIフィルタ、またはヘッダーが本文の前にあることを期待するプログラム的なクライアントがある場合)は、このパラメータをONに設定してください。	Microsoft IIS
WLFlushChunks	False	デフォルトで、IISプラグインは、チャンクの受信時にそれをストリーミングするのではなく、チャンク転送エンコーディングのレスポンスをバッファします。WLFlushChunksフラグをtrueに設定すると、プラグインは、WebLogic Serverからのチャンクの受信時にすぐにそれをフラッシュします。	Microsoft IIS
WLProxySSLPassThrough	OFF	Webサーバーとプラグインより前にデプロイされたロード・バランサまたはその他のソフトウェアがSSLの終端点となっており、その製品において、クライアントからの接続がSSLを介すかどうかに基づいてWL-Proxy-SSLリクエスト・ヘッダーがtrueまたはfalseに設定されている場合は、SSLの使用がOracle WebLogic Serverに渡されるよう、WLProxySSLPassThroughをONに設定します。 プラグインが動作するWebサーバーにSSLの終端点があるか、ロード・バランサでWL-Proxy-SSLが設定されていない場合は、WLProxySSLPassThroughをOFF (デフォルト)に設定します。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
WLServerInitiatedFailover	オン	これは、Oracle WebLogic Serverからの503エラー・レスポンスによって別のサーバーへのフェイルオーバーがトリガーされるかどうかを制御します。通常プラグインは、503エラー・レスポンスを受け取ると、別のサーバーへのフェイルオーバーを試行します。WLServerInitiatedFailoverをOFFに設定すると、503エラー・レスポンスはただちにクライアントに返されます。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
WLForwardUriUnparsed	OFF	ONに設定されている場合、WLSプラグインは元のURIをクライアントからWebLogic Serverに転送します。OFF (デフォルト)に設定されている場合、WebLogic Serverに送信されたURIは、mod_rewriteまたはその他のWebサーバー・プラグイン・モジュールによって変更されることがあります。	Oracle HTTP Server Apache HTTPサーバー
WLSRequest	OFF	これは、Oracle WebLogic Serverに転送されるリクエストを識別するSetHandler weblogicハンドラ・メカニズムに対する代替策となります。次に例を示します。 <Location /weblogic> WLSRequest ON PathTrim /weblogic </Location> SetHandler weblogic-handlerではなくWLSRequestをONにして使用すると、次のような利点があります。 Webサーバーの処理オーバーヘッドが全般的に低減されます。 WebサーバーのDocumentRootが処理速度の遅いファイル・システム上にある場合に起こる著しいパフォーマンスの低下が解決されます。 ファイル・システムの長さ制限が原因でURIをファイル・システムにマップできない場合の403エラーが解決されます。	Oracle HTTP Server Apache HTTPサーバー

7.1.1 POSTデータ・ファイルの場所

FileCachingパラメータをONに設定すると、リクエストのPOSTデータのサイズが2048バイトより大きい場合に、POSTデータが、まずディスク上の一時ファイルに読み込まれ、次に8192バイトのチャンク単位でWebLogic Serverに転送されます。これにより、フェイルオーバー時もPOSTデータが保持されます。

UNIXの場合、一時POSTファイルは/tmp/_wl_proxyの下にあります。Windowsの場合は、次の場所にあります(WLTempDirを指定していない場合)。

1. 環境変数TMP

2. 環境変数TEMP

3. C:\Temp

/tmp/_wl_proxyは、HTTPサーバーのユーザーが所有する固定ディレクトリです。異なるユーザーによって複数のHTTPサーバーがインストールされている場合は、一部のHTTPサーバーがこのディレクトリに書き込めない場合があります。このような状況では、エラーが発生します。

この問題を解決するには、WLTempDirパラメータを使用して、POSTデータ・ファイル用の_wl_proxyディレクトリに別の場所を指定します。

7.2 Webサーバー・プラグインのSSLパラメータ

注意: SCG証明書は、WebLogic Serverプロキシ・プラグインではサポートされていません。SCG以外の証明書は適切に機能するため、それらを使用することでWebLogic Serverとプラグインとの間のSSL通信が可能です。 キーストア関連の初期化パラメータは、WebLogic Serverプロキシ・プラグインでは使用できません。

表7-2に、Webサーバー・プラグインのSSLパラメータを示します。パラメータでは、大文字と小文字が区別されます。

表7-2 Webサーバー・プラグインのSSLパラメータ

パラメータ	デフォルト値	説明	適用対象
SecureProxy	OFF	このパラメータをONに設定すると、プラグインとWebLogic Serverとの間のすべての通信でSSLプロトコルの使用が有効になります。このパラメータを定義する前に、対応するWebLogic Server上のポートをSSLプロトコル用に構成しておく必要があります。 このパラメータは、メイン・サーバー用構成と仮想ホスト用構成(仮想ホストを定義してある場合)という2つのレベルで設定可能です。仮想ホスト用構成において、SSL構成はメイン・サーバー用構成から継承されます(この設定がオーバーライドされない場合)。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS
WebLogicSSLVersion	プラグインとWebLogic Serverの両方でサポートされている最適なプロトコル	プラグインとWebLogic Serverの間の通信に使用するSSLプロトコル・バージョンを指定します。この設定は、Webサーバーのssl.confファイルの設定と一致している必要はありません。プラグインは、WebLogic Serverとの通信に独自のSSLバージョンを使用できます。 注意: これは11.1.1.9リリースの新規パラメータでWeb Serverプラグインの古いリリースでは使用できません。 使用できる値は次のとおりです。 TLSv1: TLS v1.0の使用 TLSv1_1: TLS v1.1の使用 TLSv1_2: TLS v1.2の使用 次にその例を示します。 WebLogicSSLVersion TLSv1_1 TLSv1_2 スペース区切りのリストを使用して、複数のプロトコルを定義できます。選択されたSSLプロトコル・バージョンは、プラグインからWebLogic Serverへのすべての接続に使用されます。したがって、このパラメータはグローバル・スコープで定義してください。 構成されていない場合、プラグインは、プラグインとWebLogic Serverの両方でサポートされている最適なプロトコルを使用します。	Oracle HTTP Server Apache HTTPサーバー
WLSSLWallet	なし	WLSSLWalletは、Oracle WebLogic Server用のSSL構成の内容に基づいて、一方向SSLまたは双方向SSLを実行します。 引数として、Oracleウォレット(SSOウォレット・ファイルを含む)のパスが必要です。 たとえば、WLSSLWallet "ORACLE_INSTANCE}/config/COMPONENT_TYPE/COMPONENT_NAME/default"です。	Oracle HTTP Server Oracle iPlanet Web Server Apache HTTPサーバー Microsoft IIS