FAQ Installation

Nachfolgend eine Sammlung der Fragen die rund um die Installation, sowohl am Client aber vor allem am Server auftreten.
Für die Angabe von Pfaden siehe

Server

Server startet nicht

• prüfe das Verzeichnis LW:\kieselstein\dist\wildfly-26.1.2.Final\standalone\deployments\
  Hier müssen drei Dateien mit *.deployed vorhanden sein.
  Ist dem nicht so, versuche den Server “manuell” zu starten
  • Beachte die Ausgaben, die auch in der Server Log-Datei (LW:\kieselstein\dist\wildfly-26.1.2.Final\standalone\log\server.log ) enthalten sind.
  • Achte vor allem darauf, ob der Zugriff auf die Datenbank möglich ist, ob hier eventuelle Fehlerhinweise sind.
• sind die Environment Variablen gesetzt?

Ist die Datenbank aktuell

• Ist deine Datenbank aktuell?
• ist das Liquibase Update fehlerfrei durchgelaufen?

Client

Server nicht erreichbar

Kommt nach dem Start des Clients die Meldung:
Der Server ist z.Z. nicht erreichbar

So bedeutet dies, dass unter der angegebenen IP-Adresse, bzw. dem Domainnamen (in unserem Beispiel localhost) der Kieselstein ERP Server nicht erreichbar ist.
Das kann mehrere Gründe haben:

• ist dein Kieselstein ERP Server an dieser Adresse überhaupt erreichbar.?
  • Überprüfen durch PING gegen die Adresse. ACHTUNG: Die Antwort auf den Ping ist meist aus Sicherheitsgründen abgeschaltet
  • Geht die Namensauflösung überhaupt.
    Hier haben wir schon oft erlebt, dass der Domänen Name als FQDN (Fully Qualified Domain Name) angegeben werden muss, damit die Auflösung in allen Lebenslagen funktioniert.
    
    • Hinweis:
      Je nach der Qualität der Implementierung des Domain-Namens-Servers, hat sich bewährt die IP-Adresse anzugeben, da damit die oftmalige Auflösung des DNS-Namens auf die IP-Adresse nicht notwendig ist.
    • Hinweis VPN Tunnel:
      In den meisten VPN Tunnel, ist die Auflösung des Domain Namens über den Tunnel abgeschaltet. D.h. bitte die IP-Adresse angeben.
• der Server läuft nicht. Siehe oben

Einstellungen am Server und am Client

IPV4

Bitte verwendet IPV4. Leider sind noch immer Komponenten in den internen Netzwerken im Einsatz, die IPV6 nicht ausreichend verlässlich unterstützen. Zusätzlich gibt es keinen Grund für ein Netzwerk mit “nur” ein paar hundert Komponenten IPV6 zu verwenden.

Datenbank kann über den PGAdmin nicht restored und nicht gesichert werden

Dies liegt meist daran, dass, obwohl der PGadmin deinstalliert und danach eine aktuelle Version installiert wurde, sich die alten Installationspfade merkt.
Wenn du nun z.B. das Postgres14 komplett entfernt hast und auf Postgres 18 gewechselt bist, so findet der PGAdmin die Pfade nicht mehr. Die kryptische Fehlermeldung lautet:

pg_restore: error: Unable to find a dll needed by the utility. Ensure .dll files needed by the utility are in the same folder as your executable.

Nun also den PGAdmin wieder richtig einstellen:

• Menüpunkt File, Preferences
  
• Den Paths Zweig erweitern und die Binary paths richtig einstellen. Z.B.:
  
• danach den PGAdmin neu starten

Üblicherweise zeigt die Pfad-Variable auf dein verwendetes PostgresQL.

Mit dem PGAdmin 9.18 gibt es zusätzlich obiges Problem, weshalb die Pfad Definitionen wie folgt aussehen sollten. ACHTUNG: Das kann bei unterschiedlichen PGAdmin Versionen unterschiedlich sein.

Auch nach dieser Änderung den PGAdmin neu starten.

Verwendete Environment Variablen

Nachfolgende eine Liste der Umgebungsvariablen, die von Kieselstein ERP verwendet werden.

Server

Pflicht

optional

Datendatenbank

Dokumentendatenbank

Client

Migration der Dokumentendatenbank (ab Version 2.1)

Siehe Datei migrate-jackrabbit.conf

Zusatzmodule / Schnittstellen

Dazu kommen die betriebssystemseitigen Klassiker, die Kieselstein voraussetzt: JAVA_HOME und die Erweiterung von PATH um das Postgres-bin-Verzeichnis.

Hinweis: Die maßgebliche, zur installierten Version passende Beschreibung liegt immer bei den Start-Skripten deiner Installation (README im bin-Verzeichnis unter dist); dort sind auch künftige Ergänzungen dokumentiert.