DatabaseChangeLogLock gesperrt

Einleitung #

Die Sperre auf der Changelog-Tabelle konnte nicht aufgehoben werden. Der Relution-Dienst startet nicht mehr oder fährt immer wieder neu hoch (Docker). Im Log sind folgende Meldungen zu sehen:

ion.boot.LiquibaseConfig: Relution build version is … []
ion.boot.LiquibaseConfig: Database is … (Data source 'dataSource') []
ion.boot.LiquibaseConfig: Detected database type '…', version '…' []
ion.boot.LiquibaseConfig: Registering Liquibase customizations []
iquibase.MariaDBDatabase: Connected to relution@… []
iquibase.MariaDBDatabase: Setting auto commit to false from true []
vice.StandardLockService: Waiting for changelog lock.... []
vice.StandardLockService: Waiting for changelog lock.... []

Die letzte Meldung wiederholt sich dabei periodisch, bis der Dienst schließlich mit einem Timeout beendet wird und ggf. automatisch neu startet (Docker).

Ursachen #

Beim Start prüft der Relution-Dienst zunächst, ob Datenbank-Updates ausgeführt werden müssen. Um zu verhindern, dass im Cluster-Betrieb zwei Knoten zur selben Zeit das Datenbankschema verändern, wird dazu immer eine Sperre in der DATABASECHANGELOGLOCK-Tabelle gesetzt. Diese wird nach Abschluss der Prüfung und/oder der Updates wieder aufgehoben.

Wird der Relution-Dienst in diesem Zustand hart beendet, so bleibt diese Sperre bestehen. Beim nächsten Startvorgang wartet Relution darauf, dass die Sperre aufgehoben wird, da der Dienst davon ausgeht, dass ein anderer Knoten die Datenbank aktualisiert. Ist das nach ca. 5 Minuten nicht der Fall, beendet sich der Dienst mit einer entsprechenden Fehlermeldung.

Dieser Zustand tritt meist dann auf, wenn Relution während des Ausführens von größeren Datenbankupdates frühzeitig beendet wird, da der Startvorgang ungewohnt lange dauert.

Hier ist dein Text sauber als Markdown formatiert:

DatabaseChangeLogLock Wert ändern #

Nativ #

Um den Zustand zu beheben, kann entweder der (einzige) Eintrag aus der Tabelle DATABASECHANGELOGLOCK entfernt oder der Wert der Spalte LOCKED von 1 auf 0 geändert werden. Je nach Datenbank wird anstelle von 1 ggf. auch True angezeigt und muss entsprechend auf False geändert werden.

Zum Aktualisieren der Datenbank kann das entsprechende Verwaltungstool der Datenbank oder auch eine freie Alternative verwendet werden (BeeKeeper, DBeaver, HeidiSQL, …). Je nach Datenbank ist das Update auch über entsprechende Kommandozeilentools möglich. Im Fall von DBeaver zum Beispiel:

TRUNCATE TABLE DATABASECHANGELOGLOCK;

Die Platzhalter in spitzen Klammern müssen entsprechend mit den Werten aus der application.yml bzw. docker-compose.yml ersetzt werden.

Docker #

Bei einem Docker-Betrieb kann der Befehl zum Entsperren der Tabelle vom Server aus im /opt/relution/ Verzeichnis wie folgt ausgeführt werden:

Beispiel Lang

docker exec -it <containername> \
  mariadb --user=<username> \
        --password=<password> \
        --database=<database> \
        --execute="TRUNCATE TABLE DATABASECHANGELOGLOCK;"

Beispiel Lang ausgefüllt:

docker exec -it docker_mariadb \
  mariadb --user=relution \
        --password=admin123 \
        --database=relution \
        --execute="TRUNCATE TABLE DATABASECHANGELOGLOCK;"

Beispiel Kurz

docker exec -it docker_mariadb mariadb -u <username> -p<password> <database> -e "TRUNCATE TABLE DATABASECHANGELOGLOCK;"

Beispiel Kurz ausgefüllt

docker exec -it docker_mariadb mariadb -u relution -padmin123 relution -e "TRUNCATE TABLE DATABASECHANGELOGLOCK;"

Hinweis Um zu vermeiden, dass das Passwort in der Bash-Historie im Klartext gespeichert wird, kann die Option -p oder --password beim Befehl ohne Passworteingabe verwendet werden. > Dadurch wird das Datenbankpasswort nach Absenden des Befehls interaktiv abgefragt.