Mod jkのインストール

提供: Astarisk Works Wiki

はじめに

　Tomcat ConnectorsはTomcatを有名なWebサーバに接続するプラグインであり、JK(mod_jk)とJK2(mod_jk2)がある。JK2はJKをリファクタリングしたもので強力であったが、JK2が非推奨(deprecated)扱いになったため、JKを利用していく方がよい。ここではJKによるApache2への接続方法を説明する。

入手

　Apache TomcatのサイトのDownloadよりWebサーバのプラットフォームに対応するJK(Win32版Apache2ではmod_jk-1.2.xx-apache-2.0.xx.so)を入手する。

インストール

mod_jkの配備

　入手したJK(mod_jk)の名前をmod_jk.soに変更してApacheのmodulesディレクトリにコピーする

workers.propertiesの編集

このファイルは自動的には作られないので、作成して以下の内容を設定する。

worker.listにはカンマ区切りでJKが使用するworkerの名前を指定する。

但し、ロードバランサのbalance_workersに指定したworkerを指定しないこと。

一般的なworkerはworker.<workerの名前>.<directive>=<値>という形式で定義する。

Tomcatへの接続に必要な最小設定：

# jkが生成して連携するworker
worker.list=wlb,jkstatus

# ajp13wという名前でタイプajp13のworkerの定義
worker.ajp13w.type=ajp13
worker.ajp13w.host=localhost
worker.ajp13w.port=8009

# ロードバランサーの定義
worker.wlb.type=lb
worker.wlb.balance_workers=ajp13w

# ロードバランサーを管理するstatus workerの定義
worker.jkstatus.type=status

directiveの詳細はWorkers HowToを参照のこと。

httpd.confの編集

簡便な設定：

# mod_jkモジュールのロード
LoadModule jk_module modules/mod_jk.so

<IfModule mod_jk.c>
# workers.propertiesの位置
JkWorkersFile "C:/Program Files/Apache Group/Apache2/conf/workers.properties"

# コンテキスト/jsp-examplesからwlbという名前のworkerにマウント
JkMount /jsp-examples/* wlb
</IfModule>

任意のコンテキストをつなぐ場合は、上の例のjsp-examplesの部分を書き換えた設定を追加していく。不要なコンテキストをマウントをするとセキュリティ問題やパフォーマンスの低下につながる可能性があるので注意する。 directiveの詳細はConfiguring Apacheを参照のこと。

Linuxでのビルド

Linux版はソースから自分でビルドする必要がある。

tar zxvf tomcat-connectors-1.2.XX-src.tar.gz
cd tomcat-connectors-1.2.XX-src/native
./configure --with-apxs=/usr/local/apache2/bin/apxs --with-java-home=/usr/java/jdk1.5.0_XX
make
make install

インストールが無事終了すると、すでにapache2/moduleにはコピーされているのでhttpd.confの設定から行う