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

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

注意:

mod_wl_ohsが提供する機能は、Apache HTTP Server用のプラグインのそれと似ています。

mod_wl_ohsはFusion Middleware Controlからまたはmod_wl_ohs.conf構成ファイルを手動で編集することで構成できます。

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

2.1項「mod_wl_ohs構成の前提条件」
2.2項「Fusion Middleware Controlを使用したmod_wl_ohsの構成」
2.3項「mod_wl_ohsの手動での構成」
2.4項「mod_wl_ohs用SSLの構成」

2.1 mod_wl_ohs構成の前提条件

mod_wl_ohsを構成する前に、次のことを行います:

Oracle WebLogic Serverがインストール済であり、ドメインが作成されており、Oracle WebLogic Serverの管理コンソールにアクセスできることを確認してください。
Fusion Middleware Controlがインストール済であり、Enterprise Managerコンソールにアクセスできることを確認してください。これは、Fusion Middleware Control提供のグラフィカル・インタフェースを使用してmod_wl_ohsを構成する際に必要となります。
構成を検証するには、必要なJavaアプリケーションが単一の管理対象Oracle WebLogic Serverまたはクラスタにデプロイされており、アクセス可能であることを確認してください。
バックエンドのOracle WebLogic Serverのインスタンスが10.3.4以降の場合、「WebLogicプラグインの有効化」パラメータを設定する必要があります。
1. Oracle WebLogic Serverの管理コンソールにログインします。
2. 「ドメイン構造」ペインで、「環境」ノードを展開します。
  - Oracle HTTP Serverからリクエストをプロキシするサーバー・インスタンスがクラスタにある場合、「クラスタ」を選択します。
  - その他の場合は、「サーバー」を選択します。
3. Oracle HTTP Serverからリクエストをプロキシするサーバーまたはクラスタを選択します。
  
  「構成: 一般」タブが表示されます。
4. 「詳細」セクションまでスクロール・ダウンし、セクションを展開して「WebLogicプラグインの有効化」チェックボックスを選択します。
5. ステップ2で「サーバー」を選択した場合、Oracle HTTP Serverからリクエストをプロキシする他のサーバーに対してステップ3および4を繰り返します。
6. 「保存」をクリックします。
サーバー・インスタンスを再起動したら変更が適用されます。

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

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

2.1項に記載されている前提条件を満たしていることを確認してください。
Oracle HTTP Serverメニューで「管理」を選択します。
「管理」メニューでmod_wl_ohs構成を選択します。mod_wl_ohs構成ページが表示されます。

mod_wl_ohs.gif図の説明
オンライン・ヘルプに記載されている構成設定を指定します。オンライン・ヘルプにはページ上のヘルプのアイコンをクリックしてアクセスできます。
設定をレビューします。

設定が正しければ、「適用」をクリックして変更を適用します。設定が正しくないか、変更を適用しない場合は、「回復」をクリックして元の設定に戻します。
Oracle HTTP Serverを再起動するには、Oracle HTTP Serverメニューから「制御」を選択し、「起動」を選択します。

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

2.3 mod_wl_ohsの手動での構成

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

2.1項に記載されている前提条件を満たしていることを確認してください。
次のディレクトリに配置されているmod_wl_ohs.confファイルをテキスト・エディタで開きます。
```
ORACLE_INSTANCE/config/OHS/component_name
```
<IfModule weblogic_module>要素を見つけます。

次の説明に従って構成ファイルの中の<IfModule weblogic_module>要素にディレクティブを追加します。

注意:

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

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

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

構文:
```
<IfModule weblogic_module>
<Location path>
SetHandler weblogic-handler
WebLogicHost host
WeblogicPort port
</Location>
</IfModule>
```
例:

次のように構成すると、Oracle HTTP Serverリスニング・ポートで受信した/myapplication URIへのリクエストはOracle WebLogic Serverのリスニング・ポートのlocalhost:7001の/myapplicationへと転送されます。
```
<IfModule weblogic_module>
<Location /myapp1>
SetHandler weblogic-handler
WebLogicHost localhost
WeblogicPort 7001
</Location>
</IfModule>
```
Oracle WebLogic Serverインスタンスのクラスタで実行されるアプリケーションにリクエストを転送するには、その宛先クラスタの詳細を新しい<location>要素の中に指定します。

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

次のように構成すると、Oracle HTTP Serverリスニング・ポートで受信した/myapplication URIへのリクエストは、リスニング・ポートがlocalhost:8002とlocalhost:8003の管理対象サーバーを含むOracle WebLogic Serverクラスタの/myapplicationへと転送されます。
```
<IfModule weblogic_module>
<Location /myapp2>
SetHandler weblogic-handler
WebLogicCluster localhost:8002,localhost:8003
</Location>
</IfModule>
```
それぞれ単一のOracle WebLogic Serverインスタンスとクラスタで実行されるアプリケーションなど、複数の宛先を構成する場合は、各宛先を異なる<location>子要素の中に指定する必要があります。なお、次の構文で示すように、<IfModule weblogic_module>要素内のすべての<location>子要素は同じレベルにある必要があります。
```
<IfModule weblogic_module>

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

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

</IfModule>
```

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

次のコマンドを実行してOracle HTTP Serverを再起動します。
```
> $ORACLE_INSTANCE/bin/opmnctl startproc ias-component=component_name
```

2.4 mod_wl_ohs用SSLの構成

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