diff options
| author | Badlop <badlop@process-one.net> | 2009-12-28 12:43:44 +0000 |
|---|---|---|
| committer | Badlop <badlop@process-one.net> | 2009-12-28 12:43:44 +0000 |
| commit | 9aa9c34a5734f1e77114787b9b5634f14a3d3af9 (patch) | |
| tree | 4b163b64eb4b5518d7852c890421d8879cf95a2a /doc/guide.html | |
| parent | Support for arguments in ejabberdctl that are empty strings. (diff) | |
Better use install_fallback when importing a Mnesia backup file.
SVN Revision: 2829
Diffstat (limited to 'doc/guide.html')
| -rw-r--r-- | doc/guide.html | 19 |
1 files changed, 15 insertions, 4 deletions
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 <TT>"*-old.log"</TT>. See section <A HREF="#lo Store internal Mnesia database to a binary backup file. </DD><DT CLASS="dt-description"><B><TT>restore ejabberd.backup</TT></B></DT><DD CLASS="dd-description"> 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 <TT>install_fallback</TT>. </DD><DT CLASS="dt-description"><B><TT>install_fallback ejabberd.backup</TT></B></DT><DD CLASS="dd-description"> The binary backup file is installed as fallback: it will be used to restore the database at the next ejabberd start. -Similar to <TT>restore</TT>, but requires less memory. +This means that, after running this command, you have to restart ejabberd. +This command requires less memory than <TT>restore</TT>. </DD><DT CLASS="dt-description"><B><TT>dump ejabberd.dump</TT></B></DT><DD CLASS="dd-description"> Dump internal Mnesia database to a text file dump. </DD><DT CLASS="dt-description"><B><TT>load ejabberd.dump</TT></B></DT><DD CLASS="dd-description"> @@ -3698,8 +3700,17 @@ mv /var/lib/ejabberd/*.* /var/lib/ejabberd/oldfiles/ <PRE CLASS="verbatim">ejabberdctl start </PRE></LI><LI CLASS="li-enumerate">Convert the backup to new node name: <PRE CLASS="verbatim">ejabberdctl mnesia_change_nodename $OLDNODE $NEWNODE $OLDFILE $NEWFILE -</PRE></LI><LI CLASS="li-enumerate">Import the new backup: -<PRE CLASS="verbatim">ejabberdctl restore $NEWFILE +</PRE></LI><LI CLASS="li-enumerate">Install the backup file as a fallback: +<PRE CLASS="verbatim">ejabberdctl install_fallback $NEWFILE +</PRE></LI><LI CLASS="li-enumerate">Stop ejabberd: +<PRE CLASS="verbatim">ejabberdctl stop +</PRE>You may see an error message in the log files, it’s normal, so don’t worry: +<PRE CLASS="verbatim">Mnesia(ejabberd@newmachine): +** ERROR ** (ignoring core) +** FATAL ** A fallback is installed and Mnesia must be restarted. + Forcing shutdown after mnesia_down from ejabberd@newmachine... +</PRE></LI><LI CLASS="li-enumerate">Now you can finally start ejabberd: +<PRE CLASS="verbatim">ejabberdctl start </PRE></LI><LI CLASS="li-enumerate">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. </LI></OL><P> <A NAME="secure"></A> </P><!--TOC chapter Securing <TT>ejabberd</TT>--> |