Tomcat 5.5.25 Tomcat Connectors による Apache との連携

２－１．Tomcat Connectors のダウンロード

Tomcat Connectors のダウンロードは  Apache Software Foundation の Tomcat プロジェクト ( http://tomcat.apache.org/ )  から 「Download」 メニューにある 「Tomcat Connectors」 のリンクをクリックし、その先の「Download the JK 1.2.25 release sources」 をクリックします。

Windows 環境でダウンロードして Linux へ FTP 転送してもいいですし、 Linux 上の XWindow 上のウェブブラウザでダウンロードしてもいいですが、wget などのコマンドが使用できるならコマンドラインでダウンロードすることもできます。以下に /home/profaim/src ディレクトリに Tomcat Connectors のソースをダウンロードする例を紹介しておきます。

２－１．Tomcat Connectors ビルド・インストール

ダウンロードしておいた Tomcat Connectors（tomcat-connectors-1.2.25-src.tar.gz） が /home/profaim/src にあるとして、以下のコマンドでビルドとインストールを行います。

エラーが発生しなければ Tomcat Connectors のビルドは完了です。

３－１．Apache への組み込み前の確認

Apache に mod_jserv という古い Tomcat連携モジュールが組み込まれている場合は、事前にアンインストールが必要ということです。 Tomcat Connectors の mod_jk は mod_jserv の後継といことになります。今回は Apache から新規にインストールしたこともあり組み込まれていなかったので、詳しいアンインストール方法は調べていませんが、 tomcat-apache.conf や tomcat.conf で設定している人が該当するらしいので、これらのファイルが存在する人は調べてみましょう。

３－２．mod_jk モジュールを Apache へ配置

Tomcat Connectors のモジュールである mod_jk.so を Apache の module ディレクトリにコピーします。 Tomcat Connectors をビルドしインストールしたタイミングで配置されている場合もあるので、以下のコマンドで mod_jk.so が存在することを確認しましょう。 実行して mod_jk.so がリスト表示されたらインストール済みなので、改めて配置する必要はありません。 Apache は /usr/local/apache2 にインストールされているとします。モジュールはそこから ./modules の位置に配置されています。

存在していない場合は、以下のコマンドで配置します。  Tomcat Connectors は /home/profaim/src/tomcat-connectors-1.2.25-src 上でビルドしたとし、 Apache は上と同様に /usr/local/apache2 にインストールされているとしています。 また、併せて workers.properties もインストールします。

３－３．Apache の設定ファイル編集

mod_jk.so モジュールを ./modules へ配置したら、./conf にある設定ファイル（httpd.conf ）を編集します。 まず、以下のコマンドで設定ファイルをエディタで開きます。 もちろんエディタは何を使っても問題ありません。

エディタで設定ファイル（httpd.conf）を開いたら、LoadModule の設定が並んでいる場所を探して以下の１行を追加します。

あとは、設定ファイルの末尾にでも、以下の設定を追加します。JkWorkersFile には、先ほど配置した workers.properties へのパスを、 JkLogFile には mod_jk が出力するログファイルのパス、 JkLogLevel にはログの詳細度、 JkLogStampFormat には出力するログのフォーマットを指定します。 ログ関連の設定についてはこだわらないならそのまま設定しておけばいいと思います。

JkMount の設定は重要で、 Apache のどのパスへのリクエストを Tomcat へ委譲するかを設定します。以下では /servlets-examples/servlet/ のパスと /servlets-examples/ に配置された JSP ファイルを Tomcat へ委譲する設定になります。 ajp13 は workers.properties に設定されており、 Tomcat へ委譲する設定がされています。 JkMount は必要に応じて複数設定します。

４－１．確認準備

Tomcat  Connectors が正しく動作していることを確認するには、まず Tomcat と Apache を起動します。 以下の手順でなくとも普段の手順で起動させれば問題ありません。 Tomcat のインストール先は /usr/local/apache-tomcat-5.5.25 、Apache のインストール先は /usr/local/apache2/ とします。

４－２．動作確認

Tomcat のインストール時にインストールしたサンプルであり、設定にも記述した servlets-example の Servlet を使用して動作確認を行いました。Tomcat 経由でアクセスする場合（http://192.168.188.1:8080/）と同様に Apache 経由（http://192.168.188.1）でも Servlet にアクセスできることを確認します。

まず、Tomcat へアクセスして表示されるべきページを確認します。 http://192.168.188.1:8080/servlets-examples/servlet/RequestHeaderExample へアクセスして表示される内容を確認しておきます。次に、Apache へアクセスしてページを確認します。 http://192.168.188.1/servlets-examples/servlet/RequestHeaderExample へアクセスし、先ほどの表示内容と同じことを確認します。

これで確認は完了なのですが、本当に Apache へリクエストが送信され mod_jk が稼働していることを確認したい場合は、以下のコマンドで  Apache  のアクセスログ（access_log）と、 Tomcat Connectors のログ（mod_jk.log）の内容を確認すればアクセスが確認できます。 （インストール時に紹介した内容からログ出力先を変更した場合は、それに併せて参照します。）

４－３．確認完了

確認が完了したので、確認準備と逆の手順で Apache と Tomcat を停止します。 

以上で Tomcat Connector のインストールと設定は完了です。