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

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

Author: timfox
Date: 2008-03-03 15:28:10 -0500 (Mon, 03 Mar 2008)
New Revision: 3838

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


Modified: branches/Branch_JBossMessaging_1_4_0_SP3_CP/docs/userguide/en/modules/configuration.xml
===================================================================
--- branches/Branch_JBossMessaging_1_4_0_SP3_CP/docs/userguide/en/modules/configuration.xml	2008-03-03 20:20:25 UTC (rev 3837)
+++ branches/Branch_JBossMessaging_1_4_0_SP3_CP/docs/userguide/en/modules/configuration.xml	2008-03-03 20:28:10 UTC (rev 3838)
@@ -522,6 +522,14 @@
                         
       <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 (?, ?, ?, ?, ?, ?, ?, ?)
@@ -670,6 +678,25 @@
             <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>
             <para>The name of the post office.</para>