Mediawiki software - installatienotities: verschil tussen versies
| (14 tussenliggende versies door 6 gebruikers niet weergegeven) | |||
| Regel 1: | Regel 1: | ||
| − | + | [[Category:Servers network & websites]] | |
| − | |||
| − | |||
| − | |||
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. | 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 == | + | == 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. | * 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. | * /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. | ||
| Regel 13: | Regel 9: | ||
* In deze versiespecifieke directories staan ook de extensies die we gebruiken (MLEB, zie verder). | * In deze versiespecifieke directories staan ook de extensies die we gebruiken (MLEB, zie verder). | ||
| − | === Extensies === < | + | === Extensies === |
| + | |||
| + | |||
| + | === Fileformats === | ||
| + | |||
| + | 2022/11 - added f3d (Fusion) to <code>wgFileExtensions</code> in <code>/etc/mediawiki/LocalSettings.php</code> (dirkx) | ||
| − | < | + | 2024/10 - added mch (Fusion) to <code>wgFileExtensions</code> in <code>/etc/mediawiki/LocalSettings.php</code> (MarkvdKlaauw) |
| − | |||
| − | == Updaten van mediawiki == | + | == Updaten van mediawiki == |
| − | === Maak backups === | + | === Maak backups === |
| − | ==== systeembackup ==== | + | ==== systeembackup ==== |
| − | |||
<code>sudo /etc/duplicity/run.sh</code> | <code>sudo /etc/duplicity/run.sh</code> | ||
| − | ==== databasebackups ==== | + | ==== databasebackups ==== |
| − | |||
Maak backups in sql en xml: | Maak backups in sql en xml: | ||
<code>mysqldump -h localhost -u mediawiki -p --default-character-set=utf8 mediawiki --single-transaction > mediawikibackup.sql</code> | <code>mysqldump -h localhost -u mediawiki -p --default-character-set=utf8 mediawiki --single-transaction > mediawikibackup.sql</code> | ||
| − | |||
<code>mysqldump -h localhost -u mediawiki -p --xml mediawiki --single-transaction > mediawikibackup.xml</code> | <code>mysqldump -h localhost -u mediawiki -p --xml mediawiki --single-transaction > mediawikibackup.xml</code> | ||
| − | |||
(Authorisatiegegevens staan in LocalSettings.php) | (Authorisatiegegevens staan in LocalSettings.php) | ||
| − | === download mediawiki === | + | === download mediawiki === |
| − | |||
De meest recente versie van mediawiki kan worden gevonden op https://www.mediawiki.org/wiki/Download. Een wget is hier wellicht handig: | De meest recente versie van mediawiki kan worden gevonden op https://www.mediawiki.org/wiki/Download. Een wget is hier wellicht handig: | ||
| − | |||
<code>wget https://releases.wikimedia.org/mediawiki/1.27/mediawiki-1.31.0.tar.gz</code> | <code>wget https://releases.wikimedia.org/mediawiki/1.27/mediawiki-1.31.0.tar.gz</code> | ||
Het beste kun je deze eerst uncompressen in een eigen directory zodat je alle tijd hebt het pakket te bestuderen. | Het beste kun je deze eerst uncompressen in een eigen directory zodat je alle tijd hebt het pakket te bestuderen. | ||
| − | === Lees de release notes === | + | === Lees de release notes === |
| − | |||
De release notes bevatten de meest recente instructies en gegevens. Wellicht meer recent dan de pagina die je nu leest. | De release notes bevatten de meest recente instructies en gegevens. Wellicht meer recent dan de pagina die je nu leest. | ||
| − | === Lees de release notes! === | + | === Lees de release notes! === |
| − | |||
Nogmaals. Zodat je zeker weet waar je mee bezig bent. | Nogmaals. Zodat je zeker weet waar je mee bezig bent. | ||
| − | === verplaats === | + | === 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). | 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. | * 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 LocalSettings.php naar /etc/mediawiki/LocalSettings.php | ||
| Regel 70: | Regel 60: | ||
* en uiteindelijk maak een nieuwe symbolic link aan van /usr/share/mediawiki naar de nieuwe versie /usr/share/mediawiki.versie. | * 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. | Kijk in de release notes of je nog andere dingen aan moet passen. | ||
| − | === update de database === | + | === 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. | ''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 == | + | == updaten van de extensies == |
| − | |||
Het updaten van de MLEB extensie is vrijwel volledig standaard, zoals [https://www.mediawiki.org/wiki/MediaWiki_Language_Extension_Bundle beschreven]. De extensie plaats je in /usr/share/mediawiki-<versis>/extensions. Vergeet ook hier de release notes niet. | Het updaten van de MLEB extensie is vrijwel volledig standaard, zoals [https://www.mediawiki.org/wiki/MediaWiki_Language_Extension_Bundle beschreven]. De extensie plaats je in /usr/share/mediawiki-<versis>/extensions. Vergeet ook hier de release notes niet. | ||
| Regel 89: | Regel 76: | ||
<code>$wgGroupPermissions['sysop']['pagelang'] = true;</code> | <code>$wgGroupPermissions['sysop']['pagelang'] = true;</code> | ||
| − | == afronden van de update == | + | To change the maximum number of items shown per category in MediaWiki from maximum 50 to maximum 500, change the following in LocalSettings.php: |
| + | |||
| + | <code>$wgCategoryPagingLimit = 500;</code> | ||
| + | |||
| + | == 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) | * Laat apache2 weer doorgaan met het uitserveren van de mediawiki (als je dat in een van de voorgaande stappen al niet had gedaan) | ||
* test | * test | ||
* Pas deze documentatie aan als deze aangepast of verbeterd moet worden. | * Pas deze documentatie aan als deze aangepast of verbeterd moet worden. | ||
| − | |||
Huidige versie van 17 nov 2024 om 22:31
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.
Inhoud
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
Fileformats
2022/11 - added f3d (Fusion) to wgFileExtensions in /etc/mediawiki/LocalSettings.php (dirkx)
2024/10 - added mch (Fusion) to wgFileExtensions in /etc/mediawiki/LocalSettings.php (MarkvdKlaauw)
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;
To change the maximum number of items shown per category in MediaWiki from maximum 50 to maximum 500, change the following in LocalSettings.php:
$wgCategoryPagingLimit = 500;
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.
