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.0 | jon.stephens | 19 Oct |
