Migration von Version 2.x
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?
| Bereich | Version 2.x | Version 3.x |
|---|---|---|
| Konfiguration | appsettings.json (manuell bearbeiten) | Admin-Oberfläche unter http://localhost:5050 |
| Datenspeicherung | JSON-Datei | SQLite-Datenbank (settings.db) |
| Einrichtung | Datei manuell anlegen und bearbeiten | Einrichtungsassistent (über das Dashboard) |
| Datensicherung | Manuelles Kopieren der Datei | Integrierte Sicherungen in der settings.db (Bereich „Sicherungen“) |
| API-Schlüssel | Organisations- oder Standort-Schlüssel | Nur Standort-Schlüssel (seit 2.8.0) |
| Laufzeitumgebung | .NET 8/9 | .NET 10 |
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:
- Die Datenbank
settings.dbwird angelegt. - Die
appsettings.jsonwird automatisch auf bekannte Konfigurationsabschnitte geprüft. - Gefundene Einstellungen werden in die Datenbank importiert.
- Das Dashboard der Admin-Oberfläche öffnet sich unter
http://localhost:5050.
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).appsettings.json:TetraControlOptionsProgramOptionsConnectOptionsStatusOptionsSeverityOptionsSirenCalloutOptionsSirenStatusOptionsPatternOptions
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:
- Admin-Oberfläche öffnen und „Sicherungen“ aufrufen.
- Unter „appsettings.json importieren“ die bisherige
appsettings.jsonauswählen. - Bestätigen und „Datei importieren“ klicken.
- 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.
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.
