List:Commits« Previous MessageNext Message »
From:jon.stephens Date:October 19 2010 9:24am
Subject:svn commit - mysqldoc@docsrva: r23212 - trunk/cluster-manager-1.0
View as plain text  
Author: jstephens
Date: 2010-10-19 11:24:54 +0200 (Tue, 19 Oct 2010)
New Revision: 23212

Log:

Fixes Docs BUG#57160



Modified:
   trunk/cluster-manager-1.0/mcm-install.xml


Modified: trunk/cluster-manager-1.0/mcm-install.xml
===================================================================
--- trunk/cluster-manager-1.0/mcm-install.xml	2010-10-18 23:35:06 UTC (rev 23211)
+++ trunk/cluster-manager-1.0/mcm-install.xml	2010-10-19 09:24:54 UTC (rev 23212)
Changed blocks: 2, Lines Added: 36, Lines Deleted: 3; 2640 bytes

@@ -469,9 +469,12 @@
             <entry>A valid absolute path to an existing directory</entry>
             <entry>Default: <literal>manager</literal> (you <emphasis>must</emphasis>
               modify or replace this value)</entry>
-            <entry>The <replaceable>manager</replaceable> directory contains &mcm; data
-              files and MySQL Cluster configuration and data files. More
-              information about these is provided later in this section.</entry>
+            <entry>The <replaceable>manager</replaceable> directory contains collections of
+              &mcm; data files and MySQL Cluster configuration and data
+              files; such a collection is also referred to as an
+              <firstterm>agent repository</firstterm>. More information
+              about repositories and these files is provided later in
+              this section.</entry>
           </row>
           <row>
             <entry><literal>license-user-file</literal></entry>

@@ -522,6 +525,36 @@
 
     </formalpara>
 
+    <formalpara>
+
+      <title>&mcm; agent repositories (<literal>manager-directory</literal>)</title>
+
+      <para>
+        The <literal>manager-directory</literal> contains &mcm; data
+        files as well as a <filename>rep</filename> directory in MySQL
+        Cluster data files for each MySQL Cluster under &mcm; control
+        are kept. Normally, there is no need to interact with these
+        directories beyond specifying the location of the
+        <literal>manager-directory</literal> in the agent configuration
+        file (<filename>mysql-cluster-manager.ini</filename>). However,
+        in the event that an agent reaches an inconsistent state, it is
+        possible to delete the contents of the <filename>rep</filename>
+        directory, in which case the agent attempts to recover its
+        repository from another agent.
+      </para>
+
+    </formalpara>
+
+    <important>
+      <para>
+        In such cases, you must also delete the checksum file
+        <filename>repchksum</filename> from the
+        <literal>manager-directory</literal>. Otherwise, the agent reads
+        the this file and raises a checksum error due to the now-empty
+        <filename>rep</filename> directory.
+      </para>
+    </important>
+
     <para>
       A minimal agent configuration file as used in production might
       look like this:


Thread
svn commit - mysqldoc@docsrva: r23212 - trunk/cluster-manager-1.0jon.stephens19 Oct