FeuerSoftware
TetraControl2Connect

Migration von Version 2.x

Upgrade von TetraControl2Connect 2.x auf 3.x – Umstieg von appsettings.json auf die Admin-Oberfläche mit SQLite-Datenbank

Version 3.0 bringt eine neue webbasierte Admin-Oberfläche und speichert alle Einstellungen in einer SQLite-Datenbank statt in der appsettings.json. Der Umstieg ist jedoch einfach: Beim ersten Start von Version 3.x wird die vorhandene appsettings.json automatisch erkannt und importiert.

Was hat sich geändert?

BereichVersion 2.xVersion 3.x
Konfigurationappsettings.json (manuell bearbeiten)Admin-Oberfläche unter http://localhost:5050
DatenspeicherungJSON-DateiSQLite-Datenbank (settings.db)
EinrichtungDatei manuell anlegen und bearbeitenEinrichtungsassistent (über das Dashboard)
DatensicherungManuelles Kopieren der DateiIntegrierte Sicherungen in der settings.db (Bereich „Sicherungen“)
API-SchlüsselOrganisations- oder Standort-SchlüsselNur Standort-Schlüssel (seit 2.8.0)
Laufzeitumgebung.NET 8/9.NET 10
Wichtige Änderung bei API-Schlüsseln (bereits seit Version 2.8.0)Seit Version 2.8.0 sind in der Konfiguration ausschließlich Standort-API-Schlüssel zulässig. Organisationsschlüssel werden beim Start abgelehnt. Stellen Sie sicher, dass in Ihrer bestehenden Konfiguration nur Standort-Schlüssel verwendet werden, bevor Sie das Upgrade durchführen.

Migrationsschritte

1. Vorhandene Konfiguration sichern

Erstellen Sie vor dem Upgrade eine Sicherungskopie Ihrer bestehenden appsettings.json:

appsettings.json → appsettings.json.bak

2. .NET 10.0 Runtime installieren

Version 3.x benötigt die .NET 10.0 Runtime. Laden Sie diese von dot.net/download herunter und installieren Sie sie.

3. Neue Version entpacken

Entpacken Sie das Archiv der neuen Version in dasselbe Verzeichnis wie die bisherige Installation. Stellen Sie sicher, dass Ihre bestehende appsettings.json im Verzeichnis verbleibt.

4. Anwendung starten

Starten Sie die Anwendung. Beim ersten Start:

  1. Die Datenbank settings.db wird angelegt.
  2. Die appsettings.json wird automatisch auf bekannte Konfigurationsabschnitte geprüft.
  3. Gefundene Einstellungen werden in die Datenbank importiert.
  4. Das Dashboard der Admin-Oberfläche öffnet sich unter http://localhost:5050.
Der automatische Import erfolgt nur, wenn die Datenbank noch keine Einstellungen enthält. Zur Erkennung muss die appsettings.json mindestens einen der Abschnitte ProgramOptions, TetraControlOptions oder ConnectOptions enthalten. Wurde Version 3.x bereits einmal ohne die alte Datei gestartet, hilft ein späteres Hineinkopieren nicht mehr – nutzen Sie dann den manuellen Import (Schritt 6).
Der automatische Import erkennt die folgenden Abschnitte in der appsettings.json:
  • TetraControlOptions
  • ProgramOptions
  • ConnectOptions
  • StatusOptions
  • SeverityOptions
  • SirenCalloutOptions
  • SirenStatusOptions
  • PatternOptions

5. Konfiguration in der Admin-Oberfläche prüfen

Öffnen Sie http://localhost:5050 und prüfen Sie alle Einstellungsbereiche, um sicherzustellen, dass der Import vollständig und korrekt war.

6. Manueller Import (falls erforderlich)

Sollte der automatische Import nicht stattgefunden haben oder die Konfiguration nachträglich erneut importiert werden müssen:

  1. Admin-Oberfläche öffnen und „Sicherungen“ aufrufen.
  2. Unter „appsettings.json importieren“ die bisherige appsettings.json auswählen.
  3. Bestätigen und „Datei importieren“ klicken.
  4. TetraControl2Connect neu starten, damit alle Dienste die importierten Einstellungen verwenden.

In der Datei enthaltene Einstellungsbereiche werden vollständig ersetzt, nicht enthaltene Bereiche bleiben erhalten. Vor dem Import wird automatisch eine Sicherung angelegt.

Alternativ ist der Import über die REST-API möglich (POST http://localhost:5050/api/settings/import). Dabei kann die JSON-Datei als Request-Body übergeben werden. Ohne Body wird die appsettings.json aus dem Arbeitsverzeichnis verwendet. Auch hier ist anschließend ein Neustart erforderlich.

Referenz: appsettings.json Konfigurationsabschnitte

Falls Sie die appsettings.json aus der alten Version noch benötigen oder einen manuellen Import vornehmen möchten, finden Sie hier den Aufbau der wichtigsten Abschnitte. Die Beispielwerte für Status, Schweregrade und Sirenencodes entsprechen den Hessen-Standardwerten, die auch bei einer Neuinstallation gesetzt werden.

Beim Import werden Schlüssel, die in der Datei fehlen, nicht mit den Standardwerten, sondern mit leeren Werten bzw. false/0 übernommen. Prüfen Sie nach dem Import daher alle Einstellungsbereiche.

TetraControlOptions

"TetraControlOptions": {
  "TetraControlHost": "localhost",
  "TetraControlPort": 8085,
  "TetraControlUsername": "BenutzerName",
  "TetraControlPassword": "Passwort"
}

ProgramOptions

"ProgramOptions": {
  "SendVehicleStatus": true,
  "SendVehiclePositions": true,
  "SendUserOperationStatus": true,
  "SendUserAvailability": true,
  "SendAlarms": true,
  "UpdateExistingOperations": true,
  "WebSocketReconnectTimeoutMinutes": 5,
  "IgnoreStatus0": false,
  "IgnoreStatus5": false,
  "IgnoreStatus9": false,
  "AcceptCalloutsForSirens": false,
  "AcceptSDSAsCalloutsWithPattern": false,
  "UserAvailabilityLifetimeDays": 7,
  "PollForActiveOperationBeforeFallbackMaxRetryCount": 4,
  "PollForActiveOperationBeforeFallbackDelay": "00:00:10",
  "AddPropertyForAlarmTexts": false,
  "UseFullyQualifiedSubnetAddressForConnect": false,
  "IgnoreAlarmWithoutSubnetAddresses": false,
  "HeartbeatEndpointUrl": "",
  "HeartbeatInterval": "00:10:00"
}

ConnectOptions

"ConnectOptions": {
  "Sites": [
    {
      "Name": "Mein Standort",
      "Key": "<<STANDORT-API-SCHLÜSSEL>>",
      "Sirens": [
        { "Issi": "1234567", "Name": "Sirene 1" }
      ],
      "SubnetAddresses": [
        { "Name": "Schleife 1", "GSSI": "12345678", "SNA": "&01", "AlarmDirectly": false }
      ]
    }
  ]
}

StatusOptions

"StatusOptions": {
  "AvailableStatus": "15",
  "LimitedAvailableStatus": "-1",
  "NotAvailableStatus": "0",
  "ComingStatus": "32768;57345",
  "NotComingStatus": "32769;57344",
  "ComingLaterStatus": "-1"
}

SeverityOptions

"SeverityOptions": {
  "UseServerityTranslationAsKeyword": true,
  "SeverityTranslations": {
    "1": "Information",
    "2": "Einsatzabbruch",
    "3": "Bereitschaft",
    "4": "Krankentransport",
    "5": "Rettungsdienst R-0",
    "7": "Hilfeleistung normal",
    "8": "Feuer normal",
    "9": "Rettungsdienst R-1",
    "10": "Rettungsdienst R-2",
    "11": "Hilfeleistung dringend",
    "12": "Feuer dringend",
    "13": "Großalarm",
    "15": "KatS-Alarm"
  }
}

SirenCalloutOptions

"SirenCalloutOptions": {
  "UseSirenCodeTranslationAsKeyword": false,
  "SirenCodeTranslations": {
    "$2000": "Warnung der Bevölkerung",
    "$2001": "Entwarnung",
    "$2002": "Feueralarm",
    "$2003": "Probealarm"
  }
}

PatternOptions

"PatternOptions": {
  "NumberPattern": "",
  "KeywordPattern": "Stichwort:([^;]*)",
  "FactsPattern": "",
  "CityPattern": "Ort:([^;]*)",
  "StreetPattern": "Straße:([^;]*)",
  "HouseNumberPattern": "",
  "ZipCodePattern": "",
  "DistrictPattern": "",
  "RicPattern": "Schleife:([^;]*)",
  "ReporterNamePattern": "",
  "ReporterPhoneNumberPattern": "",
  "LatitudePattern": "",
  "LongitudePattern": "",
  "AdditionalProperties": []
}

Häufige Fragen

Muss ich die appsettings.json nach dem Upgrade löschen?

Nein. Die Datei wird nach dem Import nicht gelöscht und schadet dem Betrieb nicht. Sie kann aber nach erfolgreicher Migration entfernt werden.

Was passiert, wenn ich die Version 3.x ohne eine bestehende appsettings.json installiere?

Die Anwendung startet mit den Standardwerten (Hessen-Standards für Status, Schweregrade und Sirenencodes). Auf dem Dashboard erscheint die Karte „Ersteinrichtung erforderlich“; über „Einrichtung starten“ führt der Einrichtungsassistent durch die Erstkonfiguration. Fehler-Übersetzungen für die Sirenenüberwachung sind bei einer Neuinstallation nicht hinterlegt.

Kann ich die Einstellungen zwischen Installationen übertragen?

Ja, indem Sie die Datei settings.db auf die andere Installation kopieren. Die integrierten Sicherungen liegen in der settings.db selbst und können nicht als separate Datei exportiert werden. Alternativ kann auf der neuen Installation eine appsettings.json über „Sicherungen → appsettings.json importieren“ eingelesen werden.

Kann ich die Konfiguration weiterhin als JSON-Datei exportieren?

Die aktuelle Version unterstützt keinen direkten JSON-Export der Einstellungen. Alle Einstellungen sind jedoch über die REST-API unter http://localhost:5050/api/settings abrufbar und können von dort extrahiert werden.

Copyright © 2026