Florian Feuerwehrmanagement
Angebot anfordern
Angebot anfordernZum Kunden-Portal

Fehlerbehebung

Die meisten Störungen im laufenden Betrieb lassen sich in wenigen Minuten selbst beheben. Diese Seite fasst die häufigsten Fälle zusammen und zeigt für jeden einen klaren Lösungsweg – von der Reihenfolge her: erst prüfen, dann gezielt eingreifen. Führen Sie die Schritte der Reihe nach aus und halten Sie erst inne, wenn das Problem behoben ist.

Dienst startet nicht

Startet Florian nach einem Neustart des Servers nicht von selbst oder lässt sich der Dienst nicht anstoßen, arbeiten Sie diese Punkte in dieser Reihenfolge ab.

  1. Dienststatus prüfen. Kontrollieren Sie zunächst, ob der Windows-Dienst überhaupt läuft:

    sc.exe query Florian

    Steht dort STOPPED, starten Sie ihn mit sc.exe start Florian (Administrator-PowerShell). Unter Linux entsprechend systemctl status florian bzw. systemctl start florian, unter macOS über launchctl.

  2. Datenverzeichnis erreichbar? Florian braucht Lese- und Schreibzugriff auf den Ordner data\ mit florian.db. Liegt das Verzeichnis auf einem Netz- oder Wechsellaufwerk, das noch nicht verbunden ist, startet der Dienst nicht sauber. Stellen Sie sicher, dass der Pfad lokal und dauerhaft verfügbar ist.

  3. Datenbank gesperrt. Läuft bereits eine zweite Florian-Instanz (z. B. eine von Hand per Doppelklick gestartete .exe zusätzlich zum Dienst), ist die SQLite-Datei gesperrt. Beenden Sie alle weiteren Instanzen und starten Sie ausschließlich den Dienst.

  4. Log lesen. Findet sich die Ursache nicht, sehen Sie in das Anwendungs-Log im Florian-Ordner. Es nennt den konkreten Fehler beim Hochfahren – häufig ein belegter Port (siehe unten) oder ein Zertifikatsproblem.

Hinweis: Starten Sie Florian im laufenden Betrieb nicht zusätzlich per Doppelklick, wenn der Dienst bereits registriert ist. Eine einzige aktive Instanz pro Datenverzeichnis ist Pflicht.

Port belegt

Florian öffnet seinen Web-Port über den eingebauten Kestrel-Server. Ist dieser Port bereits von einer anderen Anwendung belegt (z. B. IIS, ein anderer Webdienst oder eine zweite Florian-Instanz), fährt der Dienst nicht hoch.

  1. Ermitteln Sie, welcher Prozess den Port hält:

    netstat -ano | findstr :<Port>

    Die letzte Spalte nennt die Prozess-ID (PID); über den Task-Manager sehen Sie den zugehörigen Prozess.

  2. Geben Sie den Port frei, indem Sie die andere Anwendung beenden – oder weisen Sie Florian einen freien Port zu.

  3. Den Port ändern Sie unter Einstellungen → Datenverzeichnis & Port. Starten Sie den Dienst danach neu.

Achtung: Prüfen Sie vor der Portwahl, dass keine andere auf dem Server laufende Anwendung denselben Port erwartet. Ein bereits produktiv genutzter Port gehört nicht überschrieben.

TLS-Zertifikat

Warnungen oder Startfehler rund um HTTPS gehen fast immer auf das Zertifikat zurück. Florian kennt drei TLS-Betriebsarten, die Sie unter Einstellungen → TLS umstellen.

Symptom Ursache Lösung
Browser zeigt Zertifikatswarnung im LAN Selbstsigniertes Zertifikat (Default) Im LAN unkritisch – Ausnahme im Browser bestätigen oder das Zertifikat verteilen
Dienst startet nicht, Log meldet PFX-Fehler Falsches Passwort oder beschädigte PFX-Datei Eigene .pfx mit korrektem Passwort erneut hochladen
Let's Encrypt schlägt fehl Server nicht öffentlich erreichbar oder Port 80/443 blockiert Erreichbarkeit und Domain-Weiterleitung prüfen; alternativ auf selbstsigniert oder eigenes PFX wechseln

Hinweis: Die automatische Zertifikatsausstellung über Let's Encrypt setzt voraus, dass Ihr Server aus dem Internet erreichbar ist und die nötigen Ports offen sind. Für reinen LAN-Betrieb ist ein selbstsigniertes Zertifikat die richtige und dauerhaft nutzbare Wahl.

Zeichensatz-Probleme beim Import (Umlaute im ZIP)

Beim Datenimport aus einem Bestandssystem kommen die Altdaten häufig als ZIP-Archiv. Ältere ZIP-Werkzeuge speichern Dateinamen nicht in UTF-8, sondern in einer veralteten Codepage. Enthält ein Bundesland-Regelwerk oder ein Dateiname Umlaute – etwa Baden-Württemberg oder Thüringen –, erscheinen diese nach dem Entpacken verstümmelt (z. B. Württemberg statt Württemberg).

So vermeiden bzw. beheben Sie das:

  1. ZIP mit UTF-8 entpacken. Entpacken Sie das Archiv mit einem Werkzeug, das UTF-8-Dateinamen beherrscht (aktuelle Versionen von 7-Zip oder der Windows-Explorer), und übergeben Sie Florian anschließend den entpackten Ordner statt des ZIPs.
  2. Direkt die Daten importieren. Der Datenimport liest die eigentlichen Daten (H2-Export bzw. CSV) selbst in UTF-8 ein. Entscheidend ist nur, dass die Dateinamen beim Entpacken nicht schon zerstört wurden.
  3. Betroffene Einträge nachziehen. Sind einzelne Katalog-Einträge (Dienstgrade, Ehrungen, Lehrgänge) mit falschen Umlauten angekommen, korrigieren Sie sie nachträglich unter Einstellungen → Bundesland-Regelwerk – die Kataloge sind vollständig editierbar.

Hinweis: Das betrifft die Zeichencodierung der Dateinamen im Archiv, nicht Ihre Datenbank. Florian selbst speichert durchgehend in UTF-8; einmal korrekt importierte Umlaute bleiben korrekt.

Alt-Startdateien (leeres DOS-Fenster)

Nach dem Umstieg von Ihrem bisherigen System liegen im alten Programmordner oft noch Start-Skripte (.bat/.cmd) der Vorgänger-Software. Ein versehentlicher Doppelklick darauf öffnet ein leeres schwarzes Konsolenfenster („DOS-Fenster"), das nichts tut oder sofort wieder verschwindet – das ist kein Florian-Problem.

  • Florian startet ausschließlich über die Florian.exe bzw. – im Regelbetrieb – über den registrierten Dienst. Ein Konsolenfenster ist dafür nicht nötig.
  • Verweist eine Desktop-Verknüpfung noch auf ein altes Start-Skript des Vorgängersystems, löschen Sie die Verknüpfung und legen Sie bei Bedarf eine neue direkt auf die Florian.exe an.
  • Die alten Start-Skripte des Vorgängersystems können nach erfolgreichem Import und geprüftem Betrieb von Florian gefahrlos entfernt werden.

Achtung: Löschen Sie erst dann Reste der Alt-Installation, wenn der Import in Florian vollständig geprüft ist und Sie über eine gesicherte Kopie der Altdaten verfügen.

Scanner reagiert nicht

Florian nutzt für Inventur und Geräte-Suche einen einheitlichen Scan-Service. Reagiert das Einlesen nicht, hängt es an der jeweiligen Erfassungsart.

Zebra-Handscanner (DataWedge): Der Scanner arbeitet als Tastatur-Eingabe (Keystroke-Ausgabe von DataWedge).

  1. Der Cursor muss im aktiven Scan- bzw. Suchfeld stehen. Tippen Sie das Feld an, bevor Sie scannen.
  2. Prüfen Sie in DataWedge, dass das zugehörige Profil aktiv ist und die Keystroke-Ausgabe eingeschaltet ist.
  3. Testen Sie den Scanner gegen ein einfaches Textfeld – kommt dort nichts an, liegt die Ursache in DataWedge, nicht in Florian.

Handy-Kamera (BarcodeDetector): Florian liest Barcodes über die Kamera-Schnittstelle des Browsers.

  1. Erlauben Sie im Browser den Kamera-Zugriff für Florian. Ohne Freigabe bleibt das Kamerabild schwarz.
  2. Die Kamera-Barcode-Funktion setzt eine HTTPS-Verbindung voraus. Rufen Sie Florian über https:// auf, nicht über http://.
  3. Sorgen Sie für ausreichend Licht und einen ruhigen, formatfüllenden Ausschnitt des Codes.
  4. Nutzen Sie Florian als installierte PWA, damit der Kamera-Zugriff dauerhaft erhalten bleibt.

Hinweis: Der QR-/Barcode-Druck aus der Geräteverwaltung erzeugt Etiketten, die von beiden Erfassungsarten gelesen werden. Details im Modul Inventur & Barcode.

Update schlägt fehl – Rollback und Backup

Die aktuelle Updatefunktion lädt ein berechtigtes Paket herunter und prüft SHA-256 und RSA-PSS-Signatur. Die Installation erfolgt anschließend manuell; einen automatischen Rollback oder ein integriertes Vor-Migrationsbackup gibt es in diesem Ablauf nicht.

  1. Download- oder Prüfungsfehler einordnen. Bei fehlgeschlagenem Download oder ungültiger Prüfsumme beziehungsweise Signatur ersetzt die Updatefunktion die laufende Anwendung nicht. Prüfen Sie die angezeigte Fehlermeldung, die Verbindung zum konfigurierten Update-Server und die Lizenz-/Wartungsberechtigung, bevor Sie erneut herunterladen. Die Update-Seite bietet keinen Offline-Paketupload.
  2. Fehler nach manueller Installation. Startet die installierte Version nicht korrekt, warten Sie nicht auf einen automatischen Rollback. Klären Sie mit Betreiber oder Support den Ablauf für das tatsächlich verwendete Installationspaket. Ein automatisches Zurückschalten auf vorgehaltene Programmversionen wird hier nicht bereitgestellt.
  3. Vorhandene Sicherung prüfen. Wählen Sie bei notwendiger Datenwiederherstellung eine geeignete, zuvor separat erstellte Sicherung. Folgen Sie Backup und Wiederherstellung; nach der Wiederherstellung muss die Anwendung neu gestartet werden. Prüfen Sie anschließend Daten und benötigte Funktionen.

Achtung: Ein Wiederherstellen aus einem Backup überschreibt den aktuellen Datenbestand; Änderungen seit der Sicherung gehen verloren. Eine frühere Programmversion ist nicht automatisch mit einer geänderten Datenbank kompatibel. Stimmen Sie die Wiederherstellung deshalb vorab mit dem Betreiber ab.

Bleibt ein Update dauerhaft erfolglos, prüfen Sie die oben genannten technischen Ursachen und senden Sie dem Support die Fehlermeldung sowie Ihre Florian-Version. Die Bereitstellung von Updates ist Teil des vereinbarten Abos.

Siehe auch