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

次の項では、Apache、Microsoft IISおよびOracle iPlanet Webサーバー・プラグインを構成するために使用するパラメータを説明します。

8.1項「Webサーバー・プラグインの構成ファイルでのパラメータの入力」
8.2項「Webサーバー・プラグインの一般的なパラメータ」
8.3項「Webサーバー・プラグインのSSLパラメータ」

8.1 Webサーバー・プラグインの構成ファイルでのパラメータの入力

個々のWebサーバー・プラグインに対するパラメータは、特別な構成ファイルに入力します。この構成ファイルは各Webサーバーで異なる名前を持ち、ファイルの形式について異なる規則があります。詳細については、各プラグインに関する次の項を参照してください。

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

Webサーバー・プラグインの一般的なパラメータを表8-1に示します。パラメータでは大文字/小文字が区別されます。Apache HTTP Serverの適用場所に関係なく、Oracle HTTP Serverもサポートされます。

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

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

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

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

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

環境変数TMP
環境変数TEMP
C:\Temp

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

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

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

注意:

SCG証明書は、WebLogic Serverプロキシ・プラグインで使用できません。SCG以外の証明書は適切に機能し、その場合はWebLogic Serverとプラグインの間でSSL通信を行えます。

キーストア関連の初期化パラメータは、WebLogic Serverプロキシ・プラグインで使用できません。

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

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

パラメータデフォルト説明適用対象

パラメータ	デフォルト	説明	適用対象
SecureProxy	OFF	このパラメータをONに設定すると、プラグインとWebLogic Server間のすべての通信でSSLプロトコルの使用が有効になります。このパラメータを定義する前に、対応するWebLogic ServerのポートをSSLプロトコル用に構成しておく必要があります。このパラメータは、メイン・サーバー用の構成と仮想ホスト用の構成(仮想ホストが定義されている場合)の2つのレベルで設定できます。仮想ホスト用の構成でこの設定がオーバーライドされない場合、仮想ホスト用の構成はメイン・サーバー用の構成からSSLの構成を継承します。	Microsoft IIS、Oracle iPlanet Web ServerおよびApache HTTP Server
WLSSLWallet	なし	WLSSLWalletは、WebLogic Server SSLの構成方法に基づいて一方向SSLまたは双方向SSLを実行します。引数としてOracleウォレット(SSOウォレット・ファイルを含む)のパスが必要です。例: `WLSSLWallet "ORACLE_INSTANCE}/config/COMPONENT_TYPE/COMPONENT_NAME/default"`	Microsoft IIS、Oracle iPlanet Web ServerおよびApache HTTP Server

SecureProxy

OFF

このパラメータをONに設定すると、プラグインとWebLogic Server間のすべての通信でSSLプロトコルの使用が有効になります。このパラメータを定義する前に、対応するWebLogic ServerのポートをSSLプロトコル用に構成しておく必要があります。

このパラメータは、メイン・サーバー用の構成と仮想ホスト用の構成(仮想ホストが定義されている場合)の2つのレベルで設定できます。仮想ホスト用の構成でこの設定がオーバーライドされない場合、仮想ホスト用の構成はメイン・サーバー用の構成からSSLの構成を継承します。

Microsoft IIS、Oracle iPlanet Web ServerおよびApache HTTP Server

WLSSLWallet

なし

WLSSLWalletは、WebLogic Server SSLの構成方法に基づいて一方向SSLまたは双方向SSLを実行します。

引数としてOracleウォレット(SSOウォレット・ファイルを含む)のパスが必要です。

例: WLSSLWallet "ORACLE_INSTANCE}/config/COMPONENT_TYPE/COMPONENT_NAME/default"

Microsoft IIS、Oracle iPlanet Web ServerおよびApache HTTP Server