如何让IIS5.0 与Tomcat 5.0协同工作(转贴:http://www.bbbear.org/admin/mt-tb.cgi/2)

作者环境:
Windows 2000 SP4 + IIS 5.0 + JDK 1.4.2
Tomcat安装路径:C:\Tomcat 5.0
Jdk1.4 安装路径:C: \j2sdk1.4.1_02
JAVA_HOME :C: \j2sdk1.4.1_02
CLASSPATH :.;%JAVA_HOME%\lib\tools.jar;%JAVA_HOME%\LIB\DT.JAR;

前期准备:
 在整合之前作者假定您已经成功的安装好了JDK1.4.2(现在SUN已经发行了JDK5.0,这里我只以JDK1.4.2为例,因为具体使用什么JDK并不影响服务器的配置,JDK的作用是在IIS已经将HTTP请求转发给Tomcat以后才起作用,所以等你完全配置好了您的服务器之后再重新安装更高的JDK也不会有什么大的问题。:),并配置好了JAVA_HOME和CLASSPATH环境变量。

开始安装:
1.安装Tomcat5.0
安装模式不用normal,而是选择full(这样会把Tomcat安装成服务模式启动,而且还有tomcat的源代码),然后按照提示进行。我的Tomcat装在C:\Tomcat 5.0下,安装路径您可以自行设置,但如果你修改了安装目录,那我后面介绍到的配置文件的相应目录您也必须一并修改。

2.设置环境变量TOMCAT_HOME
在桌面上“我的电脑”图标上点右键选“属性”->“高级” -> “环境变量” -> “系统变量”-> 新建变量名:TOMCAT_HOME,变量值:C:\Tomcat 5.0,点“确定”保存。

3.拷贝isapi_redirector2.dll
在C:\Tomcat 5.0\conf下新建“jk2”文件夹(这个目录您可以自行设置,但这将影响到后面相关配置文件的参数),然后复制isapi_redirector2.dll到C:\Tomcat 5.0\conf\jk2下面。

4.创建workers2.properties
创建workers2.properties到C:\Tomcat 5.0\conf下,文件内容如下:
[shm]
file= C:/Tomcat 5.0/logs/jk2.log
size=1048576

# Example socket channel, override port and host.
[channel.socket:localhost:8009]
port=8009
host=127.0.0.1

# define the worker
[ajp13: localhost:8009]
channel=channel.socket:localhost:8009

# Uri mapping
[uri:/*.jsp]
[uri:/servlets-examples/*]
worker=ajp13:localhost:8009

# define the worker
[status:status]

# Uri mapping
[uri:/jkstatus/*]
worker=status:status

使用前请将文件的第二行:file= C:/Tomcat 5.0/logs/jk2.log 中的C:/Tomcat 5.0改成您的Tomcat安装路径。

5.创建jk2.properties
创建jk2.properties到C:\Tomcat 5.0\conf下。其内容如下:
## THIS FILE MAY BE OVERRIDEN AT RUNTIME. MAKE SURE TOMCAT IS STOPED
## WHEN YOU EDIT THE FILE.
## COMMENTS WILL BE _LOST_
## DOCUMENTATION OF THE FORMAT IN JkMain javadoc.
# Set the desired handler list
# handler.list=apr,request,channelJni
#
# Override the default port for the socketChannel
# channelSocket.port=8019
# Default:
# channelUnix.file=${jkHome}/work/jk2.socket
# Just to check if the the config  is working
# shm.file=${jkHome}/work/jk2.shm
# In order to enable jni use any channelJni directive
# channelJni.disabled = 0
# And one of the following directives:
# apr.jniModeSo=/opt/apache2/modules/mod_jk2.so
# If set to inprocess the mod_jk2 will Register natives itself
# This will enable the starting of the Tomcat from mod_jk2
# apr.jniModeSo=inprocess
#request.tomcatAuthentication=true

request.tomcatAuthentication=false

6.创建并导入注册表文件isapi_redirect.2.0.reg
 创建并导入注册表文件isapi_redirect.2.0.reg,其内容如下:
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi  Redirector]

[HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\2.0]
"serverRoot"="C:\\Tomcat 5.0"
"extensionUri"="/jakarta/isapi_redirector2.dll"
"workersFile"="C:\\Tomcat 5.0\\conf\\workers2.properties"
"logLevel"="DEBUG"
导入之前请先修改注册表文件,把serverRoot 和workersFile的“C:\\Tomcat 5.0”替换成您的Tomcat安装路径。

7.设置IIS的ISAPI筛选器
点击“开始菜单” -> “设置” -> “控制面板” ->“ 管理工具” -> “Internet 服务管理器”,然后找到 你的站点(我的计算机名是BBBear,“默认 Web 站点”)。点右键 -> “属性”->“ISAPI筛选器”->“添加”->筛选器名称:jakarta,可执行文件:C:\Tomcat 5.0\conf\jk2\isapi_redirector2.dll。点“确定”保存。(这里的jk2是第3步使用的文件夹。)

8.配置用于重定向的虚拟目录(非常关键的一步
在“默认 Web 站点”点右键 -> “新建” ->“ 虚拟目录” -> “下一步” -> 别名填:jakarta ->下一步->目录选择为:C:\Tomcat 5.0\conf\jk2 -> 下一步 -> “执行(例如ISAPI应用程序或CGI)”一项一定要打上勾 -> 下一步 -> 完成。(一定要注意jakarta的名字不能改变,因为这个名字对应这注册表里jakarta对应,如果名字拼写错误将导致失败。)

9.检查筛选器配置
重新启动“默认 Web 站点”。然后在“默认 Web 站点”点右键 ->“属性”->“ISAPI筛选器”,如果“jakarta”前面的箭头是绿色的而且优先级为“高”,那么表明配置已经成功了。如果箭头是红色,那么请您重新检查整个配置过程,看看有没有弄错的地方。如果确认一切正确无误,那就请您重新启动机器,注意一定是重新启动机器而不是重新启动IIS,再重新查看其状态,这样一般可以解决这个问题。

10.设置环境变量TOMCAT_HOME
桌面上,“我的电脑”点右键 ->“属性”-> “高级”->“环境变量”->“系统变量”->新建变量名:TOMCAT_HOME, 变量值:C:\Tomcat 5.0 -> 点“确定”保存。

11.拷贝JAVA编译工具包Tools.jar
把C: \j2sdk1.4.1_02\lib目录下的tools.jar复制到Tomcat安装目录下的common\lib的目录下(C:\Tomcat 5.0\common\lib\下)。

12.添加默认文档
“开始菜单” -> “设置” -> “控制面板” -> “管理工具” -> “Internet 服务管理器” -> 找到你的站点(我的计算机名是BBBear ,“默认 Web 站点”)-> 点右键 -> “属性” -> “文档”->添加->输入“index.jsp”-> 确定 -> 再添加“index.html”-> 确定(因为着这是Tomcat的默认起始页面)-> 。

13.设置网站根路径
“主目录”-> “本地路径”一栏,选择“C:\Tomcat 5.0\webapps\ROOT”。

14.重新启动Tomcat和IIS
重新启动Tomcat 然后再重新启动IIS,

15.检验我们的成果
  首先,打开http://localhost/。您看到了什么,对,Tomcat的默认页面。熟悉的“猫”的形象是不是让您感觉到激动呢。嗯,不慌,好戏还在后面呢。其实到看到了Tomcat起始页面您不应该感到惊奇,因为您仔细看看这个页面的后缀您就明白了,“HTML”对,它只是一个静态页面,而且是由IIS解析的。
  然后,您现在试着打开http://localhost/jsp-examples看看,返回“该页无法显示”的错误页面,为什么?嗯,其实原因很简单,因为我们的IIS的默认目录在/webapps/root下,而jsp-examples目录是与root属于同一级别的子目录。所以当您使用上述路径访问的时候IIS无法在root目录下找到jsp-examples。怎么办?嗯,如果您对IIS很熟悉的话,您一定能想到,对,在IIS中的当前站点建立虚拟目录就好了。
  接着,我们现在在IIS中建立名为jsp-examples,路径为C:\Tomcat 5.0\webapps\jsp-examples的虚拟目录(这个目录是Tomcat自带的Jsp例子程序),同时建立一个名为servlets-examples,路径为C:\Tomcat 5.0\webapps\servlets-examples的虚拟目录(这个目录对应的为Tomcat自带的Servlet的例子程序)。为什么要这么做?待会您就知道了。
  现在您再使用http://localhost/ 这个路径来访问,然后在出现的Tomcat起始页面的左下方找到JSP Examples 和 Servlet Examples 的链接,您点击其中的 JSP Examples 后您就可以看到一个 JSP Samples 的页面,在这里有许多的JSP例程,您随便找一个,然后单击“Execute”,看看结果是什么?如果是正常的返回结果页面,嗯,恭喜您,这代表我们可以开始惊呼了,因为这代表我们前面的努力都得到了回报,IIS已经成功的将JSP页面交给Tomcat来解析。
  最后,现在让我们来看看让IIS转发Servlet请求,我们先回到Tomcat起始页面,然后试着点击Servlet Examples 链接,嗯,同样您将看到一个Servlet Samples页面,现在您也随便找一个Servlet程序然后点击“Execute”看看,如果不出意外,您应该看到正确的返回结果。嗯,我现在郑重的宣布,您已经成功完成了Tomcat与IIS的完美结合。恭喜!!

16.还需要罗嗦几句
当您在调试的时候配置都没有问题,但是就是出现“该页无法显示”的页面?为什么?在这里您需要注意以下几点:
  第一,Tomcat的启动是需要一些时间的,尤其是您在Tomcat上使用Struts构建的站点,这个问题尤其突出。要看Tomcat是否成功启动,您可以查看Tomcat的日志文件:c:\tomcat\logs\stdout.log,如果已经包含“Server startup in 1125 ms”,则证明Tomcat服务已经启动成功。
  第二,在调试中容易出现一些很奇怪的现象,例如:改变了配置,但是执行的结果页面却没有任何变化。嗯,这个问题在开发Web程序最容易出现的问题,在这里我也根据自己开发Web程序的经验告诉你一些避免的方法,当你在改变配置后,您最好不要在以前的打开页面上继续尝试,应该重新打开一个窗口,因为IE在访问有页面缓存,他会保存一些已经被打开的页面来提高性能,但这个性能对于开发者来说可能就是恶梦了。
  第三,您在更改workers2.properties这个文件后,如果想让其生效您必须重新启动IIS,注意是完全启动,而不是在IIS管理器中停止,而是要让IIS进程重新启动,当然如果您也可以启动您的计算机。
  第四,workers2.properties中的[URI]部分很值得注意,这部分的功能是告诉IIS,什么后缀的文件请求将转发给Tomcat来解释,在本文中您可以看到这部分的内容如下:
  [uri:/*.jsp]
  [uri:/servlets-examples/*]
  
  [uri:/*.jsp],这句话的意思是所有的JSP文件将 由Tomcat来解释。
  [uri:/servlets-examples/*] ,而这句话的意思是专门针对servlet的,因为在执行servlet的时候没有扩展名,所以如果没有此条语句,那么当您在执行servlet的时候就会出现找不到页面的错误。而此处使用的/servlets-examples正好为Tomcat自带的Servlet例子程序的目录。同时它也对应着IIS的虚拟目录servlets-examples。如果您在[URI]字段中使用如下的语法,[uri:/*],那就意味着IIS会将当前虚拟站点中的所有文件都交给Tomcat来解释。
  第五,IIS中的虚拟目录并不等于Tomcat的Server.xml中配置的上下文(Context)。而且您必须注意的是,如果您的IIS中为包含JSP或者Servlet的目录配置了虚拟目录,您不要忘记要在Tomcat中配置与目录名相同的上下文,当然,Tomcat 会自动的将主机根目录下的目录配置成为上下文,这当然也是可以实现的,但是毕竟这并不可控,所以建议大家都为专门的目录建立对应的上下文。