转载于:http://luming711115.javaeye.com/blog/200206
目前网上有N多关于Apache+Tomcat集成的文章,其实就是来自一两篇文章拷贝来拷贝去。
最近我需要在单台服务器上部署两个站点的集成方案,从网上找了N久也没有找到解决办法(或许是我的方法不对 呵呵)。javaeye论坛上和优快云论坛上有部分人提出单服务器多站点的场合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功能。优快云上有人发帖请教问题,但没有得到答案。
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 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节点是否设置为有效