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

Zur Standardansicht zurückkehren.

Installation Client

Installationsbeschreibung für die Ausrollung des Kieselstein ERP Clients

Voraussetzung: Du hast auf den jeweiligen Rechnern ausreichende Installationsrechte und bist mit den Arbeiten mit Programm-Files und allem, was so dazu gehört, vertraut. Für Unterstützung wende dich als Mitglied der Kieselstein-ERP eG gerne an eine:n der Consulter:innen.

Ab der Version 0.0.0.8 deines Kieselstein ERP können die erforderlichen Installationsdateien über einen Weblink geladen werden. Gehe dazu in einem Browser auf http://IPADRESSE_KIESELSTEIN_ERP:8080.

Klicke nun auf download clients

Hier findest du nun die vom Installationsverantwortlichen zusammengestellten Dateien zum Download zur Auswahl.

Es sind dies alle Dateien die in deinem Kieselstein-ERP im Verzeichnis
LW:\kieselstein\dist\clients abgelegt sind.
Es ist Aufgabe des/der Installierenden hier alle richtigen Dateien zusammenzustellen. Das bedeutet aktuell auch, dass nach jedem Update die Dateien anzupassen sind.

In der Client.zip sind die beiden Verzeichnisse für die Installation enthalten. Lade diese herunter und kopiere diese z.B. auf c:\kieselstein\client.

Im bin Verzeichnis findest du drei Dateien:

In Windowssystemen richte dir eine Desktop-Verknüpfung auf die kieselstein-client.bat ein. Dieser gibst du das Icon Kieselstein.ico.
In Linux bzw. macOS verwendest du die kieselstein-client.sh.

Nun benötigst du noch das passende Java (wenn nicht schon installiert), welches ebenfalls im Browser als Download zur Verfügung steht (zulu ….).

Üblicherweise kann ein / alle eventuell vorhandenes(n) Java entfernt werden. -> EMPFOHLEN

Installiere nun das Azul Java mit den default Einstellungen. Einzig bei der Frage nach dem Java Home wähle immer Verfügbar. Details siehe

Nun kannst du deinen Kieselstein ERP Client starten.
Benutzername und Passwort erhältst du von deinem/r Kieselstein ERP in Haus Verantwortlichen.

Hinweis:
Sollte nach eine Neuinstallation von Java, das Java trotzdem nicht zur Verfügung stehen (prüfen z.B. aufmachen des CMD (Command-Shell) und Java -version), so hilft unter Umständen, gerade bei komplexen Berechtigungen, ein Neustart des Rechners.

Hinweis:
Es hat sich bewährt, auf den Rechnern der Poweruser auch einen Teamviewer (https://www.teamviewer.com/de/download/windows/) installiert zu haben. Wir gehen davon aus, dass jeder ERP Anwender den Teamviewer starten kann und darf.

Von Kieselstein ERP verwendete Ports siehe bitte Server

Java

Wir setzen zurzeit folgende Version voraus:

Gerade im Clientbereich kann es vorkommen, dass andere Versionen eingesetzt werden. Bitte beachte, dass für das richtige Verhalten der Software ausschließlich die unten von Azul zur Verfügung gestellte OpenJDK11 verwendet werden sollte. Bitte beachte bei der Verwendung von original Oracle Java 11 Versionen, dass diese lizenzkostenpflichtig sind.

Der Basis-Link für das erprobte Zulu Java findest du unter https://www.azul.com/downloads/?package=jdk#zulu Hier dann Java 11 mit jdk-FX auch passend zu deinem Betriebssystem auswählen.

Den Download einer freien OpenJDK Version mit Java 11 für deinen Client finden man unter: https://www.azul.com/downloads/?version=java-11-lts&os=windows&package=jdk-fx

Achte bei der Installation des Javas darauf, dass:

  • keine weiteren Java Versionen installiert sind. ACHTUNG: solltest du für andere Programme bestimmte Java Versionen benötigen, lässt sich auch das einrichten. Bitte wende dich an deinen Kieselstein ERP Betreuer
  • bei der Installation muss das Java Home gesetzt werden, also:

Hinweis: bei einem Mac mit Apple Silicon Prozess wird die Java-Zulu FX Version vorausgesetzt.

Client startet nicht

Wenn unter Windows der Client nur kurz durchläuft und sich dann wieder automatisch beendet, so ist der Pfad in dem deine eigentlichen Clientdateien stecken zu lange. Mache diese kürzer.
Wir raten dies unter LW:\Kieselstein\Client einzurichten

Fehler beim Drucken von Barcodes

Es werden viele Fehler in der Client-Console angezeigt.
Die Barcode sind zerstückelt.
Beim Drucken von Artikeletiketten erscheint das Vorschau-Fenster nicht. Fährt man mit der Maus über den Client erscheinen teilweise die “Bilder” des Druck-Vorschau-Fensters.

Bitte prüfe, ob das aktuelle Java installiert ist.
Es muss
angezeigt werden. Wird ein älteres Java angezeigt, kann es zu den beschriebenen Effekten kommen. Wichtig eben auch, nur Java mit der FX Erweiterung.
Sollte die Anzeige trotzdem so “spinnen”, dann ist dies ein Problem der Grafikkarte bzw. des Treibers.
Das kann auch auftreten, wenn der Rechner ohne Bildschirm installiert ist und man nur per Fernwartung (Teamviewer, Remote Desktop, …) zugreift.

Fehlermeldung beim ersten Ausführen

Startet man unter Windows den Batch zum ersten Mal, kommt
So auf Weitere Informationen klicken und dann
Auf den Trotzdem ausführen Button klicken. Dies bleibt bis zum nächsten Update / Erneuerung des Batchs erhalten.

Client in Start / Taskleiste bringen

Hat man, wie oben beschrieben den Client.bat (eigentlich die LW:\kieselstein\dist\client\bin\kieselstein-ui-swing.bat ) als Verknüpfung auf den Desktop gelegt, so wünscht man sich oft, diese auch in den Start bzw. die Taskleiste zu bringen.

Der Trick dafür geht wie folgt:

  1. In den Eigenschaften der Verknüpfung vorne das Ziel um C:\Windows\System32\cmd.exe /c ergänzen.
  2. Nun Rechtsklick auf die Verknüpfung.
    • Im Windows 10 sieht man nun

      An Start anheften bzw. an Taskleiste anheften, womit man das Start-Icon in den gewünschten Bereich bringen kann. Es sollte die Verknüpfung auf das Desktop-Icon vor dem Verschieben gemacht werden.
    • Im Windows 11 wählt man vorher noch Weitere Optionen anzeigen und kann damit dann An Start anheften bzw. an Taskleiste anheften auswählen.

Wird auch Windows 7 unterstützt?

Da Windows 7 schon seit etlichen Jahren nicht mehr supported wird und alleine schon aus diesem Titel dies eine grobe Verletzung der DSGVO darstellt, wird Windows 7 nicht unterstützt. Bitte verwende aktuelle Betriebssysteme, gegebenenfalls auch in einer VM (Virtual Machine) z.B. mit Virtual Box.

Geschwindigkeit, langsamer Client

Neben der reinen Netzwerk-Zugriffs-Geschwindigkeit (siehe Hauptmenüleiste, Hilfe, Info) ist unter Umständen auch der Back-Call des Servers an den Client für die Geschwindigkeit, meist auch für die Langsamkeit verantwortlich.

D.h. es müssen sowohl der Server vom Client aus als auch der Client vom Server aus, mit ihren Netzwerk-Namen als auch mit den IP Adressen problemlos und schnell erreicht werden können. Ist dem nicht so, dauert das Blättern zwischen den Modulreitern entsprechend lange.

Gerade in Linux-Systemen oder bei VPN Verbindungen werden hier gerne Konfigurationsfehler gemacht.

In anderen Worten, es muss der DNS Name immer auf einen internen DNS Server zeigen, dann ist zumindest von dieser Seite her die Geschwindigkeit entsprechend optimiert.

Für Windows-User siehe Eigenschaften der Netzwerkverbindung

Client-Updates

Nachfolgend eine kleine Beschreibung der Besonderheiten beim Update der Clients, von aus älteren Versionen.

Alter Server

Manchmal will man die Installation vorab testen.
Hier ist wichtig zu wissen, dass die neueren Clients, z.B. 0.1.1, bereits beim Starten, bevor noch irgendeine Oberfläche angezeigt wird, den Server um die Versionsnummer (der Datenbank und des Servers) abfragen.
Das bedeutet, wenn du mit einem neuen Client gegen einen alten Server testest, wird dies nicht funktionieren. Der optische Eindruck ist, dass der Client nicht startet. Startest du den Client aus der Commandshell, ohne javaw.exe so siehst du

Got Exception No such EJB method org.jboss.ejb.client.EJBMethodLocator@bc7b26d3 found on lpserver/ejb/SystemFacBean java.lang.IllegalArgumentException: No such EJB method org.jboss.ejb.client.EJBMethodLocator@bc7b26d3 found on lpserver/ejb/SystemFacBean

Das bedeutet, der Client konnte zwar eine Verbindung zum Server herstellen, aber die Abfrage nach der Versionsnummer ist bereits fehlgeschlagen.
Hier hilft nur den Server auch zu aktualisieren.

Sprachsteuerung bei Anmeldung

Üblicherweise wird beim Start des Clients auch die Sprache vorgeschlagen, die für den Anwender die richtige ist. Diese Definition findest du unter
LW:\Kieselstein\client\bin\kieselstein-client.bat
Hier steht (ca. in Zeile 37)
´´´ set DEFAULT_JVM_OPTS="-XX:PermSize=64m" “-XX:MaxPermSize=256m” “-Djava.naming.factory.initial=org.wildfly.naming.client.WildFlyInitialContextFactory” “-Djava.naming.provider.url=remote+http://192.168.100.14:8080” “-Dloc=sl_ " “-Dsun.java2d.dpiaware=false” ´´´ mit dem Parameter -Dloc= kann gesteuert werden, welche Sprache vorgeschlagen wird. Bitte beachte: sollte die hier eingetragene Sprache in deinem Kieselstein ERP nicht aktiviert sein, so wird die nächstliegende Sprache verwendet.

Für die aktuell unterstützten Sprachen müssen folgende Einträge gemacht werden. Welche Einträge in aktiviert sind, findest du in der lp_locale.

locale Sprache
deAT Deutsch mit österreichischer Sprachausprägung
deCH Deutsch mit schweizer Sprachausprägung
deDE Deutsch mit deutscher Sprachausprägung
enGB Britisches Englisch (nicht vollständig übersetzt)
enUS Amerikanisches Englisch
itIT Italienisch
plPL Polnisch
sl Slowenisch. Bitte beachte, dass die Definition des Locales mit sl_< >< > mit zwei nachfolgenden Spaces erfolgen muss.
Ist eigentlich Englisch, aber um die Zahlen wie in Europa üblich darzustellen als Slowenisch definiert

In der für Linux verwendeten kieselstein-client. steht dies in Zeile 203.

Weitere Details siehe

Serveradresse und Locale zentrale steuern

Ab der Version 1.1.15 stehen dafür Environment Variablen zur Verfügung.
Um diese zentrale auszurollen, verwende ab der Version 1.1.15 die Batch-Datei kieselstein_server_setzen.bat aus dem client bin Verzeichnis.

Trage hier die aktuelle IP-Adresse deines Kieselstein ERP Servers ein und die gewünschte Anmeldesprache.

Üblicherweise wird diese auf ein allgemeines für Alle zugängliches Netzlaufwerk / Netzwerkshare zur Verfügung gestellt und einmal für jeden Rechner als Administrator ausgeführt.

1 - Installation Kieselstein ERP Client unter Debian

Installation eines Kieselstein ERP Clients unter Debian

Den Kieselstein ERP Client auf einem frischen Debian installieren

2 - Installation Kieselstein ERP Client unter Ubuntu

Installation Client zu Kieselstein ERP Server unter Ubuntu

Siehe bitte allgemeine Client Beschreibung

Praktisch

Den Midnight Commander verwenden:

sudo apt install mc

Java installieren

Um das passende Java11 FX zu bekommen sind folgende Schritte erforderlich:

apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 0xB1998361219BD9C9
apt-add-repository 'deb http://repos.azulsystems.com/ubuntu stable main'
apt update
apt install zulu-11

Danach das Java Home manuell hinzufügen:

nano /etc/environment
JAVA_HOME="/usr/lib/jvm/zulu-fx-11-amd64"

source /etc/environment
echo $JAVA_HOME

Anzeige:
/usr/lib/jvm/zulu-fx-11-amd64

Alternativ herunterladen des Java FX Packages

mit dpkg installieren, einmal apt install -f, dann nochmal installieren!

Erfahrungen auf einem neuen Ubuntu 24.04 LTS

Java installieren

  • Von Azul.com , JDK11 FX, Ubuntu, DEB Paket herunterladen.
    Es wird dies unter /home/username/Downloads abgelegt -> Für die eventuelle De-Installation muss das Paket an dieser oder an einer anderen auffindbaren Stelle, belassen werden.
  • In Downloads wechseln und mit Doppelklick starten
  • Sollte das nicht gehen.
    • ein Terminal starten
    • sudo -i -> damit wirst du root
    • dpkg -i Dateiname des Javapaketes z.B.
    • sudo apt-get install openjdk-11-jdk
    • gegebenenfalls muss vorher 
      apt --fix-broken install
      ausgeführt werden
  • mit java -version prüfen ob die Installation funktioniert hat
  • mit nano /etc/environment
    JAVA_HOME setzen z.B.: /lib/jvm/zulu-fx-11-amd64
  • mit echo $JAVA_HOME
    Prüfen ob das funktioniert hat.

Gegebenenfalls den Rechner mal neu starten

KES CLient herunterladen

Für eine allgemeine Anwendung kannst du den Kieselstein ERP Client unter /opt/kieselstein installieren (und hier auch zentral alle weiteren Dinge sammeln).

Bei einem lauffähigen Kieselstein ERP System findest du unter http://KIESELSTEIN_ERP_SERVER_ADRESSE:8080 alle nötigen Dateien (Für KIESELSTEIN_ERP_SERVER_ADRESSE in der Regel die IP-Adresse deines KLieselstein ERP Servers angeben )

  • Hier liegt unter Client-Install idealerweise ein angepasstes Client.zip
  • Dieses herunterladen und den Inhalt des zip z.B. nach /opt/kieselstein kopieren. Dabei auch den Ordner client mit kopieren
  • Nun ein Terminal öffnen, sudo -i (damit bist du root)
  • und nach /opt/kieselstein wechseln
  • und mit chmod -R 777 client für das client-Verzeichnis und seine Programme volle Berechtigungen setzen
  • nun mit cd client/bin/ ins Verzeichnis wechseln und ./kieselstein-client.sh starten

Einrichten der Desktop Verknüpfung

Das geht am besten mit “desktop” Files. Ein Muster findest du auch auf deinem Server unter /opt/kieselstein/dist/clients/ entweder im tar/gz oder direkt dann im bin Verzeichnis.

[Desktop Entry]
Name=Kieselstein Client
Comment=Kieselstein ERP Client
Exec=/opt/kieselstein/client/bin/kieselstein-client
Icon=/opt/kieselstein/client/bin/kieselstein-icon-square-96x96px.png
Terminal=false
Type=Application
Categories=Office

Als Icon kannst du aus dem Gitlab gerne die Kieselstein ERP Icons verwenden, bzw. das im Client.zip mit enthaltene Icon.

Für eine allgemeine Anwendung kannst du den Kieselstein ERP CLient unter /opt/kieselstein installieren (und hier auch zentral alle weiteren Dinge sammeln).

Also:

  • ein Terminal öffnen
  • mit sudo -i root werden
  • cd /opt
  • mkdir kieselstein
  • hier die Dateien aus dem Download inkl. Client einkopieren
  • nun die desktop Datei auf deinen Schreibtisch kopieren. Z.B.
cp /opt/kieselstein/client/bin/kieselstein.desktop /home/Benutzername/Schreibtisch/kieselstein.desktop
  • nun erscheint das Icon auf dem Desktop. Dieses mit der rechten Maustaste anklicken und Starten erlauben.

3 - Installation Client zu Kieselstein ERP unter Windows(r)

Installation Client zu Kieselstein ERP Server unter Windows(r)

Siehe bitte allgemeine Client Beschreibung

Abschalten der Einrichtemeldung

Windows 10

Siehe: https://support.microsoft.com/de-de/windows/benachrichtigungen-zur-ger%C3%A4teeinrichtung-deaktivieren-c88f6943-d169-23ca-5f3f-c6b927509e79

Übernommen aus obigem Artikel.

Nach jedem Neustart schlägt Windows vor, das Einrichten des Geräts zu beenden. Um dies unter Windows 10 abzuschalten, gehe bitte folgendermaßen vor:

  1. Start, Einstellungen, System, Benachrichtigungen und Aktionen
  2. Deaktiviere unter Benachrichtigungen das Kontrollkästchen neben Möglichkeiten vorschlagen, wie ich mein Gerät so einrichten kann, dass Windows optimal genutzt wird.

Windows 11

  1. Start, Einstellungen, System, Benachrichtigungen
  2. ganz nach unten scrollen und zusätzliche Einstellungen aufklappen
  3. ich persönlich entferne alle drei Häkchen

4 - Installation Client zu Kieselstein ERP unter macOS

Installation Client zu Kieselstein ERP Server unter macOS

Installation des Clients unter macOS

Du kannst den Client deines Kieselstein ERP auch unter macOS betreiben. Wichtig ist von Anfang an zu unterscheiden, mit welchem Prozessor dein MAC ausgestattet ist. Entweder X64 oder Arm. Diese Information findest du unter Apfel, über diesen MAC

und dann

Der Apple M1 ist das erste Arm-basierte System-on-a-Chip (SoC) von Apple für seine Mac-Computer. Wikipedia

Das benötigte Java findest du unter https://www.azul.com/downloads/?version=java-21-lts&os=macos&package=jdk-fx#zulu

Hier:
Nun das entsprechende Paket auswählen,

in der Regel .dmg.

In die Downloads gehen und

mit einem Doppelklick das JDK 21 von Azul installieren.

Du kannst nun prüfen, ob die soeben installierte Javaversion auch richtig installiert wurde. Dazu ein Terminal öffnen und java -version eingeben.

Herunterladen des Clients

Die Kieselstein ERP Installation stellt den Download deines Clients unter http://IPADRESSE_KIESELSTEIN_ERP:8080/clients bereit.

Öffne dazu das Terminal (Programme, Dienstprogramme, Terminal)

und lade das Archiv auf den Schreibtisch:

cd ~/Desktop
curl -O http://IPADRESSE_KIESELSTEIN_ERP:8080/clients/Client.zip

Ersetze IPADRESSE_KIESELSTEIN_ERP durch die Adresse deines Servers und Client.zip durch den Dateinamen, den dein Installationsverantwortlicher bereitgestellt hat. Welche Dateien das sind, siehst du mit:

curl http://IPADRESSE_KIESELSTEIN_ERP:8080/clients/

Anschließend entpacken und die Ausführenberechtigung für das Start-Script setzen:

unzip Client.zip
chmod +x ~/Desktop/Kieselstein/bin/kieselstein-client.sh



Meldung “Apple kann die Datei nicht auf Schadsoftware überprüfen”

Wurde das Archiv doch über den Browser geladen, so trägt das Start-Script die Quarantäne-Markierung und der Start wird mit der Meldung abgewiesen, dass Apple die Datei nicht auf Schadsoftware überprüfen kann.
Prüfen kannst du das im Terminal mit:

xattr -l ~/Desktop/Kieselstein/bin/kieselstein-client.sh

Steht dort com.apple.quarantine, so entferne die Markierung:

xattr -d com.apple.quarantine ~/Desktop/Kieselstein/bin/kieselstein-client.sh

Betrifft es mehrere Dateien, hebe die Markierung für das gesamte Verzeichnis auf:

xattr -dr com.apple.quarantine ~/Desktop/Kieselstein

ACHTUNG:
Wenn du im lokalen Netzwerk keinen Zugriff auf die interne Adresse deines Servers hast, so musst du in den Systemeinstellungen, Datenschutz & Sicherheit, lokales Netzwerk, dem Terminal bzw. deinem Browser die Zugriffsberechtigungen erlauben.

Hinweis: Beim ersten Zugriff auf die interne Netzwerkadresse wirst du nach der Freigabe gefragt. Diese mit Erlauben beantworten (erspart dir obige Einstellungen).

Nun im Finder in das Verzeichnis (Schreibtisch, Kieselstein, bin) wechseln und

auf kieselstein-client.sh mit der rechten Maustaste, Öffnen mit, Andere

Hier bei “Aktivieren” “Alle Programme” auswählen und das “Immer öffnen mit” anhaken.
Nun das Terminal auswählen.

Die nun folgende Sicherheitsmeldung mit “Öffnen” bestätigen.

Berechtigungsanpassungen für den Datenzugriff auf MacOS wurden im FAQ-Bereich der Doku genauer beschrieben.

Version 2.0.0

Ab der Version 2.0.0 wird Java 21 benötigt. Das Start-Script heißt kieselstein-client.sh.

Einrichten der Zugriffe

Setzen der Umgebungsvariablen für die Verbindung mit deinem Kieselstein Server.
Eintragen in der Datei .zshrc in deinem Benutzerverzeichnis

export KIESELSTEIN_SERVER=192.168.xx.yy
export KIESELSTEIN_LOCALE=de_DE

Für KIESELSTEIN_LOCALE stehen z.B. de_DE, de_CH, de_AT oder en_US zur Verfügung. Ohne diese Einträge verbindet sich der Client mit localhost und startet in der Sprache de_AT.

Verwendung unter ARM derzeit leider nicht empfohlen.

Beim Start der Version 2.0.0 (final) kommt leider die falsche Fehlermeldung Arimo Fonts nicht gefunden.
Trotz dieser Fehlermeldung können die Reports ordnungsgemäß gedruckt werden. Wir werden dies in einer der nächsten Versionen beheben.

MAC KnowHow

Verbinden am Mac zu einen anderen Server
  • Command(Taste) und K
  • nun die Verbindung angeben. Auf eine normale NAS z.B. mit SMB://192.168.xx.yy
  • Nun Benutzername und Passwort auf der externen Verbindung angeben.

Du findest dann dieses “Verzeichnis” im Finder unter Volumes, dann der Name der “Freigabe”

Besondere Druckereigenschaften einrichten

Siehe dazu

5 - Tipps zur Client Installation

Tipps und Infos zur Client-Installation

Nachfolgende eine Lose Sammlung an Infos rund um die Client-Installation.

Windows

Client Log

Wenn mal der Client einfach nicht starten will, so wünscht man sich meist ein Info was denn der Grund dafür sein könnte.
Diese Info wird in der Client-Log-Datei abgelegt.
Unter Windows findest du diese unter c:\user\benutzername.kse\Default\log\lpclient.log
Hier werden die täglichen Log-Dateien abgelegt, welche auch nie gelöscht werden.