Mediawiki software - installatienotities

Sinds zomer 2018 wordt de mediawiki software niet meer via apt beheerd maar met de hand. Reden hiervoor is dat we zelf controle willen hebben over de exacte versies die we gebruiken van de mediawiki en de extensies.

Softwarelocaties

• De documentroot van mediawiki voor apache2 is /var/lib/mediawiki. Deze directory bevat voornamelijk symbolic links naar bestanden in /usr/share/mediawiki, maar ook wat echte directories (images, config, cache, uploads) met kostbare gebruikersdata.
• /usr/share/mediawiki is zelf weer een symbolic link naar /usr/share/mediawiki-<version>, waar de echte software staat. Op dit moment is dat /usr/share/mediawiki-1.31.0.
• In deze versiespecifieke directories staan symbolic links van LocalSettings.php naar /etc/mediawiki/LocalSettings.php. (Ook bevat /etc/mediawiki een kopie van de apache2 (globale) configuratiefile mediawiki.conf. Waarom deze daar staat weet ik niet, maar hij is wel makkelijk terug te vinden zo)
• In deze versiespecifieke directories staan ook de extensies die we gebruiken (MLEB, zie verder).

Extensies

De enige extra extensie die is toegevoegd is de 'multi language extension bundle' (MLEB) waardoor we meerdere talen in de wiki kunnen ondersteunen.

Updaten van mediawiki

Maak backups

systeembackup

sudo /etc/duplicity/run.sh

databasebackups

Maak 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

(Authorisatiegegevens staan in LocalSettings.php)

download mediawiki

De meest recente versie van mediawiki kan worden gevonden op https://www.mediawiki.org/wiki/Download. Een wget is hier wellicht handig:

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

Het beste kun je deze eerst uncompressen in een eigen directory zodat je alle tijd hebt het pakket te bestuderen.

Lees de release notes

De release notes bevatten de meest recente instructies en gegevens. Wellicht meer recent dan de pagina die je nu leest.

Lees de 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 vrijwel volledig standaard, zoals beschreven. De extensie plaats je in /usr/share/mediawiki-<versis>/extensions. Vergeet ook hier de release notes niet.

De MLEB configuratie is met enkele regels uitgebreid om de paginataal handmatig in te kunnen stellen:

$wgPageLanguageUseDB = true;

$wgGroupPermissions['sysop']['pagelang'] = true;

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.