DatabaseChangeLogLock gesperrt

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 []
liquibase.lockservice   : Waiting for changelog lock.... []
liquibase.lockservice   : Waiting for changelog lock.... []

Die letzte Meldung wiederholt sich dabei periodisch, bis der Start nach Ablauf der Wartezeit mit einer Meldung wie Could not acquire change log lock. Currently locked by <host> since <zeitpunkt> abbricht und der Dienst 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.

Die Spalten LOCKEDBY und LOCKGRANTED der Tabelle DATABASECHANGELOGLOCK zeigen, welcher Host die Sperre seit wann hält. Im Cluster-Betrieb wird vor dem Entsperren sichergestellt, dass alle Relution-Knoten gestoppt sind und tatsächlich keine Datenbankmigration mehr läuft.


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, …). Das folgende SQL-Statement kann in einem SQL-Editor (z. B. DBeaver) oder über das Kommandozeilentool der Datenbank (z. B. mariadb, psql) ausgeführt werden:

TRUNCATE TABLE DATABASECHANGELOGLOCK;

Docker

Bei einem Docker-Betrieb kann der Befehl zum Entsperren der Tabelle vom Server aus im /opt/relution/ Verzeichnis ausgeführt werden. Der Befehl hängt von der verwendeten Datenbank ab.

Die Platzhalter in spitzen Klammern werden durch die Werte aus der application.yml bzw. der compose.yaml (bei älteren Installationen docker-compose.yml) ersetzt.

PostgreSQL

Bei einer Installation nach der aktuellen Anleitung Docker (empfohlen) → läuft die Datenbank im Container database.

Beispiel

docker exec -it <containername> psql -U <username> -d <database> -c "TRUNCATE TABLE DATABASECHANGELOGLOCK;"

Beispiel ausgefüllt

docker exec -it database psql -U relution -d relution -c "TRUNCATE TABLE DATABASECHANGELOGLOCK;"

Fragt psql nach einem Passwort, steht es bei einer Installation nach der aktuellen Docker-Anleitung in der Datei /opt/relution/secrets/postgres_password.

MariaDB

Ältere Installationen, die noch nicht auf PostgreSQL migriert wurden, verwenden MariaDB.

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 <containername> 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;"
Um zu vermeiden, dass das Passwort in der Bash-Historie im Klartext gespeichert wird, kann beim mariadb-Befehl die Option -p oder --password ohne Passwortwert angegeben werden (z. B. -p statt -p<password>). Dadurch wird das Datenbankpasswort nach Absenden des Befehls interaktiv abgefragt.

Wie hilfreich war dieser Artikel?