原创：Tomcat和Apache的集成

[b:820f207fd7]Connector的选择[/b:820f207fd7]
   选择合适的Connector对于性能、配置的方便性有很重要的影响，目前大致上有JK1。x， JK2， mod_webapp三种connector可以使用。 JK使用比较广泛。JK2是JK1.x的改进，比较新。但是不太容易配置，相关的文档也比较少。此外，JK可以支持其他Web服务器和tomcat的集成。 但mod_webapp不支持。 因此，目前JK1.x是最好的选择。
获得JK
[b:820f207fd7]使用二进制版本[/b:820f207fd7]
如果你对手工编译源代码心有余悸，使用二进制版本也许是个明智的选择。你可以从http://apache。linuxforum。net/dist/jakarta/tomcat-connectors/jk/binaries/下载JK1.x的最新版本。
然而，不幸的是二进制版本的JK和Apache的版本是捆绑在一起的，如果你使用了比较新的Apache(比如httpd-2.0.29)的话，往往很难找到对应的二进制版本的JK。
[b:820f207fd7]手工编译源代码[/b:820f207fd7]
对于不同的操作系统和Apache的版本，如果没有预编译好的JK，则需要进行手工编译。除了Linux以外，其他操作系统一般不会安装编译环境。这时你还需要安装编译器。典型的例子是在Solaris上安装GCC，或是在Windows上安装Visual C++。另外，通常Open Source的软件一般都是用GNU的autoconf、automake生成自动配置脚本和Makefile的，JK也不例外。除了Linux以外的Unix系统中的make不一定能够兼容这些脚本。 所以如果你碰到这些问题就需要安装gmake。下面以Solaris8为例说明如何安装配置编译环境：
在Solaris8中系统自带的make不能兼容automake产生的某些Makefile。
需要的软件包：
gcc-3.3-sol9-sparc-local.gz
make-3.80-sol8-sparc-local.tar.gz
所有需要的软件包都可以在www.sunfreeware.com上下载到。
解压缩：
[code:1:820f207fd7]$gunzip gcc-3.3-sol9-sparc-local.gz
$gunzip make-3.80-sol8-sparc-local.gz[/code:1:820f207fd7]
用pkgadd安装，需要root权限:
[code:1:820f207fd7]#pkgadd -d gcc-3.3-sol9-sparc-local
#pkgadd -d make-3.80-sol8-sparc-local[/code:1:820f207fd7]用pkgadd安装后，通常gcc， make会被安装在/usr/local/bin目录下。这是需要让gmake
成为系统默认的make。检查PATH环境变量，确保/usr/local/bin目录的位置在Solaris8自带的make的bin之前:
[code:1:820f207fd7]$which make
/usr/ccs/bin/make
$echo $PATH
/usr/bin:/usr/ccs/bin:/usr/local/bin[/code:1:820f207fd7]
如果发现gmake还不是系统默认的make，可以修改/etc/profile调整PATH。但有一种更简单有效的方法，在/usr/bin目录下建一个到/usr/local/bin/make的符号连接make，这样就能使gmake成为系统默认的make了：
[code:1:820f207fd7]# cd /usr/bin
# ln -s /usr/local/bin/make make[/code:1:820f207fd7]同样的技巧可以解决一些Perl脚本对perl解释器可执行文件路径引用的不正确。如某个perl脚本的头信息有#!/usr/local/bin/perl -w但Perl在系统上被安装在/usr/bin/目录下。这时需要在
/usr/local/bin/下建立一个到/usr/bin/perl的符号连接perl。
编译完JK后，把它安装到apache中去，执行：
[code:1:820f207fd7]# make install[/code:1:820f207fd7]如果不成功，可以手工把mod_jk.so拷贝到apache的modules目录下。
[b:820f207fd7]配置[/b:820f207fd7]
在具体动手配置之前应该考虑一下你集成的目标：仅仅是简单的把某个subcontext由tomcat处理，还是更高层次的动态/静态内容整合？是否允许HTTPS的转发;是否要进行负载平衡？具体配置的复杂度会因你的集成目标不同而大相径庭。

假定我们的集成目标是:
1. 所有的静态资源由Apache处理
2. 所有的动态资源由Tomcat处理
[b:820f207fd7]配置Tomcat[/b:820f207fd7]
apache和tomcat整合大致上有三种方式：
1. 在apache进程中运行tomcat来处理动态内容
2. 通过ajp13协议，apache将动态内容的请求转发给tomcat
3. 使用本地高速Unix domain socket，apache将动态内容的请求转发给tomcat

方式2可以将apache和tomcat分布在不同的机器上，从而可以实现负载平衡。方式3速度比较快，当apache和tomcat分布在相同的机器上时可以考虑使用。
本文以方式2的为例说明tomcat和apache的集成。
为了能处理ajp13请求，tomcat需要起一个服务。 这是通过在tomcat的server.xml中定义一个Connector来实现的。 在最新的tomcat4.1.30版本中该Connector默认情况下是启用的。如果没有启用在server.xml加入
[code:1:820f207fd7]    <Connector className="org。apache。coyote。tomcat4。CoyoteConnector"
               port="8009" minProcessors="5" maxProcessors="75"
               enableLookups="true" redirectPort="8443"
               acceptCount="10" debug="0" connectionTimeout="20000"
               useURIValidationHack="false"
               protocolHandlerClassName="org.apache.jk.server.JkCoyoteHandler"/>[/code:1:820f207fd7]
启动tomcat， 检查ajp13服务是否运行
netstat -a | grep 8009
或则查看tomcat标准输出上是否有类似的输出：
[code:1:820f207fd7]info: JK2: ajp13 listening on /0.0.0.0:8009
2004-5-22 14:50:35 org.apache.jk.server.JkMain start
info: Jk running ID=0 time=20/200  config=D:\Tomcat4.1\conf\jk2.properties[/code:1:820f207fd7]
[b:820f207fd7]配置Apache[/b:820f207fd7]
配置完Tomcat后，进行Apache的配置。首先，我们需要确定整个web应用所在的context，确定了context也就能确定用户通过什么样的URL可以访问该web应用。比如，网站为www.example.com， 如果web应用的context为purchase，那么用户可以通过URL http://www.example.com/purchase访问该应用;如果web应用的context为/，那么用户可以通过URL http://www.example.com访问该应用。一般而言，将web应用的context设定为/可以方便用户。如果存在多个独立的应用，可以考虑把它们放到不同的子context中去。下面介绍把应用context设为/情况下如何配置，其他情况类似。将jk的配置放在一个独立的文件里，然后在httpd。conf中Include该文件即可。
第一步，让apache加载mod_jk:
[code:1:820f207fd7]#mod jk for tomcat-apache integration
LoadModule jk_module modules/mod_jk.so[/code:1:820f207fd7]
把应用context映射到存放该应用静态资源的目录:
[code:1:820f207fd7]# Static files in the examples webapp are served by apache
Alias / /www/tomcat4。1/webapps/ROOT/ [/code:1:820f207fd7]
同时，因为现在静态资源不是由tomcat处理了，所以出于安全考虑和遵守JSP/Servlet规范需要禁止对WEB-INF子目录的访问：
[code:1:820f207fd7]# The following line prohibits users from directly access WEB-INF
<Location "ROOT/WEB-INF/"> 
  AllowOverride None 
  deny from all 
</Location>[/code:1:820f207fd7]
在集成的调试阶段可以考虑允许目录列表功能：
[code:1:820f207fd7]<Directory "/www/tomcat4。1/webapps/ROOT">
    AllowOverride FileInfo AuthConfig Limit Indexes
    Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec
</Directory>[/code:1:820f207fd7]
接下来一步告诉apache哪些动态内容应该让tomcat处理，为了确定动态内容URL的特征，应该把web.xml中的所有servlet mapping中出现的URL模式在jk.conf中声明：
[code:1:820f207fd7]JkMount /BaseServlet worker1 
JkMount /Servlet/* worker1 
JkMount /ProductUploadServlet worker1 
JkMount /upload worker1 
JkMount /test worker1 
JkMount /*.jsp worker1 
JkMount /*.do worker1[/code:1:820f207fd7]
其它可能需要修改的配置
配置项 说明
JkWorkersFile 指定jk workers.properties的位置，如果是相对路径，则假定在apache的ServerRoot目录下
JkLogFile 指定jk log文件的位置，如果是相对路径，则假定在apache的ServerRoot目录下
JkLogLevel 指定jk log的级别有效的选项有：debug/error/info
JkLogStampFormat 指定log中的时间格式，使用c函数strftime()的格式字符串语法

[b:820f207fd7]总结[/b:820f207fd7]Tomcat和Apache集成时通常需要一下步骤：
1. 决定使用哪种connector
2. 获得connector，如果没有现成的二进制的connector，则需要手工编译，根据操作系统的不同可能还要设置编译环境。
3. 配置tomcat
4. 配置apache，确定context，将context对应到应用的顶层目录。根据web.xml中的servlet映射把所有的动态内容的url模式配置在apache中
5. 测试
[b:820f207fd7]附录[/b:820f207fd7]
一个完整的配置例子：
[code:1:820f207fd7]#mod jk for tomcat-apache integration
LoadModule jk_module modules/mod_jk.so

JkWorkersFile conf/workers.properties
# Where to put jk logs

JkLogFile logs/mod_jk。log
# Set the jk log level [debug/error/info]
JkLogLevel debug

# Select the log format
JkLogStampFormat "[%Y-%m-%d %H:%M:%S] "

# JkOptions indicate to send SSL KEY SIZE，
JkOptions +ForwardKeySize +ForwardURICompat +ForwardURICompatUnparsed -ForwardDirectories

# JkRequestLogFormat set the request format
JkRequestLogFormat "%w %V %T"

# Static files in the examples webapp are served by apache
Alias / /www/tomcat4。1/webapps/ROOT/ 
# The following line prohibits users from directly access WEB-INF
<Location "ROOT/WEB-INF/"> 
AllowOverride None 
deny from all 
</Location> 

<Directory "/www/tomcat4.1/webapps/ROOT">
    AllowOverride FileInfo AuthConfig Limit Indexes
    Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec
</Directory>

#JkAutoAlias /www/tomcat4.1/webapps/ROOT
JkMount /BaseServlet worker1 
JkMount /Servlet/* worker1 
JkMount /ProductUploadServlet worker1 
JkMount /upload worker1 
JkMount /test worker1 
JkMount /*.jsp worker1 
JkMount /*.do worker1[/code:1:820f207fd7]

此外，jk还需要一个workers.properties文件配置jk本身的参数．如过不需要培植负载平衡
可以使用以下配置
[code:1:820f207fd7]# Define 1 real worker using ajp13
worker.list=worker1
# Set properties for worker1 (ajp13)
worker.worker1.type=ajp13
worker.worker1.host=127.0.0.1
worker.worker1.port=8009
worker.worker1.lbfactor=50
worker.worker1.cachesize=10
worker.worker1.cache_timeout=600
worker.worker1.socket_keepalive=1
worker.worker1.socket_timeout=300[/code:1:820f207fd7]要注意的是JkMount所引用的worker的名称必须是在work.list定义过的。

HonestQiao 回复于：2004-05-31 13:02:07

如果是原创，请在标题说明一下子

schnell18 回复于：2004-05-31 15:33:58

是原创了，马上改

wxijin 回复于：2004-05-31 18:26:39

JK已经逐步要被JK2给代替，而且APACHE不再对JK提供更新及相应的技术支持。

schnell18 回复于：2004-05-31 20:35:24

说是这么说。但如果你动手编译过jk2(特别是处了Linux以外的操作系统)的话，你就会知道jk2并没有传说的中的好。所谓“停止support”太无聊了，OSS的东西本来就没有什么支持。全靠大家用得多了，才是有所谓的支持啊。

jhsea3do 回复于：2004-05-31 20:49:50

如果单用tc+apache的话, 我自己感觉 jk 要比 jk2好 但是商业运用的话,还是很在乎support的,比如漏洞之类的东西. 而且jk2的好处在于他可以用在iis等非apache的web服务器上 甚至我的blog是跑在jetty上的,而不是tomcat,他也可以通过jk2和apache联立,jk2这方面要比jk好.

schnell18 回复于：2004-06-01 15:54:01

TO:jhsea3do 你没有没用jk2在除了linux和windows以外的操作系统和最新版本的apache集成的经验？ 我试过不太成功，配置的语法不太直观，所以觉得用jk比较方便。

peng 回复于：2004-06-01 16:22:36

我用的多是solaris，最近常做jdk2+apche+resin。 感觉jdk2还可以，尤其是一些新的功能，jk还是不能满足的。 至于麻烦，solaris下编译free的东西，就没有方便的。。

luvlm 回复于：2004-06-01 19:48:50

为何要集成呢？  两个都可单独运行。

原文转自：http://www.ltesting.net