Apache+Tomcat集成教程单服务器多站点，多服务器负载均衡集群

发表于 由

目前网上有N多关于Apache+Tomcat集成的文章，其实就是来自一两篇文章拷贝来拷贝去。
最近我需要在单台服务器上部署两个站点的集成方案，从网上找了N久也没有找到解决办法(或许是我的方法不对 呵呵)。javaeye论坛上和CSDN论坛上有部分人提出单服务器多站点的场合Apache+tomcat如何集成问题，但大部分都没有正确的答案。经过我两天的摸索，Apache+tomcat集成，负载均衡，集群主要有几个关键点；

1、apache httpd.conf加载jk_module并且根据目录和文件名称将请求转发给tomcat。

2、负责均衡的时候将请求只转发给负载分发控制器，worker.list只要列出分发配置器就可以了，这点网上有很多资料没有说明(肯定是没有认真阅读官方文档所致)。

3、tomcat server.xml配置文件中的Engine节点要注意配置jvmRoute属性，并且该属性值一定要和worker.properties中tomcat的名称保持一致，而且不能重复。如果不一致，将不能使用session_stricky功能。CSDN上有人发帖请教问题，但没有得到答案。

4、集群情况下注意多个tomcat的server.xml配置文件的各种端口不能重复，主要有Server节点、Connector节点、tcpListernPort节点。

5、集群情况下一定要注意server.xml文件Host节点中将Cluster注释去掉，且要修改Receiver端口。

6、负载均衡并不一定需要集群(但需要session_stricky会话保持)，除非你需要failover(失败转移)功能。

附件是我摸索整理的整合文档，现在共享出来希望有需要的人可以少走些弯路，本文档不涉及调优方面的内容。文档包含单服务器多个站点配置部分和负载均衡集群配置内容。文档中将一些重要的关键点都进行了红色标注，大家在实践过程中稍加留意红色部分内容。

Apache、Tomcat整合配置教程

准备相关软件

下载安装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

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 Server2.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节点是否设置为有效

 

  1. da shang
    donate-alipay
               donate-weixin weixinpay

发表评论↓↓