クイックスタート

この文書は、Jakarta Projectが記述した JK2ドキュメントを翻訳したものです。

Apache Software Foundation | Jakarta Project | Apache Tomcat

Introduction

はじめに

This document describes the configuration files used by JK on the Web Server side for the 'impatients':

workers.properties is a mandatory file used by the webserver and which is the same for all JK implementations (Apache/IIS/NES).
WebServers add-ons to be set on the webserver side.

この文書では、「せっかちな人」のために、Web サーバ側で JK が使用する設定ファイルについて説明します。

workers.properties は必須のファイルで、Web サーバによって使われます。すべての JK の実装(Apache/IIS/NES)で同じファイルを使用します。
Web サーバ側に導入する Webサーバごとの アドオン。

We'll give here minimum servers configuration and an example workers.properties to be able to install and check quickly your configuration.

ここでは、最小限のサーバの設定と、インストールと設定の確認がすぐに出来る workers.properties の例を示します。

Minimum workers.properties

最小限の workers.properties

Here is a minimum workers.properties , using just ajp13 to connect your Apache webserver to the Tomcat engine, complete documentation is available in Workers HowTo .

以下に、最小限の workers.properties を示します。Apache Web サーバと Tomcat エンジンとの接続に ajp13 だけを使っています。完全な文書は Tomcat のワーカの手引き にあります。

# Define 1 real worker using ajp13


worker.list=worker1

# Set properties for worker1 (ajp13)


worker.worker1.type=ajp13


worker.worker1.host=locahost


worker.worker1.port=8009


worker.worker1.lbfactor=50


worker.worker1.cachesize=10


worker.worker1.cache_timeout=600


worker.worker1.socket_keepalive=1


worker.worker1.socket_timeout=300

# ajp13 を使用する 1 つのワーカを定義


worker.list=worker1

# worker1 (ajp13) のプロパティの指定


worker.worker1.type=ajp13


worker.worker1.host=locahost


worker.worker1.port=8009


worker.worker1.lbfactor=50


worker.worker1.cachesize=10


worker.worker1.cache_timeout=600


worker.worker1.socket_keepalive=1


worker.worker1.socket_timeout=300

Minimum Apache WebServer configuration

最小限の Apache Web サーバの設定

Here is a minimun informations about Apache configuration, a complete documentation is available in Apache HowTo .

以下に Apache の設定に関する最小限の情報を示します。完全な文書は Apache の手引き にあります。

You should first have mod_jk.so (unix) or mod_jk.dll (Windows) installed in your Apache module directory (see your Apache documentation to locate it).

まず始めに mod_jk.so (UNIX の場合)もしくは mod_jk.dll (Windows の場合) を Apache のモジュールディレクトリ(場所については Apache の文書を参照) にインストールしておく必要があります。

Usual locations for modules directory on Unix:

/usr/lib/apache/
/usr/lib/apache2/
/usr/local/apache/libexec/

UNIX であれば、モジュールディレクトリは以下のような場所にあります。

/usr/lib/apache/
/usr/lib/apache2/
/usr/local/apache/libexec/

Usual locations for modules directory on Windows :

C:\Program Files\Apache Group\Apache\modules\
C:\Program Files\Apache Group\Apache2\modules\

Windows であれば、モジュールディレクトリは以下のような場所にあります。

C:\Program Files\Apache Group\Apache\modules\
C:\Program Files\Apache Group\Apache2\modules\

You'll find prebuilt binaries here

ビルド済みのバイナリは ここに あります。

Here is the minimum which should be set in httpd.conf directly or included from another file:

以下に httpd.conf ファイル内もしくは他のファイルから include して指定しなければならない最小限の設定を示します。

Usual locations for configuration directory on Unix:

/etc/httpd/conf/
/etc/httpd2/conf/
/usr/local/apache/conf/

UNIX であれば、設定ファイルは以下のようなディレクトリにあります。

/etc/httpd/conf/
/etc/httpd2/conf/
/usr/local/apache/conf/

Usual locations for configuration directory on Windows :

C:\Program Files\Apache Group\Apache\conf\
C:\Program Files\Apache Group\Apache2\conf\

Windows であれば、設定ファイルは以下のようなディレクトリにあります。

C:\Program Files\Apache Group\Apache\conf\
C:\Program Files\Apache Group\Apache2\conf\

# Load mod_jk module

# Update this path to match your modules location


LoadModule    jk_module  libexec/mod_jk.so

# Declare the module for <IfModule directive>


AddModule     mod_jk.c

# Where to find workers.properties

# Update this path to match your conf directory location (put workers.properties next to httpd.conf)


JkWorkersFile /etc/httpd/conf/workers.properties

# Where to put jk logs

# Update this path to match your logs directory location (put mod_jk.log next to access_log)


JkLogFile     /var/log/httpd/mod_jk.log

# Set the jk log level [debug/error/info]


JkLogLevel    info

# Select the log format


JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "

# JkOptions indicate to send SSL KEY SIZE,


JkOptions     +ForwardKeySize +ForwardURICompat -ForwardDirectories

# JkRequestLogFormat set the request format


JkRequestLogFormat     "%w %V %T"

# Send everything for context /examples to worker named worker1 (ajp13)


JkMount  /examples/* worker1

# mod_jk モジュールのロード

# このパスはモジュールの場所に合わせて修正


LoadModule    jk_module  libexec/mod_jk.so

# <IfModule 指示子>のためにモジュールの宣言


AddModule     mod_jk.c

# workers.properties の場所の指定

# このパスは conf ディレクトリの場所に合わせて修正(workers.properties は httpd.conf と一緒に置いておく)


JkWorkersFile /etc/httpd/conf/workers.properties

# JK のログファイルの場所の指定

# このパスは logs ディレクトリの場所に合わせて修正(mod_jk.log は access_log と一緒に置いておく)


JkLogFile     /var/log/httpd/mod_jk.log

# JK のログレベルの指定[debug/error/info]


JkLogLevel    info

# ログ書式の設定


JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "

# SSL KEY SIZE を送信するように JkOptions を指定


JkOptions     +ForwardKeySize +ForwardURICompat -ForwardDirectories

# JkRequestLogFormat でリクエストの書式を指定


JkRequestLogFormat     "%w %V %T"

# すべての /examples コンテキストに対するリクエスト worker1 (ajp13) へ送信


JkMount  /examples/* worker1

Minimum Domino WebServer configuration

最小限の Domino Web サーバの設定

A complete documentation is available in Domino HowTo .

完全な文書は、 Domino の手引き にあります。

This paragraph has not been written yet, but you can contribute to it.

このパラグラフはまだありません。ですから、あなたが貢献できるところです。

Minimum IIS WebServer configuration

最小限の IIS Web サーバの設定

A complete documentation is available in IIS HowTo .

完全な文書は、 IIS の手引き にあります。

This paragraph has not been written yet, but you can contribute to it.

このパラグラフはまだありません。ですから、あなたが貢献できるところです。

Minimum NES/iPlanet WebServer configuration

最小限の NES/iPlanet Web サーバの設定

A complete documentation is available in Netscape/iPlanet HowTo .

完全な文書は、 Netscape/iPlanet の手引き にあります。

This paragraph has not been written yet, but you can contribute to it.

このパラグラフはまだありません。ですから、あなたが貢献できるところです。

Test your configuration

行った設定のテスト

(Re)start the Web server and browse to the http://localhost/examples/

Web サーバを(再)起動して、ブラウザで http://localhost/examples/ をアクセスしましょう。

[訳注: これは鰈崎義之が翻訳しました。日本語訳に対するコメントがあれば、こちらに送って下さい。]