jboss和apache的集群配置

说起JBoss集群好像很高深的样子，其实一点也不恐怖，建立一个集群很简单，难的是怎么针对具体的应用优化服务器和实现负载均衡（学习中^o^）。本文将带领大家在JBoss的default目录下建立一个简单的Web方面的JBoss集群。

      搭建环境

   两台电脑 //其实一台也够了，不过需要修改其中一个JBoss监听的端口，要不然有冲突
   jboss-4.0.4.GA
   apache_2.0.59 //我使用的是apache_2.0.59-win32-x86-no_ssl，其实无所谓的
   mod_jk-apache-2.0.59.so //Apache请求分发的模块，官网上可以找到

   首先安装JBoss，我用的是zip格式的，直接解压缩就可以了，在两台电脑里分别安装。

   接下来在其中一台电脑上（这里是192.168.0.2）安装Apache（其实应该再找一台电脑来安装的），很简单，略过^o^（偶是不是很懒^o^）

      配置JBoss

    假设两台电脑的IP分别为192.168.0.2和192.168.0.3。我们这里使用JBoss的default目录。

   将如下文件从%JBoss_Home%/server/all/lib里面拷到%JBoss_Home%/server/default/lib目录下：

   jbossha.jar(加载org.jboss.ha.framework.server.ClusterPartition)
   jgroups.jar(JBoss集群底层通信协议)
   jboss-cache.jar(加载org.jboss.cache.aop.TreeCacheAop)

   还要从%JBoss_Home%/server/all/deploy里把cluster-service.xml和tc5-cluster.sar拷贝到%JBoss_Home%/server/default/deploy里面。

   编辑192.168.0.2的%JBoss_Home%/server/default/deploy/jbossweb-tomcat55.sar/server.xml 
   修改下面代码：

< Engine  name ="jboss.web"  defaultHost ="localhost" >

   修改为：

< Engine  name ="jboss.web"  defaultHost ="localhost"  jvmRoute ="node1" >

   其中 jvmRoute是用来让apache识别的节点名称，一个节点一个名称，注意不要有重复的（可以结合IP设置）。

   同理编辑192.168.0.3的%JBoss_Home%/server/default/deploy/jbossweb-tomcat55.sar/server.xml
注意把jvmRoute设置为node2，可以设置成别的只要和192.168.0.2的不重复就行，但是要和Apache的workers.properties（稍后介绍）下的配置一致。

   在%JBoss_Home%/server/default/deploy/jbossweb-tomcat55.sar/ROOT.war/目录下添加一个新文件夹/test，并在里面添加如下3个jsp文件：

index.jsp

 1 <% @ page contentType = " text/html;charset=ISO8859_1 "   %>  
 2
 3 < html >
 4 < head >
 5 < title > Test </ title >
 6 < meta  http-equiv ="Content-Type"  content ="text/html; charset=gb2312" >
 7 </ head >
 8
 9 < body  onload ="document.form.name.focus()" >
10 < br >< br >< br >
11 < center >
12 The host is :  <% = java.net.InetAddress.getLocalHost().toString() %> < br >
13 Your session id is :  <% = session.getId() %> < br >
14 Your session detail is :  <% = session.toString() %> < br >
15 Your session context is :  <% = session.getSessionContext() %> < br >< br >
16 Please input your name: < br >
17 < form  action ="test_action.jsp"  method ="POST"  name ="form" >
18      < input  type ="input"  name ="name" />
19      < input  type ="submit"  value ="提交" >
20 </ form >
21 </ center >
22 </ body >
23 </ html >
24
25

test_action.jsp

 1 <% @ page contentType = " text/html;charset=ISO8859_1 "   %>  
 2
 3 < html >
 4 < head >
 5 < title > Test Action </ title >
 6 < meta  http-equiv ="Content-Type"  content ="text/html; charset=gb2312" >
 7 </ head >
 8 <%
 9      String  name  =  request.getParameter( " name " );
10     session.setAttribute( " name " ,name);
11      String  host  =  java.net.InetAddress.getLocalHost().toString();
12 %>
13 < body >
14 < br >
15 < br >
16 < center >
17 The host is :  <% = host %> < br >< br >
18 Your session id is :  <% = session.getId() %> < br >
19 Your session detail is :  <% = session.toString() %> < br >
20 Your session context is :  <% = session.getSessionContext() %> < br >< br >
21 Your name is :  <% = name %> < br >
22 This name is set into the session. < br >
23 Please click  < a  href ="session.jsp" > here </ a >  to check the session valid or not.
24 </ center >
25 </ body >
26 </ html >
27
28

session.jsp

 1 <% @ page contentType = " text/html;charset=ISO8859_1 "   %>  
 2
 3 < html >
 4 < head >
 5 < title > Test Action </ title >
 6 < meta  http-equiv ="Content-Type"  content ="text/html; charset=gb2312" >
 7 </ head >
 8 <%
 9      String  name  =   null ;
10      if (session.getAttribute( " name " )! = null )
11         name  =  ( String )session.getAttribute( " name " );
12      String  host  =  java.net.InetAddress.getLocalHost().toString();
13 %>
14 < body >
15 < br >
16 < br >
17 < center >
18 The host is :  <% = host %> < br >
19 Your session id is :  <% = session.getId() %> < br >
20 Your session detail is :  <% = session.toString() %> < br >
21 Your session context is :  <% = session.getSessionContext() %> < br >< br >
22 <%
23      if (name! = null ){
24         out.print( " Your name is  " + name + " <br> " );
25         out.print( " The session is valid. " );
26     }
27      else {
28         out.print( " The session is invalid!!! " );
29     }
30 %>
31 < a  href ="index.jsp" > Return! </ a >
32 </ center >
33 </ body >
34 <%
35      if (session.getAttribute( " name " )! = null )
36         session.invalidate();
37 %>
38 </ html >
39
40

   编辑%JBoss_Home%/server/default/deploy/jbossweb-tomcat55.sar/ROOT.war/WEB-INF/web.xml在<web-app>节点下增加如下代码：

1 < distributable />

   完成后web.xml代码如下：

 1 <? xml version="1.0" encoding="ISO-8859-1" ?>
 2
 3 <! DOCTYPE web-app
 4     PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 5     "http://java.sun.com/dtd/web-app_2_3.dtd" >
 6
 7 < web-app >
 8    < distributable />
 9    < display-name > Welcome to JBoss </ display-name >
10    < description >
11      Welcome to JBoss
12    </ description >
13    < servlet >
14      < servlet-name > Status Servlet </ servlet-name >
15      < servlet-class > org.jboss.web.tomcat.tc5.StatusServlet </ servlet-class >
16    </ servlet >
17    < servlet-mapping >
18      < servlet-name > Status Servlet </ servlet-name >
19      < url-pattern > /status </ url-pattern >
20    </ servlet-mapping >
21 </ web-app >
22

   看到第8行了吗？^o^

   到这里JBoss就配置完成了^o^

       配置Apache

   JBoss 的Web集群使用apache的mod_jk，浏览器请求apache服务器，apache服务器根据workers.properties中的配置进行 request分发，apache服务器和Jboss中的Tomcat可以用ajp1.3进行通信的，request通过ajp1.3协议的包装被发送到 Jboss，Jboss执行后返回结果。

   将下载到的mod_jk-apache-2.0.59.so保存到%Apache%/modules/目录下，并去掉版本号重命名为“mod_jk.so”，如果不改也可以在mod-jk.conf文件（稍后介绍）里修改配置。

   在%Apache%/conf/目录下新建mod-jk.conf，并将如下代码添加进去：

 1 # Load mod_jk module
 2 # Specify the filename of the mod_jk lib
 3 LoadModule jk_module modules/mod_jk.so
 4 # Where to find workers.properties
 5 JkWorkersFile conf/workers.properties
 6 # Where to put jk logs
 7 JkLogFile logs/mod_jk.log
 8 # Set the jk log level [debug/error/info]
 9 JkLogLevel debug
10 # Select the log format
11 JkLogStampFormat "[%a %b %d %H:%M:%S %Y]"
12 # JkOptions indicates to send SSK KEY SIZE
13 JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories
14 # JkRequestLogFormat
15 JkRequestLogFormat "%w %V %T"
16 # Mount your applications
17 #JkMount /application/* loadbalancer
18 JkMount /* loadbalancer
19 # You can use external file for mount points.
20 # It will be checked for updates each 60 seconds.
21 # The format of the file is: /url=worker
22 # /examples/*=loadbalancer
23 JkMountFile conf/uriworkermap.properties
24 # Add shared memory.
25 # This directive is present with 1.2.10 and
26 # later versions of mod_jk, and is needed for
27 # for load balancing to work properly
28 JkShmFile logs/jk.shm
29 # Add jkstatus for managing runtime data
30 < Location  /jkstatus />
31 JkMount status
32 Order deny,allow
33 Deny from all
34 Allow from 127.0.0.1
35 </ Location >

   上述代码的第3行就是配置mod_jk.so模块的路径。

   编辑%Apache%/conf/httpd.conf在最后一行添加如下代码：

1 Include conf/mod-jk.conf

   在 %Apache%/conf/目录下添加workers.properties文件，该文件就是配置Apache所要将request转发到的JBoss的路径信息，代码如下：

 1 # 定义request所要转发到的节点
 2 worker.list=loadbalancer,status
 3 # 定义节点 Node1
 4 worker.node1.port=8009
 5 worker.node1.host=192.168.0.2
 6 worker.node1.type=ajp13
 7 worker.node1.lbfactor=1
 8 worker.node1.cachesize=10
 9 # 定义节点 Node2
10 worker.node2.port=8009
11 worker.node2.host=192.168.0.3
12 worker.node2.type=ajp13
13 worker.node2.lbfactor=1
14 worker.node2.cachesize=10
15 # 负载配置
16 worker.loadbalancer.type=lb
17 worker.loadbalancer.balance_workers=node1,node2
18 worker.loadbalancer.sticky_session=0
19 worker.status.type=status

   上述代码中：
   port是配置JBoss AJP所监听的端口号，可以在%JBoss_Home%/server/default/deploy/jbossweb-tomcat55.sar/server.xml 看到，如下

1 <!--  A AJP 1.3 Connector on port 8009  -->
2 < Connector  port ="8009"  address ="${jboss.bind.address}"  
3          emptySessionPath ="true"  enableLookups ="false"
4          redirectPort ="8443"  protocol ="AJP/1.3" />

   host定义JBoss所在机器的IP地址
   lbfactor定义该节点的权重，数字越大分发到该节点的request越多
   cachesize是servlet线程池的大小（对session复制有影响）

   到这里所有的配置就全部完成啦^o^

   启动192.168.0.2上的apache和两台机器上的JBoss。
   打开浏览器，输入网址访问apache： http://192.168.0.2/test/index.jsp ，回车！看到了吧？

   页面上有JBoss所在机器的IP地址，刷新页面还能看到IP在变化，说明apache将request分发到了不同的JBoss上，在输入框中输入随便一个字符串并提交还能测试JBoss 的session复制情况。

^o^