虚拟主机用户独享tomcat的配置详解

本文总结一下tomcat (v5.x)的虚拟主机配置方法，包括对CATALINA_BASE的具体解释，以及如何和apache连接。这个配置的主要目的是，在一台主机上，为每个虚拟主机建立一个独立的tomcat jvm，让用户自己管理；


环境：
apache 2.x + jk 1.2.x + tomcat   采用jk1.2.x而非jk2的原因是，jk2已经放弃维护，并且其中的一些重要功能已经逐步移植到了jk1。参见http://jakarta.apache.org/tomcat/connectors-doc/

1,apache中的虚拟主机配置。
假设，我们有这样两个虚拟主机：

host1.com   根目录 d:/www/host1/   htdoc文档根目录d:/www/host1/www
host2.com   根目录 d:/www/host2/   htdoc文档根目录d:/www/host2/www

以上的根目录,指的是我们为每个虚拟主机准备的根目录,其中www目录下面放webapp,另有一个tomcat-run目录作为CATALINA_BASE(后面详述).

在httpd.conf里面有这样的配置(我们测试apache跑在8082端口）
<VirtualHost *:8082>
     DocumentRoot d:/www/host1/www
     ServerName host1.com
</VirtualHost>

<VirtualHost *:8082>
     DocumentRoot d:/www/host2/www
     ServerName host2.com
</VirtualHost>

此时,在www目录下,假若有html文件,应该就已经可以根据不同的虚拟主机访问不同的html文件了.

2, tomcat的multi instance
我们都知道，默认安装的tomcat，CATALINA_HOME就是tomcat的安装目录,CATALINA_BASE也指向同一个目录。其实，一份tomcat是支持多个不同的CATALINA_BASE目录的。
可以启动多份instance,每个instance有一个自己的CATALINA_BASE。
CATALINA_BASE目录的结构如下，
+ conf
+ logs
+ temp
+ work
+ shared
start.bat

为了避免冲突，不同的CATALINA_BASE中，在conf/server.xml中，需要修改<server>的port和<Connector protocol="AJP/1.3">的port,关闭http的connector。每个instance必须打开两个port，而且不能冲突。需要有个小文件来记录每个instance分配的port。

在系统中设定CATALINA_HOME，然后每个instance这样启动：
set CATALINA_BASE=.
call %CATALINA_HOME%\bin\startup.bat

也就是说，服务器上的每个人可以自己独立调度自己的webapp,在一个独立的jvm中运行，重起也不会影响别人.

3, jk connector 配置
jk是tomcat和apache之间的连接器,apache和tomcat通过jk来进行通讯，jk支持多个不同的instance转发。
jk的调度是根据workers.properties来的。在自己的engine 中配置jvmRoute值，和workers.properties对应；

在httpd.conf中load module:
LoadModule jk_module modules/mod_jk-1.2.10-apache-2.0.53.so   (这个module是自己用源代码make出来的)
JkWorkersFile conf/workers.properties
JkLogFile      logs/mod_jk.log
JkLogLevel     info
JkRequestLogFormat      "%w %V %T %U %q"

workers.properties的定义为:
worker.list=host2,host1

worker.host1.port=8009
worker.host1.host=host1.com
worker.host1.type=ajp13
worker.host1.lbfactor=1
worker.host1.recycle_timeout 120

worker.host2.port=8010
worker.host2.host=host2.com
worker.host2.type=ajp13
worker.host2.lbfactor=1
worker.host2.recycle_timeout 120


然后，在每个virtualhost里面：
<VirtualHost *:8082>
     ServerName host1.com
     ....
     JkMountFile d:/www/host1/tomcat-run/jk-map.properties
</VirtualHost>

这样每个tomcat instance需要拦截哪些文件也可以由自己来控制了。在jk-map.properties里面有如下内容
/*.jsp=host1
/*.action=host1
在行前面加'-'表示jkUnmount,这样,假若有
/*=host1
-/*.html=host1
就表示,除html外,apache接收到对所有其他的文件的访问都转发到tomcat的host1 instance去.

4,tomcat的virtual host,由<host>和<engine>提供

具体的配置,请参见可以下载的附件例子.
http://www.redsaga.com/articles/tomcat-apache-virtualhost-sample.zip