⚠️ Fehler bei Datenbankmigration nach Config-Import oder Web-Update

🧩 Problem: „Migration der Datenbank“ bleibt hängen

Nach einem Firmware-Update über die Weboberfläche oder dem Import einer älteren Konfiguration erscheint der Hinweis:

„Migration der Datenbank“

Der Ladebalken verschwindet nicht, das Gateway bleibt dauerhaft in diesem Zustand. Ein regulärer Zugriff ist oft nicht mehr möglich.

🔍 Mögliche Ursachen

• Veraltete Konfigurationen (insbesondere aus Versionen vor 22.00)

• Strukturänderungen in der Datenbank durch neue Systembasis (z. B. Umstieg auf Debian 11+)

• Nicht migrierbare Alt-Daten, wie:

  • Historische Nachrichten

  • Veraltete Routing-Einträge

  • Inkonsistente Regeldefinitionen

Diese führen dazu, dass das Migrationsskript nicht korrekt abgeschlossen wird.

📉 Typische Fehlerbilder bei fehlerhafter Migration

• Gesendete oder empfangene Nachrichten werden nicht angezeigt

• Die Ansicht „Nachrichtenstatus“ bleibt leer

• Weboberfläche reagiert nicht mehr oder zeigt sporadisch Fehler

• Hohe CPU-Last, Dienste wie Apache/PHP hängen dauerhaft

👨‍🔧 Aktueller Stand

Ab Firmware-Version 23.02 ist das Problem weitgehend behoben. Die Migrationslogik wurde überarbeitet und toleranter gegenüber älteren Datenbeständen.

✅ Empfohlene Sofortmaßnahme (Workaround)

🔐 Sicherung vor Reset durchführen

1. Lizenzschlüssel exportieren

2. Adressbuch sichern (als CSV-Datei)

🧰 Werkseinstellungen wiederherstellen

• Mit Konsolenkabel (z. B. USB-zu-Seriell) und PuTTY / minicom auf das Gerät zugreifen

• Reset auf Werkseinstellungen über der Konsole

♻️ Nach dem Neustart:

• Lizenzschlüssel neu importieren

• Adressbuch neu importieren

• ❗ KEINE alte Konfiguration importieren!

Nur so wird sichergestellt, dass keine fehlerhaften Altdaten erneut eingespielt werden.

🔁 Alternative Lösungen (nur für erfahrene Anwender)

🔄 Neubespielung mit Recovery-Image

• Aktuelles Recovery-Image vom Hersteller verwenden

• Gateway vollständig neu aufsetzen

• Konfiguration manuell einrichten

📌 Empfehlungen für zukünftige Migrationen

🔄 Vorab prüfen und vorbereiten:

• Konfigurationen nur importieren, wenn Hauptversion identisch ist
  → wir informieren regelmäßig in unserem Newsletter über Versionssprünge in der Software, die solche Auswirkungen haben könnten.

• Bei größeren Versionssprüngen:

  • Konfiguration manuell über neue Weboberfläche erstellen

  • Kein direkter Import alter Backups

• Vor jedem Import:

  • Lizenzschlüssel separat sichern

  • Adressbuch separat exportieren

💡 Zusatztipp für Admins

Ein automatisiertes Backup-Skript kann helfen, Konfigurationen regelmäßig zu sichern – inklusive Lizenz, Adressbuch. So lässt sich im Ernstfall schnell und gezielt wiederherstellen, ohne auf veraltete Gesamtkonfigurationen angewiesen zu sein.