Mediawiki software - installatienotities/en

From summer 2018 onwards, the mediawiki package and installation is not managed by apt anymore but manually. This to have more fine grained control over the versions we run at makerspace.

Locations of the software

• The apache2 document root for mediawiki is /var/lib/mediawiki. This directory mainly contains symbolic links to files in /usr/share/mediawiki, but also some hard data, like the images, cache, uploads and config directories with user generated files.
• /usr/share/mediawiki is a link itself, it points to /usr/share/mediawiki-<version>, where the real software is located. At this moment this is /usr/share/mediawiki-1.31.0.
• These version specific directories contain symbolic links from LocalSettings.php to /etc/mediawiki/LocalSettings.php. Also, /etc/mediawiki contains a backup copy of Apache2's gloval config file mediawiki.conf.
• These version specific directories also contain the extensions used (i.e. MLEB, see below).

Extensions

The only additional extension used (besides the standard package installed by default) is the 'multi language extension bundle' (MLEB). This extension (set) enables multiple languages and translation workflow in the mediawiki.

Updating mediawiki

Backing up

System backup

sudo /etc/duplicity/run.sh

Database backups

Create backups in sql en xml: mysqldump -h localhost -u mediawiki -p --default-character-set=utf8 mediawiki --single-transaction > mediawikibackup.sql

mysqldump -h localhost -u mediawiki -p --xml mediawiki --single-transaction > mediawikibackup.xml

(Authorisation data can be found in LocalSettings.php)

download mediawiki

The most recent version of mediawiki can be found at https://www.mediawiki.org/wiki/Download. You can use wget to download, e.g.:

wget https://releases.wikimedia.org/mediawiki/1.27/mediawiki-1.31.0.tar.gz

Best to uncompress the archive in your home directory and not directly in /usr/var.

Study the release notes

The release notes contain important changes, instructions and last minute notices. These might be more accurate and up-to-date than the document you are reading now.

Study the release notes!

Nogmaals. Zodat je zeker weet waar je mee bezig bent.

verplaats

Voordat je hiermee aan de slag gaat is het slim om apache even te laten stoppen met het uitserveren van mediawiki (in /etc/apache2/conf-enabled).

• Verplaats de code naar /usr/share/mediawiki-<versie> en chown deze naar wikiadmin.
• maak in deze directory een symbolic link aan van LocalSettings.php naar /etc/mediawiki/LocalSettings.php
• maak in deze directory een symbolic link aan van images naar /var/lib/images
• en uiteindelijk maak een nieuwe symbolic link aan van /usr/share/mediawiki naar de nieuwe versie /usr/share/mediawiki.versie.

Kijk in de release notes of je nog andere dingen aan moet passen.

update de database

Neem nu risico en voer het database-update script 'update.php' uit in /usr/share/mediawiki/maintenance. Met een beetje geluk werkt dit.

updaten van de extensies

Het updaten van de MLEB extensie is volledig standaard, zoals beschreven. De extensie plaats je in /usr/share/mediawiki-<versis>/extensions. Vergeet ook hier de release notes niet.

afronden van de update

• Laat apache2 weer doorgaan met het uitserveren van de mediawiki (als je dat in een van de voorgaande stappen al niet had gedaan)
• test
• Pas deze documentatie aan als deze aangepast of verbeterd moet worden.