Backing up the wiki

From Synth DIY wiki
Jump to: navigation, search

Backing up the wiki

Backup XML and images are at static.miraheze.org/dumps/

Backing up the wiki without server shell access, requires Python v2 (v3 doesn't yet work).

Run the the WikiTeam Python script dumpgenerator.py from the command-line to get an XML, with edit histories, dump and a dump of all images plus their descriptions.

A XML dump does not create a full backup of the wiki database, the dump does not contain user accounts, etc. Extensions and their configuration are also not backed up, also file types other than images don't get saved.

python dumpgenerator.py --api=https://sdiy.info/w/api.php --xml --images

Full instructions are at the WikiTeam tutorial.

Restoring from backup - Miraheze, an easier solution

For free of charge MediaWiki hosting, without advertising and with the server installation maintained by expert volunteers, use miraheze.org.

Restoring from backup - με λίγα λόγια

Assumes economical shared Linux hosting, with jailed shell access.

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

  • Use cPanel > MySQL to create db e.g. wiki, user e.g. root, grant all privileges to the user and set a password e.g. Whatever123
  • SSH into your server
  • cd public_html or whatever.
  • wget http://download.wikimedia.org/mediawiki/x.xx/mediawiki-x.xx.tar.gz (replacing x.xx as apropriate for current version).
  • tar -xpzf mediawiki-x.xx.tar.gz
  • mv mediawiki-x.xx/ w (don't put wiki pages in the root directory of the site)
  • Upload the XML dump and images folder to the server, to e.g. public_html/
  • Wget and extract Scribunto extension into the extensions folder, e.g. e.g. public_html/w/extensions.
  • Open your wiki with a web browser e.g. https://sdiy.info
  • Follow theset up the wikilink. Complete the steps that follow. Leave most options at defaults. Except for:
    • Database character set select UTF-8.
    • Copyright and license to Creative Commons Attribution-ShareAlike
    • Extensions select at least Scribunto
    • Tick Enable file uploads
    • Tick Enable Instant Commons
  • Copy LocalSettings.php onto the server wiki folder, e.g. w/.
  • In the shell do php public_html/w/maintenance/importDump.php --dry-run < public_html/sdiyinfo_w-yyyymmdd-history.xml
  • If that works repeat without --dry-run
  • php public_html/w/maintenance/importImages.php public_html/images
  • php public_html/w/maintenance/rebuildrecentchanges.php

Delete the setup files now no longer required: mediawiki....tar.gz, sdiyinfo....xml, Scribunto....tar.gz and the public_html/images/ folder.

LocalSettings.php

  • Add filetypes to the default array: $wgFileExtensions = array_merge($wgFileExtensions, array('mid', 'mp3', 'svg', 'pdf', 'fpd', 'dwg'));

Tweaks

Useful extensions

Follow links for downloads and instructions.

Already installed above:

Installed with MediaWiki:

Download and install Semantic Bundle. Installed with Semantic Bundle:

Also install separately:

Templates and modules

Most templates and modules should have been restored. Where they haven't export them from Wikipedia Special:Export. Do not include the full history or the file will become too large. Tick Include templates so that any dependencies are included. Then on the SDIY wiki use Special:Import. Also copy any relevant styling.

Because of CC-BY-SA licensing considerations try to acknowledge the source of imported templates.