UniFi SDN Controller 5.7.20 Stable has been released

by Ubiquiti Employee ‎03-08-2018 01:14 PM - edited ‎07-04-2018 05:24 AM (120,899 Views)

UniFi_V5_IG_FIN.jpg

Introducing our latest release for UniFi wireless, routing & switching hardware. This is our initial stable release for the 5.7.x 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:
    https://unifi.yourdomain.com:8443/manage/hotspot/site/SITE_ID
  • For Debian/Ubuntu users, please update your APT source (see HERE).
    • unifi-beta/unifi-rapid are obsoleted. The old repo has been removed.
    • The following affects APT versions 1.5 onward (Ubuntu 17.10 and Debian Sid or newer). A recent version of the apt-secure man page stated: "Since version 1.5 changes in the information contained in the Release file about the repository need to be confirmed before APT continues to apply updates from this repository", meaning that when performing an update from a major version to the next (for example 5.6.x to 5.7.x) the apt-get update will result in an error. To fix this run the command the following way: apt-get update --allow-releaseinfo-change
  • 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). It's 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.7.x we only support Java 8. At this time Java 9 is not supported.
  • 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.

 

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.
  • Support for PicoM2 and 1st gen AC models was dropped in 5.7.x. Please see our announcement HERE.
  • As of release branch 5.7.x we've made some important changes to the Wireless Uplink feature (feature details HERE).
    • We removed the "Enable automatic uplink failover" from wireless uplinks as it is no longer needed.
    • We added the ability to opt an AP in or out of wireless uplinking to another AP. This is done by checking the "Allow meshing to another access point" option found under device properties>Config>Wireless Uplink.
      • This option should be disabled on wired APs, but is required to be enabled on wireless APs.
      • If you disable this option on a downlink/wireless AP, then your AP will be disconnected from the network and require further action (including physical access).
      • If upgrading from 5.6>5.7 then this already be disabled on wired APs, but if upgrading from an earlier 5.7. release then this may be enabled on wired APs. 
      • Again, this option should be enabled on downlink/wireless UAPs only. It should not be enabled on wired UAPs. 
    • We added the ability to set uplink priorties. This allows you to define the preferred uplinks for a downlink/wireless AP.
  • We’ve found that some migrations from 5.6 to 5.7 have resulted in Fast Roaming being enabled, which is not our recommendation. If you see this, feel free to disable Fast Roaming on all Wireless Networks.

 

Known Issues:

  • 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.

 

New Features:

  • Add IPv6 support (Beta).
  • Add Intrusion Prevention System (IPS) [beta].
  • Add GeoIP Filtering options to settings [Beta].
  • Add Virtual devices on Maps to plan coverage.
  • Add SSH keys to authenticate to device.
  • Add Auto Channel feature on Maps.
  • Add Release Notes to controller UI.
  • Add ability to create and set user defined DHCP options.
  • Add Wireless Uplink priority.
  • Add support for SNMPv3.
  • Add restart devices permission.
  • Add support for new Elite Device service.
  • Add Bulgarian translations to the Hotspot Portal.
  • Batch remove vouchers.
  • Customize voucher columns.
  • Ability to display historical statistics per Client (traffic, packets, signal power etc.).
  • Link to property panel from Location on Neighboring Access Points page.
  • Support Antenna selection for internal antenna.

 

Controller bugfixes/changes since 5.7.19:

  • Improve Neighboring Access Points loading.
  • Update Wireless Uplink information text.
  • User Groups - setting limits more flexible.
  • Fixing WebSocket error for site admin without Show pending devices permission.
  • Fixing incorrect debug terminal connection state after closing panel.
  • Removed second performance word from real-time tooltip.
  • Fix invisible debug terminal when device is RF scanning.
  • Fix set switch port profile native network as 'None'.
  • Reduce port stats log level to fix unnecessary log spam. 
  • PPPoE IPv6 provisioning improvements. 
  • Improve guest portal handling on gateway devices.
  • Fix validation of IPv6 IPs as group members (reported HERE). 
  • Various backend bugfixes and improvements.

*There is a long list of changes between 5.6.x and 5.7.x. Everything available in 5.6.x is available in 5.7.x and more. To minimize clutter in this thread, please review the attached text file changelog if you wish to see all changes from 5.7.0 to 5.7.20.

  

Recommended Firmware:

 

Download:

 

*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!