[jboss-cvs] JBoss Messaging SVN: r3837 - branches/Branch_Stable/docs/userguide/en/modules.

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

Author: timfox
Date: 2008-03-03 15:20:25 -0500 (Mon, 03 Mar 2008)
New Revision: 3837

Modified:
   branches/Branch_Stable/docs/userguide/en/modules/configuration.xml
Log:
http://jira.jboss.org/jira/browse/JBMESSAGING-1241


Modified: branches/Branch_Stable/docs/userguide/en/modules/configuration.xml
===================================================================
--- branches/Branch_Stable/docs/userguide/en/modules/configuration.xml	2008-03-03 20:06:48 UTC (rev 3836)
+++ branches/Branch_Stable/docs/userguide/en/modules/configuration.xml	2008-03-03 20:20:25 UTC (rev 3837)
@@ -687,6 +687,16 @@
                         
       <attribute name="CreateTablesOnStartup">true</attribute>
       
+      
+      <!-- If true then we will automatically detect and reject duplicate messages sent during failover -->
+      
+      <attribute name="DetectDuplicates">true</attribute>
+      
+      <!-- The size of the id cache to use when detecting duplicate messages -->
+      
+      <attribute name="IDCacheSize">500</attribute>
+      
+      
       <attribute name="SqlProperties"><![CDATA[
 CREATE_POSTOFFICE_TABLE=CREATE TABLE JBM_POSTOFFICE (POSTOFFICE_NAME VARCHAR(255), NODE_ID INTEGER, QUEUE_NAME VARCHAR(255), COND VARCHAR(1023), SELECTOR VARCHAR(1023), CHANNEL_ID BIGINT, CLUSTERED CHAR(1), ALL_NODES CHAR(1), PRIMARY KEY(POSTOFFICE_NAME, NODE_ID, QUEUE_NAME)) ENGINE = INNODB
 INSERT_BINDING=INSERT INTO JBM_POSTOFFICE (POSTOFFICE_NAME, NODE_ID, QUEUE_NAME, COND, SELECTOR, CHANNEL_ID, CLUSTERED, ALL_NODES) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
@@ -841,7 +851,32 @@
         <para>By default the value of <literal>CreateTablesOnStartup</literal>
         attribute is set to <literal>true</literal></para>
       </section>
+      
+      <section id="conf.postoffice.attributes.detectdups">
+	<title>DetectDuplicates</title>
+	
+	<para>Set this to <literal>true</literal> if you wish the post office detect duplicate messages
+		that may sent when a send is retried on a different node after server failure.
+	</para>
+	
+	<para>By default the value of <literal>DetectDuplicates</literal>
+		attribute is set to <literal>true</literal></para>
+      </section>            
+      
+      <section id="conf.postoffice.attributes.idcachesize">
+	<title>IDCacheSize</title>
+	      
+	<para>If duplicate detection is enabled. (See <literal>DetectDuplicates</literal>), then the server will rememeber the last
+	<literal>n</literal> message ids
+	sent, to prevent duplicate messages sent after failover has occurred. The value of <literal>n</literal> is determined by this attribute.
+	</para>
+	      
+	<para>By default the value of <literal>IDCacheSize</literal>
+         attribute is set to <literal>500</literal></para>
+      </section>  
+      
 
+
       <section id="conf.postoffice.attributes.postofficename">
         <title>PostOfficeName</title>