Migrating mediawiki from mysql to sqlite

Overview

To migrate a mediawiki from MySQL to SQLite there are two basic approaches:

• start with a new database and worry about
  • dumping all pages but the Main Page with the dumpBackup command and restoring them with the importDump command
  • keeping the articles' revisions
  • copying the Main Page from the old wiki to the new
  • copying the users and privileges from the old wiki to the new
  • copying the wiki statistics (like page visits) from the old wiki to the new
  • copying images and other files from the old wiki to the new
  • re-doing things like mediawiki extensions on the new wiki
  • re-doing your settings e.g. from LocalSettings.php on the new wiki

Matt gives a good overview about this

• just migrate the database below your wiki

migrate database below your wiki

I wanted to migrate the database below my wiki so

• I created a dump (aka backup aka export) of the database

mysqldump wikidb -u wikiuser -p > dump.sql

• I got a MySQL -> SQLite converter

wget https://gist.github.com/esperlu/943776/raw/dd87f4088f6d5ec7563478f7a28a37ba02cf26e2/mysql2sqlite.sh

• I started this converter to create a file /srv/www/htdocs/wikidb.sqlite:

sh mysql2sqlite.sh -u wikiuser -p wikidb | sqlite3 /srv/www/htdocs/wikidb.sqlite

• change LocalSettings.php to reflect

$wgDBtype = "sqlite";
$wgDBserver = "";
$wgDBname = "wikidb";
$wgDBuser = "";
$wgDBpassword = "";
$wgSQLiteDataDir = "/srv/www/htdocs";

• allow your webserver to write to the file:

chown wwwrun:www /srv/www/htdocs/wikidb.sqlite

I will admit that I still have some more things to explore here - my "user" table does not contain a field "user_options". But maintenance/sqlite/archives/initial-indexes.sql is called by update.php and requires this. I guess it fails in line 1291 of includes/Revision.php

TroubleShooting

I got quite a lot of error messages that were easy to fix - provided you know how.

PDO exception

Symptom: When surfing to the wiki you get a page displaying this error message:

Unexpected non-MediaWiki exception encountered, of type "PDOException"
exception 'PDOException' with message 'There is no active transaction' in /srv/www/htdocs/mediawiki/includes/db/DatabaseSqlite.php:664
Stack trace:

Solution: In LocalSettings.php set $wgDBuser to "".

Is not unique

Symptom: When calling mysql2sqlite.sh you get a lot of error messages like

Error: near line 565: column cat_id is not unique
Error: near line 566: column cat_id is not unique

Solution: You cannot call mysql2sqlite.sh twice to the same target file. Delete the target file before you start the next conversion, like this:

rm test.sqlite
sh /root/mysql2sqlite.sh -u wikiuser -p wikidb | sqlite3 test.sqlite

See also

• Migrating_a_database_from_mysql_to_sqlite