1. Oracle WebLogic Server Webアプリケーション、サーブレット、JSPの開発
  2. HTTPプロキシ・サーブレットのパラメータ

E HTTPプロキシ・サーブレットのパラメータ

HttpProxyServletパラメータの説明を確認します。

この付録の内容は次のとおりです。

Debug

デフォルト: OFF

デバッグ操作で実行するロギングのタイプを設定します。Windows NTシステムまたはWindows 2000システムでは、デバッグ情報はc:\TEMP\wlproxy.logに書き込まれます。

この場所とファイル名をオーバーライドするには、WLLogFileパラメータを別のディレクトリおよびファイルに設定します。(この場所を変更する別の方法は、WLTempDirパラメータを参照してください。)

ログ・ファイルのディレクトリに書込み権限があることを確認してください。次のいずれかのロギング・オプションを設定します(HFC、HTW、HFWおよびHTCオプションは、たとえばHFC,HTWのようにカンマ区切りにすることで組み合せて入力できます)。

  • ON: プラグインは、情報メッセージおよびエラー・メッセージを記録します。

  • OFF: デバッグ情報はログ記録されません。

  • HFC: プラグインは、クライアントからのヘッダー、情報メッセージおよびエラー・メッセージを記録します。

  • HTW: プラグインは、WebLogic Serverに送信されたヘッダー、情報メッセージおよびエラー・メッセージを記録します。

  • HFW: プラグインは、WebLogic Serverから送信されたヘッダー、情報メッセージおよびエラー・メッセージを記録します。

  • HTC: プラグインは、クライアントに送信されたヘッダー、情報メッセージおよびエラー・メッセージを記録します。

  • ERR: プラグインのエラー・メッセージのみを出力します。

  • ALL: プラグインは、クライアントとの間で送受信されたヘッダー、WebLogic Serverとの間で送受信されたヘッダー、情報メッセージおよびエラー・メッセージを記録します。

ノート:

HttpProxyServletのオプションは、TRUE(ON)およびFALSE(OFF)の2つのみです。

非推奨パラメータを使用しないロギング設定の詳細は、「Apache HTTPサーバーの非推奨ディレクティブ」を参照してください。

DebugConfigInfo

デフォルト: OFF

特殊な問合せパラメータ__WebLogicBridgeConfigを有効にします。プラグインから構成パラメータに関する詳細を取得するために使用します。

たとえば、DebugConfigInfoを設定して__WebLogicBridgeConfigを有効にしてから、?__WebLogicBridgeConfigという問合せ文字列を含むリクエストを送信すると、プラグインによって、構成情報と実行時統計が収集され、その情報がブラウザに戻されます。この場合、プラグインはWebLogic Serverに接続しません。

このパラメータはデバッグにのみ使用するもので、出力メッセージの形式はリリースによって異なります。セキュリティのため、本番システムではこのパラメータをOFFにしてください。

DefaultFileName

デフォルト: なし

URIが/の場合、プラグインは次のステップを実行します。

  1. PathTrimパラメータで指定されたパスを取り除きます。

  2. DefaultFileNameの値を末尾に付加します。

  3. PathPrependで指定された値を先頭に付加します。

これによって、WebLogic Serverからリダイレクトされなくなります。

DefaultFileNameには、リクエストをプロキシするWebLogic Server上のWebアプリケーションのデフォルト・ウェルカム・ページを設定します。たとえば、DefaultFileNameをwelcome.htmlに設定した場合は、http://somehost/weblogicというHTTPリクエストは、http://somehost/weblogic/welcome.htmlになります。このパラメータが機能するためには、リクエストが転送されるすべてのWebアプリケーションで同じウェルカム・ファイルを指定する必要があります。『Oracle Fusion Middleware Oracle WebLogic Server Webアプリケーション、サーブレット、JSPの開発』のWelcomeファイルの構成に関する項を参照してください。

Apacheユーザー向けのノート: StrongholdバージョンまたはRavenバージョンを使用する場合は、このパラメータをIfModuleブロック内ではなくLocationブロック内で定義します。

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の設定に関係なく、プラグインによってデータがメモリーに読み込まれ、必要に応じて、フェイルオーバー時にセカンダリへの複写に使用されます。

KeepAliveEnabled

デフォルト: true

プラグインとWebLogic Serverの間の接続のプールを有効化します。

  • Microsoft IISプラグインおよびHttpProxyServlet用の有効な値は、trueおよびfalseです。

  • Apache HTTPサーバー用の有効な値は、ONおよびOFFです。

    Apache prefork mpmの使用中に、Apache Webサーバーが失敗する可能性があります。prefork mpmの使用時にはKeepAliveEnabledをOFFに設定するか、Apacheでworker mpmを使用します。

ノート:

KeepAliveEnabledとHTTP/2の両方がバックエンド接続用に構成されている場合、次のメッセージが生成されます。

HTTP/2接続が有効になっているため、KeepAliveEnabledオプションは無視されます

KeepAliveSecs

デフォルト: 20

プラグインとWebLogic Serverとの間のアクティブでない接続が閉じられるまでの時間。このパラメータを有効にするには、KeepAliveEnabledをtrue (Apache HTTP Serverを使用している場合はON)に設定する必要があります。

このパラメータの値は、管理コンソールの「サーバー/HTTP」タブで設定される「期間」フィールドの値以下、またはサーバーMBeanでKeepAliveSecs属性によって設定される値以下である必要があります。

MaxPostSize

デフォルト: 0

POSTデータの最大許容サイズ(バイト単位)。コンテンツ長がMaxPostSizeを超えている場合は、プラグインによってエラー・メッセージが返されます。0に設定した場合、POSTデータのサイズはチェックされません。これは、POSTデータを使用してサーバーを過負荷状態にしようとするサービス拒否攻撃を防ぐために役立ちます。

PathPrepend

デフォルト: null

RFC仕様のとおり、URLの一般的な構文は次のようになります。

[PROTOCOL]://[HOSTNAME]:{PORT}/{PATH}/{FILENAME};{PATH_PARAMS}/{QUERY_STRING}...

PathPrependは、PathTrimの値が切り捨てられてからリクエストがWebLogic Serverに転送されるまでの間に、プラグインによって元のURLの{PATH}部分の先頭に付加されるパスを指定します。

ファイル名を付加する必要がある場合は、PathPrependではなくDefaultFileNameパラメータを使用してください。

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を併用することで、このパスを変更できます。

SecureProxy

デフォルト: OFF

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

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

WebLogicHost

単一のWebLogic Serverにプロキシする場合は必須

デフォルト: なし

HTTPリクエストの転送先となるWebLogic Serverホスト(または、WebLogic Serverで定義されている仮想ホスト名)。WebLogicクラスタを使用している場合は、WebLogicHostではなくWebLogicClusterパラメータを使用します。

WebLogicPort

単一のWebLogic Serverにプロキシする場合は必須

デフォルト: なし

WebLogic Serverホストでプラグイン(または他のサーバー)からの接続リクエストをリスニングするポート(プラグインとWebLogic Serverとの間でSSLを使用している場合は、このパラメータをSSLリスニング・ポートに設定し、SecureProxyパラメータをONに設定します)。

WebLogic Clusterを使用している場合は、WebLogicPortではなくWebLogicClusterパラメータを使用します。

WLCookieName

デフォルト: JSESSIONID

WebLogic Server WebアプリケーションのWebLogic ServerセッションCookieの名前を変更する場合は、プラグインのWLCookieNameパラメータを同じ値に変更する必要があります。WebLogicセッションCookieの名前は、WebLogic固有のデプロイメント記述子である、weblogic.xml内の<session-descriptor>要素で設定されます。

WLIOTimeoutSecs

HungServerRecoverSecsの新しい名称。

デフォルト: 120

WebLogic Serverからのリクエストへのレスポンスに対するプラグインの待機時間を定義します。プラグインは、WLIOTimeoutSecsで指定されている秒数までサーバーからのレスポンスを待機した後、サーバー無応答を宣言し、次のサーバーにフェイルオーバーします。値は大きい値に設定する必要があります。この値をサーブレットの処理時間より短くした場合は、予期しない結果が発生する場合があります。

最小値: 10

最大値: 2147483647

WLLogFile

デフォルト: 「Debug」パラメータを参照

DebugパラメータがONに設定されている場合に生成されるログ・ファイルのパスとファイル名を指定します。このディレクトリは、このパラメータを設定する前に作成する必要があります。

非推奨パラメータを使用しないロギング設定の詳細は、「Apache HTTPサーバーの非推奨ディレクティブ」を参照してください。

WLProxyPassThrough

デフォルト: OFF

プロキシの連鎖が設定されており、プロキシ・プラグインまたはHttpClusterServletが他のプロキシまたはロード・バランサの背後で実行されている場合は、WLProxyPassThroughパラメータを明示的に有効にする必要があります。このパラメータによって、ヘッダーはプロキシの連鎖に渡されるようになります。

WLProxySSL

デフォルト: OFF

次の条件に該当する場合にプラグインとWebLogic Serverとの間のSSL通信を維持するには、このパラメータをONに設定します。

  • HTTPクライアントのリクエストでHTTPSプロトコルが指定されています。

  • 1つ以上のプロキシ・サーバー(Oracle WebLogic Serverプロキシ・プラグインを含む)を経由してリクエストが渡されています

  • プラグインとWebLogic Serverとの間の接続でHTTPプロトコルが使用されています。

WLProxySSLをONにすると、WebLogic Serverからクライアントに戻されるロケーション・ヘッダーでHTTPSプロトコルが指定されます。

WLProxySSLPassThrough

デフォルト: OFF

Webサーバーとプラグインより前にデプロイされたロード・バランサまたはその他のソフトウェアがSSLの終端点となっており、その製品において、クライアントからの接続がSSLを介すかどうかに基づいてWL-Proxy-SSLリクエスト・ヘッダーがtrueまたはfalseに設定されている場合は、SSLの使用がOracle WebLogic Serverに渡されるよう、WLProxySSLPassThroughをONに設定します。

プラグインが動作するWebサーバーにSSLの終端点があるか、ロード・バランサでWL-Proxy-SSLが設定されていない場合は、WLProxySSLPassThroughをOFF (デフォルト)に設定します。