2018-06-27 配置Tomcat连接IIS环境

背景

使用FineReport制作一些报表,然后嵌入已经存在的Web项目中,因此需要Tomcat和IIS联通。
根据FineReport的官方的一些说明,知道FineReport是放入Tomcat服务器的host指定目录即可运行的,而已经存在的项目是IIS的,因此需要一个联通。

效果

通过访问site/app中的js代码,不必跨域和跨端口,直接访问../WebReport获得报表展示即可

吐槽

FineReport官网上的说明书已经落后的,根据上面的指导,我花费4小时,没有搞定,最后去了Tomcat网站看了说明马上搞定。Tomcat小白,第一次弄,做个记录吧。

准备

必要环境

  1. JRE
  2. 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正在生产,因此只能重启服务。
好像没有遇到顺序问题,直接都先停止,再启动。

测试成果

  1. 登录8080
    localhost:8080,理论上可以进入Tomcat管理默认index.jsp
    检查IIS,是否有其他站点占用8080端口
  2. localhost/examples/index.jsp
    理论上可以看到结果。

你可能感兴趣的:(2018-06-27 配置Tomcat连接IIS环境)