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

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

注意:

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

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

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

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

2.1 mod_wl_ohsの構成の前提条件

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

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

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

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

第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のリスニング・ポートで受信された/myapp1 URIのリクエストは、リスニング・ポートlocalhost:7001のOracle WebLogic Serverの/myapp1に転送されます。
```
<IfModule weblogic_module>
<Location /myapp1>
SetHandler weblogic-handler
WebLogicHost localhost
WeblogicPort 7001
</Location>
</IfModule>
```
Oracle WebLogic Serverインスタンスのクラスタ上で実行されているアプリケーションにリクエストを転送するには、その宛先クラスタの詳細を新しい<location>要素内で指定します。

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

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

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

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

</IfModule>
```

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

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

2.4 mod_wl_ohsのSSLの構成

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