svn commit - mysqldoc@docsrva: r3614 - in trunk/refman-5.1: . images

[jon]

Author: jstephens
Date: 2006-10-12 09:07:10 +0200 (Thu, 12 Oct 2006)
New Revision: 3614

Log:

Cluster filesystems draft - edits + new diagram.



Added:
   trunk/refman-5.1/images/disk-data-files.png
Modified:
   trunk/refman-5.1/mysql-cluster-filesystems.xml

Property changes on: trunk/refman-5.1/images/disk-data-files.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream


Added: trunk/refman-5.1/images/disk-data-files.png
===================================================================


Changed blocks: 0, Lines Added: 0, Lines Deleted: 0; 317 bytes


Modified: trunk/refman-5.1/mysql-cluster-filesystems.xml
===================================================================
--- trunk/refman-5.1/mysql-cluster-filesystems.xml	2006-10-11 22:41:12 UTC (rev 3613)
+++ trunk/refman-5.1/mysql-cluster-filesystems.xml	2006-10-12 07:07:10 UTC (rev 3614)
Changed blocks: 7, Lines Added: 46, Lines Deleted: 21; 4470 bytes

@@ -1,5 +1,14 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE section SYSTEM "http://www.docbook.org/xml/4.4/docbookx.dtd">
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
+[
+  <!ENTITY % fixedchars.entities  SYSTEM "../refman-common/fixedchars.ent">
+  %fixedchars.entities;
+  <!ENTITY % urls.entities       SYSTEM "../refman-common/urls.ent">
+  %urls.entities;
+  <!ENTITY % versions.entities    SYSTEM "versions.ent">
+  %versions.entities;
+]>
 <section id="mysql-cluster-filesystems">
 
   <title>MySQL Cluster Filesystems</title>

@@ -68,7 +77,8 @@
           </para>
 
           <para>
-            Logs all signals sent to or from the data node.
+            This file contains a log of all signals sent to or from the
+            data node.
           </para>
         </listitem>
 

@@ -78,16 +88,17 @@
           </para>
 
           <para>
-            Contains the data node's process ID.
+            This file contains the data node's process ID; it is created
+            when the <command>ndbd</command> process is started.
           </para>
         </listitem>
 
       </itemizedlist>
-      
+
       <para>
         The location of these files is determined by the value of the
-        <literal>DataDir</literal> configuration parameter. See 
-        <link
linkend="mysql-cluster-param-mgm-definition-datadir"><literal>DataDir</literal></link>.
+        <literal>DataDir</literal> configuration parameter. See
+        <link
linkend="mysql-cluster-param-ndbd-definition-datadir"><literal>DataDir</literal></link>.
       </para>
 
     </section>

@@ -252,13 +263,13 @@
       <para>
         MySQL Cluster creates backup files in the directory specified by
         the <literal>BackupDataDir</literal> configuration parameter, as
-        discussed in 
+        discussed in
         <xref linkend="mysql-cluster-backup-using-management-client"/>,
-        and 
-        <link linkend="mysql-cluster-identifying-data-nodes">Identifying  
+        and
+        <link linkend="mysql-cluster-identifying-data-nodes">Identifying
         Data Nodes</link>.
       </para>
-      
+
       <para>
         The files created when a backup is performed are listed and
         described in <xref linkend="mysql-cluster-backup-concepts"/>.

@@ -273,19 +284,20 @@
       <remark role="note">
         [js] This section applies to 5.1 only.
       </remark>
-      
+
       <para>
-        MySQL Cluster Disk Data files include: 
+        MySQL Cluster Disk Data files include:
       </para>
-      
+
       <itemizedlist>
+
         <listitem>
           <para>
             One or more <firstterm>undo logfiles</firstterm> associated
             with a <firstterm>logfile group</firstterm>
           </para>
         </listitem>
-        
+
         <listitem>
           <para>
             One or more <firstterm>datafiles</firstterm> associated with

@@ -293,19 +305,29 @@
             group for undo logging
           </para>
         </listitem>
+
       </itemizedlist>
-      
+
       <para>
         Both undo logfiles and datafiles files are created in the data
         directory (<literal>DataDir</literal>) of each cluster data
         node. The relationship of these files with their logfile group
-        and tablespace are shown in the following diagram: 
+        and tablespace are shown in the following diagram:
       </para>
-      
-      
 
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/disk-data-files.png" format="PNG"/>
+        </imageobject>
+        <textobject>
+          <phrase lang="en">MySQL Cluster Disk Data Files (Tablespace,
+          Datafiles; Logfile Group, Undo Files)</phrase>
+        </textobject>
+      </mediaobject>
+
       <para>
-        Disk Data files are discussed 
+        Disk Data files are discussed in depth in
+        <xref linkend="mysql-cluster-disk-data"/>.
       </para>
 
     </section>

@@ -316,7 +338,10 @@
 
     <title>Cluster Management Node Filesystem</title>
 
-    <para></para>
+    <para>
+      The files used by a MySQL Cluster management node are discussed in
+      <xref linkend="mysql-cluster-ndb-mgmd-process"/>.
+    </para>
 
   </section>