DatabaseChangeLogLock verrouillé

Le verrou sur la table changelog n’a pas pu être supprimé. Le service Relution ne démarre plus ou continue à redémarrer (Docker). Le journal affiche les messages suivants :

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.... []

Le dernier message se répète périodiquement jusqu’à ce que le démarrage soit interrompu à l’issue du délai d’attente avec un message tel que Could not acquire change log lock. Currently locked by <host> since <horodatage> et que le service redémarre automatiquement si nécessaire (Docker).


Causes

Au démarrage, le service Relution vérifie d’abord si les mises à jour de la base de données doivent être exécutées. Pour éviter que deux noeuds ne modifient le schéma de la base de données en même temps en mode cluster, un verrou est toujours placé dans la table DATABASECHANGELOGLOCK à cette fin. Ce verrou est libéré une fois que le contrôle et/ou les mises à jour sont terminés.

Si le service Relution est arrêté dans cet état, ce verrou reste en place. Au prochain démarrage de Relution, il attend que le verrou soit libéré car le service suppose qu’un autre nœud est en train de mettre à jour la base de données. Si ce n’est pas le cas après environ 5 minutes, le service se termine avec un message d’erreur approprié.

Cette situation se produit généralement lorsque Relution se termine prématurément au cours de l’exécution de mises à jour importantes de la base de données, car le processus de démarrage prend un temps anormalement long.

Les colonnes LOCKEDBY et LOCKGRANTED de la table DATABASECHANGELOGLOCK indiquent quel hôte détient le verrou et depuis quand. En mode cluster, il convient de s’assurer avant le déverrouillage que tous les nœuds Relution sont arrêtés et qu’aucune migration de la base de données n’est réellement en cours.


Natif

Pour résoudre le problème, il est possible de supprimer l’unique entrée de la table DATABASECHANGELOGLOCK, ou de modifier la valeur de la colonne LOCKED de 1 à 0. Selon la base de données, 1 peut également s’afficher comme True et doit alors être changé en False.

Pour mettre à jour la base de données, l’outil de gestion de la base de données ou une alternative gratuite (BeeKeeper, DBeaver, HeidiSQL, …) peut être utilisé. L’instruction SQL suivante peut être exécutée dans un éditeur SQL (par ex. DBeaver) ou via l’outil en ligne de commande de la base de données (par ex. mariadb, psql) :

TRUNCATE TABLE DATABASECHANGELOGLOCK;

Docker

Pour une configuration Docker, la commande permettant de déverrouiller la table peut être exécutée depuis le serveur dans le répertoire /opt/relution/. La commande dépend de la base de données utilisée.

Les espaces réservés entre chevrons sont remplacés par les valeurs du fichier application.yml ou compose.yaml (docker-compose.yml pour les installations plus anciennes).

PostgreSQL

Pour une installation selon le guide actuel Docker (Recommandé) →, la base de données s’exécute dans le conteneur database.

Exemple

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

Exemple rempli :

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

Si psql demande un mot de passe, celui-ci se trouve dans le fichier /opt/relution/secrets/postgres_password pour une installation selon le guide Docker actuel.

MariaDB

Les installations plus anciennes qui n’ont pas encore été migrées vers PostgreSQL utilisent MariaDB.

Exemple long

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

Exemple long rempli :

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

Exemple court

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

Exemple court rempli :

docker exec -it docker_mariadb mariadb -u relution -padmin123 relution -e "TRUNCATE TABLE DATABASECHANGELOGLOCK;"
Pour éviter que le mot de passe ne soit enregistré en clair dans l’historique Bash, il est possible d’indiquer l’option -p ou --password de la commande mariadb sans valeur (par exemple -p au lieu de -p<password>). Le mot de passe de la base de données est alors demandé de manière interactive après l’envoi de la commande.

Cet article a-t-il été utile ?