Een Magento 2-upgrade bereidt u voor door eerst vast te leggen wat u precies draait: editie, huidige versie, installatiemethode, hosting, extensies, maatwerk en koppelingen. Daarna kiest u een doelversie en controleert u de actuele systeemeisen. Vervolgens laat u de upgrade op een aparte proefomgeving uitvoeren en testen, met een herstelbare back-up en een duidelijk terugzetplan. Pas na een vastgelegde beoordeling van de testresultaten volgt de livegang.
In dit artikel maken we steeds onderscheid tussen wat Adobe in de officiële documentatie beschrijft en ons eigen praktische voorbereidingsadvies. Het is geen technische upgradehandleiding. Voor de uitvoering blijft de officiële documentatie leidend, samen met de beheerder van uw webshop.
Inventaris: editie, installatiemethode en doelversie
Begin met een overzicht van uw huidige situatie. Dat is ons advies, geen Adobe-voorschrift. Noteer in dat overzicht:
- de editie: Magento Open Source of Adobe Commerce, en bij Adobe Commerce of het om Commerce Cloud of een on-premises installatie gaat;
- de huidige versie en de gewenste doelversie;
- de hostingomgeving;
- alle extensies, het maatwerk en de externe koppelingen.
Dat onderscheid tussen edities en installaties is belangrijk. Adobe beschrijft aparte upgradepaden voor Composer- of on-premises-installaties, voor Cloud en voor Git-installaties. Ook de productpakketten van Magento Open Source en Adobe Commerce verschillen. Commerce Cloud, on-premises en Magento Open Source zijn dus niet identiek. Een stappenplan voor de ene situatie kunt u niet zomaar op een andere toepassen.
Actuele vereisten: PHP, afhankelijkheden en zoekmachine
Adobe vraagt om vóór een upgrade de systeemeisen voor de doelversie te controleren, inclusief de PHP-versie en andere afhankelijkheden. Daarom noemen wij hier bewust geen concrete versies.
De voorbereidingslijst van Adobe noemt onder meer:
- cron;
- bestandsrechten;
- de Composer-updateplugin;
- de zoekmachine.
Laat uw beheerder per installatie nagaan welke punten voor u gelden. Instructies voor de Cloud-infrastructuur gelden bijvoorbeeld niet automatisch voor een eigen server.
Extensies, maatwerk en koppelingen
Volgens Adobe bepalen maatwerk, extensies, integraties en de teststrategie mede hoeveel werk een upgrade vraagt.
Neem extensies, maatwerk en externe koppelingen op in uw overzicht voor de upgrade. Ga ook na of u die extensie eigenlijk nog gebruikt. Laat eigen maatwerk beoordelen op aanpassingen in kernfunctionaliteit. Noteer ook de externe koppelingen die uw webshop gebruikt. Zo ziet u vooraf waar de risico's liggen.
Proefomgeving, back-up en terugzetplan
Ons advies is om de beheerder drie zaken te laten voorbereiden.
Een proefomgeving. Die moet zoveel mogelijk lijken op de live-omgeving.
Een volledig herstelbaar back-upplan. Dat omvat de code, de database en de mediabestanden. Laat het herstel bij voorkeur ook echt testen.
Een terugzetbesluit. Leg vooraf vast wie beslist dat er wordt teruggezet en op basis van welke criteria.
De procedure van Adobe bevat onder meer onderhoudsmodus, afstemming van cron en queueconsumers, een back-up van composer.json en een controle van de storefront achteraf. Gebruik die punten om met uw beheerder te plannen. Let op: een kopie van composer.json is geen volledige back-up van uw webshop.
Testchecklist voor de proefomgeving
Dit is ons voorgestelde testadvies. Laat op de proefomgeving minstens het volgende controleren:
- product zoeken en de zoekresultaten;
- categorie- en productpagina's;
- de winkelmand;
- de checkout en alle betaalmethoden;
- orderbevestigingen en andere klantberichten;
- bestaande koppelingen met externe systemen;
- de belangrijkste beheerfuncties in de backend;
- geplande taken.
Leg per controle het verwachte en het werkelijke resultaat vast. Zo ontstaat een overzicht dat iemand anders kan nalopen, in plaats van een algemeen gevoel dat "het werkt".
Livegang alleen na beoordeling
Plan de livegang pas als de testresultaten beoordeeld zijn en openstaande punten zijn opgelost of bewust geaccepteerd. Kies een rustig moment en spreek af wie er tijdens en na de overgang bereikbaar is. Laat direct na de livegang de storefront en de checkout opnieuw controleren. Houd het terugzetplan klaar tot de webshop een tijd stabiel draait.
Veelgestelde vragen
Kan ik een upgrade-handleiding van een andere webshop gewoon volgen? Meestal niet. Adobe beschrijft verschillende paden voor Composer- of on-premises-installaties, Cloud en Git. Daarnaast verschillen Magento Open Source en Adobe Commerce in productpakketten. Ook extensies en maatwerk maken elke webshop anders.
Waarom staan hier geen exacte PHP-versies? Die horen bij een specifieke doelversie en veranderen in de loop van de tijd. Controleer ze daarom in de actuele systeemeisen en versiematrix van Adobe.
Is een back-up van composer.json voldoende? Nee. Die back-up hoort bij de procedure van Adobe, maar voor een herstelbaar terugzetplan heeft u ook de code, de database en de mediabestanden nodig.
Hulp bij de voorbereiding
Crydogs helpt bedrijven beter vindbaar en herkenbaar te worden in AI-antwoorden, ondersteund door SEO, branding en websiteontwikkeling. Voor bestaande Magento-webshops biedt Crydogs onder meer onderhoud, upgrades, bugfixes en beveiligingspatches, op basis van Magento-ervaring sinds 2008, vroeger bekend als Magento-shops.be. Wilt u de voorbereiding van uw upgrade bespreken? Neem dan contact op via de homepage.
