[jboss-cvs] JBossCache/docs/TreeCache/en/modules ...

[Jerry Gauthier]

  User: jerrygauth
  Date: 06/09/06 13:57:39

  Modified:    docs/TreeCache/en/modules  configuration.xml
  Log:
  JBCACHE-470
  
  Revision  Changes    Path
  1.11      +111 -75   JBossCache/docs/TreeCache/en/modules/configuration.xml
  
  (In the diff below, changes in quantity of whitespace are not shown.)
  
  Index: configuration.xml
  ===================================================================
  RCS file: /cvsroot/jboss/JBossCache/docs/TreeCache/en/modules/configuration.xml,v
  retrieving revision 1.10
  retrieving revision 1.11
  diff -u -b -r1.10 -r1.11
  --- configuration.xml	30 May 2006 18:40:24 -0000	1.10
  +++ configuration.xml	6 Sep 2006 17:57:39 -0000	1.11
  @@ -25,16 +25,12 @@
       <!-- Configure the TransactionManager -->
       <attribute name="TransactionManagerLookupClass">org.jboss.cache.DummyTransactionManagerLookup</attribute>
   
  -	<!-- 
  -			Node locking scheme : 
  -								PESSIMISTIC (default)
  +    <!--  Node locking scheme : PESSIMISTIC (default)
   								OPTIMISTIC 
   	-->
   	<attribute name="NodeLockingScheme">PESSIMISTIC</attribute>		
   
  -    <!--
  -            Node locking isolation level : 
  -								 SERIALIZABLE
  +    <!--  Node locking isolation level : SERIALIZABLE
                                    REPEATABLE_READ (default)
                                    READ_COMMITTED
                                    READ_UNCOMMITTED
  @@ -56,10 +52,21 @@
           registered to capture and display its statistics.  -->
       <attribute name="UseInterceptorMbeans">true</attribute>
   
  -    <!-- Name of cluster. Needs to be the same for all clusters, in order
  -             to find each other -->
  +    <!-- Name of cluster. Needs to be the same for all TreeCache nodes in a 
  +       cluster, in order to find each other -->
       <attribute name="ClusterName">JBoss-Cache-Cluster</attribute>
   
  +    <!-- Uncomment next three statements to enable JGroups multiplexer.
  +      This configuration is dependent on the JGroups multiplexer being
  +      registered in an MBean server such as JBossAS.  -->
  +    <!--
  +    <depends>jgroups.mux:name=Multiplexer</depends>
  +    <attribute name="MultiplexerService">jgroups.mux:name=Multiplexer</attribute>
  +    <attribute name="MultiplexerStack">fc-fast-minimalthreads</attribute>
  +    -->
  +
  +    <!-- JGroups protocol stack properties.  ClusterConfig isn't used if the 
  +      multiplexer is enabled and successfully initialized. -->
       <attribute name="ClusterConfig">
         <config>
           <!-- UDP: if you have a multihomed machine,
  @@ -76,12 +83,13 @@
           <MERGE2 min_interval="10000" max_interval="20000" />
           <FD shun="true" up_thread="true" down_thread="true" />
           <VERIFY_SUSPECT timeout="1500" up_thread="false" down_thread="false" />
  -        <pbcast.NAKACK gc_lag="50" max_xmit_size="8192" retransmit_timeout="600,1200,2400,4800" up_thread="false"
  -           down_thread="false" />
  +        <pbcast.NAKACK gc_lag="50" max_xmit_size="8192" retransmit_timeout="600,1200,2400,4800" 
  +           up_thread="false" down_thread="false" />
           <UNICAST timeout="600,1200,2400" window_size="100" min_threshold="10" down_thread="false" />
           <pbcast.STABLE desired_avg_gossip="20000" up_thread="false" down_thread="false" />
           <FRAG frag_size="8192" down_thread="false" up_thread="false" />
  -        <pbcast.GMS join_timeout="5000" join_retry_timeout="2000" shun="true" print_local_addr="true" />
  +        <pbcast.GMS join_timeout="5000" join_retry_timeout="2000" shun="true" 
  +           print_local_addr="true" />
           <pbcast.STATE_TRANSFER up_thread="false" down_thread="false" />
         </config>
       </attribute>
  @@ -256,12 +264,40 @@
   
             <row>
               <entry>
  +              <para>MultiplexerService</para>
  +            </entry>
  +
  +            <entry>
  +              <para>The name of the service that defines the JGroups multiplexer.
  +              This service is normally defined in jgroups-multiplexer.sar\META-INF\jboss-service.xml.
  +              When this attribute is defined and initialized successfully, the TreeCache cluster will
  +              use a multiplexed JGroups channel and the ClusterConfig attribute will be ignored.
  +              </para>
  +            </entry>
  +          </row>
  +          
  +         <row>
  +            <entry>
  +              <para>MultiplexerStack</para>
  +            </entry>
  +
  +            <entry>
  +              <para>The name of the JGroups stack to be used with the TreeCache cluster.
  +              Stacks are defined in jgroups-multiplexer.sar\META-INF\multiplexer-stacks.xml.
  +              The default stack is fc-fast-minimalthreads.  This attribute is used in conjunction with
  +              MultiplexerService.</para>
  +            </entry>
  +          </row>
  +          
  +          <row>
  +            <entry>
                 <para>ClusterConfig</para>
               </entry>
   
               <entry>
                 <para>The configuration of the underlying JGroups stack. See
  -              cluster-service.xml for an example.</para>
  +              cluster-service.xml for an example.  This attribute isn't used when
  +              MultiplexerService is defined.</para>
               </entry>
             </row>