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

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

Author: gaohoward
Date: 2010-07-01 05:02:41 -0400 (Thu, 01 Jul 2010)
New Revision: 8064

Modified:
   branches/Branch_1_4/docs/userguide/en/modules/configuration.xml
Log:
JBMESSAGING-1788


Modified: branches/Branch_1_4/docs/userguide/en/modules/configuration.xml
===================================================================
--- branches/Branch_1_4/docs/userguide/en/modules/configuration.xml	2010-06-25 15:39:54 UTC (rev 8063)
+++ branches/Branch_1_4/docs/userguide/en/modules/configuration.xml	2010-07-01 09:02:41 UTC (rev 8064)
@@ -625,6 +625,29 @@
     you need to update all the <literal>DataSource</literal> attribute in the
     persistence configuration file. Example data source configurations for
     each of the popular databases are available in the distribution.</para>
+
+    <warning>
+      <para>JBoss Messaging fully supports XA transactional resource interface. This
+        enables JBoss Messaging to be enlisted in a global transaction. However, this functionality
+        has nothing to do with the datasources it uses for persistence. In other words, JBoss 
+        Messaging does not use, and should not use, an XA database datasource for its persistence.
+        That means the configuration of the datasource to which JBoss Messaging references in its
+        persistence configuration file must be one defined in &lt;local-tx-datasource&gt; entry in the datasource
+        configuration file. For example </para>
+<programlisting>
+&lt;datasources&gt;
+  &lt;local-tx-datasource&gt;
+    &lt;jndi-name&gt;DefaultDS&lt;/jndi-name&gt;
+    &lt;connection-url&gt;jdbc:mysql://localhost:3306/messaging&lt;/connection-url&gt;
+    &lt;driver-class&gt;com.mysql.jdbc.Driver&lt;/driver-class&gt;
+    &lt;user-name&gt;sa&lt;/user-name&gt;
+    &lt;password&gt;&lt;/password&gt;
+    ... ...
+  &lt;/local-tx-datasource&gt;
+&lt;/datasources&gt;
+</programlisting>
+    </warning>
+
   </section>
 
   <section id="conf.postoffice">