Update Kieselstein ERP Server unter Debian

Update Kieselstein ERP Server unter Debian

Applicationsserver Updaten

  • Dist-Pack auf den Server kopieren
  • Dienste beenden
    • systemctl stop kieselstein-main-server.service
    • systemctl stop kieselstein-rest-server.service
  • Alte Programmdateien löschen:
    • rm /opt/kieselstein/dist/wildfly-*.Final/standalone/deployments/*.ear
    • rm /opt/kieselstein/dist/wildfly-*.Final/standalone/deployments/*.war
    • rm /opt/kieselstein/dist/wildfly-*.Final/standalone/deployments/*.rar
    • rm /opt/kieselstein/dist/apache-tomcat-*/webapps/*.war
  • Dist-Packet über die bestehende Installation entpacken
    • tar -xvf <pfad-zum-dist-packet>.gz -C /opt/kieselstein
  • Client-Scripte anpassen
    • Es muss geprüft werden, ob es manuelle Änderungen im Client-Paket für die Startskripte gab und diese eventuell bei den neuen Startscripten nachzeihen (Hostname und Splashscreen zum Beispiel).
    • Alte Client-Scripte löschen oder klar markieren als OLD (Siehe im Verzeichnis /opt/kieselstein/dist/clients/)
  • Berechtigungen wieder für den Kieselstein Ordner setzen
    • chown -R kieselstein:kieselstein /opt/kieselstein
  • Wenn im dist-Verzeichnis mehrere Tomcat oder Wildfly Versionen enthalten sind prüfen welche verwendet wird und die alten löschen
    • Prüfen welche Tomcat-Version verwendet wird:
      • cat /opt/kieselstein/dist/bin/launch-kieselstein-rest-server.sh
      • Suche nach Zeile: export CATALINA_HOME="${KIESELSTEIN_DIST}/apache-tomcat-x.x.x", diese Tomcat Version wird verwendet die andere(n) müssen gelöscht werden.
    • Prüfen welche Wildfly-Version verwendet wird:
      • cat /opt/kieselstein/dist/bin/launch-kieselstein-main-server.sh
      • Suche nach Zeile: wildfly_bin_dir=${KIESELSTEIN_DIST}/wildfly-x.x.x.Final/bin, diese Wildfly Version wird verwendet die andere(n) müssen gelöscht werden.
      • Achtung Aktuell sind im Wildfly noch die Reports dateien enthalten so wie eventuelle Anwender-Reports.
        • Es müssen wenn sich die Wildfly Version ändert vor dem Löschen des alten Wildfly Ordners alle Anwender-Reports in den neuen Wildfly kopiert werden.
        • /opt/kieselstein/dist/wildfly-.Final/server/helium/report//anwender

Datenbankmigrationen durchführen

Hinweis: Wenn Kieselstein Version kleiner als 0.0.13 ist:

Muss die initiale Migration gemacht werden.
Das gilt auch für den Start mit den Demodaten.

Installation Liquibase

Für die Datenbankmigrationen, muss das Tool liquibase installiert werden (mit root Rechten).

wget -O- https://repo.liquibase.com/liquibase.asc | gpg --dearmor > liquibase-keyring.gpg && \
cat liquibase-keyring.gpg | sudo 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' | sudo tee /etc/apt/sources.list.d/liquibase.list
apt-get update
apt-get install liquibase

Initial-Migrationen setzen

  • In das Liquibase Verzeichnis gehen
    • cd /opt/kieselstein/dist/bootstrap/liquibase
    • Bestehende Datenstrukturen als bereits migriert markieren
      • ./liquibase.sh changelog-sync --label-filter="0.0.12"

ACHTUNG Wenn die Datenbank von der Default-Installation abweicht müssen in der /opt/kieselstein/dist/bootstrap/liquibase/liquibase.properties Datei die Verbindungseinstellungen angepasst werden:

liquibase.command.url=jdbc:postgresql://localhost:5432/KIESELSTEIN
liquibase.command.username=postgres
liquibase.command.password=postgres

Datenbank Updaten

cd /opt/kieselstein/dist/bootstrap/liquibase
./liquibase.sh update

Dienste wieder aktivieren

systemctl start kieselstein-main-server.service
systemctl start kieselstein-rest-server.service