1.3. HTTPサーバ

WebOTX では、Javaベースの内蔵Webサーバのほかに、ApacheベースのWebサーバ (以降「WebOTX Webサーバ」と記載します)をバンドルしています。 WebOTX Webサーバは、インストール時の指定によりVer2.2 (Apache HTTP Server 2.2 ベース)またはVer2.4(Apache HTTP Server 2.4ベース)を選択してインストールすることができます。

WebOTXでは、その他に利用可能なWebサーバとして、IIS/Apache などの外部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.3. 外部Webサーバ設定方法」項目を参照してください。

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

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

項目の設定

WebOTX Webサーバの定義情報を設定(変更)するには、otxadmin コマンドを利用するか、WebOTX Webサーバの定義情報ファイル(httpd.conf) を直接編集します。

>otxadmin set --user admin --password adminadmin server.WebServer.属性名=設定値

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

設定項目の詳細については、ApacheのマニュアルまたはWebサイトを参照してください。

例えば、WebOTX Webサーバが利用するポート番号を80番から8080番に変更する場合には、 次の方法を利用します。

otxadmin コマンド利用時
>otxadmin set --user admin --password adminadmin server.WebServer.port=8080

httpd.conf 直接編集時
  #Listen 80
  Listen 8080

SSL(HTTPS)通信用の設定について

HTTPS通信を行うには、SSL通信用のモジュールのインストールと、次節のMO設定においてSSL通信を行うかどうかの設定 (security_enabled )を、「有効」(ture)に設定する必要があります。

なお、SSL(HTTPS)通信に関する定義情報を変更する場合は

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

の設定項目を変更する必要があります。

詳細については、マニュアルの「注意制限事項」「Webサーバ」「SSL(HTTPS)通信について」を参照してください。

1.3.2.1. MOで設定可能な項目一覧

以下はMOから設定可能なWebOTX Webサーバの定義情報項目の一覧です。

各定義情報は、${INSTANCE_ROOT}/config/WebServer/httpd.conf または${INSTANCE_ROOT}/config/WebServer/ssl.conf を直接編集することでも変更可能です。

Dottedname : server.WebServer

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 (または Port)
• 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.3.6. LoadModule

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

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

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

上記のような動作の違いにより、Windows 版と UNIX 版では、定義内容が 異なります。また、 2.2 でも定義内容が異なる場合があります。
動作プロセスに関連する主な設定は次の指示子となります。

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

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

1.3.2.5.1. SSLEngine

1.3.2.5.2. SSLCertificateFile

1.3.2.5.3. SSLCertificateKeyFile

1.3.2.5.4. SSLCACertificateFile

1.3.2.5.5. SSLVerifyClient

1.3.2.5.6. SSLOptions

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

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.9. 起動待ち合わせ時間の設定

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.10. その他の定義情報

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

• http://httpd.apache.org/docs/2.2/mod/

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

1.3.3. 外部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コンテナ」を参照してください。