UniFi 5.6.30 LTS Stable has been released

by Ubiquiti Employee ‎01-26-2018 11:53 AM - edited ‎04-06-2018 03:16 PM (109,592 Views)


Introducing our latest release for UniFi wireless, routing & switching hardware. This is our latest stable release for our current LTS branch.


How to play safe?

Make sure you always do a backup before any updates, especially if you plan to upgrade your existing installation. 


Release Notes:

  • For people who are migrating from v3, there're many changes to APIs and it's not backward compatible. You may need to update the shell library (unifi_sh_api) and/or your customized portal/external portal code.
  • Windows users must have x64 Java installed to use the unifi.ubnt.com cloud tie in, as we only support 64 bit webRTC library. Please see HERE and download the missing version (64bit offline Windows install package). The controller will run in an x86 only environment, or with x86 Java, but the unifi.ubnt.com tie in will not work.
  • For hotspot management console, make sure you have bookmark the URL with site ID (i.e. x66cipn3, or whatever random string is generated for that site). For example:
  • For Debian/Ubuntu users, please update your APT source (see HERE).
    • unifi-beta/unifi-rapid are obsoleted. The old repo has been removed.
  • You cannot re-use a VLAN ID for dynamic VLAN if it is set as a static value for another SSID on the same AP. So, if I have a SSID set to use VLAN 10, I cannot use VLAN ID 10 for RADIUS controlled VLAN users as those users will not get an IP.
  • Cloud Access feature in this release is not supported on Linux/ARMv6 architecture (for exmaple, Raspberry Pi 1). If you have problem starting controller on this platform, please remove the native library:
sudo rm /usr/lib/unifi/lib/native/Linux/armhf/libubnt_webrtc_jni.so
  • Smart Queue QoS is similar to the implementation as in EdgeOS (see HERE). Please note that DPI will not work when using Smart Queue QoS, as traffic will not be offloaded. It's also worth noting that maximum throughput will be affected when using Smart Queue QoS, as traffic is not offloaded. There are some rough guidelines in the article linked above.
  • DFS channels can not be used for wireless uplink in the US. Please use non-DFS channels if you need to use wireless uplink on dual band UAPs. 
  • Official UniFi MIBs can be downloaded from HERE and HERE (those are 2 different files).
  • A full changelog has been attached, showing changes back to the first public release (1.2.1).

Other Notes:

  • As of 5.6.x we dropped support for Java 6. The minimum supported version of Java is 7, but we highly recommend version 8. At this time Java 9 is not supported.
  • All APs will be reprovisioned on controller upgrade, which will cause a temporary outage for all connected users. Please make sure to do this after hours, or a time when it's okay to disconnect users for several minutes. This should not affect users upgrading from 5.3.8 or later. 
  • Features like airtime fairness, bandsteering, load balancing and minimum RSSI are default disabled. If you need them you need to go to Settings>Site and check Enable advanced features.
  • If you previously used Google Maps for a site map, then you have to enable this feature again by adding an API key. This is done under Settings>Controller. There is a linked guide with instructions.
  • Do not choose the skip option when running the Migrate Site wizard. If you do your devices may end up in a weird state.


Important Notes:

  • The initial database migration will take longer than normal. It is expected to see mongo using most, if not all, of the available CPU cycles during this process. Please be patient, this process could easily take 15+ minutes, depending on the amount of historical stats, as well as the system specs. As always, err on the side of caution, and make a backup before upgrading.
  • The controller will not start if it is set to bind to a privileged port (<1024), as it now runs as a non-root user. 
  • If your controller is running on a UniFi Cloud Key (UCK), make sure it is on firmware 0.6.4 or later, otherwise the controller will not start. This firmware is available via the normal upgrade mechanism found in the controller or it's local management page. Make sure to make a backup before upgrading the UCK firmware, as you'll need it to restore after, and it's good to have a backup on hand before any controller upgrade.


Known Issues:

  • Manual site-to-site VPN status is not reflected on the UniFi dashboard widget. Currently it will look like it's offline, even when the tunnel is up.
  • airTime will not work if a radio is disabled and/or there isn't any SSID present. This will be fixed in a future release. If you enable it, and it still isn't working, then you may need to force a refresh without cache. 
  • If you start both a 2.4GHz and 5GHz scan in quick succession, then it will fail.
  • It is expected that airView will stop occasionally. A stop/start sequence should restore functionality.
  • If you start an airTime scan while airView is running, then airView will stop and you'll need to perform a stop/start sequence to get it working again. This will be fixed in the future.


Controller bugfixes/changes from 5.6.29:

  • Fix displaying blank page on double click on Insights.
  • Fix downloading large backups over WebRTC.
  • Improve reliability of UniFi Cloud Access service (unifi.ubnt.com).
  • Various backend bugfixes and improvements.


Firmware changes since 3.9.15/4.4.12:

  • [HD/SHD/XG] Stability and performance improvements. 
  • [HD/SHD/XG] Fix a memory leak when multicast enhancements are enabled.
  • [AC-IW/IW-Pro/Pro/EDU/M-Pro] Add ability to set port negotiation.*
  • [nanoHD] Fix MBSS support.
  • [nanoHD] Stability improvements.
  • [nanoHD] Add guest control support.
  • [nanoHD] Add 802.1X support.
  • [nanoHD] Add support for multiple BSSIDs per radio. 
  • [nanoHD] Fix issue when using a bracket in the ESSID or PSK. 
  • [nanoHD] Fix auto channel selection.
  • [nanoHD] Fix 802.11n negotiation issue.
  • [nanoHD] Fix issue which could cause Ethernet to stay down after provision or reboot. 
  • [UAP] Improve STA signal reporting. 
  • [UAP] Wireless uplink/mesh V3 improvements.*
  • [UAP] Fix a bug with rate control when using multiple SSIDs.
  • [UAP] Fix NAS-IP-Address attribute so that it always returns the management IP of the AP.
  • [UAP] Various bugfixes and improvements.
  • [USW] Various improvements.
  • [USG] Added non-offloaded DPI support - DPI now functions when hardware offloading is disabled, so co-exists with features that disable or bypass it (smart queues, IDS/IPS). This does not change anything when hardware offload is enabled.
  • [USG] GeoIP fixes - all known problems with it resolved, added back end for directional control. 
  • [USG] SNMP persistent directory relocated to RAM disk, which prevents "Unhandled kernel unaligned access" crash 
  • [USG] Removed core handling script that was causing reboots when large core files were generated
  • [USG] Fix IGMP proxy failing to start during boot a few were experiencing.
  • [USG] Fix potential issue of UPnP failing to start during boot. 
  • [USG] Change IPS loading of ipset contents to more efficient method to greatly reduce CPU usage after initial bootup and enabling of service.
  • [USG] xl2tpd package upgraded
  • [USG] Other IDS/IPS back end improvements
  • [USG] Fix ubnt-cfgd zombie process issue
  • [USG] Added SNMPv3 back end
  • [USG] Added lock wait to all iptables operations to avoid errors in cases where multiple operations happen simultaneously.
  • [USG] DPI signature update
  • [USG] Add IDS/IPS back end
  • [USG] Fix in informs for IPv6 PD size (was causing PD size to be cleared in controller). 
  • [USG] Add support for sending custom events to controller.
  • [USG] Fix DDNS update public IP checking for NATed WANs
  • [USG] Local UI now checks ping to ping.ubnt.com rather than default gateway for Internet connectivity test
  • [USG] Copy 'hostname' and 'mailname' over during upgrades for consistency with other retained files cross-upgrade (from EdgeRouter, generally no functional impact for USG purposes). 
  • [USGXG] Bluetooth back end updates.
  • [USGXG] VLAN hardware offload improvements.
  • [USGXG] DHCP hardware offload problem fixed.
  • [USGXG] LCM (display) firmware update including splash screen, update process improvements.
  • [HW] New procotol implementation.
  • [HW] Add controller support for netconsole.*
  • [HW] Fix some issues which would cause L3 adopted devices to show up as disconnected in the controller (reported HERE and HERE).
  • [HW] Fix SNMP sysName.


Recommended Firmware:



*This release follows our usual release structure which means it will initially be available via this blog post only. It will be posted to the download site and official repos in the near future. If you aren't familiar with our release structure, please take a moment to read our post HERE. Thanks!