Updating Mediawiki Installation: Difference between revisions
First commit |
|||
(5 intermediate revisions by the same user not shown) | |||
Line 10: | Line 10: | ||
On bombur, go to <tt>/home/geos/WikiBackup</tt> and, per the README, run: | On bombur, go to <tt>/home/geos/WikiBackup</tt> and, per the README, run: | ||
mysqldump --opt --user=geos --password=<password> --host=mysql.geos5.org geos5_wiki > geos5_wiki.2017Jul26.backup.sql | $ mysqldump --opt --user=geos --password=<password> --host=mysql.geos5.org geos5_wiki > geos5_wiki.2017Jul26.backup.sql | ||
mysqldump --opt --user=geos --password=<password> --host=mysql.geos5.org geos5_wiki --xml > geos5_wiki.2017Jul26.backup.xml | $ mysqldump --opt --user=geos --password=<password> --host=mysql.geos5.org geos5_wiki --xml > geos5_wiki.2017Jul26.backup.xml | ||
where the date is changed, of course. | where the date is changed, of course. | ||
Then, gzip them for space saving. | Then, gzip them for space saving. | ||
== Get and Extract Mediawiki == | |||
A la the Mediawiki manual: | |||
$ cd /home/geos/geos5.org | |||
$ wget https://releases.wikimedia.org/mediawiki/1.29/mediawiki-1.29.0.tar.gz | |||
$ tar -xvzf mediawiki-1.29.0.tar.gz | |||
$ rm mediawiki-1.29.0.tar.gz | |||
Now we will work in the <tt>mediawiki-1.29.0/</tt> directory until we are ready to swap it for <tt>wiki/</tt>. | |||
== Copy Over Needed Files == | |||
$ cd mediawiki-1.29.0 | |||
=== LocalSettings.php === | |||
$ cp ../wiki/LocalSettings.php . | |||
=== images/ === | |||
$ cp -rp ../wiki/images/* images/ | |||
=== skins/ === | |||
For this, first do a diff, if the skins directories have the same folders, just accept the new ones. Mediawiki often fiddles with skin handling and you need to use 1.29 skins for 1.29. Luckily, GEOS-5 has little to no skin adaptation. | |||
=== extensions/ === | |||
Mainly, you want to copy over any directories that are in the old install but not in the new install. Anything in both, assume the newer is better. | |||
==== SyntaxHighlight_GeSHi ==== | |||
This one is a bit tricky. There is currently a bug in <tt>extensions/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.class.php</tt> that we need to fix. It's essentially undoing a workaround they say fixes a bug...but the workaround causes a bug for us! | |||
Once you are done with the upgrade, look at, say, [[Recipe: python program reads cubed-sphere data]] and make sure the highlighting is there! | |||
== Update MIME Types == | |||
Mediawiki's MIME tables need updating to allow .mm files as an XML file extension. To do this edit: | |||
includes/libs/mime/mime.types | |||
and change: | |||
application/xml xml xsl xsd kml | |||
to | |||
application/xml xml xsl xsd kml mm | |||
== Update the Database == | |||
=== Rename the wiki directory === | |||
First, you move away the old wiki directory and make the new install <tt>wiki/</tt> | |||
=== Set repo to read only === | |||
Edit LocalSettings.php and uncomment the last line to set in read-only mode: | |||
# ------------------- | |||
# Added by M Thompson | |||
# This puts the wiki into readonly mode | |||
# ------------------- | |||
$wgReadOnly = 'Maintenance is underway. Website is on read-only mode'; | |||
=== Run update script === | |||
$ /usr/local/php56/bin/php maintenance/update.php | |||
=== ISSUES === | |||
It turns out [https://www.mediawiki.org/wiki/Topic:Tv1swbwrwjpakgmk due to a bug in Mediawiki], you cannot run update.php if the site is in readonly mode. This is scary. It could mean inconsistent DB for any users on the wiki at that time. |