MariaDB Upgrade

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. Upgrade

    1. 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.

    2. 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