1.3. HTTPサーバ

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

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

WebOTX AS Express インストール時のデフォルト設定は、Javaベースの内蔵Webサーバを利用し、 WebOTX AS Standard/Enterprise インストール時のデフォルト設定は、WebOTX Webサーバを利用します。 WebOTX にバンドルされたWebサーバを利用する場合、インストール後に設定する項目は 特にありません。 外部Webサーバを利用する場合には、インストール後に「環境設定ツール」を起動し、外部Webサーバとの連携設定を行う必要があります。

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

項目の設定

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

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

Webコンテナの運用管理コンソールの「コネクタ」項目で、Javaベースの内蔵Webサーバの設定ができます。コネクタの「種類」が"HTTP"と表示されているものが内蔵Webサーバです。詳細は「1.4. Webコンテナ」を参照してください。

MOによる参照と設定

Javaベースの内蔵Webサーバの設定は、WebコンテナのMOを介してもアクセス可能です。対象となる MO の Dottedname は「server.http-service.http-listener.http-listener-name」です。属性 protocol の値が "HTTP/1.1" となっているものが内蔵Webサーバです。詳細は「1.4. Webコンテナ」を参照してください。

1.3.1.1. SSL通信の設定方法

1.3.2. WebOTX Webサーバ設定方法

ここでは、WebOTXで利用するWebサーバとして、「WebOTX Webサーバ」を利用する場合の設定方法について記載します。その他の外部Webサーバを利用する場合については、「1.3.4. 外部Webサーバ設定方法」を参照してください。

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

なお、 Javaベースの内蔵Webサーバの設定については、「1.4. Webコンテナ」を参照してください。

1.3.2.1. MOによる参照と設定

運用管理コマンド / 統合運用管理ツールで変更 / 参照可能な項目と、その方法については、[ ドメイン構築・基本設定ガイド > 7. WebOTXの内部サービス > 7.6. WebOTX Webサーバ > 7.6.4. 運用 > 7.6.4.2. 定義情報の参照, 7.6.4.3. 定義情報の更新, 7.6.4.4. 定義情報の追加 ] を参照してください。

1.3.2.2. 定義情報ファイル

WebOTX Webサーバの定義情報は、定義情報ファイル(httpd.conf)に格納され、WebOTX Webサーバ起動時に読み込まれます。

定義情報ファイルは、WebOTX のドメイン毎に格納されるため、ドメイン毎に 定義情報を変更する必要があります。

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

格納場所
  ${INSTANCE_ROOT}/config/WebServer/httpd.conf

なお、SSL通信用ライブラリをインストールした場合、SSL設定に関する 定義情報は、ssl.confファイルに格納されます。

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

格納場所
  ${INSTANCE_ROOT}/config/WebServer/ssl.conf

1.3.2.3. 基本定義

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

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

1.3.2.3.1. ServerRoot

1.3.2.3.2. Listen

1.3.2.3.3. User/Group

1.3.2.3.4. DocumentRoot

1.3.2.3.5. ErrorLog

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

1.3.2.3.6. LoadModule

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

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

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

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

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

1.3.2.4.1. MaxClients

1.3.2.4.2. ThreadsPerChild

1.3.2.4.3. MinSpareThreads / MaxSpareThreads

1.3.2.4.4. StartServers

1.3.2.4.5. ServerLimit / ThreadLimit

1.3.2.4.6. MaxRequestsPerChild

1.3.2.5. SSL 定義

ここでは SSL通信を行う場合、定義情報ファイルに定義する 主な設定を説明します。
SSLに関する設定は、ssl.confファイルに格納されています。 ssl.confファイルは、SSL通信用パッケージをインストール することで追加されます。

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

1.3.2.5.1. SSLEngine

1.3.2.5.2. SSLCertificateFile

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

1.3.2.5.3. SSLCertificateKeyFile

1.3.2.5.4. SSLCACertificateFile

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

1.3.2.5.5. SSLVerifyClient

1.3.2.5.6. SSLOptions

1.3.2.5.7. SSLCipherSuite

1.3.2.5.8. SSLProtocol

1.3.2.5.9. SSLPassPhraseDialog

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

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

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

1.3.2.6.1. AuthType

1.3.2.6.2. AuthName

1.3.2.6.3. AuthUserFile

1.3.2.6.4. Require

1.3.2.6.5. Order

1.3.2.6.6. Allow / Deny

1.3.2.7. LDAP 連携

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

• AuthLDAPUrl

1.3.2.7.1. AuthLDAPUrl

1.3.2.8. ログ出力

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

• ErrorLog
• CustomLog
• LogFormat
• LogLevel
• ErrorLogFormat

1.3.2.8.1. ErrorLog

1.3.2.8.2. CustomLog

1.3.2.8.3. LogFormat

1.3.2.8.4. LogLevel

1.3.2.8.5. ErrorLogFormat

1.3.2.9. 通信関連

WebOTX Webサーバとの通信で利用する定義情報について説明します。

• KeepAlive
• MaxKeepAliveRequests
• KeepAliveTimeout
• ReceiveBufferSize
• SendBufferSize

1.3.2.9.1. KeepAlive

1.3.2.9.2. MaxKeepAliveRequests

1.3.2.9.3. KeepAliveTimeout

1.3.2.9.4. ReceiveBufferSize

1.3.2.9.5. SendBufferSize

1.3.2.10. 起動待ち合わせ時間の設定

WebOTX Webサーバのアライブチェックモニタ処理は、WebOTX Webサーバの起動処理が完了してから開始しますが、システムの状態やWebサーバのモジュール起動タイミングによっては、WebOTX Webサーバが起動しているにもかかわらず、「Webサーバが起動していない」というメッセージが出力される場合があります。これを回避するために、次の設定により、WebOTX Webサーバ起動後にアライブチェックモニタ処理を開始する時間を秒単位で指定します。

ここでは、WebOTX Webサーバの起動が完了してから10秒後にアライブチェックモニタを開始する場合の設定例を記載します。

otxadmin>create-jvm-options -Dwebotx.webserver.startup_wait_count=10

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

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サーバのセキュリティ対策上、問題となる場合があります。 本設定を有効に変更する場合には、十分な注意が必要です。

1.3.2.12. その他の定義情報

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

• Apache HTTP Server Version 2.4 - Module Index

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

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

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

1.3.3.2. SSLに関する設定

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

項目の設定

外部Webサーバを利用する場合は、事前に環境設定ツールを使って連携のための設定が必要です。設定方法は、「セットアップガイド > 2. インストール > 2.3. インストール後の作業」を参照してください。

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

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

Webコンテナの運用管理コンソールの「コネクタ」項目で、外部のWebサーバと連携するためのコネクタの設定ができます。コネクタの「種類」が"AJP"と表示されているものが外部Webサーバ連携用のコネクタです。詳細は「1.4. Webコンテナ」を参照してください。

MOによる参照と設定

外部Webサーバ連携用コネクタの設定は、WebコンテナのMOを介してもアクセス可能です。対象となる MO の Dottedname は「server.http-service.http-listener.http-listener-name」です。属性 protocol の値が "AJP/1.3" となっているものが外部Webサーバ連携用コネクタです。詳細は「1.4. Webコンテナ」を参照してください。