Upgrade von MariaDB 10.3 auf 10.6
Das Upgrade von MariaDB auf die Version 10.6 bringt einige Veränderungen mit sich, wovon aber nicht jede Website betroffen ist. Sofern Sie Ihre Websites sowie deren Plugins stets aktuell halten, sollten Sie von dieser Umstellung nichts merken. Für den Fall, dass es wider erwartens zu Problemen bei der Funktionalität Ihrer Website kommen sollte, haben wir in den nachfolgenden Abschnitten einige wichtige Neuerungen für Sie zusammengefasst.
OFFSET
Von dieser Änderung betroffen sind möglicherweise selbst geschriebene oder sehr veraltete Applikationen mit Datenbankzugriff.
Der Name OFFSET (Gross- und Kleinschreibung irrelevant) ist unter MariaDB 10.6 ein neues, reserviertes Schlüsselwort.
Stellen Sie sicher, dass alle Identifikatoren (z.B. Datenbank-, Tabellen- und Spaltennamen) mit diesem Namen immer korrekt zwischen sogenannte Backticks (` `) gesetzt werden.
Beispiel:
MariaDB [user_mydb]> SELECT `offset` FROM `mytable`;
+--------+
| offset |
+--------+
| 10 |
+--------+
1 row in set (0.000 sec)Weitere Informationen dazu finden Sie auf der offiziellen Website von MariaDB:
- https://mariadb.com/kb/en/upgrading-from-mariadb-10-5-to-mariadb-10-6/#reserved-word
- https://mariadb.com/kb/en/reserved-words/
In einem solchen Fall empfehlen wir, direkt Kontakt mit dem Hersteller Ihrer Applikation oder des Plugins aufzunehmen, da die Anpassung nicht serverseitig von Hostpoint übernommen werden kann.
Magento
Magento hat strikte Anforderungen, welche MariaDB-Versionen mit welcher Mangento-Version kompatibel sind.
In der aktuellsten Version von Magento (2.4.5) wird die MariaDB-Version 10.4 vorausgesetzt.
Die Version 2.4.6 ist für März 2023 angekündigt und wird unter anderem auch MariaDB 10.6 unterstützen.
Hinweise zu den Versionen sowie deren Anforderungen finden Sie hier:
- https://experienceleague.adobe.com/docs/commerce-operations/installation-guide/system-requirements.html
- https://experienceleague.adobe.com/docs/commerce-operations/release/versions.html?lang=en
Die Restriktion, um die Version 2.4.5 unter MariaDB 10.6 zu aktualisieren oder zu installieren, können Sie anhand der folgenden Vorgehensvarianten umgehen. Mit beiden Varianten sollte ein Update wie auch eine Installation wieder problemlos funktionieren.
Variante 1 - di.xml anpassen
Eine Variante um das Problem zu umgehen ist, die entsprechende di.xml-Datei anzupassen, in der die Version von MariaDB definiert ist. Dazu müssen Sie in Ihrer Magento-Installation die Datei di.xml finden. Diese befindet sich meistens im Hauptverzeichnis Ihrer Website. In der Datei sollten Sie folgendes (oder ein ähnliches) Schema vorfinden:
<type name="Magento\Framework\DB\Adapter\SqlVersionProvider">
<arguments>
<argument name="supportedVersionPatterns" xsi:type="array">
<item name="MariaDB-(10.2-10.4)" xsi:type="string">^10\.[2-4]\.</item>
</argument>
</arguments>
</type>Passen Sie dieses Schema nun wie folgt an und speichern Sie die Datei ab:
<type name="Magento\Framework\DB\Adapter\SqlVersionProvider">
<arguments>
<argument name="supportedVersionPatterns" xsi:type="array">
<item name="MariaDB-(10.2-10.6)" xsi:type="string">^10\.[2-6]\.</item>
</argument>
</arguments>
</type>
Variante 2 - composer Modul
Eine weitere Variante ist, ein entsprechendes composer-Modul zu verwenden. Diese Variante hat den Vorteil, dass die Änderung auch nach einem Update bestehen bleibt.
Das Modul und weitere Informationen finden Sie hier:
Weitere Informationen
Weitere Informationen zu Neuerungen sowie offizielle Migrationsleitfaden finden Sie auf der Website von MariaDB:
- https://mariadb.com/kb/en/changes-and-improvements-in-mariadb-10-4/
- https://mariadb.com/kb/en/changes-and-improvements-in-mariadb-10-5/
- https://mariadb.com/kb/en/changes-improvements-in-mariadb-106/
Wenn Ihnen die Umstellung technische Probleme bereitet, nehmen sie bitte mit unserem Support Kontakt auf, damit wir eine Lösung finden können.
Wir stehen Ihnen mit unserer Erfahrung gerne helfend zur Seite.
Kontinuierliche Updates schonen die Nerven
Generell lohnt es sich, mit der Technologie stets Schritt zu halten. Wer sein CMS regelmässig und in kleinen Abständen aktualisiert, ist nicht nur bei Sicherheitsthemen klar im Vorteil. Wer seinem CMS keine grossen Versionssprünge (oder Übersprünge) zumutet, minimiert damit auch das Risiko bei Updates enorm. Meist sind die Änderungen bei Updates von einer auf die nächstfolgende Version (z.B. von 2.3 auf 2.4 oder von 1.8.2 auf 1.8.3) überschaubar, gut getestet und von den Entwicklern genau so vorgesehen. Eingesetzte Themes und Plugins überstehen solche kleinen Update-Schritte meistens schadlos.
Das Risiko steigt, wenn man mit den Updates ins Hintertreffen gerät. In diesem Fall können sich viele kleine harmlose Änderungen nach und nach zu Inkompatibilitäten oder zu - nur mit viel Aufwand lösbaren - Abhängigkeiten kumulieren. Eine unangenehme Stresssituation kann dann plötzlich entstehen, wenn man durch den Wechsel der MariaDB-Version unter Zugzwang gerät. Darum empfehlen wir Websitebetreibern, mit geringem Einsatz regelmässig am Ball zu bleiben und so den grossen Update-Problemen vorzubeugen.
Sie können über das Hostpoint Control Panel auch kostenlos ein Backup erstellen und dies im Ernstfall wieder einspielen. Bei Wiederherstellungen durch den Support können Kosten anfallen.