Dienste und Hintergrundprozesse: Was läuft auf dem FMWeb-Server?
Dieser Artikel beschreibt, welche Prozesse und Hintergrundaufgaben auf einem FMWeb-Server laufen, in welchen Intervallen sie arbeiten und welche davon Netzwerkverbindungen aufbauen. Die fachliche Konfiguration der Aufgaben erklärt Artikel 15.
Ein Prozess, keine zusätzlichen Dienste
FMWeb installiert keine Windows-Dienste. Die gesamte Anwendung – Webserver, Oberfläche und alle Automatiken – läuft in einem einzigen Prozess: FmWeb.Blazor.exe. Gestartet und am Leben gehalten wird dieser Prozess durch den geplanten Task \Cloudkasten\FMWeb (Windows-Aufgabenplanung): Start beim Hochfahren, automatischer Neustart bei Beendigung, keine zweite parallele Instanz (Artikel 145).
Im Task-Manager bzw. der Aufgabenplanung sehen Sie also genau einen FMWeb-Eintrag. Alle folgenden „Aufgaben" sind Threads innerhalb dieses Prozesses.
Die Hintergrundaufgaben im Überblick
| Aufgabe | Intervall | Zweck | Netzwerk |
|---|---|---|---|
| E-Mail-Versand (Mail-Task) | prüft laufend (ca. alle 10 s), Versandpause konfigurierbar | Versendet die E-Mail-Warteschlange aller Mandanten per SMTP (Artikel 01) | SMTP |
| Infomail-Erzeugung | täglich; versendet nur am konfigurierten Wochentag | Erzeugt Erinnerungs-E-Mails: Führerschein, Reifenwechsel, UVV, HU, Leasing, Kilometer-Bericht (Artikel 02–06) | – (stellt nur in die Warteschlange ein) |
| Lizenzprüfung | alle 20 Minuten | Gleicht Registrierung und Lizenzen mit dem K-SOFT-Lizenzserver ab (Artikel 112) | HTTPS → api-fmweb-prod.cloudkasten.net |
| KFZ-Info-Berechnung | Standard: stündlich | Berechnet Fahrzeug-Kennzahlen (Verbrauch, Kosten, Antriebsart) für alle Mandanten (Artikel 14) | – |
| FleetSync | konfigurierbar (Minuten) | Übernimmt Führerscheinkontroll-Ergebnisse von fleet-id (Artikel 116) | HTTPS → fleet-id.de |
| YellowFox | konfigurierbar (Stunden) | Übernimmt Kilometerstände und Führerscheinprüfungen aus der YellowFox-Telematik (Artikel 117) | HTTPS → map.yellowfox.de |
| DKV-Postfach-Import | konfigurierbar | Holt DKV-Tankdaten aus einem IMAP-Postfach und stellt sie in den Tankkarten-Import ein (Artikel 09) | IMAP |
| UTA-FTP-Import | – | Vorgesehen für den automatischen UTA-Abruf per FTP; in dieser Version nicht aktiv | – |
| Konfigurations-Initialisierung | einmalig beim Start | Hasht ggf. noch ungehashte Kennwörter, schreibt die Server-URL in die Konfiguration, füllt leere E-Mail-Vorlagen | – |
| Datums-Bereinigung | stündlich | Ersetzt das Alt-Datumsformat „01.01.1753" (Platzhalter des klassischen Flottenmanagers) durch echte Leerwerte | – |
| Protokoll-Bereinigung | täglich | Löscht Einträge des Fachprotokolls nach der je Mandant eingestellten Aufbewahrungsdauer (Artikel 16) | – |
| Technik-Log-Bereinigung | stündlich | Löscht technische Aufgabenprotokolle (TaskLogs) nach Standard 30 Tagen (konfigurierbar) | – |
| Netzwerklizenz-Bereinigung | jede Minute | Gibt nicht mehr genutzte gleichzeitige Anmeldungen (Floating-Lizenzen) wieder frei | – |
Alle Aufgaben arbeiten mandantenübergreifend: Sie durchlaufen nacheinander alle aktiven Mandanten und öffnen dabei die jeweilige Mandanten-Datenbank. Aufgaben, deren Funktion eine Lizenz voraussetzt (FleetSync, YellowFox, DKV), prüfen die Lizenz und legen sich ohne Lizenz schlafen.
Verhalten bei Fehlern und Überwachung
- Ein Fehler in einer Aufgabe beendet niemals die Anwendung. Die betroffene Aufgabe protokolliert den Fehler und versucht es im nächsten Intervall erneut; im Ausnahmefall bleibt eine einzelne Aufgabe bis zum nächsten Neustart des Prozesses stehen.
- Jede Aufgabe schreibt ihre Läufe und Fehler in das technische Aufgabenprotokoll, einsehbar im Hintergrundaufgaben-Dashboard (Artikel 15) und im System-Monitoring (Artikel 16).
- Ein Neustart des geplanten Tasks startet alle Aufgaben neu – das ist die einfachste Abhilfe, wenn eine einzelne Automatik nicht mehr arbeitet.
- Der Health-Check
http://<server>:9998/healthprüft die Erreichbarkeit der Anwendung (Artikel 143).
Die E-Mail-Warteschlange als zentrales Muster
FMWeb versendet E-Mails nie direkt aus der Oberfläche. Alle Absender – Erinnerungen, WebRes-Bestätigungen, Ad-hoc-Mails – stellen die Nachricht in eine Warteschlange in der Mandanten-Datenbank ein; der Mail-Task arbeitet diese Warteschlange ab und protokolliert Erfolg oder Fehler je Nachricht. Vorteile: Der SMTP-Server muss nicht dauerhaft erreichbar sein, fehlgeschlagene Mails werden automatisch erneut versucht, und in der Fehlerdiagnose ist jeder Versand nachvollziehbar (Artikel 07).
Betreiben Sie parallel den klassischen Flottenmanager mit dessen E-Mail-Versand, koordinieren sich beide über einen Sperrmechanismus in der Warteschlange, sodass keine E-Mail doppelt versendet wird.
Zusammenspiel mit dem klassischen Flottenmanager
Mehrere Aufgaben existieren gerade wegen des Parallelbetriebs mit der Windows-Anwendung: Die KFZ-Info-Berechnung übernimmt die Kennzahlen-Aktualisierung, die früher der Desktop-Client erledigte; die Datums-Bereinigung räumt dessen Alt-Datumsplatzhalter auf. Details zur gemeinsamen Datenhaltung: Artikel 142.
Häufige Fragen
Kann ich einzelne Aufgaben abschalten? Ja – die fachlichen Aufgaben (E-Mail, Importe, Integrationen, KFZ-Info) haben im Hintergrundaufgaben-Dashboard einen Aktiv-Schalter und konfigurierbare Intervalle (Artikel 15). Die Wartungsaufgaben (Bereinigungen, Lizenzprüfung) laufen immer.
Belasten die Aufgaben den Server? Die Aufgaben arbeiten sequenziell und in moderaten Intervallen. Rechenintensiv ist allenfalls die KFZ-Info-Berechnung bei sehr großen Beständen – ihr Intervall lässt sich anpassen.
Warum sehe ich keinen FMWeb-Windows-Dienst? FMWeb nutzt bewusst die Windows-Aufgabenplanung statt eines Dienstes. Der geplante Task \Cloudkasten\FMWeb übernimmt dieselbe Rolle (Autostart, Neustart bei Fehlern) – sichtbar in der Aufgabenplanung, nicht unter „Dienste".
Verwandte Artikel
