打通版微社区(4):微信第三方服务部署——JSP的IIS部署
写在前面:
本机环境2008R2、tomcat8
网上搜了很多JSP的IIS部署,内容大部分是相近的,这些文章最早出现在2012的样子。大概的原理就是通过ISAPI方式对IIS进行扩展(这个扩展是tomcat官方的,是官方comcat-connectors项目的IIS子集),让IIS将JSP提交给tomcat进行处理。官网有英文版本的详细介绍http://tomcat.apache.org/connectors-doc/webserver_howto/iis.html 另外csdn上down了一个文档,指出了官网原文有不正确的地方。两者是我参考的主要文献。
PS:所谓指出官方文档有不正确的地方就是64位的2008R2在使用ISAPI这个扩展文件时是否使用64位,如果是64位则参考官方文档,如果不是则参考网上的文档。在具体部署这一步骤的时候我详细记录了。
其他参考文档
http://blog.sina.com.cn/s/blog_68b0cad1010168hf.html
http://www.it165.net/os/html/201402/7156.html
一、部署jre
我下载的是1.8.0.45 x64,放到D盘Server目录下
配置环境变量
Path: %JAVA_HOME%\bin; JAVA_HOME: D:\Server\Java\jre1.8.0_84 CLASSPATH: .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;
二、部署tomcat
我下载的是apache-tomcat-8.0.23 8.0.23 用的是安装版,安装版本自动匹配64
安装到D:\Server目录下。好了直接访问8080端口可以发现tomcat已经OK了
三、配置Tomcat Connectors
1.下载Tomcat Connectors JK 1.2。说的好听,就是ISAPI扩展文件,官网直接放出源码。我下载的是“tomcat-connectors-1.2.40-windows-x86_64-iis.zip”。http://apache.fayea.com/tomcat/tomcat-connectors/jk/binaries/windows/
2.拷贝isapi_redirect.dll文件到Server\Tomcat8\bin\win32\x86_64文件夹下。
3.注册isapi_redirect.dll,我直接弄reg文件并没有完全导入成功,后面两项我是手动添加上去的。
Windows Registry Editor Version 5.00 [HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0] "extension_uri"="/jakarta/isapi_redirect.dll" "log_file"="D:\Server\Tomcat8\logs\isapi.log" "log_level"="debug" "worker_file"="D:\Server\Tomcat8\conf\workers.properties" "worker_mount_file"="D:\Server\Tomcat8\conf\uriworkermap.properties"
PS:
a.extension_uri:tomcat这个isapi工作原理,是通过iis的虚拟目录调用tomcat的,在这里也就是site下面有个虚目录jakarta,jakart指向了存放dll的目录。通过调用这个虚目录在调用tomcat。
b.worker_file与worker_mount_file者两个文件是配置的是iis调用tomcat后,tomcat自己的工作方式及站点挂载方式。
c.在2008R2中如你想使用32位的isapi接口文件,也是可以的。只需要将isapi换成32位的dll文件。然后在IIS里面将允许jsp的site对应的应程序的高级设置里将 将启用32位程序设置为true(官方的介绍就是讲应用程序模式改为WOW64模式),注册表注册项目路径改为HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Jakarta Isapi Redirector\1.0 也就在wow64模式下注册。
4.在tomcat安装目录下conf文件夹下建立两个文件
文件1:workers.properties 其中worker1代表一个应用标签
#这里的worker1是worker们的名字。worker相当于一个tomcat运行实例,可以允许多个,就在此定义命名,命名规则为大小写字母数字与下划线减号 worker.list=worker1 #指定运行实例的工作类型,分为ajp12(一个旧的协议,为了兼容而保留,不赞成使用的),ajp13(常用的),lb(负载均衡方式工作的) worker.worker1.type=ajp13 worker.worker1.port=8009 worker.worker1.host=localhost worker.worker1.lbfactor=1 worker.worker1.connection_pool_timeout=600 worker.worker1.socket_keepalive=1 worker.worker1.socket_timeout=60 ##官方的例子 Define 3 workers, 2 real workers using ajp12, ajp13, the last one being a loadbalancing worker #worker.list=worker1, worker2, worker3 # Set properties for worker1 (ajp12) ##worker.worker1.type=ajp12 #worker.worker1.host=localhost #worker.worker1.port=8007 #worker.worker1.lbfactor=1 ## Set properties for worker2 (ajp13) #worker.worker2.type=ajp13 #worker.worker2.host=localhost #worker.worker2.port=8009 #worker.worker2.lbfactor=1 #worker.worker2.connection_pool_timeout=600 #worker.worker2.socket_keepalive=1 #worker.worker2.socket_timeout=60 ## Set properties for worker3 (lb) which use worker1 and worker2 #worker.worker3.balance_workers=worker1,worker2
文件2:uriworkermap.properties
/examples/* = worker1
/TZCGS/*=worker1
PS:
a.worker_file一般指向一个tomcat的工作实例类似iis的site.
b.worker_mount_file类似iis里面的虚目录配置文件。这里就是如果请求uri是hostlocal/examples和hostlocal/TZCGS 就用worker1实例来解析,其他还有iis来判断如何执行。其中的*是转义字符代表匹配任意后缀,也可以配置相关规则具体可详见官网说明。如果直接说/*=worker1那整个整个站点都有worker1实例来执行。
c.如何让IIS的一个site同时使用jsp,php,.net jsp的配置重点就是这里,你得告诉iis什么uri规则让tomcat执行。
四.配置IIS
1)在IIS的根节点即计算机节点中选择“ISAPI和CGI限制”里面增加isapi_redirect.dll扩展,参考如下
PS:这里的的描述可以自己设置,我建议可以为jakarta也可以为jsp
2)在iis增加一个site用来跑jsp程序,配置可以参考如下
3)在该站点的ISAPI筛选器中添加isapi筛选模块。名称自定义可以参考如下。
4)建立映射jsp执行的虚目录,此虚目录不做实际的虚目录使用,只是跟注册表中注册的extension_uri配合指向tomcat。所以这个虚目录的名称一定要对应注册表中extension_uri的值。在这里就是jakarta。然后其物理路径一定要指向isapi_redirect.dll的目录,在这里是D:\Server\Tomcat8\bin\win32\x86_64
5)配置虚目录的“应用程序映射”,编辑功能权限,将“执行”打勾,配置参考如下
ps:在这一步,有网文说需要添加一个*.jsp的映射指向到isapi的dll,在2008r2环境中本人实测根本不需要。
五.添加php程序,我这里是一个dz3.2的论坛。因为我直接配置了phpmanager且使用FASTCGI模式,只要在IIS的根节点配置成功,添加PHP程序就像添加.NET程序一样简单根本不需要配置任何东西。
PHP的IIS配置参考我之前的文章。
至此,根据我上文的配置,localhost/examples 就是访问tomcat 下webapps\examples中的jsp程序 ,访问localhost/bbs就是访问此虚目录指向的php dz程序。
六、32位的isapi_redirect.dll的总结
32配置的注册表文件
Windows Registry Editor Version 5.00 [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Jakarta Isapi Redirector\1.0] "extension_uri"="/jakarta/isapi_redirect.dll" "log_level"="debug" "worker_file"="D:\\Server\\Tomcat8\\conf\\workers.properties" "worker_mount_file"="D:\\Server\\Tomcat8\\conf\\uriworkermap.properties" "log_file"="D:\\Server\\Tomcat8\\logs\\isapi.log"
32位在IIS中需要单独配置的地方,正因为32程序是基于WOW64模式,所以注册表才会要在相应的目录下配置
关于Eclipse使用tomcat自身配置文件,运行tomcat服务。
怎么有这个问题的。主要是因为,要在测试服务器上使用Eclipse开发环境调试程序。Eclipse的server窗口里面的web服务,默认Eclipse自己建立一个独立的tomcat服务,这个服务在配置文件在%workspace_dir%\.metadata\.plugins\org.eclipse.wst.server.core\tempX目录下。也就是上面的IIS+tomcat的方法,无法让IIS调用tomcat安装目录下的配置的。解决途径有两种:
一种是把IIS的配置操作用于workspace目录下。
一种是把Eclipse调试用的tomcat服务,直接使用tomcat安装目录下的配置文件生产。
我选择的是后者。Eclipse的server一旦建立,里面是无法修改的。解决方法在server窗口中删除那个server直接重建,选择use tomcat installation 即可。