mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-11-15 12:37:14 +01:00
1 line
18 KiB
Plaintext
1 line
18 KiB
Plaintext
<p><span style="font-size:28px;"><strong>System Meldungen (System Health)</strong></span></p> <p>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.</p><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=systemhealth&fileid=3711" style="width: 1200px; height: 591px;" /><br /> <h1>Übersicht</h1> In der Übersicht sind auf einen Blick alle Meldungen über den Gesundheitszustand des Systems ersichtlich. Warnungen werden in orange angezeigt, Fehlermeldungen in rot.<br /> <h2><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=systemhealth&fileid=3712" style="width: 1200px; height: 626px;" /><br /><br /><br />Beobachten</h2> 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.<br /> <h2> </h2><h1>Zeitlicher Ablauf der Systemprüfungen</h1> Die dargestellten Meldungen werden in verschiedenen Intervallen und zu verschiedenen Zeitpunkten erstellt.<br /> <h2>Regelmäßige Prüfung durch Prozessstarter</h2>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.<br />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.<br /> <h2>Prüfung bei Ausführung</h2>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.<br /> <h1><br />Prozessstarter</h1> 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:<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=systemhealth&fileid=3713" style="width: 1200px; height: 441px;" /><br /><br />Für die Überprüfung doppelter Nummern ist zusätzlich der Prozessstarter "Doppelte Nummern prüfen" notwendig.<h1><br /><br />Fehlermeldungen und deren Bedeutung</h1><h2>MHD / Chargen / Seriennummern</h2><p><span style="color:null;"><span style="font-size:16px;"><strong>Chargen-Schiefstand</strong></span></span></p> Meldung wenn Chargeneinträge nicht mit der Menge der vorhandenen Artikel zusammenpassen.<p><br /><span style="color:null;"><span style="font-size:16px;"><strong>MHD-Schiefstand</strong></span></span></p><span style="color:null;"> </span>Meldung wenn Chargeneinträge nicht mit der Menge der vorhandenen Artikel zusammenpassen.<p><br /><span style="font-size:16px;"><strong>Abgelaufene MHD</strong></span></p> Es wurden Artikel gefunden, bei denen das Mindesthaltbarkeitsdatum überschritten wurde.<p><br /><span style="font-size:16px;"><strong>Seriennummern</strong></span></p> 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.<br /> <h2><br />Prozessstarter</h2><p><span style="font-size:16px;"><strong>Fehler</strong></span></p><p>Hier werden Hinweise aufgeführt, wenn aktive Prozessstarter nicht richtig ausgeführt oder nicht korrekt beendet werden konnten.</p><p>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.</p><p>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.</p><p>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.<br /> </p><p><span style="font-size:16px;"><strong>Aktivität</strong></span></p> 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.<h3><br /><span style="font-size:16px;"><strong>Laufzeit</strong></span></h3> Hinweis auf die systemseitig konfigurierte maximale Laufzeit der Prozessstarter. Empfohlen werden mind. 30 Sek. Ideal ist eine unbegrenzte Laufzeit.<br /> <h3><span style="font-size:16px;"><strong>Speicher</strong></span></h3> Hinweis auf die systemseitig konfigurierte maximale Speichertnutzung der Prozessstarter. Empfohlen werden mind. 128 MB. Ideal sind mind. 512 MB je Prozess.<h3><br /><span style="color:null;"><span style="font-size:16px;"><strong>Speicherüberlauf</strong></span></span></h3>Diese Meldung erscheint, wenn der Serverspeicher voll ist.<h2><br /><br />Datenbank</h2><p><span style="color:null;"><span style="font-size:16px;"><strong>DB-Version</strong></span></span></p>Diese Meldung erscheint, wenn die Datenbank Version veraltet ist.<p><br /><span style="color:null;"><strong><span style="font-size:16px;">DB-Version ab 20.2</span></strong></span></p>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.<br /> <p><span style="color:null;"><span style="font-size:16px;"><strong>SQL-Fehler</strong></span></span></p> Es ist ein Fehler im Zusammehang mit SQL-Queries erkannt worden.<p><br /><span style="font-size:16px;"><strong>Datenintegrität</strong></span></p> 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.<br /><br /><strong>Hinweis</strong>: 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.<h2><br /><br />Stammdaten</h2><p><span style="font-size:16px;"><strong>Doppelte Artikelnummern, Kundennummern, Lieferantennummern</strong></span></p><p>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.</p> <p><span style="font-size:16px;"><strong>Leere Artikelnummern</strong></span></p><p>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.</p> <p><span style="font-size:16px;"><strong>Rechnungsnummern, Gutschriftsnummern</strong></span></p><p>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.</p><strong>Lösung</strong>:<ul><li>Zunächst ist auf Basis unseres Helpdeskeintrages des Moduls Doppelte Nummern die Meldung zu bearbeiten.</li><li>Sind die Fehler durch einen Import (z.B. über den Belegimporter) entstanden, ist ggf. der letzte Datenbank-Snapshot wieder einzuspielen. Vor dem nächsten Import sind ggf. die Nummernkreisdefinitionen zu ändern oder die Importdaten zu bearbeiten.</li><li>Sollte dies nicht funktioniert haben, ist unser Support oder ein technischer Partner zur Bereinigung der Datenbankeinträge zu kontaktieren.</li></ul><br /><strong>Hinweis</strong>: 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.<br /> <h2><br />Server</h2><p><span style="font-size:16px;"><strong>Speicherplatz</strong></span></p> Anzeige des verbleibenden Speicherplatzes.<br /><strong>Hinweis</strong>: Dieser Wert kann aus technischen Gründen nicht auf allen Systemen (z.B. Shared Hosting) abgefragt werden.<br /> <p><span style="font-size:16px;"><strong>Lizenz</strong></span></p> 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.<br /><br /><strong>Hinweis</strong>: 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.<h3> </h3><p><span style="font-size:16px;"><strong>Scriptlauftzeit</strong></span></p> 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.<h3> </h3><p><span style="font-size:16px;"><strong>Upload-Kapazität</strong></span></p> 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.<h3> </h3><p><span style="font-size:16px;"><strong>PHP-Version</strong></span></p> 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.<h3> </h3><p><span style="font-size:16px;"><strong>Userdata</strong></span></p> 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.<br /><br />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.<br /><br />Dazu kann<ul><li>entweder in der Webserver-Konfiguration die DocRoot umgesetzt werden (auf das Verzeichnis ""www"", das in Standardfall parallel zum Verzeichnis userdata liegt), so dass das userdata Verzeichnis nicht mehr "offen" ist.</li><li>Alternativ kann das userdata Verzeichnis auch nach "oberhalb" der Docroot verschoben werden und dann in der Datei userinc.php der Pfad angepasst werden.</li><li>Je nach Webserver (i.d.R. apache oder nginx) kann auch per .htaccess der Zugriffsschutz auf das userdata Verzeichnis entzogen werden.</li></ul> <h2><br />Einstellungen</h2><p><span style="font-size:16px;"><strong>Firmendaten</strong></span></p> Sollte es zu Problemen bei der Prüfung der hinterlegten Firmendaten kommen wird diese Meldung aktiv. <h3> </h3><p><span style="font-size:16px;"><strong>Briefpapier</strong></span></p>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.<ul><li>keine vollformatigen Scans sondern nur Flächen hinterlegen, die notwendig sind (z.B. Kopf und Fussbereich)</li><li>Verwendung von Vektordaten für Logos und andere grafische Elemente</li><li>Texte immer als Schrift setzen, nicht als Bild</li><li>PDF-Datei nicht rastern und platzsparend abspeichern</li></ul><br />Eine gute Dateigröße für hinterlegte Briefpapier-PDF-Dateien ist 50 kB.<h2><br /><br />Bereich Onlineshops</h2><p><span style="font-size:16px;"><strong>Authentifizierung</strong></span></p>Diese Meldungen erscheinen bei Fehlern in der Verbindung zu Online-Shops.<h1><br /><br />Bekannte Probleme / Known Issues</h1> 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).<br /><br />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.<h2><br />Liste Bekannter Probleme</h2> (Stand 20.02.2020)<ul><li>VAT-Meldung: Link defekt</li><li>Meldung Dateninkonsistenz: arbeitspaket.projekt > projekt.id</li><li>Meldung "Doppelte Kundennummern" wird angezeigt, Modul Doppelte Nummern zeigt keine Fehler</li><li>Meldung "Doppelte Lieferantennummern" wird angezeigt, Link verweist auf Modul Doppelte Nummern / Doppelte Kundennummern und zeigt keine Fehler</li><li>Meldung Dateninkonsistenz: documente_send.adresse > adresse.id</li><li>Meldung Dateninkonsistenz: produktion_protokoll.produktion > produktion.id</li><li>Meldung Dateninkonsistenz: datei_version.datei > datei.id und datei_stichwoerter.datei > datei.id</li><li>Meldung Dateninkonsistenz: pdfarchiv.table_id > rechnung.id, pdfarchiv.table_id > auftrag.id, pdfarchiv.table_id > bestellung.id, pdfarchiv.table_id > angebot.id</li><li>Meldung Dateninkonsistenz: verkaufspreise.artikel > artikel.id</li><li>Meldung Dateninkonsistenz: einkaufspreise.artikel > artikel.id und verkaufspreise.artikel > artikel.id</li><li>Meldung Dateninkonsistenz: pdfarchiv.table_id > lieferschein.id und beleg_chargesnmhd.doctypeid > lieferschein.id</li><li>Warnmeldung bzgl. Doppelter Nummern verhält sich umgekehrt zu Administration => Einstellungen => Grundeinstellungen => Doppelte Seriennummern</li><li>Meldung Doppelte Seriennummern: Link zum Serinnummernmodul funktioniert nicht</li></ul><br /><br /> |