Upcoming Maintenance Alert:

The UBNT Community will be upgraded at 5pm MDT on April 25th. During this time the community forums will be set to read-only status.

Learn more

×

UniFi 3.2.10 is released

by Previous Employee UBNT-DavidQ on ‎02-02-2015 02:33 PM - last edited on ‎07-21-2016 11:02 AM by Ubiquiti Employee (173,198 Views)

UniFi - 3.2.10-GA is the latest official General Availability Release.

 

NOTE:

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

 

Release Note

  • Feature Added
  • CTRL - Add multiple accounting server support for 802.1x/WPA2 Enterprise.
  • CTRL - Add multiple radius server support for 802.1x/WPA2 Enterprise.
  • Bug Fixes

From 3.2.7->3.2.10

  • UAPS - Fixed a case where wireless uplink stays isolated.
  • UAPS - Fixed roaming statistics.
  • UAPS - Fixed wireless uplink UAP LR stays isolated after a second wireless AP joins.
  • UAPS - Fixed waiting for firmware upgrade loop.
  • UAPs - Fixed a regression introduced in 3.2.7(fixing a crash) on rate limiting reported from forum.
  • UAPs - Fixed wireless uplink monitor randomly resets the interfaces causing disconnects. Note, Please setup a gatway ip address if using wireless uplink. If not using wireless uplink, please disable wireless uplink monitor.
  • UAPs - Fixed some memory leak in hostapd reported from forum.
  • UAPs - Default timezone to UTC.
  • UAPs - Fixed Guest Portal appends www.google.com to promotional URL if VLAN is enabled. This fix is needed along with v3.2.9 CTRL code or higher.
  • UAPs - Fixed rate limiting not working in certain configs, regression introduced in 3.2.7 reported from forum.
  • UAPs - Fixed radius accounting rounding account stop messages reported from forum.
  • UAPS - Fixed help text when using stamgr.
  • UAPS - Fixed hostname does not get updated sometimes.
  • UAPs(except AC) - Disable UAPSD by default. For Spectralink phone users, please change to enable in config.properties.
  • UAP Pro - Improved 5Ghz HT40 performance with Intel6300.
  • UAP Pro - Fixed ssh reboot along with toughswitch causes reboot loop.
  • UAP AC - Corrected power display again from previous fix.
  • UAP AC - Fixed AP can not pass PPPoE traffic reported from forum.
  • UAP AC - Fixed kernel panic during heavy reset testing.
  • UAP AC - Fixed Rogue AP reported as secured when it is open.
  • UAP AC - Fixed DHCP offers containinng wrong subnet mask reported from forum.
  • UAP AC - Added hostapd support for UAP ACS to help fix some WPA/2 Enterprise Radius issues reported from forum.
  • UAP AC - Fixed rebooting issue after some stress SSID testing.
  • UAP AC - Fixed STA Packet/byte counts is unreasonably low.
  • UAP AC - Fixed kernel panic in certain wireless environments.
  • UAP AC - Fixed sta reported info is not always accurate.
  • UAP AC - Fixed phantom SSID(ethx/wlxx) broadcast on the air reported from forum.
  • CTRL - Updated portal sample hotspot scripts to use tls v1 and ssl v1.
  • CTRL - Enable HT80 support in South Africa.
  • CTRL - Fixed web ui closes with error when downloading support info from chrome browser.
  • CTRL - Enable connectivity monitoring also for Zero Handoff.
  • CTRL - Fixed calendar selection is off at insight/past guest authorization reported from forum.
  • CTRL - Fixed map scaling issue with Firefox/Ubuntu.
  • CTRL - Fixed "Events" time scope filter is off.
  • CTRL - Fixed Guest Portal appends www.google.com to promotional URL if VLAN is enabled. This fix is needed along with v3.2.9 AP code or higher.
  • CTRL - Fixed Invalid Operator Account creation error in hotspot manager.
  • CTRL - Removed embargoed countries from country selection as well as removed Japan.
  • CTRL - Added some enhancement messages on roaming in logs.
  • CTRL - Clean up some api error messages.
  • CTRL - Fixed insight calendar off by a day.

How to perform the upgrade

We're being more cautious in pushing releases to the world. Following Google's model, we'll have three release channels

  • stable (widely used, most stable)
  • rapid (soaked in beta for a while)
  • beta (cutting edge)

For Debian-based system, simply do

sudo apt-get update
sudo apt-get install unifi-rapid

How to play safe?

UniFi stores everything under <UNIFI_BASE>/data/ . Keeping a copy will get your base covered. You can even install the new version, stop it, copy the data/ over it, and restart the controller.

How to downgrade?

The DB schema is drastically different and downgrade is not possible. Make sure you have a backup of prior version. After downgrading the controller, you can downgrade the AP firmware.

Known Limitations

  • UAP-AC - Rogue AP detection will only search for rogue AP on first power up. It will not continuously update rogue AP list during runtime.
  • Zero Handoff not supported on UAP-AC yet. Currently in development.
  • Wireless Uplink not supported on UAP-AC yet.

Download

UniFi Controller APT howto

  1. edit /etc/apt/sources.list
    ## Ubuntu
    deb http://www.ubnt.com/downloads/unifi/distros/deb/ubuntu ubuntu ubiquiti
    # if you're using quantal (12.04) or after, you don't need this line
    deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen
    ## Debian Wheezy (7.0)
    deb http://www.ubnt.com/downloads/unifi/distros/deb/debian debian ubiquiti
    ## Debian Squeeze (6.0)
    deb http://www.ubnt.com/downloads/unifi/distros/deb/debian debian ubiquiti
    deb http://downloads-distro.mongodb.org/repo/debian-sysvinit dist 10gen
    ## Debian Lenny (5.0):
    deb http://www.ubnt.com/downloads/unifi/distros/deb/lenny lenny ubiquiti
    deb http://downloads-distro.mongodb.org/repo/debian-sysvinit dist 10gen
    
  2. add GPG Key
    # for Ubiquiti
    sudo apt-key adv --keyserver keyserver.ubuntu.com --recv C0A52C50
    # for mongo-10gen
    sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 7F0CEB10
    # or over HTTP by using hkp://keyserver.ubuntu.com:80
    
  3. update, install, and upgrade
    # retrieve the latest package information
    apt-get update
    # install/upgrade unifi package
    # there are 3 packages in the same repository 
    # . unifi       (the most stable)
    # . unifi-rapid (soaked beta/rc/stable)
    # . unifi-beta  (the cutting edge)
    # you can install / switch between them
    apt-get install unifi-rapid
    

UniFi API

A shell library, unifi_sh_api is provided with the release. here's a sample script to authorize a guest for 30 minutes

#!/bin/sh
## define required variables
username=admin
password=admin
baseurl=https://localhost:8443
site=default
## include the API library
. unifi_sh_api
unifi_login
# authorize a client for 30 minutes, limit down/up speed to 2048/1024kbps, quota is 500MB
unifi_authorize_guest "e8:17:22:10:5d:4d" 30 down=2048 up=1024 bytes=500 
# generate 10 voucher(s) valid for 60 minutes, limit down/up speed to 2048/1024kbps, quota is 500MB
unifi_create_voucher 60 10 down=2048 up=1024 bytes=500
# this returns you a token that you can call by using unifi_get_vouchers()
unifi_logout

Notes

  1. AP->Performance view is experimental. Currently it shows what the radio is doing by red (packets not sent because of likely interference) / yellow (packets retried) / green (packets sent)
  2. voucher.css and voucher.html, at data/sites/SITE_NAME/portal/bundle/, is where you can fully customize your voucher.
  3. If you have existing customized guest portal, make sure to change form="/guest/login" to form="login" - let the relative path take care of per-site URL
  4. For API access, you pretty much need to insert /s/SITENAME into the URL. (after login with an admin in for site)