Author: jstephens
Date: 2007-01-26 14:27:16 +0100 (Fri, 26 Jan 2007)
New Revision: 4655
Log:
Clarified ndb_restore vs single user mode (MikeK)
Clarified # of times ndb_restore must be run.
Modified:
branches/telcos/refman-5.1/mysql-cluster.xml
trunk/refman-4.1/mysql-cluster.xml
trunk/refman-5.0/mysql-cluster.xml
trunk/refman-5.1/mysql-cluster.xml
Modified: branches/telcos/refman-5.1/mysql-cluster.xml
===================================================================
--- branches/telcos/refman-5.1/mysql-cluster.xml 2007-01-26 12:49:00 UTC (rev 4654)
+++ branches/telcos/refman-5.1/mysql-cluster.xml 2007-01-26 13:27:16 UTC (rev 4655)
Changed blocks: 2, Lines Added: 19, Lines Deleted: 8; 2342 bytes
@@ -12577,17 +12577,26 @@
<indexterm>
<primary><command>ndb_restore</command></primary>
</indexterm>
-
+
<para>
The cluster restoration program is implemented as a separate
command-line utility <command>ndb_restore</command>, which can
normally be found in the MySQL <filename>bin</filename>
directory. This program reads the files created as a result of
the backup and inserts the stored information into the database.
- <command>ndb_restore</command> must be executed once for each
- set of backup files — that is, once for each data node in
- the cluster at the time that the backup was created.
</para>
+
+ <para>
+ <command>ndb_restore</command> must be executed
+ <literal><replaceable>N</replaceable> + 1</literal> times, where
+ <replaceable>N</replaceable> is the number of backup files that
+ were created by the <literal>START BACKUP</literal> command used
+ to create the backup (see
+ <xref linkend="mysql-cluster-backup-using-management-client"/>).
+ This is equal to once for restoring cluster metadata such as
+ table schemas, plus once for each data node in the cluster at
+ the time that the backup was created.
+ </para>
<indexterm>
<primary>single user mode (MySQL Cluster)</primary>
@@ -12595,10 +12604,12 @@
</indexterm>
<para>
- <emphasis role="bold">Important</emphasis>: In order to use
- <command>ndb_restore</command>, the cluster must be running in
- single user mode. See
- <xref linkend="mysql-cluster-single-user-mode"/>.
+ <emphasis role="bold">Note</emphasis>: Before using
+ <command>ndb_restore</command>, it is recommended that the
+ cluster be running in single user mode, unless you are restoring
+ multiple data nodes in parallel. See
+ <xref linkend="mysql-cluster-single-user-mode"/>, for more
+ information about single user mode.
</para>
<para>
Modified: trunk/refman-4.1/mysql-cluster.xml
===================================================================
--- trunk/refman-4.1/mysql-cluster.xml 2007-01-26 12:49:00 UTC (rev 4654)
+++ trunk/refman-4.1/mysql-cluster.xml 2007-01-26 13:27:16 UTC (rev 4655)
Changed blocks: 1, Lines Added: 20, Lines Deleted: 9; 2360 bytes
@@ -12355,28 +12355,39 @@
<indexterm>
<primary><command>ndb_restore</command></primary>
</indexterm>
-
+
<para>
The cluster restoration program is implemented as a separate
command-line utility <command>ndb_restore</command>, which can
normally be found in the MySQL <filename>bin</filename>
directory. This program reads the files created as a result of
the backup and inserts the stored information into the database.
- <command>ndb_restore</command> must be executed once for each
- set of backup files — that is, once for each data node in
- the cluster at the time that the backup was created.
</para>
+
+ <para>
+ <command>ndb_restore</command> must be executed
+ <literal><replaceable>N</replaceable> + 1</literal> times, where
+ <replaceable>N</replaceable> is the number of backup files that
+ were created by the <literal>START BACKUP</literal> command used
+ to create the backup (see
+ <xref linkend="mysql-cluster-backup-using-management-client"/>).
+ This is equal to once for restoring cluster metadata such as
+ table schemas, plus once for each data node in the cluster at
+ the time that the backup was created.
+ </para>
<indexterm>
<primary>single user mode (MySQL Cluster)</primary>
<secondary>and <command>ndb_restore</command></secondary>
</indexterm>
-
+
<para>
- <emphasis role="bold">Important</emphasis>: In order to use
- <command>ndb_restore</command>, the cluster must be running in
- single user mode. See
- <xref linkend="mysql-cluster-single-user-mode"/>.
+ <emphasis role="bold">Note</emphasis>: Before using
+ <command>ndb_restore</command>, it is recommended that the
+ cluster be running in single user mode, unless you are restoring
+ multiple data nodes in parallel. See
+ <xref linkend="mysql-cluster-single-user-mode"/>, for more
+ information about single user mode.
</para>
<para>
Modified: trunk/refman-5.0/mysql-cluster.xml
===================================================================
--- trunk/refman-5.0/mysql-cluster.xml 2007-01-26 12:49:00 UTC (rev 4654)
+++ trunk/refman-5.0/mysql-cluster.xml 2007-01-26 13:27:16 UTC (rev 4655)
Changed blocks: 1, Lines Added: 20, Lines Deleted: 9; 2360 bytes
@@ -12468,28 +12468,39 @@
<indexterm>
<primary><command>ndb_restore</command></primary>
</indexterm>
-
+
<para>
The cluster restoration program is implemented as a separate
command-line utility <command>ndb_restore</command>, which can
normally be found in the MySQL <filename>bin</filename>
directory. This program reads the files created as a result of
the backup and inserts the stored information into the database.
- <command>ndb_restore</command> must be executed once for each
- set of backup files — that is, once for each data node in
- the cluster at the time that the backup was created.
</para>
+
+ <para>
+ <command>ndb_restore</command> must be executed
+ <literal><replaceable>N</replaceable> + 1</literal> times, where
+ <replaceable>N</replaceable> is the number of backup files that
+ were created by the <literal>START BACKUP</literal> command used
+ to create the backup (see
+ <xref linkend="mysql-cluster-backup-using-management-client"/>).
+ This is equal to once for restoring cluster metadata such as
+ table schemas, plus once for each data node in the cluster at
+ the time that the backup was created.
+ </para>
<indexterm>
<primary>single user mode (MySQL Cluster)</primary>
<secondary>and <command>ndb_restore</command></secondary>
</indexterm>
-
+
<para>
- <emphasis role="bold">Important</emphasis>: In order to use
- <command>ndb_restore</command>, the cluster must be running in
- single user mode. See
- <xref linkend="mysql-cluster-single-user-mode"/>.
+ <emphasis role="bold">Note</emphasis>: Before using
+ <command>ndb_restore</command>, it is recommended that the
+ cluster be running in single user mode, unless you are restoring
+ multiple data nodes in parallel. See
+ <xref linkend="mysql-cluster-single-user-mode"/>, for more
+ information about single user mode.
</para>
<para>
Modified: trunk/refman-5.1/mysql-cluster.xml
===================================================================
--- trunk/refman-5.1/mysql-cluster.xml 2007-01-26 12:49:00 UTC (rev 4654)
+++ trunk/refman-5.1/mysql-cluster.xml 2007-01-26 13:27:16 UTC (rev 4655)
Changed blocks: 1, Lines Added: 20, Lines Deleted: 9; 2360 bytes
@@ -12521,28 +12521,39 @@
<indexterm>
<primary><command>ndb_restore</command></primary>
</indexterm>
-
+
<para>
The cluster restoration program is implemented as a separate
command-line utility <command>ndb_restore</command>, which can
normally be found in the MySQL <filename>bin</filename>
directory. This program reads the files created as a result of
the backup and inserts the stored information into the database.
- <command>ndb_restore</command> must be executed once for each
- set of backup files — that is, once for each data node in
- the cluster at the time that the backup was created.
</para>
+
+ <para>
+ <command>ndb_restore</command> must be executed
+ <literal><replaceable>N</replaceable> + 1</literal> times, where
+ <replaceable>N</replaceable> is the number of backup files that
+ were created by the <literal>START BACKUP</literal> command used
+ to create the backup (see
+ <xref linkend="mysql-cluster-backup-using-management-client"/>).
+ This is equal to once for restoring cluster metadata such as
+ table schemas, plus once for each data node in the cluster at
+ the time that the backup was created.
+ </para>
<indexterm>
<primary>single user mode (MySQL Cluster)</primary>
<secondary>and <command>ndb_restore</command></secondary>
</indexterm>
-
+
<para>
- <emphasis role="bold">Important</emphasis>: In order to use
- <command>ndb_restore</command>, the cluster must be running in
- single user mode. See
- <xref linkend="mysql-cluster-single-user-mode"/>.
+ <emphasis role="bold">Note</emphasis>: Before using
+ <command>ndb_restore</command>, it is recommended that the
+ cluster be running in single user mode, unless you are restoring
+ multiple data nodes in parallel. See
+ <xref linkend="mysql-cluster-single-user-mode"/>, for more
+ information about single user mode.
</para>
<para>
| Thread |
|---|
| • svn commit - mysqldoc@docsrva: r4655 - branches/telcos/refman-5.1 trunk/refman-4.1 trunk/refman-5.0 trunk/refman-5.1 | jon | 26 Jan |
