Diagnose- und Konfigurationsseite des SLON EIC

SLON EIC bringt eine eigene Weboberfläche mit, die direkt am Server im Browser aufgerufen wird. Sie hat zwei Aufgaben:

Status und Fehlersuche – auf einen Blick sehen, ob die Schnittstelle funktioniert, und bei einem Problem erfahren, was zu tun ist.
Konfiguration – die Einstellungen des SLON EIC im Browser ansehen und ändern, statt die Konfigurationsdatei von Hand zu bearbeiten.

Damit lassen sich die meisten Probleme ohne Anruf beim SLON Support erkennen und beheben.

Verfügbar ab Version 1.5.0

Die Diagnose- und Konfigurationsseite ist ab SLON EIC Version 1.5.0 enthalten und nach der Installation automatisch eingeschaltet.

Seite aufrufen

Öffnen Sie auf dem Computer, auf dem SLON EIC installiert ist, im Browser die Adresse:

http://localhost:5099

Die Seite ist standardmäßig nur auf diesem Computer erreichbar. Rechts oben wählen Sie die Sprache (Deutsch, Italienisch, Englisch) und ob sich die Anzeige automatisch aktualisieren soll.

Zugriff von anderen Rechnern

Soll die Seite auch von anderen Rechnern im Netzwerk erreichbar sein, muss in der Konfiguration eine Netzwerkadresse eingetragen und ein SLON EIC Passwort gesetzt sein – ohne Passwort startet die Seite in diesem Fall nicht. Zusätzlich muss der Port in der Windows-Firewall freigegeben werden; das erledigt die Installation bewusst nicht automatisch. Die Seite ist dann für alle Benutzer nur mit diesem Passwort zugänglich.

Tab „Status“: Probleme erkennen und beheben

Der Tab Status zeigt den aktuellen Zustand der Schnittstelle:

Bereich	Was Sie dort sehen
Was ist zu tun?	Alle aktuellen Probleme, jeweils mit einem konkreten Lösungshinweis. Ist alles in Ordnung, bleibt dieser Bereich leer.
SLON-Plattform	Ob die Anmeldung funktioniert – zum Beispiel „Zugangsdaten falsch“, „Rolle EIC fehlt“ oder „nicht erreichbar“ –, wann zuletzt erfolgreich Kontakt bestand, sowie Echtzeitkanal und Proxy.
Warteschlange	Wie viele Aufträge noch nicht an SLON übertragen wurden und seit wann der älteste wartet; außerdem Aufträge, die SLON abgelehnt hat.
Schnittstellen	Datei-Import, REST-Schnittstelle, Webhook und Export mit Ordner bzw. Adresse und letzter Aktivität. Erkannt werden unter anderem fehlende Ordner, ein bereits belegter Port und Dateien, die im Importordner liegen geblieben sind.
Aktivitäten	Die letzten Vorgänge, filterbar nach OK, Probleme und Fehler, nach Bereich und per Suchtext – etwa nach Ihrer Belegnummer oder der SLON-ID. Ein Klick auf einen Eintrag zeigt die technischen Details. Die Aktivitäten bleiben auch nach einem Neustart des Dienstes erhalten.
Service-Log	Das Ende der Protokolldatei des Dienstes.

Diagnosebericht für den Support

Über „Diagnosebericht herunterladen“ erzeugen Sie eine Textdatei mit Status, Aktivitäten und Protokoll. Passwörter und Schlüssel sind darin automatisch entfernt. Bitte senden Sie diese Datei bei jeder Support-Anfrage zum SLON EIC mit – das verkürzt die Fehlersuche erheblich.

Tab „Konfiguration“: SLON EIC im Browser einrichten

Im Tab Konfiguration sehen Sie die aktuellen Einstellungen des SLON EIC – ohne Passwörter. Mit dem SLON EIC Passwort können Sie die Einstellungen auch bearbeiten und speichern.

Bearbeitet werden können:

Abschnitt	Einstellungen
SLON-Plattform	Server-Adresse, Benutzer (EICUser@sloncompany_<Betriebs-ID>), neues SLON-Passwort
Datei-Import (Excel)	Importordner, Dateifilter, Backup-Ordner, Aufbau der Transporteinheiten und Zuordnung der Spalten zu den Feldern in SLON
Export (Rechnungsdaten)	Exportdatei, Report-ID, MwSt.-Satz und Auslöser des Exports (z. B. Intervall oder fester Tag und Uhrzeit im Monat)
REST-Schnittstelle (ERP)	Adresse, API-Key und Webhook-URL für die Anbindung Ihres ERP-Systems
Diagnoseseite	Seite ein/aus, Adresse, Anzahl gespeicherter Aktivitäten, Anzeige des Service-Logs

So ändern Sie die Konfiguration

Öffnen Sie den Tab Konfiguration und geben Sie das SLON EIC Passwort ein. Klicken Sie auf „Entsperren“.
Ändern Sie die gewünschten Felder. Das Feld „Neues SLON-Passwort“ lassen Sie leer, um das gespeicherte Passwort zu behalten.
Klicken Sie auf „Speichern“. Die Eingaben werden vorher geprüft: Fehler sind markiert und verhindern das Speichern, Hinweise nicht.
Starten Sie den Dienst neu – siehe unten.

Die vorherige Konfiguration wird bei jedem Speichern automatisch gesichert (die letzten zehn Stände im Unterordner config-backups des Programmverzeichnisses). Jede Änderung erscheint mit den geänderten Feldern in den Aktivitäten. Einstellungen, die im Formular nicht vorkommen, bleiben beim Speichern unverändert erhalten. Nach 30 Minuten oder über „Sperren“ wird die Bearbeitung wieder gesperrt.

Neustart erforderlich

Gespeicherte Änderungen gelten erst nach einem Neustart des Dienstes: Windows-Dienste (services.msc) → „SlonEIC“ → Neu starten, oder in einer PowerShell mit Administratorrechten Restart-Service SlonEIC. Bis dahin weisen beide Tabs auf den ausstehenden Neustart hin – auch wenn die Konfigurationsdatei von Hand geändert wurde.

SLON EIC Passwort setzen (einmalig)

Nach einer Neuinstallation ist noch kein SLON EIC Passwort gesetzt; die Konfiguration kann dann nur angesehen werden. Das Passwort wird aus Sicherheitsgründen nicht über die Seite selbst gesetzt, sondern einmalig von Hand:

Öffnen Sie die Datei config.json im Programmverzeichnis (standardmäßig C:\Programme (x86)\SLON EIC) mit einem Texteditor mit Administratorrechten.
Ergänzen Sie im Abschnitt Diagnostics den Eintrag „Password“: „IhrPasswort“.
Starten Sie den Dienst neu.

Beim Start überträgt SLON EIC das Passwort in den sicheren Speicher von Windows (Anmeldeinformationsverwaltung) und entfernt es aus der Datei – genauso wie das SLON-Passwort. Ein neues Passwort setzen Sie auf demselben Weg.

Zu viele Fehlversuche

Nach fünf falschen Passwörtern ist die Anmeldung für fünf Minuten gesperrt.

Wenn SLON EIC nicht startet

Fehlt die Konfigurationsdatei oder ist sie fehlerhaft, arbeitet SLON EIC keine Aufträge ab, die Diagnose- und Konfigurationsseite läuft aber weiter. Sie zeigt dann, was an der Konfiguration fehlt. Wurde schon früher ein SLON EIC Passwort gesetzt, können Sie die Konfiguration direkt im Browser korrigieren.

Überwachung durch Ihre IT

Unter http://localhost:5099/api/status liefert SLON EIC den Gesamtstatus für Überwachungssysteme. Der HTTP-Status ist 200, solange alles in Ordnung ist oder nur Warnungen vorliegen, und 503 bei einer Störung. Ein einfacher HTTP-Check in PRTG, Zabbix, Checkmk o. ä. genügt, um bei Problemen automatisch alarmiert zu werden.

Inhaltsverzeichnis