Early Access Omada SDN Controller_V5.15.20 Pre-Release Firmware (Update on 24th Jan, 2025)
This Article Applies to
Omada_SDN_Controller_v5.15.20.11 Windows (Windows 10/11/Server, 64bit Recommended)
Omada_SDN_Controller_v5.15.20.10_linux_x64.tar.gz
Omada_SDN_Controller_v5.15.20.10_linux_x64.deb
Overview
We hope to offer you a chance to experience the new features added in the Controller v5.15.20 in advance, and also give us TP-Link the opportunity to fully test the firmware in your real network environment and scenarios before the official release. All feedback is welcome, including letting us know about successful upgrades.
Release Notes for Omada SDN Controller
1. Version Info
This version of the Controller is fully applied to the Omada APP of version 4.22 or above.
2. Supported Device Models
For device models Omada Software Controller supports, refer to: Omada Cloud SDN Platform Compatibility List
1) Added support for Gateways supporting double SIM cards: DR3650v-4G v1.0, DR3220v-4G v1.0, ER706W-4G v2.0, ER706WP-4G v1.0.
2) Added support for Switches: IES210GPP v1.0, IES206GPP v1.0, IES208G v1.0, IES206G v1.0.
3) Added support for APs: EAP668-Outdoor(EU/US) v1.0, EAP772-Outdoor(EU/US) v1.0.
4) Added support for OLT: DS-P7001-01 v1.0 (firmware update required).
3. New Features
1) Added support for AFC (Automated Frequency Coordination) with EAP772-Outdoor (EU/US) v1.0. The privilege of 6GHz Standard Power will be assigned to Access Points according to the device's location, so the available channels and the power of each channel can be adjusted dynamically.
2) Added support for Service Port Profile in Devices > OLT Properties Window > OLT Settings > PON > Profiles. This feature can help to create a service port automatically and simplify the configuration of the OLT PON unit.
3) Added support for Site/Device Template in Global View > Site Template (Beta). With Site Template, customer can batch manage and edit the configuration of sites bound to the template. With Device Template, customer can batch manage and edit the configuration of devices (currently, Switch & Gateway only) bound to the template.
4) For Linux: Added support for Cluster(Beta) in Global View > Settings > Cluster, including Modes as Distributed Cluster and Hot-Standby Backup.
5) Added support for Google Authentication (Beta) in Site View > Settings > Portal > Authentication Type.
6) Added support to display the used and remaining data in Logout Page of Voucher and Local Users Portal.
7) Added support for 'Remember Device' in Site View > Settings > Site Settings > General Configure. After device reset and power-on, the Controller will automatically adopt the device if the controller can find it.
8) Added support to edit Profiles All and Default in Site View > Settings > LAN > Switch Profile.
9) Added support for Role Super Administrator, which can manage all the other roles (except Main Administrator) and the privilege of most features. 10) *Added support to Disable NAT in Site View > Settings > Transmission > NAT.
11) *Added support for LAN DNS in Site View > Settings > Wired & Wireless Network > LAN.
12) *Added support for filtering with content in Site View > Settings > Network Security > URL Filtering. This feature helps network managers to achieve efficient, secure and convenient web access control by integrating a large number of categorized URL libraries.
13) *Added support for SD-WAN in Global View. Users can easily connect multiple gateways together without complicated VPN configuration through SD-WAN in enterprise scenarios.
14) *Added support for ARP Detection on Gateway. When you enable this feature, the dumb terminal can be detected, including POS, printer, etc.
4. Enhancements
1) Optimized dependencies:
Windows: Added support for built-in Java Runtime Environment in Controller, no need for the customer to install and configure Java anymore.
Linux: Added support MongoDB v8.0. Since Linux Controller v5.15.20, JDK below version 17 is no longer compatible.
2) Optimized WAN Mode. Added support for automatic updates to the Gateway Model when a new model is released.
3) Optimized Portal Logout Page. Added support to show used and remaining data on the Logout page of Voucher/Local User Portal.
4) Optimized MAC Filtering. When adopting devices with MAC filtering enabled, the MAC address of devices will be added into Allow List automatically.
5) *Optimized Gateway ACL. Added support for choice as "! -> !", customer can choose data resources and destinations not in certain marked range, which allows customer to configure more flexible profiles.
6) *Optimized DHCP Reservation. Added support for DHCP option 60, 66 and 138.
7) *Added support for DNS Override in DNS Proxy.
8) *Optimized Attack Defense. Added support to customize the length of large PING.
9) *Optimized Network Transmission. Added support for domain in settings of OpenVPN and Wireguard VPN.
10) *Optimized LAN on the following features: Added support to configure DHCP NEXT SERVER. Added support to edit Default LAN port of gateway.
11) *Added support to display the Device MAC in the WAN port of gateway's properties window.
12) *Added support for a maximum of 512 VLANs.
13) Optimized LDAP Profile in Site View > Settings > Network Profile:
- Added support for the maximum length of strings in Regular DN as 256.
- Added support for the maximum length of strings in Regular Password as 256.
- Added support for the maximum length of strings in Base Distinguished Name as 512.
- Added support for the maximum length of strings in Additional Filter as 512.
- Added support for the maximum length of strings in Group Distinguished Name as 512.
14) Added support to show the PPSK profile of SSID used by a client in Client List.
15) Optimized PoE Utilization chart. The Utilization will be calculated according to the power limit of each port.
16) Added support to enable and disable PoE Adapter Remote Reset in Devices > Properties Window(AP) > Config > General for EAP211-Bridge and EAP215-Bridge. With this function, the EAP can be reset remotely. Customers may choose to turn off this function to avoid it being triggered incorrectly due to a complex wireless environment.
17) Added support for 5000 entries in one Voucher Group.
18) Optimized the following Controller properties:
- Added support for maximum number of reports email sent via Cloud Access as 100.
- Added support for maximum number of reports email sent via SMTP Server as unlimited.
19) *Added support to show DHCP LEASE TIME in Client List. This feature will show the remaining time of this assigned IP address for certain client.
20) *Added support for Downlink chart in Detail unit of Gateway's properties window. Downlink chart will show the information of downstream Omada devices connected to this Gateway
5. Bug Fixed
1) Fixed the bug that the picture with "." in the file name can't be uploaded into Hot Map.
2) Reduced potential security risks by forcibly redirecting HTTP requests and responses to HTTPS ones.
Notes
1. These feature with * sign requires gateway's firmware to adapt to Controller v5.15.
2. Please note that Controllers on different platforms may have some differences on features, even their first three digits of the version code are the same. For example, Linux Controller currently supports Cluster Mode but Windows Controller doesn't support it yet.
3. Omada SDN Controller can only manage certain devices running the supported firmware. Please confirm that your device is compatible with the SDN Controller.
4. Since version 5.14.32, Omada Software Controller no longer supports upgrade from Controller v4.
5. Since version 5.14.32, Omada Software Controller(windows) only supports installation on Windows64-bit platform.
Firmware Download
Before the Upgrade
(1) Please be sure you have read the Beta Test Agreement before upgrading the Pre-release firmware!
(2) For the sake of insurance, it's always recommended to save a copy of the controller Backup Config file before upgrading or downgrading.
(3) You may follow the following guide to upgrade your Omada Controller. How to Upgrade or Downgrade Omada SDN Controller.
Firmware Download Link
Direct Download
Omada_SDN_Controller_v5.15.20.8_windows
Omada_SDN_Controller_v5.15.20.11 Windows (Windows 10/11/Server, 64bit Recommended)
Omada_SDN_Controller_v5.15.20.10_linux_x64.tar.gz
Omada_SDN_Controller_v5.15.20.10_linux_x64.deb
Additional Information
If somehow you encounter an issue during or after the controller upgrade, it's suggested to contact us with the following info:
- Omada Controller version (previous and current)
- Device Model(s), Hardware and Firmware versions
- (if possible) A copy of the Log file and Backup Config file
If you decide to downgrade the controller before reporting the issue to TP-Link, it's suggested to save a copy of the current Log file and Backup Config file before you do that, which could help to investigate and address the issue quickly.
>> How to get the Log file and Backup Config file for Omada SDN Controller:
-
If your Windows software controller failed to get launched, please locate the controller installation path for the Log file.
-
If it's not a launch issue, you can export the Log file and Backup Config file in the local network.
-
For Omada Controller v5.8 or later version,
In the Global View, go to Settings > Maintenance > Backup & Restore > Retained Data Backup, select Settings Only, then click Export for the Backup Config file. On the same page, scroll down for Export for Support, click Export Running Logs for desensitized Log file.
-
For Omada Controller v5.6 or v5.7,
Go to Settings > Maintenance > Backup & Restore > Retained Data Backup, select Settings Only, then click Export for the Backup Config file. On the same page, scroll down for Export for Support, click Export Running Logs for desensitized Log file.
-
For Omada Controller v5.5 or previous version,
Go to Settings > Maintenance > Backup & Restore > Retained Data Backup, select Settings Only, then click Export for the Backup Config file . Go to Settings > Services > Export Data > Running Log to export the Log file.
-
Update Log
Jan 24th, 2025
Update the following controller firmware for early access.
Omada_SDN_Controller_v5.15.20.11_pre-release_windows
Provide SDN controller for Linux system:
Omada_SDN_Controller_v5.15.20.10_linux_x64_deb
Omada_SDN_Controller_v5.15.20.10_x64_tar.gz
Jan 17th, 2025
Update the following controller firmware for early access.
Omada_SDN_Controller_v5.15.20.8_pre-release_windows
Jan 10th, 2025
Provide the following controller firmware for early access.
Omada_SDN_Controller_v5.15.20.7_pre-release_windows
Recommended Threads
TP-Link Early Access Program Is Now Available!
Get the Latest Omada SDN Controller Releases Here - Subscribe for Updates
Experience the Latest Omada EAP Firmware - Trial Available Here, Subscribe for Updates!
Get the Latest Firmware Releases for Omada Routers Here - Subscribe for Updates
- Copy Link
- Subscribe
- Bookmark
- Report Inappropriate Content
- Copy Link
- Report Inappropriate Content
Hi @Guirong
Yes, this is well noted and will be fixed in the subsequent update. Thanks for your feedback.
- Copy Link
- Report Inappropriate Content
- Copy Link
- Report Inappropriate Content
Installation Successfully Completed!
If you're encountering any issues related to Java, kindly run the following command to configure the correct Java version:
bash CMD
sudo update-alternatives --config java
Then, select Java version 17 and try the installation again.
- Copy Link
- Report Inappropriate Content
Updated on Ubuntu, no issues after updating java.
Poking around, in the Global View->Setttings->Cluster after you enable Cluster the link to " How to Configure Distributed Cluster Mode on Linux Controller. "
(https://www.omadanetworks.com/support/faq/4347/) is broken.
I have a lot of interest in this--is there anywhere to view additional information or should I just wait for the link to be published and go from there?
Additionally, I noticed on the link to supported products that the list in quite limited and only includes EAPs. Will Routers and Switches be coming or do they all support it and therefore don't require a compatability list? And I know its beta, etc. but is there a general timeframe target for cluster support across the Omada line?
- Copy Link
- Report Inappropriate Content
@Vincent-TP My controller is hosed after attempting to update from the previous version: 5.15.8.2. Lots of errors in /opt/tplink/EAPController/logs/server.log that the forum won't let me copy fully here...
01-24-2025 20:38:08.530 ERROR [main] [] c.t.s.o.s.t.SpringBootStartUpTask(): Cannot start up springboot. reson:Failed to read candidate component class: URL [jar:file:/opt/tplink/EAPCo
ntroller/lib/backup-core-5.15.8.2.jar!/com/tplink/smb/omada/backup/core/unit/globalconfig/g/b/b.class]
org.springframework.beans.factory.BeanDefinitionStoreException: Failed to read candidate component class: URL [jar:file:/opt/tplink/EAPController/lib/backup-core-5.15.8.2.jar!/com/tpli
nk/smb/omada/backup/core/unit/globalconfig/g/b/b.class]
...
Caused by: java.lang.IllegalArgumentException: No enum constant com.tplink.smb.omada.backup.api.c.j.V10000940
...
But I did upgrade java:
# update-alternatives --config java
There are 3 choices for the alternative java (providing /usr/bin/java).
Selection Path Priority Status
------------------------------------------------------------
0 /usr/lib/jvm/zulu17/bin/java 2175601 auto mode
* 1 /usr/lib/jvm/java-17-openjdk-amd64/bin/java 1711 manual mode
2 /usr/lib/jvm/zulu17/bin/java 2175601 manual mode
3 /usr/lib/jvm/zulu8/jre/bin/java 1808401 manual mode
Press <enter> to keep the current choice[*], or type selection number: 1
root@omada:~# java -version
openjdk version "17.0.13" 2024-10-15
OpenJDK Runtime Environment (build 17.0.13+11-Debian-2deb12u1)
OpenJDK 64-Bit Server VM (build 17.0.13+11-Debian-2deb12u1, mixed mode, sharing)
- Copy Link
- Report Inappropriate Content
I'm not sure what the fix was, but after the following, I am running fine on the latest - I suspect it was running the previous version under jdk17 before upgrading to the latest, rather than running the previous under jdk8 and then the latest under jdk17.
- Kept jdk17 as the active java version
- installed the previous omada_v5.15.8.2_linux_x64_20241230190018.deb - that worked
- Upgraded to the latest jsvc following the install guide from source (1.4.1)
- installed the latest dpkg -i omada_v5.15.20.10_linux_x64_20250122095751_1737709061629.deb
- Copy Link
- Report Inappropriate Content
Had the same Java Error on my Ubuntu Install... and Followed the direction from previous users/post and it worked!
So far so good!
My test lab has a 7206 V1... hopefully it gets a few firmware update.
- Copy Link
- Report Inappropriate Content
@Vincent-TP While everything appears to be working so far now, I just migrated from one software controller (the one I just updated to 5.15.20.10) to a newly installed 5.15.20.10
controller, and notice these errors scrolling through the logs on the newly migrated (but otherwise appearing to be working correctly with everything adopted) controller on 5.15.20.10 (I cannot include full logs due to forum url filtering it seems):
Caused by: com.fasterxml.jackson.databind.exc.MismatchedInputException: Cannot deserialize value of type `com.tplink.smb.omada.device.manage.message.get.osg.ContentFilterResp` from Array value (token `JsonToken.START_ARRAY`) at [Source: REDACTED (`StreamReadFeature.INCLUDE_SOURCE_IN_LOCATION` disabled); line: 1, column: 45] (through reference chain: com.tplink.smb.omada.device.manage.message.body.osg.OsgGetRespBody["urlFiltering"])
- Copy Link
- Report Inappropriate Content
For the new features, please refer to:
How to Configure Distributed Cluster Mode on Linux Controller
How to Configure Hot-Standby Backup Mode on Omada Controller
- Copy Link
- Report Inappropriate Content
Information
Helpful: 6
Views: 4134
Replies: 37
Voters 3
