U klikt op “Nu bijwerken” bij een plugin. Het draaiende icoontje verschijnt, de tekst “bezig met bijwerken” ook, en dan gebeurt er niets meer. Na vijf minuten staat het er nog. U durft het scherm niet te sluiten, want wat als u de update halverwege afbreekt? Tegelijk wilt u verder met uw werk. Ondertussen ziet u misschien dat de site voor bezoekers een onderhoudsmelding toont.

Als een WordPress update blijft hangen, is de update in werkelijkheid meestal al gestopt. Het scherm wacht alleen nog op een antwoord dat niet meer komt. In dit artikel leest u waarom dat gebeurt, hoe u de situatie veilig afrondt en wat u aanpast zodat het niet elke maand opnieuw voorkomt.

Wat er gebeurt tijdens een update

Een update lijkt één handeling, maar bestaat uit een reeks stappen: WordPress zet de site in onderhoudsmodus, downloadt het zip-bestand van de nieuwe versie, pakt het uit in een tijdelijke map, verwijdert de oude bestanden, kopieert de nieuwe op hun plaats, voert eventuele database-aanpassingen van de plugin uit en haalt de onderhoudsmodus weer weg. Het scherm in uw browser wacht ondertussen op een seintje dat alles klaar is.

Elke stap kan mislukken. Als dat gebeurt zonder dat WordPress een nette foutmelding kan terugsturen, blijft de browser wachten. U ziet “bezig met bijwerken”, terwijl op de server allang niets meer beweegt.

Waarom een WordPress update blijft hangen

De download of het uitpakken duurt te lang

Grote plugins, zoals paginabouwers of WooCommerce-uitbreidingen, zijn tientallen megabytes. Op een trage server of bij een langzame verbinding met de downloadserver kan de maximale uitvoeringstijd van PHP worden overschreden. Het proces wordt dan halverwege afgebroken. Hetzelfde geldt voor het uitpakken op een server met weinig geheugen.

Bestandsrechten kloppen niet

Als de webserver de plugin-map niet mag overschrijven, stopt de update stil bij het kopiëren. Dit zien wij vaak na een verhuizing of nadat iemand bestanden via FTP heeft geüpload met een andere gebruiker. In sommige gevallen vraagt WordPress om FTP-gegevens; in andere gevallen blijft hij gewoon hangen.

De schijf is vol

Een verrassend vaak voorkomende oorzaak. Back-upbestanden die op de server zelf worden bewaard, logbestanden die jaren doorgroeien, of een mediabibliotheek die de limiet van het hostingpakket heeft bereikt. Het uitpakken van een zip heeft ruimte nodig en die is er dan niet.

Een andere update draait nog

WordPress zet een tijdelijke vergrendeling in de database zolang een update loopt. Als een eerdere poging is afgebroken, blijft die vergrendeling vijftien minuten staan. Nieuwe pogingen binnen die tijd lijken te hangen, maar wachten in werkelijkheid op een proces dat niet meer bestaat.

Een plugin- of PHP-fout tijdens het activeren

Sommige plugins voeren na het kopiëren nog code uit, bijvoorbeeld om databasetabellen aan te passen. Gaat dat mis, dan kan de hele aanvraag stilvallen. Vooral bij het overslaan van meerdere versies tegelijk komt dit voor.

Zo rondt u een vastgelopen update veilig af

  1. Wacht vijf minuten, geen uur. Als er na vijf minuten nog niets is gebeurd, gebeurt er ook niets meer.
  2. Open de site in een ander tabblad of een privévenster. Ziet u een melding “Kort niet beschikbaar voor gepland onderhoud”, dan staat het .maintenance-bestand nog op de server. Hoe u dat weghaalt leest u in het artikel over de site die vastzit in onderhoudsmodus. Ziet u de site gewoon, dan is de onderhoudsmodus al opgeheven.
  3. Ga naar Plugins in het beheer en controleer het versienummer van de plugin. Staat het nieuwe nummer erbij, dan is de update wel gelukt en heeft alleen het scherm het niet meer meegekregen. Staat het oude nummer er nog, dan is de update niet doorgegaan.
  4. Is de plugin verdwenen uit de lijst? Dan zijn de oude bestanden verwijderd maar de nieuwe niet geplaatst. Geen paniek: uw instellingen staan in de database. Installeer de plugin opnieuw via Plugins, Nieuwe plugin, of upload het zip-bestand handmatig. Uw instellingen komen terug zodra de plugin weer actief is.
  5. Wacht bij een tweede poging vijftien minuten als u meteen daarna een “een andere update is bezig”-melding krijgt. De vergrendeling verloopt vanzelf.
  6. Controleer daarna de site: homepage, een formulier en, bij een webshop, de afrekenpagina.

Maak voordat u opnieuw probeert een back-up, of controleer dat de laatste automatische back-up recent is. Een tweede mislukte poging op een al beschadigde site maakt herstel lastiger.

Praktijkvoorbeeld: een cateraar in Breda

Een cateringbedrijf uit Breda belde ons op een maandagochtend. De eigenaar had zondagavond de paginabouwer willen bijwerken. Na twintig minuten “bezig met bijwerken” had ze de browser gesloten. De site toonde nu de onderhoudsmelding en de beheeromgeving was onbereikbaar.

Wij hebben eerst het .maintenance-bestand verwijderd, waarna de site weer zichtbaar was. De paginabouwer bleek uit de pluginlijst verdwenen. Alle pagina’s toonden ruwe, ongestilde inhoud, maar niets was verloren. Bij het opnieuw installeren stuitten we op de echte oorzaak: de hostingaccount zat op 99 procent van de schijfruimte, door een back-upplugin die veertig kopieën op dezelfde server bewaarde. Na het opruimen daarvan verliep de installatie in dertig seconden. De cateraar bewaart haar back-ups nu extern en de schijf is weer voor driekwart vrij.

Voorkomen dat het weer gebeurt

  • Werk regelmatig bij. Kleine stapjes gaan bijna altijd goed; sprongen over vijf versies tegelijk vaker niet.
  • Houd ruimte over op de server. Bewaar back-ups niet op dezelfde server als de site en ruim oude logbestanden op.
  • Controleer de PHP-instellingen. Een maximale uitvoeringstijd van 30 seconden en een geheugenlimiet van 128 MB zijn voor grote plugins aan de krappe kant. Uw hostingpartij kan die verhogen.
  • Werk één plugin tegelijk bij bij grote of belangrijke plugins. De knop “alles bijwerken” is handig, maar als het misgaat weet u niet welke van de twaalf de boosdoener was.
  • Test grote updates eerst op een kopie. Voor webshops en sites met een paginabouwer loont een staging-omgeving zich al na één vermeden storing.

Wie liever geen zondagavonden meer aan updates besteedt, kan dit uitbesteden. Bij een onderhoudsabonnement worden updates op een rustig moment uitgevoerd, na een back-up en met controle achteraf, en als er toch iets vastloopt is dat een kwestie voor de bugfixing-specialist en niet voor u.

Maar ook als u het zelf blijft doen: houd de lijst hierboven bij de hand en laat een update nooit langer dan een paar minuten “bezig” zijn zonder te controleren wat er werkelijk is gebeurd. Meer over wat u doet als de site na een update echt kapot is, leest u in het stappenplan voor herstel na een update.