背景
使用FineReport制作一些报表，然后嵌入已经存在的Web项目中，因此需要Tomcat和IIS联通。
根据FineReport的官方的一些说明，知道FineReport是放入Tomcat服务器的host指定目录即可运行的，而已经存在的项目是IIS的，因此需要一个联通。
效果
通过访问site/app中的js代码，不必跨域和跨端口，直接访问../WebReport获得报表展示即可
吐槽
FineReport官网上的说明书已经落后的，根据上面的指导，我花费4小时，没有搞定，最后去了Tomcat网站看了说明马上搞定。Tomcat小白，第一次弄，做个记录吧。
准备
必要环境
- JRE
- JDK
都是从Oracle那里去下载。
不明白为什么要JDK，反正根据Tomcat上的说明是需要的，我就安装了。
Tomcat服务
我从官网下载了最新的Tomcat9.0，直接安装默认目录，端口也没有修改。很多百度结果都是安装到非C盘。我只想说，实际部署的时候，有那么多盘给你吗？安装C盘，然后提权就可以了。
IIS服务
这个一般是windows server自己配置了。没有太多可以说的。
下载联通控制程序
去Tomcat网站下载：https://tomcat.apache.org/download-connectors.cgi
根据说明可以下载源码和编译好的released版本。我选择了兼容x64的适配Windows的下载。当然也是用最新版。
需要选择合适的镜像，基本国内大学的site都可以用。
源码需要vs2015的编译器，我没有尝试过（没有空折腾了），如果是Linux部署肯定编译好，不过IIS有在Linux吗？
其他备忘
OS: Windows10，Windows 2012 Server （x64）
IIS: IIS 10 , IIS 8
Tomcat：9.0， 安装到->C:\Program Files\Apache Software Foundation\Tomcat 9.0
JDK:10.0
JRE:8
isapi_redirect.dll:1.2.43
步骤
后面就是Step By Step配置，说明手册很简单。
http://tomcat.apache.org/connectors-doc/webserver_howto/iis.html
我这里仅仅做点中文翻译即可
Tomcat配置部分
创建isapi目录
创建一个目录： ${tomcat_home}\isapi
授权
需要管理员权限执行Cmd：
icacls "C:\Program Files\Apache Software Foundation\Tomcat 9.0\isapi" /grant "IIS APPPOOL\DefaultAppPool":(OI)(CI)M
注意哦：这里用的是IIS APPPOOL\DefaultAppPool，如果站点用的应用程序池不是这个，则需要修改。
下载并部署连接器
在https://tomcat.apache.org/download-connectors.cgi找到合适的版本下载，然后解压；
将isapi_redirect.dll放入目录：${tomcat_home}\isapi
创建配置文件
文件路径：
${tomcat_home}\isapi\isapi_redirect.properties
我使用notepad++的管理员权限创建保存。
（实际上，我还是比较习惯sudo vi，方便啊）
文件内容：
extension_uri=/jakarta/isapi_redirect.dll
log_file=C:\Program Files\Apache Software Foundation\Tomcat 9.0\isapi\isapi_redirect.log
log_level=info
worker_file=C:\Program Files\Apache Software Foundation\Tomcat 9.0\isapi\workers.properties
worker_mount_file=C:\Program Files\Apache Software Foundation\Tomcat 9.0\isapi\uriworkermap.properties
注意：使用windows的notepad可能导致没有权限和默认加上.txt扩展名
创建配套worker文件
文件路径：
${tomcat_home}\isapi\workers.properties
文件内容：
worker.list=tomcat01
worker.tomcat01.type=ajp13
worker.tomcat01.host=localhost
worker.tomcat01.port=8009
注意：不要照抄，根据客户生产环境和Tomcat安装配置的端口处理
创建配套映射文件
文件路径：
${tomcat_home}\isapi\uriworkermap.properties
文件内容：
/examples/*=tomcat01
/WebReport/*=tomcat01
注意：
我这里写了2个路径映射，一个举例，我主要用来测试，一个是FineReport默认的路径。届时，IIS遇到这样的路径，直接转发给Tomcat。
IIS配置部分
增加虚拟目录
在自己的站点上，增加一个虚拟目录。
别名：jakarta
物理路径：${tomcat_home}\isapi
说明：因为配置中写了jakarta，所以别名就必须配套一致。
配置处理程序映射
选中虚拟目录，双击“处理程序映射”。
找到：ISAPI-dll一行（可能是disabled状态），
在右侧的操作Form中，点击“编辑功能权限”，在弹出的对话框中，勾选最后一个“执行”。
（如果是disable状态，确定后会激活）
为站点添加Filter
选中部署的站点（地球图标），双击“ISAPI筛选器”。
点击右侧Form中的添加。
输入名称：tomcat（其实可以随意）
可执行文件：${tomcat_home}\isapi\isapi_redirect.dll
点击确定退出。
服务器配置
选中IIS中的一个服务器（你站点的服务器）。
双击“ISAPI and CGI 限制”，在操作Form中点击添加。
在弹出的对话框Form中输入：
路径：
${tomcat_home}\isapi\isapi_redirect.dll
描述：
tomcat（其实可以随意）
勾选：
checked 允许执行扩展路径
点击确定。
完工重启服务
配置过程中其实最好是停止所有的服务，然后再启动。
不过有时候IIS正在生产，因此只能重启服务。
好像没有遇到顺序问题，直接都先停止，再启动。
测试成果
- 登录8080
localhost:8080，理论上可以进入Tomcat管理默认index.jsp
检查IIS，是否有其他站点占用8080端口 - localhost/examples/index.jsp
理论上可以看到结果。
网友评论