TP-Link Installation Omada Controller Software

TP-Link Logo
TP-Link Logo

TP-Link bietet für die Wlan Serie Omada eine kostenlose Controller Software. Ich selber nutze die Modelle EAP110, EAP330 und EAP225 Outdoor. Damit ich diese einheitlich konfigurieren kann und auch Diese kann auf folgenden Betriebssystemen installiert werden:

  • Ubuntu 14.04/16.04/17.04/18.04,
  • CentOS 6.x/7.x
  • Fedora ab 20,
  • Debian 9.8. / 10

Informationen unter: https://www.tp-link.com/de/support/download/eap-controller
Omada Controller User Manual:

Folgende Accespoints werden unterstützt:

Compatible With All TP-Link EAP Models

ModelAuranet EAP330Auranet EAP320Omada EAP245Omada EAP225Auranet EAP115Auranet EAP110
Product NameAC1900 Wireless Dual Band
Gigabit Access Point
AC1200 Wireless Dual Band
Gigabit Access Point
AC1750 Wireless Dual Band
Gigabit Access Point
AC1350 Wireless MU-MIMO Gigabit Access Point300Mbps Wireless N
Access Point
300Mbps Wireless N
Access Point
Wireless Throughput2.4GHz : 600Mbps
5GHz : 1300Mbps
2.4GHz : 300Mbps
5GHz : 867Mbps
2.4GHz : 450Mbps
5GHz : 1300Mbps
2.4GHz : 450Mbps
5GHz : 867Mbps
2.4GHz:300Mbps2.4GHz:300Mbps
Ethernet PortGigabit Port*2Gigabit Port*1Gigabit Port*1Gigabit Port*110/100Mbps Port*110/100Mbps Port*1
Internal Antennas2.4GHz: 3*6dBi
5GHz: 3*7dBi
2.4GHz: 2*6dBi
5GHz: 2*7dBi
2.4GHz:3*4dBi
5GHz: 3*4dBi
2.4GHz:3*4dBi
5GHz: 2*5dBi
2.4GHz:2*3dBi2.4GHz:2*3dBi
PoE ModeIEEE 802.3atIEEE 802.3atIEEE 802.3atIEEE 802.3af and Passive PoEIEEE 802.3afPassive PoE
Captive Portal
Airtime Fairness
Beamforming
Band Steering
Load Balance

Die bis dato aktuelle Version ist 3.2.4 vom 08.11.2019. Nachfolgend werde ich die TP-Link Controller Software in einer virtuellen Maschine mit Debian Buster als Betriebssystem installieren und betreiben.

TP-Link Controller Release Notes 3.2.4

Windows

New Feature/Enhancement:

1. Add “Select Page” feature on the voucher management page.

2. Change the default status of “Terms of Service” on default portal page to uncheck.

3. Optimize the “Free Authentication Policy” to support URL with suffixes.

4. Change the default status of new added “Free Authentication Policy” to enable.

Bug Fixed:

1. Fixed the bug that when clients disconnect from the Facebook portal, the connection time and traffic usage of these clients may be zero in the log.

2. Fixed the bug that AP may disconnect from Omada Controller when it is upgrading the firmware.

3. Fixed the bug that in some cases, the channel configuration of 2.4G frequency may show up in 5G by mistake.

4. Fixed the bug that the configuration of SSID will not be issued correctly when changing the WLAN Group on the provisioning status.

Linux

New Feature/Enhancement:

1. Optimize the performance of Controller to manage up to 1500 EAPs.

2. Optimize the interactive process between EAP and Controller to decrease the processing time.

3. Limit the entry number of client/client history/guest to 1.2 million/1.2 million /6 million.

4. Optimize display page of map and log when there are a lot of entries.

Bug Fixed:

1. Fixed the bug that CPU and memory may be highly used when Fast Roaming is enabled.

2. Fixed the bug that Omada Controller reports timeout error when adopting multiple EAPs simultaneously.

3. Fixed the bug that Controller will print all Voucher codes even only some of the codes are selected.

TP-Link Installation Omada Controller Software

Voraussetzungen

Der Omada Controller kann bis zu 1500 EAPs managen. Voraussetzung es stehen genug Ressourcen bereit:

  • CPU: Intel Core i3-8100, i5-6500 oder i7-4700 mit 2 oder mehr Cores und 4 oder mehr Threads
  • RAM 6 GB RAM oder mehr
  • OS siehe oben
  • Web Browser: Mozilla Firefox ab Version 32
  • Google Chrome ab Version 37
  • Opera ab Version 24
  • Microsoft Internet Explorer 11 oder neuer

Ich habe testweise eine VM mit KVM und 8GB HDD, sowie 1GB RAM unter Debian 10 Buster erstellt. Wie sich diese Konfiguration schlägt werde ich sehen und ggf. anpassen.

Vorbereitung

  1. alle Accesspoints müssen auf die letzte unterstütze Firmware aktualisiert werden
  2. es wird das Tool netstat benötigt
  3. es wird JRE 1.8 Java benötigt
  4. Installation MongoDB siehe: Debian 11 MongoDB installieren
  5. ein Downgrade ist nach dem Upgrade nicht mehr möglich
  6. Einstellungen des Portal gehen beim Upgrade von 2.4.8 verloren
# apt install -y jsvc curl net-tools

Install TP-Link Omada Controller 5.0.x unter Debian 11

Achtung ältere Modelle wie die EAP330 werden nicht mehr unterstützt!

# cd /usr/local/src/
#  wget https://static.tp-link.com/upload/software/2022/202201/20220107/Omada_SDN_Controller_v5.0.29_linux_x64.tar.gz
# tar xfz Omada_SDN_Controller_v5.0.29_linux_x64.tar.gz
# cd Omada_SDN_Controller_v5.0.29_linux_x64/
# # ./install.sh
Omada Controller will be installed in [/opt/tplink/EAPController] (y/n): y  
Omada Controller will start up with system boot. You can also control it by [/usr/bin/tpeap].
Starting Omada Controller. Please wait.............................................................................................................................
Started successfully.
You can visit http://localhost:8088 on this host to manage the wireless network.
TP-Link Omada Controller Setup
TP-Link Omada Controller Setup
TP-Link Omada Controller Scenario
TP-Link Omada Controller Scenario
TP-Link Omada Controller Devices
TP-Link Omada Controller Devices
TP-Link Omada Controller Devices WAN
TP-Link Omada Controller Devices WAN
TP-Link Omada Controller WiFi SSID
TP-Link Omada Controller WiFi SSID
TP-Link Omada Controller Access
TP-Link Omada Controller Access
TP-Link Omada Controller Login
TP-Link Omada Controller Login

Installation TP-Link Omada Controller 3.2.x unter Debian 10

# cd /usr/local/src/

## 3.2.4
# wget https://static.tp-link.com/2019/201911/20191108/omada_v3.2.4_linux_x64_20190925173425.deb
# dpkg -i omada_v3.2.4_linux_x64_20190925173425.deb
Entpacken von omada (3.2.4) über (3.2.4) ...
omada (3.2.4) wird eingerichtet ...

## 3.2.10
# wget https://static.tp-link.com/2020/202004/20200420/omada_v3.2.10_linux_x64_20200330135119.deb
# dpkg -i omada_v3.2.10_linux_x64_20200330135119.deb

Install Omada Controller succeeded!
==========================
Omada Controller will start up with system boot. You can also control it by [/usr/bin/tpeap].
check omada
Starting Omada Controller. Please wait.....................................................
Started successfully.
You can visit http://localhost:8088 on this host to manage the wireless network.
========================
Trigger für systemd (241-7~deb10u2) werden verarbeitet ...

Wenn der Omada Controller und die Access Points nicht im selben Netzwerksegment sind, dann muss nun das Tool Omada Discovery Utility installiert werden. Details in dem User-Handbuch. Habe ich nicht, also weiter.

Nun ist der TP-Link Omada Controller installiert und die Installation kann über die Webseite weiter erfolgen. Dafür den Hostnamen bzw. die IP Adresse mit Port 8088 im Browser aufrufen z.B. : https://<ip-omada-controller>:8088

TP-Link Omada Controller Install
TP-Link Omada Controller Install

Controller Name vergeben

TP-Link Omada Controller Install Hostname
TP-Link Omada Controller Install Hostname

Login festlegen

TP-Link Omada Controller Install Login
TP-Link Omada Controller Install Login

TP-AP Konfiguration – die zu konfigurierenden Access Points auswählen

TP-Link Omada Controller Install AP
TP-Link Omada Controller Install AP

Nun den Netzwerknamen / die SSID und das Passwort festlegen

TP-Link Omada Controller Install Networkname
TP-Link Omada Controller Install Networkname

TP-Link Cloud Access konfigurieren, bzw. deaktivieren

TP-Link Omada Controller Install Cloud Access
TP-Link Omada Controller Install Cloud Access

Zusammenfassung der Konfiguration

TP-Link Omada Controller Install Summary
TP-Link Omada Controller Install Summary

TP Link Omada Controller Login

TP-Link Omada Controller Login
TP-Link Omada Controller Login

Damit ist die Installation der TP-Link Omada Controller Software abgeschlossen. Weiter geht es im nächstes Artikel mit der Einrichtung der ersten Site und der Access Points.

TP-Link Omada Controller Version 3 Update

Ich hatte einen Controller der von Version 3.2.10 auf die neuere 3.2.14 aktualisiert werden sollte. Das Update ist recht einfach:

# cd /usr/local/src
# wget https://static.tp-link.com/2020/202012/20201225/Omada_v3.2.14_linux_x64.deb
# dpkg -i Omada_v3.2.14_linux_x64.deb 
(Reading database ... 34081 files and directories currently installed.)
Preparing to unpack Omada_v3.2.14_linux_x64.deb ...
Omada Controller is running, going to stop it.
Stopping Omada Controller 
Stop successfully.
Unpacking omada (3.2.14) over (3.2.10) ...
Setting up omada (3.2.14) ...
Install Omada Controller succeeded!
==========================
Omada Controller will start up with system boot. You can also control it by [/usr/bin/tpeap]. 
check omada
Starting Omada Controller. Please wait.............................................................
Started successfully.

TP-Link Omada Controller start failed

Log anzeigen

# cat': cat /opt/tplink/EAPController/logs/server.log
# netstat -altnp @grep :27
Active Internet connections (servers and established)
Proto Recv-Q Send-Q Local Address           Foreign Address         State       PID/Program name
tcp        0      0 127.0.0.1:27017         0.0.0.0:*               LISTEN      384/mongod

Obwohl 1,9GB im root frei sind, zeigt mir das mongodb Log folgendes:

# cat /opt/tplink/EAPController/logs/mongod.log
Tue Jan 25 17:51:42 [initandlisten] ERROR: Insufficient free space for journal files
Tue Jan 25 17:51:42 [initandlisten] Please make at least 3379MB available in /opt/tplink/EAPController/data/db/journal or use --smallfiles

Erstversuch:

# cd /opt/tplink/EAPController/data
# rm -f db/* db/journal/* db/_tmp/*

Da bei mir in diesen Verzeichnissen keine Dateien waren, half dies nicht, also musste die virtuelle Disk der VM in Proxmox vergrößert werden. Nach der Vergrößerung konnte ich dies im Log sehen:

# ls -als /opt/tplink/EAPController/data/db/tpeap.*
 65540 -rw------- 1 omada omada  67108864 Jan 25 21:33 /opt/tplink/EAPController/data/db/tpeap.0
131072 -rw------- 1 omada omada 134217728 Jan 25 19:56 /opt/tplink/EAPController/data/db/tpeap.1
 16388 -rw------- 1 omada omada  16777216 Jan 25 21:28 /opt/tplink/EAPController/data/db/tpeap.ns

Die Fehlermeldung ist dann verschwunden und Omada Controller wird gestartet, die WebUI ist erreichbar, sieht jedoch etwas komisch aus:

~# service tpeap status
* tpeap.service - LSB: Omada Controller
   Loaded: loaded (/etc/init.d/tpeap; generated)
   Active: failed (Result: timeout) since Tue 2022-01-25 19:11:37 CET; 2h 25min ago
     Docs: man:systemd-sysv-generator(8)
  Process: 366 ExecStart=/etc/init.d/tpeap start (code=killed, signal=TERM)
    Tasks: 0 (limit: 1147)
   Memory: 13.0M
   CGroup: /system.slice/tpeap.service

Jan 25 19:06:38 debomada01 systemd[1]: Starting LSB: Omada Controller...
Jan 25 19:06:39 debomada01 tpeap[366]: check omada
Jan 25 19:11:37 debomada01 systemd[1]: tpeap.service: Start operation timed out. Terminating.
Jan 25 19:11:37 debomada01 systemd[1]: tpeap.service: Control process exited, code=killed, status=15/TERM
Jan 25 19:11:37 debomada01 systemd[1]: tpeap.service: Failed with result 'timeout'.
Jan 25 19:11:37 debomada01 systemd[1]: Failed to start LSB: Omada Controller.
Jan 25 19:11:38 debomada01 tpeap[366]: Starting Omada Controller. Please wait...

Ersten Kommentar schreiben

Antworten

Deine E-Mail-Adresse wird nicht veröffentlicht.


*


Diese Website verwendet Akismet, um Spam zu reduzieren. Erfahre mehr darüber, wie deine Kommentardaten verarbeitet werden.