From 9aa9c34a5734f1e77114787b9b5634f14a3d3af9 Mon Sep 17 00:00:00 2001 From: Badlop Date: Mon, 28 Dec 2009 12:43:44 +0000 Subject: Better use install_fallback when importing a Mnesia backup file. SVN Revision: 2829 --- doc/guide.html | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) (limited to 'doc/guide.html') diff --git a/doc/guide.html b/doc/guide.html index 1d894cd7a..972161a20 100644 --- a/doc/guide.html +++ b/doc/guide.html @@ -3511,11 +3511,13 @@ they are automatically renamed to "*-old.log". See section restore ejabberd.backup
Restore immediately from a binary backup file the internal Mnesia database. -This will consume quite some memory for big servers. +This will consume a lot of memory if you have a large database, +so better use install_fallback.
install_fallback ejabberd.backup
The binary backup file is installed as fallback: it will be used to restore the database at the next ejabberd start. -Similar to restore, but requires less memory. +This means that, after running this command, you have to restart ejabberd. +This command requires less memory than restore.
dump ejabberd.dump
Dump internal Mnesia database to a text file dump.
load ejabberd.dump
@@ -3698,8 +3700,17 @@ mv /var/lib/ejabberd/*.* /var/lib/ejabberd/oldfiles/ 
ejabberdctl start
  • Convert the backup to new node name: 
    ejabberdctl mnesia_change_nodename $OLDNODE $NEWNODE $OLDFILE $NEWFILE
-
  • Import the new backup: -
    ejabberdctl restore $NEWFILE
+
  • Install the backup file as a fallback: +
    ejabberdctl install_fallback $NEWFILE
+
  • Stop ejabberd: +
    ejabberdctl stop
+
    You may see an error message in the log files, it’s normal, so don’t worry: +
    Mnesia(ejabberd@newmachine):
+** ERROR ** (ignoring core)
+** FATAL ** A fallback is installed and Mnesia must be restarted.
+  Forcing shutdown after mnesia_down from ejabberd@newmachine...
+
  • Now you can finally start ejabberd: +
    ejabberdctl start
  • Check that the information of the old database is available: accounts, rosters... After you finish, remember to delete the temporary backup files from public directories.

    • -- cgit v1.2.3