System Meldungen (System Health)

 

Im Modul System Meldungen ist ein Überlick über den "Gesundheitszustand" des Systems. Entdeckt das System an verschiedenen Stellen Unstimmigkeiten, wie etwa doppelte Nummern, Fehler beim Ausführen von Prozessstartern, einen vollgelaufenen Speicher o.Ä. wird eine Warn- oder Fehlermeldung in der System Health Übersicht erzeugt.


 

Übersicht

In der Übersicht sind auf einen Blick alle Meldungen über den Gesundheitszustand des Systems ersichtlich. Warnungen werden in orange angezeigt, Fehlermeldungen in rot.
 




Beobachten

Sollten bestimmte Meldungen im System häufiger sein, werden diese "beobachtet". Im Fall des Auftretens eines solchen Fehlers wird dann sofort ein Hinweis, auch im laufenden Betrieb, eingeblendet.
 

 

Zeitlicher Ablauf der Systemprüfungen

Die dargestellten Meldungen werden in verschiedenen Intervallen und zu verschiedenen Zeitpunkten erstellt.
 

Regelmäßige Prüfung durch Prozessstarter

Wie weiter unten beschrieben führt der mitgelieferte Prozessstarter regelmäßig (typischerweise einmal täglich) ausführliche Prüfroutinen durch, um den Systemzustand zu bewerten.
Einige der regelmäßig ausgeführten Prüfungen werden beim Aufruf des Moduls System Meldungen erneut ausgeführt. Im Zweifel lohnt sich also nach der Lösung eines Problems der erneute Aufruf des Modules. Eine wiederholte Ausführung des Prozesstarters wird jedoch auf Grund der u.U. langen Laufzeit nicht empfohlen. Das System würde stärker ausgelastet und die Aussagekraft der Meldungen durch zeitliche Überschneidungen beeinträchtigt.
 

Prüfung bei Ausführung

Meldungen wie z.B. die Connectivität zu Online-Shops oder APIs, Übertragen. Moduls o.ä. werden zum Zeitpunkt des erkennens protokolliert und in der Anzeige vorgehalten bis sie zurückgesetzt werden. Dabei ist es möglich, dass zwischenzeitlich bereits erfolgreiche Verbindungen stattgefunden haben. Die Meldung ist in diesem Fall veraltet, deutet jedoch immer noch auf eine mind. einmalige fehlerhafte Verbindung hin.
 


Prozessstarter

Für die Funktionalität des System Health Moduls ist der Prozessstarter System Health notwendig. Dieser kann unter Administration → Einstellungen → Prozessstarter nach diesem Muster eingestellt werden:



Für die Überprüfung doppelter Nummern ist zusätzlich der Prozessstarter "Doppelte Nummern prüfen" notwendig.



Fehlermeldungen und deren Bedeutung

MHD / Chargen / Seriennummern

Chargen-Schiefstand

Meldung wenn Chargeneinträge nicht mit der Menge der vorhandenen Artikel zusammenpassen.


MHD-Schiefstand

Meldung wenn Chargeneinträge nicht mit der Menge der vorhandenen Artikel zusammenpassen.


Abgelaufene MHD

Es wurden Artikel gefunden, bei denen das Mindesthaltbarkeitsdatum überschritten wurde.


Seriennummern

Es existieren mind. 2 gleiche Artikel mit identischen Seriennummern. Mit Hilfe des Moduls "Doppelte Nummern" können die Seriennummern identifiziert und die Einträge manuell korrigiert werden.
 


Prozessstarter

Fehler

Hier werden Hinweise aufgeführt, wenn aktive Prozessstarter nicht richtig ausgeführt oder nicht korrekt beendet werden konnten.

Prozessstarter, die nicht benötigt werden, können unter Administration → Einstellungen → Prozessstarter einfach deaktiviert werden. Das ist vor allem dann sinnvoll, wenn ein Prozessstarter läuft, man aber das dazugehörige Modul nicht besitzt oder nicht verwendet.

Wird ein Prozessstarter auch wirklich gebraucht, aber nicht korrekt beendet, so kann er unter Administration → Einstellungen → Prozessstarter noch einmal manuell angestoßen werden, was oftmals schon ausreicht.

Läuft der Prozessstarter auch nach mehreren Versuchen nicht durch, so empfiehlt es sich die Ursache am Server zu suchen, also den Serverhoster oder -administrator zu kontaktieren. Kunden, deren System auf der xentral Cloud gehostet sind, können sich per Support-Ticketsystem an xentral wenden.
 

Aktivität

Hier wird die letzte Ausführung des System-Prozessstarters protokolliert. Eine regelmäßige Ausführung führt zu einer regelmäßigen Aktualisierung des angezeigten Datums und der angezeigten Uhrzeit.


Laufzeit

Hinweis auf die systemseitig konfigurierte maximale Laufzeit der Prozessstarter. Empfohlen werden mind. 30 Sek. Ideal ist eine unbegrenzte Laufzeit.
 

Speicher

Hinweis auf die systemseitig konfigurierte maximale Speichertnutzung der Prozessstarter. Empfohlen werden mind. 128 MB. Ideal sind mind. 512 MB je Prozess.


Speicherüberlauf

Diese Meldung erscheint, wenn der Serverspeicher voll ist.



Datenbank

DB-Version

Diese Meldung erscheint, wenn die Datenbank Version veraltet ist.


DB-Version ab 20.2

Die Ursache ist, dass ab der Xentral-Version 20.2 Funktionen der MySQL-Datenbank in der Version 5.7 oder höher benötigt werden. Die Lösung ist, dass rechtzeitig dafür gesorgt wird, dass der Systemadministrator oder Hosting-Provider auf die Datenbankversion 5.7 updated.
 

SQL-Fehler

Es ist ein Fehler im Zusammehang mit SQL-Queries erkannt worden.


Datenintegrität

Die Ursache hier ist, dass "verwaiste" Datenbankeinträge existieren. In der Regel handelt es sich dabei um Einträge bei denen der übergeordneter Bezug (Elternknoten) nicht mehr existiert. Hauptursache dafür sind unvollständig oder fehlerhaft manuell gelöschte Daten, z.B. Testdaten. Zur Lösung ist zunächst auf den Meldungstext zu klicken. Es erscheint eine Seite auf der die Datenbank per Klick auf den Button "Testen" getestet werden kann. Im Anschluß ist eine Liste der gefundenen Integritätsfehler ersichtlich. Hier können einige per Klick in der Spalte Aktion gefixt werden. Alle anderen Fehler können durch einen Techniker durch einen Blick auf die Datenbank geprüft werden. Zur Lösung ist in der Regel ein Techniker notwendig. Ggf. kann xentral einen Kontakt zu einem unserer IT-Partner herstellen.

Hinweis: Es wird dringend davon abgeraten direkt auf Datenbankebene in xentral zu arbeiten. Die Datenintegrität kann durch solche Eingriffe gefährdet werden. In jedem Fall muss vorab ein Datenbank-Snapshot erstellt werden um ggf. auf einen laufenden vorherigen Zustand des Systems zurückfallen zu können.



Stammdaten

Doppelte Artikelnummern, Kundennummern, Lieferantennummern

Diese Hinweismeldung entsteht durch manuelle Bearbeitung, eine Änderung der Nummernkreisdefintion oder von Projekteinstellungen sind verschiedene Datensätze von Artikeln oder Adressen mit denselben Nummern belegt. Zur Artikelnummern, Kundennummern und Lieferantennummern können durch Eingabe einer neuen Nummer geändert werden. Es ist möglich durch einen Klick auf den Meldungstext in das Modul Doppelte Nummern zu springen. Dort werden die Elemente mit gleichen Nummern angezeigt und können von dort aus einfach bearbeitet werden.

 

Leere Artikelnummern

Bei diesem Hinweis haben Artikel keine Artikelnummer. Artikel mit leeren Artikelnummern können durch Eingabe einer neuen Artikelnummer ergänzt werden. Artikel werden in der Regel über ihre technische ID angesprochen, eine Ergänzung fehlender Artikelnummern ist also möglich.

 

Rechnungsnummern, Gutschriftsnummern

Bei dieser Warnung haben mind. 2 Rechnungen oder mind. 2 Gutschriften die gleiche Nummer. Doppelte Belegnummern bei Rechnungen und Gutschriften sollten in der Regel nicht vorkommen. Es kann aber dazu kommen, wenn z.B. der eingestellte globale oder projektspezifische Nummernkreis zurückgesetzt/verändert wurde oder wenn Belege über den Belege Importer ins System geladen wurden.

Lösung:
Hinweis: Es ist sicherzustellen, dass die Definition von Nummernkreisen nicht im laufenden Betrieb umgestellt wird. Sollten Projekte eigene Nummernkreise besitzen sollte diese Einstellung dringend beibehalten werden. Bereits mit dem Abschalten des eigenen Nummernkreises in einem Projekt können doppelten Nummern "erzeugt" werden da diese nun nicht mehr als projektspezifisch angesehen werden.
 


Server

Speicherplatz

Anzeige des verbleibenden Speicherplatzes.
Hinweis: Dieser Wert kann aus technischen Gründen nicht auf allen Systemen (z.B. Shared Hosting) abgefragt werden.
 

Lizenz

Zeigt eine evtl. in Kürze ablaufende Lizenz (bei monatlicher Zahlweise im Mietmodell) bzw. ablaufenden Support (bei Kauflizenzen) an. Es erscheint eine Warnung (ab 14 Tage vor Ablauf der Lizenz) oder ein Fehler nach Ablauf der Lizenz Zur Lösung ist der xentral Vertrieb zur Klärung oder zur Verlängerung der Lizenz zu kontaktieren.

Hinweis: Unter Umständen kann bei Cloud-Lizenzen nach längerer Inaktivität (länger 30 Tage) ein Hinweis auf eine abgelaufene Lizenz angezeigt werden. Durch eine erneute Prüfung (z.B. durch den prüfemdem Prozessstarter oder den Aufruf des Moduls System Meldungen kann dieser Hinweis entfernt werden. Sollte sich der Hinweis trotz gültiger Cloud-Lizenz nicht entfernen lassen, ist der xentral Support zu kontaktieren.

 

Scriptlauftzeit

Um sicherzustellen, dass auch länger andauernde Berechnungen in Prozessstartern korrekt und abschließend ausgeführt werden können, ist die Länge der erlaubten Script-Laufzeit, eine Einstellung der Server-Konfiguration, wichtig.

 

Upload-Kapazität

Um sicherzustellen, dass Dateien und übertragene Formulardaten korrekt auf den Server übertragen werden können, ist die Upload-Kapazität, eine Einstellung der Server-Konfiguration, wichtig.

 

PHP-Version

Bei PHP handelt es sich um eine Serversoftware (genauer: einen Interpreter), die notwendig ist um xentral ablaufen zu lassen. Da diese Software serverseitig in verschiedenen Versionen vorliegen kann, die unterschiedliche Funktionalität bieten, ist die korrekte Mindestversion relevant für das Ausführen von xentral ERP.

 

Userdata

Wenn die Meldung "Userdata-Verzeichnis nicht beschreibbar" erscheint, gilt: Dieser kritische Fehler muss dringend durch den Systemadministrator oder Hosting-Provider behoben werden. Dabei muss sichergestellt werden, dass das Verzeichnis userdata und alle Unterverzeichnisse durch den Benutzer beschreibbar ist, der den Webserver undd die Cronjobs (z.B. starterX.php) ausführt. Ohne eine Behebung dieses Fehler können keine Datein gespeichert, keine PDF-Archive angelegt oder Snapshots der Datenbank gesichert werden.

Wenn die Meldung "Userdata-Verzeichnis von aussen einsehbar" erscheint, gilt: Dieser Fehler sollte aus Gründen des Datenschutzes durch den Systemadministrator oder Hosting-Provider behoben werden.

Dazu kann 


Einstellungen

Firmendaten

Sollte es zu Problemen bei der Prüfung der hinterlegten Firmendaten kommen wird diese Meldung aktiv. 

 

Briefpapier

Die Verwendung von zu großen PDF-Hintergrunddateien oder eines sehr hochauflösenden Logos führt bei hoher Anzahl von Belegen schnell zu einem unnötig hohen Speicherplatzbedarf auf dem Server. In diesem Fall sollten dringend die verwendeten Vorlagen (Briefpapier-PDF oder Logodatei) verkleinert werden. Zur Lösung ist die Grafik-Agentur zu kontaktieren oder die Hintergrunddateien unter Berücksichtigung der folgenden Tipps selbst noch einmal neu zu erstellen.
Eine gute Dateigröße für hinterlegte Briefpapier-PDF-Dateien ist 50 kB.



Bereich Onlineshops

Authentifizierung

Diese Meldungen erscheinen bei Fehlern in der Verbindung zu Online-Shops.



Bekannte Probleme / Known Issues

Das Modul System Health befindet sich derzeit im Beta-Stadium. Daher können vereinzelt sog. Falsch-Positive Meldungen auftreten, d.h. es werden Fehler angezeigt die nicht existieren. Außerdem werden Fehler angezeigt, die bereits seit längerem im System vorliegen (wie z.B. Inkonsistente Daten).

Wir bitten diese Fehler gerne an uns zu melden, damit xentral die Ursache beheben kann. Bitte vorab den Fehler mit der folgenden Liste abgleichen, um Mehrfachmeldungen zu vermeiden.


Liste Bekannter Probleme

(Stand 20.02.2020)