Mediawiki software - installatienotities: verschil tussen versies
k (marked for translation) |
(Heeft deze versie voor vertaling gemarkeerd) |
||
| Regel 2: | Regel 2: | ||
<translate> | <translate> | ||
| + | <!--T:1--> | ||
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 == <!--T:2--> |
| + | <!--T:3--> | ||
* 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 11: | Regel 13: | ||
* 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 === <!--T:4--> |
| + | <!--T:5--> | ||
De enige extra extensie die is toegevoegd is de 'multi language extension bundle' ([https://www.mediawiki.org/wiki/MediaWiki_Language_Extension_Bundle MLEB]) waardoor we meerdere talen in de wiki kunnen ondersteunen. | De enige extra extensie die is toegevoegd is de 'multi language extension bundle' ([https://www.mediawiki.org/wiki/MediaWiki_Language_Extension_Bundle MLEB]) waardoor we meerdere talen in de wiki kunnen ondersteunen. | ||
| − | == Updaten van mediawiki == | + | == Updaten van mediawiki == <!--T:6--> |
| − | === Maak backups === | + | === Maak backups === <!--T:7--> |
| − | ==== systeembackup ==== | + | ==== systeembackup ==== <!--T:8--> |
| + | <!--T:9--> | ||
<code>sudo /etc/duplicity/run.sh</code> | <code>sudo /etc/duplicity/run.sh</code> | ||
| − | ==== databasebackups ==== | + | ==== databasebackups ==== <!--T:10--> |
| + | <!--T:11--> | ||
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> | ||
| + | <!--T:12--> | ||
<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> | ||
| + | <!--T:13--> | ||
(Authorisatiegegevens staan in LocalSettings.php) | (Authorisatiegegevens staan in LocalSettings.php) | ||
| − | === download mediawiki === | + | === download mediawiki === <!--T:14--> |
| + | <!--T:15--> | ||
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: | ||
| + | <!--T:16--> | ||
<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 === <!--T:17--> |
| + | <!--T:18--> | ||
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! === <!--T:19--> |
| + | <!--T:20--> | ||
Nogmaals. Zodat je zeker weet waar je mee bezig bent. | Nogmaals. Zodat je zeker weet waar je mee bezig bent. | ||
| − | === verplaats === | + | === verplaats === <!--T:21--> |
| + | <!--T:22--> | ||
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). | ||
| + | <!--T:23--> | ||
* 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 57: | Regel 70: | ||
* 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. | ||
| + | <!--T:24--> | ||
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 === <!--T:25--> |
| + | <!--T:26--> | ||
''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 == <!--T:27--> |
| + | <!--T:28--> | ||
Het updaten van de MLEB extensie is 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 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. | ||
| − | == afronden van de update == | + | == afronden van de update == <!--T:29--> |
| + | <!--T:30--> | ||
* 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. | ||
</translate> | </translate> | ||
Versie van 8 sep 2018 om 21:11
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
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 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.
