Das ist eine für den Ausdruck optimierte Ansicht des gesamten Kapitels inkl. Unterseiten. Druckvorgang starten.

Zur Standardansicht zurückkehren.

Installation Kieselstein ERP Version Java21

Installation des Kieselstein ERP unter Java 21

Eine lose Sammlung der Änderung gegenüber der Java11 Installation.
Getestet unter

  • Windows11, Windows2019
  • Debian13

Basisversionen

Herunterladen der neuen Release wie üblich von Gitlab Kieselstein Releases

Java21 FX von Azul

  • Java Home überschrieben, Java11 aber am Rechner belassen.
  • Path angepasst

Wenn du, warum auch immer, auch eine andere, z.B. Java11 Installation auf deinem Rechner installieren willst, beachte untenstehendes.

Postgres 18.4-1

  • vor der Installation bestehendes Postgres in den Services deaktivieren
  • d:\Program Files\PostgreSQL\18
  • für die Übertragung der Daten achte auf
  • Windowsanwender ändern für den Kieselstein-Server auch noch den Path auf die Postgres18, also z.B. von LW:\Program Files\PostgreSQL\15\bin\ auf LW:\Program Files\PostgreSQL\18\bin

Denke daran die Postgres einzustellen. Siehe

Info:
Mit der Debian 13 wird default die PostgresQL 17 zur Verfügung gestellt. Laut aktuellem Wissensstand kann diese gerne verwendet werden. Beachte bei einem allfälligen Update der PostgresQL jedoch, das unter Update Postgres beschriebene.

PGadmin 4, V 9.9

gerne auch neuer

Liquibase

Achte darauf das Liquibase 4.33.0 zu verwenden. Bitte derzeit keine 5er Version des Liquibase verwenden.
Bei der Installation das Bestehende Installation entfernen lassen verwenden.

Liquibase 4.33.0 kann auch mit Java21 betrieben werden.

Terminal 1.0 testen

Wir freuen uns wenn du im Zuge des Gesamt-Tests sowohl das Zeiterfassungsterminal in allen drei Ausführungen als auch die Mobile Android App mit-testes.
D.h. bitte von herunterladen

Kieselstein Server

  • Struktur wie unter Java11, z.B. aus der 1.1.x gehabt belassen
  • Benennung als dist belassen
  • Das bedeutet auf einem Rechner installiert auf dem nur mehr Java21 verwendet wird
  • data aus Java11 belassen, keine Änderungen

Reports

Es kann / sollte nur mehr JasperStudio 6.21.5 verwendet werden.
Für die Verwendung von JasperStudio 7 sind gröbere Umstellungen erforderlich. Dies wird in einem eigenen Projekt realisiert.

Da JasperStudio 6.21.3 nur bis zu Java 20 unterstützt, wir aber nun Java 21 verwenden, muss das Jasperstudio 6.21.5 verwendet werden.
Dafür zusätzlich zu den üblichen Einstellungen noch folgende Umstellungen treffen:

  • Window, Preferences

    Java, Compiler auf Java 21 stellen
  • Zusätzlich in ?:\Program Files\jaspersoftstudio\Jaspersoft Studio.ini
    den Eintrag unter vm von features/jre.win32.win32.x86_64.feature_17.0.8.1_1/eclipsetemurin_jre/bin auf dein eigentliches Java Home stellen, sodass dies z.B. wie folgt aussieht:
-vm
c:\Program Files\Zulu\zulu-21\bin

Bzw. wenn beim kompilieren die Fehlermeldung

java.lang.RuntimeException: java.lang.UnsupportedClassVersionError: com/lp/util/report/PositionRpt has been compiled by a more recent version of the Java Runtime (class file version 65.0), this version of the Java Runtime only recognizes class file versions up to 61.0

kommt, so obigen Änderung durchführen.

Anpassung des ClassPath

Zusätzlich muss, für den richtigen HelperReport auch die Java21 kieselstein-ejb-2.x.x.jar hinterlegt sein.

weitere Fehler Möglichkeiten:

  • HelperReport cannot be resolved to a type

    Ursache: Ungültige Client ejb im Classpath
    Abhilfe: auch hier wie oben beschrieben die Java21 kieselstein-ejb-2.x.x.jar hinterlegen.

Hinweis:
Wenn man alle bisher verwendeten QR Codes durch die QR-Codes aus dem Jasper Studio 6.21.5 ersetzt, sind die beiden Libraries:

  • core-3.2.1.jar
  • javase-3.2.1.jar

nicht mehr erforderlich.

XSL Vorlage vereinheitlicht

Bisher gab es für EMail (XSL) Definition des Angebotes eine eigene Vorlage (LW:\dist\wildfly-26.1.2.Final\kieselstein\reports\angebot\angb_angebot.xsl). Diese wurde in der Version 2 entfernt.
Solltest du diese alte Vorlage verwendet haben, so kopiere diese aus obigem Verzeichnis deiner Version 1.x.x nach LW:\data\reports\angebot.

Das hat den Vorteil, dass die allgemeinen xsl Definitionen auch für das Angebot greifen.

Barcodes

Im JasperStudio 6.21.x steht auch das QR-Barcode Format zur Verfügung.
Idealerweise sollte alle Reports, die nicht mehr im iReport bearbeitet werden, durch den integrierten QR-Code ersetzt werden. ACHTUNG: Wird der QR Code im Report verwendet, kann er im iReport nicht mehr geöffnet werden.

Installation

Für das Einspielen in eine komplette Postgres-Neuinstallation gehe wie unter Desaster Recovery beschrieben vor. Es werden durch das Durchführen der Schritte 1 & 2 auch Einstellungen an deiner Postgres-Installation vorgenommen, die beim direkten Einkopieren fehlen würden, womit möglicherweise dein Kieselstein ERP nicht vollständig funktioniert. Nachfolgend die Kurzfassung dazu:

  1. createdb.bat

  2. Starten liquibase mit update oder clear-checksums
    Wenn dies Fehler bringt so die Liquibase Version prüfen. Derzeit wird nur bis Liquibase 4.33 unterstützt. Liquibase 5 hat eine geänderte interne Struktur

  3. Liquibase 4.33
    unter Windows:

    • run-liquibase.bat clear-checksums
    • run-liquibase.bat update

    unter Linux:

    • liquibase.sh clear-checksums
    • liquibase.sh update

ACHTUNG: Wenn du eine bestehende Installation übernehmen willst, dann muss hier der Restore der alten Datenbanken gemacht werden. Danach sind liquibase clear-checksums und update auszuführen.

  1. Clients entpacken

  2. Server starten, aus CMD Shell
    Java Port in Firewall freischalten -> JA

  3. Anpassung des Client-Scalings
    ist ab 2.0.0.RC3 nicht mehr erforderlich

  4. Starten als Dienst
    Sollte der Dienst nicht starten, so aus dem LW:\kieselstein\dist\bootstrap\service\windows\install-kieselstein-services.bat mit Administratorrechten erneut aufrufen. Damit werden die Pfade usw. richtiggestellt.

Druck der Bestellung

Wenn der Druck z.B. der Bestellung wie folgt aussieht, bitte den Report wie oben beschrieben neu compilieren.

Datenbank

Es sollte die Postgres18 verwendet werden. Für die Übertragung der Daten gilt das unter Update Postgres geschriebene.

Update

So wie üblich, du wirst in aller Regel ein clear-checksums durchführen müssen.

Jasper Studio

Denke daran, dass das aktuelle Client EJB für den/die Buildpfade anpassen musst.

Hinweis zu core-3.2.1 und javase-3.2.1.
Wenn du ausschließlich die von JasperStudioCode 6.5.21 zur Verfügung gestellten QR-Codes verwendest, werden diese beiden externen JAR-Files nicht benötigt.

Alle Anwender-Reports neu compilieren

Bei der Umstellung müssen alle Anwenderreports neu kompiliert werden. Dafür das Build All

verwenden. Siehe dazu auch die nachfolgende Beschreibung zu Schriften.

Üblicherweise sollte man in jedem Druck so wenig unterschiedliche Schriften wie möglich haben. Daher und auch aus Lizenzgründen bitte alles auf Arimo oder deine lizenzierten Schriften umstellen. Hinweis: Für den Versand von Rechnungen im Zugferd-Format dürfen nur freie Schriften verwendet werden.

Hinweis:
Die Standard-Reports sind ab der Version 2.0.0 (ohne RC) bereits alle auf Arimo umgestellt.

Info:
Leider war die Verwendung der Liberation Sans nicht ausreichend stabil, weshalb wir auf die ebenfalls freie Schrift Arimo wechseln mussten. Auch diese ist zur Arial Größen kompatibel und eine freie Schrift (SIL Open Font License). Für weitere Details siehe bitte

Hinweis:
Die Report-Vorlage aus /allgemein/flrdruck.jrxml ist die programm-technische Vorlage für die Erstellung der Auswahllisten und darf nicht verändert werden. Wie hier ausgeführt, darf es dafür keine *.jasper Datei geben. Wir raten auch davon ab, diese Datei in das Anwenderverzeichnis der Reports mit aufzunehmen.

Schriften

Anstelle der bisher verwendeten Arial wird nun in allen Formularen die Arimo verwendet.
Die Standard-Formulare sind alle bereits geändert.
Es müssen jedoch die anwenderspezifischen Formulare, also die aus LW:/kieselstein/data/reports umgestellt werden.

Für die Installation von Arimo siehe

Für die Änderung der Schriften kann man das direkt im JasperStudio 6.21.5 machen.

  • Öffnen des Projektbaumes
  • Auswahl einer jrxml Datei
  • Klick auf den Reiter Source
  • Strg+H bringt den Suchen / Ersetzen Dialog
  • Suchen nach
fontName="Arial"
  • Einstellung

    und klicken auf Replace
  • Ersetzen mit
fontName="Arimo"

in

Womit in allen Formularen deines Workspaces alle Arial Fonts auf Arimo geändert werden.

  • ACHTUNG: Leider werden mit diesem Lauf die Fonts der Style Informationen nicht ausgetauscht. D.h. du musst, z.B. mit dem TotalCommander, alle deine jrxml Dateien nach Arial durchsuchen und hier dann die Fontnamen gegen Arimo austauschen.

  • nun noch kompilieren aller Reports mit Klick auf
    Hier darauf achten, dass alle Reports kompiliert wurden. Bleiben Reports mit den roten X bestehen. Diesen auswählen, erneut kompilieren und die eventuellen Fehler korrigieren.

Sans Serife

Gerade in den Anwender-Reports wurde oft auch die Schrift Sans Serife verwendet. Meist wird automatisch (vom Jasper-Reports) als Ersatz dafür die Liberation Sans verwendet. Da sowohl der Schriftschnitt der Sans Serife, als auch das Erscheinungsbild etwas anders ist, raten wir die oben beschriebenen Schrift-Ersetzungsmaßnahmen auch für die Sans Serife durchzuführen.

Jasper Studio default Font einstellen

Unter Window, Preferences und dann
Jaspersoft Studio, Properties
Hier dann runtersuchen bis default.font.name
Hier die gewünschte Schrift Arimo eintragen. Damit werden neue Felder immer mit dieser Schrift angelegt. Es empfiehlt sich auch die font.size auf 8 Pixel zu stellen, damit passt die Arimo in die Standard Texthöhe von 10 Pixel.

fuehreSQLQueryAus wurde entfernt

Diese schon seit langer Zeit nicht mehr unterstützte Funktion fuehreSQLQueryAus wurde mit der V2.0.0 endgültig entfernt. D.h. beim Kompilieren kommen entsprechende Fehlermeldungen.

Dies bedeutet, du musst alle SQL Aufrufe durch den Parameter $P{P_SQLEXEC}.execute ersetzen. Denke daran, dass bei Subreports dieser Parameter vom aufrufenden Report aus durchgereicht werden muss.

Anleitung

Eine Stichwortartige Anleitung wie für die Änderung in den Reports vorgehen, wobei fast alles im Jasperstudio 6.21.5 gemacht werden kann:

  • du sollst z.B. die Datei LW:\dist\wildfly-26.1.2.Final\kieselstein\reports\fertigung\fert_fehlteile.jrxml im JasperStudio verfügbar haben
  • kopiere von dieser Datei die beiden Parameter , P_SQLEXEC und P_MANDANT_OBJ
  • und füge diese als Parameter in deinen zu ändernden Report ein
  • als Muster kopiere nun aus der Variablen LosEndeTermin aus dem Report fertigung/fert_fehlteile die erste Zeile
$P{P_SQLEXEC}.execute(
  • ersetze nun in deinem anzupassenden Report den Aufruf von fuehreSQLQueryAus durch obigen Aufruf
  • sollte die zu ändernde Variable nicht einfach aufgefunden werden, so hat sich der Klick auf den Reiter Source bewährt. Hier mit Strg+F nach SQLQ suchen. Damit siehst du, wo überall der nicht mehr unterstützte Helper aufgerufen wird.

Wenn dieser Parameter in einem Subreport verwendet wird, musst du den Parameter aus dem Hauptreport durchreichen. Dazu:

  • Den Subreport links anklicken
  • In den Subreport Properties (meist rechts) auf den Reiter Subreport

    und dann auf den Button Edit Parameter klicken. ACHTUNG: Das JasperStudio braucht durchaus einige Zeit bis es diese Funktion geladen hat, oder stürzt leider ganz ab. Also vorher alle deine Änderungen sichern. Siehe dazu
  • Trage hier nun den P_SQLEXEC als zu übergebenden Parameter ein.
  • Im Subreport selbst gehst du analog zum oben Beschriebenen vor. D.h. du übergibst die beiden Parameter (P_SQLEXEC und P_MANDANT_OBJ). Kopierst aus dem Hauptreport die beiden Parameter und fügst diese in den Subreport ein.

Client-Farbgestaltung

An der Version 2 steht die Möglichkeit der eigenen Farbgestaltung, sogenannte Themes zur Verfügung.
Diese ist zweistufig gestaltet.

  • Vom Client aus. Dies ist gedacht um “seine” Farben herauszutesten
  • Am Server, ../kieselstein/data/… um dies für die jeweilige Installation spezifisch einzustellen. Z.B. um das Testsystem optisch eindeutig vom Echtsystem zu trennen.

Die Verwendung muss vom Client aus aktiviert werden. Du findest dies in der Hauptmenüleiste unter Ansicht.

Die standard Farbeinstellungen findest du unter LW:\kieselstein\dist\clients\lib\kieselstein-client-2.0.0-rc4.jar\com\lp\client\res\lpconfig.properties

Für die Farbeinstellungen siehe

Um das Design aus Serversicht einzustellen, musst du als Admin angemeldet sein.

Nutzung des Printservers

Der Printserver (LW:\kieselstein\dist\bootstrap\print-service\kieselstein-printservice) steht ohne Änderung auch unter Java21 zur Verfügung.

was testen

Für den Freigabetest solltest du den kompletten Umfang in dem du dein Kieselstein ERP verwendest bitte sehr akribisch prüfen. Idealerweise machst du dir auch eine Liste was du alles geprüft hast, prüfen willst. Hersteller von z.B. Medizinprodukten kennen dieses Verfahren.

Nachfolgend eine Aufstellung der zu prüfenden Dinge (die nicht vollständig sein muss):

  • Der tägliche Ablauf, die Verwendung aller von dir genutzten Module
    Bitte auch in den unterschiedlichen Arbeitsweisen der verschiedenen Anwender
  • deine Auswertungen
    • tägliche
    • monatliche
    • jährliche
    • auch die die nur von bestimmten Abteilungen bzw. der Geschäftsleitung genutzt werden
  • JSP, also alle genutzten Weblinks wie z.B. die Anwesenheitsliste aus dem Browser
  • die Import- und Exportfunktionen
  • die Verwendung aller der von dir genutzten Funktionen des Terminals
    Hinweis: Ev. solltest du die Gelegenheit nutzen und gleich die Version 1.2 des Terminals mit-testen.
  • die Verwendung aller der von dir in der mobilen App genutzten Funktionen, idealerweise auch in der Version 1.2
  • wenn du eine eigene RestAPI Anbindung hast, bitte diese Funktionen sehr akribisch prüfen
  • die Dokumentenablage, sowohl in der Anzeige und dem Ausdruck alter Dokumenten, als auch für neue mit der Testversion erzeugter und abgelegter Dokumente
  • prüfe die Hardware nahen Dinge, für mich gehören dazu vor allem:
    • jeglicher Etikettendruck
      Das gilt vor allem für kleine / sehr kleine Etiketten
    • jeder Ausdruck, vor allem die, die nicht das A4 Format verwenden bzw. alle die eine kritische Positionierung haben, z.B. Formulare befüllen
    • der indirekte Druck von Etiketten und ähnlichem aus Terminal bzw. mobiler App

Du solltest vor den Test der Ausdrucke in deinen Anwenderspezifischen Reports bereits die Umstellung auf Liberation Sans gemacht haben.

Hinweis:
Verwende bei den Tests der Etikettendrucke idealerweise ein sehr günstiges Etikettenmaterial.

Eine große Bitte
Solltest du einen Fehler feststellen, so ist das ärgerlich. Bitte notiere diesen Fehler, setze aber unbedingt deine Prüfungen fort, soweit irgend möglich. Wir wollen damit erreichen, dass mit einer einmaligen Änderung dann die gute Version zur Verfügung steht.

Bevor du uns den Fehler mitteilst, solltest du bitte im Git prüfen, ob dieser Fehler schon bekannt ist. Für die verschiedenen Release-Kandidaten wurden diese unter folgenden Links gesammelt.

Release Candidat Link
RC 1 #593
RC 2 #595
RC 2.1 #607
RC 3 #609
RC 4 #613
RC 5 #617
RC 6 #624
RC 7 - RC 9 betreffen die Umstellung von Liberation Sans auf die Arimo
Final geht mit Kleinigkeiten aus der RC9 hervor.
Für den Download siehe

Parallele Java Installation

Gerade in der Umstellungsphase wird es vorkommen, dass man auf einem Rechner sowohl das benötigte Java21 als auch z.B. das Java 11 gleichzeitig installiert haben möchte.

Wichtig ist hier darauf zu achten, dass die Java 21 Installation sauber bleibt, also nicht mit dem Java 11 vermischt wird.

Unsere Vorgehensweise dazu ist:

  • zuerst das Java 21 installieren und sowohl Path als auch Java Home setzen und auch die JavaSoft registration Keys.

Wenn du danach das Java 11 installierst, lade nur die Zip Datei herunter.
Kopiere dann den Inhalt auf ein Verzeichnis deiner Wahl. Wir raten davon ab, den Installer zu verwenden.

Nun musst du bei den Programme, die Java 11 verwenden eventuell explizit den Pfad auf dein Java 11 angeben, also auch die JAVA_HOME Variable temporär auf den entsprechenden Pfad setzen.

Tipp

Eine kleine Sammlung von Tipps / Besonderheiten aufbauend auf RC6

Start des Servers

Aufgrund der Umstellungen der Strukturen im Kernel des Kieselstein ERP Servers, dauert der Start der Module ca. doppelt so lange wie in der Version 1.x. Dafür ist dein Kieselstein ERP System dann im Betrieb deutlich schneller.

EMail Versand prüfen

Insbesondere wenn du auf einen neuen Server, eine neue IP-Adresse umgestellt hast, prüfe ob der EMail-Versand noch funktioniert. Je nach Konstellation kann es sein, dass an deinem EMail-Server (SMTP, IMAP, usw.) noch Einstellungen zu treffen sind.

Linux

Update / Installation Java

  • herunterladen von www.azul.com/downloads/

    • lade das .deb Paket herunter
    • Achte auf die FX Erweiterungen
  • Wechsle nun in dein Download-Verzeichnis und installiere das Java.
    Eventuell musst du vorher root werden. Das geht mit su - root. Jedenfalls brauchst du das root Passwort.

  • herunterladen in einer Headless Umgebung mit wget und danach den Downloadlink

apt install ./zulu21.52.15-ca-fx-jdk21.0.12-linux_amd64.deb

Installation überprüfen:

java -version

Java Home setzen

nano /etc/environment
JAVA_HOME=/usr/lib/jvm/zulu-fx-21-amd64
source /etc/environment
printenv | grep JAVA

zeigt dir die aktuellen Einstellungen deines JAVA_HOME auf deinem Rechner.

Herunterladen

  • Idealerweise gehst du vorher in dein Download-Verzeichnis
  • für die richtige Datei, einfach bei Releases rechtsklick und Link kopieren und dann mit wget und dem Link als root herunterladen oder eben von Gitlab herunterladen

opt vorbereiten

Bei einer bestehenden Installation wechselst du nach /opt/kieselstein und benennst das alte dist-Verzeichnis passend zur alten Version um. Die Version findest du in der Datei Version im Verzeichnis dist.

mv dist dist.1.1.15

entzippen

Beispiel für das Entpacken des Dist-Packets aus dem Downloadverzeichnis des angemeldeten Users.

tar -xvf ./kieselstein-distpack-2.0.0.tar.gz -C /opt/kieselstein

Datenbank updaten

cd /opt/kieselstein/dist/bootstrap/liquibase
./liquibase.sh clear-checksums
./liquibase.sh update

Achte darauf, dass dein Java21 verwendet wird.

Einrichten der Fonts

Fonts installieren

Dazu zuerst die Client-Dateien entpacken.

cd /opt/kieselstein/dist/clients
tar -xvf ./kieselstein-client-2.0.0.tar.gz

Damit findest du unter kieselstein-client-2.0.0 die Verzeichnisse bin und lib.
Im bin-Verzeichnis gibt es das Verzeichnis Fonts. Hier sind die benötigten Schriften. Kopiere diese wie hier beschrieben.

Kopieren der Font Dateien:

  • du stellst dich auf /usr/share/fonts/truetype
  • md arimo … für das Fontverzeichnis
  • cp /opt/kieselstein/dist/clients/kieselstein-client-2.0.0/bin/Fonts/. arimo/

Denke daran danach den Server neu zu starten.

Dienststart updaten

Unter /opt/kieselstein/dist/bootstrap/service/linux
das install-kieselstein-services.sh (erneut) ausführen, damit die geänderten Startparameter übernommen werden.
Dann mit systemctl start kieselstein-main-server.service starten
Unter /opt/kieselstein/dist/wildfly-26.1.2.Final/standalone/deployments das Startverhalten beobachten.

Gehe für die Installation auf einem Windows-Server analog vor. D.h. unter LW:\kieselstein\dist\bootstrap\service\windows\install-kieselstein-services.bat mit Administratorrechten ausführen.

Prüfung der Javaversion

Ab der Version 2.0.0 (final) wird auch die verwendete Java-Version geprüft. D.h. wenn du die Fehlermeldung

bekommst, so bitte die richtige Version installieren (verlinken). Mit der falschen Java-Version gehen alle Funktionen die die FX Komponente verwenden nicht, wie z.B. Kurzbriefe, EMail-Versand, usw.. Dies ist ein Fehler der Java-Version.

Ab der Javaversion 21.0.12+8 funktioniert die FX Komponente wieder.
D.h. wenn du dir sicher bist, das richtige Java installiert zu haben, kannst du die Fehlermeldung beim Start des Clients ignorieren.
Da ab der Version 2.1 deines Kieselstein ERP Java 25 zum Einsatz kommt, wird diese nun falsche Meldung voraussichtlich nicht korrigiert werden.

Kurzfassung der Umstellung

von 1.x auf 2.0.0

Vorbereitung am Server

  • Java auf Java 21 umstellen
  • Update der Datenbank wie üblich
  • neues Dist wie üblich einkopieren
  • client.zip vorbereiten und unter LW:\Kieselstein\dist\clients zur Verfügung stellen
    • dabei die IP-Adresse des KES-Servers und ev. die locale in der ..\bin\kieselstein_server_setzen.bat entsprechend einrichten
  • die passende Java Installationsdatei auch unter LW:\Kieselstein\dist\clients zur Verfügung stellen

Update der Clients

  1. Deinstallieren des Java 11 (und aller anderen Java Versionen) Systemsteuerung, Programme und Features, Azul Zulu 11 deinstallieren

  2. Java und Client herunterladen von http://IP_ADresse_Kieselstein_ERP:8080/, dann auf download clients klicken und das Client.zip und das zulu21… herunterladen

  3. das Zulu21 (Java 21) installieren, dabei darauf achten das Java Home zu setzen

    auf entire …. Bitte nur dieses Java verwenden. In der neueren Version ist leider ein Bug enthalten.

  4. das bestehende Client-Verzeichnis aus c:\Kieselstein komplett löschen

  5. In das Client.zip reingehen und das Verzeichnis Client in das c:\kieselstein reinkopieren

  6. Hier findest du im Unterverzeichnis bin die Datei Kieselstein_server_setzen.bat
    Diese bitte einmal als Administrator ausführen.
    Damit wird die Environment Variable gesetzt und die Schrift installiert.

  7. Nun kann der Kieselstein Client mit der bisherigen Desktop Verlinkung gestartet werden. Wenn du möchtest kannst du über die Eigenschaften der Desktop Verlinkung das neuere Icon Kieselstein_weißauftürkis setzen.
    Gerne auch eine neue Desktop-Verknüpfung auf die nunmehrige c:\Kieselstein\Client\bin\kieselstein-client.bat einrichten.

  8. Den Kieselstein Client starten und mit den bisherigen Anmeldedaten anmelden.

Backup

Prüfe ob dein Backup noch funktioniert. Es hat sich doch einiges geändert.

Funktionieren die grundlegenden Dinge?

Ich persönlich prüfe gerne nach diesem doch größeren Update, ob nach alles so wie erwartet funktioniert. Hier geht es nicht um die Funktionalitäten des Programms, sondern ob den die Installation wie gedacht funktioniert. Dafür hat sich folgender Schnellcheck bewährt

  • Anmelden
  • Ausdrucken eines Kurzbriefes, als physikalischen Papierausdruck
  • Versenden dieses Test-Kurzbriefes auch als EMail -> kommt dieses EMail beim Empfänger auch an (bedenke den Zeitversatz von üblicherweise fünf Minuten)

MACos

Das alte Java vor dem Update deinstallieren. D.h. im Finder auf /Library/Java/JavaVirtualMachine/ das alte zulu-xx.jdk entfernen.
Denke daran, das JAVA_HOME in der ~/.zshrc anzupassen, bzw. für alle User unter /etc/zprofile

1 - Farbliche Gestaltung deines Kieselstein ERP Clients

Wie die Farben Clients deines Kieselstein ERP ab Version 2.x.x gestalten

Ab der Version 2.x.x steht die Farbgestaltung über eigene Properties / Dateien zur Verfügung. Eine Vorlage findest du unter LW:\kieselstein\dist\clients\lib\kieselstein-client-2.0.0-rc4.jar\com\lp\client\res\lpconfig.properties

Idealerweise prüfst du deine gewünschten Farben nur auf deinem lokalen Client aus. Entsprechen diese deinen Wunschvorstellungen kannst du diese auch Systemweit ausrollen.

Um nun einen Bezug zwischen der propertie-Datei und deren Wirkung herzustellen, haben wir die Standard Datei genommen, in dieser alle Einträge für den Standardlook und den speziellen Definitionen für die Rot-Grün Fehlsichtigkeit entfernt und nun jeweils einen Parameter auf die Farbe .. verändert und dies dokumentiert, sodass du ein Gefühl dafür bekommst, mit welchem Parameter du welche Wirkung erzielen kannst.

Bitte beachte:

  • Idealerweise bearbeitest du die properties Datei mit dem Notepad++
  • Hinter der Angabe des Hex-Wertes darf kein wie immer gearteter Text kommen. Leider auch kein Kommentar
  • Nach dem Speichern muss die Änderung neu eingelesen werden. D.h. im Hauptmenü, Ansicht, Design von Datei laden (lokal)

Wir haben folgende Werte verändert:

Parameter Default Wert Hinweis Bild_Bild_Bild_Bild_Bild_Bild_Bild_Bild
color.heliumlook.button.background.normal fafafa Hintergrund der Buttons
color.heliumlook.button.border.normal dcdcdc Rahmen um die Buttons
color.heliumlook.checkbox.background.normal fafafa
color.heliumlook.dependencefield.background.disabled.normal eeffdd
color.heliumlook.dependencefield.background.normal ddffbb während des bearbeitens siehe z.B. Artikel, Technik, Material, Kupferzuschlag
color.heliumlook.desktopstatusbar.border.normal e6e6d2
color.heliumlook.label.background.normal fafafa für die Listenüberschriften
und die Umrandungen der angezeigten Werte
color.heliumlook.list.background.normal Artikel Detail
Bestellvorschlag Lieferanteninfos unten
color.heliumlook.lpmodul.toolbarbutton.background.normal fafafa Man muss den Client neu starten
Die Definition des Borders wirkt erst, wenn lpmodul.toolbarbutton.background definiert ist. Wenn leer, dann wird kein Border gezeigt
color.heliumlook.lpmodul.toolbarbutton.border.normal
color.heliumlook.mandatoryfield.border.normal faba61 Der Rahmen um ein Pflichtfeld
color.heliumlook.optionpane.background.normal fafafa
color.heliumlook.panel.background.normal fafafa
color.heliumlook.panel.toolbarbutton.background.normal e9e9e9
color.heliumlook.panel.toolbarbutton.border.normal
color.heliumlook.radiobutton.background.normal fafafa
color.heliumlook.scrollpane.background.normal fafafa Die Scrollbars der Druckvorschau
color.heliumlook.selectedField.background.normal b4c3ff ????? #FFB3EA unbekannt ![
color.heliumlook.statusbar.border.normal e6e6d2
color.heliumlook.table.gridcolor.normal dddddd
color.heliumlook.tableheader.background.normal fafafa
color.heliumlook.text.normal 0 Ist z.B. der Inhalt der Datumseingabe
color.heliumlook.text.valid.normal 009600 ist eigentlich ungültig / invalid #FF00FF
color.heliumlook.text.invalid.normal ff0000 ????? Unbekannt Rot #777700
color.heliumlook.textfield.background.normal d8eff6 Dateiauswahldialog
color.heliumlook.textfield.showborder 0 0..kein Border
1..Border mit Farbe aus textfield.border
color.heliumlook.textfield.border.normal dddddd Direktfilter, alle Eingabefelder
color.heliumlook.textfield.editable.normal ffe6cb
color.heliumlook.textfield.inactiveforeground.normal 0000ff ????? unbekannt Blau #000077
color.heliumlook.textfield.noteditable.normal f0f0f0 Nur Anzeigen von Feldern
color.heliumlook.textfield.onfocus.normal d7e6f2 während des Bearbeitens das Feld auf dem der Focus ist
color.heliumlook.toolbar.background.normal fafafa Datei Dialog
color.heliumlook.viewport.background.normal fafafa Der leere Hintergrund von Listen

Wie kann ich die Hexfarben definieren?

Dies geht z.B. mit einem grafischen Editor wie dem Paint unter Windows. Hier einfach z.B. ein Rechteck malen und auf Palette bearbeiten klicken.
Nun die gewünschte Farbe auswählen und oben den Hexcode auslesen.

Musterdatei

Eine Musterdatei, in der auch die unbekannten Elemente definiert sind findest du hier.farbmuster_default.properties
Beachte, dass nur die Farben im Kieselsteinlook und nicht in der Rot-Grün Fehlsichtigkeit definiert sind.

Trennung verschiedener Installationen

Gerade für den parallelen Betrieb von Echt- und Test-Systemen, empfiehlt sich, für das Testsystem entsprechende Warn-Farben zu hinterlegen, sodass man jederzeit erkennen kann, auf welchem der System man ist.

Dafür können die Servereinstellungen verwendet werden.
D.h. wenn du als Admin angemeldet bist, so findest du im Hauptmenü unter Ansicht, Design von Datei laden (Server). Hier werden die Resource-Einstellungen in der Datei %KIESELSTEIN_DATA%/configdesign/kieselstein-look.properties abgelegt.
Das bedeutet auch, dass du

  • zuerst mit den Client Einstellungen die gewünschten Farben erarbeitest und dann
  • diese Properties-Datei für alle Anwender entsprechend ausrollst, indem du die eben in der oben angeführte Datei ablegst.

Das bedeutet auch, wenn du am Client für den Server eine Farbdefinition lä#dst, so wird diese automatisch unter LW/kieselstein/data/configdesign/kieselstein-look.properties abgelegt und somit allen Anwendern dieser Installation zur Verfügung gestellt.

2 - Schriften mit Kieselstein ERP Version 2.x, Java21

How To in Zusammenhang mit den Schriften deines Kieselstein ERP ab der Version 2.x

Das Kieselstein ERP Version 2.x kommt default mit Arimo in den Formularen.

Wichtig ist, dass auf allen deinen Rechnern, auf denen dein Kieselstein ERP gestartet wird, egal ob Client oder Server, die gleichen Fonts (Schriften) installiert haben musst.

Verwende dazu die im Clientverzeichnis ausgelieferten Fonts.
LW:\kieselstein\dist\clients\bin\Fonts

Diese sind gleichlautend zu den von Google zur Verfügung gestellten Fonts.

Info:
Da von der Liberation Sans viele verschiedene Versionen im Umlauf sind und eine stabile Prüfung der Versionen, vor allem unter Windows offensichtlich nicht möglich ist, haben wir uns entschlossen den Arimo Font, welcher wiederum von Liberation Sans abgeleitet ist, zu verwenden. Wir gehen davon aus, dass es von diesem Font auf allen von uns unterstützten Betriebssystemen nur eine Version gibt.

Stellt die Überprüfung fest, dass die Fonts nicht mit den in Kieselstein ERP eingebundenen Fonts übereinstimmen, kommt sinngemäß folgende Fehlermeldung:

Installiere in diesem Falle die oben angegebenen Fonts auf deinem Kieselstein ERP Server und auch auf dem jeweiligen Client.

Hinweis zum Printserver:
Solltest du auch den Kieselstein ERP Printserver im Einsatz haben, so muss auch auf diesem Rechner die gleiche Version des Arimo Fonts installiert sein. Sollte dies nicht der Fall sein, so siehst du im Log des Printservers einen dazu passenden Hinweis.

[Mi. Mai 06 11:40:58 MESZ 2026] SCHWERWIEGEND: Jasper Print Job failed with exception: Font "Arimo" is not available to the JVM. See the Javadoc for more details. 

Wo müssen die Schriften hin

Damit in deinem Unternehmen überall die gleichen Fonts verwendet werden, müssen auf allen mit Kieselstein ERP beteiligten Rechnern die gleichen Fonts verwendet werden. D.h. auch auf deinem Kieselstein ERP Server.
Dafür haben wir die freien Fonts im Client Startverzeichnis zur Verfügung gestellt. D.h. du findest diese unter:
LW:\kieselstein\dist\clients\kieselstein-client-2.0.0-rc9.tar.gz und hier dann unter kieselstein-client-2.0.0-rc9\bin\Fonts.
Installiere diese Fontdateien mit den Werkzeugen des jeweiligen Betriebssystems.

In anderen Worten: Immer wenn du an den Fonts / den Font-Dateien etwas änderst, muss zumindest der Java Prozess neu gestartet werden. Das kann auch bedeuten, wenn ein anderes Programm, den Arimo Font überschreibt, dass es noch bis zum nächsten Neustart (des Rechners, des Java-Programms) gut geht und nach dem Neustart spinnt es.

Hinweis:
Wenn du unter Windows direkt aus dem Font-Verzeichnis, Rechtklick machst, so denke daran, insbesondere am Server, dass du für
Für alle Benutzerinstallieren auswählst.
Zur Sicherheit kannst du auch prüfen, dass die Fontdateien unter c:\Windows\Fonts tatsächlich vorhanden sind.

Welche Schriften sind installiert

Auf einem Linux-System gibt es das Commando: fc-list
Dieses zeigt dir alle auf deinem System installierten Schriften. D.h. auch, mit:

fc-list | grep -i arimo | sort

bekommst du eine Übersicht, wo überall und für welchen User die verschiedenen Arimo-Fonts installiert sind.

Unter Windows findest du diese Liste unter Einstellungen, Personalisierung, Schriftarten.

Muss ich die Schrift auf allen Rechnern installieren

Ja, sowohl auf deinem Kieselstein ERP Server als auch auf allen Rechnern die den Kieselstein ERP Client verwenden (und auch ausdrucken).

Achte darauf, dass wirklich die Arimo Schrift auf den Clients installiert ist. Es kann der Client auch ohne dieser Schrift betrieben werden. Es werden dann jedoch anstelle der Schriftzeichen nur Bilder gedruckt, womit die daraus erzeugten Jasper Dateien, z.B. der Dokumentenablage, nicht mehr nach Texten durchsucht werden können.
Menschen mit einem guten grafischen Auge, erkennen auch leichte Unterschiede in der Darstellung, vor allem in der Schärfe der Texte.

Es werden derzeit nur die unter Static, bzw. im Client Font Verzeichnis angeführten Fonts benötigt.

Hinweis:
Idealerweise installierst du die Arimo für alle Benutzer.

Sollte beim Start des Clients nur die Fehlermeldung kommen, dass der Font am Server nicht installiert ist, du aber die Fonts installiert haben, so starten deinen KES Server durch, damit auch die Java Umgebung (JVM) die neuen Fonts mitbekommt.

Hinweis in Kombination mit alten (V1.x) Installationen:
Wenn du auf deinen Client-Rechnern sowohl die Version 1.x (das Live-System) und die Version 2.x (z.B. zum Test) installiert hast, und die Schrift Liberation Sans auf den Client-Rechnern eingerichtet ist, so müssen auch auf dem Kieselstein ERP Server der Version 1 die passenden Fonts eingerichtet sein. Anderenfalls kann es auch in dieser Konstellation zur falschen Darstellung z.B. der Umlaute kommen.

Hinweis zur Verwendung von Sans Serife:
Offensichtlich wird vom Server (Jasper) die Liberation Sans, zumindest in Linux (Debian) Umgebungen, als Ersatz für die Sans Serife verwendet. Womit sich die oben beschriebene Thematik weiter verbreitet.
Lösungsmöglichkeit:

  • Verwende in allen Formularen der Version 1.x anstelle der Sans Serife die Schrift Arial

Es werden keine Texte mehr gedruckt

Bekommst du beim physikalischen Papierdruck, der auch in einen PDF-Drucker gehen kann (und nicht mit dem Speichern als PDF) ein ähnliches Bild wie hier

so starte deinen Rechner und unter Umständen auch deinen Server neu, damit die richtigen Fonts geladen werden.

Fehlermeldung beim Reportaufruf

Erhältst du beim Drucken eines Reports die Meldung

So bedeutet dies generell, dass eine im Report verwendete Schrift / Font, am Server nicht verfügbar ist. Gerade in der Umstellungszeit kann es sein, dass du auf deinem Kieselstein ERP Server die Schrift Arimo nicht installiert hast. Bitte installieren.

Im Detail der Fehlermeldung siehst du, welche Schrift genau fehlt.

class com.lp.client.frame.ExceptionLP
net.sf.jasperreports.engine.util.JRFontNotFoundException: Font "Arimo" is not available to the JVM. See the Javadoc for more details.

Font am Client nicht verfügbar

Bekommst du beim Aufruf eines Reports die Meldung

so bedeutet dies meist, dass eine Schrift am Client nicht installiert ist.
Details dazu findet man, etwas versteckt, im Client-Log.
Gerade in der Umstellungszeit, wird das auch die Schrift Arimo sein, was bedeutet, bitte auch am Client installieren.

Am MACos installieren

Wichtig: Bevor du die Schriften zu installieren beginnst musst du definieren wo diese hin installiert werden sollten. In der Regel willst du für dein Kieselstein ERP dies für alle Benutzer einrichten. Also bitte wie folgt vorgehen:

  • Schriftsammlung
  • Einstellungen
  • Installation
  • Nun Standardort für Installation, hier alle Benutzer auswählen

Nun kannst du die Arimo-Font Dateien aus deinem Kieselstein-Client-Verzeichnis einfach mit einem Doppelklick installieren.
Diese sind danach im Verzeichnis /libraries/fonts zu finden.