Apache と Tomcat の連携

今回の目的

Java で開発した Servlet を動作させるための環境を構築する。
Tomcat 単体でも Webサービスを提供することは可能だが、一般的な Webサーバと比べて次のような問題がある。

静的なページは Apache ほど速くない
Apache ほど細かな設定ができない
Apache ほど頑強ではない
Apache のモジュールでしか提供していない機能に対してサポートできない(例えば PHP とか)

これらの理由から、静的なコンテンツには Apache のよな Webサーバ使用し、Tomcat を Servlet/JSP のアドオンとして使うことが一般的である。

Apache のインストールと設定は割愛します(証明書関連のトコロでちょっと書きましたのでソレを参照)。

Java のインストールと環境設定

Tomcat を利用するには、事前に Java をインストールしておく必要がある。
http://java.sun.com/javase/downloads/index.jsp から Linux self-extracting file(ファイル名は jdk-6u10-linux-i586.bin)をダウンロードする。

ダウンロードしたファイルを展開先に移動して実行する(/usr/local/javaディレクトリが無い場合は予め作成しておくこと)。

Fig.1-1: Javaインストール
# mkdir -p /usr/local/java/.
# mv jdk-6u10-linux-i586.bin /usr/local/java/.
# chmod a+x /usr/local/java/jdk-6u10-linux-i586.bin
# /usr/local/java/jdk-6u10-linux-i586.bin

Java を利用するユーザは次の環境変数を設定すること。

Fig.1-2: Javaを利用するための設定
export JAVA_HOME=/usr/local/java/jdk1.6.0_10
export PATH=$PATH:$JAVA_HOME/bin

ユーザ毎に記述するのが面倒な場合は /etc/profile や /etc/bash.bashrc に上記設定を追加すれば、全てのユーザで Java を利用できるようになる。

Tomcat のインストールと環境設定

http://tomcat.apache.org/ から apache-tomcat-5.5.27.zip をダウンロードする。

ダウンロードしたファイルを展開しインストールする。
unzipコマンドが無い場合には(apt-get install unzip)でインストールすればよい。

Fig.2-1: Tomcatインストール
# unzip apache-tomcat-5.5.27.zip
# mv apache-tomcat-5.5.27.zip /usr/local/tomcat

スーパーユーザに次の環境変数を設定する。

Fig.2-2: Tomcatを利用するための設定
export CATALINE_HOME=/usr/local/tomcat
export CLASSPATH=.:$CATALINE_HOME/common/lib/servlet-api.jar
export CLASSPATH=.:$CATALINE_HOME/common/lib/jsp-api.jar
export CLASSPATH=.:$CATALINE_HOME/webapps/sample/WEB-INF/classes

/usr/local/tomcat/bin に展開したスクリプト群は実行権限が与えられていないので *.sh に対して権限を付与する。

Fig.2-3: スクリプト群に実行権限付与
# chmod a+x /usr/local/tomcat/bin/*.sh

tomcat を起動するには起動スクリプトを実行すればよい。
Opera 等のウェブブラウザを起動しアクセス出来ればインストールは成功である(例えば http://localhost:8080/)。
尚、tomcat の起動には環境変数 JAVA_HOME が設定してある必要がある。

Fig.2-4: Tomcatの起動スクリプト実行
# ./startup.sh

停止するには終了スクリプトを実行すればよい。

Fig.2-5: Tomcatの終了スクリプト実行
# ./shutdown.sh

Tomcat Manager にログインするために /usr/local/tomcat/conf/tomcat-users.xml を編集すれば、ユーザ名「 admin 」、パスワード「 admin 」でログインできる。

Fig.2-6: tomcat-users.xmlの編集内容
<role rolename="manager" />
<role rolename="admin" />
<user username="admin" password="admin" roles="admin,manager" />

Webサーバアダプタのインストール

これは Tomcat と Apache の間の情報を受け渡しするプログラムです。
http://tomcat.apache.org/download-connectors.cgi から mod_jk をダウンロードしてインストールする。
インストールの手順については付属のマニュアルを参照すること。

Webサーバの設定

インストールが完了したら Apache、Tomcat、Webサーバアダプタの設定を行う。

最初に Apache の設定を変更するが、ここでは Apache 2.x での設定例を記す。
まず、httpd.conf の末尾に次の内容を追加する。

Fig.4-1: httpd.conf の編集内容
vi /usr/local/apache2/conf/httpd.conf
LoadModule jk_module modules/mod_jk.so

続いて、httpd-ssl.conf の VirtualHostタグの末尾に次の内容を追加する。

Fig.4-2: httpd-ssl.conf の編集内容(VirtualHostタグ内)
vi /usr/local/apache2/conf/extra/httpd-ssl.conf
JkMount /*.jsp worker1
JkMount /balancer/* worker1
#JkMount /jsp-examples/* worker1
#JkMount /servlets-examples/* worker1
JkMount /tomcat-docs/* worker1
JkMount /webdav/* worker1
JkMount /dnc/*.do worker1
JkMount /dnc/pages/* worker1
JkMount /shiken_web/* worker1

そして、VirtualHostタグの外(つまりファイルの末尾)に次の内容を追加する。

Fig.4-3: httpd-ssl.conf の編集内容
JkWorkersFile /usr/local/apache2/conf/workers.properties
JkLogFile /usr/local/apache2/logs/mod_jk.log
JkLogLevel warn

最後に workers.properties を作成する。

Fig.4-4: workers.properties の編集内容
vi /usr/local/apache2/conf/workers.properties
worker.list=worker1
worker.worker1.port=8009
worker.worker1.host=localhost
worker.worker1.type=ajp13
worker.worker1.lbfactor=1

ここまでで Apache の設定は終了し、次に Tomcat の設定を行う。
通常 Tomcat は 8080ポートで Webサービスを行っています。つまり、外部(インターネットやイントラネット)から 8080ポートで Tomcat にアクセスすることができますが、Apache との連携を行うので外部からのアクセスは全て Apache を経由します。
そこで 8080ポートで要求を受けるための設定を以下の様に解除します(既存の定義をコメントアウトするだけ。

Fig.4-5: server.xml の編集内容
vi /usr/local/tomcat/conf/server.xml
<!--
<Connector port="8080" maxHttpHeaderSize="8192"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true" />
-->

設定ファイルの編集が完了したら、Tomcat → Apache の順番で再起動して内容を反映させます。
尚、この順番で再起動しなかった場合、変更内容が正しく認識されないことがありますので注意してください。

鍵ペアの生成

Sooooooooooooooooooooooooooooorrrrrrrrrrry!!