S
sondinetworkTech Innovation Hub
Zurück zu allen Artikeln
Unifi

UniFi Geräte via MongoDB manuell entfernen und neu einbinden

admin
2 min Lesezeit
UniFi Geräte via MongoDB manuell entfernen und neu einbinden

Einleitung

In seltenen Fällen kann es vorkommen, dass sich ein UniFi-Gerät (Access Point, Switch oder Gateway) im Controller «aufhängt». Es wird als «Disconnected» oder «Adopting» angezeigt, lässt sich aber über die grafische Benutzeroberfläche nicht entfernen. Wenn der reguläre «Forget»-Button versagt, muss der Eintrag direkt aus der Datenbank gelöscht werden.

Dieses Tutorial zeigt den Weg über die Kommandozeile und die MongoDB, um solche «Geister-Geräte» sauber zu entfernen.

Voraussetzungen:

  • SSH-Zugriff auf den UniFi-Controller (Cloud Key, UDM oder Server)
  • Root- oder Sudo-Rechte
  • Die MAC-Adresse des betroffenen Geräts

[BILD 1: UniFi Controller Dashboard mit einem ausgegrauten, nicht verbundenen Gerät]

Überblick

Durch den direkten Eingriff in die Datenbank erreichen wir folgendes:

  • Vollständige Entfernung der Geräteleiche aus der Datenbank
  • Bereinigung von Konflikten bei der Neu-Adoption
  • Möglichkeit zur sauberen Neueinbindung

Schritt-für-Schritt Anleitung

  1. Verbindung herstellen
    Loggen Sie sich per SSH auf Ihrem Controller ein. Ersetzen Sie die IP-Adresse und den Benutzernamen entsprechend Ihrer Konfiguration. 
    ssh richard@192.168.2.4
sudo -i
  2. Datenbank öffnen
    UniFi nutzt MongoDB. Wir verbinden uns lokal auf dem Standard-Port 27117 und wählen die Datenbank ace aus, welche die Konfigurationen enthält. 
    mongo --port 27117
use ace
  3. Gerät identifizieren und löschen
    Ersetzen Sie xx:xx:xx:xx:xx:xx durch die tatsächliche MAC-Adresse des Geräts. Der erste Befehl dient zur Verifizierung, ob das Gerät gefunden wird. Der zweite Befehl entfernt es endgültig.

    Aktion:
    Suchen und Entfernen

    # Prüfen, ob Eintrag existiert
db.device.find({"mac":"xx:xx:xx:xx:xx:xx"})

# Eintrag löschen
db.device.remove({"mac":"xx:xx:xx:xx:xx:xx"})

    [BILD 2: Terminal-Fenster mit MongoDB-Shell und erfolgreicher Löschbestätigung]

  4. Sitzung beenden
    Verlassen Sie die Datenbank-Shell und die SSH-Verbindung. 
    exit
exit
  5. Controller neu starten
    Damit die Änderungen wirksam werden und der Cache bereinigt wird, ist ein Neustart des Systems erforderlich. 
    reboot

Wichtige Hinweise & Stolperfallen

MAC-Adresse: Achten Sie penibel auf die korrekte Schreibweise der MAC-Adresse (Kleinschreibung, Doppelpunkte). Ein Tippfehler führt dazu, dass der Befehl ins Leere läuft.

Downtime: Der Befehl reboot startet das gesamte Host-System neu. Während dieser Zeit ist der Controller nicht erreichbar und das Gäste-Portal sowie die Statistik-Erfassung fallen aus. Das eigentliche Routing/Switching läuft jedoch weiter.

Ergebnis & Fazit

Nach dem Neustart taucht das physikalisch vorhandene Gerät wieder als «Pending Adoption» (Zur Adoption bereit) in der Übersicht auf. Sie können es nun sauber neu einbinden, als wäre es ein werksneues Gerät. Diese Methode ist der zuverlässigste Weg, um Datenbank-Inkonsistenzen bei UniFi-Hardware zu beheben.

Ähnliche Artikel