7 Oracle HTTP Serverの構成

この章では、OPMN opmn.xmlファイルのOracle HTTP Serverの構成について説明します。

この章の項目は次のとおりです。

• 第7.1項「Oracle HTTP Server プロセス・モジュールの構成」

• 第7.2項「Oracle HTTP Serverの最小構成」

• 第7.3項「Oracle HTTP Serverの完全構成」

• 第7.4項「Oracle HTTP Serverの属性の説明」

• 第7.5項「Oracle HTTP Server 2」

• 第7.6項「一般的なApache（Linuxのみ）」

  注意 各ORACLE_HOMEには、Oracle HTTP Serverを1つのみ構成できます。 Oracle Application Server 10gリリース3（10.1.3.1.0）には、Apache 1.3に基づいたOracle HTTP Serverが付属しています。このバージョンのOracle Application Serverの構成では、Apache 2に基づいたOracle HTTP Server 2を実行できません。 Oracle HTTP Server 2を使用するには、Oracle HTTP Server 2スタンドアロン・インストールを使用する必要があります。Oracle HTTP Server 2スタンドアロン・インストールは、付属のCDから利用可能です。Oracle HTTP Server 2インストールの構成では、Oracle HTTP Serverを実行できません。

7.1 Oracle HTTP Server プロセス・モジュールの構成

次のコードは、Oracle HTTP Serverプロセス・モジュールのロードと識別を行います。プロセス・モジュールによるOracle HTTP Serverプロセスの管理は、module idによって識別されます。

<module path="ORACLE_HOME/opmn/lib/libopmnohs.so">
   <module-id="OHS"/>
</module>

7.2 Oracle HTTP Serverの最小構成

次のコードは、Oracle HTTP Serverの最小限の構成を示します。Oracle HTTP Serverの他のすべての構成要素と属性にはデフォルト値が割り当てられます。

<ias-component id="HTTP_Server">
   <process-type id="HTTP_Server" module-id="OHS">
      <process-set id="HTTP_Server" numprocs="1"/>
   </process-type>
</ias-component>

7.3 Oracle HTTP Serverの完全構成

次のコードは、Oracle HTTP Serverの完全な構成を示します。これには、Oracle HTTP Serverに使用できる構成要素と属性がすべて含まれています。

<ias-component id="HTTP_Server" status="enabled" id-matching="false">
   <process-type id="HTTP_Server" module-id="OHS">
      <process-set id="HTTP_Server" restart-on-death="true" numprocs=1>
         <module-data>
            <category id="start-parameters">
               <data id="config-file" value="/myconfs/httpd.conf"/>
               <data id="start-mode" value="ssl-disabled"/>
               <data id="command-line" value="-D MyDefine"/>
               <data id="routing-id" value="routing id">
            </category>
            <category id="ping-parameters">
               <data id="ping-url" value="/"/>
            </category>
            <category id="restart-parameters">
               <data id="reverseping-timeout" value="345"/>
               <data id="no-reverseping-failed-ping-limit" value="3"/>
               <data id="reverseping-failed-ping-limit" value="6"/>
            </category>
         </module-data>
            <start timeout="300" retry="3"/>
            <stop timeout="300"/>
            <restart timeout="300"/>
            <ping timeout="30" interval="30"/>
      </process-set>
   </process-type>
</ias-component>

7.4 Oracle HTTP Serverの属性の説明

この項では、Oracle HTTP Serverに固有の属性について説明します。

Oracle HTTP Serverの属性について、次の形式で記述します。

• タイトル: 属性名とその設定値を示します。たとえば、id="HTTP_Server"のように記述します。

• 必須: コンポーネントの定義において、この属性が必須かどうかを示します。

• デフォルト値: この属性に割り当てられるデフォルトの値を示します。デフォルト値は、インストールされたバージョンのopmn.xmlファイルに表示されるか、属性が存在しない場合は内部的に割り当てられます。

• 有効値: 該当する場合、この属性に対する有効値を示します。たとえば、HTTP_Serverのように記述します。

• パス: この属性をどの要素内で指定できるかを示します。たとえば、ias-component/process-type/process-setのように記述します。

id="HTTP_Server"

必須: ○

デフォルト値: なし

有効値: HTTP_Server

パス: ias-component

パス: ias-component/process-type

パス: ias-component/process-type/process-set

id属性は必須で、変更できません。idは、targets.xmlのエントリと一致している必要があります。一致しない場合、Application Server Controlコンソールは機能しません。

module-id="OHS"

必須: ○

デフォルト値: なし

有効値: OHS

パス: ias-component/process-type

module-id属性は、プロセスのタイプを定義します。これにより、この構成とプロセス・モジュールが関連付けられます。OHS module-idは、Apache 1.3の管理用に構成できます。

numprocs=1

必須: ○

デフォルト値: なし

有効値: 1

パス: ias-component/process-type/process-set

numprocs属性には、起動するOracle HTTP Serverインスタンスの数を指定します。有効な値は1のみです。

id="start-parameters"

必須: ×

デフォルト値: なし

パス: ias-component/process-type/process-set/module-data/category

start-parametersカテゴリには、Oracle HTTP Serverの起動に関連するパラメータが含まれます。

id="config-file"

必須: ×

デフォルト値: ORACLE_HOME/Apache/Apache/conf/httpd.conf

有効値: 既存の構成ファイルへの任意のフルパス

パス: ias-component/process-type/process-set/module-data/category/

data

config-file idは、Oracle HTTP Serverの起動に使用するhttpd.confを指定するコマンド・オプションです。config-file idは、Microsoft Windowsではサポートされていません。

id="start-mode"

必須: ×

デフォルト値: ssl-disabled

有効値: ssl-enabled/ssl-disabled

パス: ias-component/process-type/process-set/module-data/

category/data

このオプションは、Oracle HTTP Serverをssl enabledで起動するかどうかを指定します。

id="command-line"

必須: ×

デフォルト値: なし

有効値: Oracle HTTP Serverへの任意の有効なコマンドライン・オプション

パス: ias-component/process-type/process-set/module-data/

category/data

このidオプションでは、Oracle HTTP Serverコマンドラインに追加する追加コマンドラインを指定します。

id="routing-id"

必須: ×

デフォルト値: なし

親要素: category

属性: Value

routing-idはルーティングIDモジュールの値を定義します。

Oracle HTTP Serverのrouting-id要素は、opmn.xmlファイルまたはOracle HTTP Serverの構成のいずれかで構成できます。ただし、この両方でrouting-id要素が構成されている場合、OPMNは起動しません。

value="routing id"

必須: ○

デフォルト値: なし

有効値: 任意の文字列

routing idは、OC4JとOracle HTTP Server間のルーティング上の関係を指定します。つまり、Oracle HTTP Serverは、同一のrouting idを持つすべてのOC4Jに対してルーティングを行います。デフォルトでは、routing idは、opmn.xmlファイルのias-instance下でmodule dataとして指定されています。routing-idのデフォルトはg_rt_idです。opmn.xmlファイルでは階層制が採用されており、opmn.xmlファイルに構成されているすべてのコンポーネントは、routing idの構成を継承します。Oracle HTTP ServerまたはOC4Jに別のrouting idを構成するには、opmn.xmlファイルで下位のrouting idを構成する必要があります。opmn.xmlファイルの多くのエントリと同様に、下位に構成されたエントリは、上位に構成されたエントリよりも優先されます。

id="ping-parameters"

必須: ×

デフォルト値: なし

パス: ias-component/process-type/process-set/module-data/

category

ping parametersカテゴリには、OPMNがOracle HTTP Serverにpingを実行する方法を構成するパラメータが含まれます。

id="ping-url"

必須: ×

デフォルト値: /

有効値: URLのパス部分。たとえば、http://127.0.0.1/<path>などです。

パス: ias-component/process-type/process-set/module-data/

category/data

ping-url idは、OPMNがOracle HTTP Serverにpingを実行するURLを指定します。

id="restart-parameters"

必須: ×

デフォルト値: なし

パス: ias-component/process-type/process-set/module-data/

category

restart-parametersカテゴリは、障害の検出に使用するパラメータを定義するために使用されます。

id="reverseping-timeout"

必須: ×

デフォルト値: 300秒

有効値: 適切なタイムアウト値

パス: ias-component/process-type/process-set/module-data/

category/data

reverseping-timeout値は、Oracle HTTP Serverプロセスから受け取る通知間の最大許容時間です。障害検出機能の一部として、Oracle HTTP Serverモジュールは、Oracle HTTP Serverプロセスにフォワードpingを実行します。フォワードpingの起動が失敗した場合は、障害の検出においてリバースpingが考慮され、Oracle HTTP Serverプロセスが再起動されます。

id="no-reverseping-failed-ping-limit"

必須: ×

デフォルト値: 1

有効値: リバースpingも失敗した場合に、フォワードpingの失敗に対してOPMNが持つトレランスを示す任意の適切な値。OPMNは、このトレランスを使用して、プロセスを応答なしと宣言して置換するタイミングを決定します。

パス: ias-component/process-type/process-set/module-data/category/

data

このid module data要素は、（reverseping-timeoutデータ要素によって指定されているタイムアウト時間内に）リバースpingも受信しない場合の、フォワードpingの失敗に対するトレランスを定義します。pingが失敗した回数がこの上限値に達すると、プロセスは応答なしと見なされ、OPMNによって再起動されます。

id="reverseping-failed-ping-limit"

必須: ×

デフォルト値: 3

有効値: リバースpingを受信した場合に、フォワードpingの失敗に対してOPMNが持つトレランスを示す任意の適切な値。OPMNは、このトレランスを使用して、プロセスを応答なしと宣言して置換するタイミングを決定します。

パス: ias-component/process-type/process-set/module-data/category/

data

このmodule data要素は、リバースpingが成功した場合に、フォワードpingの失敗に対して持つトレランスを定義します。pingが失敗した回数がこの上限値に達すると、プロセスは応答なしと見なされ、OPMNによって再起動されます。

7.5 Oracle HTTP Server 2

Apache 2に基づいたOracle HTTP Server 2（OHS2）のモジュールIDは、Oracle Application Server 10gとともに付属のCDに含まれるApache 2バージョンの管理に使用されます。

module-id="OHS2"

必須: ○

デフォルト値: なし

有効値: OHS2

パス: ias-component/process-type

module-id属性は、プロセスのタイプを定義します。これにより、この構成とプロセス・モジュールが関連付けられます。

id="mpm"

必須: ×

デフォルト値: prefork

有効値: worker/prefork

パス: ias-component/process-type/process-set/module-data/

category/data

このオプションは、OHS2で使用するスレッド・モデルを指定します。Linuxプラットフォーム上のOHS2のみで有効です。

オラクル社では、perchild MPMはサポートしていません。Microsoft Windowsでは、mpm_winnt MPMを使用します。

7.6 一般的なApache（Linuxのみ）

Oracle HTTP Serverのプロセス・モジュールは、一般的なApacheのプロセスの管理用に構成できます。Oracle HTTP Serverのプロセス・モジュールを、一般的なApacheのプロセスの管理用に構成するには、次の手順に従います。

• モジュール定義を更新し、一般的なApacheのmodule-idを追加します。モジュール定義は、次のようになります。

  <module path="ORACLE_HOME/opmn/lib/libopmnohs.so">
     <module-id id="OHS" />
     <module-id id="GENERIC_APACHE" />
  </module>
  
  

• 一般的なApacheを管理できるようにHTTP_Serverコンポーネントを変更します。GENERIC_APACHEのプロセスは、module-dataとして指定される1つの必須パラメータを持ちます。そのパラメータは、module-dataの"start-parameters"カテゴリにある"apache-home"です。"apache-home"には、一般的なApacheのインストール・ディレクトリを指定します。次の例は、一般的なApacheの構成を示しています。

  <ias-component id="HTTP_Server">
     <process-type id="HTTP_Server" module-id="GENERIC_APACHE">
        <module-data>
           <category id="start-parameters">
              <data id="apache-home" value="/private1/apbuild/runapache_1.3.27"/>
           </category>
        </module-data>
        <process-set id="HTTP_Server" numprocs="1"/>
     </process-type>
  </ias-component>