svn commit - mysqldoc@docsrva: r6610 - in trunk: refman-4.1 refman-5.0 refman-5.1

[jon]

Author: jstephens
Date: 2007-05-30 20:06:40 +0200 (Wed, 30 May 2007)
New Revision: 6610

Log:

Incorporated feedback on Cluster Limitations from Calvin, Martin, and 
Hartmut.




Modified:
   trunk/refman-4.1/mysql-cluster.xml
   trunk/refman-5.0/mysql-cluster.xml
   trunk/refman-5.1/mysql-cluster.xml


Modified: trunk/refman-4.1/mysql-cluster.xml
===================================================================
--- trunk/refman-4.1/mysql-cluster.xml	2007-05-30 17:41:30 UTC (rev 6609)
+++ trunk/refman-4.1/mysql-cluster.xml	2007-05-30 18:06:40 UTC (rev 6610)
Changed blocks: 4, Lines Added: 19, Lines Deleted: 4; 1768 bytes

@@ -2977,7 +2977,7 @@
 [MYSQLD]
 HostName= mysqld_5.mysql.com
 </programlisting>
-        
+
         <para>
           Each node has its own section in the
           <filename>config.ini</filename> file. For example, this

@@ -2985,7 +2985,7 @@
           file contains two <literal>[NDBD]</literal> sections defining
           these nodes.
         </para>
-        
+
         <note>
           <para>
             Do not place comments on the same line as a section heading

@@ -17897,8 +17897,11 @@
                           <para>
                             When executing a <literal>LOAD DATA
                             INFILE</literal> statement, the
-                            <literal>NDB</literal> engine can and does
-                            commit at will.
+                            <literal>NDB</literal> engine performs
+                            commits at irregular intervals that enable
+                            better utilization of the communication
+                            network. It is not possible to know ahead of
+                            time when such commits take place.
                           </para>
                         </important>
 

@@ -18176,6 +18179,18 @@
             </formalpara>
           </listitem>
 
+          <listitem>
+            <formalpara>
+
+              <title>Replication</title>
+
+              <para>
+                Replication is not supported.
+              </para>
+
+            </formalpara>
+          </listitem>
+
         </itemizedlist>
       </para>
 


Modified: trunk/refman-5.0/mysql-cluster.xml
===================================================================
--- trunk/refman-5.0/mysql-cluster.xml	2007-05-30 17:41:30 UTC (rev 6609)
+++ trunk/refman-5.0/mysql-cluster.xml	2007-05-30 18:06:40 UTC (rev 6610)
Changed blocks: 3, Lines Added: 18, Lines Deleted: 3; 1553 bytes

@@ -2901,7 +2901,7 @@
           file contains two <literal>[NDBD]</literal> sections defining
           these nodes.
         </para>
-        
+
         <note>
           <para>
             Do not place comments on the same line as a section heading

@@ -17997,8 +17997,11 @@
                           <para>
                             When executing a <literal>LOAD DATA
                             INFILE</literal> statement, the
-                            <literal>NDB</literal> engine can and does
-                            commit at will.
+                            <literal>NDB</literal> engine performs
+                            commits at irregular intervals that enable
+                            better utilization of the communication
+                            network. It is not possible to know ahead of
+                            time when such commits take place.
                           </para>
                         </important>
 

@@ -18276,6 +18279,18 @@
             </formalpara>
           </listitem>
 
+          <listitem>
+            <formalpara>
+
+              <title>Replication</title>
+
+              <para>
+                Replication is not supported.
+              </para>
+
+            </formalpara>
+          </listitem>
+
         </itemizedlist>
       </para>
 


Modified: trunk/refman-5.1/mysql-cluster.xml
===================================================================
--- trunk/refman-5.1/mysql-cluster.xml	2007-05-30 17:41:30 UTC (rev 6609)
+++ trunk/refman-5.1/mysql-cluster.xml	2007-05-30 18:06:40 UTC (rev 6610)
Changed blocks: 5, Lines Added: 30, Lines Deleted: 21; 3654 bytes

@@ -3139,7 +3139,7 @@
 [MYSQLD]
 HostName= mysqld_5.mysql.com
 </programlisting>
-        
+
         <para>
           Each node has its own section in the
           <filename>config.ini</filename> file. For example, this

@@ -3147,7 +3147,7 @@
           file contains two <literal>[NDBD]</literal> sections defining
           these nodes.
         </para>
-        
+
         <note>
           <para>
             Do not place comments on the same line as a section heading

@@ -18095,13 +18095,13 @@
             as replication masters and slaves. However, you must
             <emphasis>not</emphasis> start any of the SQL nodes using
             <option>--log-slave-updates</option> (see the
-            <link linkend="option_mysqld_log-slave-updates">description of this
-            option</link> for more information). This type of circular
-            replication scheme for MySQL Cluster, in which the line of
-            replication (again indicated by the red arrows in the
-            diagram) is discontinuous, should be possible, but it should
-            be noted that it has not yet been thoroughly tested and must
-            therefore still be considered experimental.
+            <link linkend="option_mysqld_log-slave-updates">description
+            of this option</link> for more information). This type of
+            circular replication scheme for MySQL Cluster, in which the
+            line of replication (again indicated by the red arrows in
+            the diagram) is discontinuous, should be possible, but it
+            should be noted that it has not yet been thoroughly tested
+            and must therefore still be considered experimental.
           </para>
 
           &mccge-warning-end-cluster;

@@ -21810,18 +21810,11 @@
                           <para>
                             When executing a <literal>LOAD DATA
                             INFILE</literal> statement, the
-                            <literal>NDB</literal> engine can and does
-                            commit at will.
-
-                            <remark>
-                              What does "at will" exactly mean? Always?
-                              /SH
-
-                              <remark>
-                                [js] "Whenever it feels like it", I
-                                guess. ;) I'll ask the devs.
-                              </remark>
-                            </remark>
+                            <literal>NDB</literal> engine performs
+                            commits at irregular intervals that enable
+                            better utilization of the communication
+                            network. It is not possible to know ahead of
+                            time when such commits take place.
                           </para>
                         </important>
 

@@ -22108,6 +22101,22 @@
             </formalpara>
           </listitem>
 
+          <listitem>
+            <formalpara>
+
+              <title>Replication</title>
+
+              <para>
+                Statement-based replication is not supported. Use
+                --binlog-format=ROW (or --binlog-format=MIXED) when
+                setting up cluster replication. See
+                <xref linkend="mysql-cluster-replication"/>, for more
+                information.
+              </para>
+
+            </formalpara>
+          </listitem>
+
         </itemizedlist>
       </para>