mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-26 14:40:29 +01:00
1 line
15 KiB
Plaintext
1 line
15 KiB
Plaintext
<p><span style="font-size:28px;"><strong>System Meldungen (System Health)</strong></span></p> <p>Im Modul System Meldungen erhalten Sie eine Überlick über den "Gesundheitszustand" Ihres 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><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=systemhealth&fileid=4" /><h1>Übersicht</h1> In der Übersicht erhalten Sie auf einen Blick alle Meldungen über den Gesundheitszustand des Systems.<br /><br />Warnungen werden in orange angezeigt, Fehlermeldungen in rot.<img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=systemhealth&fileid=5" /><h2>Beobachten</h2> Sollten bestimmte Meldungen in Ihrem System häufiger sein, können Sie diese als "beobachtet" erkennen. Im Fall des Auftretens eines solchen Fehlers wird Ihnen dann sofort ein Hinweis auch im laufenden Betrieb eingeblendet.<br /> <h2>Zeitlicher Ablauf der Systemprüfungen</h2> Die dargestellten Meldungen werden in verschiedenen Intervallen und zu verschiedenen Zeitpunkten erstellt.<br /><br />Regelmäßige Prüfung durch ProzessstarterWie weiter unten beschrieben führt der mitgelieferte Prozessstarter regelmäßig (typischerweise ein mal 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 /><br />Prüfung bei AusführungMeldungen 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>Prozessstarter</h1> Für die Funktionalität des System Health Moduls ist der Prozessstarter System Health notwendig. Diesen können Sie unter Administration → Einstellungen → Prozessstarter wiefolgt einstellen:<img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=systemhealth&fileid=6" />Für die Überprüfung doppelter Nummern ist zusätzlich der Doppelte Nummern prüfen notwendig.<h1>Fehlermeldungen und deren Bedeutung</h1> Dieser Eintrag befindet sich derzeit in der Überarbeitung - Stand: 10.01.2020<br /> <h2>Bereich MHD / Chargen / Seriennummern</h2><h3><br />Chargen-Schiefstand</h3> Beitrag folgt.<h3>MHD-Schiefstand</h3> Beitrag folgt.<h3>Abgelaufene MHD</h3> Beitrag folgt.<h3>Seriennummern</h3> <strong>Ursache</strong>: Es existieren mind. 2 gleiche Artikel mit identischen Seriennummern<br />Bewertung: <span style="color:#e74c3c;">Warnung</span><br /><strong>Lösung</strong>: Mit Hilfe des moduls Doppelte Nummern können Sie die Seriennummerin identifizieren und die Einträge manuell korrigieren.<br /> <h2>Bereich Prozessstarter</h2> <h3>Fehler</h3> Beitrag folgt.<h3>Aktivität</h3> Hier wird die letzte Ausführung des System-Prozessstarters protokolliert. Eine regelmäßige Ausführung führt zu einer regelmäßigen Aktialisierung des angezeigten Datums und der angezeigten Uhrzeit.<h3>Laufzeit</h3> Hinweis auf die systemseitig konfigurierte maximale Laufzeit der Prozessstarter. Empfohlen werden mind. 30 Sek.Ideal ist eine unbegrenzte Laufzeit.<br /> <h3>Speicher</h3> Hinweis auf die systemseitig konfigurierte maximale Speichertnutzung der Prozessstarter. Empfohlen werden mind. 128 MB Ideal sind mind. 512 MB je Prozess.<br /> <h3>Speicherüberlauf</h3> Beitrag folgt.<h2><br />Bereich Datenbank</h2><h3>DB-Version</h3> Beitrag folgt.<h3>DB-Version ab 20.2</h3> Ursache: Ab der Xentral-Version 20.2 werden Funktionen der MySQL-Datenbank in der Version 5.7 oder höher benötigt.Bewertung: Warnung bis Fehler (je nach verwendeter Xentral-Version)<br />Lösung: Bitte sorgen Sie rechtzeitig dafür, dass Ihr Systemadministrator oder Hosting-Provider auf die Datenbankversion 5.7 updated. Ein Update auf die Version 8.0 wird derzeit noch nicht empfohlen.<br /> <h3>SQL-Fehler</h3> Beitrag folgt.<h3>Datenintegrität</h3> <strong>Ursache</strong>: Es existieren "verwaiste" Datenbankeinträge, in der Regel handelt es sich dabei um Einträge der übergeordneter Bezug (Elternknoten) nicht mehr existiert. Hauptursache dafür sind unvollständig oder fehlerhaft manuell gelöschte Daten, z.B. Testdaten.<br />Bewertung: Warnung<br /><strong>Lösung</strong>: Klicken Sie bitte zunächst auf den Meldungstext. Sie kommen zu einer Seite auf der man die Datenbank per Klick auf den Button Testen kann. Im Anschluß sehen Sie eine Liste der gefundenen Integritätsfehler. 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-Snaphot erstellt werden um ggf. auf einen laufenden vorherigen Zustand des Systems zurückfallen zu können.<h2><br />Bereich Stammdaten</h2><h3>Doppelte Artikelnummern, Kundennummern, Lieferantennummern</h3> <strong>Ursache</strong>: Durch manuelle Bearbeitung, eine Änderung der Nummernkreisdefintion oder von Projekteinstellungen sind verschiedene Datensätze von Artikeln oder Adressen mit denselben Nummern belegt.<br />Bewertung: Hinweis<br /><strong>Lösung</strong>: Artikelnummern, Kundennummern und Lieferantennummern können durch Eingabe einer neuen Nummer geändert werden. Dazu können Sie durch einen Klick auf den Meldungstext in das Modul Doppelte Nummern springen. Dort werden Ihnen die Elemente mit gleichen Nummern angezeigt und können von dort aus einfach bearbeitet werden.<br /> <h3>Leere Artikelnummern</h3> <strong>Ursache</strong>: Artikel haben keine Artikelnummer<br />Bewertung: Hinweis<br /><strong>Lösung</strong>: 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.<br /> <h3>Rechnungsnummern, Gutschriftsnummern</h3> <strong>Ursache</strong>: Mind. 2 Rechnungen oder mind. 2 Gutschriften haben die gleiche Nummer<br />Doppelte Belegnummern bei Rechnungen und Gutschriften sollten in Regel nicht vorkommen. Es kann aber dazu kommen, wenn z.B. der eingestellte globale oder projektspezifische Nummernkreis zurücksetzt/verändert wurde oder wenn Belege über den Belege Importer ins System geladen wurden.<br />Bewertung: Warnung<br /><strong>Lösung</strong>:<ul><li>Bitte versuchen Sie zunächst 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, spielen Sie ggf. den letzten Datenbank-Snapshot wieder ein. Vor dem nächsten Import ändern Sie ggf. die Nummeernkreisdefinitionen oder bearbeiten Sie die Importdaten.</li><li>Sollten Sie über diese Methoden nicht zum Ziel gekommen sein, kontaktieren Sie bitte einen technischen Partner zur Bereinigung der Datenbankeinträge.</li></ul><br />Hinweis: Bitte stellen Sie sicher, das die Definition von Nummernkreisen nicht im laufenden Betrieb um gestellt werden. 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>Bereich Server</h2> <h3>Speicherplatz</h3> Anzeige des verbleibenden Speicherplatzes.Hinweis: Dieser Wert kann aus technischen Gründen nicht auf allen Systemen (z.B. Shared Hosting) abgefragt werden.<br /> <h3>Lizenz</h3> <strong>Ursache</strong>: Zeigt eine evtl. in Kürze ablaufende Lizenz (bei monatlicher Zahlweise im Mietmodell) bzw. ablaufenden Support (bei Kauflizenzen) an.Bewertung: Warnung (ab 14 Tage vor Ablauf der Lizenz) bis Fehler nach Ablauf der Lizenz<br /><strong>Lösung</strong>: Bitte kontaktieren Sie unseren Vertrieb zur Klärung oder zur Verlängerung der Lizenz.<br /><br />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, kontaktieren Sie bitte unseren Support.<h3>Scriptlauftzeit</h3> 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-Laufzeeit, eine Einstellung der Server-Konfiguration, wichtig.<h3>Upload-Kapazität</h3> Um sicherzustellen, dass Dateien und übertragene Formulardaten korrrekt auf den Server übertragen werden können ist die Upload-Kapazität, eine Einstellung der Server-Konfiguration, wichtig.<h3>PHP-Version</h3> 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>Userdata</h3> Meldung: Userdata-Verzeichnis nicht beschreibbar: 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.Meldung: Userdata-Verzeichnis von aussen einsehbar: 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 Verzeichniss 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>Bereich Einstellungen</h2><h3>Firmendaten</h3> Sollte es zu Problemen bei der Prüfung der hinterlegten Firmendaten kommen wird diese Meldung aktiv. In diesem Fall kontaktieren Sie bitte einen technischen Partner unter Hinweis auf die Meldung.<h3>Briefpapier</h3> Meldung: 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 Ihrem Server. In diesem Fall sollten Sie dringend ihr verwendeten Vorlagen (Briefpapier-PDF oder Logodatei) verkleinern.Lösung: Bitte kontaktieren Sie Ihre Grafik-Agentur oder erstellen Sie Ihre Hintergrunddateien unter Berücksichtigung der folgenden Tipps selbst noch einmal neu.<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 />Bereich Onlineshops</h2><h3>Authentifizierung</h3> Meldungen erscheinen bei Fehlern in der Verbindung zu Online-Shops.<h1>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 Sie diese Fehler gerne an uns zu melden, damit der Sache auf den Grund gehen können. Bitte gleichen SIe vorab Ihren Fehler mit der folgenden Liste ab 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 /> |