Plan het terugdraaien vóór de upgrade begint: maak een back-up van code, media en database, spreek af wanneer u besluit terug te gaan en oefen het terugzetten eerst op een testomgeving. Volgens Adobe merkt u een mislukte upgrade doordat de winkel daarna niet goed laadt.
Wat Adobe zegt over back-ups
Magento heeft de opdracht bin/magento setup:backup, waarmee u een back-up maakt van de bestanden, de map pub/media en de database. Terugzetten gaat met bin/magento setup:rollback, op basis van de bestandsnaam van de back-up. Adobe markeert deze back-upfunctie wel als verouderd sinds versie 2.1.16, 2.2.7 en 2.3.0. Adobe raadt aan om andere back-uptechnieken te onderzoeken, zoals Percona XtraBackup.
Adobe waarschuwt dat een rollback stil kan mislukken, waarbij onvolledige gegevens worden teruggezet. Adobe adviseert daarom de open files limit op 65536 of hoger te zetten en geen waarde voor pcre.recursion_limit in php.ini in te stellen. Tijdens de upgrade zelf beschrijft Adobe het maken van een kopie van composer.json.
Bruikbare stappen
- Maak vóór de upgrade een back-up van database, code en media en test of het terugzetten op een testomgeving werkt.
- Bewaar een kopie van composer.json en composer.lock van vóór de upgrade.
- Spreek vooraf af bij welke fouten of na hoeveel tijd u besluit tot terugdraaien.
- Plan de upgrade op een rustig moment en zet de winkel tijdens de upgrade in onderhoudsmodus.
- Controleer na de upgrade of de winkel goed laadt en of een testbestelling lukt.
- Noteer welke bestellingen na de upgrade binnenkomen, zodat ze na het terugdraaien niet verloren gaan.
Waarom alleen composer.json niet genoeg is
Volgens Adobe werkt bin/magento setup:upgrade tijdens de upgrade het databaseschema en de gegevens bij. Een oude composer.json zet dus wel de pakketten terug, maar niet de database. Voor een volledig herstel is een databaseback-up van vóór de upgrade nodig, plus een plan voor bestellingen die intussen zijn binnengekomen.
Veelgestelde vragen
Is setup:backup nog een goede keuze? Niet als enige middel, want Adobe noemt de functie verouderd en raadt aan andere back-uptechnieken te onderzoeken.
Waarom het terugzetten vooraf oefenen? Adobe waarschuwt dat een rollback stil kan mislukken. Een oefening op een testomgeving laat zien of de back-up echt bruikbaar is voordat u erop moet vertrouwen.
Wie beslist over terugdraaien? Spreek dat vóór de upgrade af met de beheerder van de winkel. Dan hoeft niemand tijdens een storing nog te overleggen over wie de knoop doorhakt.
Crydogs verzorgt onderhoud, upgrades, bugfixes en beveiligingspatches voor bestaande Magento-webshops, met Magento-ervaring achter de dienst sinds 2008. Wilt u een upgrade met een uitgewerkt terugzetplan, neem dan contact met ons op via https://crydogs.com/#contact.
