UNIFI-Controller installieren - Ubuntu: Unterschied zwischen den Versionen
Peter (Diskussion | Beiträge) (Die Seite wurde neu angelegt: „Ich möchte euch näher bringen, wie man einen UNIFI-Controller auf einem UBUNTU 2004 LTS installiert. Dies hat natürlich einen Grund. Niemand möchte gerne L…“) |
Peter (Diskussion | Beiträge) K |
||
| (33 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| + | [[Kategorie:Inhalt]] | ||
| + | [[Kategorie:Linux Server]] | ||
| + | __INHALTSVERZEICHNIS_ERZWINGEN__ | ||
| + | __INDEXIEREN__ | ||
Ich möchte euch näher bringen, wie man einen UNIFI-Controller auf einem UBUNTU 2004 LTS installiert. Dies hat natürlich einen Grund. Niemand möchte gerne Lizenzkosten haben, wenn man es auf einem Windows System installiert, kommt die Windows Lizenz hinzu, es spielt keine Rolle ob Windows 10 oder Windows Server. Dies sind extra kosten. Ein weiterer Grund ist, dass Ressourcen schonendes Verhalten von Linux, man benötigt nur 2 GHz CPU Leistung, 2-3 GB RAM und ich empfehle 50 GB Festplatten speicher, damit hat man wirklich ausreichend Ressource, sogar etwas über dimensioniert. Ebenso ist ein guter Grund, wenn man beim Linux ein Update fährt, zieht man gleich den UNIFI-Controller mit, sollte man dies nicht wollen, einfach in der Repository, die Zeile auskommentieren. | Ich möchte euch näher bringen, wie man einen UNIFI-Controller auf einem UBUNTU 2004 LTS installiert. Dies hat natürlich einen Grund. Niemand möchte gerne Lizenzkosten haben, wenn man es auf einem Windows System installiert, kommt die Windows Lizenz hinzu, es spielt keine Rolle ob Windows 10 oder Windows Server. Dies sind extra kosten. Ein weiterer Grund ist, dass Ressourcen schonendes Verhalten von Linux, man benötigt nur 2 GHz CPU Leistung, 2-3 GB RAM und ich empfehle 50 GB Festplatten speicher, damit hat man wirklich ausreichend Ressource, sogar etwas über dimensioniert. Ebenso ist ein guter Grund, wenn man beim Linux ein Update fährt, zieht man gleich den UNIFI-Controller mit, sollte man dies nicht wollen, einfach in der Repository, die Zeile auskommentieren. | ||
| − | == Installation == | + | ==='''<span style="color:#FF0000">Installation</span>'''=== |
| − | Wir werden nun die Basis installieren bzw. uns Pakete installieren die man später zum reibungslosen ablauf installieren. | + | ----Wir werden nun die Basis installieren bzw. uns Pakete installieren die man später zum reibungslosen ablauf installieren.<syntaxhighlight lang="console"> |
| + | sudo apt update | ||
| + | sudo apt install -y ca-certificates apt-transport-https | ||
| + | </syntaxhighlight>Wir benötigen nun die Repository, um an das benötigte Paket zu kommen.<syntaxhighlight lang="console"> | ||
| + | sudo wget -O /etc/apt/trusted.gpg.d/unifi-repo.gpg https://dl.ui.com/unifi/unifi-repo.gpg | ||
| + | echo ‘deb https://www.ui.com/downloads/unifi/debian stable ubiquiti’ | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list | ||
| + | </syntaxhighlight>Dies kann man kontrollieren unter:<syntaxhighlight lang="console"> | ||
| + | nano /etc/apt/sources.list.d/100-ubnt-unifi.list | ||
| + | </syntaxhighlight>[[Datei:UNIFI REPO.png|zentriert|gerahmt]] | ||
| + | Eine Datenbank, wird ebenso benötigt, wir nehmen ausschließlich, für den UNIFI-Controller eine mongoDB, darauf ist der Controller aufgebaut. Wir setzten wieder eine Repository für die Datenbank, damit wir die richtigen Pakete bekommen.<syntaxhighlight lang="console"> | ||
| + | wget -qO – https://www.mongodb.org/static/pgp/server-3.4.asc | sudo apt-key add – | ||
| + | echo “deb https://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.4 multiverse” | sudo tee /etc/apt/sources.list.d/mongodb-org-3.4.list | ||
| + | </syntaxhighlight>Wir sehen uns natürlich, zur Kontrolle ebenso den Eintrag an.<syntaxhighlight lang="console"> | ||
| + | nano /etc/apt/sources.list.d/mongodb-org-3.4.list | ||
| + | </syntaxhighlight>[[Datei:MONGO REPO.png|zentriert|gerahmt]]Um die Repository Liste zu aktualisieren und eines Reibungsloses installieren zu gewährleisten, müssen wir noch ein Update ziehen.<syntaxhighlight lang="console"> | ||
| + | sudo apt update | ||
| + | </syntaxhighlight>Jetzt werden wir den UNIFI-Controller Software installieren und das Paket OpenJDK 8 wird benötigt und auch installiert.<syntaxhighlight lang="console"> | ||
| + | sudo apt install -y openjdk-8-jre-headless unifi | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | ==='''<span style="color:#FF0000">Systemkonfiguration</span>'''=== | ||
| + | ----Wir werden nun erzwingen, damit die Datenbank und der UNIFI-Controller beim Neustart automatisch startet. | ||
| + | |||
| + | ===='''<span style="color:#4682B4">MongoDB (Datenbank)</span>'''==== | ||
| + | <syntaxhighlight lang="console"> | ||
| + | sudo systemctl enable mongodb | ||
| + | sudo systemctl restart mongodb | ||
| + | sudo systemctl status mongodb | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | ===='''<span style="color:#4682B4">UNIFI-Controller</span>'''==== | ||
| + | <syntaxhighlight lang="console"> | ||
| + | sudo systemctl enable unifi | ||
| + | sudo systemctl restart unifi | ||
| + | sudo systemctl status unifi | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | ==='''<span style="color:#FF0000">System</span>'''=== | ||
| + | ---- | ||
| + | |||
| + | ===='''<span style="color:#4682B4">MongoDB (Datenbank)</span>'''==== | ||
| + | <syntaxhighlight lang="console"> | ||
| + | sudo systemctl enable mongodb | ||
| + | sudo systemctl start mongodb | ||
| + | sudo systemctl stop mongodb | ||
| + | sudo systemctl status mongodb | ||
| + | sudo systemctl restart mongodb | ||
| + | sudo systemctl disable mongodb | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | ===='''<span style="color:#4682B4">UNIFI-Controller</span>'''==== | ||
| + | <syntaxhighlight lang="console"> | ||
| + | sudo systemctl enable unifi | ||
| + | sudo systemctl start unifi | ||
| + | sudo systemctl stop unifi | ||
| + | sudo systemctl status unifi | ||
| + | sudo systemctl restart unifi | ||
| + | sudo systemctl disable unifi | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | ==='''<span style="color:#FF0000">Firewall</span>'''=== | ||
| + | ----Sollte jemand eine aktive Firewall haben, wird er diese Freischaltungen benötigen, auch Windows Installationen werden diese benötigen. Damit der UNIFI-Controller einwandfrei funktioniert. | ||
| + | {| class=" wikitable sortable" style="width: 100%;" | ||
| + | |+ | ||
| + | Erforderliche Firewall Regeln auf dem Linux Server | ||
| + | !'''Ports''' | ||
| + | !'''Protokoll''' | ||
| + | !'''Erklärung''' | ||
| + | |- | ||
| + | |style="text-align:center;"|3478 | ||
| + | |style="text-align:center;"|UDP | ||
| + | |STUN | ||
| + | |- | ||
| + | |style="text-align:center;"|5514 | ||
| + | |style="text-align:center;"|UDP | ||
| + | |Remote-Syslog-Erfassung. | ||
| + | |- | ||
| + | |style="text-align:center;"|8080 | ||
| + | |style="text-align:center;"|TCP | ||
| + | |Geräte- und Controller-Kommunikation. | ||
| + | |- | ||
| + | |style="text-align:center;"|8443 | ||
| + | |style="text-align:center;"|TCP | ||
| + | |Controller-GUI / API in einem Webbrowser | ||
| + | |- | ||
| + | |style="text-align:center;"|8880 | ||
| + | |style="text-align:center;"|TCP | ||
| + | |HTTP-Portalumleitung (Captiv Portal) | ||
| + | |- | ||
| + | |style="text-align:center;"|8843 | ||
| + | |style="text-align:center;"|TCP | ||
| + | |HTTPS-Portalumleitung (Captiv Portal) | ||
| + | |- | ||
| + | |style="text-align:center;"|6789 | ||
| + | |style="text-align:center;"|TCP | ||
| + | |UNIFI Mobile Speed Test | ||
| + | |- | ||
| + | |style="text-align:center;"|27117 | ||
| + | |style="text-align:center;"|TCP | ||
| + | |Lokal gebundene Datenbankkommunikation | ||
| + | |- | ||
| + | |style="text-align:center;"|5656-5699 | ||
| + | |style="text-align:center;"|UDP | ||
| + | |AP-EDU broadcasting | ||
| + | |- | ||
| + | |style="text-align:center;"|10001 | ||
| + | |style="text-align:center;"|UDP | ||
| + | |Geräteerkennung | ||
| + | |- | ||
| + | |style="text-align:center;"|1900 | ||
| + | |style="text-align:center;"|UDP | ||
| + | |“Controller im L2-Netzwerk erkennbar machen” in den Controller-Einstellungen. | ||
| + | |} | ||
| + | |||
| + | ==='''<span style="color:#FF0000">Konfiguration</span>'''=== | ||
| + | ----Die erste Anmeldung, benötigt man keinen Benutzernamen und Kennwort, dies wird beim Wizard später festgelegt. Die Adresse lautetet: | ||
| + | <nowiki>https://yout_server_IP:8443/</nowiki> | ||
Aktuelle Version vom 6. November 2020, 07:53 Uhr
Ich möchte euch näher bringen, wie man einen UNIFI-Controller auf einem UBUNTU 2004 LTS installiert. Dies hat natürlich einen Grund. Niemand möchte gerne Lizenzkosten haben, wenn man es auf einem Windows System installiert, kommt die Windows Lizenz hinzu, es spielt keine Rolle ob Windows 10 oder Windows Server. Dies sind extra kosten. Ein weiterer Grund ist, dass Ressourcen schonendes Verhalten von Linux, man benötigt nur 2 GHz CPU Leistung, 2-3 GB RAM und ich empfehle 50 GB Festplatten speicher, damit hat man wirklich ausreichend Ressource, sogar etwas über dimensioniert. Ebenso ist ein guter Grund, wenn man beim Linux ein Update fährt, zieht man gleich den UNIFI-Controller mit, sollte man dies nicht wollen, einfach in der Repository, die Zeile auskommentieren.
Installation[Bearbeiten | Quelltext bearbeiten]
Wir werden nun die Basis installieren bzw. uns Pakete installieren die man später zum reibungslosen ablauf installieren.
sudo apt update
sudo apt install -y ca-certificates apt-transport-https
Wir benötigen nun die Repository, um an das benötigte Paket zu kommen.
sudo wget -O /etc/apt/trusted.gpg.d/unifi-repo.gpg https://dl.ui.com/unifi/unifi-repo.gpg
echo ‘deb https://www.ui.com/downloads/unifi/debian stable ubiquiti’ | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list
Dies kann man kontrollieren unter:
nano /etc/apt/sources.list.d/100-ubnt-unifi.list
Eine Datenbank, wird ebenso benötigt, wir nehmen ausschließlich, für den UNIFI-Controller eine mongoDB, darauf ist der Controller aufgebaut. Wir setzten wieder eine Repository für die Datenbank, damit wir die richtigen Pakete bekommen.
wget -qO – https://www.mongodb.org/static/pgp/server-3.4.asc | sudo apt-key add –
echo “deb https://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.4 multiverse” | sudo tee /etc/apt/sources.list.d/mongodb-org-3.4.list
Wir sehen uns natürlich, zur Kontrolle ebenso den Eintrag an.
nano /etc/apt/sources.list.d/mongodb-org-3.4.list
Um die Repository Liste zu aktualisieren und eines Reibungsloses installieren zu gewährleisten, müssen wir noch ein Update ziehen.
sudo apt update
Jetzt werden wir den UNIFI-Controller Software installieren und das Paket OpenJDK 8 wird benötigt und auch installiert.
sudo apt install -y openjdk-8-jre-headless unifi
Systemkonfiguration[Bearbeiten | Quelltext bearbeiten]
Wir werden nun erzwingen, damit die Datenbank und der UNIFI-Controller beim Neustart automatisch startet.
MongoDB (Datenbank)[Bearbeiten | Quelltext bearbeiten]
sudo systemctl enable mongodb
sudo systemctl restart mongodb
sudo systemctl status mongodb
UNIFI-Controller[Bearbeiten | Quelltext bearbeiten]
sudo systemctl enable unifi
sudo systemctl restart unifi
sudo systemctl status unifi
System[Bearbeiten | Quelltext bearbeiten]
MongoDB (Datenbank)[Bearbeiten | Quelltext bearbeiten]
sudo systemctl enable mongodb
sudo systemctl start mongodb
sudo systemctl stop mongodb
sudo systemctl status mongodb
sudo systemctl restart mongodb
sudo systemctl disable mongodb
UNIFI-Controller[Bearbeiten | Quelltext bearbeiten]
sudo systemctl enable unifi
sudo systemctl start unifi
sudo systemctl stop unifi
sudo systemctl status unifi
sudo systemctl restart unifi
sudo systemctl disable unifi
Firewall[Bearbeiten | Quelltext bearbeiten]
Sollte jemand eine aktive Firewall haben, wird er diese Freischaltungen benötigen, auch Windows Installationen werden diese benötigen. Damit der UNIFI-Controller einwandfrei funktioniert.
| Ports | Protokoll | Erklärung |
|---|---|---|
| 3478 | UDP | STUN |
| 5514 | UDP | Remote-Syslog-Erfassung. |
| 8080 | TCP | Geräte- und Controller-Kommunikation. |
| 8443 | TCP | Controller-GUI / API in einem Webbrowser |
| 8880 | TCP | HTTP-Portalumleitung (Captiv Portal) |
| 8843 | TCP | HTTPS-Portalumleitung (Captiv Portal) |
| 6789 | TCP | UNIFI Mobile Speed Test |
| 27117 | TCP | Lokal gebundene Datenbankkommunikation |
| 5656-5699 | UDP | AP-EDU broadcasting |
| 10001 | UDP | Geräteerkennung |
| 1900 | UDP | “Controller im L2-Netzwerk erkennbar machen” in den Controller-Einstellungen. |
Konfiguration[Bearbeiten | Quelltext bearbeiten]
Die erste Anmeldung, benötigt man keinen Benutzernamen und Kennwort, dies wird beim Wizard später festgelegt. Die Adresse lautetet:
https://yout_server_IP:8443/

