Oracle® Fusion Middleware

Oracle WebLogic Server 1.1におけるWebサーバー・プラグインの使用

11gリリース1(11.1.1)

B61009-08(原本部品番号:E37889-03)

2016年12月

このドキュメントでは、WebサーバーからOracle WebLogic Serverへのリクエストのプロキシのために提供される、バージョン1.1プラグインの使用について説明します。このドキュメントは、主にWebLogic Serverアプリケーション・プラットフォームおよびその様々なサブシステムを管理するシステム管理者を対象としています。

Oracle Fusion Middleware Oracle WebLogic ServerにおけるWebサーバー1.1プラグインの使用, 11gリリース1 (11.1.1)

B61009-08

Copyright © 2007, 2016, Oracle and/or its affiliates.All rights reserved.

原本著者: Srinivas Sudhindra

原本協力者: Seema Alevoor、Jeff Trawick、Yulong Shi、Edwin Spear

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- ドキュメントのアクセシビリティについて

- 表記規則

1 Webサーバー1.1プラグインの概要

- 1.1 Webサーバー・プラグインとは

- 1.1.1 接続プーリングとキープ・アライブ

- 1.1.2 リクエストのプロキシ

- 1.2 バージョン1.1プラグインの入手方法

- 1.3 1.0プラグインからのアップグレード

- 1.4 バージョン1.1プラグインの機能

- 1.4.1 標準暗号化強度が許容する簡潔なネーミング

- 1.4.2 バージョン1.1プラグインでのOracleセキュリティ・フレームワークの使用

- 1.4.3 バージョン1.1プラグインでのIPv6のサポート

- 1.4.4 バージョン1.1プラグインでの双方向SSLのサポート

- 1.5 サポートおよびパッチ適用

2 Oracle HTTP Server用のmod_wl_ohsプラグインの構成

- 2.1 mod_wl_ohsの構成の前提条件

- 2.2 Fusion Middleware Controlを使用したmod_wl_ohsの構成

- 2.3 手動でのmod_wl_ohsの構成

- 2.4 mod_wl_ohsのSSLの構成

3 Oracle iPlanet Web Serverプラグインのインストールと構成

- 3.1 Oracle iPlanet Web Serverプラグインの概要

- 3.2 Oracle iPlanet Web Serverプラグインのインストールと構成

- 3.2.1 インストールの前提条件

- 3.2.2 Oracle iPlanet Web Serverプラグインのインストール

- 3.2.3 Oracle iPlanet Web Serverプラグインの構成

- 3.2.3.1 URLによるリクエストのプロキシ

- 3.2.3.2 MIMEタイプによるリクエストのプロキシ

- 3.2.3.3 プラグインのテスト

- 3.2.4 例: iPlanetプラグインの構成

- 3.2.5 obj.confファイルの変更のガイドライン

- 3.2.6 obj.confファイルのサンプル(WebLogicクラスタを使用しない場合)

- 3.2.7 obj.confファイルのサンプル(WebLogicクラスタを使用する場合)

4 Apache HTTP Serverプラグインのインストールと構成

- 4.1 Apache HTTPサーバー・プラグインのインストール

- 4.1.1 インストールの前提条件

- 4.1.2 Apache HTTPサーバー・プラグインのインストール

- 4.2 Apache HTTPサーバー・プラグインの構成

- 4.2.1 httpd.confファイルの編集

- 4.2.1.1 LocationブロックまたはVirtualHostブロック内へのWebLogicプロパティの配置

- 4.2.1.2 例: Apacheプラグインの構成

- 4.2.2 weblogic.confファイルのhttpd.confファイルへのインクルード

- 4.2.2.1 weblogic.confファイルの作成

- 4.2.2.2 weblogic.conf構成ファイルのサンプル

- 4.2.2.3 Apache HTTPサーバーのhttpd.confファイルのテンプレート

5 Microsoft IISプラグインのインストールと構成

- 5.1 Microsoft Internet Information Serverプラグインのインストールと構成

- 5.1.1 例: IISプラグインの構成

- 5.2Microsoft Internet Information Server IIS 7.0プラグインのインストールと構成

- 5.3 Webサーバーからの静的ファイルの提供

- 5.4 ワイルドカード・アプリケーション・マッピングを使用したパスによるプロキシ

- 5.4.1 ワイルドカード・アプリケーション・マッピングのインストール(IIS 6.0)

- 5.4.2 IIS 7.5用のワイルドカード・スクリプト・マップの追加

- 5.5 複数の仮想WebサイトからWebLogic Serverへのリクエストのプロキシ

- 5.5.1 iisproxy.iniファイルのサンプル

- 5.6 IISを介したACLの作成

- 5.7 インストールのテスト

6 共通の構成タスク

- 6.1 プラグインでのSSLの使用

- 6.1.1 SSL用のライブラリの構成

- 6.1.2 一方向SSL用のプラグインの構成

- 6.1.3 プラグインとOracle WebLogic Serverとの間の双方向SSLの構成

- 6.2 プラグインでのIPv6の使用

- 6.3 境界認証の設定

- 6.4 接続エラーとクラスタリング・フェイルオーバーの理解

- 6.4.1 接続障害についての考えられる原因

- 6.4.2 Connection_Refusedエラーを減らすためのヒント

- 6.4.3 クラスタ化されていない単一のWebLogic Serverでのフェイルオーバー

- 6.4.4 動的サーバー・リスト

- 6.4.5 フェイルオーバー、CookieおよびHTTPセッション

- 6.4.6 Oracle iPlanet Web ServerプラグインでのSSLの使用

- 6.4.7 ファイアウォールとロード・ディレクタを使用する場合のフェイルオーバー動作

- 6.5 WebLogicプロキシ・プラグインおよびOracle WebLogic ServerでのSSLの構成

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

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

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

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

はじめに

ここでは、『Oracle WebLogic ServerにおけるWebサーバー1.1プラグインの使用』で使用されるドキュメントのアクセシビリティ機能と表記規則について説明します。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

サポートをご購入のOracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info) か、聴覚に障害のあるお客様は (http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 Webサーバー1.1プラグインの概要

次の各項では、WebLogic Serverで使用するためオラクル社が提供するプラグインについて説明します。

- 第1.1項 「Webサーバー・プラグインとは」

- 第1.2項「バージョン1.1プラグインの入手方法」

- 第1.3項 「1.0プラグインからのアップグレード」

- 第1.4項 「バージョン1.1プラグインの機能」

- 第1.5項 「サポートおよびパッチ適用」

1.1 Webサーバー・プラグインとは

Webサーバー・プラグインを使用すると、Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTPサーバーまたはMicrosoft Internet Information Server (IIS)からOracle WebLogic Serverへリクエストをプロキシできます。こうしてプラグインによりHTTPサーバーとWebLogic Server上にデプロイされたアプリケーションとの通信が可能になります。

プラグインによって、HTTPサーバー・インストールが拡張され、動的な機能を必要とするリクエストをOracle WebLogic Serverで処理できるようになります。つまり、一般には、HTMLページなどの静的ページがHTTPサーバーによって提供される一方で、HTTPサーブレットやJava Server Page (JSP)などの動的ページがOracle WebLogic Serverによって提供されるようにするプラグインを使用することになります。

Oracle WebLogic Serverは、別のプロセス(場合によっては別のホスト上)で動作している場合があります。エンド・ユーザーには(つまり、ブラウザでは)、HTTPリクエストがOracle WebLogic Serverへ委任されても、これがHTTPサーバーから送信されているように見えます。

また、WebLogicクライアント・サーバー・プロトコルのHTTPトンネリング機能は、このプラグインを介して動作しており、すべてのOracle WebLogic Serverサービスへのアクセスを提供します。

1.1.1 接続プーリングとキープ・アライブ

プラグインでは、プラグインからOracle WebLogic Serverへの接続のプールを使用してパフォーマンスを向上させます。このプラグインでは、同一プラグインからの後続リクエストに同じ接続を再利用することで、プラグインとOracle WebLogic Serverとの間でHTTP 1.1キープ・アライブ接続が実施されます。接続は、20秒(またはユーザー定義の時間)が経過してもアクティブにならない場合は閉じられます。詳細は、表7-1の「KeepAliveEnabled」を参照してください。

注意:
クライアント接続はWebサーバーによって管理されます。

1.1.2 リクエストのプロキシ

プラグインは、指定した構成に基づいてOracle WebLogic Serverへリクエストをプロキシします。

- リクエストのURL (またはURLの一部)に基づいて、リクエストをプロキシできます。これをパスによるプロキシと呼びます。

- リクエストされたファイルのMIMEタイプに基づいてリクエストをプロキシすることもでき、これをファイル拡張子によるプロキシと呼びます。

両方の方法を有効にすることもできます。両方の方法を有効にし、リクエストが両方の条件に一致した場合は、そのリクエストはパスによってプロキシされます。

また、これらの各リクエスト・タイプに、プラグインのその他の動作を定義するその他のパラメータも指定できます。

1.2 バージョン1.1プラグインの入手方法

次のWebサーバー用のバージョン1.1プラグインが入手可能です。

表1-1 バージョン1.1プラグインの入手方法

Webサーバー

プラグインの入手方法

参照

Oracle HTTP Server 11gR1

プラグインはOracle HTTP Serverのインストールに含まれています。このプラグインの構成の詳細は、第2章「Oracle HTTP Server用mod_wl_ohsプラグインの構成」を参照してください。

第2章「Oracle HTTP Server用のmod_wl_ohsプラグインの構成」を参照してください。

Oracle iPlanet Web Server (リリース7.0.9以降)

Apache HTTPサーバー2.2.x

Microsoft Internet Information Server (IIS) 6.0から7.5

プラグインは、My Oracle Support (http://support.oracle.com)およびSoftware Delivery Cloud (http://edelivery.oracle.com)のWebサイトから、必要なバイナリ・ファイルおよびヘルパー・ファイルを含むzipファイルとしてダウンロードできます。

たとえば、mod_wl.soというプラグイン・ディストリビューションには次のディレクトリが含まれています。Windows版では、DLLファイルが用意されています。

- lib/mod_wl.so (Apache HTTPサーバー・プラグイン)

- lib/*.soまたはlib\*.dll (ネイティブ・ライブラリ)

- bin/orapkiまたはbin\orapki.cmd (orapkiツール)

- jlib/*.jar (orapki用Javaヘルパー・ライブラリ)

Apache HTTPサーバー、Microsoft IISおよびOracle iPlanet Web Serverのインストールと構成の詳細は、次の章を参照してください。

- 第3章「Oracle iPlanet Web Serverプラグインのインストールと構成」

- 第4章「Apache HTTP Serverプラグインのインストールと構成」

- 第5章「Microsoft IISプラグインのインストールと構成」

1.3 1.0プラグインからのアップグレード

「Oracle WebLogic ServerでのWeb Serverプラグインの使用」で説明しているバージョン1.0プラグインは非推奨であり、Oracle WebLogic Serverの将来のバージョンでは提供されない可能性があります。

バージョン1.1プラグインに置き換えることをお薦めします。

注意:
Apache HTTPサーバー1.3.xまたは2.0.xでは、バージョン1.0プラグインを使用してください。

バージョン1.1プラグインはバージョン1.0プラグインのスーパーセットであり、既存の機能をサポートしています。ただし、アップグレードの際には、次の考慮事項に留意してください。

- サポート対象プラットフォームのリストが変更されています。詳細は、次の場所にある「Oracle Fusion Middlewareでサポートされているシステム構成」を参照してください。
http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

- 128ビットの暗号化を使用している場合は、第1.4.1項「標準暗号化強度が許容する簡潔なネーミング」で説明されているように、新しい命名規則を反映するよう構成ファイルを変更する必要があります。たとえば、mod_wl128_22.soをmod_wl.soに変更する必要があります。

1.4 バージョン1.1プラグインの機能

この項では、1.0プラグインと比較してバージョン1.1プラグインで追加された機能を説明します。

- 第1.4.1項「標準暗号化強度が許容する簡潔なネーミング」

- 第1.4.2項「バージョン1.1プラグインでのOracleセキュリティ・フレームワークの使用」

- 第1.4.3項「バージョン1.1プラグインでのIPv6のサポート」

- 第1.4.4項「バージョン1.1プラグインでの双方向SSLのサポート」

1.4.1 標準暗号化強度が許容する簡潔なネーミング

バージョン1.0プラグインは、40ビット暗号化と128ビット暗号化の両方の標準をサポートしていたため、サポートされる標準をプラグインのファイル名で識別する必要がありました。たとえば、mod_wl_22.soは40ビットの暗号化を表し、mod_wl128_22.soは128ビットの暗号化を表します。

ただし、バージョン1.1プラグインは128ビット暗号化のみをサポートし、プラグイン名は簡略化されるようになりました。たとえば、mod_wl.soが、必要な唯一のファイル名となります。

注意:
128ビット暗号化を使用していた場合は、1.0プラグインからアップグレードすると、新しい命名規則を反映するよう構成ファイルを変更する必要があります。たとえば、mod_wl128_22.soをmod_wl.soに変更する必要があります。

1.4.2 バージョン1.1プラグインでのOracleセキュリティ・フレームワークの使用

バージョン1.1プラグインでは、Oracle認証済セキュリティ・ネットワークを使用し、そのためOracleウォレットを使用してSSL構成情報を格納できます。

このような理由から、バージョン1.1プラグインでは、Oracleウォレットを使用するためにSSL構成パラメータWLSSLWalletが導入されています。

プラグイン・バイナリ・ファイルとともに提供されるコマンド行ツールで、Oracleウォレットに証明書を構成できます。SSLの構成の詳細は、第6.1項「プラグインでのSSLの使用」を参照してください。

1.4.3 バージョン1.1プラグインでのIPv6のサポート

バージョン1.1プラグインでは、IPv6がサポートされています。WebLogicHost構成パラメータおよびWebLogicCluster構成パラメータ(表7-1を参照)によって、IPv6アドレスがサポートされるようになりました。

詳細は、第6.2項「プラグインでのIPv6の使用」を参照してください。

1.4.4 バージョン1.1プラグインでの双方向SSLのサポート

バージョン1.1プラグインでは、クライアントIDの検証のために双方向SSLがサポートされています。双方向SSLは、ハンドシェイク・プロセスにおいてWebLogic Serverからクライアント証明書がリクエストされると、自動的に有効になります。

詳細は、第6.1項「プラグインでのSSLの使用」を参照してください。

1.5 サポートおよびパッチ適用

プラグインに関して問題が発生した場合は、ご使用のプラグインのバージョンを必ずお知らせください。この情報は、Apacheのログや、プラグインのデバッグ・ログ(構成してある場合)で確認できます。バージョン情報は、次のように示されます。

WebLogic Server Pluginバージョン1.1、 <WLSPLUGINS_XXXX_XXXX_XXXXX.XXXX>

注意:
Linux用のApache Webサーバーでは、次のコマンドを実行してプラグインのバージョンを確認することもできます。

$ strings ${PLUGIN_HOME}/lib/mod_wl.so | grep -i wlsplugins

プラグインのパッチには、通常、置き換えられる1つ以上の共有オブジェクトが含まれています。パッチ内の共有オブジェクトに置き換える前に、必ず元のファイルをバックアップしてください。ログ内のバージョン文字列を確認して、パッチが正常に適用されていることを検証してください。

2 Oracle HTTP Server用のmod_wl_ohsプラグインの構成

この章では、Oracle HTTP ServerからOracle WebLogic Serverへのリクエストのプロキシ用のプラグインである、mod_wl_ohsの構成方法を説明します。mod_wl_ohsモジュールはOracle HTTP Serverのインストールに含まれています。別途ダウンロードしてインストールする必要はありません。

注意:
mod_wl_ohsには、Apache HTTPサーバー用のプラグインと同じ機能が用意されています。

mod_wl_ohsを構成するには、Fusion Middleware Controlを使用するか、またはmod_wl_ohs.conf構成ファイルを手動で編集します。

この章には次のトピックが含まれます:

- 第2.1項「mod_wl_ohsの構成の前提条件」

- 第2.2項「Fusion Middleware Controlを使用したmod_wl_ohsの構成」

- 第2.3項「手動でのmod_wl_ohsの構成」

- 第2.4項「mod_wl_ohsのSSLの構成」

2.1 mod_wl_ohsの構成の前提条件

mod_wl_ohsを構成する前に、次のことを行ってください。

- Oracle WebLogic Serverがインストールされ、ドメインが作成されており、Oracle WebLogic Serverの管理コンソールにアクセスできることを確認します。

- Fusion Middleware Controlがインストールされており、Enterprise Managerコンソールにアクセスできることを確認します。これは、Fusion Middleware Controlに用意されているグラフィカル・インタフェースを使用してmod_wl_ohsを構成する場合に必要になります。

- 構成をテストできるようにするには、必要なJavaアプリケーションがOracle WebLogic Server (単一の管理対象サーバーまたはクラスタ)にデプロイされており、アクセス可能であることを確認します。

- バックエンドのOracle WebLogic Serverインスタンスがバージョン10.3.4以降の場合は、「WebLogicプラグインの有効化」パラメータを設定する必要があります。

1. Oracle WebLogic Server管理コンソールにログインします。

2. 「ドメイン構造」ペインで「環境」ノードを開きます。

- Oracle HTTP Serverからリクエストをプロキシするサーバー・インスタンスがクラスタにある場合は、「クラスタ」を選択します。

- それ以外の場合は、「サーバー」を選択します。

3. Oracle HTTP Serverからリクエストをプロキシするサーバーまたはクラスタを選択します。

「構成」→「一般」タブが表示されます。

4. 下にスクロールして「詳細」セクションを開き、「WebLogicプラグインの有効化」チェック・ボックスを選択します。

5. 手順2で「サーバー」を選択した場合は、Oracle HTTP Serverからのリクエストをプロキシするその他のサーバーに対して手順3と4を繰り返します。

6. 「保存」をクリックします。

変更内容を有効にするには、サーバー・インスタンスを再起動する必要があります。

2.2 Fusion Middleware Controlを使用したmod_wl_ohsの構成

Fusion Middleware Controlを使用してmod_wl_ohsモジュールを構成するには、次の手順を実行します。

1. 第2.1項で示された前提条件を満たしていることを確認します。

2. 「Oracle HTTP Server」メニューから「管理」を選択します。

3. 「管理」メニューで「mod_wl_ohs構成」を選択します。「mod_wl_ohs構成」ページが表示されます。

4. オンライン・ヘルプで説明しているように構成設定を指定します(オンライン・ヘルプはページ上のヘルプ・アイコンをクリックして起動できます)。

5. 設定を確認します。
設定に問題がない場合、「適用」をクリックして変更を適用します。設定に問題がある場合、または変更を適用しない場合、「元に戻す」をクリックして元の設定に戻します。

6. Oracle HTTP Serverメニューで「制御」→「起動」を選択し、Oracle HTTP Serverを再起動します。

mod_wl_ohsモジュール構成が保存され、「mod_wl_ohs構成」ページに表示されます。

2.3 手動でのmod_wl_ohsの構成

mod_wl_ohsを手動で構成するには、mod_wl_ohs.confファイルにディレクティブを指定します。

1. 第2.1項で示された前提条件を満たしていることを確認します。

2. 次のディレクトリに配置されているmod_wl_ohs.confファイルをテキスト・エディタで開きます。

ORACLE_INSTANCE/config/OHS/component_name

3. <IfModule weblogic_module>要素を見つけます。

4. 次に示すように、構成ファイルの<IfModule weblogic_module>要素内にディレクティブを追加します。

注意:
事前定義済の<IfModule weblogic_module>要素内でディレクティブを指定することをお薦めします。
事前定義済の<IfModule weblogic_module>要素の外や、追加された<IfModule weblogic_module>要素内、またはmod_wl_ohs.conf以外の構成ファイル内でディレクティブを指定した場合、mod_wl_ohsモジュールは機能したとしても、Fusion Middleware Controlで表示されるモジュールの構成状態は、mod_wl_ohs.conf構成ファイル内で指定したディレクティブと矛盾する可能性があります。

- 単一のOracle WebLogic Serverインスタンス上で実行されるアプリケーションにリクエストを転送するには、その宛先サーバーの詳細を<location>要素内で指定します。
構文:

<IfModule weblogic_module>
<Location path>
SetHandler weblogic-handler
WebLogicHost host
WeblogicPort port
</Location>
</IfModule>

例:

次のように構成すると、Oracle HTTP Serverのリスニング・ポートで受信された/myapp1 URIのリクエストは、リスニング・ポートlocalhost:7001のOracle WebLogic Serverの/myapp1に転送されます。

<IfModule weblogic_module>
<Location /myapp1>
SetHandler weblogic-handler
WebLogicHost localhost
WeblogicPort 7001
</Location>
</IfModule>

- Oracle WebLogic Serverインスタンスのクラスタ上で実行されているアプリケーションにリクエストを転送するには、その宛先クラスタの詳細を新しい<location>要素内で指定します。
構文:

<IfModule weblogic_module>
<Location path>
SetHandler weblogic-handler
WebLogicCluster host:port,host:port,...
</Location>
</IfModule>

例:

次のように構成すると、Oracle HTTP Serverリスニング・ポートで受信された/myapp2 URIのリクエストは、リスニング・ポートlocalhost:8002およびlocalhost:8003の管理対象サーバーを含むOracle WebLogic Serverクラスタ/myapp2へ転送されます。

<IfModule weblogic_module>
<Location /myapp2>
SetHandler weblogic-handler
WebLogicCluster localhost:8002,localhost:8003
</Location>
</IfModule>

- 単一のOracle WebLogic Serverインスタンス上で実行されているアプリケーションとクラスタ上で実行されている別のアプリケーションなど、複数の宛先を構成するには、各宛先を個別の<location>子要素内で指定する必要があります。次の構文で示すように、<IfModule weblogic_module>要素内のすべての<location>子要素は同じレベルに存在する必要があります。

<IfModule weblogic_module>

#For an application running on a single server instance
<Location path1>
SetHandler weblogic-handler
WebLogicHost host
WeblogicPort port
</Location>

#For an application running on a cluster
<Location path2>
SetHandler weblogic-handler
WebLogicCluster host:port,host:port,...
</Location>

</IfModule>

mod_wl_ohs.confファイル内で指定できるその他のディレクティブの詳細は、第7章「Webサーバー・プラグインのパラメータ」を参照してください。

5. 次のコマンドを使用してOracle HTTP Serverを再起動します。

> $ORACLE_INSTANCE/bin/opmnctl startproc ias-component=component_name

2.4 mod_wl_ohsのSSLの構成

Oracle HTTP ServerとOracle WebLogic Serverとの間で一方向SSLおよび双方向SSLをサポートするmod_wl_ohsの構成に関する情報は、『Oracle Fusion Middleware管理者ガイド』のOracle HTTP Serverからのアウトバウンド・リクエストのSSLの有効化に関する項を参照してください。

3 Oracle iPlanet Web Serverプラグインのインストールと構成

この章では、Oracle iPlanet Web Serverプラグインをインストールして構成する方法を説明します。以前のリリースでは、このプラグインはNetscape Enterprise Serverプラグインと呼ばれていました。

この章には次の項が含まれます:

- 第3.1項「Oracle iPlanet Web Serverプラグインの概要」

- 第3.2項「Oracle iPlanet Web Serverプラグインのインストールと構成」

3.1Oracle iPlanet Web Serverプラグインの概要

Oracle iPlanet Web Server用プラグインでは、リクエストをOracle iPlanet Web ServerからOracle WebLogic Serverへプロキシできます。このプラグインによって、WebLogic Serverの動的な機能を必要とするリクエストをWebLogic Serverで処理できるようにすることで、Oracle iPlanet Web Serverのインストールが拡張されます。

Oracle iPlanet Web Serverプラグインは、静的ページがOracle iPlanet Web Serverによって提供され、JSPや、HTTPサーブレットで生成されたページなどの動的ページの提供をOracle WebLogic Serverのインスタンス(別のプロセスで、場合によっては別のマシン上で動作)が委任される環境用に設計されています。WebLogic ServerとOracle iPlanet Web Serverプラグインは、クリア・テキストまたはSecure Sockets Layer (SSL)を使用して接続されます。エンド・ユーザーには(つまり、ブラウザでは)、WebLogic Serverへ委任されるHTTPリクエストは、静的ページと同じソースに由来しているように見えます。また、WebLogic ServerのHTTPトンネリング機能もOracle iPlanet Web Serverプラグインを介して動作すると、動的ページのみでなく、すべてのWebLogic Serverサービスへのアクセスを提供できます。

Oracle iPlanet Web Serverプラグイン12.1.3は、Oracle iPlanet Web Server内のモジュールとして機能します。モジュールは起動時にロードされ、その後、構成に基づいて特定のHTTPリクエストがモジュールへ委任されます。

Oracle iPlanet Web Serverの詳細は、http://download.oracle.com/docs/cd/E18958_01/doc.70/e18789/chapter.htmを参照してください。

3.2 Oracle iPlanet Web Serverプラグインのインストールと構成

次の各項では、Oracle iPlanet Web Serverプラグインのインストール前提条件および構成方法について説明します。

3.2.1 インストールの前提条件

Oracle iPlanet Web Serverプラグインをインストールする前に、次のことを行ってください。

- プラグインのzipを解凍する場所(PLUGIN_HOME(たとえば、/home/myhome/weblogic-plugins-1.1/))を作成します。

- 第1.2項「バージョン1.1プラグインの入手方法」の説明に従って、Oracle iPlanet Web Serverプラグインをダウンロードします。

- プラグインのzipディストリビューションをWebサーバーのインストール・ディレクトリ(install-dir)に解凍します。プラグインのzipディストリビューションを解凍する前に、install-dir内の既存のREADME.txtの名前を変更してください。このディストリビューションには、次のようなファイルが含まれています。

表3-1 Oracle iPlanet Web ServerプラグインのZipに含まれているファイル

(パス)/ファイル名

説明

README.txt

このディストリビューションに固有の情報、最新の更新およびその他の正誤表

bin/orapki (Windowsでは.bat)

Oracleウォレットを構成するためのorapkiツール

jlib/*.jar

orapkiヘルパーJavaライブラリ

lib/mod_wl.so(Windowsでは.dll)

WebLogicプロキシ・モジュール

lib/*.so(.dll)

ヘルパー・ライブラリ

- SSLを使用する場合は、JDK 7をインストールします。orapkiユーティリティを使用する場合は、JDK 7のインストールが必要です。orapkiユーティリティでは、SSLで使用するための、ウォレットや証明書失効リストなどの公開鍵インフラストラクチャ(PKI)要素を管理します。

- IPLANET_HOMEにインストールされたサポート済Oracle iPlanet Web Serverインストール環境(7.0.9以降)を作成しました。つまり、iplanet-host:iplanet-portをリスニングするiPlanetサーバーです。
バージョン1.1プラグインは、http://www.oracle.com/technology/software/products/ias/files/fusion_certification.htmlで説明されているOracle iPlanet Web Serverプラットフォーム上でサポートされます。

- iPlanetインスタンスの場所(INSTANCE-DIR(たとえば、${IPLANET_HOME}/https-foo))を作成します。

- サポートされているバージョンのWebLogic Serverを構成し、ターゲット・システム上で実行します。このサーバーは、プラグインのzipディストリビューションを解凍したシステム上で実行する必要はないことに注意してください。WebLogic Serverのサポートされているバージョンについては、次のサイトを参照してください。
http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html

3.2.2 Oracle iPlanet Web Serverプラグインのインストール

Oracle iPlanet Web Serverプラグインは、UNIXプラットフォームでは共有オブジェクト(.so)として、WindowsではDLL(.dll)として配布されます。

Oracle iPlanet Web Serverに、モジュールとしてネイティブ・ライブラリ(UNIXまたはWindows)をロードするよう指示するには、magnus.confファイルに次の行を追加します。

Init fn="load-modules" shlib="mod_wl.so"

magnus.confファイルはINSTANCE-DIR/configディレクトリにあります。ここでのINSTANCE-DIRは、Webサーバー・インスタンスのディレクトリです。詳細は、次の章を参照してください。

http://download.oracle.com/docs/cd/E19146-01/821-1827/821-1827.pdf

3.2.3 Oracle iPlanet Web Serverプラグインの構成

この項では、Oracle iPlanet Web Serverプラグインの構成について説明します。

obj.confファイルを見つけて開きます。

デフォルトのobj.confファイルは、INSTANCE-DIR/configディレクトリにあります。ここでのINSTANCE-DIRは、Webサーバー・インスタンスのディレクトリです。
詳細は、次を参照してください。

http://download.oracle.com/docs/cd/E19146-01/821-1827/821-1827.pdf

obj.confファイルを構成する方法は複数あります。

第3.2.5項「obj.confファイルの変更のガイドライン」を参照してください。obj.confファイルでは、WebLogic Serverにプロキシされるリクエストや他の構成情報を定義します。

3.2.3.1 URLによるリクエストのプロキシ

URLによりリクエストをプロキシする(「パスによるプロキシ」とも呼ぶ)には、プロキシするURLごとに別個の<Object>タグを作成し、PathTrimパラメータを定義します。文字列*/weblogic/*を含むリクエストをプロキシする、<Object>タグの例を次に示します。

<Object ppath="*/weblogic/*">
Service fn=wl-proxy WebLogicHost=myserver.com WebLogicPort=7001 PathTrim="/weblogic"
</Object>

WebLogic Serverの別々のインスタンスに送信されるリクエストを特定する、別個の2つのppathのためのオブジェクト定義の例を次に示します。

<Object ppath="*/weblogic/*">
Service fn=wl-proxy WebLogicHost=myserver.com WebLogicPort=7001 PathTrim="/weblogic"
</Object>
<Object name="si" ppath="*/servletimages/*">
Service fn=wl-proxy WebLogicHost=otherserver.com WebLogicPort=7008
</Object>

注意:
PathTrimなどの必須でないパラメータを使用すると、Oracle iPlanet Web Serverプラグインを介してppathを渡す方法を、より詳細に構成できます。プラグイン・パラメータの詳細なリストについては、第8.2項、第7.1項「Webサーバー・プラグインの一般パラメータ」を参照してください。

3.2.3.2 MIMEタイプによるリクエストのプロキシ

MIMEタイプによってリクエストをプロキシする場合は、obj.confファイルで参照されているすべての新しいMIMEタイプを、mime.typesファイルに追加します。MIMEタイプを追加するには、iPlanetサーバー・コンソールを使用するか、直接mime.typesファイルを編集します。

- 直接mime.typesファイルを編集する場合は、編集するファイルを開き、次の行を入力します。

type=text/jsp exts=jsp

- iPlanet管理コンソールでmime.typesファイルを編集する場合は、次を参照してください。
http://download.oracle.com/docs/cd/E19146-01/821-1828/gdabr/index.html

注意:
iPlanet Web Server 7.0.9以降では、すでにJSP用のMIMEタイプが定義されています。既存のMIMEタイプをmagnus-internal/jspからtext/jspに変更してください。

指定したMIMEタイプの拡張子(.jspなど)を持つすべてのリクエストを、URLに関係なく、WebLogic Serverにプロキシできます。

たとえば、すべてのJSPをWebLogic Serverにプロキシするには、次のServiceディレクティブを追加してください。

Service method="(GET|HEAD|POST|PUT)" type=text/jsp fn=wl-proxy WebLogicHost=myserver.com WebLogicPort=7001 PathPrepend=/jspfiles

このServiceディレクティブによって、拡張子が.jspのすべてのファイルが、指定されたWebLogic Serverへプロキシされます。その際、ファイルは次のようなURLで提供されます。

http://myserver.com:7001/jspfiles/myfile.jsp

PathPrependパラメータの値は、リクエストのプロキシ先となるWebLogic ServerまたはクラスタにデプロイされているWebアプリケーションのコンテキスト・ルートと一致する必要があります。

Oracle iPlanet Web Serverプラグインのエントリを追加した後、デフォルトのObject定義は次の例のようになります。

<Object name="default">
AuthTrans fn="match-browser" browser="*MSIE*" ssl-unclean-shutdown="true"
NameTrans fn="pfx2dir" from="/mc-icons" dir="/export/home/ws/lib/icons" name="es-internal"
PathCheck fn="uri-clean"
PathCheck fn="check-acl" acl="default"
PathCheck fn="find-pathinfo"
PathCheck fn="find-index" index-names="index.html,home.html
ObjectType fn="type-by-extension"
ObjectType fn="force-type" type="text/plain"
Service method="(GET|HEAD|POST|PUT)" type="text/jsp" fn="wl-proxy" WebLogicHost="myweblogic.server.com" WebLogicPort="7100"
Service method="(GET|HEAD)" type="magnus-internal/directory" fn="index-common"
Service method="(GET|HEAD|POST)" type="*~magnus-internal/*" fn="send-file"
Service method="TRACE" fn="service-trace"
AddLog fn="flex-log"
</Object>

WebLogic Serverにプロキシするその他すべてのMIMEタイプのデフォルトのオブジェクト定義に、同様のService文を追加できます。

MIMEによるプロキシが正しく機能するには、Oracle iPlanet Web ServerからのJavaを無効にする必要があります - 無効にしないと、SUN Oneが*.jspで終わるすべてのリクエストを処理しようとし、$doc_rootにリソースが見つからないため404エラーを戻すことになります。

Oracle iPlanet Web ServerでJavaを無効にするには、obj.confファイルでname="default"
の下にある #NameTrans fn="ntrans-j2ee" name="j2ee"をコメント・アウトし、Webサーバーを再起動します。次のような設定も可能です。

- パスでプロキシする場合は、HTTPトンネリングを有効にします。
weblogic.jarを使用していてt3プロトコルをトンネリングする場合は、次のオブジェクト定義をobj.confファイルに追加し、HTTPトンネリング・リクエストを処理させるWebLogic Serverホスト名とWebLogic Serverポート番号、またはWebLogicクラスタ名を置き換えてください。

<Object name="tunnel" ppath="*/HTTPClnt*"
Service fn=wl-proxy WebLogicHost=myserver.com WebLogicPort=7001
</Object>

- WebLogic Serverシン・クライアントwlclient.jarで使用される一意のプロトコルのIIOPをトンネリングする場合は、次のオブジェクト定義をobj.confファイルに追加し、HTTPトンネリング・リクエストを処理させるWebLogic Serverホスト名とWebLogic Serverポート番号、またはWebLogicクラスタ名を置き換えてください。

<Object name="tunnel" ppath="*/iiop*">
Service fn=wl-proxy WebLogicHost=myserver.com WebLogicPort=7001
</Object>

3.2.3.3 プラグインのテスト

Oracle iPlanet Web Serverプラグインをテストするには:

1. WebLogic Serverを起動します。

2. Oracle iPlanet Web Serverを起動します。Oracle iPlanet Web Serverがすでに実行されている場合は、サーバーを再起動するか、再構成する必要があります。

3. Oracle iPlanet Web Serverプラグインをテストするには、次のURLを使用します。このサンプルで示すデフォルトのWebアプリケーションに対して定義されているとおりに、デフォルトのWebLogic Server HTMLページ、ウェルカム・ファイルまたはデフォルトのサーブレットが表示される必要があります。

http://webserver_host:webserver_port/weblogic/

デフォルトWebアプリケーションの作成方法の詳細は、『Oracle WebLogic Server Webアプリケーション、サーブレット、JSPの開発』を参照してください。

3.2.4 例: iPlanetプラグインの構成

次の例では、バックエンドWebLogic Server(WLS)にリクエストをプロキシするようiPlanetプラグインを簡潔に設定するための基本的な手順を示します。

1. %IPLANET_INSTANCE_HOME%\config\magnus.confファイルを編集し、次を追加します。

...
Init fn="load-modules" shlib="%PLUGIN_HOME%\lib\mod_wl.so"
...

2. %IPLANET_INSTANCE_HOME%\config\<vs-obj.conf>ファイル(デフォルトは%IPLANET_INSTANCE_HOME%\config\obj.conf)を開き、次のコードを追加します。

...
<Object name="weblogic" ppath="*/wls/*">
Service fn="wl-proxy" WebLogicHost=<wls-host> WebLogicPort=<wls-port>
Debug="ALL" WLLogFile="C:\Temp\wl-proxy.log" DebugConfigInfo="ON"
PathTrim="/wls"
</Object>
...

obj.confの内容の構成の詳細は、第3.2.6項「obj.confファイルのサンプル(WebLogicクラスタを使用しない場合)」および第3.2.7項「obj.confファイルのサンプル(WebLogicクラスタを使用する場合)」を参照してください。

3. プロンプトで、次のコマンドを入力してPATHに%PLUGIN_HOME%\libを追加します。

set PATH=C:\myhome\weblogic-plugin-1.1\lib:...

注意:
libの内容をIPLANET_HOME\libにコピーするかIPLANET_INSTANCE_HOME\bin\startservを編集しても、PATHを更新できます。

4. プロンプトで、次のコマンドを入力してiPlanetサーバーを起動します。

%IPLANET_INSTANCE_HOME%\bin\startserv

5. ブラウザからhttp://iplanet-host:iplanet-port/mywebapp/my.jspにリクエストを送信し、レスポンスを確認します。

3.2.5 obj.confファイルの変更のガイドライン

Oracle iPlanet Web Serverプラグインを使用するには、obj.confファイルにいくつかの変更を加える必要があります。詳細は、次の章を参照してください。

http://download.oracle.com/docs/cd/E19146-01/821-1827/821-1827.pdf

3.2.6 obj.confファイルのサンプル(WebLogicクラスタを使用しない場合)

クラスタを使用しない場合にobj.confファイルに追加する必要がある行の例を次に示します。このサンプルをテンプレートとして使用し、ご使用の環境およびサーバーに合せて変更できます。#で始まる行はコメントです。

- URLによるリクエストのプロキシ

## --------------BEGIN SAMPLE obj.conf CONFIGURATION---------
# (no cluster)
# Configure which types of HTTP requests should be handled by the
# iPlanet NSAPI plug-In (and, in turn, by WebLogic). This is done
# with one or more "<Object>" tags as shown below.
# Here we configure the iPlanet plug-In module to pass requests for
# "/weblogic" to a WebLogic Server listening at port 7001 on
# the host myweblogic.server.com.
<Object ppath="*/weblogic/*">
Service fn=wl-proxy WebLogicHost=myweblogic.server.com WebLogicPort=7001 PathTrim="/weblogic"
</Object>
# Here we configure the plug-in so that requests that
# match "/servletimages/" is handled by the
# plug-in/WebLogic.
<Object name="si" ppath="*/servletimages/*">
Service fn=wl-proxy WebLogicHost=myweblogic.server.com WebLogicPort=7001
</Object>
## -------------END SAMPLE obj.conf CONFIGURATION-------------------

- MIMEタイプによるリクエストのプロキシ

This Object directive works by file extension rather than
# request path. To use this configuration, you must modify the existing line or add the following line to mime.types file.

## -----------BEGIN SAMPLE mime.types CONFIGURATION---------------------
#
# type=text/jsp exts=jsp
## ------------END SAMPLE mime.types CONFIGURATION----------------------

## -------------BEGIN SAMPLE obj.conf CONFIGURATION---------------------
# This configuration means that any file with the extension
# ".jsp" are proxied to WebLogic. Then you must add the
# Service line for this extension to the Object "default",
# which should already exist in your obj.conf file:
<Object name=default>
NameTrans fn=pfx2dir from=/ns-icons dir="c:/Export/Home/ns-icons"
NameTrans fn=pfx2dir from=/mc-icons dir="c://Export/Home/ns-icons"
NameTrans fn="pfx2dir" from="/help" dir="c:/Export/Home/manual/https/ug"
NameTrans fn=document-root root="c:/Export/Home/docs"
Service method="(GET|HEAD|POST|PUT)" type=text/jsp fn=wl_proxy WebLogicHost=myweblogic.server.com WebLogicPort=7001 PathPrepend=/jspfiles
PathCheck fn=nt-uri-clean
PathCheck fn="check-acl" acl="default"
PathCheck fn=find-pathinfo
PathCheck fn=find-index index-names="index.html,home.html"
ObjectType fn=type-by-extension
ObjectType fn=force-type type=text/plain
Service method=(GET|HEAD) type=magnus-internal/imagemap fn=imagemap
Service method=(GET|HEAD) type=magnus-internal/directory fn=index-common
Service method=(GET|HEAD) type=*~magnus-internal/* fn=send-file
AddLog fn=flex-log name="access"
</Object>
# The following directive enables HTTP-tunneling of the
# WebLogic protocol through the iPlanet plug-in.
<Object name="tunnel" ppath="*/HTTPClnt*">
Service fn=wl-proxy WebLogicHost=myweblogic.server.com WebLogicPort=7001
</Object>
#
## -------------END SAMPLE obj.conf CONFIGURATION---------------------

3.2.7 obj.confファイルのサンプル(WebLogicクラスタを使用する場合)

WebLogic Serverクラスタを使用する場合にobj.confファイルに追加する行の例を次に示します。このサンプルをテンプレートとして使用し、ご使用の環境およびサーバーに合せて変更できます。#で始まる行はコメントです。

- URLによるリクエストのプロキシ

## -------------BEGIN SAMPLE obj.conf CONFIGURATION-------------------
# (using a WebLogic Cluster)
#
# Configure which types of HTTP requests should be handled by the
# iPlanet module (and, in turn, by WebLogic). This is done
# with one or more "<Object>" tags as shown below.
# Here we configure the iPlanet module to pass requests for
# "/weblogic" to a cluster of WebLogic Servers.
<Object ppath="*/weblogic/*">
Service fn=wl-proxy WebLogicCluster="myweblogic.com:7001,yourweblogic.com:7001, theirweblogic.com:7001" PathTrim="/weblogic"
</Object>
# Here we configure the plug-in so that requests that
# match "/servletimages/" are handled by the
# plug-in/WebLogic.
<Object name="si" ppath="*/servletimages/*">
Service fn=wl-proxy WebLogicCluster="myweblogic.com:7001,yourweblogic.com:7001, theirweblogic.com:7001"
</Object>
## ----------------END OF SAMPLE obj.conf CONFIGURATION------------------

- MIMEタイプによるリクエストのプロキシ

# This Object directive works by file extension rather than
# request path. To use this configuration, you must modify the existing line or add the following line to mime.types file.:
## -----------------BEGIN SAMPLE mime.types FILE -------------------------
# type=text/jsp exts=jsp
#
## --------------------END SAMPLE mime.types------------------------------

## -------------BEGIN SAMPLE obj.conf CONFIGURATION-----------------------
# This configuration means that any file with the extension
# ".jsp" is proxied to WebLogic. Then you must add the
# Service line for this extension to the Object "default",
# which should already exist in your obj.conf file:
<Object name=default>
NameTrans fn=pfx2dir from=/ns-icons dir="c:/Export/Home/ns-icons"
NameTrans fn=pfx2dir from=/mc-icons dir="c:/Export/Home/ns-icons"
NameTrans fn="pfx2dir" from="/help" dir="c://Export/Home/manual/https/ug"
NameTrans fn=document-root root="c://Export/Home/docs"
Service method="(GET|HEAD|POST|PUT)" type=text/jsp fn=wl_proxy WebLogicCluster="myweblogic.com:7001, yourweblogic.com:7001, theirweblogic.com:7001",PathPrepend=/jspfiles
PathCheck fn=nt-uri-clean
PathCheck fn="check-acl" acl="default"
PathCheck fn=find-pathinfo
PathCheck fn=find-index index-names="index.html,home.html"
ObjectType fn=type-by-extension
ObjectType fn=force-type type=text/plain
Service method=(GET|HEAD) type=magnus-internal/imagemap fn=imagemap
Service method=(GET|HEAD) type=magnus-internal/directory fn=index-common
Service method=(GET|HEAD) type=*~magnus-internal/* fn=send-file
AddLog fn=flex-log name="access"
</Object>
# The following directive enables HTTP-tunneling of the
# WebLogic protocol through the NES plug-in.
<Object name="tunnel" ppath="*/HTTPClnt*">
Service fn=wl-proxy WebLogicCluster="myweblogic.com:7001, yourweblogic.com:7001, theirweblogic.com:7001"
</Object>
#
## -------------END SAMPLE obj.conf CONFIGURATION--------------------

4 Apache HTTP Serverプラグインのインストールと構成

この章では、Apache HTTPサーバー・プラグインをインストールして構成する方法を説明します。次の項で構成されます。

- 第4.1項「Apache HTTPサーバー・プラグインのインストール」

- 第4.2項「Apache HTTPサーバー・プラグインの構成」

注意:
Oracle HTTP ServerからOracle WebLogic Serverにリクエストをプロキシするためには、mod_wl_ohsプラグインを使用します。これはApache HTTPサーバー用のプラグインと似ていますが、別途ダウンロードしてインストールする必要はありません。mod_wl_ohsの構成の詳細は、第2章「Oracle HTTP Server用mod_wl_ohsプラグインの構成」を参照してください。

4.1 Apache HTTPサーバー・プラグインのインストール

第1.2項「バージョン1.1プラグインの入手方法」の説明に従ってApache HTTPサーバー・プラグインをダウンロードした後、それをApache HTTPサーバー・モジュールとしてApache HTTPサーバーのインストール環境にインストールできます。

4.1.1 インストールの前提条件

Apache HTTP Serverプラグインをインストールする前に、次のことを行ってください。

- 第1.2項「バージョン1.1プラグインの入手方法」の説明に従って、Apache HTTPサーバー・プラグインをダウンロードします。

- プラグインのzipを解凍する場所(PLUGIN_HOME。たとえば、/home/myhome/weblogic-plugins-1.1/)

- プラグインのzipディストリビューションをPLUGIN_HOME(たとえば、/home/myhome/weblogic-plugins-1.1/)に解凍します。このディストリビューションには、次のようなファイルが含まれています。

表4-1 Apache Webサーバー・プラグインのZipに含まれているファイル

(パス)/ファイル名

説明

README.txt

このファイル

bin/orapki.bat

Oracleウォレットを構成するためのorapkiツール

jlib/*.jar

orapkiヘルパーJavaライブラリ

lib/mod_wl.so

WebLogicプロキシ・モジュール

lib/*.so(.dll)

ヘルパー・ライブラリ

- SSLを使用する場合は、JDK 7をインストールします。SSLで使用するためにウォレットや証明書失効リストなどの公開鍵インフラストラクチャ(PKI)要素を管理するorapkiユーティリティを使用するには、JDK 7のインストールが必要です。

- サポートされているApache HTTPサーバーのインストール環境があることを確認します。

注意:
Apache HTTP Server 2.4を使用する場合は、12.1.xプラグインにアップグレードしてください。

詳細は、次を参照してください。

http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html.

- サポートされているバージョンのOracle WebLogic Serverが構成済であり、ターゲット・システム上で実行されていることを確認します。このサーバーはプラグインのzipディストリビューションを解凍したシステム上で実行する必要はないことに注意してください。サポートされているOracle WebLogic Serverのバージョンについては、次を参照してください。
http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html.

4.1.2 Apache HTTPサーバー・プラグインのインストール

Apache HTTP Serverプラグインは共有オブジェクト(.so)ファイルとして配布されます。

Apache HTTPサーバー・プラグインをインストールするには:

1. weblogic-plugins-1.1/libフォルダがUNIXシステム上のLD_LIBRARY_PATH(およびWindowsシステム上のPATH)に含まれていることを確認します。含まれていない場合は、Apache HTTPサーバーの起動時にリンケージ・エラーが表示されます。

2. ダウンロードしたプラグイン・ファイルを解凍した場所で、lib/mod_wl.soを見つけます(たとえば、/home/myhome/weblogic-plugins-1.1/lib/mod_wl.so)。

3. mod_so.cモジュールが有効になっていることを確認します。
Apacheで提供されるスクリプトを使用してApache HTTPサーバーをインストールした場合、mod_so.cはすでに有効になっています。UNIX/Linuxプラットフォームで次のコマンドを実行して、mod_so.cが有効になっていることを確認します。

APACHE_HOME/bin/apachectl -l

(APACHE_HOMEは、Apache HTTPサーバーのインストールが含まれているディレクトリです。)

注意:
apachectlコマンドはWindowsプラットフォームでは使用できません。

このコマンドによって、有効なすべてのモジュールがリスト表示されます。mod_so.cがリストにない場合は、Apache HTTPサーバーを再構築し、次の構成オプションが指定されていることを確認します。

...
--enable-module=so
...

4. バックアップとして、 APACHE_HOME/bin/httpd.confファイルのコピーを作成します。

5. httpd.confファイルを開きます。

6. Apache 2.2.x用のApache HTTPサーバー・プラグイン・モジュールをインストールするには、次の行を追加します。Windowsでは、.dllファイルを指定します。

LoadModule weblogic_module /home/myhome/weblogic-plugins-1.1/lib/mod_wl.so

7. 次のコマンドを実行して、httpd.confファイルの構文を確認します。

- Windows

APACHE_HOME\bin> apachectl -t

- UNIX/Linux

> APACHE_HOME/bin/apachectl -t

httpd.confファイルにエラーがある場合はこのコマンドの出力でエラーが表示され、それ以外の場合は次のような結果が戻されます。

Syntax OK

4.2 Apache HTTPサーバー・プラグインの構成

この項では、HTTPトンネリングを有効にし、Oracle WebLogic Serverプラグインのその他のパラメータを使用するため、httpd.confファイルを編集してパスまたはMIMEタイプによってリクエストをプロキシする方法を説明します。

4.2.1 httpd.confファイルの編集

Apache HTTPサーバー・インストールのhttpd.confファイルを編集し、Apache HTTPサーバー・プラグインを構成します。

1. httpd.confファイルを開きます(まだ開いていない場合)。

2. MIMEタイプによってリクエストをプロキシするには、次のどちらかを定義するIfModuleブロックを追加します。

- クラスタリングされていないWebLogic Serverの場合: WebLogicHostおよびWebLogicPortパラメータ

- WebLogic Serverのクラスタの場合: WebLogicClusterパラメータ

例:

<IfModule mod_weblogic.c>
WebLogicHost myweblogic.example.com
WebLogicPort 7001
Debug ALL
DebugConfigInfo ON
WLLogFile /tmp/wl-proxy.log
</IfModule>

3. MIMEタイプによってリクエストをプロキシするには、MatchExpression行をIfModuleブロックに追加します。MIMEタイプおよびパスによるプロキシの両方を有効にした場合は、パスによるプロキシがMIMEタイプによるプロキシより優先されることに注意してください。
たとえば、クラスタリングされていないWebLogic Serverに対する次のIfModuleブロックでは、MIMEタイプが.jspであるすべてのファイルがプロキシされます。

<IfModule mod_weblogic.c>
WebLogicHost my-weblogic.server.com
WebLogicPort 7001
MatchExpression *.jsp
Debug ALL
DebugConfigInfo ON
WLLogFile /tmp/wl-proxy.log
</IfModule>

次のように、複数のMatchExpressionsを使用することもできます。

<IfModule mod_weblogic.c>
WebLogicHost my-weblogic.server.com
WebLogicPort 7001
MatchExpression *.jsp
MatchExpression *.xyz
Debug ALL
DebugConfigInfo ON
WLLogFile /tmp/wl-proxy.log
</IfModule>

MIMEタイプによってWebLogic Serverのクラスタにリクエストをプロキシする場合は、WebLogicHostパラメータとWebLogicPortパラメータのかわりに、WebLogicClusterパラメータを使用します。次にその例を示します。

<IfModule mod_weblogic.c>
WebLogicCluster w1s1.com:7001,w1s2.com:7001,w1s3.com:7001
MatchExpression *.jsp
MatchExpression *.xyz
</IfModule>

4. パスによってリクエストをプロキシするには、LocationブロックおよびSetHandler文を使用します。SetHandlerは、Apache HTTPサーバー・プラグイン・モジュールのハンドラを指定します。たとえば、次のLocationブロックでは、URLに/weblogicが含まれるすべてのリクエストがプロキシされます。

<Location /weblogic>
SetHandler weblogic-handler
PathTrim /weblogic
</Location>

PathTrimパラメータには、WebLogic Serverインスタンスにリクエストを渡す前にURLの先頭から削除する文字列を指定します(第7.1項「Webサーバー・プラグインの一般パラメータ」を参照)。

5. PathTrimパラメータは、<Location>タグ内で構成する必要があります。SSLを使用するためにApacheプラグインを構成する際に、次の既知の問題が発生します

- 次の構成は正しくありません。

<Location /weblogic>
SetHandler weblogic-handler
</Location>

<IfModule mod_weblogic.c>
WebLogicHost localhost
WebLogicPort 7001
PathTrim /weblogic
</IfModule>

次の構成は正しい設定です。

<Location /weblogic>
SetHandler weblogic-handler
PathTrim /weblogic
</Location>

- WebLogic Server Apacheプラグインの現在の実装では、Apache SSLに関して複数の証明書ファイルの使用はサポートされていません。

6. オプションで、t3またはIIOPプロトコルおよびweblogic.jarのHTTPトンネリングを有効にして、次のLocationブロックをhttpd.confファイルに追加します。

<Location /bea_wls_internal/HTTPClnt>
SetHandler weblogic-handler
</Location>

7. Apache HTTPサーバー・プラグインの追加パラメータを定義します。
Apache HTTPサーバー・プラグインは、第7.1項「Webサーバー・プラグインの一般的なパラメータ」にリストされているパラメータを認識します。Apache HTTPサーバー・プラグインの動作を修正するには、次のいずれかのパラメータを定義します。

- Locationブロック(パスによるプロキシに適用されるパラメータの場合)、または

- MIMEタイプによるプロキシに適用するパラメータの場合、グローバルまたは仮想ホスト・スコープ

8. 次のコマンドをUNIX/Linuxプラットフォームで実行してhttpd.confファイルの構文を検証します。

> APACHE_HOME/bin/apachectl -t

注意:
apachectlコマンドはWindowsプラットフォームでは使用できません。

httpd.confファイルにエラーがある場合はこのコマンドの出力でエラーが表示され、それ以外の場合は次のような結果が戻されます。

Syntax OK

9. Apache HTTPサーバーを起動します。

- Windows

APACHE_HOME\bin> httpd -k start

- UNIX/Linux

> APACHE_HOME/bin/apachectl start

10. ブラウザからhttp://apache-host:apache-port/mywebapp/my.jspにリクエストを送信します。レスポンスを確認します。

4.2.1.1 LocationブロックまたはVirtualHostブロック内へのWebLogicプロパティの配置

IfModuleを使用しないようにした場合は、かわりにWebLogicプロパティを直接Locationブロック内またはVirtualHostブロック内に配置できます。次にLocationおよびVirtualHostブロックの例を示します。

<Location /weblogic>
SetHandler weblogic-handler
WebLogicHost myweblogic.server.com
WebLogicPort 7001
</Location>

<Location /weblogic>
SetHandler weblogic-handler
WebLogicCluster w1s1.com:7001,w1s2.com:7001,w1s3.com:7001
</Location>

<VirtualHost apachehost:80>
SetHandler weblogic-handler
WebLogicServer weblogic.server.com
WebLogicPort 7001
</VirtualHost>

4.2.1.2 例: Apacheプラグインの構成

次の例では、バックエンドWebLogic ServerにリクエストをプロキシするようApacheプラグインを簡潔に設定するための基本的な手順を示します。

1. ${APACHE_HOME}/conf/httpd.confファイルのコピーを作成します。

2. ファイルを編集し、次のコードを追加します。

...   LoadModule weblogic_module /home/myhome/weblogic-plugins-1.1/lib/mod_wl.so

<IfModule mod_weblogic.c>
WebLogicHost wls-host
WebLogicPort wls-port
Debug ALL
WLLogFile /tmp/wl-proxy.log
</IfModule>

<Location /mywebapp>
SetHandler weblogic-handler
</Location>
...

3. 次のコマンドを入力して、LD_LIBRARY_PATHに${PLUGIN_HOME}/libを組み込みます。

$ export LD_LIBRARY_PATH=/home/myhome/weblogic-plugin-1.1/lib:...

注意:
libの内容をAPACHE_HOME\libにコピーするか、APACHE_HOME/bin/apachectlを編集してLD_LIBRARY_PATHを更新してもPATHを更新できます。

4. プロンプトで、次のコマンドを入力してApacheサーバーを起動します。

$ ${APACHE_HOME}/bin/apachectl start

5. ブラウザからhttp://apache-host:apache-port/mywebapp/my.jspにリクエストを送信し、レスポンスを確認します。

4.2.2 weblogic.confファイルのhttpd.confファイルへのインクルード

別個の構成ファイルを複数保持する場合は、次のようにApache HTTPサーバーのIncludeディレクティブをhttpd.confファイルのIfModuleブロック内で使用することで、httpd.confという別個の構成ファイルにおいてパラメータを定義できます。

<IfModule mod_weblogic.c>
# Config file for WebLogic Server that defines the parameters
Include conf/weblogic.conf
</IfModule>

weblogic.confファイルの構文は、httpd.confファイルの構文と同じです。

この項では、weblogic.confファイルの作成方法を説明し、サンプルのweblogic.confファイルが含まれています。

4.2.2.1 weblogic.confファイルの作成

weblogic.confファイルを作成する際には、次の点に注意してください。

- パラメータをそれぞれ新しい行に入力します。パラメータとその値の間に=を挿入しないでください。次にその例を示します。

PARAM_1 value1
PARAM_2 value2
PARAM_3 value3

- IfModuleブロックのMatchExpressionで指定されたMIMEタイプとLocationブロックで指定されたパスの両方にリクエストが一致する場合は、Locationブロックで指定された動作が優先されます。

- Apache HTTPサーバーの<VirtualHost>ブロックを使用する場合は、<VirtualHost>ブロック内に仮想ホストのすべての構成パラメータ(MatchExpressionなど)を含める必要があります(http://httpd.apache.org/docs/vhosts/のApache仮想ホストに関するドキュメントを参照)。

- 環境内に構成されているすべての仮想ホストのログ・ファイルを1つのみにしたい場合は、グローバル・プロパティを使用すれば実現できます。各仮想ホストでDebug、WLLogFileおよびWLTempDirプロパティを指定するかわりに、<IfModule>タグで一度に指定できます。

- httpd.confファイルの例は次のとおりです。

<IfModule mod_weblogic.c>
WebLogicCluster johndoe02:8005,johndoe:8006
Debug ON
WLLogFile c:/tmp/global_proxy.log
WLTempDir "c:/myTemp"
DebugConfigInfo ON
KeepAliveEnabled ON
KeepAliveSecs 15
</IfModule>

<Location /jurl>
SetHandler weblogic-handler
WebLogicCluster agarwalp01:7001
</Location>

<Location /web>
SetHandler weblogic-handler
PathTrim /web
Debug OFF
WLLogFile c:/tmp/web_log.log
</Location>

<Location /foo>
SetHandler weblogic-handler
PathTrim /foo
Debug ERR
WLLogFile c:/tmp/foo_proxy.log
</Location>

- /jurl/*に一致するすべてのリクエストではDebug LevelがALLに設定され、ログ・メッセージがc:/tmp/global_proxy.logファイルに記録されます。/web/*に一致するすべてのリクエストではDebug LevelがOFFに設定され、ログ・メッセージは記録されなくなります。/foo/*に一致するすべてのリクエストではDebug LevelがERRに設定され、ログ・メッセージはc:/tmp/foo_proxy.logファイルに記録されます。

- <Files>ブロックではなくMatchExpression文を使用することをお薦めします。

4.2.2.2 weblogic.conf構成ファイルのサンプル

次のweblogic.confファイルの例をテンプレートとして使用して、ユーザーの環境およびサーバーに合うように変更できます。#で始まる行はコメントです。

例4-1 WebLogicクラスタを使用する例

# These parameters are common for all URLs which are
# directed to the current module. If you want to override
# these parameters for each URL, you can set them again in
# the <Location> or <Files> blocks. (Except WebLogicHost,
# WebLogicPort, WebLogicCluster, and CookieName.)

<IfModule mod_weblogic.c>
WebLogicCluster w1s1.com:7001,w1s2.com:7001,w1s3.com:7001
ErrorPage http://myerrorpage.mydomain.com
MatchExpression *.jsp
</IfModule>
####################################################

例4-2の、ファイル名のパターン、HTTPリクエストの転送先となるWebLogic Serverホストおよびその他の様々なパラメータを示すためのMatchExpressionパラメータ構文は、次のとおりです。

MatchExpression [filename pattern] [WebLogicHost=host] | [paramName=value]

最初のMatchExpressionパラメータではファイル名パターン*.jspを指定してから、1つのWebLogicHost名を指定しています。パイプ記号の後に続くparamName=valueの組合せでは、WebLogic Serverで接続リクエストをリスニングするポートを指定し、デバッグ・オプションも有効にします。2番目のMatchExpressionでは、ファイル名パターン*.htmlを指定し、WebLogicClusterホストおよびそのポートを特定しています。パイプ記号の後に続くparamName=valueの組合せでは、クラスタのエラー・ページを指定しています。

例4-2 複数のWebLogicクラスタを使用する例

# These parameters are common for all URLs which are
# directed to the current module. If you want to override
# these parameters for each URL, you can set them again in
# the <Location> or <Files> blocks (Except WebLogicHost,
# WebLogicPort, WebLogicCluster, and CookieName.)

<IfModule mod_weblogic.c>
MatchExpression *.jsp WebLogicHost=myHost|WebLogicPort=7001|Debug=ON
MatchExpression *.html WebLogicCluster=myHost1:7282,myHost2:7283|ErrorPage=
http://www.xyz.com/error.html
</IfModule>

例4-3に、WebLogicクラスタを使用しない例を示します。

例4-3 WebLogicクラスタを使用しない例

# These parameters are common for all URLs which are
# directed to the current module. If you want to override
# these parameters for each URL, you can set them again in
# the <Location> or <Files> blocks (Except WebLogicHost,
# WebLogicPort, WebLogicCluster, and CookieName.)
<IfModule mod_weblogic.c>
WebLogicHost myweblogic.server.com
WebLogicPort 7001
MatchExpression *.jsp
</IfModule>

例4-4に、複数の名前ベースの仮想ホストを構成する例を示します。

例4-4 複数の名前ベースの仮想ホストを構成する例

# VirtualHost1 = localhost:80
<VirtualHost 127.0.0.1:80>
DocumentRoot "C:/test/VirtualHost1"
ServerName localhost:80
<IfModule mod_weblogic.c>
#... WLS parameter ...
WebLogicCluster localhost:7101,localhost:7201
# Example: MatchExpression *.jsp <some additional parameter>
MatchExpression *.jsp PathPrepend=/test2
</IfModule>
</VirtualHost>

# VirtualHost2 = 127.0.0.2:80
<VirtualHost 127.0.0.2:80>
DocumentRoot "C:/test/VirtualHost1"
ServerName 127.0.0.2:80
<IfModule mod_weblogic.c>
#... WLS parameter ...
WebLogicCluster localhost:7101,localhost:7201
# Example: MatchExpression *.jsp <some additional parameter>
MatchExpression *.jsp PathPrepend=/test2
#... WLS parameter ...
</IfModule>
</VirtualHost>

ServerNameには一意の値を定義する必要があり、そうでない場合は、一部のプラグイン・パラメータが予想どおりに機能しません。

4.2.2.3 Apache HTTPサーバーのhttpd.confファイルのテンプレート

この項には、Apache 2.2のhttpd.confファイルのサンプルが含まれています。このサンプルをテンプレートとして使用し、ご使用の環境およびサーバーに合せて変更できます。#で始まる行はコメントです。

Apache HTTPサーバーでは大文字と小文字が区別されない点に注意してください。

例4-5 Apache 2.2のhttpd.confファイルのサンプル

####################################################
APACHE-HOME/conf/httpd.conf file
####################################################
LoadModule weblogic_module lhome/myhome/weblogic-plugins-1.1/lib/mod_wl.so

<Location /weblogic>
SetHandler weblogic-handler
PathTrim /weblogic
ErrorPage http://myerrorpage1.mydomain.com
</Location>

<Location /servletimages>
SetHandler weblogic-handler
PathTrim /something
ErrorPage http://myerrorpage1.mydomain.com
</Location>

<IfModule mod_weblogic.c>
MatchExpression *.jsp
WebLogicCluster w1s1.com:7001,w1s2.com:7001,w1s3.com:7001
ErrorPage http://myerrorpage.mydomain.com
</IfModule>

5 Microsoft IISプラグインのインストールと構成

次の項では、Microsoft Internet Information Serverプラグインをインストールして構成する方法を説明します。

- 第5.1項「Microsoft Internet Information Serverプラグインのインストールと構成」

- 第5.2項「Microsoft Internet Information Server IIS 7.0プラグインのインストールと構成」

- 第5.3項「Webサーバーからの静的ファイルの提供」

- 第5.4項「ワイルドカード・アプリケーション・マッピングを使用したパスによるプロキシ」

- 第5.5項「複数の仮想WebサイトからWebLogic Serverへのリクエストのプロキシ」

- 第5.6項「IISを介したACLの作成」

- 第5.7項「インストールのテスト」

5.1 Microsoft Internet Information Serverプラグインのインストールと構成

Microsoft Internet Information Serverプラグインをインストールするには:

1. 第1.2項「バージョン1.1プラグインの入手方法」の説明に従って、Microsoft Internet Information Serverプラグインをダウンロードします。zipファイルには、次に示すファイルが含まれています。

表5-1 Microsoft IISプラグインのZipに含まれているファイル

(パス)/ファイル名

説明

README.txt

このディストリビューションに固有の情報、最新の更新およびその他の正誤表

bin/orapki.bat

Oracleウォレットを構成するためのorapkiツール

jlib/*.jar

orapkiヘルパーJavaライブラリ

iisproxy.dll

WebLogicプロキシ・モジュール

lib/*.dll

ヘルパー・ライブラリ

2. IISからアクセス可能な使用しやすいディレクトリにiisproxy.dllファイルをコピーします。このディレクトリには、手順6で作成するiisproxy.iniファイルも格納する必要があります。

3. iisproxy.dllファイル用のユーザーの権限を設定し、IISを実行するユーザーの名前を含めます。これを行う方法の1つとして、iisproxy.dllファイル上で右クリックして権限を選択し、IISを実行する人のユーザー名を追加するやり方があります。

4. ファイル拡張子(MIMEタイプ)によるプロキシを構成する場合は、次の手順を実行してください。(MIMEタイプによる構成に加えて、あるいはそのかわりに、パスによるプロキシを構成できます。手順5を参照してください。)

1. 「スタート」メニューからInternet Information Serviceマネージャーを選択して起動します。

2. 「サービス・マネージャ」の左側のパネルでWebサイトを選択します(デフォルトは「デフォルトWebサイト」です)。

図5-1 サービス・マネージャにおけるWebサイトの選択

3. ツールバーの「再生」矢印をクリックして起動します。

4. 左側のパネルにあるWebサイトの選択を右クリックしプロパティを選択して、Webサイトのプロパティを開きます。

図5-2 選択したWebサイトのプロパティの選択

5. 「プロパティ」パネルで、「ホーム・ディレクトリ」タブを選択し、「アプリケーションの設定」セクションの「構成」ボタンをクリックします。

図5-3 「プロパティ」パネルの「ホーム ディレクトリ」タブ

6. マッピングタブの「追加」ボタンをクリックして、ファイル・タイプを追加し、それらがWebLogic Serverにプロキシされるように構成します。

図5-4 「追加」ボタンのクリックによるファイル・タイプの追加

7. 「追加」ダイアログ・ボックスを参照してiisproxy.dllファイルを探します。

8. 拡張子を、WebLogic Serverにプロキシするファイルのタイプに設定します。

9. IIS 6.0以降を構成している場合は、「ファイルの存在を確認する」チェック・ボックスの選択を解除します。この確認の動作は、以前のバージョンのIISから変更されています。以前は、iisproxy.dllファイルの存在が確認されていましたが、プロキシからリクエストされたファイルがWebサーバーのルート・ディレクトリに存在するかどうかが確認されるようになりました。この確認でファイルが見つからなかった場合は、iisproxy.dllファイルではWebLogic Serverにリクエストをプロキシできません。

10. 安全なインストールを作成するために、「ディレクトリ セキュリティ」タブで、必要に応じてメソッド除外を設定します。

11. 完了したら、「OK」をクリックして構成を保存します。この手順を、WebLogicにプロキシするファイル・タイプごとに繰り返します。

12. ファイル・タイプの構成が完了したら、「OK」ボタンをクリックして「プロパティ」パネルを閉じます。

注意:
URL内のサーバーとポートの後に追加したパス情報は、WebLogic Serverにそのまま渡されます。たとえば、IISから次のURLでファイルをリクエストする場合、
http://myiis.com/jspfiles/myfile.jsp

これはhttp://mywebLogic:7001/jspfiles/myfile.jspというURLでWebLogic Serverへプロキシされます。

注意:
アウト・オブ・プロセス・エラーを避けるため、必ず「ISAPIアプリケーションのキャッシュ」を選択してください。

5. パスによるプロキシを構成する場合は、第5.4項「ワイルドカード・アプリケーション・マッピングを使用したパスによるプロキシ」を参照してください。

6. WebLogic Serverで、iisproxy.iniファイルを作成します。

iisproxy.iniファイルには、プラグインの構成パラメータを定義する名前=値ペアが格納されます。そのパラメータは、第7.1項「Webサーバー・プラグインの一般パラメータ」にリストされています。

第5.5.1項「iisproxy.iniファイルのサンプル」で示しているiisproxy.iniファイルの例を、iisproxy.iniファイルを作成するためのテンプレートとして使用します。

注意:
「IIS Admin Service」(コントロール・パネルの「サービス」にあります)を再起動するまで、パラメータの変更は有効になりません。

iisproxy.iniファイルをiisproxy.dllファイルと同じディレクトリに配置することをお薦めします。他の場所に配置することも可能です。他のディレクトリに配置した場合、次のディレクトリにおいて次の順序でiisproxy.iniが検索されます。

1. isproxy.dllが配置されているディレクトリ。

2. Windowsレジストリで参照される最新バージョンのWebLogic Serverのホーム・ディレクトリ(ホーム・ディレクトリでiisproxy.iniファイルが見つからない場合、WebLogic Serverは、WindowsレジストリでWebLogic Serverの旧バージョンを調べ、古いインストール環境のホーム・ディレクトリでiisproxy.iniファイルを探します。)

3. c:\weblogicディレクトリ(存在する場合)。

7. Microsoft Internet Information Serverプラグインがリクエストをプロキシする、Oracle WebLogic Serverのホストおよびポート番号を定義します。ホストおよびポートを定義するには、構成に応じて次の2つの方法があります。

- 1つのWebLogic Serverにリクエストをプロキシする場合は、iisproxy.iniファイルでWebLogicHostパラメータとWebLogicPortパラメータを定義します。次にその例を示します。

WebLogicHost=localhost
WebLogicPort=7001

- WebLogic Serverのクラスタにリクエストをプロキシする場合は、iisproxy.iniファイルでWebLogicClusterパラメータを定義します。次にその例を示します。

WebLogicCluster=myweblogic.com:7001,yourweblogic.com:7001

myweblogic.comとyourweblogic.comは、クラスタ内で動作するOracle WebLogic Serverのインスタンスです。

8. 必要な場合は、パスによるプロキシの手順(第5.4項「ワイルドカード・アプリケーション・マッピングを使用したパスによるプロキシ」を参照)に従ってHTTPトンネリングを有効にし、HTTPトンネリング・リクエストを処理するWebLogic Serverホスト名とWebLogic Serverポート番号、またはWebLogicクラスタの名前を置き換えることもできます。

9. iisproxy.iniファイルに追加パラメータを設定します。パラメータの詳細なリストは、第7.1項「Webサーバー・プラグインの一般パラメータ」(付録)で参照できます。

10. パスによるプロキシではなく、IISからWebLogic Serverにサーブレットをプロキシする場合は、第5.4項「ワイルドカード・アプリケーション・マッピングを使用したパスによるプロキシ」を参照してください。

11. 初期設定でインストールされているバージョンのIISでは、iisproxy.dllは許可されていません。IISマネージャー・コンソールを使用して、次のようにプラグインを有効にしてください。

1. IISマネージャー・コンソールを開きます。

2. 「Web サービス拡張」を選択します。

3. 「すべての不明な ISAPI 拡張」を「許可」に設定します。

5.1.1 例: IISプラグインの構成

次の例では、バックエンドWebLogic Server(WLS)にリクエストをプロキシするようIISプラグイン設定する方法を示します。

1. %PLUGIN_HOME%\lib\にiisproxy.iniファイルを作成します。次の行を追加してください。

WebLogicHost=wls-host
WebLogicPort=wls-port
Debug=ALL
WLLogFile=C:\Temp\wl-proxy.log

2. %PLUGIN_HOME%\libがシステムPATHに含まれていることを確認します(「コントロール パネル」→「システム」→「システムのプロパティ」→「環境変数」→「システムのプロパティ」→「PATH」)。

3. IISマネージャーを開き、「既定の Web サイト」を使用するか、新しいWebサイトを作成します。サイトをクリックして「ハンドラ・マッピング」を開き、スクリプト・マップを追加します(「拡張子」を*.jspや*などに、「実行可能ファイル」を%PLUGIN_HOME%\lib\iisproxy.dllに設定し、「名前」を割り当てます)。

4. IISを起動します。

5. ブラウザからhttp://iis-host:iis-port/mywebapp/my.jspにリクエストを送信します。レスポンスを確認します。

5.2Microsoft Internet Information Server IIS 7.0プラグインのインストールと構成

この項では、Microsoft Internet Information Server IIS 7.0プラグインの設定方法の差異について説明します。

IIS 7.0用のMicrosoft Internet Information Serverプラグインを設定するには、次の手順を実行します。

1. IISマネージャーで、「Web サイト」を右クリックして「Web サイトの追加」を選択し、Webアプリケーションを作成します。
「Web サイト名」に、Webアプリケーションに付ける名前(たとえば、MyApp)を入力します。Webアプリケーションのポート(現在使用中でない任意の有効なポート番号)の物理パスを選択します。

「OK」をクリックしてWebアプリケーションを作成します。

「Web サイト」の下にそのアプリケーションの名前が表示されていれば、アプリケーションが作成され、実行が開始されています。図5-5のように、MyAppアプリケーションに関するすべての設定(変更可能)を表示するには、「Web サイト」の下にあるMyAppノードをクリックします。

図5-5 アプリケーション・ホーム・ページ

2. 「ハンドラー マッピング」をクリックして、特定のMIMEタイプのハンドラへのマッピングを設定します。

図5-6 「ハンドラー マッピング」の設定

3. 「StaticFile」をクリックし、「要求パス」を*から*.*に変更します。「OK」をクリックします。

図5-7 モジュールの「要求パス」の編集

4. 「MyApp」をクリックして、右側のメニュー・オプションの「スクリプト マップの追加」をクリックします。「要求パス」に*を入力します。
iisproxy.dllファイルを参照し、実行ファイルとして追加します。proxyという名前を付けます。

図5-8 スクリプトの「要求パス」の編集

5. 「要求の制限」をクリックし、「要求のマップ先が次の場合のみハンドラーを呼び出す」の選択を解除します。

図5-9 「要求の制限」の編集

6. 「OK」をクリックして、このハンドラ・マッピングを追加します。「スクリプト マップの追加」ダイアログ・ボックスで「はい」をクリックします。

図5-10 スクリプト・マップの追加

7. パスによるプロキシを構成する場合は、第5.4項「ワイルドカード・アプリケーション・マッピングを使用したパスによるプロキシ」を参照してください。

8. IISマネージャーのツリーのルート・ノードをクリックし、「ISAPI および CGI の制限」をクリックします。必ず「特定できない ISAPI モジュールを許可する」を選択してください。

図5-11 「ISAPI および CGI の制限」の編集

9. 次の内容のiisproxy.iniというファイルを作成し、プラグインのあるディレクトリに置きます。

WebLogicHost= @hostname@
WebLogicPort= @port@
ConnectRetrySecs=5
ConnectTimeoutSecs=25
Debug=ALL
DebugConfigInfo=ON
KeepAliveEnabled=true

WLLogFile=@Log file name@
SecureProxy=OFF

10. Internet Explorerブラウザを開き、http://<hostname>:<port>を入力します。Oracle WebLogic ServerからMedrecサンプル・アプリケーションを表示できるはずです。
SSLモードでプラグインを実行する場合、WeblogicPortの値をアプリケーションのSSLポートに変更し、SecureProxyの値をONに変更します。

図5-12 Medrecサンプル・アプリケーション

5.3 Webサーバーからの静的ファイルの提供

WebLogic Serverによって提供される予定のWebアプリケーションに含めることができるすべての静的コンテンツをIIS 7.5が提供できるようにするには、次の手順を実行してください。

1. 第5.1項の説明に従って、IIS 7.5 Webサーバー上でWebLogic Serverプラグイン1.1を設定することでアプリケーションを構成します。

オラクル社のドキュメントで説明されているとおりに、proxyという名前のハンドラ・マッパーを作成してあると想定します。

重要:
プロキシ設定では、WLEXCLUDEPATHORMIMETYPEプロパティを使用しないでください。これは、必要でも役立つこともなく、手順がわかりにくくなる可能性があるだけです。

2. IISマネージャーで、手順1で作成した仮想ディレクトリまたはアプリケーションをクリックしてホーム・ページを表示します。

3. 「Handling Mappers」をダブルクリックし、右側のペインで「順序指定された一覧の表示」をクリックします。ハンドラ・マッピングの順序指定された一覧が表示されます。

4. proxyを選択して、StaticFileハンドラ・マッピングの下にドラッグします(つまり、StaticFileハンドラ・マッピングがproxyハンドラ・マッピングの上に表示される必要があります)。

5. 静的ファイルを編集し、要求パスを*.jpgに変更します。ファイルを保存します。

6. IIS 7.5でPNG、GIF、CSSなどの種類の静的ファイルを提供できるようにするには、次の手順を実行します。

1. IISマネージャーで、手順1で作成した仮想ディレクトリまたはアプリケーションをクリックしてホーム・ページを表示します。

2. ここで、「Handling Mappers」をダブルクリックし、右側のペインで「モジュール マップの追加」をクリックします。

3. 必要なタイプの「要求パス」を選択します(PNGの場合は*.png、GIFの場合は*.gifなど)。「モジュール」には「StaticFileModule」を選択し、名前を入力して「OK」をクリックします。

4. 手順4で説明しているように、新しく作成したハンドラ・マッピングの順序が、手順1で定義したproxyハンドラ・マッピングより前になるようにしてください。

5.4 ワイルドカード・アプリケーション・マッピングを使用したパスによるプロキシ

「Installing Wildcard Application Mappings (IIS 6.0)」(http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/5c5ae5e0-f4f9-44b0-a743-f4c3a5ff68ec.mspx?mfr=true)およびIIS 7.5用の「Add a Wildcard Script Map」(http://technet.microsoft.com/en-us/library/cc754606(WS.10).aspx)で説明されているように、リクエストされたファイルの拡張子に関係なく、Webサイトまたは仮想ディレクトリへの各リクエストの最初にInternet Server API (ISAPI)アプリケーションを実行するよう、そのWebサイトまたは仮想ディレクトリを構成できます。この機能を使用して、iisproxy.dllにマッピングを挿入し、リクエストをWebLogic Serverへとパスによってプロキシできます。

5.4.1 ワイルドカード・アプリケーション・マッピングのインストール(IIS 6.0)

次に示す手順は、「Installing Wildcard Application Mappings (IIS 6.0)」(http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/5c5ae5e0-f4f9-44b0-a743-f4c3a5ff68ec.mspx?mfr=true)で説明されている、IIS 6.0でWebサーバーまたはWebサイトにワイルドカード・アプリケーション・マッピングを追加する方法をまとめたものです。

1. IISマネージャーで、ローカル・コンピュータ、「Web サイト」フォルダの順に開き、使用するWebサイトまたは仮想ディレクトリを右クリックして「プロパティ」をクリックします。

2. 適切なタブ(「ホーム ディレクトリ」、「仮想ディレクトリ」または「ディレクトリ」)をクリックします。

3. 「アプリケーション設定」領域で「構成」→「マッピング」タブをクリックします。

4. ワイルドカード・アプリケーション・マップをインストールするには、次の手順を実行します。

1. 「マッピング」タブで「挿入」をクリックします。

2. 「実行可能ファイル」テキスト・ボックスでiisproxy.dll DLLへのパスを入力するか、「参照」をクリックしてその場所に移動します。

3. 「OK」をクリックします。

5.4.2 IIS 7.5用のワイルドカード・スクリプト・マップの追加

次に示す手順は、IIS 7.5向けの「Add a Wildcard Script Map」(http://technet.microsoft.com/en-us/library/cc754606(WS.10).aspx)で説明されている、IIS 7.5でワイルドカード・スクリプト・マップを追加し、ISAPIを使用してパスによってプロキシする方法をまとめたものです。

1. IISマネージャーを開き、管理するレベルに移動します。IISマネージャーを開く方法の詳細は、http://technet.microsoft.com/en-us/library/cc770472(WS.10).aspxの「Open IIS Manager」を参照してください。UIでの場所移動の詳細は、http://technet.microsoft.com/en-us/library/cc732920(WS.10).aspxの「Navigation in IIS Manager」を参照してください。

2. サーバー、サイトまたはアプリケーション・ホームページの機能ビューでハンドラのマッピングをダブルクリックします。

3. 「ハンドラー マッピング」ページの「操作」ペインで、「ワイルドカード スクリプト マップの追加」をクリックします。

4. 「実行ファイル」ボックスに完全なパスを入力するか、リクエストを処理するiisproxy.dllを参照します。たとえば、systemroot\system32\inetsrv\iisproxy.dllと入力します。

5. 「名前」ボックスにハンドラ・マッピングのわかりやすい名前を入力します。

6. 「OK」をクリックします。

7. 必要に応じて、「ハンドラー マッピング」ページでハンドラを選択してそれをロックまたはロック解除することもできます。ハンドラ・マッピングをロックすると、それを構成内の下位レベルでオーバーライドできなくなります。リストからハンドラ・マッピングを選択し、「アクション」ペインの「ロックまたはロック解除」をクリックします。

8. ワイルドカード・スクリプト・マップを追加した後、実行可能ファイルを「ISAPI および CGI の制限」リストに追加して、実行できるようにする必要があります。ISAPIおよびCGIの制限の詳細は、http://technet.microsoft.com/en-us/library/cc730912(WS.10).aspxの「Configuring ISAPI and CGI Restrictions in IIS 7」を参照してください。

5.5 複数の仮想WebサイトからWebLogic Serverへのリクエストのプロキシ

複数のWebサイト(IISで仮想ディレクトリとして定義済)からWebLogic Serverへリクエストをプロキシするには:

1. 仮想ディレクトリ用に新しいディレクトリを作成します。このディレクトリには、プロキシを定義するために使用する.dllおよび.iniファイルが格納されます。

2. プラグインの.zipファイルをディレクトリに解凍します。

3. 構成した各仮想ディレクトリについて、手順1で作成したディレクトリに、プラグインの\libフォルダの内容をコピーします。

4. 第1.1.2項「リクエストのプロキシ」の説明に従って、仮想Webサイトのためのiisproxy.iniファイルを作成します。このiispoxy.iniファイルをステップ1で作成したディレクトリにコピーします。

5. ステップ1で作成したディレクトリにiisproxy.dllをコピーします。

6. 仮想ディレクトリごとに別個のアプリケーション・プールを作成します。
「Creating Application Pools (IIS 6)」(http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/93275ef2-2f85-4eb1-8b92-a67545be11b4.mspx?mfr=true)で説明されているように、様々なWebアプリケーションまたはWebサイトを、アプリケーション・プールと呼ばれるプールに隔離できます。アプリケーション・プールでは、プロセス境界によって各ワーカー・プロセスが他のワーカー・プロセスから分離され、アプリケーションが1つのアプリケーション・プールにルーティングされる場合に、別のアプリケーション・プールのアプリケーションがそのアプリケーションに影響を及ぼすことはありません。

5.5.1 iisproxy.iniファイルのサンプル

次に、クラスタ化されていない1つのWebLogic Serverで使用するサンプルiisproxy.iniファイルを示します。先頭に「#」が付いた行はコメントです。

# This file contains initialization name/value pairs
# for the IIS/WebLogic plug-in.
WebLogicHost=localhost
WebLogicPort=7001
ConnectTimeoutSecs=20
ConnectRetrySecs=2

次に、クラスタ化されたWebLogic Serverで使用するサンプルiisproxy.iniファイルを示します。先頭に「#」が付いた行はコメントです。

# This file contains initialization name/value pairs
# for the IIS/WebLogic plug-in.
WebLogicCluster=myweblogic.com:7001,yourweblogic.com:7001
ConnectTimeoutSecs=20
ConnectRetrySecs=2

注意:
プラグインとWebLogic Serverとの間でSSLを使用する場合は、ポート番号をSSLリスニング・ポートとして定義する必要があります。

5.6 IISを介したACLの作成

ACLは、IISからAuthorizationヘッダーが渡されない場合はMicrosoft IISプラグインでは機能しません。次の情報を参考にして、IISによって必ずAuthorizationヘッダーが渡されるようにしてください。

基本認証を使用する場合、ユーザーはローカルのログオン権限でログオンします。基本認証を使用できるようにするには、IISサーバー上で各ユーザー・アカウントに「ローカル・ログオン」ユーザー権限を付与します。基本認証でローカル・ログオンを使用する場合は、次の2つの問題が発生する可能性があります。

- ユーザーにローカル・ログオン権限がない場合は、FrontPage、IISおよびWindows NTが正しく構成されているように見えるとしても、基本認証は機能しません。

- ローカル・ログオン権限があり、IISを実行するホスト・コンピュータに実際にアクセスできるユーザーが、コンソールで対話型セッションを開始できます。

基本認証を有効にするには、コンソールの「ディレクトリ・セキュリティ」タブで、「匿名を許可」がオン、それ以外のオプションがすべてオフになっていることを確認してください。

5.7 インストールのテスト

Microsoft IISプラグインをインストールして構成した後は、次の手順に従ってデプロイメントとテストを行います。

1. WebLogic ServerとIISが実行されていることを確認します。

2. JSPファイルをデフォルトWebアプリケーションのドキュメント・ルートに保存します。

3. ブラウザを開き、次の例のように、IISとfilename.jspへのURLを設定します。

http://myii.server.com/filename.jsp

filename.jspがブラウザに表示されれば、プラグインは正常に機能しています。

6 共通の構成タスク

この章では、オラクル社提供のプラグインの構成において、すべてのWebサーバーに共通するタスクを説明します。次の項で構成されます。

- 第6.1項「プラグインでのSSLの使用」

- 第6.2項「プラグインでのIPv6の使用」

- 第6.3項「境界認証の設定」

- 第6.4項「接続エラーとクラスタリング・フェイルオーバーの理解」

- 第6.5項「WebLogicプロキシ・プラグインおよびOracle WebLogic ServerでのSSLの構成」

6.1 プラグインでのSSLの使用

Secure Sockets Layer (SSL)プロトコルを使用することで、プラグインとOracle WebLogic Serverとの間の接続を保護できます。SSLプロトコルによって、プラグインとWebLogic Serverとの間で渡されるデータの機密性と整合性が保持されます。

プラグインでは、プラグインとWebLogic Serverとの間の接続の保護にSSLを使用するかどうかの決定に、HTTPリクエストで指定された(通常はブラウザによって指定)トランスポート・プロトコル(HTTPまたはHTTPS)を使用しません。つまり、プラグインは、(通常はブラウザからの)HTTPリクエストでHTTPS (SSL)が使用されるかどうかには一切依存しません。

かわりに、プラグインでは、第7.2項「Webサーバー・プラグインのSSLパラメータ」で説明されているように、SSLをいつ使用をするかを決定するため、プラグインに対して次のように構成したSSLパラメータを使用します。

- WebLogicSSLVersion—プラグインとWebLogic Serverの間の通信に使用するSSLプロトコル・バージョンを指定します。これは11.1.1.9リリースの新規パラメータでWeb Serverプラグインの古いリリースでは使用できません。

- WLSSLWallet-バージョン1.1のプラグインでは、SSL構成情報の格納にOracleウォレットが使用されます。プラグインには、Oracleウォレットの使用のために、新しいSSL構成パラメータであるWLSSLWalletが導入されています。この目的のために、プラグインのディストリビューション内にorapkiユーティリティが用意されています。
orapkiユーティリティでは、ウォレット、証明書失効リストなど、公開鍵インフラストラクチャ(PKI)の要素をコマンド行で管理するため、実行するタスクをスクリプトに組み込むことができます。これを使用して、PKIを保守するルーチン・タスクの多くを自動化できます。

詳細は、orapkiユーティリティを使用した証明書検証およびCRL管理に関する項を参照してください。

- SecureProxy-SecureProxyパラメータによって、SSLを有効にするかどうかを決定します。

注意:
有効なセキュリティ・プロトコルおよび現行リリースの暗号に関する詳細は、『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』のSSLCipherSuiteに関する項およびSSLProtocolに関する項を参照してください。

双方向SSLについては、Oracle WebLogic Serverが双方向SSLを使用するように構成されている場合にクライアント証明書をリクエストすると、プラグイン(SSLクライアント)によって自動的に双方向SSLが使用されます。

クライアント証明書がリクエストされない場合は、デフォルトでプラグインは一方向SSLになります。

注意:
Apacheプラグイン(Oracle HTTP Serverを含む)と同じシステム上にOracle Fusion Middleware 11gR1製品がインストールされている場合は、ORACLE_HOME変数が有効なインストール環境を指している必要があり、そうでない場合は、プラグインによるSSLの初期化が失敗します。
たとえば、製品が正常に削除されなかったためにORACLE_HOMEが無効になっている場合、プラグインによるSSLの初期化は失敗します。

6.1.1 SSL用のライブラリの構成

プラグインでは、SSLをサポートするためにOracleライブラリ(NZ)が使用されます。ライブラリはサイズが大きいため、SSLの使用が必要な場合のみロードされます。lib/*.so*にあるライブラリ・ファイルは、必ず、プラグインによる動的なロードが可能な適切な場所に配置する必要があります。

Apache HTTPサーバー用プラグインのライブラリを構成するには、次のような方法があります。

- Windows: .dllファイルを含むlibディレクトリをPATH変数で指定するか、*.dllファイルをbinディレクトリにコピーします。

- UNIX: ライブラリを含むフォルダを指すようLD_LIBRARY_PATHを設定するか、ライブラリをlibディレクトリにコピーします。

PATH変数(Windows)またはLD_LIBRARY_PATH変数(UNIX)を更新するのではなく、ライブラリをコピーした場合は、新しいバージョンのプラグインをインストールするたびにライブラリをコピーしなおす必要があります。

6.1.2 一方向SSL用のプラグインの構成

一方向SSLを構成するには、次の手順に従ってください。

この手順では、WebLogic Serverがインストールされているシステム上で keytoolコマンドを実行し、バージョン1.1のプラグインがインストールされているシステム上でorapkiコマンドを実行します。

注意:
この項で示す例には、WebLogic ServerのデモCAが使用されています。本番環境でプラグインを使用している場合は、プラグインおよびOracle WebLogic Serverに対して、信頼性のあるCAが正しく構成されていることを確認してください。

1. SSL用にOracle WebLogic Serverを構成します。詳細は、Oracle WebLogic Serverの保護のSSLの構成を参照してください。

2. orapkiユーティリティを使用してOracleウォレットを作成します。

orapki wallet create -wallet mywallet -auto_login_only

詳細は、『Oracle Fusion Middleware管理者ガイド』のorapkiユーティリティを使用した証明書検証およびCRL管理に関する項を参照してください。

注意:
ウォレットにアクセスできるのは、そのウォレットを作成したユーザーのみです(Windowsの場合はSYSTEMアカウント)。
通常、Apacheは、WindowsではSYSTEMアカウント、UNIXではウォレットの作成ユーザーとして実行されるため、Apacheプラグインについてはこれで十分です。ただしIISの場合は、デフォルト・ユーザーがIUSR_<Machine_Name> (IIS6.0以下)またはIUSR (IIS7.0以上)であるため、ウォレットは機能しません。

ApacheプラグインまたはIISプラグインを実行するユーザーが、ウォレットを作成するユーザー(Windowsの場合はSYSTEMアカウント)と異なる場合には、ウォレットの作成後にcaclsコマンド(Windows)またはchmodコマンド(UNIX)を実行してユーザーにそのウォレットへのアクセス権を付与する必要があります。次にその例を示します。

IIS 6.0:

cacls <wallet_path>\cwallet.sso /e /g IUSR_<Machine_Name>:R

IIS 7.5:

cacls <wallet_path>\cwallet.sso /e /g IUSR:R

3. WL_HOME\server\lib\CertGenCA.der CAをOracle Walletにインポートします。

orapki wallet add -wallet mywallet -trusted_cert -cert CertGenCA.der -auto_login_only

4. Webサーバーの構成ファイルを次のように構成します。

- Oracle HTTP Server用にmod_wl_ohs.confファイルを次のように編集します。

<IfModule mod_weblogic.c>
WebLogicHost host
WebLogicPort port
SecureProxy ON
WLSSLWallet path_to_wallet
</IfModule>

- Microsoft IISの場合は、次のようにiisproxy.iniファイルを編集します。

WebLogicHost=host
WebLogicPort=port
SecureProxy=ON
WLSSLWallet=path_to_wallet

- iPlanet Web Serverの場合、次のように、config/obj.confまたはconfig/<vs>-obj.confファイルを編集します。

<Object ppath="*/weblogic/*">>
Service fn=wl-proxy WebLogicHost=myserver.com WebLogicPort=7001  PathTrim="/weblogic"
SecureProxy=ON
WLSSLWallet=path_to_wallet
</Object>

これらの例で使用されているパラメータの詳細は、第7章「Webサーバー・プラグインのパラメータ」を参照してください。

5. バックエンドのOracle WebLogic Serverインスタンスがバージョン10.3.4以降の場合は、次の手順に従ってください。

1. Oracle WebLogic Server管理コンソールにログインします。

2. 「ドメイン構造」ペインで「環境」ノードを開きます。

- Oracle HTTP Serverからリクエストをプロキシするサーバー・インスタンスがクラスタにある場合は、「クラスタ」を選択します。

- それ以外の場合は、「サーバー」を選択します。

3. Oracle HTTP Serverからリクエストをプロキシするサーバーまたはクラスタを選択します。

「構成」→「一般」タブが表示されます。

4. 下にスクロールし、「詳細」セクションを開きます。

5. 「WebLogicプラグインの有効化」チェック・ボックスを選択します。

6. 「クライアント証明書プロキシの有効化」チェック・ボックスを選択します。

7. 手順bで「サーバー」を選択した場合は、Oracle HTTP Serverからのリクエストをプロキシする他のサーバーに対して手順cとdを繰り返します。

8. 「保存」をクリックします。

変更内容を有効にするには、サーバー・インスタンスを再起動する必要があります。

6. ブラウザからhttp://host:port/mywebapp/my.jspにリクエストを送信し、レスポンスを確認します。

6.1.3 プラグインとOracle WebLogic Serverとの間の双方向SSLの構成

Oracle WebLogic Serverを双方向SSL用に構成してある場合は、プラグインによってユーザー証明書がWebLogic Serverに転送されます。WebLogic Serverがユーザー証明書を確認できれば、双方向SSLを確立できます。

第6.1.2項「一方向SSL用のプラグインの構成」で説明されている手順に加えて、次の手順も実行してください。

この手順では、WebLogic Serverがインストールされているシステム上でkeytoolコマンドを実行します。また、バージョン1.1プラグインがインストールされているシステム上でorapkiコマンドを実行します。

1. Oracleウォレットから証明書リクエストを生成します。

2. この証明書リクエストを使用し、CAまたはその他のメカニズムを介して証明書を作成します。

3. ユーザー証明書を、信頼性のある証明書としてWebLogic信頼ストアにインポートします。Oracle WebLogic Serverで、その証明書を信頼する必要があります。

keytool -file user.crt -importcert -trustcacerts -keystore DemoTrust.jks -storepass <passphrase>

4. クライアント証明書(双方向SSL用)の提示が必要となるWebLogic Server SSL構成オプションを設定します。詳細は、Oracle WebLogic Server管理コンソール・ヘルプの双方向SSLの構成に関する項を参照してください。

6.2 プラグインでのIPv6の使用

バージョン1.1プラグインでは、IPv6がサポートされています。具体的には、WebLogicHostおよびWebLogicClusterの構成パラメータ(表7-1を参照)でIPv6アドレスをサポートするようになりました。次にその例を示します。

<IfModule mod_weblogic.c>
WebLogicHost [a:b:c:d:e:f]
WebLogicPort 7002
...
</IfModule>

または

<IfModule mod_weblogic.c>
WebLogicCluster [a:b:c:d:e:f]:<port>, [g:h:i:j:k:l]:<port>

....
</IfModule>

IPv6アドレスにマップされているホスト名を使用することもできます。

注意:
Windows 2008以降、DNSサーバーは、IPv4アドレスよりもIPv6アドレスを優先して返します。IPv4を使用してWindows 2008以降のシステムに接続している場合は、最初にリンクローカルIPv6アドレス形式が試みられ、それによって遅延が顕著となり、パフォーマンスが低下する可能性があります。IPv4アドレス形式を使用するには、構成ファイルでかわりのIPアドレスを使用するようシステムを構成するか、IPv4アドレスをetc/hostsファイルに追加します。
また、mod_wl_ohs.confファイル内でDynamicServerListプロパティをOFFに設定することによっても、IPv6でのパフォーマンスが向上する可能性があります。OFFに設定すると、プラグインは、プラグインからプロキシされたロード・バランシング・リクエストに使用される動的クラスタ・リストを無視し、WebLogicClusterパラメータで指定された静的リストを使用します。

6.3 境界認証の設定

プラグインを介してアクセスされる、WebLogic Serverアプリケーションを保護するには、境界認証を使用します。

WebLogic IDアサーション・プロバイダでは、WebLogic Serverアプリケーションにアクセスする外部システム(プラグインを介してWebLogic Serverアプリケーションにアクセスするユーザーを含む)からのトークンを認証します。次の手順に従って、プラグインを安全に保護するIDアサーション・プロバイダを作成します。

1. WebLogic Serverアプリケーションに対してカスタムIDアサーション・プロバイダを作成します。『Oracle WebLogic Serverセキュリティ・プロバイダの開発』のカスタムIDアサーション・プロバイダの開発方法に関する項を参照してください。

2. Certトークン・タイプをサポートしてCertをアクティブなトークン・タイプにするよう、カスタムIDアサーション・プロバイダを構成します。『Oracle WebLogic Serverセキュリティ・プロバイダの開発』の新しいトークン・タイプの作成方法に関する項を参照してください。

3. Webアプリケーションのweb.xmlデプロイメント記述子ファイルで、clientCertProxyをTrueに設定します。(クラスタを使用する場合、必要に応じて、管理コンソールの「クラスタ」-->「構成」-->「一般」タブで、クラスタ全体に対して「クライアント証明書プロキシの有効化」属性をtrueに設定します。
ロード・バランサ、SSLアクセラレータなど、サード・パーティのプロキシ・サーバーでclientCertProxy属性を使用することで、双方向SSL認証を有効にできます。clientCertProxy属性の詳細は、『Oracle WebLogic Server Webアプリケーション、サーブレット、JSPの開発』のcontext-paramに関する項を参照してください。

4. clientCertProxyを設定したら、接続フィルタを使用して、このプラグインが実行されているマシンからの接続のみがWebLogic Serverに受け入れられるようにしてください。『Oracle WebLogic Serverセキュリティのプログラミング』のネットワーク接続フィルタの使用に関する項を参照してください。

5. Webサーバーのプラグインでは、プラグインとWebLogic Serverとの間でSSLを使用するために、信頼性のある認証局ファイルが必要になります。SSLを構成するために必要な手順は、第6.1項「プラグインでのSSLの使用」を参照してください。

『Oracle WebLogic Serverセキュリティ・プロバイダの開発』のIDアサーション・プロバイダに関する項を参照してください。

6.4 接続エラーとクラスタリング・フェイルオーバーの理解

プラグインでは、WebLogic Serverへの接続を試みるときに、様々な構成パラメータを使用することで、WebLogic Serverホストへの接続を待機する時間と接続確立後にレスポンスを待機する時間が決定されます。接続できないかレスポンスがない場合、プラグインは、クラスタ内の別のWebLogic Serverインスタンスへの接続とリクエストの送信を試みます。接続に失敗するか、クラスタ内のどのWebLogic Serverからもレスポンスがない場合は、エラー・メッセージが送信されます。

図6-1に、プラグインでのフェイルオーバーの処理方法を示します。

6.4.1 接続障害についての考えられる原因

WebLogic Serverホストで接続リクエストに対する応答に失敗する場合は、次のような問題が考えられます。

- ホスト・マシンの物理的な問題

- ネットワークの問題

- その他のサーバー障害

すべてのWebLogic Serverインスタンスで応答に失敗する場合は、次のような問題が考えられます。

- WebLogic Serverが実行されていないか使用不可である

- サーバーのハング

- データベースの問題

- アプリケーション固有の障害

6.4.2 Connection_Refusedエラーを減らすためのヒント

負荷がかかると、プラグインはバックエンドのWebLogic ServerインスタンスからCONNECTION_REFUSEDエラーを受け取ることがあります。CONNECTION_REFUSEDエラーを減らすには、チューニングに関する次のヒントに従ってください。

- WebLogic Serverドメインの構成において、AcceptBackLogの設定値を大きくします。

- 待機時間を短くします。この設定は、使用するオペレーティング・システムに応じて異なります。次にその例を示します。

- Windows NTの場合は、プロキシおよびWebLogic ServerサーバーのTcpTimedWaitDelayの設定値を小さくします。HKEY_LOCAL_MACHINEの下の次のレジストリ・キーを編集することで、Windows NTでのTIME_WAIT間隔を設定します。

SYSTEM\CurrentControlSet\Services\Tcpip\Parameters\TcpTimedWaitDelay

このキーが存在しない場合は、DWORD値としてこれを作成できます。数値は待機する秒数であり、30から240までの任意の値を設定できます。設定しない場合、Windows NTでは、TIME_WAITにデフォルトの240秒が設定されます。

- Windows 2000の場合は、HKEY_LOCAL_MACHINEの下の次のレジストリ・キーを編集することで、TcpTimedWaitDelayの値を小さくします。

SYSTEM\CurrentControlSet\Services\Tcpip\Parameters

- Solarisの場合は、tcp_time_wait_intervalの設定を1秒に減らします(可能な場合は、WebLogic ServerマシンとApacheマシンの両方に対して設定)。

$ndd /dev/tcp
param name to set - tcp_time_wait_interval
value=1000

- マシン上でオープン・ファイル・ディスクリプタの制限値を大きくします。この制限は、オペレーティング・システムによって異なります。limit (.csh)またはulimit (.sh)ディレクティブを使用して、制限値を大きくするスクリプトを作成できます。次にその例を示します。

#!/bin/sh
ulimit -S -n 100
exec httpd

- Solarisの場合は、WebLogic Serverマシン上の次のチューニング可能項目の値を大きくします。

tcp_conn_req_max_q tcp_conn_req_max_q0

6.4.3 クラスタ化されていない単一のWebLogic Serverでのフェイルオーバー

WebLogic Serverインスタンスが1つしか実行されていない場合、プラグインは、WebLogicHostパラメータで定義されているサーバーのみに接続を試みます。失敗すると、HTTP 503エラー・メッセージが返されます。プラグインは、ConnectTimeoutSecsとConnectRetrySecsの比で指定されている最大再試行回数まで、同じWebLogic Serverインスタンスへの接続の試行を続けます。

6.4.4 動的サーバー・リスト

WebLogicClusterパラメータは、クラスタ化されたバックエンド・サーバーのリストにプロキシしたり、クラスタ化されていない管理対象サーバー・インスタンスのロード・バランシングを実行するために必要となります。

クラスタリングされた管理対象サーバーにプロキシする場合、httpd.confまたはweblogic.confファイルでWebLogicClusterパラメータを使用してWebLogic Serverのリストを指定すると、プラグインはクラスタ・メンバー間でのロード・バランシングの起点としてそのリストを使用します。最初のリクエストがそれらのサーバーの1つにルーティングされた後、クラスタ内のサーバーの更新されたリストを含む動的サーバー・リストが返されます。更新されたリストでは、クラスタ内の新しいサーバーが追加され、クラスタを離脱したサーバーやリクエストに応答できなかったサーバーは削除されます。このリストは、クラスタ内で変化が発生したときにHTTPレスポンスによって自動的に更新されます。

6.4.5 フェイルオーバー、CookieおよびHTTPセッション

リクエストに、CookieやPOSTデータに格納されているかURLでエンコードされたセッション情報が含まれている場合、そのセッションIDには、セッションが最初に確立された特定のサーバー・インスタンス(プライマリ・サーバーと呼ばれる)への参照が含まれています。Cookieが含まれるリクエストは、プライマリ・サーバーへの接続を試みます。その試みが失敗すると、プラグインは、ラウンドロビン方式で、リスト内にある次に使用可能なサーバーへの接続を試みます。そのサーバーが元のセカンダリ・サーバーからセッションを取得し、そのサーバー自体が同一セッションの新しいプライマリ・サーバーになります。図6-1を参照してください。

注意:
POSTデータが64Kより大きい場合、プラグインは、セッションIDを取得するため、POSTデータを解析しません。したがって、セッションIDをPOSTデータに格納した場合、プラグインはリクエストを正しいプライマリ・サーバーまたはセカンダリ・サーバーにルーティングできず、セッション・データが失われる可能性があります。

図6-1 接続のフェイルオーバー

この図の赤色のループに許容されている最大試行回数はConnectTimeoutSecs/ConnectRetrySecsの値と等しくなります。

6.4.6 Oracle iPlanet Web ServerプラグインでのSSLの使用

Secure Sockets Layer (SSL)プロトコルを使用することで、Oracle iPlanet Web ServerプラグインとOracle WebLogic Serverとの間の接続を保護できます。SSLプロトコルによって、Oracle iPlanet Web ServerプラグインとOracle WebLogic Serverとの間で渡されるデータの機密性と整合性が保持されます。

Oracle iPlanet Web Serverプラグインは、Oracle iPlanet Web ServerプラグインとOracle WebLogic Serverの間の接続の保護にSSLプロトコルが使用されるかどうかを決定する際に、(通常はブラウザによって)HTTPリクエストに指定されるトランスポート・プロトコル(httpまたはhttps)を使用しません。

Oracle iPlanet Web ServerプラグインとOracle WebLogic Serverとの間でSSLプロトコルを使用するには:

1. SSL用にOracle WebLogic Serverを構成します。詳細は、Oracle WebLogic Serverの保護のSSLの構成を参照してください。

2. obj.confファイル内のServiceディレクティブのWebLogicPortパラメータを、手順1で構成したリスニング・ポートに設定します。

3. obj.confobj.confファイル内のServiceディレクティブのSecureProxyパラメータをONに設定します。

4. 必要に応じて、obj.confファイル内のServiceディレクティブで、SSL接続に関する情報を定義するその他のパラメータを設定します。パラメータのリストは、第7.2項「Webサーバー・プラグインのSSLパラメータ」を参照してください。

6.4.7 ファイアウォールとロード・ディレクタを使用する場合のフェイルオーバー動作

ほとんどの構成では、Oracle iPlanet Web Serverプラグインはリクエストをクラスタのプライマリ・インスタンスに送信します。そのインスタンスを使用できないと、リクエストはセカンダリ・インスタンスにフェイルオーバーします。ただし、ファイアウォールとロード・ディレクタを組み合せて使用する一部の構成では、WebLogic Serverのプライマリ・インスタンスを使用できなくても、いずれか1つのサーバー(ファイアウォールまたはロード・ディレクタ)がリクエストを受け入れ、正常な接続を返します。WebLogic Serverの使用できないプライマリ・インスタンスへのリクエストの送信が試行された後、リクエストは「接続リセット」としてプラグインに戻されます。

ファイアウォールの組合せを介して(ロード・ディレクタの有無に関係なく)実行されるリクエストは、WebLogic Serverによって処理されます。つまり、接続リセットのレスポンスは、WebLogic Serverのセカンダリ・インスタンスにフェイルオーバーします。このような構成では、接続リセットのレスポンスがフェイルオーバーするため、サーブレットは多重呼出し不変である必要があります。そうでない場合は、トランザクションの処理が重複する可能性があります。

6.5 WebLogicプロキシ・プラグインおよびOracle WebLogic ServerでのSSLの構成

WebLogicプロキシ・プラグイン11.1.1.9は、追加のSSLプロトコル(TLS 1.1およびTLS 1.2など)をサポートし、WebLogic ServerとのSSLハンドシェイク中にこれらのセキュア・プロトコルにデフォルト設定されます。WebLogic Serverプロキシ・プラグインに11.1.1.9がHTTPSトラフィックをWebLogic Serverからフロントエンドする際に、管理者は次の処理のいずれかを実行する必要があります。

- WebLogic ServerでTLS 1.2プロトコルがサポートされることを確認します。
WebLogic Server 10.3.xは、TLS 1.2プロトコルを使用するように明示的に構成する必要があります。詳細については、以下を参照してください。

- 詳細は、『Oracle WebLogic Serverの新機能』のトランスポート層セキュリティ(TLS)1.2サポートに関する項およびOracle Supportドキュメントを参照してください。

- 詳細は、Oracle WebLogic Serverの保護の「JSSEベースのSSL実装の有効化および無効化」を参照してください。

- https://support.oracle.comの「Oracle Fusion Middleware製品でSSLプロトコルを変更する(SSL 3.0を無効にする)方法(ドキュメントID 1936300.1)」

WebLogic Server 12.1以降のリリースでは、デフォルトでTLS 1.2プロトコルがサポートされます。追加の構成は不要です。

- WebLogic Server 10.3.6でTLS 1.2プロトコルをサポートするように構成できない場合、次の例のようにWebLogicSSLVersionディレクティブを使用して、WebLogic Server 10.3.6とのSSLハンドシェイク中に、TLS1.0プロトコルを使用してWebLogic Serverプロキシ・プラグイン11.1.1.9を通信するように明示的に構成する必要があります。

<IfModule mod_weblogic.c>
WebLogicSSLVersion TLSv1
</IfModule>

注意:
WebLogicSSLVersionディレクティブは、Oracle HTTP ServerおよびApache HTTPサーバーに対してのみ使用可能です。

このディレクティブに関する詳細は、『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』のWebLogicSSLVersionに関する項を参照してください。

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

Oracleの法律上の注意点

コピーライト

Copyright © 1994-2017, Oracle and/or its affiliates. All rights reserved.

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクルまでご連絡ください。

制限付権利について

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracle Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

Pre-General Availability (一般提供前)版のドキュメントについて

このドキュメントがPre-General Availability (一般提供前)版の場合:

このドキュメントはPre-General Availability (一般提供前)版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。Oracle Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

非公開のPre-General Availability (一般提供前)版のドキュメントについて

このドキュメントが非公開のPre-General Availability (一般提供前)版の場合:

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のPre-General Availability Trial Agreement (Pre-GAトライアル契約)のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle Partner Network Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

ドキュメントのアクセシビリティ

オラクルのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info)か、聴覚に障害のあるお客様は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。