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 oder auch von Sourceforge

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

Da dies nicht mehr geht, von Github herunterladen

nun das Verzeichnis anlegen:

sudo mkdir /opt/liquibase

Danach
in dein Download Verzeichnis wechseln und

sudo tar -xzf liquibase-4.33.0.tar.gz -C /opt/liquibase

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

liquibase --version

Und die Pfad Definition erweitern:

nano ~/.bashrc
export PATH="$PATH:/opt/liquibase"

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.