Web Sessions Installation

hhajhh

　　　　展示不使用Terracotta DSO如何集群Web Sessions。
　　　　1、要求
　　　　　　1）jdk1.6或者更高版本
　　　　　　2）Terracotta 3.7或者更高版本
　　　　　　3）所有被集群的对象需要实现序列化，如果不想实现序列化，必须使用Terracotta DSO定制Web Sessions的安装
　　　　2、安装Terracotta Sessions jar
　　　　　　1）为保证兼容性，请使用已安装的Terracotta的jar文件
　　　　　　2）为了使应用的web Sessions在集群中共享，添加下列jar文件到应用服务器的的lib目录中



${TERRACOTTA_HOME}/sessions/terracotta-session-<version>.jar
　　　　　　${TERRACOTTA_HOME}是指Terracotta的安装目录，<version>是指当前使用的terracotta session的版本，我这里就是D:\terracotta\terracotta-3.7.2\sessions\terracotta-session-1.3.1.jar。



${TERRACOTTA_HOME}/common/terracotta-toolkit-<API-version>-runtime-ee-<version>.jar
　　　　　　The Terracotta Toolkit JAR包含了Terracotta客户端类库，<API-version> 就是指Terracotta Toolkit API version. <version>就是当前使用的Terracotta Toolkit JAR版本，我这里就是：D:\terracotta\terracotta-3.7.2\common\terracotta-toolkit-1.6-runtime-5.2.0.jar
　　3）上述session和toolkit的jar文件在各种应用服务器中的存放路径

Application ServerSuggested Location for Terracotta Sessions JAR File

JBoss AS (earlier than 6.0)
< jboss install dir>/lib


JBoss AS 6.0
< jboss install dir>/common/lib (REQUIRED)


JBoss AS 7.0 or 7.1
< jboss install dir>/WEB-INF/lib


Jetty
WEB-INF/lib


Tomcat 5.0 and 5.5
$CATALINA_HOME/server/lib


Tomcat 6.0 and 7.0
$CATALINA_HOME/lib


WebLogic
WEB-INF/lib
　　　　3、配置web-session集群
　　　　　　1）Terracotta servers和Terracotta clients通过 Terracotta配置文件运行在集群中的应用服务器上，默认的配置文件是tc-config.xml，服务器启动的时候不指定配置文件就默认使用tc-config.xml。
　　　　　　2）为了把Terracotta集群添加到我们的应用中，需要通过web.xml或者context.xml文件指定Terracotta clients如何获取配置。
　　　　　　3）Jetty, WebLogic, and WebSphere需要添加以下配置到web.xml文件中



<filter>
<filter-name>terracotta</filter-name>
<!-- The filter class is specific to the application server. -->
<filter-class>org.terracotta.session.{container-specific-class}</filter-class>
<init-param>
<param-name>tcConfigUrl</param-name>  
<!-- <init-param> of type tcConfigUrl has a <param-value> element containing the
URL or filepath (for example, /lib/tc-config.xml) to tc-config.xml.
If the Terracotta configuration source changes at a later time,
it must be updated in configuration. -->
<param-value>localhost:9510</param-value>
</init-param>
</filter>
<filter-mapping>
<!-- Must match filter name from above. -->
<filter-name>terracotta</filter-name>
<url-pattern>/*</url-pattern>
<!-- Enable all available dispatchers. -->
<dispatcher>ERROR</dispatcher> <dispatcher>INCLUDE</dispatcher>
<dispatcher>FORWARD</dispatcher>
<dispatcher>REQUEST</dispatcher>
</filter-mapping>
　　<filter-class>中的{container-specific-class}根据实际的应用服务器类型选择：

ContainerValue of <filter-class>

Jetty 6.1
org.terracotta.session.TerracottaJetty61xSessionFilter


Jetty 7.4.1
org.terracotta.session.TerracottaJetty74xSessionFilter


WebLogic 9
org.terracotta.session.TerracottaWeblogic9xSessionFilter


WebLogic 10
org.terracotta.session.TerracottaWeblogic10xSessionFilter


WebSphere 6.1
org.terracotta.session.TerracottaWebsphere61xSessionFilter


WebSphere 7.0
org.terracotta.session.TerracottaWebsphere70xSessionFilter
　　　　　　　　4）Tomcat and JBoss AS 6.0 or Earlier
　　　　　　　　　　使用war包发布的应用，如果是tomcat，确保context.xml文件在/META-INF目录下，如果是JBoss，确保context.xml文件在/WEB-INF目录下。
　　　　　　　　　　context.xml文件内容如下：



<Valve className="org.terracotta.session.{container-specific-class}" tcConfigUrl="localhost:9510"/>
　　　{container-specific-class}根据实际的应用服务器类型选择：

ContainerValue of className

JBoss Application Server 4.0
org.terracotta.session.TerracottaJboss40xSessionValve


JBoss Application Server 4.2
org.terracotta.session.TerracottaJboss42xSessionValve


JBoss Application Server 5.1
org.terracotta.session.TerracottaJboss51xSessionValve


JBoss Application Server 6.0
org.terracotta.session.TerracottaJboss60xSessionValve


Tomcat 5.0
org.terracotta.session.TerracottaTomcat50xSessionValve


Tomcat 5.5
org.terracotta.session.TerracottaTomcat55xSessionValve


Tomcat 6.0
org.terracotta.session.TerracottaTomcat60xSessionValve


Tomcat 7.0
org.terracotta.session.TerracottaTomcat70xSessionValve
　　　　　　　　　　例如在tomcat6.0中，context.xml内容如下：



<Context>
　　<Valve className="org.terracotta.session.TerracottaTomcat60xSessionValve" tcConfigUrl="localhost:9510"/>
</Context>
　　　　　　　　　　确保Terracotta Value是context.xml文件中的第一个<Value>元素。
　　　　　　　　　　如果在tomcat中使用了authenticator，在Terracotta集群运行的时候有可能会遇到UnsupportedOperationException，在tomcat5.5以上可以禁用changeSessionIdOnAuthentication来防止这种错误：



<Valve changeSessionIdOnAuthentication="false" className="org.apache.catalina.authenticator.BasicAuthenticator"/>
　　　　  5）JBoss7.0 or 7.1　　
　　　　　　　　添加以下内容到WEB-INF/jboss-web.xml中



<?xml version="1.0" encoding="UTF-8"?>
<jboss-web>
...  
<valve>
<class-name>org.terracotta.session.TerracottaJboss7xSessionValve</class-name>      
<param>
<param-name>tcConfigUrl</param-name>
        <param-value>localhost:9510</param-value>
</param>
</valve>
...
</jboss-web>
　　
　　　　4、启动集群
　　　　　　1）启动 Terracotta server:
　　　　　　　　UNIX/Linux



${TERRACOTTA_HOME}/bin/start-tc-server.sh &
　　　　　　　　Microsoft Windows



${TERRACOTTA_HOME}\bin\start-tc-server.bat
　　　　2）启动应用服务器
　　　　　　3）启动Terracotta 控制台
　　UNIX/Linux



${TERRACOTTA_HOME}/bin/dev-console.sh &
　　Microsoft Windows



${TERRACOTTA_HOME}\bin\dev-console.bat
　　4）启动控制台后，可以看到集群中Terracotta Server和客户端
　　　5、Terracotta配置
　　　　　　这里配置展示如何在分开的机器上运行服务器和客户端，增加容灾（高可用性），扩展集群和添加高可用性可以按照下面的步骤：　

• Moving the Terracotta server to its own machine
  
• Creating a cluster with multiple Terracotta servers
  
• Creating multiple application nodes
  

　　　　　　1）关闭Terracotta Cluster
　　　　　　2）创建Terracotta配置文件tc-config.xml：



<tc:tc-config>
<servers>
<!-- Sets where the Terracotta server can be found. Replace the value of
host with the server's IP address. -->
<server host="server.1.ip.address" name="Server1">
　　<data>%(user.home)/terracotta/server-data</data>
　　<logs>%(user.home)/terracotta/server-logs</logs>
</server>
<!-- If using a standby Terracotta server,
also referred to as an ACTIVE-PASSIVE configuration,
add the second server here. -->
<server host="server.2.ip.address" name="Server2">
　　 <data>%(user.home)/terracotta/server-data</data>
　　 <logs>%(user.home)/terracotta/server-logs</logs>
</server>
<!-- If using more than one server, add an <ha> section. -->
<ha>
　　 <mode>networked-active-passive</mode>
　　 <networked-active-passive>
　　　　<election-time>5</election-time>
　　</networked-active-passive>
</ha>
</servers>
<!-- Sets where the generated client logs are saved on clients. -->
<clients>
<logs>%(user.home)/terracotta/client-logs</logs>
</clients>
</tc:tc-config>
　　　3）在tc-config.xml中配置的每一台服务器机器上安装terracotta3.7.2
　　　　　　4）把tc-config.xml文件复制到每一台服务器中的terracotta Server可以访问的位置
　　　　　　5）在每一台服务器中按照上面步骤（2、安装Terracotta Sessions jar）安装Terracotta Sessions jar
　　　　　　6）在每一台应用服务器中配置web.xml或者context.xml
　　　　　　　　如果使用的是web.xml，按如下配置：



<param-value>server.1.ip.address:9510,server.2.ip.address:9510</param-value>
　　　　　　　　如果使用的是context.xml，按如下配置：



tcConfigUrl="server.1.ip.address:9510,server.2.ip.address:9510"
　　　　　　　　tc-config.xml中配置了多少台服务器，web.xml或者context.xml就要配置多少。
　　　　7）启动Terracotta Server
　　　　　　UNIX/Linux



${TERRACOTTA_HOME}/bin/start-tc-server.sh -f <path/to/tc-config.xml> -n Server1 &
　　　　　　Microsoft Windows



${TERRACOTTA_HOME}\bin\start-tc-server.bat -f <path\to\tc-config.xml> -n Server1
　　　　　　${TERRACOTTA_HOME}是指terracotta的安装目录
　　　　　　<path/to/tc-config.xml>是指tc-config.xml文件的完整存放路径
　　　　　　Server1是指在tc-config.xml文件中配置的ServerName
　　　　　　在每一台服务器上启动各自的Terracotta Server，注意启动的时候 -n 指定各自的ServerName，第二台和往后启动的Terracotta Server处于备用状态。
　　　　　　8）在每一台服务器上启动各自的应用服务器
　　　　　　9）启动Terracotta控制台查看集群