slonwiki:eic:diagnose_konfiguration [SLON Knowledge Center]

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== 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.

<callout type="info" title="Verfügbar ab Version 1.5.0" icon="true">
Die Diagnose- und Konfigurationsseite ist ab SLON EIC Version 1.5.0 enthalten und nach der Installation automatisch eingeschaltet.
</callout>

{{draft:wiki:pasted:todo_screenshot_eic_diagnose_status.png}}

===== Seite aufrufen =====

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

<code>
http://localhost:5099
</code>

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.

<callout type="warning" title="Zugriff von anderen Rechnern" icon="true">
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.
</callout>

===== 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. |

<callout type="info" title="Diagnosebericht für den Support" icon="true">
Ü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.
</callout>

===== 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.

{{draft:wiki:pasted:todo_screenshot_eic_diagnose_konfiguration.png}}

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.

<callout type="warning" title="Neustart erforderlich" icon="true">
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.
</callout>

==== 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.

<callout type="info" title="Zu viele Fehlversuche" icon="true">
Nach fünf falschen Passwörtern ist die Anmeldung für fünf Minuten gesperrt.
</callout>

===== 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.

===== Verwandte Artikel =====

  * [[slonwiki:eic:start|SLON EIC – Datenaustausch mit externer Software]]
  * [[slonwiki:eic:schnittstellen|Verfügbare SLON EIC Schnittstellen]]
  * [[slonwiki:eic:transport_beauftragen|Transportbeauftragung über SLON EIC]]
  * [[slonwiki:referenz:support|SLON Support kontaktieren]]