Sie sollten mariadb-upgrade nach dem Upgrade von einer MySQL/MariaDB-Hauptversion auf eine andere ausführen. Sie müssen mariadb-upgrade auch nach einer direkten horizontalen Migration verwenden. mariadb-upgrade kann auch für kleinere Upgrades verwendet werden, da sich nichts ändert, solange keine Inkompatibilitäten vorliegen.

Vorbereitung/Check

Wenn im MariaDB-Log die Meldung "MariaDB upgrade information missing, assuming required" enthalten ist, müssen Sie den nachfolgenden Ablauf durchführen.

Mögliche Symptome

• Fehler im Fehlerprotokoll: Einige Systemtabellen enthalten nicht alle benötigten Spalten.
• Aktualisierungen oder Suchvorgänge finden möglicherweise nicht den Datensatz, nach dem sie suchen oder aktualisieren möchten.
• CHECKSUM TABLE meldet möglicherweise die falsche Prüfsumme für MyISAM- oder Aria-Tabellen.
• Die Fehlermeldung „Kann nicht aus mysql.proc geladen werden. Die Tabelle ist wahrscheinlich beschädigt.“

Ablauf

1. Datenbank-Backup durchführen
2. a) Docker-Umgebung
   1. Offizielle Dokumentation: https://mariadb.com/kb/en/mariadb-server-docker-official-image-environment-variables/
   2. Alle Services herunterfahren: docker-compose down
   3. docker-compose.yml den Service mariadb um die "environment" Variablen "MARIADB_AUTO_UPGRADE: 1" und "MARIADB_DISABLE_UPGRADE_BACKUP: 1" ergänzen
   4. Den MariaDB-Service starten: docker-compose up -d mariadb
   5. Warten, bis in MariaDB-Log der komplette Update-Prozess fertig ist.
   6. Den MaraiDB-Service herunterfahren: docker-compose down mariadb
   7. Bei Bedarf: Die neue Environment-Variable wieder entfernen
   8. Alle Services hochfahren: docker-compose up -d
3. b) Native Umgebung
   1. Offizielle Dokumentation: https://mariadb.com/kb/en/mariadb-upgrade/

Kontrolle

Im MariaDB-Log muss beim Startup-Prozess die Meldung "MariaDB upgrade not required" enthalten sein