Terracotta 简介;
Terracotta 是一款由美国 Terracotta 公司开发的著名开源 Java 集群平台。它在 JVM 与 Java 应用之间实现了一个专门处理集群功能的抽象层,以其特有的增量检测、智能定向传送、分布式协作、服务器镜像、分片等技术,允许用户在不改变现有系统代码的情况下实现单机 Java 应用向集群话应用的无缝迁移。使得用户可以专注于商业逻辑的开发,由 Terracotta 负责实现高性能、高可用性、高稳定性的企业级 Java 集群. Terracotta 公司在 2009 年收购了著名的 Java 开源缓存项目 Ehcache 以及 Java 任务调度项目 Quartz 。经过对该项目的深度整合, Terracotta 推出了易用性更高的分布式缓存、分布式任务调度以及分布式 Web Session 等快捷解决方案.以上引自老马的文章,具体可参加作者博客了解http://lima01.iteye.com/。
配置环境:
我的配置环境是:winxp,jdk1.5—17,spring2.5,hibernate3.3,tomcat5.5, terracotta版本是3.2.1_1,目前最新版本是3.2.1_2,可在http://www.terracotta.org/dl/oss-download-catalog下载。
实战:
首先需要说明的是 terracotta分为express mode(快捷模式)和客户化模式, express mode能够让大家快速上手,不需要复杂的配置就可运行起来,而 客户化模式则有很多高级功能,而且需要配置相应的文件,初学可以先运行 express mode作为学习。
首先以 express mode模式为例说明
1.首先下载 terracotta 3.2.1_1。jar,前提是机器已经安装jdk及配置好了java_home,利用java -jar terracotta 3.2.1_1。jar命令安装 terracotta ,安装时最好保持jdk及 terracotta 安装目录名称都没有空格。
2.首先集成session复制,将terracotta安装目录下的 sessions文件夹下的 terracotta-session-1.0.1.jar 拷贝到tomcat-5.5\server\lib文件夹下,然后
将 context.xml 文件(此文件可参见安装目录下的sessions\conf-samples的例子文件)拷贝到我们自己项目的 META-INF 文件夹下,具体内容根据使用的不同中间件进行不同配置,一下是使用tomcat5.5的配置,其他的也可看光放文档说明http://www.terracotta.org/documentation/ga/product-documentation
例如:
<Context>
<Valve className="org.terracotta.session.TerracottaTomcat55xSessionValve" tcConfigUrl="localhost:9510"/>
</Context>
<!-- tomcat 5.5.x -->
将我们的web工程发布到webapps下,启动tomcat5.5/bin/下的startup.bat即可,然后到Terracotta Console控制台查看object brower下是否出现tc:session。也可运行 terracotta自带的例子,位于安装目录下的sessions\samples\下,验证时客气起双tomcat分配不同的端口号,打开两个浏览器窗口进行验证。
客户化模式的session复制可参见老马博客文章。
2.集成hibernate二级缓存
集成的时候需要注意将 将安装后的 terracotta 文件夹下的 ehcache-core-2.0.1.jar 、 ehcache-terracotta-2.0.1.jar 、 slf4j-api-1.5.8.jar 、 slf4j-jdk14-1.5.8.jar 等文件拷贝到项目的 lib 文件夹下,配置hibernate属性
<prop key="hibernate.cache.use_query_cache">true</prop>
<prop key="hibernate.cache.use_second_level_cache">true</prop>
<prop key="
hibernate.cache.provider_class">org.hibernate.cache.EhCacheProvider</prop>
加粗部分根据使用的hibernate不同版本配置,在hibernate3.3中就需要配置为
<property name = "hibernate.cache.region.factory_class" > net.sf.ehcache.hibernate.EhCacheRegionFactory </property>
For Hibernate 3.2则是上面加粗部分配置。
ehcache.xml文件的配置为大致如下:
< defaultCache
maxElementsInMemory = "10"
eternal = "false"
timeToIdleSeconds = "120"
timeToLiveSeconds = "120"
>
< terracotta />
</ defaultCache >
< terracottaConfig url = "localhost:9510" />
需要注意的是快捷模式下无法使用 valueMode="identity" 模式
具体可根据需要进行扩展。下面要讲述的客户化模式配置会有很大却别。
以上是express模式的大致配置。下面记录客户化模式
3.客户化模式下的session复制及缓存
快捷模式不需要 tc-config 。 Xml 文件的支持,直接启动 start-tc-server 。 Bat (win下)就可以,而客户化模式需要在 tc-config . Xml 文件中进行配置。
验证session复制的时候就不需要惊醒context。xml的配置及terracotta-session-1.0.1.jar的拷贝,一切都在 tc-config . Xml配置文件中配置大致配置如下:
<servers>
<!-- For more information on working with the Terracotta configuration file, including how to add
more servers, see http://www.terracotta.org/web/display/docs/About+Terracotta+Configuration+Files.
Edit the following server element so that its host attribute contains the value matching the
hostname for the Terracotta server. -->
<server host="localhost">
<data>data/server-data</data>
<logs>logs/server-logs</logs>
<l2-group-port>9530</l2-group-port>
<dso>
<persistence>
<mode>permanent-store</mode>
</persistence>
</dso>
</server>
<update-check>
<enabled>true</enabled>
</update-check>
</servers>
<!-- Check that the TIM shown in the <module> element's name attribute matches the Tomcat version you
are using. The TIM listed here, "tim-tomcat-5.5" is for Tomcat 5.5. For example, if you are using
Tomcat 6.0, edit the name to "tim-tomcat-6.0". -->
<clients>
<modules>
<module name="tim-tomcat-5.5" version="2.1.2" />
<module name="tim-tomcat-common" version="2.1.2" />
<module name="tim-session-common" version="2.1.2" />
<module name="tim-ehcache-2.0" version="1.5.2" />
<module name="tim-concurrent-collections" version="1.3.2" />
<module name="tim-distributed-cache" version="1.3.2" />
<module name="tim-svt" version="1.3.2" />
<module name="tim-quartz-1.7" version="1.3.2" />
<module name="tim-async-processing" version="1.3.2" />
<module name="tim-annotations" version="1.5.1" />
</modules>
</clients>
<!-- Using <web-application> elements, enter the context root of the web application being clustered.
If you are clustering more than one web application, use one <web-application> element per application.
Two example <web-application> elements are shown below. Edit or remove these elements as needed.
To set the value of the <web-application> element to the default web-application context, use the
special value "ROOT" (without quotation marks). -->
<application>
<dso>
<additional-boot-jar-classes>
<include>java.util.Locale</include>
<include>java.lang.String$Case
<instrumented-classes>
<include>
<class-expression>org.acegisecurity.captcha.CaptchaSecurityContextImpl</class-expression>
</include>
</instrumented-classes>
<web-applications>
<web-application >myapplication</web-application>
</web-applications>
</dso>
</application>
</tc:tc-config>
首先前提是通过已经通过 tim-get.bat install 命令安装了相应的 tim jar 文件。
在 <instrumented-classes>
<include>
<class-expression>org.acegisecurity.captcha.CaptchaSecurityContextImpl</class-expression>
</include>
中配置需要在 terracotta 中共享的类,
一般在如果使用了 hibernate 情况下, test.hbm.xml 文件中 many-to-one 关系对应的 class = "com.test.oa.domain.BaAt" 都需要在 <include> 中配置,不然启动中间件时会报错,控制台也会提示您需要 include 相应的类,
这里如果使用的 acegi 安全框架,目前 terracotta1 版本只能在客户化模式下配置,不能使用 express 模式。
<web-applications>
<web-application >myWebApplication</web-application>
</web-applications>
配置相应的 web 工程.
如果集成 ehcache 时,还需要将 tim-ehcache-2.0-1.5.2.jar 、 tim-distributed-cache-1.3.2.jar 、 tim-concurrent-collections-1.3.2.jar 、等拷贝到项目的 lib 下( express 模式不需要拷贝),可参看官方文档说明。
客户化模式的启动需要 startupTC.bat 的支持,还是以 tomcat 为例,在 tomcat 的 bin 目录下建立 startupTC.bat 内容如下:
set TC_INSTALL_DIR=D:\terracotta(安装目录)
set TC_CONFIG_PATH=D:\terracotta\bin\tc-config.xml(安装目录下的自建配置文件)
call %TC_INSTALL_DIR%\bin\dso-env.bat -q
set JAVA_OPTS=%JAVA_OPTS% %TC_JAVA_OPTS% -Xms256m -Xmx1024m -XX:MaxPermSize=128m
pause
startup.bat
红色部分很重要。
客户化模式还需要根据 tc-config 。 Xml 重新生成 boot.jar ,位置在 terracotta\lib\dso-boot 下
常用命令如下:
tim-get.bat upgrade tc-config.xml
make-boot-jar.bat -f tc-config.xml
start-tc-server.bat -n jerry -f D:\terracotta\bin\tc-config.xml
多server时需要启动服务端时指定name名称,如上所示,配置多server时刻以很容易实现容灾数据备份等, 一个 server down 了,另一个 server 可无感知切换至激活状态
启动 startupTC.bat后进入 terracotta控制台查看效果,如附件所示。
以上大致写了一些,以作备忘。