ApacheTomcat整合

准备相关软件

下载安装Apache2.2.4
Apache下载地址：http://archive.apache.org/dist/httpd/binaries/win32/，选择下载windows平台安装包文件apache_2.2.4-win32-x86-no_ssl.msi。

 

接受安装协议

 

配置apache服务器信息

 

Network Domain设置站点名称，这个不会对实际站点产生影响。
Server Name设置当前服务器名称，这个不会对实际站点产生影响。
Administrator’s Email Address设置站点管理员邮件地址，Apache文档说明当站点出错时的页面底部会出现该地址。

 

安装类型一般选择typical

 

安装路径选择默认

 

Tomcat5.5.26下载地址：http://tomcat.apache.org/download-55.cgi，选择Core的zip包。

 

下载Tomcat Connector(jk.1.2.6)
Tomcat Connector下载地址：http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/win32/jk-1.2.26/，此处注意一定要下载与Apache版本匹配的jk。jk文件名后半部分名称反应Apache的版本，如：mod_jk-1.2.26-httpd-2.2.4.so其匹配的Apache为2.2.4，与本次安装的Apache版本一致。

 

单台主机多站点场景
在一台机器上配置多个站点，每个站点有自己独立的域名。假设服务器有两个站点wap.abc.com和bbs.abc.com，两个站点分别运行在一个tomcat下。为方便说明，下面分别简称为wap和bbs站点。

 

Apache配置
将Tomcat Connector文件mod_jk-1.2.26-httpd-2.2.4.so拷贝到Apache安装目录Apache2.2\modules下。
在Apache配置文件Apache2.2\conf\httpd.conf末尾增加以下内容；

 

#以下为tomcat集成配置部分
LoadModule jk_module modules/mod_jk-1.2.26-httpd-2.2.4.so
JkWorkersFile conf/workers.properties

#如果机器有多个IP地址请务必使用*号
NameVirtualHost *:80

#bbs.abc.com虚拟站点
<VirtualHost *:80>
ServerName bbs.abc.com
JkMount /*.* tomcatbbs
DirectoryIndex index.jsp
</VirtualHost>

#wap.abc.com虚拟站点
<VirtualHost *:80>
ServerName wap.abc.com
JkMount /*.* tomcatwap
DirectoryIndex index.jsp
</VirtualHost>

 

配置完成以后使用开始程序菜单目录中的Apache HTTP Server 2.2.4? Configure Apache Server? Test Configuration检查Apache配置文件是否正确。

Tomcat Connector配置
在Apache配置目录Apache2.2\conf创建workers.properties配置文件，该文件主要用于配置Apache与Tomcat的集成要用到的Tomcat实例。
Workers.properties文件放置一下内容；

 

#下面是Tomcat实例列表
worker.list=tomcatbbs,tomcatwap

#Tomcatbbs实例配置
worker.tomcatbbs.host=127.0.0.1
worker.tomcatbbs.port=8009
worker.tomcatbbs.type=ajp13

#Tomcatwap实例配置
worker.tomcatwap.host=127.0.0.1
worker.tomcatwap.port=9009
worker.tomcatwap.type=ajp13

 

Tomcat配置
Wap和bbs分别运行在两个Tomcat实例下，将刚才下载的Tomcat分别解压为两个目录tomcatbbs和tomcatwap。

 

Tomcatbbs实例配置
打开bbs站点tomcat目录下的conf\server.xml，找到下面的节点内容

 

<Server port="8005" shutdown="SHUTDOWN">
<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
<Connector port="8080" maxHttpHeaderSize="8192"
               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
               enableLookups="false" redirectPort="8443" acceptCount="100"
               connectionTimeout="20000" disableUploadTimeout="true" />

中间忽略N多注释

<!-- Define an AJP 1.3 Connector on port 8009 -->
<Connector port="8009" 
               enableLookups="false" redirectPort="8443" protocol="AJP/1.3" />

 

注意以上标注红色的配置，同一台机器的多个Tomcat不能重复使用以上端口，下半部分AJP的端口配置要和workers.properties的端口配置保持一致。

 

再找到Host节点配置更改一些内容

 

<!-- Define the default virtual host
           Note: XML Schema validation will not work with Xerces 2.2.
       -->
<Host name="bbs.abc.com" appBase="webapps\bbs"
       unpackWARs="true" autoDeploy="true"
       xmlValidation="false" xmlNamespaceAware="false">

中间忽略N多注释

<!--下面是增加的内容-->
<Context docBase="." path="" reloadable="true"/>

 

以上第一处是配置站点域名和站点内容路径，下面增加的内容是配置站点的根路径。

 

Tomcatwap实例配置
打开wap站点tomcat目录下的conf\server.xml，找到下面的节点内容

 

<Server port="9005" shutdown="SHUTDOWN">
<!-- Define a non-SSL HTTP/1.1 Connector on port 9090 -->
<Connector port="9090" maxHttpHeaderSize="8192"
               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
               enableLookups="false" redirectPort="8443" acceptCount="100"
               connectionTimeout="20000" disableUploadTimeout="true" />

中间忽略N多注释

<!-- Define an AJP 1.3 Connector on port 8009 -->
<Connector port="9009" 
               enableLookups="false" redirectPort="8443" protocol="AJP/1.3" />

 

以上标注红色的配置，同一台机器的多个Tomcat不能重复使用以上端口，下半部分AJP的端口配置要和workers.properties的端口配置保持一致。请注意本次配置分别改了两个端口为9090和9009。

 

在找到Host节点配置更改一些内容

 

<!-- Define the default virtual host
           Note: XML Schema validation will not work with Xerces 2.2.
       -->
<Host name="wap.abc.com" appBase="webapps\wap"
       unpackWARs="true" autoDeploy="true"
       xmlValidation="false" xmlNamespaceAware="false">

中间忽略N多注释

<!--下面是增加的内容-->
<Context docBase="." path="" reloadable="true"/>

 

以上第一处是配置站点域名和站点内容路径，下面增加的内容是配置站点的根路径。

 

 常见问题
修改host文件，加入wap.abc.com，bbs.abc.com解析至当前机器127.0.0.1。
分别启动Apache和两个Tomcat，打开两个浏览器分别输入wap.abc.com，bbs.abc.com测试是否显示不同的站点内容。

如果没有达到预期效果请检查一下几点配置：
Apache2.2\conf\httpd.conf配置文件是否配置的两个Host是否配置了域名
Host中JkMount /*.* tomcatwap配置tomcat对应的Service.xml中配置的域名是否一致
Worker.properites中配置的tomcat实例端口是否和对应tomcat Service.xml文件中的AJP端口是否一致
Tomcat Service.xml配置文件Host节点是否有<Context docBase="." path="" reloadable="true"/>配置内容
Tomcat站点内容目录下是否有httpd.conf文件Host节点中DirectoryIndex index.jsp配置的文件

 

单台主机单站点集群、负载均衡

Apache配置
将Tomcat Connector文件mod_jk-1.2.26-httpd-2.2.4.so拷贝到Apache安装目录Apache2.2\modules下。
在Apache安装目录找到conf/httpd.conf文件，在末尾增加一下内容

 

#以下为tomcat集成配置部分
LoadModule jk_module modules/mod_jk-1.2.26-httpd-2.2.4.so
JkWorkersFile conf/workers.properties
JkMount /*.* lbcontroller

找到下面配置，将默认目录文件index.html改为index.jsp
<IfModule dir_module>
    DirectoryIndex index.jsp
</IfModule>

 

Tomcat Connector配置
在Apache配置目录Apache2.2\conf创建workers.properties配置文件，该文件主要用于配置Apache与Tomcat的集成要用到的Tomcat实例和负载均衡分发控制器。
Workers.properties文件放置一下内容；

 

#下面是分发控制器 注意不要放tomcat实例
worker.list=lbcontroller

#Tomcat1实例配置 这里要和Tomcat配置文件Service.xml的jvmRoute保持一致
worker.tomcat1.host=127.0.0.1
worker.tomcat1.port=8009
worker.tomcat1.type=ajp13
#分发权重 值越大负载越大
worker.tomcat1.lbfactor = 1

#Tomcat2实例配置
worker.tomcat2.host=127.0.0.1
worker.tomcat2.port=9009
worker.tomcat2.type=ajp13
#分发权重 值越大负载越大
worker.tomcat2.lbfactor = 1

#负载均衡分发控制器
worker.lbcontroller.type=lb
worker.lbcontroller.balance_workers=tomcat1,tomcat2

 

Tomcat配置
Tomcat配置文件Service.xml主要注意两个地方，一个是Engine节点需要增加节点标识jvmRoute，一个是将原本注释掉的Session复制节点改为有效。具体如下

 

<!-- Define the top level container in our container hierarchy -->
<!--jvmRoute在各个Tomcat配置中不能重复且要与worker.properties文件中的名称一致-->
<Engine name="Catalina" defaultHost="localhost" jvmRoute=" tomcat1">
<!—每个Tomcat的Hostname必须一样?
<Host name="bbs.abc.com" appBase="webapps\bbs"
       unpackWARs="true" autoDeploy="true"
       xmlValidation="false" xmlNamespaceAware="false">

这里省略N多注释

将下面的注释变去掉
<!--
        <Cluster className="org.apache.catalina.cluster.tcp.SimpleTcpCluster"
                 managerClassName="org.apache.catalina.cluster.session.DeltaManager"
                 expireSessionsOnShutdown="false"
                 useDirtyFlag="true"
                 notifyListenersOnReplication="true">
            <Membership 
                className="org.apache.catalina.cluster.mcast.McastService"
                mcastAddr="228.0.0.4"
                mcastPort="45564"
                mcastFrequency="500"
                mcastDropTime="3000"/>
<!—接收端口在各个Tomcat配置中不能重复-->
            <Receiver 
                className="org.apache.catalina.cluster.tcp.ReplicationListener"
                tcpListenAddress="auto"
                tcpListenPort="4001" 
                tcpSelectorTimeout="100"
                tcpThreadCount="6"/>
            <Sender
                className="org.apache.catalina.cluster.tcp.ReplicationTransmitter"
                replicationMode="pooled"
                ackTimeout="15000"
                waitForAck="true"/>
            <Valve className="org.apache.catalina.cluster.tcp.ReplicationValve"
                   filter=".*\.gif;.*\.js;.*\.jpg;.*\.png;.*\.htm;.*\.html;.*\.css;.*\.txt;"/>                   
            <Deployer className="org.apache.catalina.cluster.deploy.FarmWarDeployer"
                      tempDir="/tmp/war-temp/"
                      deployDir="/tmp/war-deploy/"
                      watchDir="/tmp/war-listen/"
                      watchEnabled="false"/>                      
            <ClusterListener className="org.apache.catalina.cluster.session.ClusterSessionListener"/>
        </Cluster>
        -->
<!—Host节点增加一下内容表示站点根路径-->
<Context docBase="." path="" reloadable="true"/>

 

我们分别将两个Tomcat配置文件中的jvmRoute设置为tomcat1、tomcat2，Server节点 端口分别配置为8005和9005，集群Receiver 节点tcpListenPort端口分别配置为4001和4002，Connector节点端口分别配置为8080和9090，AJPConnector端口分别配置为8009和9009，Connector端口配置参照单主机多站点场景。请注意两个Tomcat配置文件Host节点的域名配置必须一样，Server.xml中的jvmRoute名称必须和worker.properties中的tomcat实例名称一致，不然无法实现session_stricky。

Web.xml配置
Web.xml配置文件加上<distributable/>节点，此配置说明当前Web工程处于分布式部署环境。如果不进行这个配置，每次访问页面tomcat都会产生一个新的sessionid。

常见问题
修改Host文件将bbs.abc.com解析到本机。打开两个IE窗口分别提交session操作，然后在控制台观察效果。
正常情况为；同一个IE窗口的所有请求都分发到同一个Tomcat，当关闭其中一个Tomcat时，IE窗口重新请求会分发到另一个Tomat并且Session保持同步。

 

如果没有达到预期效果请检查一下几点；
Apache配置文件中DirectoryIndex配置的文件是否存在tomcat应用的目录下
Apache配置文件中JkMount是否分发到负责均衡控制器
两个Tomcat端口是否有重复,
Worker.properties中tomcat端口是否和对应server.xmlAJPConnector端口一致
Server.xml配置文件的Host节点name属性是否一致
Server.xml配置文件的Engine节点是否配置jvnRoute，并且与worker.properties配置的名称保持一致
Server.xmlHost节点内的Cluster节点是否设置为有效