Macht ein Update meines Kieselstein ERP Servers Sinn?
Sollte ich mein Kieselstein ERP aktualisieren
Wie für die Installation deines Kieselstein ERP Servers ab Juni 2025 vorgehen
Wird die Serverinstallation von uns durchgeführt, so benötigen wir, neben den ganzen Zugangsdaten,
Unter Linux wird das kieselstein unter /opt/kieselstein installiert.
Von der Bedeutung her wird die sehr ähnliche Struktur unter Windows auf LW:\kieselstein eingerichtet, wobei hier LW für das Laufwerk der lokalen Kieselstein Installation steht.
In der nachfolgenden Dokumentation verwenden wir immer die Windows-Notation (außer es gibt besondere Gründe dies anders / doppelt darzustellen).
Für Linux bitte einfach das LW: durch /opt und die \(Backslash) durch /(Forward Slash / Schrägstrich) ersetzen.
Ab dem Kieselstein Verzeichnis sind die Strukturen in allen Systemen gleich.
Die Steuerung des Verhaltens deines Kieselstein ERP Servers erfolgt in der Regel (wir können nur dringend dazu raten) mit Environment / Umgebungsvariablen. Für die Beschreibung dieser sei auf LW:\kieselstein\dist\bin\README.md verwiesen bzw. siehe
Weitere verwendete Environment Variablen sind in der jeweiligen Server-Startdateien beschrieben, also LW:\kieselstein\dist\bin\launch-kieselstein-main-server.bat bzw. .sh
Mit der Erfahrung der letzten Jahre raten wir zur Verwendung folgender Verzeichnis-Struktur.
Grundsätzlich ist die Struktur in den Betriebssystemtypen (Linux, Windows, MAC) annähernd gleich. Lediglich die Basispfade unterscheiden sich.
| Betriebssystem | Basispfad |
|---|---|
| Linux | /opt/kieselstein |
| Windows | LW:\kieselstein |
Nach dem LW:\kieselstein gibt es die Verzeichnisse dist und data und eventuell das Client.
Im dist befindet sich immer die aktuell in Verwendung befindliche Version. Dies ist auch in der Datei LW:\kieselstein\dist\VERSION.txt ersichtlich.
Im Client ist die vorbereitete Clientinstalltion enthalten, welche dann als gezippte Version unter LW:\kieselstein\dist\clients\Client.zip zur Verfügung gestellt wird.
Für ein Update wird lediglich das dist Verzeichnis auf dist.Versionsnummer umbenannt und danach aus der heruntergeladenen Zip-Datei siehe das neue dist-Verzeichnis einkopiert.
Es hat sich bewährt, unter Windows, für das Arbeiten mit den tar bzw. gz Dateien, den Totalcommander zu verwenden. Dieser kann alle Pack-Formate auflösen.
Alternativ kann auch 7Zip verwendet werden.
Für die Neuinstallation deines Kieselstein ERP Systems müssen folgende Programme / Dienste / Voraussetzungen gegeben sein.
Nachdem du PostgresQL und das aktuelle Java installiert hast (und diese auch funktionieren) muss deine Kieselstein Datenbank eingerichtet werden. Siehe dazu
Daran anschließend solltest du deinen Kieselstein Server manuell, also in einer Command Shell, starten.
Das Ergebnis muss hier sein, dass der Server Fehlerfrei startet, was bedeutet (leider sind einige Warnings derzeit noch normal) dass unter LW:\kieselstein\dist\wildfly-26.1.2.Final\standalone\deployments<br>
drei deployed Dateien sein müssen (kieselstein-1.0.26.ear.deployed, jackrabbit-jca-2.22.0.rar.deployed, tinymce.war.deployed)
Es darf keine failed Einträge geben.
Da dieser Start einige Minuten dauern kann, abhängig von der Performance deines Servers, wird während des Startens *.dodeploy bzw. *.isdeploying bei obigen drei Dateien angezeigt.
Sollte der Start nicht gelingen, so hilft ein Blick in die Log-Datei unter LW:\kieselstein\dist\wildfly-26.1.2.Final\standalone\log\server.log
Ein weiteres Kennzeichen dass das KES gut gestartet ist, ist die Anzeige im Command Shell von

Für die Installation eines Debian mit anschließender Einrichtung des Kieselstein ERP Servers siehe
Die zu deinem Server passenden Clientdateien findest du unter LW:\kieselstein\dist\clients\kieselstein-client-develop.tar.gz
Hier sind, mehrfach gezippt (LW:\kieselstein\dist\clients\kieselstein-client-develop.tar.gz\kieselstein-client-develop) die beiden Verzeichnisse

bin und lib.
Bewährt hat sich, wenn du dir direkt in deiner Kieselstein-Server-Verzeichnis-Struktur auch ein Verzeichnis Client (neben dist und data) anlegst und in dieses das bin und das lib Verzeichnis einkopierst. Die Struktur sollte wie folgt aussehen.

Info:
Die Anpassung der Dateien unter bin ist nur initial erforderlich. Bei den Updates muss ledglich das lib-Verzeichnis ausgetauscht werden.
Weiteres zu Sprachen am Client siehe
Ab der Version 2 steht die Möglichkeit des setzen der Environmentvariablen für die Adresse deines Kieselstein Servers und der gewünschten Sprache zur Verfügung.
D.h. du musst nur mehr einmal die kieselstein_server_setzen.bat Datei anpassen und diese als Administrator ausführen. Damit können in Zukunft die Startdateien gleich belassen werden.
Zugleich werden beim Aufruf dieser Batch-Datei (kieselstein_server_setzen.bat) die von Kieselstein ERP verwendeten Fonts, LiberationSans, aktualisiert. Diese sind von ihrer Lizenzierung frei und werden in der Version 2 für alle Reports verwendet. Insbesondere für den Versand der eRechnung, welche als XML in Zugferd eingebettet ist, sollten nur wirklich freie Fonts verwendet werden.
Alternativ kannst du aber auch die bisherige Anpassung der unten angeführten Client-Startdateien verwenden. Achte aber darauf, dass die Liberation Sans auf aktuellem Stand ist.
Die Client-Startdateien aus dem Verzeichnis bin müssen einmalig auf Sprache und IP-Adresse angepasst werden. D.h. hier muss der localhost gegen die IP-Adresse deines Kieselstein ERP Servers ausgetauscht werden und gegebenenfalls die Sprachdefinition von de_AT auf z.B. de_DE geändert werden.
| Betriebssystem | Batch Script |
|---|---|
| Linux | kieselstein-client |
| Windows | kieselstein-client.bat |
Wenn der oben beschriebene Start deines Servers funktioniert hat, was die Regel ist, so kannst du nun durch Start des passenden Batch-Scriptes direkt am Server deinen Kieselstein ERP Client starten.
Für Linux-Anwender bzw. generell. Der Client braucht einen entsprechenden grafischen Desktop.
Beim Starten zeigt dir der Client zuerst den Kieselstein Splash-Screen und kommt dann mit dem Anmeldedialog

in dem deine Sprache bereits voreingestellt ist.
Du solltest nun diese angepassten Clientdateien deinen Anwendern zur Verfügung stellen, in dem das Clientverzeichnis (LW:\kieselstein\Client) gezippt wird und unter LW\kieselstein\dist\clients\Client.zip zur Verfügung gestellt wird. siehe client vom Browser installieren.
Sind obige Punkte positiv verlaufen, so sollte dein Kieselstein ERP Server als Dienst / Service eingerichtet werden. Dazu:
| Betriebssystem | Install Script |
|---|---|
| Linux | linux/install-kieselstein-services.sh |
| Windows | windows\install-kieselstein-services.bat |
ausführen. Bitte immer direkt aus dem jeweiligen Verzeichnis. 3. den jeweiligen Service starten
| Betriebssystem | Service Start Kommando |
|---|---|
| Linux | systemctl start kieselstein-main-server.service (wird bei der Installation mit gestartet und enabled) |
| Windows | in den Services starten |
Auch hier solltes du im deploy Verzeichnis (LW:\kieselstein\dist\wildfly-26.1.2.Final\standalone\deployments) prüfen, dass der Kieselstein ERP Server tatsächlich gestartet ist.
Damit ist die Installation abgeschlossen.
Achte darauf, dass auch auf deinem Server die gleichen Liberation Sans Schrift, wie für den Client zur Verfügung gestellt, verwendet wird.
wir verwenden gerne auch noch:
apt install mc
sudo apt install doublecmd-gtk
danach mit doublecmd starten
Da üblicherweise kein root installiert wird, man aber die Rechte braucht, einfach mit su root und dem eigenen PW anmelden.
ip address
Wir freuen uns über jedeN der uns beim Testen der aktuellen Software hilft. Insofern stehen unter dem Link die latest Release und ein aktueller Build zur Verfügung.
D.h. über den Link kommst du zum Repository des Kernsystems von Kieselstein ERP. 
Nun kannst du durch Klick auf Latest Release
die letzte gültige Version herunterladen.
Alternativ bekommst du den aktuellen Stand durch Klick auf
, welche den neuesten von der Technik / Softwareentwicklung zur Verfügung dargestellten Stand darstellt.
Um die Latest Release, zu finden auch unter direkt herunter zu laden, klicke auf den Button und dann auf

Leider ist die Kennzeichnung der Dateien im Gitlab nicht immer einheitlich. D.h. es kann auch anstatt Pakete mit sonstiges bezeichnt sein.

Beachte bitte unbedingt die unter Versionshinweise

angegebenen Punkte.
Entzippe aus dieser Datei das dist Verzeichnis nach LW:\kieselstein\dist
Lege parallel dazu ein Verzeichnis data (LW:\kieselstein\data) an
Es werden aktuell ausschließlich PostgresQL Version 14 und 15 unterstützt. Ab der Kieselstein ERP Version 2 solltest du Postgres 18 verwenden. MS-SQL wird nicht unterstützt. Für eine eventuelle Konvertierung deiner MS-SQL Datenbank wende dich bitte an die Kieselstein ERP eG. Neuere PostgresQL Versionen können funktionieren, sind aber aktuell von uns nicht freigegeben.
Bei der Installation darauf achten, dass nur PostgresSQL Server und die Command Line Tools installiert werden.

Bei der Installation muss auch das default Passwort für den User Postgres angegeben werden (postgres). Beachte in diesem Zusammenhang auch die Themen der Datenzugriffssicherheit. Aktuell kann das Datenbankpasswort durch die Environmentvariable MAIN_DB_PASS übersteuert werden.
Bitte prüfe, dass auch der Port auf 5432 vorgeschlagen wird.
Beachte, dass die Installation in Windowssystemen idealerweise auf einem eigenen Laufwerk erfolgt. Also z.B. nicht auf C: sondern, vom Betriebssystem unabhängig auf z.B. D:
Für die Installation benötigst du auch
Denke daran die Postgres einzustellen. Siehe
ACHTUNG:
Wenn du bestehende Daten übernimmst, schau im Kieselstein ERP Wiki nach.
Ab der Version 1.x.x steht eine leere Datenbank zur Verfügung.
D.h. mit LW:\kieselstein\dist\bootstrap\liquibase\createdb.bat bzw. .sh (4x postgres PW eingeben) legst du die grundsätzlichen Datenbanken an.
Wenn du die vorbereiteten Daten verwenden willst, dann bitte jetzt einlesen und erst danach mit dem Liquibase Update weiter.
Führe nun aus dem Liquibaseverzeichnis (LW:\kieselstein\dist\bootstrap\liquibase) mit *run-liquibase.bat update * bzw. liquibase.sh update aus und erzeuge damit eine leere aber funktionsfähige Datenbank.
ACHTUNG: Liquibase ab Version 4.29 verlangt Java 11
Aktuell bitte maximal Liquibase Version 4.xx verwenden. Die Liquibase Version 5 hat andere Datenstrukturen. Eine entsprechende Adaptierung ist in Planung.
Bitte verwende aktuell nur IP V4, sowohl für den Zugriff auf den Datenbank-Server als auch für die Kommunikation von den Clients mit deinem Kieselstein ERP Server.
Die abschließende Meldung nach dem Rechner-Neustart kann ignoriert werden.
Es gibt noch weitere optionale Environment-Variablen welche in der README.md Datei bei den Start-Scripten (im KIESELSTEIN_DIST/bin/) beschrieben sind.
Wir haben für Testzwecke eine sehr kleine und einfache Musterdatenbank eingerichtet. Diese findest du hier. Bitte beachte:

Führe hier bitte das restore_Demodaten.bat aus. Das Ergebnis sollte wie folgt aussehen.

Eine weitere Variante sind Demodaten in deDE und ohne Fibu. Diese findest du hier. Bitte beachte:
D.h. anstatt des restore_Demodaten.bat führst du das restore_Demodaten_DE_OF.bat aus.
Diese Daten müssen auf die aktuelle Datenbankversion gehoben werden.
D.h. bevor du mit der Installation fortfährst, muss je nach Betriebssystem das Datenbankupdate ausgeführt werden.
| Betriebssystem | Basispfad |
|---|---|
| Linux 1. | /opt/kieselstein/dist/bootstrap/liquibase/liquibase.sh changelog-sync –label-filter=“0.0.12” |
| Linux 2. | /opt/kieselstein/dist/bootstrap/liquibase/liquibase.sh update |
| Windows | LW:\kieselstein\dist\bin\initial.bat |
Eine lose Sammlung von Tipps, KnowHow und ähnlichem für den/die Consultant im Rahmen der Installation.
ACHTE immer auf die Sicherheit Durch das Öffnen von Ports, gibt es natürlich auch mehr Möglichkeiten das System anzugreifen. Also denke auch an die Verwendung von VPN Tunnel usw..
Dass Betriebssystem, Virenscanner und Firewall immer aktuell sind, ergibt sich schon aus der DSGVO.
Die Themen rund um die Sicherheit, Passwörter abweichend vom default usw. sind im Web ausreichend abgehandelt. Kieselstein ERP eG Mitglieder schauen im Wiki unter dem Suchwort Sicherheit nach.
| Port | Zweck |
|---|---|
| 8080 | für den Zugriff auf den Kieselstein ERP Applikationsserver inkl. RestAPI |
| 5432 | für den Zugriff auf die Postgres-Datenbank |
| 22 | für Linux, SSH Kommunikation |
Das sind die Standard Ports. Diese können, z.B. für weitere parallele Installationen am gleichen Rechner auch abweichen.
Siehe dazu auch: LW:/kieselstein/dist/bin/launch-kieselstein-main-server.bat bzw. .sh
Hier sollte zusätzlich der gewünschte Netzwerkkreis eingetragen werden, mit dem auch ein Zugriff erlaubt ist. Beispiel:
was bedeutet, dass aus dem Subnetz xx alle IP-Geräte die ein Passwort wissen auf die Datenbank zugreifen können.
Die pg_hba.conf findest du, je nach Betriebssystem unter:
| Betriebssystem | Pfad | Bemerkung |
|---|---|---|
| Windows(R) | LW:\Programm Files\PostgreSQL\VV\data\ | |
| Debian | /etc/postgresql/14/main | Achtung: Wenn englisch installiert, muss der datestyle auf ‘ios, dmy’ gestellt werden. |
| Ubuntu | /etc/postgresql/14/main | ev. muss zusätzlich in der postgresql.conf listen_addresses=’*’ gestellt werden |
| iOS | .. |
ACHTUNG: Wenn auf dem Kieselstein ERP Server die IP Adresse verändert wurde, so muss danach unbedingt der Kieselstein ERP Server neu gestartet werden.
Vom Client aus auf http://Kieselstein-ERP-SERVER-IP-Adresse:8080 gehen.

Auf der Willkommensseite findest du links unten den Link zu download clients.
hier werden alle Dateien angezeigt die im Server unter LW:\Kieselstein\dist\clients zur Verfügung stehen. D.h. üblicherweise werden hier die angepassten LW:\Kieselstein\dist\client Verzeichnisse als Client.zip einkopiert und somit dem Anwender zur Verfügung gestellt.
Bewährt hat sich auch, dass hier ein aktuelles Java (das gleiche wie für den Server) für den Client hinterlegt wird.
Der Basis-Link für das erprobte Zulu Java findest du unter https://www.azul.com/downloads/?package=jdk#zulu
Hier dann für Server und Client nur Java 11 mit jdk-FX verwenden.

Für Windows-User empfiehlt sich die .msi herunterzuladen.
Darauf achten, dass bei der Installation das Java Home
gesetzt wird.
Prüfen, dass auch installiert durch Command Shell, Java -version

Bitte achte massivst darauf, dass auch in virtuellen Betriebsumgebungen ausreichen Ram zur Verfügung steht. Es kommt leider immer wieder vor, dass manche IT-Betreuer glauben, der VM ausreichend Platz gegeben zu haben, es kommt dieses RAM aber bei der VM nicht an. Hier empfiehlt sich, eine fixe Speicher Zuweisung zu verwenden.
Für Start und Stop des Kieselstein ERP Servers geht man üblicherweise wie folgt vor:



Automatisch Verzögerter Start (da die PostgresQL vorher starten muss)Gegebenenfalls den Kieselstein Service nun auch noch starten. 
systemctl start kieselstein-main-server.service
systemctl stop kieselstein-main-server.service
Sollte, je nach Betriebssystem der Start des Dienstes nur direkt aus dem Dinesteverzeichnis möglich sein, hier eine Aufstellung wo du was findest.
| Betriebssystem | Pfad |
|---|---|
| Debian | /etc/systemd/system/, |
so läuft der Zugriff grundsätzlich. Nun den Client beenden und dann den Server (mit Strg+C) stoppen und mit der Einrichtung des Serverdienstes fortsetzen.Fehlermeldung beim Einrichten des Dienstes
Kommt beim Einrichten des Dienstes die Meldung
so bedeutet dies “nur”, dass bisher kein Kieselstein ERP Dienst eingerichtet ist (und nicht upgedated werden konnte).
Du findest trotzdem nun die neu eingerichteten
in den Windows-Diensten.
Unter Linux ist es nicht üblich sich als Root anzumelden. Dafür gibt es die sogenannten Sudo Rechte. D.h. nur User die in der Sudo Liste eingetragen sind, können sich mit einem der folgenden Commands entsprechende Rootrechte holen.
Für das Update deiner Kieselstein ERP Installation sind folgende Schritte erforderlich. Natürlich must du auch hier die entsprechenden Rechte haben.
Sollte es zu Checksum-Probleme des Liquibase Datenbank-Verwaltungs-Managers kommen, so
und danach erneut bei Datenbank-Update weiter.
Eine Kurzfassung aller unter Debian durchzuführenden Commandos.
Voraussetzung das neue Release ist bereits heruntergeladen und liegt im Download Verzeichnis.
Du bist root / mit Root-Rechten (sudo -s) angemeldet
systemctl stop kieselstein-main-server.service
cd /opt/kieselstein
mv dist dist.alte_Versionsnummer
cd /home/BENUTZER/Downloads
tar -xvf kieselstein-distpack-1.1.13.tar.gz -C /opt/kieselstein
cd /opt/kieselstein
chmod -R 777 dist
cd /opt/kieselstein/dist/bootstrap/liquibase/
./liquibase.sh clear-checksums
./liquibase.sh update
systemctl start kieselstein-main-server.service
cd /opt/kieselstein/dist/clients
tar -xvf kieselstein-client-1.1.13.tar.gz
Danach noch die Startdatei, aus cd /opt/kieselstein/dist/clients/kieselstein-client-1.1.13/bin/ anpassen.
Ab der Version 1.1.13 können für Server und Sprache (locale) auf den Clients auch die Environmentvariablen verwendet werden:
| Environment | Beschreibung | mögliche Werte |
|---|---|---|
| KIESELSTEIN_SERVER | IP Adresse des Kieselsteinservers | nur IP V4 |
| KIESELSTEIN_LOCALE | Die Anmeldesprache des Clients | de_AT de_DE de_CH en_US it_IT sl_ |
| KIESELSTEIN_EXPERIMENTAL_OPENGL | Verwendet die Grafikbeschleunigung | true |
Nach der Anpassung der Client Dateien diese wiederum komprimieren und den Benutzern unter … zur Verfügung stellen.
tar -cvf ../../client.tar
Somit findest du dann im Verzeichnis /opt/kieselstein/dist/clients das erzeugte client.tar, welches du an die Benutzerausrollen kannst. Nutze dafür http://dein_Kieselstein_server:8080
Für den unwahrscheinlichen Fall, dass du das Datenbank-Update deines Kieselstein ERP nicht zum Laufen bekommst und unter der Voraussetzung, dass du nach obiger Anleitung / Reihenfolge vorgegangen bist, muss für das Fallback nur:
Sollte damit dein Kieselstein ERP nicht starten, so muss auch noch das gültige Datenbankupdate eingespielt werden. Da in aller Regel keine Änderungen an der Dokumentendatenbank durchgeführt werden, reicht der Datenbankrestore der KIESELSTEIN.
Tipp / Empfehlung:
Melde dich bitte bei der Technik, mit welchen Fehlern du nicht weiter gekommen bist.
Meist wünscht sich die Technik, dann auch ein entsprechendes Backup, der Datenbank.
Sollte ich mein Kieselstein ERP aktualisieren
Desasterrecovery, Restore
Installation Kieselstein ERP Server unter Debian
Installation Kieselstein ERP Server unter Ubuntu
Installation Kieselstein ERP Server unter Windows(r)
Installation Kieselstein ERP Server unter Windows
Installation Kieselstein ERP Server unter macOS
Muss ich regelmäßig updaten und wenn ja, was?
Anforderungen an den Kieselstein ERP Server
Einige Gedanken zur Datensicherung
Was sind die Aufgaben deines IT-Betreuers
Wo werden meine Dokumente gespeichert
Einstellungen an der Postgres
Installation Liquibase für dein Kieselstein ERP