[jboss-cvs] JBossAS SVN: r94319 - projects/docs/community/5/Performance_Tuning_Guide/en-US.

[jboss-cvs-commits at lists.jboss.org]

Author: bstansberry at jboss.com
Date: 2009-10-04 17:48:33 -0400 (Sun, 04 Oct 2009)
New Revision: 94319

Modified:
   projects/docs/community/5/Performance_Tuning_Guide/en-US/Performance_Tuning_Guide.xml
Log:
[JBAS-6299] Add buddy replication

Modified: projects/docs/community/5/Performance_Tuning_Guide/en-US/Performance_Tuning_Guide.xml
===================================================================
--- projects/docs/community/5/Performance_Tuning_Guide/en-US/Performance_Tuning_Guide.xml	2009-10-04 21:38:57 UTC (rev 94318)
+++ projects/docs/community/5/Performance_Tuning_Guide/en-US/Performance_Tuning_Guide.xml	2009-10-04 21:48:33 UTC (rev 94319)
@@ -441,6 +441,40 @@
         This means additional sockets will be opened compared to a standard Enterprise Application Platform installation.</para>
       </note>
       </section>
+      
+      <section>
+         <title>Enabling Buddy Replication for Session Caches</title>
+         <para>If your application involves high volume replication of web sessions or EJB3 stateful session beans in a cluster
+         of more than two nodes, you can improve performance by enabling "buddy replication" in the web session and stateful 
+         session bean caches. With buddy replication, instead of replicating a copy of sessions to all nodes in the cluster,
+         a copy is only replicated to a configurable number of "buddy" nodes.
+         </para>
+         
+         <para>Buddy replication is enabled done by editing the 
+         <literal>&lt;JBoss_Home&gt;/server/&lt;your_configuration&gt;/deploy/cluster/jboss-cache-manager.sar/META-INF/jboss-cache-jboss-beans.xml</literal> file. For example, for the cache used by default for
+         web sessions:</para>
+         
+         <programlisting><![CDATA[. . .
+      
+<!-- Standard cache used for web sessions -->
+<entry><key>standard-session-cache</key>
+<value>      
+   <bean name="StandardSessionCacheConfig" class="org.jboss.cache.config.Configuration">
+      
+      . . . 
+      
+      <property name="buddyReplicationConfig">
+         <bean class="org.jboss.cache.config.BuddyReplicationConfig">
+               
+            <!--  Just set to true to turn on buddy replication -->
+            <property name="enabled">true</property>
+      
+      . . .]]></programlisting>
+      
+      <para>For FIELD granularity web sessions, in the same file the same change can be made to the cache configuration with the <literal>field-granularity-session-cache</literal> key.
+      For EJB3 stateful session beans, in the same file the same change can be made to the cache configuration with the <literal>sfsb-cache</literal> key.</para>
+            
+      </section>
      
       <section>
          <title>Reducing the Volume of Web Session Replication</title>