Installation Liquibase

Für die Datenbankversionsverwaltung deines Kieselstein ERP Systemes, wird die Community Edition von Liquibase verwendet.

Es wird dafür die Version 4.30 bis 4.33 benötigt.
Die Version 5.x benötigt Java 17 und kann daher derzeit nicht verwendet werden.

Den Download von github.com starten
bzw. Allgemein

Das oben geht besser Liquibase von herunterladen, auf der Liquibase Seite nicht mehr verfügbar https://sourceforge.net/projects/liquibase.mirror/files/v4.33.0/

Installation Liquibase unter Windows

Für die Datenbankmigrationen muss das Tool liquibase installiert werden.
Aktuelle Liquibase Version vom git Repository runterladen:
https://github.com/liquibase/liquibase/releases
Hier bis zu den Assets runterscrollen und dann den passenden (Windows-)Installer auswählen. Z.B.: liquibase-windows-x64-installer-4.x.x.exe

Den Installer (siehe oben) am Server ausführen und durchklicken.
Bitte darauf achten, dass Add Liquibase to PATH angehakt bleibt.

Achtung nach der Installation von Liquibase müssen für die weiteren Arbeiten neue Eingabeaufforderungen (cmd) gestartet werden! Ein Neustart des Servers ist nicht erforderlich.

ACHTUNG

Das Liquibase ergänzt die Pfad-Angabe nur benutzerspezifisch.
Das bedeutet, wenn du danach das Update unter einem anderen Benutzer machst, hast du keinen Zugriff mehr.
Unsere Empfehlung:
Verschiebe die Pfad-Ergänzung von den Benutzervariablen in die Systemvariablen.

Installation Liquibase unter Linux

Für die Datenbankmigrationen, muss das Tool liquibase installiert werden.
ACHTUNG: Du musst dafür root-Rechte haben z.B. su - root (und dann dein eigenes PW eingeben)

wget -O- https://repo.liquibase.com/liquibase.asc | gpg --dearmor > liquibase-keyring.gpg && \
cat liquibase-keyring.gpg | tee /usr/share/keyrings/liquibase-keyring.gpg > /dev/null && \
echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/liquibase-keyring.gpg] https://repo.liquibase.com stable main' | tee /etc/apt/sources.list.d/liquibase.list

apt-get update

Nun die Liquibase Version 4.33.0 installieren

apt-get install liquibase=4.33.0

Auch hier kannst du prüfen, ob die Installation gegangen ist.

liquibase --version

Hinweis:
Sollte die Installation des Liquibase nicht möglich sein, muss das gpg aktualisiert werden. Vermutlich ist das ein Signal für eine veraltete Installation, daher das gesamte Betriebssystem aktualisieren.

passende Version

Gerne stellen wir dir eine passende Liquibase Version zur Verfügung.
Wende dich diesbezüglich vertrauensvoll an die Kieselstein ERP eG

Liquibase kann nicht updaten

Beim Update sehr alter Versionen kann es anscheinend vorkommen, dass in der Liquibase Protokolldatei der Eintrag, dass das Initiale-Datenbankupdate schon durchgeführt wurde fehlt.
Das bewirkt, dass ein ewig langes Errorlog ausgegeben wird (welches leider nicht in ein File umgeleitet werden kann). Es sind in diesem Dump die Commandos aus dem Initialen changelog 0.0.0 enthalten.

Im Endeffekt bedeutet es, dass der Eintrag in die Protokolltabelle eingetragen werden muss. D.h. z.B. mit dem PGAdmin folgendes Statement ausführen.

INSERT INTO public.databasechangelog(
	id, author, filename, dateexecuted, orderexecuted, exectype, md5sum, description, comments, tag, liquibase, contexts, labels, deployment_id)
	VALUES ('update-db','KES','changelogs/0.0.0/init.xml','2024-11-12 16:55:47.706595',1,'EXECUTED','9:d59fe261b60da8688003077dc5bbf89c','sqlFile path=0_basic_structure.sql; sqlFile path=1_basic_data.sql; sqlFile path=2_basic_constraints.sql','',NULL,'4.30.0',NULL,'0.0.12','1426947719');

Danach erneut

• clear-checksum
• update

ausführen.