Terry.Li-彬

1 概述

• Round-Robin (org.jboss.ha.framework.interfaces.RoundRobin)：每次調用被派發給一個新的節點，第一個節點是隨機選擇的。

• First Available (org.jboss.ha.framework.interfaces.FirstAvailable):：第一個可用的節點選為主節點，服務于隨后每一個調用，主節點的選擇是隨機的。當集群中的節點發生變化時（因為節點啟動或者停止），除非當前主節點依然可用，將重新選擇一個可用的節點作為主節點。每個客戶端攔截器或負載平衡器獨立選擇自己的主節點。

1. xml version="1.0" encoding="UTF-8"?>       
2. <server>           
3.            
4.     <mbean code="org.jboss.ha.framework.server.FarmMemberService"        
5.             name="jboss:service=FarmMember,partition=DefaultPartition">        
6.         ...         
7.         <attribute name="PartitionName">DefaultPartitionattribute>         
8.         <attribute name="ScanPeriod">5000attribute>         
9.         <attribute name="URLs">farm/attribute>        
10.     mbean>          
11. server>  

• 會話狀態復制

• 請求負載平衡

注意

一個負載平衡器跟蹤HTTP請求，根據和請求關聯的會話，決定派發請求到合適的節點。這被稱作使用sticky-sessions的負載平衡器：一 旦在某個節點創建了會話，隨后的請求將由同一個節點進行處理。使用一個支持sticky-sessions的負載平衡器可以不用復制會話，沒有會話狀態復 制的花銷，每個請求將是被同一個節點處理。但是一旦這個節點崩潰，保存在這個節點的所有客戶會話都將丟失，客戶必須登錄進另一個節點，重新啟動一個新的會 話。在某些情況，不復制HTTP會話是可以接受的，因為比較關鍵的狀態都保存在數據庫中，但是也有些情況下，丟失會話狀態是無法接受的，這種情況下，會話 狀態復制的花銷是必須承受的。

從http://httpd.apache.org/ 下載Apache,安裝是非常直白的，不需要特別的配置，推薦使用2.0.x版本，這里假定Apache安裝目錄為APACHE_HOME。 

然后從www.apache.org/dist/jakarta/tomcat-connectors/jk/binaries/. 下載mod_jk模塊，建議使用mod_jk 1.2.x版本。重命名下載的文件為mod_jk.so，拷貝到APACHE_HOME/modules/目錄下。

更改APACHE_HOME/conf/httpd.conf 文件，在文件尾部添加一行：

創建文件APACHE_HOME/conf/mod-jk.conf:

java 代碼


    
# Load mod_jk module   
    
# Specify the filename of the mod_jk lib   
    
LoadModule jk_module modules/mod_jk.so   
    
    
    
# Where to find workers.properties   
    
JkWorkersFile conf/workers.properties   
    
  
    
# Where to put jk logs   
    
JkLogFile logs/mod_jk.log   
    
    
    
# Set the jk log level [debug/error/info]   
    
JkLogLevel info    
    
    
    
# Select the log format   
    
JkLogStampFormat  "[%a %b %d %H:%M:%S %Y]"  
    
    
    
# JkOptions indicates to send SSK KEY SIZE   
    
JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories   
    
    
    
# JkRequestLogFormat   
    
JkRequestLogFormat "%w %V %T"  
    
                  
    
# Mount your applications   
    
JkMount /application/* loadbalancer   
    
    
    
# You can use external file for mount points.   
    
# It will be checked for updates each 60 seconds.   
    
# The format of the file is: /url=worker   
    
# /examples/*=loadbalancer   
    
JkMountFile conf/uriworkermap.properties                  
    
  
    
# Add shared memory.   
    
# This directive is present with 1.2.10 and   
    
# later versions of mod_jk, and is needed for  
    
# for load balancing to work properly   
    
JkShmFile logs/jk.shm    
    
                 
    
# Add jkstatus for managing runtime data   
    
   
    
    JkMount status   
    
    Order deny,allow   
    
    Deny from all   
    
    Allow from 127.0.0.1  
    
   

其中有兩個設置是非常重要的：

除了使用 JkMount 指令，也可以使用JkMountFile 指令指定一個配置文件，包含多個URL映射配置。你只需要在APACHE_HOME/conf 目錄下創建一個uriworkermap.properties 文件。文件格式為/url=worker_name,示例文件如下：

java 代碼


    
# Simple worker configuration file   
    
  
    
# Mount the Servlet context to the ajp13 worker   
    
/jmx-console=loadbalancer   
    
/jmx-console/*=loadbalancer   
    
/web-console=loadbalancer   
    
/web-console/*=loadbalancer   

如上示例將配置 mod_jk 派發請求 /jmx-console 和/web-console 給Tomcat。

接著需要創建conf/workers.properties文件，這個文件用來指定名個不同的Servlet容器的位置以及調用如何在這些容器之間進行平衡。針對一個兩個節點的設置，示例文件如下：

java 代碼


    
# Define list of workers that will be used   
    
# for mapping requests   
    
worker.list=loadbalancer,status   
    
  
    
# Define Node1   
    
# modify the host as your host IP or DNS name.   
    
worker.node1.port=8009  
    
worker.node1.host=node1.mydomain.com    
    
worker.node1.type=ajp13   
    
worker.node1.lbfactor=1  
    
worker.node1.cachesize=10  
    
  
    
# Define Node2   
    
# modify the host as your host IP or DNS name.   
    
worker.node2.port=8009  
    
worker.node2.host= node2.mydomain.com   
    
worker.node2.type=ajp13   
    
worker.node2.lbfactor=1  
    
worker.node2.cachesize=10  
    
  
    
# Load-balancing behaviour   
    
worker.loadbalancer.type=lb   
    
worker.loadbalancer.balance_workers=node1,node2   
    
worker.loadbalancer.sticky_session=1  
    
#worker.list=loadbalancer   
    
  
    
# Status worker for managing load balancer   
    
worker.status.type=status              

上述文件配置mod_jk執行Round-Robin的基于sticky-sessions的負載平衡策略，兩個節點都監聽8009端口。

works.properties文件中，每個節點使用worker.XXX 命名規范進行定義，這里 XXX 可以是任何名字，用來命名Servlet容器。對于每個工作者，必須指定在目標Servlet容器中配置的AJP13連接器的IP地址和端口號。

lbfactor 屬性用來表示負載平衡權重，決定節點之間的優先級，值越大，該節點將接受越多的請求。這個選項可以用來分配不同的節點不同的負載。

cachesize 屬性定義關聯的Servlet容器的線程池大小，確定這個值沒有超過Servlet容器在AJP13連接器中的配置。可以參考jakarta.apache.org/tomcat/connectors-doc/config/workers.html

conf/workers.properties 最后定義負載平衡工作者，唯一需要改變的是worker.loadbalancer.balanced_workers 設置，必須列出剛才定義的所有工作者。

sticky_session 屬性指定集群針對HTTP會話的處理方式，如果指定worker.loadbalancer.sticky_session=0，每個請求將在兩個節點中進行負載平衡。但是當一個用戶在某個節點創建一個會話時，比較好的方式是隨后的請求都導向這個節點，這被稱作"sticky session"，由于客戶總是使用會話創建的節點服務所有隨后的請求。否則用戶的會話數據必須在兩個節點進行同步，要啟用"sticky session"，必須設置 worker.loadbalancer.sticky_session 值為1。

最后必須配置集群中所有節點的JBoss Tomcat實例。

在每個節點中，我們必須根據workers.properties文件中的worker名稱來命名節點。比如，在JBoss 實例node1中，需要編輯JBOSS_HOME/server/all/deploy/jbossweb-tomcat50.sar/server.xml 文件，定位 元素添加一個jvmRoute屬性：

目前為止，已經成功配置了sticky-session方式的負載平衡，但是這種方式并不是一個完善的解決方案，因為一個節點崩潰，所有的會話數據都會丟失。更可選的解決方式是在集群的節點之間復制會話狀態，這樣客戶訪問任一個節點都會獲得同樣的會話狀態。

jboss.cache:service=TomcatClusteringCache MBean 使用 JBoss Cache提供HTTP會話狀態復制服務，這個MBean定義在deploy/tc5-cluster.sar/META-INF/jboss-service.xml 文件中。

下面是一個典型的deploy/tc5-cluster.sar/META-INF/jboss-service.xml 文件

要在你的WEB應用程序中啟用集群，必須在web.xml文件中聲明distributable。示例如下：

 

可以在jboss-web.xml文件中進一步配置會話復制，示例如下：




xml 代碼


    
<jboss-web>  
    
    <replication-config>  
    
        <replication-trigger>SET_AND_NON_PRIMITIVE_GETreplication-trigger>  
    
        <replication-granularity>SESSIONreplication-granularity>  
    
        <replication-field-batch-mode>truereplication-field-batch-mode>  
    
    replication-config>  
    
jboss-web>  

replication-trigger 元素確定什么情況觸發一次會話復制，有四個選項：

replication-granularity 元素控制復制粒度，支持的選項包括：

replication-field-batch-mode 表示是否需要在每個HTTP請求進行批量更新，缺省值為true。

如果你的會話通常比較小，SESSION選項比較適合，如果會話比較大，而且某些部分不是經常被訪問，ATTRIBUTE 選項比較適合，如果會話屬性包含大數據量的對象而且只有字段經常更改，FIELD 選項比較適合。

FIELD-level replication only replicates modified data fields inside objects stored in the session. It could potentially drastically reduce the data traffic between clustered nodes, and hence improve the performance of the whole cluster. To use FIELD-level replication, you have to first prepare your Java class to indicate which fields are to be replicated. This is done via JDK 1.4 style annotations embedded in JavaDocs:

To annotate your POJO, we provide two annotations: @@org.jboss.web.tomcat.tc5.session.AopMarker and @@org.jboss.web.tomcat.tc5.session.InstanceAopMarker. When you annotate your class with AopMarker, you indicate that instances of this class will be used in FIELD-level replication. For exmaple,

/*

* My usual comments here first.

* @@org.jboss.web.tomcat.tc5.session.AopMarker

*/

public class Address 

{

...

}

If you annotate it with InstanceAopMarker instead, then all of its sub-class will be automatically annotated as well. For example,

/*

*

* @@org.jboss.web.tomcat.tc5.session.InstanceOfAopMarker

*/

public class Person 

{

...

}

then when you have a sub-class like

public class Student extends Person

{

...

}

there will be no need to annotate Student. It will be annotated automatically because it is a sub-class of Person.

However, since we only support JDK 1.4 style annotation (provided by JBoss Aop) now, you will need to perform a pre-processing step. You need to use the JBoss AOP pre-compiler annotationc and post-compiler aopc to process the above source code before and after they are compiled by the Java compiler. Here is an example on how to invoke those commands from command line.

$ annotationc [classpath] [source files or directories]

$ javac -cp [classpath] [source files or directories]

$ aopc [classpath] [class files or directories]            

Please see the JBoss AOP documentation for the usage of the pre- and post-compiler. The JBoss AOP project also provides easy to use ANT tasks to help integrate those steps into your application build process. In the next AS release, JDK 5.0 annotation support will be provided for greater transparency. But for now, it is important that you perform the pre- and post-compilation steps for your source code.

When you deploy the web application into JBoss AS, make sure that the following configurations are correct:

Finally, let's see an example on how to use FIELD-level replication on those data classes. Notice that there is no need to call session.setAttribute() after you make changes to the data object, and all changes to the fields are automatically replicated across the cluster.