TheaterEncyclopedie:Onderhoud
Hoewel het (technisch) onderhoud is uitbesteed, toch een aantal aantekeningen, die relevant zijn voor gebruikers. Houd er rekening mee, dat de informatie op deze pagina achterhaald kan zijn!!
Maintenance scripts
Ad hoc gebruikte scripts:
- refreshLinks.sh
- BM: Ik neem aan dat hier gaat om refreshLinks.php, wat is/wordt gebruikt voor het updaten van (categorie-)links.
- runjobs.php - na grootschalige wijzigingen
Onderhoud semantische gegevens:
- Speciaal:SMWBeheer - incl. rebuildData.php (?)
- rebuildData.php
- Zie ook documentatie
Cron-jobs
Tot 2021 (overgang naar PW) werden met behulp van "cron-jobs" de volgende onderhoudstaken uitgevoerd:
- backup
- runJobs.php (beperkt tot 1 uur runtime - info HB)
- generateSitemap.php
- rebuildFileCache.php
BM: Na de overgang naar PW (medio 2021), kunnen zij de onderhoudsscript in principe naar eigen inzicht instellen. Er zijn veel verschillende manieren om dit (ook "on-the-fly" te configureren, maar ik zou hiervoor vooral gebruikmaken van de expertise van PW). Voor ons is van belang te vereisen dat bijv. dagelijks (bij voorkeur 's nachts) in ieder geval de gehele job-queue wordt weggewerkt, zodat de volgende dag alle wijzigingen zichtbaar zijn. Dit geldt zowel voor Productie-TE als Test-TE.
BM: Op aanvraag het runJobs.php script (en evt. andere scripts) laten runnen zal in geval van problemen of grootschalige wijzigingen m.i. wenselijk blijven. We zouden bijv. ook kunnen kiezen voor het laten lopen van i.i.g. runJobs.php op uurbasis op de Test-TE.
Veel gebruik sjablonen
Door aanpassingen in sjablonen, die op veel pagina's worden gebruikt, kan het nodig zijn om handmatig het script runJobs.php te laten draaien, zodat de wijzigingen ook zichtbaar worden.
- Suggeste PW
- this is a task that should be seen in connection with job queue execution and this is already working towards improving the wiki and introducing best practices once regular operations at our end commence. This task is acutally something that is being underestimated but I am sure that you have come across this in the past already.
Every time a template is edited (every revision) MediaWiki does link checking no matter what. Depending on how complex a template is structured and also how often it is used on a wiki this can potentially trigger quite a lot of intense and demanding jobs. To increase stability and performance of the wiki I recommend to mark these templates with notes. These notes will increase awareness that the template should only consciously be edited preferably also by testing the change somewhere else in advance.
This kind of templates is basically what Wikipedia calls "high risk templates" [0].
A first step here could be to identify the templates and then figure at the note. (bron: e-mail d.d. 28-5-2021 van Karsten Hoffmeyer)
BM: Het hierboven door PW aangehaalde punt m.b.t. sjablonen is bekend bij de mensen die nu sjablonen bewerken (al zijn er tot heden nog geen problemen geweest met ongewenste bewerkingen). Als ik het goed heb, staat het bewerken van sjablonen nu nog open voor (alle) geregistreerde gebruikers; hoewel slechts een heel beperkt aantal mensen daadwerkelijk sjablonen aanpast (voor zover ik weet alleen WikiWerkers). Omdat (bijna) alle sjablonen van de TE een grote en brede uitwerking hebben, op de weergave van informatie, lijkt het mij goed de toegang tot de naamruimte "Sjablonen" in ieder geval op de productie-omgeving te beperken tot een kleine(re) groep "Sjabloon-bewerkers".
BM: Omdat we (met name WikiWerkers) met grote regelmaat sjabloonaanpassingen doen t.b.v. de ontwikkeling van nieuwe content(weergave), kan het nodig zijn met enige regelmaat het runJobs.php script op aanvraag uit te voeren.
BM: Alleen "PM", wellicht de mogelijkheid onderzoeken om betreffende scripts via speciale pagina te kunnen runnen. Als ik me goed herinner zijn hier extensies voor, vergelijkbaar met die voor Semantic MediaWiki-onderhoud.