Backing up the wiki

Revision as of 19:02, 24 April 2021 by Rob Kam (talk | contribs) (Created page with "== Backing up the wiki == Any confirmed user on this wiki is able to create an XML, JSON or image backup with Special:DataDump.<!-- Depending on settings in Special:Manage...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Backing up the wiki

Any confirmed user on this wiki is able to create an XML, JSON or image backup with Special:DataDump.

Basic site info, such as a list of the extensions in use, is downloaded to the JSON file. The XML dump does not contain user accounts, etc.

WikiTeam's dumpgenerator.py

Another method is to use the WikiTeam Python (only with version 2) dumpgenerator.py script from the command-line.

Example usage, this will produce a JSON file, an XML dump with page histories and a folder of files:
python2 dumpgenerator.py --xmlrevisions --xml --images --api=https://sdiy.info/w/api.php

However large wikis may fail to export leaving an incomplete XML dump. The presence of a siteinfo.json file probably indicates a succesful XML dump.

Full instructions are at the WikiTeam tutorial.

Restoring from backup

See MediaWiki.org for more detailed instructions, (specifically Manual:Importing XML dumps and Manual:importImages.php).

After installing MediaWiki and extensions, in the shell use importDump.php to import the XML, this can take a long time. e.g. from the mediawiki folder
php maintenance/importDump.php --conf LocalSettings.php --dry-run < your_dumpfile.xml

If that works repeat without --dry-run. It won't matter if the XML dump file has the file extension .gz or .bz2 (is compressed).

Due to the bug T206683 it may be necessary to also include --user-prefix="" in the command.

Afterwards use ImportImages.php to import the images
php maintenance/importImages.php your_files/

Afterwards run php maintenance/rebuildrecentchanges.php in order to update the content of Special:Recentchanges.