view docs/admin/backup.rst @ 2770:264e4015212e

docs: fixes, additions, formatting
author Thomas Waldmann <tw AT waldmann-edv DOT de>
date Tue, 02 Sep 2014 16:22:47 +0200
parents d126d94d7858
children 6af6e61dc25f
line wrap: on
line source
Backup and Restore

Full Backup / Restore

The best way to recover from data loss is to have a **full** backup of your machine.
With this backup you can easily restore your machine to a working condition.

The procedure below explains how to selectively backup only the files
essential to your MoinMoin installation. While there is no need to maintain both a full
and a selective backup, having at least one of the two is strongly recommended.

Selective Backup
If you want a backup of MoinMoin and your data, then backup the following:

* your data
* moin configuration, e.g.
* logging configuration, e.g. logging.conf
* moin deployment script, e.g. moin.wsgi
* web server configuration, e.g. apache virtualhost config
* optional: moin code + dependencies; you should at least know which version
  you ran, so you can reinstall that version when you need to restore

To create a dump of all data stored in moinmoin (wiki items, user profiles), run the
following command::

 moin save --all-backends --file backup.moin

Please note that this file contains sensitive data like user profiles, wiki
contents, so store your backups in a safe place that no unauthorized
individual can access.

Selective Restore

To restore all software and configuration files to their original
place, create an empty wiki first::

 moin index-create -s -i  # -s = create new storage
                          # -i = create new index

To load the backup file into your empty wiki, run::

 moin load --file backup.moin

Then build an index of the loaded data::

 moin index-build