UniFi Controller: Manuelles Update & Log-Bereinigung via SSH

Einleitung

Die Weboberfläche des UniFi Controllers ist komfortabel, doch bei Updates oder Speicherplatzproblemen ist der Weg über das Terminal (SSH) oft zuverlässiger. Besonders wenn der Controller aufgrund voller Log-Dateien (MongoDB) nicht mehr startet, sind Kenntnisse der Kommandozeile unverzichtbar.

Dieses Tutorial zeigt, wie Sie den Controller sauber aktualisieren und wachsende Log-Dateien bändigen.

Voraussetzungen:

• SSH-Zugriff auf den Controller (Cloud Key, Raspberry Pi oder Server)
• Sudo/Root-Rechte
• Ein aktuelles Backup (heruntergeladen via GUI)

Teil 1: UniFi Controller aktualisieren

1. Verbindung herstellen
   Loggen Sie sich auf Ihrem Host ein. Passen Sie IP und User entsprechend an.
   
   ssh richard@192.168.1.20
2. Dienst stoppen
   Um Datenbankfehler während des Updates zu vermeiden, stoppen wir den laufenden Dienst.
   
   sudo service unifi stop
3. Update durchführen
   Wir aktualisieren die Paketquellen und installieren die neueste Version aus dem Repository.
   
   sudo apt update sudo apt install unifi -y
4. Dienst starten
   Nach der Installation starten wir den Controller wieder. Geben Sie ihm einige Minuten Zeit zum Booten.
   
   sudo service unifi start

Teil 2: Logs analysieren und leeren

Wenn der Controller träge wird oder der Speicherplatz schwindet, sind oft riesige Log-Dateien die Ursache.

1. Navigation zu den Logs
   Wechseln Sie zum Root-User und navigieren Sie in das Standard-Log-Verzeichnis.
   
   sudo -i cd /usr/lib/unifi/logs ls -lh
   (Der Befehl ls -lh zeigt Ihnen direkt die Dateigrößen an.)
2. Logs einsehen
   Nutzen Sie nano (oder tail -f für Echtzeit), um Fehler zu finden.
   • server.log: Allgemeine Controller-Ereignisse.
   • mongod.log: Datenbank-spezifische Meldungen.
   
   nano server.log # Beenden mit STRG+X
3. Logs leeren (Truncate)
   Anstatt die Datei zu löschen (was Probleme verursachen kann, wenn der Prozess noch darauf zugreift), «kürzen» wir sie auf 0 Bytes. Dies gibt sofort Speicherplatz frei.
   
   sudo truncate -s 0 server.log sudo truncate -s 0 mongod.log

Wichtige Hinweise & Stolperfallen

Backup ist Pflicht: Ein Update via SSH ist sicher, aber nicht unfehlbar. Sollte die MongoDB-Migration scheitern, ist ein Backup Ihre Lebensversicherung.

Automatisierung: Müssen Sie die Logs wöchentlich leeren? Dann stimmt etwas nicht. Prüfen Sie in den UniFi-Einstellungen unter «Maintenance», wie lange historische Daten (Data Retention) gespeichert werden, und reduzieren Sie diese Zeiträume.

Fazit

Mit diesen Befehlen halten Sie Ihr UniFi-System aktuell und schlank. Besonders der truncate-Befehl ist ein wertvoller Helfer für jeden Admin, der mit begrenztem Speicherplatz auf Cloud Keys oder Raspberry Pis kämpft.