はじめに

この文書では、JK2 が使用する Tomcat と Web サーバの設定ファイルについて説明します。

• jk2.properties は、Tomcat 側で使われるファイルです。インストールパスは、 $TOMCAT_HOME/conf ディレクトリです。
• workers2.properties は、Web サーバ側で使われるファイルです。Apache サーバのデフォルトのパスは、 ServerRoot/conf ディレクトリです。

最小限の設定

ここで紹介する最小限の設定は、JK2 が動作するための一番単純な設定です。 チャンネルとしてはソケットを使い、多くのオプションはデフォルトのまま使います。 Tomcat と Web サーバはどちらも同じコンピュータ上にあるとします。

jk2.properties:

# デフォルトのポート番号は 8009 ですが、違うポート番号を使うなら指定
# channelSocket.port=8019

workers2.properties:

# 通信チャンネルの定義
[channel.socket:localhost:8009]
info=Ajp13 forwarding over socket
tomcatId=localhost:8009

# Tomcat の examples Web アプリケーションを Web サーバ URI 空間にマップ(関連付け)
[uri:/examples/*]
info=Map the whole webapp

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

最小限の JNI の設定

ここで紹介する最小限の JNI の設定は、Web サーバのプロセス内で Tomcat を動作させる一番単純な設定です。 通信チャンネルは JNI だけを使います。JK2 はすべてのネイティブ呼出を自分自身で登録するので、 Java 側でネイティブライブラリを指定する必要はありません。

jk2.properties:

# ハンドラのリストに apr と channelJni を追加
handler.list=apr,request,container,channelJni
# ネイティブライブラリは JK2 によって登録される
apr.jniModeSo=inprocess

workers2.properties:

# 通信チャンネルの定義
[channel.jni:jni]
info=The jni channel, used if tomcat is started inprocess

# Java バーチャルマシンのパラメータの定義
[vm:]
info=Parameters used to load a JVM in the server process
OPT=-Djava.class.path=${TOMCAT_HOME}/lib/tomcat-jni.jar;${TOMCAT_HOME}/lib/tomcat.jar
OPT=-Dtomcat.home=${TOMCAT_HOME}
OPT=-Dcatalina.home=${TOMCAT_HOME}
OPT=-Xmx128M

# JNI ワーカの起動時ハンドラ
[worker.jni:onStartup]
info=Command to be executed by the VM on startup. This one will start tomcat.
class=org/apache/jk/apr/TomcatStarter
ARG=start
stdout=${serverRoot}/logs/stdout.log
stderr=${serverRoot}/logs/stderr.log

# JNI ワーカの終了時ハンドラ
[worker.jni:onShutdown]
info=Command to be executed by the VM on shutdown. This one will stop tomcat.
class=org/apache/jk/apr/TomcatStarter
ARG=stop

# Tomcat の examples Web アプリケーションを Web サーバ URI 空間にマップ(関連付け)
[uri:/examples/*]
info=Map the whole webapp

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