Oracle® Fusion Middleware

Oracle WebLogic Serverプロキシ・プラグインの使用

12c (12.2.1.2.0)

E82686-02(原本部品番号:E78107-03)

2016年12月

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

Oracle Fusion Middleware Oracle WebLogic Serverプロキシ・プラグインの使用, 12c (12.2.1.2.0)

E82686-02

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

原本著者: Tom Pfaeffle

原本著者: Sandeep Ramavana、Mike Rumph、Xiaodong Zhang、Sebastian Arockiasamy

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

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

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

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 Oracle WebLogic Serverプロキシ・プラグインの概要

- 1.1 Oracle WebLogic Serverプロキシ・プラグインとは

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

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

- 1.2 Oracle WebLogic Serverプロキシ・プラグインの入手方法

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

- 1.3.1 アップグレードの手順

- 1.3.2 Oracle WebLogic Serverプロキシ・プラグインのバージョン1.0から12c (12.2.1)へのアップグレードの考慮事項

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

- 1.4.1 Oracle WebLogic Serverプロキシの監視

- 1.4.2 マルチテナンシおよびパーティションのサポート

- 1.4.3 iPlanet Web ServerのSSLサポート

- 1.4.4 IIS 7.5でプラグインを使用する場合のドキュメント

- 1.4.5 MD5アルゴリズムを使用して署名された証明書の非推奨になったサポート

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

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

- 2.1 Oracle HTTP Serverのサポートに関する注意事項

- 2.2 Oracle WebLogic Serverプロキシ・プラグインの構成準備

- 2.2.1 「WebLogicプラグインの有効化」パラメータの設定

- 2.2.1.1 「WebLogicプラグインの有効化」パラメータの理解

- 2.3 Fusion Middleware Controlを使用したOracle WebLogic Serverプロキシ・プラグインの構成

- 2.3.1 タスク1: 「mod_wl_ohs構成」ページに移動

- 2.3.2 タスク2: 構成設定の指定

- 2.3.3 タスク3: 式のオーバーライドまたはロケーションのオーバーライドの構成(省略可)

- 2.3.4 タスク4: 変更の適用

- 2.3.5 検索機能の使用

- 2.3.6 自動入力機能の使用

- 2.4 Oracle WebLogic Serverプロキシ・プラグインの手動による構成

- 2.4.1 <IfModule weblogic_module>要素の構成例

- 2.5 Oracle WebLogic Serverプロキシ・プラグインのパフォーマンス・メトリックの理解

- 2.5.1 Oracle HTTP Serverプロキシ・プラグイン用のDMSメトリックの構成

- 2.5.2 Oracle HTTP Serverプロキシ・プラグイン用のパフォーマンス・メトリックの表示

- 2.5.3 DMS状態メトリック

- 2.5.4 DMSイベント・メトリック

- 2.5.5 DMS PhaseEventメトリック

- 2.6 Oracle HTTP Serverの非推奨ディレクティブ

- 2.7 Oracle WebLogic Serverプロキシ・プラグインの実装に関するトラブルシューティング

- 2.7.1 WLSセッションの問題

- 2.7.2 CONNECTION_REFUSEDエラー

- 2.7.3 NO_RESOURCESエラー

- 2.7.4 Oracle WebLogic Serverキーストアの変更により予想外の動作が発生する

3 Apache HTTP Server用プラグインの構成

- 3.1 Apache HTTP Serverのサポートに関する注意事項

- 3.2 Apache HTTP Server用Oracle WebLogic Serverプロキシ・プラグインのインストール

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

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

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

- 3.3.1 httpd.confファイルの構成

- 3.3.1.1 タスク1: MIMEリクエストの構成

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

- 3.3.1.1.2 パスによるプロキシ・リクエストの構成

- 3.3.1.2 タスク2: Oracle WebLogic Serverプロキシ・プラグインのその他パラメータの定義

- 3.3.1.3 タスク3: HTTPトンネリングの有効化(省略可)

- 3.3.1.4 タスク4: Webサービスのアトミック・トランザクションの有効化(省略可)

- 3.3.1.5 タスク5: 構成の検証と適用

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

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

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

- 3.3.4.1 weblogic.confファイルを作成するためのルール

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

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

- 3.4 Apache HTTP ServerプラグインのDMSメトリックの理解

- 3.4.1 Apache HTTP ServerプラグインのDMSメトリックの構成

- 3.4.2 Apache HTTP Serverプラグインのパフォーマンス・メトリックの表示

- 3.5 Apache HTTPサーバーの非推奨ディレクティブ

4 iPlanet Web Server用プラグインの構成

- 4.1 iPlanet用Oracle WebLogic Serverプロキシ・プラグインの概要

- 4.2 iPlanet用プラグインのインストールと構成

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

- 4.2.2 iPlanet Web Server用Oracle WebLogic Serverプロキシ・プラグインのインストール

- 4.2.3 iPlanet Web Server用Oracle WebLogic Serverプロキシ・プラグインの構成

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

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

- 4.2.3.3 プラグインのテスト

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

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

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

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

- 4.3 iPlanet Web Serverの非推奨ディレクティブ

5 Microsoft IIS Web Server用プラグインの構成

- 5.1 Microsoft IIS 7.0プラグインの操作

- 5.1.1 Microsoft IIS 7.0プラグインのインストールと構成

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

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

- 5.1.3.1 IIS 7.0以降のためのワイルドカード・スクリプト・マップの追加

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

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

- 5.1.5 IISを介したACLの作成 7.0

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

- 5.2 Microsoft IIS 7.5プラグインの操作

- 5.2.1 Microsoft IIS 7.5プラグインのインストールと構成

- 5.2.2 IIS 7.5での静的ファイルの提供

- 5.2.3 IIS 7.5での同じリクエストからの静的ファイルおよび動的コンテンツの提供

6 セキュリティの構成

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

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

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

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

- 6.1.4 MD5アルゴリズムを使用して署名された証明書の置換

- 6.1.5 MD5アルゴリズムを使用して署名された証明書のサポートの有効化

- 6.2 iPlanet Web Server用プラグインでのSSLの構成

- 6.3 境界認証の構成

7 共通の構成タスク

- 7.1 プラグインでのIPv6の構成

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

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

- 7.2.2 CONNECTION_REFUSEDエラーを減らすためのヒント

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

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

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

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

- 7.3 WebSocketアップグレード・リクエストのスループットを高めるためのOracle HTTP ServerとApache HTTP Serverのチューニング

- 7.4 パーティションの操作

- 7.4.1 パーティションの追加

- 7.4.1.1 Apache ServerおよびOracle HTTP Serverの構成の変更

- 7.4.1.1.1 Oracle HTTP Server/Apacheプラグインの例

- 7.4.1.2 iPlanet Serverの構成の変更

- 7.4.1.3 IIS Serverの構成の変更

- 7.4.2 パーティションの変更およびパーティション移行

- 7.4.3 Web ServerとOracle WebLogic Serverとの間のSSLの構成

- 7.4.4 クラスタ変更の動的検出

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

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

- 8.1.1 ConnectRetrySecs

- 8.1.2 ConnectTimeoutSecs

- 8.1.3 Debug

- 8.1.4 DebugConfigInfo

- 8.1.5 DefaultFileName

- 8.1.6 DynamicServerList

- 8.1.7 ErrorPage

- 8.1.8 FileCaching

- 8.1.9 Idempotent

- 8.1.10 KeepAliveEnabled

- 8.1.11 KeepAliveSecs

- 8.1.12 MatchExpression

- 8.1.13 MaxPostSize

- 8.1.14 MaxSkipTime

- 8.1.15 PathPrepend

- 8.1.16 PathTrim

- 8.1.17 QueryFromRequest

- 8.1.18 WebLogicCluster

- 8.1.19 WebLogicHost

- 8.1.20 WebLogicPort

- 8.1.21 WLCookieName

- 8.1.22 WLDNSRefreshInterval

- 8.1.23 WLExcludePathOrMimeType

- 8.1.24 WLFlushChunks

- 8.1.25 WLForwardUriUnparsed

- 8.1.26 WLIOTimeoutSecs

- 8.1.27 WLLocalIP

- 8.1.28 WLLogFile

- 8.1.29 WLMaxWebSocketClients

- 8.1.30 WLProxyPassThrough

- 8.1.31 WLProxySSL

- 8.1.32 WLProxySSLPassThrough

- 8.1.33 WLRetryOnTimeout

- 8.1.34 WLRetryAfterDroppedConnection

- 8.1.35 WLSendHdrSeparately

- 8.1.36 WLServerInitiatedFailover

- 8.1.37 WLSocketTimeoutSecs

- 8.1.38 WLSRequest

- 8.1.39 WLTempDir

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

- 8.2.1 SecureProxy

- 8.2.2 WebLogicSSLVersion

- 8.2.3 WLSSLWallet

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

はじめに

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

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

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 Oracle WebLogic Serverプロキシ・プラグインの概要

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

- Oracle WebLogic Serverプロキシ・プラグインとは

- Oracle WebLogic Serverプロキシ・プラグインの入手方法

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

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

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

1.1 Oracle WebLogic Serverプロキシ・プラグインとは

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秒(またはユーザー定義の時間)が経過してもアクティブにならない場合は閉じられます。詳細は、「KeepAliveEnabled」を参照してください。

注意:

Webサーバーはクライアント接続を管理します。

1.1.2 リクエストのプロキシ

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

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

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

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

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

1.2 Oracle WebLogic Serverプロキシ・プラグインの入手方法

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

表1-1 バージョン12c (12.2.1.1.0)プラグインの入手方法

Webサーバー

プラグインの入手方法

参照

Oracle HTTP Server 12c

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

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

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

Apache HTTPサーバー2.2.x

Microsoft Internet Information Server (IIS) 7.0および7.5

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

たとえば、mod_wl.soというプラグイン・ディストリビューションには次のディレクトリが含まれています。

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

- lib/*.so (ネイティブ・ライブラリ)

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

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

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

- Apache HTTP Server用プラグインの構成

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

- Microsoft IIS Web Server用プラグインの構成

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

バージョン1.0プラグインは非推奨であり、Oracle WebLogic Serverの将来のバージョンでは提供されない可能性があります。バージョン12c (12.2.1.1.0)プラグインに置き換えることをお薦めします。

注意:

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

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

- アップグレード手順

- Oracle WebLogic Serverプロキシ・プラグインのバージョン1.0から12c (12.2.1)へのアップグレードの考慮事項

1.3.1 アップグレード手順

11gプラグインからOracle WebLogic Serverプロキシ・プラグイン12c (12.2.1.1.0)にアップグレードする場合は、表1-2に示す、ご使用のWebサーバー向けの章で説明されているインストール手順に従ってください。

表1-2 プラグイン別のアップグレード手順

12c (12.2.1.1.0)プラグインにアップグレードする対象サーバー:

次を参照してください。

Oracle HTTP Server

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

Apache HTTPサーバー

Apache HTTP Server用プラグインの構成

iPlanet Web Server

iPlanet Web Server用プラグインの構成

Microsoft IIS Webサーバー

Microsoft IIS Web Server用プラグインの構成

1.3.2 Oracle WebLogic Serverプロキシ・プラグインのバージョン1.0から12c (12.2.1)へのアップグレードの考慮事項

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

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

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

注意:

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

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

この項では、バージョン12c (12.2.1)プラグインの追加機能について説明します。

- Oracle WebLogic Serverプロキシの監視

- マルチテナンシおよびパーティションのサポート

- iPlanet Web ServerのSSLサポート

- IIS 7.5でプラグインを使用する場合のドキュメント

- MD5アルゴリズムを使用して署名された証明書の非推奨になったサポート

1.4.1 Oracle WebLogic Serverプロキシの監視

現在のリリースでは、Oracle HTTP Serverのパフォーマンスを監視するためのサポートが追加されています。パフォーマンス・メトリックは、リクエストがバックエンドWebLogicサーバーにプロキシされるOracle WebLogic Serverプロキシ・プラグインに固有です。「Oracle WebLogic Serverプロキシ・プラグインのパフォーマンス・メトリックの理解」を参照してください。

1.4.2 マルチテナンシおよびパーティションのサポート

現在のリリースでは、Oracle WebLogic Serverプロキシ・プラグインをパーティション認識にすることができます。これは、Oracle WebLogic Server MT (マルチテナンシ)のサポートで役割を果します。「パーティションの操作」を参照してください。

1.4.3 iPlanet Web ServerのSSLサポート

現在のリリースでは、iPlanet Web ServerでSSLを使用するためのサポートが追加されています。「iPlanet Web Server用プラグインでのSSLの構成」を参照してください。

1.4.4 IIS 7.5でプラグインを使用する場合のドキュメント

Microsoft IIS Web Server 7.5でOracle WebLogic Serverプロキシ・プラグインを使用するための手順が追加されています。「Microsoft IIS 7.5プラグインの操作」を参照してください。

1.4.5 MD5アルゴリズムを使用して署名された証明書の非推奨になったサポート

MD5を使用して署名された証明書のサポートは非推奨です。「MD5アルゴリズムを使用して署名された証明書の置換」を参照してください。

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

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

WebLogic Server Plug-in version 12.2.1 <WLSPLUGINS_XXXX_XXXX_XXXXX.XXXX>

注意:

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

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

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

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

Oracle WebLogic Serverプロキシ・プラグイン()を構成します。これは、Oracle HTTP ServerからOracle WebLogic Serverにリクエストをプロキシするためのプラグインです。Oracle WebLogic Serverプロキシ・プラグインは、Oracle HTTP Server 12c (12.2.1.1.0)インストールに含まれます。別途ダウンロードしてインストールする必要はありません。

注意:

Oracle WebLogic Serverプロキシ・プラグインには、Apache HTTP Server用のプラグインと同じ機能が用意されています。

Oracle WebLogic Serverプロキシ・プラグインは、Fusion Middleware Controlを使用するか、mod_wl_ohs.conf構成ファイルを手動で編集することで構成できます。

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

- Oracle HTTP Serverのサポートに関する注意事項

- Oracle WebLogic Serverプロキシ・プラグインの構成準備

- Fusion Middleware Controlを使用したOracle WebLogic Serverプロキシ・プラグインの構成

- Oracle WebLogic Serverプロキシ・プラグインの手動による構成

- Oracle WebLogic Serverプロキシ・プラグインのパフォーマンス・メトリックの理解

- Oracle HTTP Serverの非推奨ディレクティブ

- Oracle WebLogic Serverプロキシ・プラグインの実装に関するトラブルシューティング

2.1 Oracle HTTP Serverのサポートに関する注意事項

Oracle HTTP Server用Oracle WebLogic Serverプロキシ・プラグインは、WebSocketアプリケーションのフロントエンドとなることができるようになりました。

2.2 Oracle WebLogic Serverプロキシ・プラグインの構成準備

Oracle WebLogic Serverプロキシ・プラグインを構成する前に、一部のインストールおよび検証タスクを完了する必要があります。

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

- Fusion Middleware Controlがインストールされており、Enterprise Managerコンソールにアクセスできることを確認します。これは、Fusion Middleware Controlに用意されているグラフィカル・インタフェースを使用してOracle WebLogic Serverプロキシ・プラグインを構成する場合に必要になります。Fusion Middleware Controlは、WebLogic管理対象ドメインにのみ利用できます。

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

2.2.1 「WebLogicプラグインの有効化」パラメータの設定

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

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

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

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

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

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

4. 「WebLogic Server」ドロップダウン・メニュー、「管理」、「一般」設定の順に選択します。

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

5. 下にスクロールして「詳細」セクションを開き、「WebLogicプラグインの有効化」ドロップダウン・リストから「はい」を選択します。

WebLogicプラグインをWebLogic Serverと使用する場合には、「はい」を選択する必要があります。詳細は、「「WebLogicプラグインの有効化」パラメータの理解」を参照してください。

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

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

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

2.2.1.1 「WebLogicプラグインの有効化」パラメータの理解

「WebLogicプラグインの有効化」ドロップダウン・リストには次の値が含まれます。

- はい: WebLogicプラグインをWebLogic Serverと使用する場合には、「はい」を選択する必要があります。サーバーで「はい」に設定すると、このサーバーで独自のWL-Proxy-Client-IPヘッダーを使用することを指定することになります。サーバー・インスタンスがプロキシ・プラグインからリクエストを受信する場合は、設定することをお薦めします。
クラスタで「はい」に設定すると、クラスタがプロキシ・プラグインまたはHttpClusterServletからのリクエストを受信することを指定することになります。getRemoteAddrを呼び出すと、Webサーバーではなく、独自のWL-Proxy-Client-IPヘッダーからブラウザ・クライアントのアドレスが戻されます。

- いいえ: サーバーまたはクラスタで「いいえ」を選択すると、config.xmlファイルのweblogic-plugin-enabledパラメータが無効になります(weblogic-plugin-enabled=false)。

- デフォルト: サーバー・ページの「WebLogicプラグインの有効化」で「デフォルト」を選択すると、サーバーはクラスタの「WebLogicプラグインの有効化」に選択した値を継承します。クラスタ・ページの「WebLogicプラグインの有効化」で「デフォルト」を選択すると、クラスタはドメインの「WebLogicプラグインの有効化」に選択した値を継承します。

2.3 Fusion Middleware Controlを使用したOracle WebLogic Serverプロキシ・プラグインの構成

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

- タスク1: 「mod_wl_ohs構成」ページに移動

- タスク2: 構成設定の指定

- タスク3: 式のオーバーライドまたはロケーションのオーバーライドの構成(省略可)

- タスク4: 変更の適用

2.3.1 タスク1: 「mod_wl_ohs構成」ページに移動

「mod_wl_ohs構成」ページには、Oracle WebLogic Serverプロキシ・プラグインを構成するためのパラメータがあります。

1. 「Oracle WebLogic Serverプロキシ・プラグインの構成準備」に示されている前提条件が満たされていることを確認します。

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

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

次の表では、mod_wl_ohsページのフィールドについて説明します。

フィールド

説明

WebLogicクラスタ詳細の指定

ロード・バランシングに使用可能なOracle WebLogicクラスタのリスト。サーバーまたはクラスタのリストは、host:portエントリのリストです。クラスタとシングル・サーバーを組み合せて指定した場合、このパラメータに対して返される動的リストには、クラスタ化されたサーバーのみが含まれます。

適切なクラスタかどうかがわからない場合は、検索アイコンをクリックして、関連付けられたすべてのクラスタのリストを表示できます。詳細は、「検索機能の使用」を参照してください。

このモジュールは、すべての使用可能なサーバーの間の単純なラウンドロビンを実行します。このプロパティで指定したサーバー・リストが、サーバーとモジュールが保持する動的サーバー・リストの開始点となります。Oracle WebLogicサーバーおよびこのモジュールの連携により、このサーバー・リストは新規、失敗およびリカバリされたクラスタ・メンバーで自動的に更新されます。

動的クラスタ・リストの使用を無効にするには、「動的サーバー・リストをオン」フィールドを無効にします。このモジュールはCookie、URLエンコード済セッション、またはPOSTデータに格納されたセッションを含むHTTPリクエストを、最初にCookieを作成したクラスタ内のサーバーに送信します。

WebLogic Serverホストおよびポート詳細の指定

- WebLogicホスト
HTTPリクエストが転送される、Oracle WebLogic Serverホスト(またはOracle WebLogic Serverに定義されている仮想ホスト名)。WebLogicクラスタを使用している場合は、「WebLogicホスト」ではなく「WebLogicクラスタ」パラメータを使用します。

適切なサーバーかどうかがわからない場合は、検索アイコンをクリックして、関連付けられたすべてのクラスタのリストを表示できます。詳細は、「検索機能の使用」を参照してください。

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

動的サーバー・リストをオン | オフ

オフに設定すると、モジュールはプロキシ設定されたロード・バランシング・リクエストに使用される動的クラスタ・リストを無視し、WebLogicクラスタ・パラメータで指定された静的リストのみを使用します。通常は、このパラメータをオンに設定してください。

このパラメータをオフに設定した場合、次のような影響があります。

- 静的リスト内の1つ以上のサーバーが失敗した場合、モジュールは終了したサーバーへの接続を試行し無駄な時間を費やすことがあるため、パフォーマンスが低下します。

- クラスタに新しいサーバーを追加した場合、このパラメータを再定義しないかぎりモジュールは新しいサーバーへリクエストをプロキシ設定できません。Oracle WebLogic Serverは、新しいサーバーがクラスタの一部になると、これらのサーバーを動的サーバー・リストへ自動的に追加します。

エラー・ページ

WebサーバーでリクエストをOracle WebLogic Serverに転送できない場合に表示されるよう、独自のエラー・ページを作成できます。

WebLogic一時ディレクトリ

ポスト・データ・ファイル用の_wl_proxyディレクトリの場所を指定します。

パスまたはMIMEタイプの除外

このパラメータを使用すると、特定のリクエストをプロキシ処理から除外できます。

このパラメータは、グローバルに定義することも、「場所」タグ・レベルでローカルに定義することもできます。このプロパティをローカルに定義した場合、グローバルなプロパティがオーバーライドされるのではなく、2つのパラメータの集合が定義されます。

一致式

このリージョンを使用して、式のオーバーライドを指定します。たとえば、MIMEタイプでプロキシしている場合には、次のように入力できます。

*.jsp WebLogicHost=myHost|paramName=value

次の構文を使用することで、「一致式」の新しいパラメータを定義できます。

*.jsp PathPrepend=/test|PathTrim=/foo

(パラメータは|で区切られます)

ロケーション

この表を使用して、ロケーションのオーバーライドを指定します。「タスク3: 式のオーバーライドまたはロケーションのオーバーライドの構成(省略可)」を参照してください。

クロス・コンポーネント・ワイヤリングの追加

このボタンは、Oracle HTTP Serverを完全JRFモード(コロケート)でインストールし、バッキング・データベースがある場合にのみ表示されます。

このボタンを選択すると、サービス表ページが開きます。サービス表を使用して、サービス・プロバイダはサービスのエンドポイント情報を公開し、これらのサービスのクライアントはこれらのサービスに問い合せてバインドすることができます。サービス表はデータベース・スキーマの単一の表です。パブリッシュされる各エンドポイントに対して1行あります。サービス表スキーマは、最初にリポジトリ作成ユーティリティにより作成されます。

詳細は、Oracle Fusion Middlewareの管理のクロス・コンポーネント・ワイヤリングを参照してください

2.3.2 タスク2: 構成設定の指定

Oracle WebLogic Serverプロキシ・プラグインの構成設定を指定します。「一般」セクションで、WebLogicクラスタまたはWebLogicサーバーのmod_wl_ohsを構成できます。

- 「WebLogicクラスタ詳細の指定」ラジオ・ボタンを選択する場合、「WebLogicクラスタ」、「動的サーバー・リストをオン」、「エラー・ページ」、「WebLogic一時ディレクトリ」、「パスまたはMIMEタイプの除外」の各フィールドに値を指定します。

- 「WebLogic Serverホストおよびポート詳細の指定」ラジオ・ボタンを選択する場合、「WebLogicホスト」、「WebLogicポート」、「動的サーバー・リストをオン」、「エラー・ページ」、「WebLogic一時ディレクトリ」、「パスまたはMIMEタイプの除外」の各フィールドに値を指定します。

2.3.3 タスク3: 式のオーバーライドまたはロケーションのオーバーライドの構成(省略可)

必要に応じて、式のオーバーライドやロケーションのオーバーライドを構成に追加できます。

1. 「一致式」フィールドで式のオーバーライドを追加します。

2. 「ロケーション」表でロケーションのオーバーライドを追加します。

a. 「行の追加」をクリックして新規行を作成します。

b. 関連付けられているディレクティブが有効になる、ベースURIを入力します。

c. 「WebLogicクラスタ」、「WebLogicホスト」および「WebLogicポート」フィールドにすべて入力します。「自動入力」をクリックすることで、これらのフィールドに自動入力できます(「自動入力機能の使用」を参照)。

d. 「パスの切捨て」フィールドに入力します。
RFC仕様に従うと、URLの汎用構文は次のとおりです。

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

「パスの切捨て」は、リクエストがWebLogic Serverに転送される前に、モジュールによって元のURLの{PATH}/{FILENAME}部分から切り捨てられる文字列を指定します。たとえば、URLが次のとおりだとします。

http://myWeb.server.com/weblogic/foo

このURLは、解析のためにモジュールに渡されます。また「パスの切捨て」がURLをWebLogic Serverに渡す前に/weblogicを切り捨てるように設定されている場合、WebLogic Serverには次のURLが転送されます。

http://myWeb.server.com:7002/foo

注意:

既存のサード・パーティ製サーバーを変更し、初めてこのモジュールを使用してWebLogic Serverにリクエストをプロキシする場合は、/fooへのアプリケーション・パスをweblogic/fooを含むよう変更する必要があります。「パスの切捨て」と「パスの付加」を併用することで、このパスを変更できます。

e. 「パスの付加」フィールドに入力します。
RFC仕様に従うと、URLの汎用構文は次のとおりです。

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

「パスの付加」は、「パスの切捨て」の値が切り捨てられてからリクエストがWebLogic Serverに転送されるまでの間に、モジュールによって元のURLの{PATH}部分の先頭に付加されるパスを指定します。

注意:

ファイル名を付加する必要がある場合は、「パスの付加」ではなくDefaultFileNameモジュール・パラメータを使用してください。

f. 再度「行の追加」をクリックして、新しい行を保存します。

2.3.4 タスク4: 変更の適用

「mod_wl_ohs構成」ページに変更を適用して、Oracle HTTP Serverを再起動します。

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

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

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

2.3.5 検索機能の使用

検索機能を使用すると、選択したOracle HTTP Serverインスタンスで利用可能な特定のWebLogicクラスタまたはWebLogicホストを検索できます。検索アイコンをクリックすることで、選択したOracle HTTP Serverインスタンスで使用可能なクラスタまたはサーバーのリストを表示できます。検索機能を使用する手順は、次のとおりです。

1. 「WebLogicクラスタ」または「WebLogicホスト」の検索アイコンをクリックします。「WebLogicクラスタの選択」または「WebLogic Serverの選択」ダイアログ・ボックスが表示されます。

2. 使用するクラスタまたはサーバーを選択して、「OK」をクリックします。

選択したクラスタまたはサーバーの名前が、該当するフィールドに表示されます。

2.3.6 自動入力機能の使用

注意:

「自動入力」機能は、完全JRFモードでOracle WebLogic Serverを使用する場合のみ利用できます。制限JRFを使用する場合は利用できません。

「自動入力」ボタンを使用することで、指定したベースURLに対する有効なWebLogic Serverおよびエンドポイントの場所をOracle WebLogic Serverプロキシ・プラグインの「構成」画面の「ロケーション」表に簡単に追加できます。このための手順は、次のとおりです。

1. 「追加」をクリックして、新しいロケーションを追加します。

2. 「ロケーション」フィールドにロケーション名を入力します。

3. 「自動入力」をクリックします。

同一名の場所のデータは更新され、新しい場所は表に追加されます。

2.4 Oracle WebLogic Serverプロキシ・プラグインの手動による構成

mod_wl_ohs.confファイルにディレクティブを指定して、Oracle WebLogic Serverプロキシ・プラグインを手動で構成します。

1. 「Oracle WebLogic Serverプロキシ・プラグインの構成準備」に示されている前提条件が満たされていることを確認します。

2. テキスト・エディタでmod_wl_ohs.confファイルを開きます。

mod_wl_ohs.confファイルは次のディレクトリにあります。

DOMAIN_HOME/config/fmwconfig/components/OHS/componentHome

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

たとえば、「<IfModule weblogic_module>要素の構成例」を参照してください。

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

4. Oracle HTTP Serverの管理のOracle HTTP Serverの起動で説明されているいずれかの方法でOracle HTTP Serverを再起動します。

2.4.1 <IfModule weblogic_module>要素の構成例

事前定義済の<IfModule weblogic_module>要素の構成によって、リクエストがどのようにOracle WebLogic Serverに送信されるかが決まります。次の例は、この要素を構成できる様々な方法を示しています。

注意:

事前定義済の<IfModule weblogic_module>要素内でディレクティブを指定することをお薦めします。

事前定義済の<IfModule weblogic_module>要素の外や、追加された<IfModule weblogic_module>要素内、またはmod_wl_ohs.conf以外の構成ファイル内でディレクティブを指定した場合、Oracle WebLogic Serverプロキシ・プラグインは機能したとしても、Fusion Middleware Controlで表示されるモジュールの構成状態は、mod_wl_ohs.conf構成ファイル内で指定したディレクティブと矛盾する可能性があります。

単一のOracle WebLogic Serverインスタンスにリクエストを転送する場合

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

構文:

<IfModule weblogic_module>
<Location path>
WLSRequest On
WebLogicHost host
WeblogicPort port
</Location>
</IfModule>

例:

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

<IfModule weblogic_module>
<Location /myapp1>
WLSRequest On
WebLogicHost localhost
WeblogicPort 7001
</Location>
</IfModule>

Oracle WebLogic Serverインスタンスのクラスタにリクエストを転送する場合

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

構文:

<IfModule weblogic_module>
<Location path>
WLSRequest On
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>
WLSRequest On
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>
WLSRequest On
WebLogicHost host
WeblogicPort port
</Location>

#For an application running on a cluster
<Location path2>
WLSRequest On
WebLogicCluster host:port,host:port,...
</Location>

</IfModule>

管理対象サーバーにリンクする場合

たとえばOracle HTTP Serverの高可用性デプロイメントを有効にするため、Oracle WebLogic Serverプロキシ・プラグインを管理対象サーバーにリンクできるように構成するには、mod_wl_ohs.confファイルを次のように編集します。

<IfModule mod_weblogic.c>
WebLogicCluster apphost1.mycompany.com:7050,apphost2.mycompany.com:7050
MatchExpression *.jsp
</IfModule>

<Location /weblogic>
WLSRequest On
WebLogicCluster apphost1.mycompany.com:7050,apphost2.com:7050
DefaultFileName index.jsp
</Location>

注意:

SSL終端を使用しており、リクエストをWebLogicにルーティングする場合は、さらに次の構成が必要です。

WebLogicコンソールで、ドメイン、クラスタまたは管理対象サーバーのレベルで「WebLogicプラグインの有効化」を「true」に設定する必要があります。

WebLogic管理対象サーバーにリクエストを送信するLocationブロックに、次の行のどちらかを追加することも必要です。

WLProxySSL ON
WLProxySSLPassThrough ON

(使用するパラメータの決定には、「Webサーバー・プラグインのSSLパラメータ」を参照してください。)

次にその例を示します。

<Location /weblogic>
WLSRequest On
WebLogicCluster apphost1.mycompany.com:7050,apphost2.com:7050
WLProxySSL On
WLProxySSLPassThrough ON
DefaultFileName index.jsp
</Location>

WebLogicプラグインを有効化した後、管理サーバーを再起動します。

詳細は、『Oracle HTTP Serverの管理』のSSLリクエストの終了に関する項を参照してください。

この例は、Oracle WebLogic管理対象サーバーにリクエストをルーティングする2つの方法を示しています。

- <IfModule>ブロックでは、*.jspで終わるすべてのリクエストがApphost1およびApphost2上にあるWebLogic管理対象サーバーのクラスタに送信されます。

- <Location>ブロックでは、/weblogicで始まるURLのすべてのリクエストがApphost1およびApphost2上にあるWebLogic管理対象サーバーのクラスタに送信されます。

一方向および双方向SSLを構成する場合

Oracle HTTP ServerとOracle WebLogic Serverとの間の一方向SSLおよび双方向SSLをサポートするようOracle WebLogic Serverプロキシ・プラグインを構成する方法の詳細は、「プラグインでのSSLの使用」を参照してください。

2.5 Oracle WebLogic Serverプロキシ・プラグインのパフォーマンス・メトリックの理解

Oracle HTTP Serverには、リクエストがバックエンドWebLogicサーバーにプロキシされるOracle WebLogic Serverプロキシ・プラグイン(mod_wl_ohs)モジュールに固有のパフォーマンス・メトリックが用意されています。

これらのメトリックは、Oracle Dynamic Monitoring Service (DMS)経由で提供されます。これを使用すると、Oracle Fusion Middlewareのコンポーネントは、Fusion Middleware Controlなどの管理ツールに、コンポーネントのパフォーマンス、状態および進行中の動作に関するデータを提供できるようになります。たとえば、Oracle WebLogic Serverプロキシ・プラグイン・モジュールの場合、プロキシされたリクエストの数、失敗したリクエストの数、その他固有のメトリックが返されます。DMSの詳細は、『パフォーマンスのチューニング・ガイド』のOracle Dynamic Monitoring Serviceの使用に関する項を参照してください。

注意:

Oracle WebLogic Serverプロキシ・プラグイン・モジュールのメトリックは、Oracle HTTP ServerおよびApache Serverプラグインにのみ利用できます。Microsoft IISおよびiPlanet Serverプラグインでは利用できません。

この項では、DMSメトリックに関する次の情報について説明します。

- 「Oracle HTTP Serverプロキシ・プラグイン用のDMSメトリックの構成」 - Oracle WebLogic ServerのDMSメトリックの構成方法。

- 「Oracle HTTP Serverプロキシ・プラグイン用のパフォーマンス・メトリックの表示」 - Oracle WebLogic ServerのDMSメトリックの表示方法。

- 「DMS状態メトリック」 - これらのメトリックは、カウンタやステータスなどの単一データ・ポイントを表します。

- 「DMSイベント・メトリック」 - これらのメトリックは、ログインの失敗などのイベントを表します。

- 「DMSフェーズPhaseEventメトリック」 - これらのメトリックは、イベントのフェーズを表します。

2.5.1 Oracle HTTP Serverプロキシ・プラグイン用のDMSメトリックの構成

Oracle WebLogic Serverプロキシ・プラグイン用のDMSメトリックは、admin.confファイルでデフォルトで有効です。これらは、通常のDMSメトリック・コレクションの一部として含まれます。

2.5.2 Oracle HTTP Serverプロキシ・プラグイン用のパフォーマンス・メトリックの表示

パフォーマンス・メトリックを表示するには、管理ポート、WLSTコマンドまたはFusion Middleware Controlのいずれかを使用します。各パフォーマンス・メトリックの詳細は、「DMS状態メトリック」、「DMSイベント・メトリック」および「DMS PhaseEventメトリック」を参照してください。

管理コンソールを使用する場合:

たとえば、127.0.0.1:9999で管理ポートを構成する場合、生のDMSメトリックをURL http://127.0.0.1/dms/で表示できます。

セクション/WebLogicProxy [type=OHSWebLogic]のメトリックは、Oracle WebLogic Serverプラグインからのメトリックになります。

WLSTの使用(コロケート・モードのみ)

WLSTコマンドdisplayMetricTablesを使用して、パフォーマンス・メトリックを表示します。たとえば、次のようになります。

displayMetricTables(servertype="OHS", servers=<instancename>)

セクション/WebLogicProxy [type=OHSWebLogic]のメトリックは、Oracle WebLogic Serverプロキシ・プラグインからのメトリックになります。

Fusion Middleware Controlの使用(コロケート・モードのみ)

Fusion Middleware Controlでパフォーマンス・メトリックを表示するには、「Oracle HTTP Server」、「モニタリング」、「パフォーマンス・サマリー」の順に選択します。このページの下部にあるメトリックには、Oracle WebLogic Serverプロキシ・プラグインに固有のメトリックがあります。『Oracle HTTP Serverの管理』のパフォーマンス・メトリックの表示に関する項を参照してください。

2.5.3 DMS状態メトリック

状態メトリックは、システムのステータス情報や、イベントに関係のないメトリックを追跡します。表2-1では、Oracle WebLogic Serverプロキシ・プラグイン・モジュールに利用可能な状態メトリックについて説明します。

これらのメトリックは、Oracle WebLogic ServerおよびApache HTTP Serverプラグインの場合に返されます。

表2-1 Oracle WebLogic Serverプロキシ・プラグイン・モジュールの状態メトリック

メトリック名

説明

totalDeclines

拒否された(mod_wl_ohsで処理されない)リクエストの合計数。この数は、構成されないリクエストまたはプラグインで拒否されるリクエスト(カスタムHTTPメソッドが常にプラグインで拒否される場合など)を表します。

totalErrors

正常に処理できなかったリクエストの数。エラーについては、イベント・メトリックを参照してください。

totalHandled

mod_wl_ohsプラグインにより処理されたリクエストの合計数。

totalRequests

mod_wl_ohsにより受信されたリクエストの合計数。この数には、プラグインの対象となるすべてのリクエストに加えて、任意のモジュールの対象とならない(構成されない)リクエストが含まれます。

totalRetries

リクエストが再試行された回数。リクエストは、通常、失敗すると再試行されます(構成により異なる)。これまでにリクエストが再試行された場合、このメトリックは増分します(リクエストが再試行された回数に関係なく、リクエストごとに1回)。

totalSuccess

処理に成功したリクエストの数。リクエストの処理が成功した場合(Oracle WebLogic Serverにプロキシされてレスポンスがクライアントに返される)、このメトリックは増分します。

websocketActive

現在アクティブなWebSocketアップグレード・リクエストの数。

websocketClose

終了したWebSocketアップグレード・リクエストの数。WebSocketセッションを(なんらかの理由で)終了する場合、このメトリックが更新されます。

websocketMax

アクティブの可能性がある同時WebSocketリクエストの最大数。

WLMaxWebSocketClientsパラメータを構成する場合、次の値よりも低くなります。

- 構成値または

- MaxRequestWorkersの値の0.75 (Oracle HTTP ServerおよびApache 2.4)または

- MaxClientsの値の0.75 (Apache 2.2)または

- ThreadsPerChildの値の0.75 (Oracle HTTP ServerおよびApache 2.2/2.4、Windowsのみ)

WLMaxWebSocketClientsパラメータを構成しない場合、値は次のようになります。

- MaxRequestWorkersの値の0.5 (Oracle HTTP ServerおよびApache 2.4)または

- MaxClientsの値の0.5 (Apache 2.2)または

- ThreadsPerChildの値の0.5 (Oracle HTTP ServerおよびApache 2.2/2.4、Windowsのみ)

WLMaxWebSocketClientsパラメータの詳細は、「WebSocketアップグレード・リクエストの高スループットに対するOracle HTTP ServerおよびApache HTTP Serverのチューニング」を参照してください。

websocketPercent

この値を定義するには、次のように、アクティブなWebSocketsの数(websocketActive)を同時WebSocketリクエストの最大数(websocketMax)で除算した値に100を掛けます。

(websocketActive/webocketMax)*100.

websocketRequests

作成されたWebSocketアップグレード・リクエストの数。リクエストURIがWebSocketアップグレード・リクエストの場合、このメトリックは増分します。

websocketSuccess

正常に完了したWebSocketアップグレード・リクエストの数。Oracle WebLogic Serverが「101 プロトコルの切替え中」でWebSocketアップグレード・リクエストに応答する場合、このメトリックは更新されます。

2.5.4 DMSイベント・メトリック

DMSイベント・メトリックは、システム・イベントをカウントします。DMSイベントは、継続時間の短いシステム・イベントや、イベントの継続時間よりもイベントの発生が重要な場合のイベントを追跡します。表2-2では、Oracle WebLogic Serverプロキシ・プラグイン・モジュールに利用可能なイベント・メトリックについて説明します。

これらのメトリックは、Oracle WebLogic ServerおよびApache HTTP Serverプロキシ・プラグインの場合に返されます。

表2-2 Oracle WebLogic Serverプロキシ・プラグイン・モジュールのイベント・メトリック。

メトリック名

説明

errConnRefused

CONNECTION_REFUSEDエラーの数。構成されたWebLogicHostまたはWebLogicPortに到達できないか、リスニングしない回数を表します。

errNoResources

NO_RESOURCESエラーの数この例外が発生する可能性のある1つのシナリオとして、SSLをプラグインで構成しても、対応するSSL構成を管理対象サーバーで定義しない場合があります。

errOthers

他のエラーの数。たとえば、POSTデータ・サイズは、MaxPostSizeの値よりも大きくなります。

errReadClient

READ_ERROR_FROM_CLIENTエラーの数。プラグインがクライアント(ブラウザ)から読み込まれなかった回数を表します。

errReadServer

READ_ERROR_FROM_SERVERエラーの数。読取り操作がOracle WebLogic Serverで正常に行われなかった回数を表します。

errReadTimeout

READ_TIMEOUTエラーの数。たとえば、WLIOTimeoutSecs内でOracle WebLogic Serverが応答しない場合などがあります。

errWriteClient

WRITE_ERROR_TO_CLIENTエラーの数。プラグインがクライアントに書き込むことができなかった回数を表します。これは、クライアントがリクエストを送信してもレスポンスの受信前に接続を終了する場合に表示されます。

errWriteWLS

WRITE_ERROR_TO_SERVERエラーの数。プラグインがOracle WebLogic Serverに書き込むことができなかった回数を表します。

wsClientClose

クライアントにより終了したWebSocketアップグレード・リクエストの数。クライアントがWebSocketアップグレード・リクエストを送信してクライアントが接続を終了する場合、このメトリックは更新されます。

wsErrorClose

エラーが原因で終了したWebSocketセッションの数。WebSocket接続が終了する原因となるエラーがある場合、このメトリックは更新されます。

wsNoUpgrade

WebSocketアップグレード・リクエストが拒否された回数。WebSocketアップグレード・リクエストのレスポンスは「101 プロトコルの切替え中」ではありません。これは、WebSockets (Oracle WebLogic Serverバージョン12.1.2以前)をサポートしないOracle WebLogic Serverにアップグレード・リクエストが送信される場合に発生します。

wsServerClose

サーバーにより終了したWebSocketアップグレード・リクエストの数。Oracle WebLogic ServerがWebSocket通信の終了を開始する場合、このメトリックは更新されます。たとえば、リクエストのアップグレード後のタイムアウトまたは通信なし(デフォルトで5分)など。

2.5.5 DMS PhaseEventメトリック

DMS PhaseEventメトリックは、コード内の特定セクションの開始から終了までにかかる時間を測定します。PhaseEventは、あるメソッドまたはコード・ブロックの時間を追跡します。フェーズ・イベントごとに、「アクティブな件数」、「完了した件数」、「合計時間」、「最小時間」、「最大時間」、「平均時間」の値が含まれます。表2-3では、Oracle WebLogic Serverプロキシ・プラグイン・モジュールに利用可能なPhaseEventメトリックについて説明します。

これらのメトリックは、Oracle WebLogic ServerおよびApache HTTP Serverプロキシ・プラグインの場合に返されます。

表2-3 Oracle WebLogic Serverプロキシ・プラグイン・モジュールのPhaseEventメトリック

メトリック名

説明

websocketPhase

進行中のWebSocket通信。「WebSocketアップグレードの成功」から「WebSocket接続の終了」までのフェーズ(時間)

wlsWait

「Oracle WebLogic Serverへのリクエストの送信」から「レスポンスの待機中」までのフェーズ(時間)。

2.6 Oracle HTTP Serverの非推奨ディレクティブ

Oracle WebLogic Serverプロキシ・プラグイン用のWebLogic Serverプラグイン・ログは、現在はWeb Serverのエラー・ログ・メカニズムの一部となっています。モジュール名をweblogicとしてリファレンスを識別できます。たとえば、次のようになります。

[2015-05-14T00:43:27.8355-06:00] [OHS] [TRACE:16] [OH99999] [weblogic] [client_id: ::1] [host_id: XXXXXXXX] [host_addr: XX.XXX.XXX.XXX] [pid: 1240] [tid: 2424] [user: sramavan] [ecid: 00iT9hK4DrhFw0zobn063z0BvEE3zsYyk0000JO00000H] [rid: 0] [VirtualHost: main] ================New Request: [GET /favicon.ico HTTP/1.1] =================

ディレクティブWLLogFileおよびDebugは非推奨です。構成でこれらのディレクティブを使用すると、次の注意がノード・マネージャのプラグイン・ログ・ファイル(ohs_nm.log)に表示されます。

<2015-05-14 00:36:25> <INFO> <OHS-0> <[Thu May 14 00:36:25.723286 2015] [weblogic:warn] [pid 5084:tid 668] The Debug directive is ignored. The web server log level is used instead.>

<2015-05-14 00:36:25> <INFO> <OHS-0> <[Thu May 14 00:36:25.724263 2015] [weblogic:warn] [pid 5084:tid 668] The WLLogFile directive is ignored. The web server log file is used instead.>

プラグイン・ログを有効にするには:

- OraLogModeをODL-textに設定した場合は、OraLogSeverityをTRACE:16に設定します。これらのログは、OraLogDirディレクトリに表示されます(instance-name.log)。これはデフォルトの設定です。

- OraLogModeをapacheに設定した場合は、LogLevelをdebugに設定します。ディレクティブErrorLogは、エラーの記録先となるファイルを示します。

Oracle HTTP Serverのログの管理の詳細は、『Oracle HTTP Serverの管理』のOracle HTTP Serverのログの管理に関する項を参照してください。

2.7 Oracle WebLogic Serverプロキシ・プラグインの実装に関するトラブルシューティング

Oracle WebLogic Serverプロキシ・プラグインを使用する場合、次の問題の一部が発生する可能性があります。これらの問題の解決方法について説明します。

- WLSセッションの問題

- CONNECTION_REFUSEDエラー

- NO_RESOURCESエラー

- Oracle WebLogic Serverキーストアの変更により予想外の動作が発生する

2.7.1 WLSセッションの問題

Oracle WebLogic Serverプロキシ・プラグインにより、バックエンドのOracle WebLogic Serverまたはクラスタにリクエストがルーティングされます。Oracle WebLogic Serverでは、同一クライアントからの後続リクエストが同一サーバーにルーティングされるようにセッションを維持します。ただし、様々な理由により、Oracle WebLogic Serverプロキシ・プラグインがOracle WebLogic Serverサーバーと通信できない場合、リクエストは次の方法で処理されます。

- リクエストが単一のWebLogic Serverインスタンスにルーティングされると、Oracle WebLogic Serverプロキシ・プラグインは、ConnectTimeoutSecsとConnectRetrySecsの比で指定されている最大再試行回数まで、同じWebLogic Serverインスタンスへの接続の試行を継続します。すべての試みが失敗すると、クライアントにHTTP 503エラー・メッセージが返されます。

- リクエストがWebLogicクラスタにルーティングされると、現在のWLSサーバーはbadとしてマークされ、そのリクエストは次に使用可能なWLSサーバーにルーティングされます。すべての試みが失敗すると、クライアントにHTTP 503エラー・メッセージが返されます。

HTTP 503エラー・メッセージが送信されるほか、レスポンスとしてHTTPクライアントで次のメッセージが表示されます。

Failure of Web Server bridge:
No backend server available for connection: timed out after xx seconds or idempotent set to OFF or method not idempotent.

2.7.2 CONNECTION_REFUSEDエラー

ストレス条件下では、いくつかのリクエストが失敗し、エラー・ログ・ファイルに次のエラーが記録される場合があります。

weblogic: Trying GET /uri at backend host 'xx.xx.xx.xx/port; got exception 'CONNECTION_REFUSED [os error=xxx, line xxxx of URL.cpp]: apr_socket_connect call failed with error=xxx, host=xx.xx.xx.xx, port=xxxx'

「CONNECTION_REFUSEDエラーを減らすためのヒント」で説明されているように、Oracle WebLogic Serverが最大許容バックログ接続に達した可能性があります。

解決するには、「CONNECTION_REFUSEDエラーを減らすためのヒント」で説明されている手順に従ってください。

2.7.3 NO_RESOURCESエラー

ストレス条件下では、いくつかのリクエストが失敗し、エラー・ログ・ファイルに次のエラーが記録される場合があります。

weblogic: *******Exception type [NO_RESOURCES] (apr_socket_connect call failed with error=70007, host=xx.xx.xx.xx, port=xxxx) raised at line xxxx of URL.cpp

これは通常、Oracle WebLogic Serverがビジー状態でOracle WebLogic Serverプロキシ・プラグインからの接続リクエストに応答できない場合に発生します。WLSocketTimeoutSecsの値を大きくすることで解決される場合があります。これにより、Oracle WebLogic Serverプロキシ・プラグインでの、接続リクエストに対するOracle WebLogic Serverからのレスポンスを待機する時間は長くなります。

2.7.4 Oracle WebLogic Serverキーストアの変更により予想外の動作が発生する

(たとえば、Oracle HTTP ServerとOracle WebLogic Serverとの間でバックエンドの一方向SSLを設定して)Oracle WebLogic Serverキーストアを変更する場合、Oracle WebLogic ServerとNodeManagerの間の通信が遮断される可能性があります。これが発生する場合、WLSTから発行されるすべてのプロビジョニングおよびプロセス管理コマンドにも影響があります。この状況でのエラー・メッセージは適切ではないため、状況が混乱する場合があります。たとえば、NodeManagerが明らかに稼働していることがユーザーに表示される場合でも、一部のエラーでは停止状態が示されます。

ここでは、発生の可能性がある予想外の動作の例をいくつか示します。これらの例では、NodeManagerが稼働していることに注意してください。

- Oracle HTTP Serverインスタンスに対して実行されたすべてのstate()コマンドがUNKNOWNを返す場合。

wls:/OHSDomain/serverConfig/> state('ohs1')
Current state of "ohs1" : UNKNOWN

- Oracle HTTP Serverプロセス管理コマンドがSSLEngineエラーを返す場合:

wls:/OHSDomain/serverConfig/> start('ohs1')
Starting system component "ohs1" ...

General SSLEngine problem
Traceback (innermost last):
File "<console>", line 1, in ?
File "<iostream>", line 1384, in start
File "<iostream>", line 553, in raiseWLSTException
WLSTException: Error occurred while performing start : System component with
name "ohs1" failed to start : General SSLEngine problem
....

- Oracle HTTP Serverカスタム・コマンドohs_createInstanceが、NodeManagerが停止していることを示すメッセージを返し、バックアップされるとコマンドが完了する場合。例:

ohs_createInstance(instanceName='ohs1',machine='myMachine.myCompany.com')
....
The node manager for "ohs1" is not reachable. Changes will be completed when the node manager is available.
The node manager error is: Node Manager is not available on machine myMachine.myCompany.com
Activation completed.

回避策:

この問題を回避するには、NodeManagerデモ信頼証明書をJava標準信頼に追加します。この回避策は、ユーザーが一方向のバックエンドSSLを設定する場合のみ適用されることに注意してください。他のシナリオの場合、別の手順が必要になることがあります。

1. keytoolコマンドを使用して、NodeManagerデモ信頼証明書をJavaキーストアにエクスポートします。

keytool -exportcert -rfc -alias wlscertgenca -storepass DemoTrustKeyStorePassPhrase -file /<path to location of nmCert.crt> -keystore $ORACLE_HOME/wlserver/server/lib/DemoTrust.jks

2. keytoolコマンドを使用して、NodeManagerデモ信頼証明書をJava標準信頼にインポートします。

keytool -importcert -alias wlscertgenca -file /<path to location of nmCert.crt> -keystore $JAVA_HOME/jre/lib/security/cacerts -trustcacerts -storepass changeit -noprompt

3. Oracle WebLogic Serverは、keytoolコマンドの適用後、バウンス(停止または再起動)する必要があります。

3 Apache HTTP Server用プラグインの構成

この章では、Apache HTTP Server用Oracle WebLogic Serverプロキシ・プラグインをインストールして構成する方法を説明します。次の項で構成されます。

- Apache HTTP Serverのサポートに関する注意事項

- Apache HTTP Server用Oracle WebLogic Serverプロキシ・プラグインのインストール

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

- Apache HTTP ServerプラグインのDMSメトリックの理解

- Apache HTTPサーバーの非推奨ディレクティブ

注意:

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

3.1 Apache HTTP Serverのサポートに関する注意事項

Apache HTTP Server用Oracle WebLogic Serverプロキシ・プラグインは、Apache 2.2および2.4のWebサーバーでサポートされており、WebSocketアプリケーションのフロントエンドとなることができます。

3.2 Apache HTTP Server用Oracle WebLogic Serverプロキシ・プラグインのインストール

「Oracle WebLogic Serverプロキシ・プラグインの入手方法」の説明に従ってApache HTTP Server用Oracle WebLogic Serverプロキシ・プラグインをダウンロードした後、それをApache HTTP ServerモジュールとしてApache HTTP Serverのインストール環境にインストールできます。

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

- Apache HTTP Serverプラグインのインストール

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

Apache HTTP Server用Oracle WebLogic Serverプロキシ・プラグインをインストールする前に、次のインストールと検証のタスクを行います。

- 「Oracle WebLogic Serverプロキシ・プラグインの入手方法」の説明に従って、Apache HTTP Server用Oracle WebLogic Serverプロキシ・プラグインをダウンロードします。

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

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

(パス)/ファイル名

説明

README.txt

プラグインのREADMEファイル

bin/orapki.bat

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

jlib/*.jar

orapkiヘルパーJavaライブラリ

lib/mod_wl.so

Apache 2.2用のWebLogicプロキシ・モジュール

lib/*.so

ヘルパー・ライブラリ

lib/mod_wl_24.so

Apache 2.4用のWebLogicプロキシ・モジュール

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

- サポートされているApache HTTPサーバーのインストール環境があることを確認します。
詳細は、次を参照してください。

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

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

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

Apache HTTP Server用Oracle WebLogic Serverプロキシ・プラグインは、共有オブジェクト(.so)ファイルとして配布されます。プラグインは、次のサイトから入手できます。

http://www.oracle.com/technetwork/middleware/webtier/overview/index.html

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

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

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

3. mod_so.cモジュールが有効になっていることを確認します。

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

- UNIX/Linux

APACHE_HOME/bin/apachectl -l

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

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

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

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

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

6. Apacheのバージョンに応じて次のどちらかのコマンドを使用し、プラグインをインストールします。

- Apache 2.2.x用のApache HTTPサーバー・プラグイン・モジュールをインストールするには、次の行を追加します。

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

- Apache 2.4.x用のApache HTTPサーバー・プラグイン・モジュールをインストールするには、次の行を追加します。

LoadModule weblogic_module /home/myhome/weblogic-plugins-12.2.1/lib/mod_wl_24.so

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

- UNIX/Linux

> APACHE_HOME/bin/apachectl -t

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

Syntax OK

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

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

- httpd.confファイルの構成

- WebLogicプロパティをLocationまたはVirtualHostブロック内に置く

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

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

- Apache HTTP ServerプラグインのDMSメトリックの理解

3.3.1 httpd.confファイルの構成

Apache HTTP Serverプラグインを構成するには、Apache HTTPサーバー・インストールのhttpd.confファイルを編集します。次のタスクを実行します。

- タスク1: MIMEリクエストの構成

- タスク2: Oracle WebLogic Serverプロキシ・プラグインのその他パラメータの定義

- タスク3: HTTPトンネリングの有効化(省略可)

- タスク4: Webサービスのアトミック・トランザクションの有効化(省略可)

- タスク5: 構成の検証と適用

3.3.1.1 タスク1: MIMEリクエストの構成

リクエストは、MIMEタイプまたはパス、あるいはその両方によってプロキシできます。テキスト・エディタでhttpd.confファイルを開きます。

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

- パスによるプロキシ・リクエストの構成

注意:

MIMEタイプおよびパスによるプロキシの両方を有効にした場合は、パスによるプロキシがMIMEタイプによるプロキシより優先されます。

3.3.1.1.1 MIMEタイプによるプロキシ・リクエストの構成

次の手順に従い、httpd.confファイルでMIMEタイプによるMIMEリクエストを構成します。

1. 次のいずれかを定義する<IfModule>ブロックを追加します。

- クラスタ化されていないWebLogic Serverの場合: WebLogicHostパラメータとWebLogicPortパラメータを定義します。

- WebLogic Serverのクラスタの場合: WebLogicClusterパラメータを定義します。

例:

<IfModule mod_weblogic.c>
WebLogicHost myweblogic.example.com
WebLogicPort 7001
DebugConfigInfo ON
</IfModule>

2. <IfModule>ブロックにMatchExpression行を追加します。

たとえば、クラスタ化されていないWebLogic Serverのための次のような<IfModule>ブロックでは、MIMEタイプが.jspであるすべてのファイルがプロキシされます。

<IfModule mod_weblogic.c>
WebLogicHost my-weblogic.server.com
WebLogicPort 7001
MatchExpression *.jsp
DebugConfigInfo ON
</IfModule>

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

<IfModule mod_weblogic.c>
WebLogicHost my-weblogic.server.com
WebLogicPort 7001
MatchExpression *.jsp
MatchExpression *.xyz
DebugConfigInfo ON
</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>

3.3.1.1.2 パスによるプロキシ・リクエストの構成

次の手順に従い、httpd.confファイルでパスによるMIMEリクエストを構成します。

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

<Location /weblogic>
WLSRequest On
PathTrim /weblogic
</Location>

2. PathTrimパラメータは、<Location>タグ内で構成します。

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

SSLを使用するようApache HTTP Server用Oracle WebLogic Serverプロキシ・プラグインを構成する際には、次のような既知の問題が発生します

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

<Location /weblogic>
WLSRequest On
</Location>

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

正しい構成は次のとおりです。

<Location /weblogic>
WLSRequest On
PathTrim /weblogic
</Location>

- Apache HTTP Server用Oracle WebLogic Serverプロキシ・プラグインの現行の実装では、Apache SSLでの複数の証明書ファイルの使用はサポートされていません。

3.3.1.2 タスク2: Oracle WebLogic Serverプロキシ・プラグインのその他パラメータの定義

Apache HTTP Server用Oracle WebLogic Serverプロキシ・プラグインのためのその他のパラメータを定義します。

Apache HTTP Server用Oracle WebLogic Serverプロキシ・プラグインでは、「Webサーバー・プラグインの一般パラメータ」でリストされているパラメータが認識されます。Apache HTTP Server用Oracle WebLogic Serverプロキシ・プラグインの動作を変更するには、次のどちらかでパラメータを定義します。

- パスによるプロキシに適用するパラメータの場合、<Location>ブロック

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

3.3.1.3 タスク3: HTTPトンネリングの有効化(省略可)

t3プロトコルまたはIIOPプロトコルのHTTPトンネリングを有効にするには、<Location>ブロックを構成します。

- t3プロトコルおよびweblogic.jarを使用している場合にHTTPトンネリングを有効にするには、次の<Location>ブロックをhttpd.confファイルに追加します。

<Location /bea_wls_internal>
WLSRequest On
</Location>

- IIOP (WebLogic Serverシン・クライアントのwlclient.jarによって使用される唯一のプロトコル)を使用する場合にHTTPトンネリングを有効にするには、次のLocationブロックをhttpd.confファイルに追加します。

<Location /bea_wls_internal>
WLSRequest On
</Location>

3.3.1.4 タスク4: Webサービスのアトミック・トランザクションの有効化(省略可)

Webサービスのアトミック・トランザクション(WS-AT)は、<Location>ブロックを構成することで有効にできます。<wls-wsat>パラメータが、パスによるプロキシに適用されます。オプションで、Apache HTTP Server用WebLogic Web Serverプロキシ・プラグインの動作を変更するパラメータを定義できます。

<Location /wls-wsat>
WLSRequest On
</Location>

WebLogic Webサービスは、IBM WebSphere、JBoss、Microsoft .NETなどの外部トランザクション処理システムとの相互運用性を実現します。Webサービスのアトミック・トランザクション(WS-AtomicTransaction)の詳細は、https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=ws-txを参照してください。

3.3.1.5 タスク5: 構成の検証と適用

次の手順に従い、httpd.conf構成を検証してApache HTTP Serverに適用します。

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

- UNIX/Linux

> APACHE_HOME/bin/apachectl -t

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

Syntax OK

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

- UNIX/Linux

> APACHE_HOME/bin/apachectl start

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

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

<IfModule>を使用しないようにした場合は、かわりにWebLogicプロパティを直接Locationブロック内または<VirtualHost>ブロック内に配置できます。次に示す<Location>ブロックと<VirtualHost>ブロックの例を参考にしてください。

<Location /weblogic>
WLSRequest On
WebLogicHost myweblogic.server.com
WebLogicPort 7001
</Location>

<Location /weblogic>
WLSRequest On
WebLogicCluster w1s1.com:7001,w1s2.com:7001,w1s3.com:7001
</Location>

<VirtualHost apachehost:80>
WLSRequest On
WebLogicServer weblogic.server.com
WebLogicPort 7001
</VirtualHost>

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

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

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

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

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

<IfModule mod_weblogic.c>
WebLogicHost wls-host
WebLogicPort wls-port
</IfModule>

<Location /mywebapp>
WLSRequest On
</Location>
...

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

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

注意:

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

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

$ ${APACHE_HOME}/bin/apachectl start

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

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

別個の構成ファイルを複数保持する場合は、次のようにApache HTTP ServerのIncludeディレクティブをhttpd.confファイルの<IfModule>ブロック内で使用することで、weblogic.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ファイルのサンプルを示します。

- weblogic.confファイルを作成するためのルール

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

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

3.3.4.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仮想ホストに関するドキュメントを参照)。

- httpd.confファイルのサンプルを次に示します。

<IfModule mod_weblogic.c>
WebLogicCluster johndoe02:8005,johndoe:8006
WLTempDir "c:\myTemp"
DebugConfigInfo ON
KeepAliveEnabled ON
KeepAliveSecs 15
</IfModule>

<Location /jurl>
WLSRequest On
WebLogicCluster myCluster:7001
WLTempDir "c:\jurl"
</Location>

<Location /web>
WLSRequest On
PathTrim /web
WebLogicHost myhost
WebLogicPort 8001
WLTempDir "c:\web"
</Location>
<Location /foo>
WLSRequest On
WebLogicHost myhost02
WebLogicPort 8090
WLTempDir "c:\foo"
PathTrim /foo
</Location>

- /jurl/*に一致するすべてのリクエストは、POSTデータ・ファイルがc:\jurl内にあり、agarwalp01およびポート7001にリバース・プロキシされます。/web/*に一致するすべてのリクエストは、POSTデータ・ファイルがc:\web内にあり、myhostおよびポート8001にリバース・プロキシされます。/foo/*に一致するすべてのリクエストは、POSTデータ・ファイルがc:\fooに書き込まれ、myhost02およびポート8090にリバース・プロキシされます。

- <Files>ブロックではなくMatchExpression文を使用する必要があります

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

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

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>
####################################################

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

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

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

複数の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>

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>

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

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

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

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

注意:

Apache HTTPサーバーでは大文字と小文字が区別されません。

Apache HTTPサーバーのhttpd.confファイルのサンプル

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

<Location /weblogic>
WLSRequest On
PathTrim /weblogic
ErrorPage http://myerrorpage1.mydomain.com
</Location>

<Location /servletimages>
WLSRequest On
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>

3.4 Apache HTTP ServerプラグインのDMSメトリックの理解

Apache HTTP ServerのDMSパフォーマンス・メトリックを構成して表示できます。Apache HTTPサーバーには、Oracle WebLogic Serverと同じDMSメトリックのセットが用意されています。

返されるDMSメトリックについては、「DMS状態メトリック」、「DMSイベント・メトリック」および「DMS PhaseEventメトリック」で説明しています。

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

- Apache HTTP ServerプラグインのDMSメトリックの構成

- Apache HTTP Serverプラグインのパフォーマンス・メトリックの表示

3.4.1 Apache HTTP ServerプラグインのDMSメトリックの構成

Apache HTTP ServerのDMSメトリックを構成するには、httpd.confファイルに次のコードを追加します。

# Add the following LoadModule only if it is not already present
# Use mod_wl.so for Apache httpd 2.2
LoadModule weblogic_module $PLUGIN_HOME/mod_wl_24.so

<Location /metrics>
SetHandler dms-handler
</Location>

3.4.2 Apache HTTP Serverプラグインのパフォーマンス・メトリックの表示

生のメトリックは、次のURLを使用して表示できます。

http://apachehost:apacheport/metrics

ここで、apachehostは、Apacheサーバーのホスト名、apacheportはポート番号になります。

Oracle WebLogic Serverプラグインから生じるメトリックは、セクション/WebLogicProxy [type=OHSWebLogic]にあります。

3.5 Apache HTTPサーバーの非推奨ディレクティブ

WebLogic Serverプラグイン・ログは、現在はApache HTTP Serverのエラー・ログの一部となっています。簡単に識別できるよう、次の例のように先頭にweblogic:というリファレンスが付いています。

Apache 2.4の例:

[Thu May 14 23:15:05.160459 2015] [weblogic:debug] [pid 6571:tid 139894556022528] ApacheProxy.cpp(875): [client 10.184.61.77:53634] <657114316705052> ================New Request: [GET /weblogic/index.html HTTP/1.1] =================

Apache 2.2の例:

[Thu Apr 16 04:15:37 2015] [debug] ApacheProxy.cpp(873): [client 10.184.61.77] <2157714291829372> weblogic: ================New Request: [GET /weblogic/index.html HTTP/1.1] =================

ディレクティブWLLogFileおよびDebugは非推奨です。構成でこれらのディレクティブが使用されている場合は、起動時に次のような注意が表示されます。

[Thu May 14 23:22:19 2015] [warn] weblogic: The Debug directive is ignored.  The web server log level is used instead.

プラグインのログを有効にするには、LogLevelをdebugに設定します。これらのログは、ErrorLogディレクティブで指定されているファイルに含まれます。

4 iPlanet Web Server用プラグインの構成

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

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

- iPlanet用Oracle WebLogic Serverプロキシ・プラグインの概要

- iPlanet用プラグインのインストールと構成

- iPlanet Web Serverの非推奨ディレクティブ

4.1 iPlanet用Oracle WebLogic Serverプロキシ・プラグインの概要

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

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

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

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

4.2 iPlanet用プラグインのインストールと構成

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

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

- iPlanet Web Server用Oracle WebLogic Serverプロキシ・プラグインのインストール

- iPlanet Web Server用Oracle WebLogic Serverプロキシ・プラグインの構成

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

- obj.confファイル修正のガイドライン

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

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

iPlanet Web Server用Oracle WebLogic Serverプロキシ・プラグインをインストールする前に、次のインストールと検証のタスクを行います。

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

- 「Oracle WebLogic Serverプロキシ・プラグインの入手方法」の説明に従って、iPlanet Web Server用Oracle WebLogic Serverプロキシ・プラグインをダウンロードします。

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

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

(パス)/ファイル名

説明

README.txt

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

bin/orapki (Windowsでは.bat)

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

jlib/*.jar

orapkiヘルパーJavaライブラリ

lib/mod_wl.so

WebLogicプロキシ・モジュール

lib/*.so

ヘルパー・ライブラリ

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

- IPLANET_HOMEにインストールされたiPlanet Web Serverインストール(7.0.9以降) (つまり、iplanet-host:iplanet-portをリスニングするiPlanetサーバー)用のサポートされるOracle WebLogic Serverプロキシ・プラグインを作成します。
http://www.oracle.com/technology/software/products/ias/files/fusion_certification.htmlで示されているiPlanet Web Serverプラットフォーム用Oracle WebLogic Serverプロキシ・プラグイン12c (12.2.1.1.0)では、バージョン12c (12.2.1.1.0)プラグインがサポートされています

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

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

4.2.2 iPlanet Web Server用Oracle WebLogic Serverプロキシ・プラグインのインストール

iPlanet Web Server用Oracle WebLogic Serverプロキシ・プラグインは、共有オブジェクト(.so)として配布されます。

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

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

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

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

4.2.3 iPlanet Web Server用Oracle WebLogic Serverプロキシ・プラグインの構成

この項では、iPlanet Web Server用Oracle WebLogic Serverプロキシ・プラグインの構成について説明します。このためには、obj.confファイルを構成します。obj.confファイルでは、WebLogic Serverにプロキシされるリクエストやその他の構成情報を定義します。

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

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

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

2. obj.confファイルを構成します。

obj.confファイルを構成する方法は複数あります。「obj.confファイルの変更のガイドライン」で説明するガイドラインを参照してください。

4.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>

注意:

ppathをiPlanet Web Server用Oracle WebLogic Serverプロキシ・プラグインを介して渡す方法をより詳細に構成するには、PathTrimなど、必須ではないパラメータを使用します。プラグイン・パラメータの完全なリストは「Webサーバー・プラグインの一般的なパラメータ」を参照してください

4.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://docs.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アプリケーションのコンテキスト・ルートと一致する必要があります。

iPlanet Web Server用Oracle WebLogic 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によるプロキシを正常に機能させるには、iPlanet Web Server用Oracle WebLogic Serverプロキシ・プラグイン12c (12.2.1.1.0)でJavaを無効にする必要があります。無効にしないと、SUN Oneによって末尾が*.jspのすべてのリクエストの処理が試みられ、$doc_rootの下にリソースが見つからないために404エラーが返されます。

Oracle iPlanet Web ServerでJavaを無効にするには、obj.confファイルでname="default"の下にあるNameTrans行をコメント・アウトします。その後、Webサーバーを再起動します。

#NameTrans fn="ntrans-j2ee" name="j2ee"

あるいは、次の操作を実行できます。

- パスでプロキシする場合は、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>

4.2.3.3 プラグインのテスト

Oracle iPlanet Web Serverプラグインをテストするには、次の手順を実行します。

1. WebLogic Serverを起動します。

2. Oracle iPlanet Web Serverを起動します。
iPlanet Web Server用Oracle WebLogic Serverプロキシ・プラグインがすでに実行されている場合は、サーバーを再起動するか、再構成する必要があります。

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

http://webserver_host:webserver_port/weblogic/

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

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

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

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>
DebugConfigInfo="ON"
PathTrim="/wls"
</Object>
...

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

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

set LD_LIBRARY_PATH=/home/user/weblogic-plugin-12.2.1/lib:..

注意:

'lib'の内容をIPLANET_HOME/libにコピーするか、$IPLANET_INSTANCE_HOME /bin/startservを編集しても、LD_LIBRARY_PATHを更新できます。

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

$IPLANET_INSTANCE_HOME /bin/startserv

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

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

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

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

4.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---------------------

4.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.3 iPlanet Web Serverの非推奨ディレクティブ

WebLogic Serverプラグイン・ログは、現在はOracle iPlanet Serverのエラー・ログの一部となっています。簡単に識別できるよう、次の例のように先頭にweblogic:というリファレンスが付いています。

[14/May/2015:23:18:34] fine (21904): for host 10.184.61.77 trying to GET /wls/testcluster, wl-proxy reports: <2190414316707144> weblogic: After trimming path: '/testcluster'

ディレクティブWLLogFileおよびDebugは非推奨です。構成でこれらのディレクティブが使用されている場合は、次のような注意が表示されます。

[14/May/2015:23:18:34] warning (21904): wl-proxy reports: weblogic: Debug & WLLogFile directives are deprecated for the current plugin release. Please Refer to the plugin documentation.

プラグインのログを有効にするには、ログレベルをfineに設定します。

5 Microsoft IIS Web Server用プラグインの構成

次の各項では、Microsoft IIS Web Server用Oracle WebLogic Serverプロキシ・プラグインをインストールして構成する方法を説明します。

- Microsoft IIS 7.0プラグインの操作

- Microsoft IIS 7.5プラグインの操作

「Oracle WebLogic Serverプロキシ・プラグインの入手方法」の説明に従って、IIS Web Server用Oracle WebLogic Serverプロキシ・プラグインをダウンロードします。zipファイルには、これらのファイルが含まれています。

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

(パス)/ファイル名

説明

README.txt

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

bin/orapki.bat

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

jlib/*.jar

orapkiヘルパーJavaライブラリ

iisproxy.dll

WebLogicプロキシ・モジュール

lib/*.dll

ヘルパー・ライブラリ

5.1 Microsoft IIS 7.0プラグインの操作

この項では、Microsoft IIS 7.0のプラグインのインストール方法と構成方法について説明します。

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

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

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

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

- IISを経由するACLの作成 7.0

- インストールのテスト

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

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

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

1. Microsoft IIS 7.0をダウンロードしてインストールします。

2. Microsoft IIS 7.0の必要な機能がすべて有効になっていることを確認します。

3. Oracle WebLogic Serverプロキシ・プラグインの最新のzipファイルをダウンロードしてインストールします。

4. IISマネージャーで、「Web サイト」を右クリックして「Web サイトの追加」を選択し、Webアプリケーションを作成します。

「Web サイト名」に、Webアプリケーションに付ける名前(たとえば、MyApp)を入力します。Webアプリケーションのポート(現在使用中でない任意の有効なポート番号)の物理パスを選択します。

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

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

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

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

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

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

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

7. 「MyApp」をクリックして、右側のメニュー・オプションの「スクリプト マップの追加」をクリックします。「要求パス」に*を入力します。

iisproxy.dllファイルを参照し、それを実行可能ファイルとして追加します。それにproxyという名前を付けます。

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

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

図5-5 リクエスト制限の編集

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

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

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

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

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

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

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

WLLogFile=@Log file name@
SecureProxy=OFF

13. Internet Explorerブラウザを開き、http://<hostname>:<port>を入力します。Oracle WebLogic ServerからMedrecサンプル・アプリケーションを表示できるはずです。

SSLモードでプラグインを実行する場合は、WeblogicPortの値をアプリケーションのSSLポートに、SecureProxyの値をONに変更して、WLSSLWalletをウォレットの場所に設定します。SSLパラメータの詳細は、「Webサーバー・プラグインのSSLパラメータ」を参照してください。

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

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

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

1. 「Microsoft IIS 7.0プラグインのインストールと構成」の説明に従って、IIS Web Server上でMicrosoft IIS Web Server用Oracle WebLogic Serverプロキシ・プラグインを設定することでアプリケーションを構成します。

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

注意:

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

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

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

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

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

6. PNG、GIF、CSSなどの種類の静的ファイルを提供するようにIISを構成します。

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

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

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

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

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

リクエストしたファイルの拡張子に関係なく、Webサイトまたは仮想ディレクトリへのすべてのリクエストの開始時にInternet Server API (ISAPI)アプリケーションを実行するように該当のWebサイトまたは仮想ディレクトリを構成できます。この機能を使用することで、iisproxy.dllにマッピングを挿入し、パスによってWebLogic Serverへリクエストをプロキシできます。

5.1.3.1 IIS 7.0以降のためのワイルドカード・スクリプト・マップの追加

次に示す手順は、IIS向けの「Add a Wildcard Script Map」(http://technet.microsoft.com/en-us/library/cc754606(WS.10).aspx)で説明されている、IISでワイルドカード・スクリプト・マップを追加し、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」を参照してください。

注意:

同じIISサイト内の複数のIISアプリケーションにリクエストをプロキシする場合は、後続リクエストが最初のWebサイトにしかプロキシされない状態にならないように、各IISアプリケーションを作成して、それぞれに一意のアプリケーション・プールを割り当てます。

IIS 7.xでは、アプリケーション・プールを仮想ディレクトリに割り当てることはできません。

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

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

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

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

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

4. 「iisproxy.iniファイルのサンプル」の説明に従って、仮想Webサイトのためのiisproxy.iniファイルを作成します。手順1で作成したディレクトリに、このiispoxy.iniファイルをコピーします。

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つのアプリケーション・プールにルーティングされる場合に、別のアプリケーション・プールのアプリケーションがそのアプリケーションに影響を及ぼすことはありません。

注意:

IIS 7.0には「アプリケーション保護」オプションがないため、手順6はIIS 6.0のみに適用されます。特定のIISサイト内に存在するIIS仮想ディレクトリが厳密に1つであることを除けば、この手順はIIS 7.0で機能します。このような制限があるのは、IIS 7.0では仮想ディレクトリごとに一意のアプリケーション・プールを割り当てることができず、後続リクエストが必ず最初のwebsite (仮想ディレクトリ)にプロキシされるためです。

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

クラスタ化されていない単一の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.1.5 IISを介したACLの作成 7.0

ACLは、IISによってAuthorizationヘッダーが渡されない場合、Microsoft IIS Web Server用Oracle WebLogic Serverプロキシ・プラグイン12c (12.2.1.1.0)では機能しません。次の情報を参考にして、IISによって必ずAuthorizationヘッダーが渡されるようにしてください。

1. 基本認証を使用する場合、ユーザーがローカルのログオン権限でログオンすることを確認します。

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

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

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

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

5.1.6 インストールのテスト

次の手順に従い、Microsoft IISプラグインのインストール、構成およびデプロイが正常に行われたことを確認します。

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

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

3. ブラウザを開き、次の例に示すように、IISにfilename.jspを加えた形式でURLを設定します。

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

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

5.2 Microsoft IIS 7.5プラグインの操作

この項では、Microsoft IIS 7.5のプラグインのインストール方法と構成方法について説明します。

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

- IIS 7.5での静的ファイルの提供

- IIS 7.5での同じリクエストからの静的ファイルおよび動的コンテンツの提供

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

次の手順に従い、Microsoft IIS 7.5プラグインをインストールして構成します。

1. Microsoft IIS 7.5をインストールします。

2. Microsoft IIS 7.5の必要な機能がすべて有効になっていることを確認します。

a. 「スタート」メニューで、「コントロール パネル」、「プログラムと機能」の順に選択します。「Internet Information Services (IIS) 7+ Manager」を選択します。「Windows の機能の有効化または無効化」をクリックします。

b. 「Internet Information Services」の下のツリー全体を開き、サブ機能がすべて選択されていることを確認します。

図5-9 Internet Information ServicesのWindows機能

3. Oracle WebLogic Serverプロキシ・プラグインの最新のzipファイルをダウンロードしてインストールします。

4. 次の内容でiisproxy.iniファイルを%PLUGIN_HOME%\lib\フォルダに作成します。

WebLogicHost=URL_of_WebLogic_Host
WebLogicPort=WebLogic_Port
Debug=ALL
DebugConfigInfo=ON
WLLogFile=C:\Temp\wl-proxy.log

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

6. 「IIS マネージャー」を開きます(「スタート」、「すべてのプログラム」→「管理ツール」→「Internet Information Servicesマネージャー」 を選択)。

図5-10 Internet Information Servicesマネージャーのウィンドウ

7. IISに新しいWebサイトを作成します。詳細は、IISヘルプ・システムを参照してください。

8. サイト名をクリックして、「ハンドラー マッピング」を開き、スクリプト・マップを追加します(「拡張子」を.jspなどの値に設定し、「実行可能ファイル」を%PLUGIN_HOME%\lib\iiproxy.dllに設定して、値を「名前」に割り当てます)。

9. 「MIME の種類」をクリックして、MIMEの種類が拡張子に定義されていることを確認します。MIMEの種類とその定義(ない場合)を追加します。

10. サイト名をクリックし、「ディレクトリの参照」を開いて機能を有効にします。

11. IISを起動します(コマンド・プロンプトでservices.mscと入力し、下部にある「World Wide Web発行サービス」に移動して再起動します。さらに、Webサイトを再起動します)。

図5-11 Windowsのサービス・ウィンドウ

12. リクエストをブラウザからhttp://iishost:iisport/application_name/に送信して構成をテストし、レスポンスを検証します。
ここで、iishostは、IISサーバーのURL、iisportはポート番号になります。iisport番号が、WebLogic Serverのポート番号と異なることに注意してください。

5.2.2 IIS 7.5での静的ファイルの提供

WLSプラグインを構成して機能することを確認した後(「Microsoft IIS 7.5プラグインのインストールと構成」を参照)、次の手順に従い、静的ファイルを提供します。

1. 「既定の Web サイト」を右クリックして、「仮想ディレクトリの追加」をクリックします。

2. 「エイリアス」フィールドで、staticと入力し、物理パスを静的ファイルの場所(c:\inetpub\wwwroot\staticなど)に設定します。「OK」をクリックします。staticフォルダが「既定の Web サイト」に表示されます。

注意: ファイルを別の場所に配置した場合、物理パスが異なることがあります。パスを適宜変更します。

3. 「既定の Web サイト」で「static」をクリックして、staticのホーム・ページを開きます。

4. staticホーム・ページで、「ハンドラー マッピング」をクリックして、右ペインで「順序指定された一覧の表示」をクリックします。「ハンドラー マッピング」の順序指定されたリストが表示されます。

5. 「スクリプト マップの追加」をクリックします。「要求パス」を「*」に設定し、「実行可能ファイル」を%PLUGIN_HOME%\lib\iiproxy.dllに設定して、値proxyを「名前」に割り当てます。「OK」をクリックします。

6. 「順序指定された一覧の表示」をクリックして、ハンドラのリストを並べ替えます。

7. 「proxy」スクリプト・マップをクリックして、StaticFileハンドラ・マッピングの下に移動します。(つまり、StaticFileハンドラ・マッピングがproxyハンドラ・マッピングの上に表示されます。)

8. c:\inetpub\wwwrootの下にstaticフォルダを作成し、このフォルダ内にHTMLファイル(index.htmlなど)をコピーします。

9. サービスで「World Wide Web発行サービス」を再起動して、IIS 7.5を再起動します( 図5-11を参照)。

10. 作業をテストします。http://localhost:80/static/index.htmlにアクセスして、index.htmlファイルにアクセスします。

5.2.3 IIS 7.5での同じリクエストからの静的ファイルおよび動的コンテンツの提供

IISからのリクエスト「http://localhost:80/console」およびバックエンドWebLogic Serverからのその他の動的コンテンツに対して、*.gifや*.pngイメージなどの静的ファイルを提供するとします。「IIS 7.5での静的ファイルの提供」の他に次の手順を実行します。

1. 「IIS 7.5での静的ファイルの提供」で説明する手順を実行します。

2. 「既定の Web サイト」を右クリックして「仮想ディレクトリの追加」をクリックし、「仮想ディレクトリの追加」ダイアログ・ボックスに次の内容を入力します。

- エイリアス: console

- 物理パス: C:\path_to_the_wls_plug-in\console

この例では、consoleの物理パスはC:\OHS_Plugin_IIS\consoleになります。

「OK」をクリックします。「既定の Web サイト」の左ペインに「console」エントリが表示されます。

3. 「既定の Web サイト」で「console」をクリックします。右側に「consoleホーム」が開きます。

4. 「consoleホーム」ペインで「ハンドラー マッピング」をクリックします

5. 「StaticFile」を右クリックし、「編集」を選択します。「モジュール マップの編集」ダイアログ・ボックスでフィールドを次のように更新します。

- 要求パス: *.png (つまり、「*」を「*.png」に変更)

- モジュール: StaticFileModule, DefaultDocumentModule, DirectoryListingModule (デフォルト)

- 実行可能ファイル: 不要。空白のままにしておきます。

- 名前: StaticFile (ここでの名前変更は不可)

6. 「要求の制限」をクリックします。「要求の制限」ダイアログ・ボックスの「マップ」タブで、「要求のマップ先が次の場合のみハンドラを呼び出す」を選択した場合、「ファイル」または「フォルダー」を選択します。「OK」→「OK」をクリックしてダイアログ・ボックスを閉じます。

前述の手順では、IISサーバーから*.pngを提供します。

7. *.gifファイルなど、他のイメージ・ファイルを提供するには、次の手順を実行します。

a. 「Consoleホーム」で「ハンドラー マッピング」をクリックし、右側で「モジュール マップの追加」をクリックして、次の内容を入力します。
要求パス: *.gif

モジュール: StaticFileModule, DefaultDocumentModule, DirectoryListingModule

実行可能ファイル: 不要。空白のままにしておきます

名前: StaticFileForGIF

b. 「要求の制限」をクリックします。「マップ」で、「要求のマップ先が次の場合のみハンドラを呼び出す」を選択していることを確認し、「ファイル」または「フォルダー」を選択して、「OK」→「OK」をクリックします

8. ハンドラの順序を調整します。

a. 「既定の Web サイト」で「console」をクリックして、右側で「ハンドラー マッピング」、「順序指定された一覧の表示」の順にクリックします

b. 「proxy」を選択して、「proxy」が「StaticFile」と「StaticFileForGIF」の下になるまで移動します。つまり、順序は次のようになります。

StaticFile
StaticFileForGIF
proxy

9. http://loclhost:<iis-port>/consoleリクエストに属する静的ファイルをすべてWebLogic ServerからIISにコピーします。

10. サービスを再起動してから、Webサイトを再起動します。

イメージ(*.pngおよび*.gif)がIISで提供され、動的コンテンツがWeblogicサーバーで提供されるようになりました。

たとえば、リクエストhttp://localhost:80/consoleの場合、コンソールのイメージはIISで提供され、*.pngや*.gif以外のリクエストはすべてWeblogic Serverで提供されます。

6 セキュリティの構成

この章では、プラグインに関するセキュリティの使用方法について説明します。内容は次のとおりです。

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

- iPlanet Web Server用プラグインでのSSLの構成

- 境界認証の構成

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

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

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

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

- WebLogicSSLVersion—プラグインとWebLogic Serverの間の通信に使用するSSLプロトコル・バージョンを指定します。

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

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

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

注意:

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

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

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

注意:

Apacheプラグイン(Oracle HTTP Serverを含む)と同じシステム上にOracle Fusion Middleware 12c (12.2.1.1.0)製品がインストールされている場合は、ORACLE_HOME変数が有効なインストール環境を指している必要があり、そうでない場合は、プラグインによるSSLの初期化が失敗します。

たとえば、製品が正常に削除されなかったためにORACLE_HOMEが無効になっている場合、プラグインによるSSLの初期化は失敗します。

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

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

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

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

- MD5アルゴリズムを使用して署名された証明書の置換

- MD5証明書のサポートの有効化

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コマンドを実行し、バージョン12c (12.2.1.1.0)のプラグインがインストールされているシステム上で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アカウント)。

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

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

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

3. OracleウォレットにWLS信頼証明書をインポートします。

orapki wallet add -wallet mywallet -trusted_cert -cert <cert_file_name> -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

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

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

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

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

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

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

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

d. 「構成」: 「一般」タブで、「詳細」セクションまでスクロール・ダウンして開きます。

e. 次のいずれかの操作を行います。

目的

選択オプション

一方向SSLの有効化

WebLogicプラグインの有効化

認証にクライアント証明書が使用される双方向SSLの有効化

クライアント証明書プロキシの有効化

クライアント証明書による双方向SSLの有効化

両方

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

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

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

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

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

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

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

この手順では、WebLogic Serverがインストールされているシステム上でkeytoolコマンドを実行します。また、バージョン12c (12.2.1.1.0)プラグインがインストールされているシステム上で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.1.4 MD5アルゴリズムを使用して署名された証明書の置換

SSLを使用してWebLogic Serverに接続する場合、MD5を使用して署名された証明書リクエストまたは証明書がウォレット内のSHA-2で署名された証明書で置換されていることを確認します。これ以外の場合、サーバーは起動に失敗します。

証明書の署名アルゴリズムの確認

証明書の署名アルゴリズムを確認するには:

1. 証明書を識別名で検索するには、次のコマンドを使用します
${PLUGIN_HOME}/bin/orapki wallet display -wallet <wallet__location>

2. ウォレットで使用可能な証明書をエクスポートします
${PLUGIN_HOME}/bin/orapki  wallet export -wallet <wallet_Location> -dn 'DN_string' -cert <certificate_file>

3. keytoolを使用して、<certificate_file>を署名する際に使用する署名アルゴリズムを確認します
$JAVA_HOME/bin/keytool -printcert -file <certificate_file>

MD5アルゴリズムを使用して署名された証明書リクエストまたは証明書の削除

- MD5アルゴリズムを使用して署名されたユーザー証明書を削除するには、次のようにします

${PLUGIN_HOME}/bin/orapki wallet remove -wallet <wallet_location> -dn 'DN_string' -user_cert [-pwd <pwd>] | [-auto_login_only]

- 信頼性がありリクエストされた証明書リストで使用可能な自己署名証明書を削除するには、次のようにします。

${PLUGIN_HOME}/bin/orapki wallet remove -wallet < wallet_location > -dn 'DN_string' -trusted_cert [-pwd <pwd>] | [-auto_login_only]
${PLUGIN_HOME}/bin/orapki wallet remove -wallet < wallet_location > -dn 'DN_string' -cert_req [-pwd <pwd>] | [-auto_login_only]

- MD5アルゴリズムを使用して署名された信頼性のある証明書を削除するには、次のようにします

${PLUGIN_HOME}/bin/orapki wallet remove -wallet < wallet_location > -dn 'DN_string' -trusted_cert [-pwd < pwd >] | [-auto_login_only]

- MD5アルゴリズムを使用して署名された証明書リクエストを削除するには、次のようにします

${PLUGIN_HOME}/bin/orapki wallet remove -wallet < wallet_location > -dn 'DN_string' -cert_req [-pwd <pwd>] | [-auto_login_only]

SHA-2アルゴリズムを使用して署名された自己署名ユーザー証明書の追加

次のコマンドを使用して、MD5アルゴリズムによって署名された自己署名ユーザー証明書を、ウォレットのSHA-2アルゴリズムを使用して署名された自己署名証明書で追加します。

${PLUGIN_HOME}
/bin/orapki wallet add -wallet <wallet_Location>
-dn 'DN_String'
keysize 2048 -sign_alg sha256 -self_signed
-validity 9125 [-pwd <pwd>] | [-auto_login_only]

MD5アルゴリズムを使用した既存の認証局の署名済ユーザー証明書の更新

認証局に連絡してSHA-2署名アルゴリズムを使用して署名されたユーザー証明書を取得し、これを既存のユーザー証明書と置換します。

${PLUGIN_HOME}/bin/orapki -wallet add -wallet <wallet_Location> -user_cert -cert <certificate_file> [-pwd <pwd> ] | [-auto_login_only]

MD5アルゴリズムを使用して署名された既存の信頼性のある証明書の更新

ウォレットにインポートされたMD5署名アルゴリズムを使用して署名されている信頼性のある証明書がある場合、SHA-2署名アルゴリズムを使用するように、対応するバックエンドWebLogic Serverの証明書を更新します。更新後、ウォレット内の信頼性のあるMD5証明書を更新済証明書に置換します。

${PLUGIN_HOME}/bin/orapki -wallet add -wallet <wallet_Location> -trusted_cert -cert <certificate_file> [-pwd <pwd> ] | [-auto_login_only]

6.1.5 MD5アルゴリズムを使用して署名された証明書のサポートの有効化

注意:
セキュリティが損なわれるため、MD5アルゴリズムを使用して署名された証明書は推奨されていません。MD5アルゴリズムを使用して署名された証明書の使用を続行するには、ORACLE_SSL_ALLOW_MD5_CERT_SIGNATURES=1環境変数を設定します。

プラグイン内のenvironment. variable を設定します。

- Oracle HTTP Serverプラグイン: environment.ORACLE_SSL_ALLOW_MD5_CERT_SIGNATURES=1をDOMAIN_HOME/config/fmwconfig/components/OHS/instances/instanceName /ohs.plugin.nodemanger.propertiesに追加します

- Apacheプラグイン: export ORACLE_SSL_ALLOW_MD5_CERT_SIGNATURES=1を$APACHE_HOME/bin/envvarsに追加します。

- iPlanetプラグイン: export ORACLE_SSL_ALLOW_MD5_CERT_SIGNATURES=1 を$IPLANET_INSTANCE_HOME/bin/startservに追加します。

- IISプラグイン: ORACLE_SSL_ALLOW_MD5_CERT_SIGNATURES=1をシステム環境変数に追加します。

6.2 iPlanet Web Server用プラグインでのSSLの構成

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

iPlanet Web Serverプラグイン用Oracle WebLogic Serverプロキシ・プラグイン12c (12.2.1.1.0)では、iPlanet Web Server用Oracle WebLogic Serverプロキシ・プラグイン12c (12.2.1.1.0)と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.confファイル内のServiceディレクティブのSecureProxyパラメータをONに設定します。

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

6.3 境界認証の構成

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

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

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

2. Certトークン・タイプをサポートするようにカスタムIDアサーション・プロバイダを構成し、Certをアクティブなトークン・タイプにします。『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に受け入れられるようにしてください。『WebLogicセキュリティ・サービスによるアプリケーションの開発』のネットワーク接続フィルタの使用に関する項を参照してください。

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

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

7 共通の構成タスク

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

- プラグインでのIPv6の構成

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

- WebSocketアップグレード・リクエストのスループットを高めるためのOracle HTTP ServerとApache HTTP Serverのチューニング

- パーティションの操作

7.1 プラグインでのIPv6の構成

バージョン12c (12.2.1.1.0)プラグインでは、IPv6がサポートされています。具体的には、WebLogicHostおよびWebLogicCluster構成パラメータ(「WebLogicCluster」および「WebLogicHost」を参照)で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/mod_wl.conf/iisproxy.iniファイル内でDynamicServerListプロパティをOFFに設定することによっても、IPv6でのパフォーマンスが向上する可能性があります。OFFに設定すると、プラグインは、プラグインからプロキシされたロード・バランシング・リクエストに使用される動的クラスタ・リストを無視し、WebLogicClusterパラメータで指定された静的リストを使用します。

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

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

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

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

- 接続失敗の考えられる原因

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

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

- 動的サーバー・リスト

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

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

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

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

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

- ネットワークの問題

- その他のサーバー障害

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

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

- サーバーのハング

- データベースの問題

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

7.2.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

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

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

7.2.4 動的サーバー・リスト

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

クラスタ化された管理対象サーバーにプロキシする場合、WebLogicClusterパラメータを使用してWebLogic Serverのリストを指定すると、プラグインは、クラスタ・メンバー間でのロード・バランシングの起点としてそのリストを使用します。最初のリクエストがそれらのサーバーの1つにルーティングされた後、クラスタ内のサーバーの更新されたリストを含む動的サーバー・リストが返されます。

更新されたリストでは、クラスタ内の新しいサーバーが追加され、停止されたサーバー、一時停止されたサーバー、クラスタ・メンバーではなくなったサーバーおよびリクエストに応答しなかったサーバーは削除されます。この機能は、DynamicServerListを使用して制御可能です。たとえば、この機能を無効にするには、DynamicServerListをOFFに設定します。

DynamicServerList ONは、推奨されるパフォーマンス・チューニング・パラメータです。クラスタのメンバーが保守のために一時的に停止されている場合や、管理者が別のメンバーを追加することを決定し、Webサーバーの再起動が必要ない場合などに役立ちます。

注意:

DynamicServerListをONに設定し、WebLogicClusterで指定されたバックエンドWebLogic Serverのリストがクラスタにない場合、動作は未定義になります。

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

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

注意:

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

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

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

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

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

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

7.3 WebSocketアップグレード・リクエストのスループットを高めるためのOracle HTTP ServerとApache HTTP Serverのチューニング

WebLogic Server 12c (12.2.1.1.0)では、WebSocketアプリケーションのデプロイがサポートされています。Oracle HTTP Server 12c (12.2.1.1.0)とApache HTTP Server 2.2.xおよび2.4.x用のOracle WebLogic Serverプロキシ・プラグイン12c (12.2.1.1.0)では、そのようなWebSocket接続アップグレード・リクエストを処理して、WebLogic Server 12c (12.2.1.1.0)以降でホストされるWebSocketアプリケーションに対して効率的にプロキシできるようになりました。このサポートが追加されたことで、新しい構成パラメータであるWLMaxWebSocketClientsが導入されています。

WLMaxWebSocketClientsパラメータは、アクティブなWebSocket接続の数をいつでも制限します。このパラメータに設定できる最大値は、ThreadsPerChildの75% (Windowsの場合)またはMaxRequestWorkersの75% (Windows以外の場合)となります。したがって、HTTPサーバーのWebSocket接続アップグレード・リクエストの最大数を調整するには、MaxRequestWorkersまたはThreadsPerChildをWebSocket接続にも対応できる値に設定してください。また、WLMaxWebSocketClientsがMaxRequestWorkers/ThreadsPerChildの75%に設定されていることを確認してください。

7.4 パーティションの操作

手動構成を一部行うことで、Oracle WebLogic Serverプロキシ・プラグインは、Oracle WebLogic Server MT (マルチテナンシ)のフロントエンドになることができます。

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

注意:

この項では、Oracle WebLogic Serverプロキシ・プラグインに適用する場合に限定して、パーティションとマルチテナンシについて説明します。Oracle WebLogic Server MT、パーティションおよびマルチテナンシの詳細は、『Oracle Fusion Middleware WebLogic Server MTの使用』を参照してください。

- パーティションの追加

- パーティションの変更およびパーティション移行

- Web ServerとOracle WebLogic Serverとの間のSSLの構成

- クラスタ変更の動的検出

7.4.1 パーティションの追加

パーティションをOracle WebLogic Server MT側で追加した場合、新しいパーティションのフロントになるように、対応する変更を必ずWebサーバー構成に加える必要があります。パーティション自体の追加の詳細は、Oracle WebLogic Server MTのドキュメントに記載されています(『Oracle Fusion Middleware WebLogic Server MTの使用』のドメイン・パーティションの構成に関する項を参照)。

次の項では、Oracle WebLogic Server MTで新規追加したパーティションのフロントエンドになるように、対応する変更をWebサーバー構成に加える方法について説明します。

注意:

次の項では、Oracle WebLogic Serverに1つ以上のドメイン・パーティションがすでに作成されていることが前提になります。ドメイン・パーティションの作成の詳細は、『Oracle Fusion Middleware WebLogic Server MTの使用』のドメイン・パーティションの構成に関する項を参照してください。

- Apache ServerおよびOracle HTTP Serverの構成の変更

- iPlanet Serverの構成の変更

- IIS Serverの構成の変更

7.4.1.1 Apache ServerおよびOracle HTTP Serverの構成の変更

次に、新しいパーティションを追加するたびに、Oracle HTTP ServerまたはApacheプラグインの構成ファイル(httpd.conf)に追加する必要があるサンプル構成を示します。構成によって、パーティションのホスト名とポート、サーバーとそれが属するWebLogicクラスタ、パーティションに構成されるオプションのURIが識別されます。

1. Oracle HTTP ServerまたはApache Serverのプラグインをインストールして構成します。「Oracle WebLogic Serverプロキシ・プラグインの構成準備」または「Apache HTTP Server用Oracle WebLogic Serverプロキシ・プラグインのインストール」を参照してください。

2. 新しいパーティションごとに、httpd.confファイルを編集して次のセクションを追加します。

# For OHS: Uncomment the following line
# LoadModule weblogic_module modules/mod_wl_ohs.so
# For Apache 2.2: Uncomment the following line
# LoadModule weblogic_module modules/mod_wl.so
# For Apache 2.4: Uncomment the following line
LoadModule weblogic_module modules/mod_wl_24.so

<VirtualHost hostname_and_port_of_the_partition>
<IfModule mod_weblogic.c>
ServerName server_URL
WebLogicCluster comma_separated_list_of_WebLogic_clusters
SetHandler weblogic-handler
PathPrepend optional_uri_of_the_partition
</IfModule>
</VirtualHost>

3. 構成の変更後、ApacheまたはOracle HTTP Serverを再起動する必要があります。

7.4.1.1.1 Oracle HTTP Server/Apacheプラグインの例

次の例では、様々な使用例のサンプル構成を示します。

例1: クライアントでパーティション・パスを構成できない

ドメインに2つのパーティションがあるとします。

- VirtualTarget1のホスト名はwww.myCompany1.com、URI接頭辞(パーティション・パス)は、Oracle WebLogic Serverで構成されているnullになります。

- VirtualTarget2のホスト名はwww.myCompany2.com、URI接頭辞(パーティション・パス)は、Oracle WebLogic Serverで構成されているnullになります。

この場合、パーティション・パスを構成する必要はありません

LoadModule weblogic_module modules/mod_wl_24.so

<VirtualHost *:8080>
<IfModule mod_weblogic.c>
ServerName www.myCompany1.com
WebLogicCluster wls1:7001,wls2:7001,wls3:7001
SetHandler weblogic-handler
</IfModule>
</VirtualHost>

<VirtualHost *:8080>
<IfModule mod_weblogic.c>
ServerName www.myCompany2.com
WebLogicCluster wls1:7002,wls2:7002,wls3:7002
SetHandler weblogic-handler
</IfModule>
</VirtualHost>

この構成では、myCompany1.com:8080またはmyCompany1.comへのリクエストはすべて、管理対象サーバーwls1:7001、wls2:7001およびwls3:7001にプロキシされます。同様に、myCompany2.com:8080またはmyCompany2.comへのリクエストはすべて、管理対象サーバーwls1:7002、wls2:7002およびwls3:7002にプロキシされます。

例2: クライアントでパーティション・パスによってWebサイトが分割される

ドメインに2つのパーティションがあるとします。

- VirtualTarget1のホスト名はwww.foo.com、URI接頭辞(パーティション・パス)は、Oracle WebLogic Serverで構成されている/myCompany1になります。

- VirtualTarget2のホスト名はwww.foo.com、URI接頭辞(パーティション・パス)は、Oracle WebLogic Serverで構成されている/myCompany2になります。

この場合、パーティション・パスを構成する必要はありません。

<VirtualHost *:8080>
<IfModule mod_weblogic.c>
ServerName server1
WebLogicCluster wls1:7001,wls2:7001,wls3:7001
SetHandler weblogic-handler
</IfModule>
</VirtualHost>

使用可能なURLは次のとおりです。

www.foo.com:8080/myCompany1

www.foo.com:8080/myCompany2

7.4.1.2 iPlanet Serverの構成の変更

次に、新しいパーティションを追加するたびに、iPlanet Serverプラグイン構成ファイルに追加する必要があるサンプル構成を示します。

1. iPlanet Server用プラグインをインストールします。「iPlanet用プラグインのインストールと構成」を参照してください。

2. magnus.confファイルを編集し、次のセクションを追加します。

ServerName server_URL
Init fn="load-modules" shlib="path to the /plugin/mod_wl.so file"

次にその例を示します。

ServerName www.myCompany.com
Init fn="load-modules" shlib="/scratch/plugin/mod_wl.so"/"

3. 新しいパーティションごとに、obj.confファイルを編集して次のセクションを追加します。

<Object name="weblogic" ppath="*">
Service ChunkedRequestBufferSize="0" fn="wl-proxy" WebLogicCluster="comma_separated_list_of_WebLogic_clusters" PathPrepend="optional_uri_of_the_partition" SecureProxy="OFF" WLIOTimeoutSecs="10"
</Object>

次にその例を示します。

<Object name="weblogic" ppath="*">
Service ChunkedRequestBufferSize="0" fn="wl-proxy" WebLogicCluster="wls1:7001,wls2:7001,wls3:7001" PathPrepend="/partition1" SecureProxy="OFF" WLIOTimeoutSecs="10"
</Object>

4. 構成の変更後、iPlanet Serverを再起動する必要があります。

7.4.1.3 IIS Serverの構成の変更

次に、新しいパーティションを追加するたびに、Microsoft IISプラグイン構成ファイルに追加する必要があるサンプル構成を示します。

1. Microsoft IIS Server用プラグインをインストールします。「Microsoft IIS 7.5プラグインのインストールと構成」を参照してください。

2. 「IIS マネージャー」を開き、新しいWebサイトを作成します。

ホスト名を設定します。たとえば、www.myCompany.comに設定します。

3. IISサーバーにプラグインを追加します。

「IIS マネージャー」で「ハンドラー マッピング」をクリックして、特定のMIMEタイプのマッピングをハンドラーに設定します。

4. プラグイン構成ファイルを作成します。

次の内容のiisproxy.iniというファイルを作成し、プラグインのあるディレクトリに置きます。新しいパーティションごとに同様の内容をファイルに作成します。

WebLogicCluster=comma_separated_list_of_WebLogic_clusters
Debug=ALL
WLLogFile=path to the wlproxy.log file
PathPrepend=optional_uri_of_the_partition
SecureProxy=OFF
WLIOTimeoutSecs=10

次にその例を示します。

WebLogicCluster=wls1:7001,wls2:7001,wls3:7001
Debug=ALL
WLLogFile=C:/pp_iis_home/myCompany/logs/iis7.0_wlproxy.log
PathPrepend=/partition1
SecureProxy=OFF
WLIOTimeoutSecs=10

5. 構成の変更後、Microsoft IIS Serverを再起動する必要があります。

7.4.2 パーティションの変更およびパーティション移行

パーティション移行は、Oracle WebLogic Server MTの機能です。Oracle WebLogic Serverプロキシ・プラグイン側でパーティションは移行できません。パーティションを移行したら、新しいパーティション情報を使用するには、Oracle WebLogic Serverプロキシ・プラグイン構成を手動で更新する必要があります。

パーティション移行の詳細は、『Oracle Fusion Middleware WebLogic Server MTの使用』のパーティションのエクスポートとインポートに関する項を参照してください。

Oracle WebLogic Server側でパーティションを変更する場合、対応する変更をプラグイン構成に加える必要があります。Oracle WebLogic Server側では、通常、VirtualHostパラメータ(ホストとポート)およびオプションでURIを変更できます。この場合、プラグイン構成でServerNameおよびPathPrependパラメータを編集する必要があります。

Oracle WebLogic Server側で管理対象サーバーを追加、削除または移行する場合、対応する変更をプラグイン構成でも加える必要があります。

たとえば、次のOracle HTTP Server (またはApache)プラグイン構成があるとします。

<VirtualHost *:8080>
<IfModule mod_weblogic.c>
ServerName server1
WebLogicCluster wls1:7001,wls2:7001,wls3:7001
SetHandler weblogic-handler
</IfModule>
</VirtualHost>

管理対象サーバーwls4をパーティションに追加する場合、wls4をWebLogicClusterパラメータに追加します。

<VirtualHost *:8080>
<IfModule mod_weblogic.c>
ServerName server1
WebLogicCluster wls1:7001,wls2:7001,wls3:7001,wls4:7001
SetHandler weblogic-handler
</IfModule>
</VirtualHost>

管理対象サーバーwls1をパーティションから削除する場合、wls1をWebLogicClusterパラメータから削除します。

<VirtualHost *:8080>
<IfModule mod_weblogic.c>
ServerName server1
WebLogicCluster wls2:7001,wls3:7001,wls4:7001
SetHandler weblogic-handler
</IfModule>
</VirtualHost>

管理対象サーバーwls2をwls5に移行する場合、wls2を削除して、wls5をWebLogicClusterパラメータに追加します。

<VirtualHost *:8080>
<IfModule mod_weblogic.c>
ServerName server1
WebLogicCluster wls3:7001,wls4:7001,wls5:7001
SetHandler weblogic-handler
</IfModule>

Oracle WebLogic Server側のパーティションの変更の詳細は、『Oracle Fusion Middleware WebLogic Server MTの使用』のドメイン・パーティションの構成に関する項、仮想ターゲットの構成に関する項およびパーティションのエクスポートとインポートに関する項を参照してください。

7.4.3 Web ServerとOracle WebLogic Serverとの間のSSLの構成

Oracle WebLogic Serverの場合と同様にOracle WebLogic Server MTでSSLを構成しますが、同じホスト名を対象とするパーティションには同じ証明書が必要になります。

7.4.4 クラスタ変更の動的検出

クラスタ変更の動的検出は、Oracle WebLogic Serverプロキシ・プラグインとOracle WebLogic Serverの両方の機能です。マルチテナンシによる影響はありません。この機能は、DynamicServerListパラメータを使用して制御可能です。詳細は、「DynamicServerList」を参照してください。

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

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

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

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

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

注意:

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

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

- Apache HTTP Server用プラグインの構成

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

- Microsoft IIS Web Server用プラグインの構成

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

Webサーバー・プラグインの一般的なパラメータについて、次の各項で説明します。パラメータの名前では、大/小文字が区別されます。

- ConnectRetrySecs

- ConnectTimeoutSecs

- Debug

- DebugConfigInfo

- DefaultFileName

- DynamicServerList

- ErrorPage

- FileCaching

- Idempotent

- KeepAliveEnabled

- KeepAliveSecs

- MatchExpression

- MaxPostSize

- MaxSkipTime

- PathPrepend

- PathTrim

- QueryFromRequest

- WebLogicCluster

- WebLogicHost

- WebLogicPort

- WLCookieName

- WLDNSRefreshInterval

- WLExcludePathOrMimeType

- WLFlushChunks

- WLForwardUriUnparsed

- WLIOTimeoutSecs

- WLLocalIP

- WLLogFile

- WLMaxWebSocketClients

- WLProxyPassThrough

- WLProxySSL

- WLProxySSLPassThrough

- WLRetryAfterDroppedConnection

- WLSendHdrSeparately

- WLServerInitiatedFailover

- WLSocketTimeoutSecs

- WLSRequest

- WLTempDir

8.1.1 ConnectRetrySecs

デフォルト: 2

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

WebLogic Serverホスト(またはクラスタ内のすべてのサーバー)への接続試行の間にプラグインがスリープする間隔(秒)。この値はConnectTimeoutSecsより小さくします。クライアントにHTTP 503/Service Unavailableというレスポンスを返す前にプラグインが接続を試みる回数は、ConnectTimeoutSecsをConnectRetrySecsで除算することで算出されます。

再試行しないようにするには、ConnectRetrySecsをConnectTimeoutSecsと同じ値に設定します。ただし、プラグインは最低でも2回の接続を試みます。

エラー・レスポンスは、ErrorPageパラメータを使用してカスタマイズできます。

8.1.2 ConnectTimeoutSecs

デフォルト: 10

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

プラグインがWebLogic Serverホストへの接続を試行する最大時間(秒)。この値はConnectRetrySecsより大きくしてください。指定どおりに再試行されたが(ConnectRetrySecsを参照)、接続に成功せずにConnectTimeoutSecsの秒数が経過した場合は、クライアントにHTTP 503/Service Unavailableというレスポンスが送信されます。

エラー・レスポンスは、ErrorPageパラメータを使用してカスタマイズできます。

8.1.3 Debug

デフォルト: OFF

適用対象: Microsoft IIS

デバッグ操作で実行するロギングのタイプを設定します。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との間で送受信されたヘッダー、情報メッセージおよびエラー・メッセージを記録します。

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

8.1.4 DebugConfigInfo

デフォルト: OFF

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

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

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

8.1.5 DefaultFileName

デフォルト: none

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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アプリケーションで同じウェルカム・ファイルを指定する必要があります。詳細は、ウェルカム・ページの構成に関する項を参照してください。

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

8.1.6 DynamicServerList

デフォルト: ON

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

OFFに設定すると、プラグインはプロキシされたロード・バランシング・リクエストに使用される動的クラスタ・リストを無視し、WebLogicClusterパラメータで指定された静的リストのみを使用します。通常は、このパラメータをONに設定したままにしてください。

このパラメータをOFFに設定した場合は、次のような影響があります。

- 静的リスト内の1つ以上のサーバーが失敗した場合、プラグインは停止したサーバーへの接続を試行し無駄な時間を費やすことがあるため、パフォーマンスが低下します。

- クラスタに新しいサーバーを追加した場合、このパラメータを再定義しないかぎりプラグインは新しいサーバーへリクエストをプロキシ設定できません。WebLogicサーバーは、新しいサーバーがクラスタの一部になると、これらのサーバーを動的サーバー・リストへ自動的に追加します。

8.1.7 ErrorPage

デフォルト: none

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

WebサーバーからWebLogic Serverにリクエストを転送できなかった場合に表示される、ユーザー独自のエラー・ページを作成できます。

バックエンド・サーバーが「HTTP 503: サービスが使用できません」レスポンスを返し、フェイルオーバー用のサーバーがない場合、プラグインはエラー・ページにリダイレクトします。

8.1.8 FileCaching

デフォルト: ON

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

8.1.9 Idempotent

デフォルト: ON

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

ONに設定されている状態で、サーバーがWLIOTimeoutSecsの時間内に応答しない場合、プラグインはフェイルオーバーします(メソッドがIdempotentの場合)。

IdempotentをONに設定してある場合も、プラグインによってフェイルオーバーされるため、サーバーからREAD_ERROR_FROM_SERVERなどのエラーが返されます。

IdempotentがOFFに設定されている場合、プラグインはフェイルオーバーしません。Apache HTTP Serverを使用している場合は、複数のURLまたはMIMEタイプに対してこのパラメータを別々に設定できます。

Idempotentが有効なのは、リクエストがWebLogic Serverに正常に送信され、プラグインがバックエンド・サーバーからのレスポンスを待機中の場合のみです。

POSTリクエストは、Idempotentとマークされていても再試行されません。

8.1.10 KeepAliveEnabled

デフォルト: true (Microsoft IISプラグイン)、ON (Oracle HTTP ServerおよびApache HTTP Server)、ON (Oracle iPlanet Web Server)

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

プラグインと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です。

8.1.11 KeepAliveSecs

デフォルト: 20

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

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

8.1.12 MatchExpression

デフォルト: none

適用対象: Oracle HTTP Server、Apache HTTP Server

このパラメータを使用すると、既存のパラメータ値の変更や、特定の構成に対する新しいパラメータの追加が可能です。

MatchExpressionパラメータは、*と?の正規表現のみをサポートします。

- 0以上の文字と一致する*

- 1つの文字と完全に一致する?

このパラメータは、次のような2つのシナリオについて構成できます。

MIMEタイプによるプロキシ:

特定のMIMEタイプに対して他のパラメータを設定するには、次の形式でこのパラメータを使用します。

構文:

MatchExpression <file_extension> <param=value>|<param-value>|…

たとえば、次の構成では、*.jspはmyHost:8080にプロキシされます。

<IfModule weblogic_module>
MatchExpression *.jsp WebLogicHost=myHost|WebLogicPort=8080
</IfModule>

パスによるプロキシ:

また、特定のパスに対して他のパラメータを設定するには、次の形式でこのパラメータを使用します。

構文:

MatchExpression <path> <param=value>|<param-value>|…

たとえば、次の構成では、/weblogicで始まるURIはmyHost:9090にプロキシされます。

<IfModule weblogic_module>
MatchExpression /weblogic WebLogicHost=myHost|WebLogicPort=9090
</IfModule>

前述のとおり、MatchExpressionを使用してパラメータ値をオーバーライドすることもできます。新しいパラメータ(構成内で使用されていないパラメータ)の定義に使用することも可能です。

たとえば、次のような構成では、すべてのリクエストがmyHost:8080にプロキシされます。タイプjpgに一致するURIはmyHost:8080/imagesにプロキシされ、その他のURIはmyHost:8080にプロキシされます。

<IfModule weblogic_module>
SetHandler weblogic-handler
WebLogicHost myHost
WebLogicPort 8080
MatchExpression *.jpg PathPrepend=/images
</IfModule>

MatchExpressionの使用方法のその他の例は、「Apache HTTP Server用プラグインの構成」に記載されています。

8.1.13 MaxPostSize

デフォルト: 0

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

8.1.14 MaxSkipTime

デフォルト: 10

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

WebLogicClusterパラメータか、WebLogic Serverから戻される動的クラスタ・リストのどちらかにリストされているWebLogic Serverで障害が発生した場合、障害の発生したサーバーはbadとしてマークされ、プラグインによって、リスト内の次のサーバーへの接続が試みられます。

MaxSkipTimeには、プラグインがbadとしてマークされたサーバーへの接続を再試行するまでの時間を設定します。プラグインは、一意のリクエスト(つまり、Cookieのないリクエスト)を受信するたびにリスト内の新しいサーバーに接続しようとします。

8.1.15 PathPrepend

デフォルト: null

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

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

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

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

8.1.16 PathTrim

デフォルト: null

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

8.1.17 QueryFromRequest

デフォルト: OFF

適用対象: Oracle HTTP Server、Apache HTTP Server

ONに設定すると、Apache HTTPサーバーで次のコマンドが使用されます。

(request_rec *)r->the_request

問合せ文字列をWebLogic Serverに渡します。(詳細は、Apacheドキュメントを参照してください。)この動作は、Netscapeバージョン4.xブラウザで、問合せ文字列にスペースのあるリクエストを行う場合に役立ちます。

OFFに設定すると、Apache HTTPサーバーで(request_rec *)r->argsが使用され、WebLogic Serverに問合せ文字列が渡されます。

8.1.18 WebLogicCluster

WebLogic Serverの1つのクラスタ、またはクラスタ化されていない複数のサーバーにプロキシする場合は必須

デフォルト: none

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

ロード・バランシングに使用可能なWebLogic Serverのリスト。サーバーまたはクラスタのリストは、host:portエントリのリストです。クラスタとシングル・サーバーを組み合せて指定した場合、このパラメータに対して返される動的リストには、クラスタ化されたサーバーのみが含まれます。

このパラメータの値を指定するための構文は、プラグインの構成対象となるWebサーバーに応じて異なります。詳細は、次を参照してください。

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

- Apache HTTP Server用プラグインの構成

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

- Microsoft IIS Web Server用プラグインの構成

プラグインとWebLogic Serverの間にSSLを使用している場合は、ポート番号をSSLリスニング・ポートに設定して、SecureProxyパラメータをONに設定します。

このプラグインは、すべての使用可能なサーバーの間の単純なラウンドロビンを実行します。このプロパティで指定したサーバー・リストが、サーバーとプラグインが保持する動的サーバー・リストの開始点となります。WebLogic Serverとこのプラグインの連携により、クラスタに発生した新規のクラスタ・メンバー、失敗したクラスタ・メンバーおよびリカバリしたクラスタ・メンバーを反映してサーバーのリストが自動的に更新されます。

動的クラスタ・リストの使用を無効にするには、DynamicServerListパラメータをOFFに設定します。

このプラグインはCookie、URLエンコード済セッション、またはPOSTデータに格納されたセッションを含むHTTPリクエストを、Cookieを作成したクラスタ内のサーバーに送信します。

8.1.19 WebLogicHost

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

デフォルト: none

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

8.1.20 WebLogicPort

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

デフォルト: none

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

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

8.1.21 WLCookieName

デフォルト: JSESSIONID

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

8.1.22 WLDNSRefreshInterval

デフォルト: 0 (起動時に1回ルックアップ)

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server

プロキシ構成で定義されている場合、WebLogic ServerがサーバーのDNS名とIPとの間のマッピングをリフレッシュする間隔を秒数で指定します。WebLogic Serverインスタンスを別のIPアドレスに移行する場合に使用できますが、そのサーバーのIPのDNS名は変更されません。この場合、指定したリフレッシュ間隔で、DNSとIPとの間のマッピングが更新されます。

8.1.23 WLExcludePathOrMimeType

デフォルト: none

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

このパラメータによって、プロキシ設定から一定のリクエストを除外できます。

このパラメータは、グローバルに定義することも、「場所」タグ・レベルでローカルに定義することもできます。このプロパティをローカルに定義した場合、グローバルなプロパティがオーバーライドされるのではなく、2つのパラメータの集合が定義されます。

8.1.24 WLFlushChunks

デフォルト: False

適用対象: Microsoft IIS

デフォルトで、IISプラグインは、チャンクの受信時にそれをストリーミングするのではなく、チャンク転送エンコーディングのレスポンスをバッファします。WLFlushChunksフラグをtrueに設定すると、プラグインは、WebLogic Serverからのチャンクの受信時にすぐにそれをフラッシュします。

8.1.25 WLForwardUriUnparsed

デフォルト: OFF

適用対象: Oracle HTTP Server、Apache HTTP Server

ONに設定されている場合、WLSプラグインは元のURIをクライアントからWebLogic Serverに転送します。OFF (デフォルト)に設定されている場合、WebLogic Serverに送信されたURIは、mod_rewriteまたはその他のWebサーバー・プラグイン・モジュールによって変更されることがあります。

8.1.26 WLIOTimeoutSecs

HungServerRecoverSecsの新しい名称。

デフォルト: 300

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

最小値: 10

最大値: 制限なし

8.1.27 WLLocalIP

デフォルト: none

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

プラグインがマルチホーム・マシン上で実行されているWebLogic Serverインスタンスに接続する際の、バインド先(プラグインのシステム上)となるIPアドレスを定義します。

WLLocalIPを設定しない場合、TCP/IPスタックはソースIPアドレスを選択します。

8.1.28 WLLogFile

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

適用対象: Microsoft IIS

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

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

8.1.29 WLMaxWebSocketClients

デフォルト: Windows: ThreadsPerChildの半分、Windows以外: MaxRequestWorkers (またはApache 2.2の場合はMaxClients)の半分

適用対象: Oracle HTTP Server、Apache HTTP Server

アクティブなWebSocket接続の数をいつでも制限します。

注意:

このパラメータに設定できる最大値は、ThreadsPerChildの75% (Windowsの場合)またはMaxRequestWorkers (Windows以外でApache 2.2の場合はMaxClients)の75%となります。このパラメータに対して指定された値が、許容されている最大値よりも大きい場合は、自動的にその最大値以下に設定されます。

8.1.30 WLProxyPassThrough

デフォルト: OFF

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

8.1.31 WLProxySSL

デフォルト: OFF

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

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

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

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

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

8.1.32 WLProxySSLPassThrough

デフォルト: OFF

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

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

8.1.33 WLRetryOnTimeout

デフォルト: なし

適用対象: Oracle HTTP Server、Apache HTTP Server

タイムアウトが発生したときに、WebLogicサーバーがステータス行を送信する前にリクエストを再試行するかどうかをWebLogicプラグインに伝えます。有効な引数は次のとおりです。

- ALL: すべてのリクエストが再試行されます。

- IDEMPOTENT: 多重呼出し不変メソッドを使用しているリクエストのみが再試行されます。

- NONE: リクエストは再試行されません。

8.1.34 WLRetryAfterDroppedConnection

デフォルト: ALL

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

WLSがステータス行を送信する前に接続が失われた場合に、Apacheプラグインに再試行するリクエストを指示します。有効な引数は次のとおりです。

- ALL: すべてのリクエストが再試行されます。

- IDEMPOTENT: 多重呼出し不変メソッドを使用しているリクエストのみが再試行されます。

- NONE: リクエストは再試行されません。

8.1.35 WLSendHdrSeparately

デフォルト: ON

適用対象: Microsoft IIS

このパラメータをONに設定すると、ヘッダーとレスポンス本文が別々のパケットで送信されます。

注意:

ヘッダーとレスポンスの本文を2つのコールで送信する必要がある場合、たとえば、他のISAPIフィルタまたは本文の前にヘッダーがあることを期待するクライアントを持つ場合、このパラメータをONに設定します。

8.1.36 WLServerInitiatedFailover

デフォルト: ON

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

これは、Oracle WebLogic Serverからの503エラー・レスポンスによって別のサーバーへのフェイルオーバーがトリガーされるかどうかを制御します。通常プラグインは、503エラー・レスポンスを受け取ると、別のサーバーへのフェイルオーバーを試行します。WLServerInitiatedFailoverをOFFに設定すると、503エラー・レスポンスはただちにクライアントに返されます。

8.1.37 WLSocketTimeoutSecs

デフォルト: 2 (0より大きくすること)

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

ソケットの接続時のタイムアウトを秒単位で設定します。詳細は、ConnectTimeoutSecsおよびConnectRetrySecsを参照してください。

8.1.38 WLSRequest

デフォルト: OFF

適用対象: Oracle HTTP Server、Apache HTTP Server

これは、Oracle WebLogic Serverに転送されるリクエストの識別に使用されるWLSRequest Onメカニズムのかわりに使用できます。次に例を示します。

<Location /weblogic>
WLSRequest ON
PathTrim /weblogic
</Location>

SetHandler weblogic-handlerではなくWLSRequestをONにして使用すると、次のような利点があります。

- Webサーバーの処理オーバーヘッドが全般的に低減されます。

- WebサーバーのDocumentRootが処理速度の遅いファイル・システム上にある場合に起こる著しいパフォーマンスの低下が解決されます。

- ファイル・システムの長さ制限が原因でURIをファイル・システムにマップできない場合の403エラーが解決されます。

8.1.39 WLTempDir

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

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

Oracle HTTP Server、Apache HTTP ServerおよびOracle iPlanet HTTP Serverの場合は、このディレクティブでPOSTデータ・ファイル用の_wl_proxyディレクトリの場所を指定します。

Microsoft IISの場合は、このディレクティブで、wlproxy.logを作成するディレクトリを指定します。場所が見つからない場合は、プラグインによってC:/tempの下にログ・ファイルが作成されます。また、POSTデータ・ファイル用の_wl_proxyディレクトリの場所も指定します。WLTempDirとWLLogFileの両方を設定した場合は、wlproxy.logの場所はWLLogFileが優先されます。_wl_proxyディレクトリの場所は、このような場合もWLTempDirによって決定されます。

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

注意:

SCG証明書は、Oracle WebLogic Serverプロキシ・プラグインではサポートされていません。SCG以外の証明書は適切に機能するため、それらを使用することでWebLogic Serverとプラグインとの間のSSL通信が可能です。

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

Web ServerプラグインのSSLパラメータについて、次の各項で説明します。パラメータでは、大文字と小文字が区別されます。

- SecureProxy

- WebLogicSSLVersion

- WLSSLWallet

8.2.1 SecureProxy

デフォルト: OFF

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

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

8.2.2 WebLogicSSLVersion

デフォルト: プラグインとWebLogic Serverの両方でサポートされている最適なプロトコル。

適用対象: Oracle HTTP Server、Apache HTTP Server

プラグインとWebLogic Serverの間の通信に使用するSSLプロトコル・バージョンを指定します。この設定は、Webサーバーのssl.confファイルの設定と一致している必要はありません。プラグインは、WebLogic Serverとの通信に独自のSSLバージョンを使用できます。

使用できる値は次のとおりです。

- TLSv1: TLS v1.0の使用

- TLSv1_1: TLS v1.1の使用

- TLSv1_2: TLS v1.2の使用

次にその例を示します。

WebLogicSSLVersion TLSv1_1 TLSv1_2

スペース区切りのリストを使用して、複数のプロトコルを定義できます。選択されたSSLプロトコル・バージョンは、プラグインからWebLogic Serverへのすべての接続に使用されます。したがって、このパラメータはグローバル・スコープで定義してください。

構成されていない場合、プラグインは、プラグインとWebLogic Serverの両方でサポートされている最適なプロトコルを使用します。

8.2.3 WLSSLWallet

デフォルト: none

適用対象: Oracle HTTP Server、Oracle iPlanet Web Server、Apache HTTP Server、Microsoft IIS

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

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

WLSSLWallet "${ORACLE_INSTANCE}/config/fmwconfig/components/${COMPONENT_TYPE}/instances/${COMPONENT_NAME}/keystores/default"

8.3 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ディレクトリに別の場所を指定します。

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)を参照してください。