gmt-24.net

サイトのTopをTomcatで処理させたい場合、ROOTとしてウェブアプリケーションを配備すればよい、ということを書きました(サイトのTop自身もTomcatに処理させる)。

でも、アプリケーションをビルドする際にROOT.warとするのもちょっとイヤだったので、プロジェクト名.warで固めたアーカイブ(someproject.war)をROOTとして利用できる方法にチャレンジしてみました。

サイトURLはhttp://www.example.com/と仮定します。

server.xmlへの仮想ホスト設定

Hostコンテナでwww.example.comを定義します。

<Host name="www.example.com" deployXML="false"
         appBase="/var/tomcat5/sites/www.example.com"
         unpackWARs="true" autoDeploy="true" 
         xmlValidation="false"
         xmlNamespaceAware="false">
</Host>

ROOT.xmlを用意

docBaseにwarファイルへの絶対パスを指定したROOTコンテキストファイルを用意します。

<Context path="" docBase="/usr/local/webapps/someproject.war" debug="0" reloadable="true">
</Context>

warファイルの置き場所はHostコンテナのappBaseには含めないようにします。
ROOT.xmlの置き場所は$CATALINA_HOME/conf/Catalina/www.example.com/配下になります(厳密には$CATALINA_HOME/conf/[enginename]/[hostname]/以下です)。

これでTomcatを起動すると/usr/local/webapps/someproject.warが/var/tomcat5/sites/www.example.com/ROOTとして展開されて、www.example.comのサイトTopとして利用できるようになります。

ちなみにこの応用として、Context定義をROOT.xmlではなくsubdir.xmlで用意すれば、www.example.com/subdirとして配備することも可能になります。

タイトル変かもしれません。
http://www.example.com/のトップレベルからTomcatに処理させたい場合。Tomcatだけでウェブサーバ公開すれば、っていう突っ込みはなしでお願いします。

Apacheでは以下のように仮想ホストを設定。

<VirtualHost *:80>
  ServerName www.example.com
  JkMount /* ajp13
</VirtualHost>

Tomcat側ではappBaseである/var/tomcat5/webapps/直下にアプリを配備したとする。
サブディレクトリがあるわけではなく、/var/tomcat5/webapps/index.jspのようになっている状態。

はじめはこれでいいのだろうと思いましたが、うまくいきません。

/var/tomcat5/webapps/ROOT/index.jspのように、ROOTというディレクトリをはさむ必要があります。
Tomcatウェブサーバのトップページと同じ構造です。

ROOT.warとしてビルドしてwebappsにおいてしまうのが一番簡単です。ROOT.war以外のファイル名にしたい場合は、ROOT.xmlのContextでdocBaseに直接warファイル名を記述するようにすればよいです。

<Context docBase="/path/to/hogehoge.war">
</Context>

Eclipseのプロジェクト名のままwarにしてROOTアプリケーションとして配備したいような場合に有用でしょう。

参考：

• Apache Tomcat Configuration Reference – The Context Container
  The default web application may be defined by using a file called ROOT.xml.
  
• Top Ten Tomcat Configuration Tips
  3. Deploying a Web Application

Tomcat起動時のJVMオプションを$CATALINA_OPTSや$JAVA_OPTS環境変数に設定する情報をよく見かけます。

これらの変数は、起動前にコマンドラインで設定しようとか、~/.bashrcに書いておこうとか、catalina.shを書き換えようといったハナシで大抵終わっているのですが、setenv.shファイルを用意する、という方法もあります。

実は起動スクリプトのcatalina.shには「setenv.shがあれば読み込む」というコードが仕込まれています。

if [ -r "$CATALINA_HOME"/bin/setenv.sh ]; then
  . "$CATALINA_HOME"/bin/setenv.sh
fi

ですので、このファイルを用意して(デフォルトでは存在しません)、

CATALINA_OPTS="-server -Xmx512M"

とでもしておけば、簡単に設定することができるようになっているのです。

この方法のメリットは、ユーザが手動なりprofileなりでいかなる環境変数を設定していても影響をうけなくなることです。無理やりリセットすることになりますから。
suの方法によってはprofile読まれなかったりすることもありますからねー。

本番環境で使われる場合や、catalina.shを書き換えるぐらいなら、setenv.shの利用をおすすめしておきます。

余談ですがCLASSPATHはsetenv.shでは設定できません。
catalina.shを更に眺めていくとよくわかるのですが、setenv.shのあとにsetclasspath.shというファイルを読み込んで、その中で初期化しているためです。