Direkte Installation¶

Von Ubiquiti Networks werden DEB-Pakete ⮷ angeboten.

Syntaxfehler: Bedingungen erlauben nur einen Ausdruck pro Block.

Installation über die Fremdquelle¶

Um die Fremdquelle zu authentifizieren, muss man den Signierungsschlüssel mit folgendem Befehl importieren:

sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 06E85760C0A52C50  

Dann die Fremdquelle hinzufügen:

sudo add-apt-repository 'deb http://www.ubnt.com/downloads/unifi/debian stable ubiquiti' 

Anschließend noch die Paketlisten neu einlesen:

apt-get update 

und schließlich die Installation starten:

• unifi (Fremdquelle)

Befehl zum Installieren der Pakete:

sudo apt-get install unifi 

Oder mit apturl installieren, Link: apt://unifi

Zugewiesener Speicherplatz¶

Der Unifi Controller nutzt eine Mongo-Datenbank. Für den Controller und für die MongoDB werden dabei für Log-Dateien über 6 GB Speicherplatz reserviert. Wenn auf dem Installationsmedium nicht so viel Platz zur Verfügung steht (oder nicht so viel Platz zur Verfügung gestellt werden soll), bestehen zwei Möglichkeiten: entweder lagert man die entsprechenden Log-Dateien aus, oder man weist das System an, mit kleineren Log-Dateien zu arbeiten. Für die erste Variante muss in verlinkbarer Umgebung genügend Speicherplatz vorhanden sein; die zweite empfiehlt sich nur, wenn vom System sonst keine MongoDBs genutzt werden.

# Verschieben der Log-Dateien
sudo mv -R /var/lib/unifi/db/journal /Ort/mit/Platz/unifi_journal
sudo mv -R /var/lib/mongodb/journal /Ort/mit/Platz/mongodb_journal

# Verlinken der Log-Dateien
sudo ln -s /Ort/mit/Platz/unifi_journal /var/lib/unifi/db/journal
sudo ln -s /Ort/mit/Platz/mongodb_journal /var/lib/mongodb/journal 

1

ENABLE_MONGODB="yes"

1

ENABLE_MONGODB="no"

1

unifi.db.extraargs=--smallfiles

1

unifi.db.nojournal=true

Bedienung¶

Der UniFi Controller wird nach der Installation automatisch als systemd Service Unit gestartet. Der UniFi Controller ist über einen beliebigen graphischen Webbrowser unter einer der beiden folgenden Adressen anzusprechen:

• http://<hostname>:8080

• https://<hostname>:8443

Bei einer lokalen Installation kann <hostname> durch localhost oder 127.0.0.1 ersetzt werden; ansonsten ist die Server-IP einzutragen.

Beim ersten Aufruf wird der Nutzer aufgefordert, ein Admin-Konto anzulegen, über das die Steuerung der Netzwerkkomponenten von nun an von einem beliebigen Rechner aus unternommen werden kann (sofern der Host in Reichweite ist).

Die weiteren Möglichkeiten des Controllers (Statistiken zu einzelnen Netzwerkkomponenten und zu verbundenen Clients, Hauspläne mit der Reichweite einzelner Access-Points, etc.) unterscheiden sich unter Ubuntu nicht von anderen Betriebssystemen. Die Bedienung ist selbstklärend.

Änderung der Standard-Ports¶

Standardmäßig arbeitet UniFI mit folgenden Ports:

Sämtliche Ports lassen sich in der Datei /usr/lib/unifi/data/system.properties umdefinieren, beim Bearbeiten sind Root-Rechte notwendig^[5]. Dazu ist bei den entsprechenden Zeilen auch das Kommentarzeichen zu entfernen.

Temporäre Nutzung¶

Standardmäßig läuft der UniFi Server als ständiger Dienst auf dem System, auf das er installiert wurde. Wird der UniFi-Controller nur benötigt, um einen einzelnen Access-Point einzurichten oder ein kleines Netzwerk, das nicht ständig überwacht werden muss, so ist es sinnvoll, den Dienst auszuschalten. Man kann dazu folgenden Befehl verwenden:

sudo systemctl disable unifi 

Der Dienst wird nun nicht mehr beim Systemstart geladen, kann aber weiterhin manuell gestartet werden.

Passwort Reset funktioniert nicht¶

Wer sein Admin-Passwort verlegt hat, muss entweder den Controller neu installieren, wenn die Passwort-Rücksetzung nicht funktioniert, oder folgendes Brecheisen verwenden:

Zuerst ist sicherzustellen, dass die MongoDB läuft:

sudo service mongodb restart 

Dann ist über folgenden Befehl herauszufinden, unter welchem Benutzernamen man sein Konto hinterlegt hat:

mongo --port 27117 ace --eval "db.admin.find().forEach(printjson);" 

Das führt zu folgender Ausgabe (wobei die Option name den gesuchten Benutzernamen ausgibt):

MongoDB shell version v3.6.3
connecting to: mongodb://127.0.0.1:27117/ace
MongoDB server version: 3.6.3
{
	"_id" : ObjectId("0123456789abcdef01234567"),
	"name" : "NAME",
	"email" : "EMAIL",
	"x_shadow" : "IRGENDEIN-UNLESERLICHER-HASH",
	"time_created" : NumberLong(0123456789),
	"last_site_name" : "default",
}

Nun ist ein neues Passwort zu erstellen (der Befehl mkpasswd findet sich im Paket whois ^[1] ):

mkpasswd -m sha-512 

Der Passwort-Hash, den man erhält, ist nun über folgenden Befehl in die MongoDB einzutragen (sowohl "NAME" als auch "PASSWORT-HASH" sind durch die eigenen Angaben zu ersetzen):

mongo --port 27117 ace --eval 'db.admin.update( { "name" : "NAME" }, { $set : { "x_shadow" : "PASSWORT-HASH" } } )' 

Danach kann man sich unter dem Benutzernamen mit dem neu erstellten Passwort normal anmelden.