WebOTX Manual V10.2 (第4版) 目次を表示

---

3. HTTPサーバ

WebOTX では、Javaベースの内蔵Webサーバのほかに、Apache HTTP ServerベースのWebサーバ (以降「WebOTX Webサーバ」と記載します)をバンドルしています。

WebOTXでは、その他に利用可能なWebサーバとして、IIS / Apache HTTP Server の外部Webサーバをサポートしています。

WebOTX AS インストール時に、利用するWebサーバを正しく指定していればインストール後に設定する項目は、特にありません。 利用中のドメインで別のWebサーバに変更する必要が生じた場合には、「初期設定ツール」を起動し、外部Webサーバとの連携設定を行う必要があります。

3.1. Javaベース内蔵Webサーバ設定方法

3.1.1. 項目の設定

Javaベースの内蔵Webサーバの設定方法については、次の２通りがあります。

Webコンテナ管理コンソールによる設定

Webコンテナの運用管理コンソールの「network-listener」項目で、Javaベースの内蔵Webサーバの設定ができます。リスナの名称が"HTTPリスナ〜"と表示されているものが内蔵Webサーバです。詳細は「Webコンテナ」を参照してください。

MOによる参照と設定

Javaベースの内蔵Webサーバの設定は、WebコンテナのMOを介してもアクセス可能です。対象となる MO の Dottedname は「server.network-config.network-listeners.network-listener.リスナ名」です。 「server.network-config.network-listeners.network-listener.リスナ名.protocol」に紐付いた 「server.network-config.protocols.protocol.protocol名.type」の値が"nio"となっているものが内蔵Webサーバです。詳細は[ Webコンテナ ]を参照してください。

3.1.2. SSL通信の設定方法

3.2. WebOTX Webサーバ設定方法

ここでは、WebOTXで利用するWebサーバとして、「WebOTX Webサーバ」を利用する場合の設定方法について記載します。その他の外部Webサーバの設定については、[ 外部Webサーバ設定方法 ] を、Javaベースの内蔵Webサーバの設定については、[ Webコンテナ ] を参照してください。

WebOTXの運用管理コマンド / 統合運用管理ツールでは、WebOTX Webサーバの一部の定義情報の変更と参照、および、Webサーバの起動と停止ができます。また、定義情報ファイル (httpd.conf / ssl.conf) をエディタで編集して、定義情報の更新することが可能です。

3.2.1. MOによる参照と設定

運用管理コマンド / 統合運用管理ツールで変更 / 参照可能な項目と、その方法については、[ Webサーバガイド > 定義情報の参照, 定義情報の更新, 定義情報の追加 ] を参照してください。

3.2.2. 定義情報ファイル

WebOTX Webサーバの定義情報は、定義情報ファイル (httpd.conf / ssl.conf) に格納され、WebOTX Webサーバ起動時に読み込まれます。 定義情報ファイルは、WebOTX のドメイン毎に格納されるため、ドメイン毎に定義情報を変更する必要があります。

また、定義情報を更新した場合には、WebOTX Webサーバの再起動が必要です。

格納場所

• ${INSTANCE_ROOT}/config/WebServer/httpd.conf
• ${INSTANCE_ROOT}/config/WebServer/ssl.conf

SSL設定に関する定義情報は、ssl.confファイルに格納されます。 SSL通信で利用するポート番号や証明書／秘密鍵ファイルを設定／変更する場合、このファイルに定義された情報を変更する必要があります。

3.2.3. 基本定義

ここでは、WebOTX Webサーバが動作するために必要となる定義情報について 説明します。
定義情報ファイルには、最低限、次の定義を含める必要があります。

• ServerRoot
• Listen
• User / Group
• DocumentRoot
• ErrorLog
• LoadModule

3.2.3.1. ServerRoot

3.2.3.2. Listen

3.2.3.3. User / Group

3.2.3.4. DocumentRoot

3.2.3.5. ErrorLog

定義情報は、[ ログ出力 > ErrorLog ] を参照してください。

3.2.3.6. LoadModule

3.2.4. サーバ動作に関する設定

ここでは、WebOTX Webサーバの動作プロセス数に関する設定を説明します。

Windows 版は、１つの子プロセス上で複数スレッドが動作し、各スレッド上で クライアントからのリクエストを受け付けます。つまり、１リクエストに対して、 １スレッドが割り当てられます。

上記のような動作の違いにより、Windows 版と UNIX 版では、定義内容が 異なります。 動作プロセスに関連する主なディレクティブは、次の通りです。

• MaxClients
• ThreadsPerChild
• MinSpareThreads / MaxSpareThreads
• StartServers
• ServerLimit / ThreadLimit
• MaxRequestsPerChild

3.2.4.1. MaxClients

3.2.4.2. ThreadsPerChild

3.2.4.3. MinSpareThreads / MaxSpareThreads

3.2.4.4. StartServers

3.2.4.5. ServerLimit / ThreadLimit

3.2.4.6. MaxRequestsPerChild

3.2.5. SSL 定義

ここでは SSL通信を行う場合、定義情報ファイルに定義する 主な設定を説明します。
SSLに関する設定は、ssl.confファイルに格納されています。

• SSLEngine
• SSLCertificateFile
• SSLCertificateKeyFile
• SSLCACertificateFile
• SSLVerifyClient
• SSLOptions
• SSLCipherSuite
• SSLProtocol
• SSLPassPhraseDialog

3.2.5.1. SSLEngine

3.2.5.2. SSLCertificateFile

    -----BEGIN CERTIFICATE-----
          <サーバ証明書>
    -----END CERTIFICATE-----
    -----BEGIN CERTIFICATE-----
          <中間CA証明書>
    -----END CERTIFICATE-----
    -----BEGIN CERTIFICATE-----
          <クロスルート証明書>
    -----END CERTIFICATE-----

3.2.5.3. SSLCertificateKeyFile

3.2.5.4. SSLCACertificateFile

    -----BEGIN CERTIFICATE-----
          <ルート証明書>
    -----END CERTIFICATE-----
    -----BEGIN CERTIFICATE-----
          <中間CA証明書>
    -----END CERTIFICATE-----

3.2.5.5. SSLVerifyClient

3.2.5.6. SSLOptions

3.2.5.7. SSLCipherSuite

3.2.5.8. SSLProtocol

3.2.5.9. SSLPassPhraseDialog

3.2.6. ユーザ認証、アクセス制御

ここでは WebOTX Webサーバがサポートするユーザ認証機能と、 クライアントのアクセス制御に関する設定を記述します。

• AuthType
• AuthName
• AuthUserFile
• Require
• Order
• Allow / Deny

3.2.6.1. AuthType

3.2.6.2. AuthName

3.2.6.3. AuthUserFile

3.2.6.4. Require

3.2.6.5. Order

3.2.6.6. Allow / Deny

3.2.7. LDAP 連携

LDAP連携する場合に必要となる定義情報を記載します。

• AuthLDAPUrl

3.2.7.1. AuthLDAPUrl

3.2.8. ログ出力

WebOTX Webサーバが出力するログに関する定義情報について説明します。

• ErrorLog
• CustomLog
• LogFormat
• LogLevel
• ErrorLogFormat

3.2.8.1. ErrorLog

3.2.8.2. CustomLog

3.2.8.3. LogFormat

3.2.8.4. LogLevel

3.2.8.5. ErrorLogFormat

3.2.9. 通信関連

WebOTX Webサーバとの通信で利用する。

• KeepAlive
• MaxKeepAliveRequests
• KeepAliveTimeout
• SoKeepAlive
• ReceiveBufferSize
• SendBufferSize
• SoLinger
• SoReuseAddr
• TcpNodelay

3.2.9.1. KeepAlive

3.2.9.2. MaxKeepAliveRequests

3.2.9.3. KeepAliveTimeout

3.2.9.4. SoKeepAlive

3.2.9.5. ReceiveBufferSize

3.2.9.6. SendBufferSize

3.2.9.7. SoLinger

3.2.9.8. SoReuseAddr

3.2.9.9. TcpNodelay

なお、KeepAliveディレクティブと、SoKeepAliveディレクティブの関係は、次の通りです。

ユーザ数が限られている場合や、必要に応じてブラウザを落とす前提で良ければ、 HTTPレベルのキープアライブを無効 (KeepAlive Off) にして、 TCPレベルのキープアライブを有効 (SoKeepAlive On) にすることで、 コネクション再利用が最大化され、性能的なメリットを受けることができます。

3.2.10. ディレクトリ一覧表示機能の無効化

WebOTX Webサーバの定義情報ファイル (httpd.conf) において、 ディレクトリ一覧表示機能を「無効」 (ディレクトリリスティングを禁止) に 設定しています。
そのため、ブラウザからWebOTX Webサーバの DocumentRootディレクトリ (つまり http://localhost/) や、DirectoryIndexディレクティブで設定しているファイル (index.html) が 存在しないディレクトリにアクセスすると、以下の Forbidden メッセージ (HTTPステータスコード 403) が 返却されます。
WebOTX Webサーバは正常起動していますので、本メッセージが出力されることに 問題はありません。

なお、WebOTX Webサーバへのアクセスに対して正常終了 (HTTPステータス 200) が 返却されること確認する場合には、ブラウザから次のURLを指定し、 WebOTX Webサーバのマニュアルページが表示されることを確認してください。

  http://localhost/manual/

WebOTX Webサーバのディレクトリ一覧表示機能を有効にするには、 WebOTX Webサーバの定義情報ファイル (httpd.confファイル) において、 <Directory>ディレクティブ内で設定されている Options ディレクティブに Indexes オプションを追加します。
<Directory>ディレクティブは複数存在しますので、それぞれに 設定する必要があります。

<Directory "/opt/WebOTX/domains/domain1/docroot">
  Optios Indexes FollowSymLinks MultiView
  …
</Directory>

ただし、ディレクトリ一覧表示機能を有効に設定することは、 WebOTX Webサーバのセキュリティ対策上、問題となる場合があります。 本設定を有効に変更する場合には、十分な注意が必要です。

3.2.11. その他の定義情報

その他の定義情報の詳細については、次のURLを参照してください。

• Apache HTTP Server Version 2.4 - Module Index

  http://httpd.apache.org/docs/2.4/mod/

3.3. Javaベース内蔵WebサーバとWebOTX Webサーバの設定対応表

3.3.1. Webサーバに関する設定

3.3.2. SSLに関する設定

3.4. 外部Webサーバ設定方法

3.4.1. 項目の設定

環境構築ツールを使ってのドメイン作成時に、利用するWebサーバを指定することでWebコンテナとの連携設定が自動で行われます。 内蔵Webサーバを利用している環境から外部Webサーバに連携する環境に変更する場合には初期設定ツールを使って連携のための設定が必要です。設定方法は、 [ Webコンテナ > Webコンテナと連携するWebサーバを切り替える方法 > Javaベースの内蔵Webサーバから外部Webサーバへ切り替える場合 ] を参照してください。

外部Webサーバの設定方法については次の２通りがあります。なお、下記は外部Webサーバと連携するためのリスナに関する設定です。Webサーバ自体の設定については、それぞれのマニュアルを参照してください。

Webコンテナ管理コンソールによる設定

Webコンテナの運用管理コンソールの「network-listener」項目で、外部のWebサーバと連携するためのリスナの設定ができます。リスナの名称が"AJPリスナ(〜)"と表示されているものが外部Webサーバ連携用のリスナです。詳細は「Webコンテナ」を参照してください。

MOによる参照と設定

外部Webサーバ連携用リスナの設定は、WebコンテナのMOを介してもアクセス可能です。対象となる MO の Dottedname は「server.network-config.network-listeners.network-listener.リスナ名」です。
「server.network-config.network-listeners.network-listener.リスナ名.protocol」に紐付いた 「server.network-config.protocols.protocol.protocol名.type」の値が"ajp"となっているものがエージェントプロセス用外部Webサーバ連携用リスナ設定です。詳細は「Webコンテナ」を参照してください。

「server.network-config.network-listeners.network-listener.リスナ名.protocol」に紐付いた 「server.network-config.protocols.protocol.protocol名.type」の値が"tpm"となっているものがTPシステム用外部Webサーバ連携用リスナ設定(プロトコル用の設定※1)です。詳細は「Webコンテナ」を参照してください。

※1 通信に関する設定は「TPシステム」の「WebOTX　AJPリスナ」を参照してください。