Reply
Ubiquiti Employee
Posts: 991
Registered: ‎05-04-2009
Posts: 991
Kudos: 510
Solutions: 17
Contributions: 1
Registered: 05-04-2009

UniFi - Past Releases

Release 1.2.1
Release 1.2.1 is the first mass production version of UniFi.
Release Notes
1. fix the problem where in-bound VLAN traffic not being forwarded correctly
2. fix the qos setting not taking effect
3. enhance wireless performance and stability
4. handle mobile devices (especially in power-saving mode) better
5. general bug fixes, UI enhancements, etc.
6. bg / n device and their power-saving status at a glance
How to perform the update
1. go to Admin tab, it should tell you that an update is available. If not, refresh the page.
2. click on the update button and follow the instructions
3. optionally, after you log back in, you can update the firmware of each device one by one by clicking the upgrade button for each device. Yes, you can do multiple ones at the same time.
I saw the event but didn't see the update button in Admin tab. What do I do?
There _was_ a upgrade button when the event was triggered. However, due to a bug in the controller, the button disappears next time it checks for upgrade (24 hours) if you don't perform the upgrade. (we didn't catch this during our testing as we never waited for 24 hours)
The workaround is to
1. stop the UniFi controller
2. remove the /data/update.json and /data/update.zip
3. restart the UniFi controller
4. in a few minutes, you should see the event again, refresh the browser page
5. now you should see 'Upgrade' button in Admin tab
What the update does
1. It updates your UniFi controller.
2. It bundles new AP firmwares
3. It will migrate your DB if necessary
What it doesn't do
1. It doesn't update your AP firmware (unless you enabled "Automatically upgrade firmware" in the System settings)
2. It doesn't reboot your AP
3. It doesn't disconnect active wireless client
What would happen if I don't update the AP firmware
Nothing for update from 1.2.0->1.2.1.
In general, we recommend you to update the firmware so it matches the version your UniFi is running. Not only can you pick up the latest bug fixes, but it guarantees the best compatibility between the controller and the AP.
In scenarios like major releases (e.g. 1.2.x->2.0.0), firmware updates will be applied automatically.
Download
You can also download the software for fresh installation.
UniFi Controller CD Image
UniFi Controller for Mac
UniFi Controller for Windows
Linux builds (see UniFi/readme.txt, experimental/unsupported)
UniFi Controller for Linux (32-bit)
UniFi Controller for Linux (64-bit)
Ubiquiti Employee
Posts: 991
Registered: ‎05-04-2009
Posts: 991
Kudos: 510
Solutions: 17
Contributions: 1
Registered: 05-04-2009

Release 1.2.2

Release Notes
1. VLAN issue fixed (returning vlan traffic should be forwarded correctly)
2. fixed AP stuck at adoption state and improved adoption speed (turn Auto Firmware Upgrade "on" for best result)
3. fixed manual AP's channel selection for certain country codes (e.g. Australia)
4. enhance wireless performance (especially for power-saving clients)
5. added UAP-LR support
6. accepts Database Backup from different versions (1.2.0 and 1.2.1)


How to perform the update
1. Auto upgrade: UniFi checks for updates daily. If you've seen an event about an update being available, go to Admin tab, find a Upgrade button. If not, refresh the page.
2. Manual upgrade: Backup your DB (Admin->Backup), uninstall 1.2.1, download 1.2.2, install 1.2.2 and Restore (Admin->Restore)

What the update does
1. It updates your UniFi controller.
2. It bundles new AP firmwares
3. It will migrate your DB if necessary

What it doesn't do
1. It doesn't update your AP firmware (unless you enabled "Automatically upgrade firmware" in the System settings)
2. It doesn't reboot your AP
3. It doesn't disconnect active wireless client

What would happen if I don't update the AP firmware
Nothing for update from 1.2.0 or 1.2.1->1.2.2
In general, we recommend you to update the firmware so it matches the version your UniFi is running. Not only can you pick up the latest bug fixes, but it guarantees the best compatibility between the controller and the AP.
In scenarios like major releases (e.g. 1.2.x->2.0.0), firmware updates will be applied automatically.

Download
You can also download the software for fresh installation.
UniFi Controller CD Image
UniFi Controller for Mac
UniFi Controller for Windows

Linux builds
Because of some changes in the dependencies and the inclusion of Ubuntu 11.04 support, releasing our 1.2.2 debian package may cost more trouble than it's worth. Please stay tuned for the 1.2.3 release.
Ubiquiti Employee
Posts: 991
Registered: ‎05-04-2009
Posts: 991
Kudos: 510
Solutions: 17
Contributions: 1
Registered: 05-04-2009

Release 1.2.3

Release Notes
1. fix the latency issue with iPad, iPod4 and other mobile devices that are very aggressive with power-saving
2. Andriod phone connection problem
3. guest portal redirect crashing Andriod browser
4. fix the heartbeat interval
5. debian package (debian 5 - debian 6, ubuntu 9.04 - ubuntu 11.04)
How to perform the update
1. Auto upgrade: UniFi checks for updates daily. If you've seen an event about an update being available, go to Admin tab, find a Upgrade button. If not, refresh the page.
2. Manual upgrade: Backup your DB (Admin->Backup), uninstall the old version, install the new one. Use the Restore function in Admin->Restore
What the update does
1. It updates your UniFi controller.
2. It bundles new AP firmwares
3. It will migrate your DB if necessary
What it doesn't do
1. It doesn't update your AP firmware (unless you enabled "Automatically upgrade firmware" in the System settings)
2. It doesn't reboot your AP
3. It doesn't disconnect active wireless client
What would happen if I don't update the AP firmware
Nothing if update between hotfix releases (i.e. 1.2.x -> 1.2.x)
In general, we recommend you to update the firmware so it matches the version your UniFi is running. Not only can you pick up the latest bug fixes, but it guarantees the best compatibility between the controller and the AP.
In scenarios like major releases (e.g. 1.2.x->2.0.0), firmware updates will be applied automatically.
Download
You can also download the software for fresh installation.
UniFi Controller CD Image
UniFi Controller for Mac
UniFi Controller for Windows
UniFi Controller APT howto
1. add mongoDB to apt souce.
UniFi Controller .dep package depends on mongoDB 1.6.1 or newer.
So please follow the steps HERE to add mongoDB into apt source list before install UniFi Controller.
2. edit /etc/apt/sources.list
For Ubuntu Maverick (10.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/maverick maverick ubiquiti

For Ubuntu Lucid (10.4):
deb http://www.ubnt.com/downloads/unifi/distros/deb/lucid lucid ubiquiti

For Ubuntu Karmic (9.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/karmic karmic ubiquiti

For Ubuntu Jaunty (9.4):
deb http://www.ubnt.com/downloads/unifi/distros/deb/jaunty jaunty ubiquiti

For Debian Lenny (5.0):
deb http://www.ubnt.com/downloads/unifi/distros/deb/lenny lenny ubiquiti

For Debian Squeeze (6.0):
deb http://www.ubnt.com/downloads/unifi/distros/deb/squeeze squeeze ubiquiti

3. add GPG Key
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv C0A52C50

or
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv C0A52C50

4. update, install & upgrade
apt-get update
apt-get install unifi
apt-get upgrade
Ubiquiti Employee
Posts: 991
Registered: ‎05-04-2009
Posts: 991
Kudos: 510
Solutions: 17
Contributions: 1
Registered: 05-04-2009

Release 1.3.0

Release Notes
- allow special characters for admin password / WLAN SSID and PSK
- static IP per ap
- WLAN override per AP (VLAN, SSID)
- supports PicoM2
- allow LED to be disabled
- fix the blackberry device connection problem

How to perform the update
1. Auto upgrade: UniFi checks for updates daily. If you've seen an event about an update being available, go to Admin tab, find a Upgrade button. If not, refresh the page.
2. Manual upgrade: Backup your DB (Admin->Backup), uninstall the old version, install the new one. Use the Restore function in Admin->Restore

What the update does
1. It updates your UniFi controller.
2. It bundles new AP firmwares
3. It will migrate your DB if necessary

What it doesn't do
1. It doesn't update your AP firmware (unless you enabled "Automatically upgrade firmware" in the System settings)
2. It doesn't reboot your AP
3. It doesn't disconnect active wireless client

What would happen if I don't update the AP firmware
Nothing if update between hotfix releases (i.e. 1.2.x -> 1.2.x)
Some new features may not work between minor releases (i.e. i.e. 1.2.x -> 1.3.x)
Between major releases (e.g. 1.2.x->2.0.0), firmware updates will be applied automatically.
In general, we recommend you to update the firmware so it matches the version your UniFi is running. Not only can you pick up the latest bug fixes, but it guarantees the best compatibility between the controller and the AP.

How to convert PicoM2 to run UniFi?
1. Download the firmware at HERE
2. In AirOS UI, upgrade with the firmware you downloaded

Notes:
- LED behaves differently and the first 2 LED cannot be disabled
- This process is one way. There's no plan to release a tool to reverse it
- While this firmware can be applied to other models running AirOS, UniFi cannot manage them and such action may void your warranty

Download
You can also download the software for fresh installation.
UniFi Controller CD Image
UniFi Controller for Mac
UniFi Controller for Windows

UniFi Controller APT howto
1. add mongoDB to apt souce.
UniFi Controller .dep package depends on mongoDB 1.6.1 or newer.
So please follow the steps HERE to add mongoDB into apt source list before install UniFi Controller.

2. edit /etc/apt/sources.list

## Ubuntu Maverick (10.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/maverick maverick ubiquiti
## Ubuntu Lucid (10.4):
deb http://www.ubnt.com/downloads/unifi/distros/deb/lucid lucid ubiquiti
## Ubuntu Karmic (9.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/karmic karmic ubiquiti
## Ubuntu Jaunty (9.4):
deb http://www.ubnt.com/downloads/unifi/distros/deb/jaunty jaunty ubiquiti
## Debian Lenny (5.0):
deb http://www.ubnt.com/downloads/unifi/distros/deb/lenny lenny ubiquiti
## Debian Squeeze (6.0):
deb http://www.ubnt.com/downloads/unifi/distros/deb/squeeze squeeze ubiquiti
#



3. add GPG Key

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv C0A52C50
# or over HTTP:
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv C0A52C50


4. update, install & upgrade
apt-get update
apt-get install unifi
apt-get upgrade


5. the UniFi webUI can be reached via https://:8443/
Ubiquiti Employee
Posts: 991
Registered: ‎05-04-2009
Posts: 991
Kudos: 510
Solutions: 17
Contributions: 1
Registered: 05-04-2009

Release 1.3.2

Release Notes
- fix static IP issue
- fix WLAN override issue
- allow guest expiration to be set for guest portal
- UI enhancements
- TX power respecting EIRP at all time (UniFi AP)

How to perform the update
1. Auto upgrade: UniFi checks for updates daily. If you've seen an event about an update being available, go to Admin tab, find a Upgrade button. If not, refresh the page.
2. Manual upgrade: Backup your DB (Admin->Backup), uninstall the old version, install the new one. Use the Restore function in Admin->Restore

What the update does
1. It updates your UniFi controller.
2. It bundles new AP firmwares
3. It will migrate your DB if necessary

What it doesn't do
1. It doesn't update your AP firmware (unless you enabled "Automatically upgrade firmware" in the System settings)
2. It doesn't reboot your AP
3. It doesn't disconnect active wireless client

What would happen if I don't update the AP firmware
Nothing if update between hotfix releases (i.e. 1.2.x -> 1.2.x)
Some new features may not work between minor releases (i.e. i.e. 1.2.x -> 1.3.x)
Between major releases (e.g. 1.2.x->2.0.0), firmware updates will be applied automatically.
In general, we recommend you to update the firmware so it matches the version your UniFi is running. Not only can you pick up the latest bug fixes, but it guarantees the best compatibility between the controller and the AP.

How to convert PicoM2 to run UniFi?
1. Download the firmware at HERE
2. In AirOS UI, upgrade with the firmware you downloaded

Notes:
- LED behaves differently and the first 2 LED cannot be disabled
- This process is one way. There's no plan to release a tool to reverse it
- While this firmware can be applied to other models running AirOS, UniFi cannot manage them and such action may void your warranty

Download
You can also download the software for fresh installation.
UniFi Controller CD Image
UniFi Controller for Mac
UniFi Controller for Windows

UniFi Controller APT howto
UniFi provides a debian package that you can update via APT
1. add mongoDB to apt souce.
UniFi Controller .dep package depends on mongoDB 1.6.1 or newer.
So please follow the steps HERE to add mongoDB into apt source list before install UniFi Controller.

2. edit /etc/apt/sources.list

## Ubuntu Maverick (10.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/maverick maverick ubiquiti
## Ubuntu Lucid (10.4):
deb http://www.ubnt.com/downloads/unifi/distros/deb/lucid lucid ubiquiti
## Ubuntu Karmic (9.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/karmic karmic ubiquiti
## Ubuntu Jaunty (9.4):
deb http://www.ubnt.com/downloads/unifi/distros/deb/jaunty jaunty ubiquiti
## Debian Lenny (5.0):
deb http://www.ubnt.com/downloads/unifi/distros/deb/lenny lenny ubiquiti
## Debian Squeeze (6.0):
deb http://www.ubnt.com/downloads/unifi/distros/deb/squeeze squeeze ubiquiti




3. add GPG Key

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv C0A52C50
# or over HTTP:
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv C0A52C50


4. update, install & upgrade
apt-get update
apt-get install unifi
apt-get upgrade


5. the UniFi webUI can be reached via https://:8443/

UniFi Zipped Package
A zipped package is also provide for DIYers. See readme.txt for details.
UniFi.unix.zip
Ubiquiti Employee
Posts: 991
Registered: ‎05-04-2009
Posts: 991
Kudos: 510
Solutions: 17
Contributions: 1
Registered: 05-04-2009

Release 2.2.0

We're releasing 2.2.0, the official V2 release. For people running 1.x, this update brings many major/useful features. For people running 2.x beta, we believe you'll be pleasantly surprised, too.

New Features

Wireless Uplink
Supports wireless uplink, each wired AP can have up to 4 downlinks
Allows runtime change of network topology
Allows wireless adoption of 2.0.0 APs in default state

L3 Manageability
Allows the controller to run in a different subnet
Allows no-touch AP provisioning by using DHCP Option 43 or DNS
Provides UniFi Discovery utility to make local AP to inform back to the controller in NOC or Cloud


Hotspot with Billing and Customization
Built-in support for billing integration (Paypal) accepting major credit cards and paypal, teaser package
Built-in support for voucher-base authentication
Built-in hotspot manager for voucher creation, guest management, payment refund
Allows full customization of portal pages
API support for voucher generation, guest authorization, guest unauthorization, etc.

Rate Limiting
You can limit the upload / download speed per WLAN. You can even override it per user.
Allow different rate-limiting and usage-limiting for each hotspot package

Other Features

  • Better/finer TX Power control
  • Advanced WPA settings - WPA1-Only / WPA2-Only, TKIP / CCMP(AES). Allow all printable characters for Passphrase
  • WLAN Override: add enable/disable, PSK override
  • Google Map integration (you can use Google Map in the Map view)
  • Load balancing (specifying desired number of clients per AP)
  • Offline client management
  • Allowed/whitelisted subnets for guest access
  • Running UniFi as Windows service
  • Shows "Managed by Other" for APs that were managed by old controller. An "advanced adoption" option is added to allow take-over.
  • Email notification for alerts
  • SSL certificate import
  • More API support


How to perform the update
1. Auto upgrade: UniFi checks for updates daily. If you've seen an event about an update being available, go to Admin tab, find a Upgrade button. If not, refresh the page.
2. Manual upgrade: Backup your DB (Admin->Backup), uninstall the old version, install the new one, use the "restore from previous backup" in the Setup Wizard
* It's encouraged to do a backup before you upgrade.

Downgrade
Assuming you have your configuration backup from, say, 1.3.2, you can remove 2.2.0, install 1.3.2, restore it. Then upgrade all the firmwares on the AP.

How to convert PicoM2 to run UniFi?
1. Download the firmware at HERE
2. In AirOS UI, upgrade with the firmware you downloaded

Notes:
- LED behaves differently and the first 2 LED cannot be disabled
- This process is one way. There's no plan to release a tool to reverse it
- While this firmware can be applied to other models running AirOS, UniFi cannot manage them and such action may void your warranty

Download
UniFi Controller for Mac
UniFi Controller for Windows

UniFi Controller APT howto
UniFi provides a debian package that you can update via APT
1. add mongoDB to apt souce.
UniFi Controller .dep package depends on mongoDB 2.0.0 or newer.
So please follow the steps HERE to add mongoDB into apt source list before install UniFi Controller.

2. edit /etc/apt/sources.list

## Ubuntu Natty (11.04):
deb http://www.ubnt.com/downloads/unifi/distros/deb/natty natty ubiquiti
## Ubuntu Maverick (10.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/maverick maverick ubiquiti
## Ubuntu Lucid (10.4):
deb http://www.ubnt.com/downloads/unifi/distros/deb/lucid lucid ubiquiti
## Ubuntu Karmic (9.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/karmic karmic ubiquiti
## Ubuntu Jaunty (9.4):
deb http://www.ubnt.com/downloads/unifi/distros/deb/jaunty jaunty ubiquiti
## Debian Lenny (5.0):
deb http://www.ubnt.com/downloads/unifi/distros/deb/lenny lenny ubiquiti
## Debian Squeeze (6.0):
deb http://www.ubnt.com/downloads/unifi/distros/deb/squeeze squeeze ubiquiti


3. add GPG Key

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv C0A52C50
# or over HTTP:
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv C0A52C50


4. update, install & upgrade

# retrieve the latest package information
apt-get update
# install/upgrade unifi package
apt-get install unifi
# or you can do apt-get upgrade to upgrade all packages on your debian


5. the UniFi webUI can be reached via https://:8443/

UniFi Zipped Package
A zipped package is also provide for DIYers. See readme.txt for details.
UniFi.unix.zip
Ubiquiti Employee
Posts: 991
Registered: ‎05-04-2009
Posts: 991
Kudos: 510
Solutions: 17
Contributions: 1
Registered: 05-04-2009

Release 2.2.1

Release 2.2.1 is deemed not reliable. See Release 2.2.3.
Release Note

  • SMTP send email problem
  • Controller performance improvement
  • Use 64-bit mongod in Windows whenever possible
  • UI: fix UI issue on older browsers (Firefox 3.6, Safari 5.0.x)
  • more flexible subnet configuration
  • fix Map disappear after logout
  • allow ASCII WEP key

...
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
## include the API library
. unifi_sh_api
unifi_login
unifi_authorize_guest "e8:17:22:10:5d:4d" 30
unifi_logout
Ubiquiti Employee
Posts: 991
Registered: ‎05-04-2009
Posts: 991
Kudos: 510
Solutions: 17
Contributions: 1
Registered: 05-04-2009

Release 2.2.5

2.2.5 addresses a few outstanding issues since 2.2.0.

Release Note

  • fix AP reboots issue
  • fix guest redirect problem after authorized
  • fix iOS guest redirect
  • fix wireless uplink issue in L3 deployments
  • Controller performance improvement
  • fix SMTP send email problem
  • Use 64-bit mongod in Windows whenever possible
  • UI: fix UI issue on older browsers (Firefox 3.6, Safari 5.0.x)
  • more flexible subnet configuration
  • fix Map disappear after logout
  • add 2-hour trial into portal sample page
  • allow ASCII WEP key


How to perform the update
We're being more cautious in pushing releases to the world.
Before we implement Google's model, we kind of treat people on the forum on the rapid track. Thus:

For people on 2.2.3 (beta), 2.2.5 will show up as auto-upgrade (for Windows/Mac)
For debian, it will be available in unifi repo.
For people on 2.2.0, you can either wait or use method 2 or 3 below.

1. Auto upgrade: UniFi checks for updates daily. If you've seen an event about an update being available, go to Admin tab, find a Upgrade button. If not, refresh the page.
2. Manual upgrade: Backup your DB (Admin->Backup), uninstall the old version, install the new one, use the "restore from previous backup" in the Setup Wizard
* It's encouraged to do a backup before you upgrade.
3. Advanced upgrade for Mac/Windows: Stop the UniFi controller. Copy/move the /data/ directory somewhere else. Uninstall/Re-install UniFi without starting it. Copy/move the directory back and overwrite the one just installed. Start the controller.

Downgrade
Assuming you have your configuration backup from, say, 2.2.0, you can remove 2.2.5, install 2.2.0, restore it. Then upgrade all the firmwares on the AP.
If you didn't backup and used auto-upgrade, there is a auto-backup done for you at /data/backup/2.2.0.unf

How to convert PicoM2 to run UniFi?
1. Download the firmware at HERE
2. In AirOS UI, upgrade with the firmware you downloaded

Notes:
- LED behaves differently and the first 2 LED cannot be disabled
- This process is one way. There's no plan to release a tool to reverse it
- While this firmware can be applied to other models running AirOS, UniFi cannot manage them and such action may void your warranty

Download
UniFi Controller for Mac
UniFi Controller for Windows

UniFi Controller APT howto
UniFi provides a debian package that you can update via APT
1. add mongoDB to apt souce.
UniFi Controller .dep package depends on mongoDB 2.0.0 or newer.
So please follow the steps HERE to add mongoDB into apt source list before install UniFi Controller.

2. edit /etc/apt/sources.list

## Ubuntu Natty (11.04):
deb http://www.ubnt.com/downloads/unifi/distros/deb/natty natty ubiquiti
## Ubuntu Maverick (10.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/maverick maverick ubiquiti
## Ubuntu Lucid (10.4):
deb http://www.ubnt.com/downloads/unifi/distros/deb/lucid lucid ubiquiti
## Ubuntu Karmic (9.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/karmic karmic ubiquiti
## Ubuntu Jaunty (9.4):
deb http://www.ubnt.com/downloads/unifi/distros/deb/jaunty jaunty ubiquiti
## Debian Lenny (5.0):
deb http://www.ubnt.com/downloads/unifi/distros/deb/lenny lenny ubiquiti
## Debian Squeeze (6.0):
deb http://www.ubnt.com/downloads/unifi/distros/deb/squeeze squeeze ubiquiti


3. add GPG Key

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv C0A52C50
# or over HTTP:
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv C0A52C50


4. update, install & upgrade

# retrieve the latest package information
apt-get update
# install/upgrade unifi package
apt-get install unifi
# or you can do apt-get upgrade to upgrade all packages on your debian


5. the UniFi webUI can be reached via https://:8443/

UniFi Zipped Package
A zipped package is also provide for DIYers. See readme.txt for details.
UniFi.unix.zip

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

## include the API library
. unifi_sh_api

unifi_login
unifi_authorize_guest "e8:17:22:10:5d:4d" 30
unifi_logout
Ubiquiti Employee
Posts: 991
Registered: ‎05-04-2009
Posts: 991
Kudos: 510
Solutions: 17
Contributions: 1
Registered: 05-04-2009

Release 2.3.8

Release Note

  • bandwidth limiting enhancement (make it more in sync with results from speedtest or wget, etc)
  • portal redirect enhancements
  • enhanced adoption/handling when DNS is not reachable
  • enable UAP-Outdoor's secondary ethernet port
  • allow connectivity/uplink monitor to be disabled completely (for people who don't use wireless uplink and don't want wireless to be disabled when gateway is not reachable)
  • fix controller stopping issue when installed as Windows service
  • Google Map fix - allows map type selection, saves as image (this is more of a workaround, before we get rid of Flash)
  • Paypal to allow other currency
  • add Ubuntu 12.04 (precise) support
  • add Java 7 support
  • fix for wireless uplink and PicoM2->UniFi conversion for newer units with DC:9FMan Very HappyB OUI
  • VoIP enhancement (mapping DSCP 46 to Voice, for getontoit)
  • UI enhancements

How to perform the update
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

Downgrade
Assuming you have your configuration backup from, say, 2.2.5, you can remove 2.3.8, install 2.2.5, restore it. Then upgrade all the firmwares on the AP.
If you didn't backup and used auto-upgrade, there is a auto-backup done for you at /data/backup/2.2.5.unf
How to convert PicoM2 to run UniFi?
1. Download the firmware at HERE
2. In AirOS UI, upgrade with the firmware you downloaded
Notes:
- LED behaves differently and the first 2 LED cannot be disabled
- This process is one way. There's no plan to release a tool to reverse it
- While this firmware can be applied to other models running AirOS, UniFi cannot manage them and such action may void your warranty
Download
UniFi Controller for Mac
UniFi Controller for Windows
UniFi Controller APT howto
UniFi provides a debian package that you can update via APT
1. add mongoDB to apt souce.
UniFi Controller .dep package depends on mongoDB 2.0.0 or newer.
So please follow the steps HERE to add mongoDB into apt source list before install UniFi Controller.

## for most people with Ubuntu 9.10 and after
deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen
## for most people with Debian
deb http://downloads-distro.mongodb.org/repo/debian-sysvinit dist 10gen

2. edit /etc/apt/sources.list

## Ubuntu Precise (12.04):
deb http://www.ubnt.com/downloads/unifi/distros/deb/precise precise ubiquiti
## Ubuntu Oneiric (11.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/oneiric oneiric ubiquiti
## Ubuntu Natty (11.04):
deb http://www.ubnt.com/downloads/unifi/distros/deb/natty natty ubiquiti
## Ubuntu Maverick (10.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/maverick maverick ubiquiti
## Ubuntu Lucid (10.4):
deb http://www.ubnt.com/downloads/unifi/distros/deb/lucid lucid ubiquiti
## Ubuntu Karmic (9.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/karmic karmic ubiquiti
## Debian Lenny (5.0):
deb http://www.ubnt.com/downloads/unifi/distros/deb/lenny lenny ubiquiti
## Debian Squeeze (6.0):
deb http://www.ubnt.com/downloads/unifi/distros/deb/squeeze squeeze ubiquiti

3. add GPG Key

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv C0A52C50
# or over HTTP:
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv C0A52C50

4. update, install & 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), and unifi-beta (the cutting edge)
# you can install / switch between them
apt-get install unifi
# or you can do apt-get upgrade to upgrade all packages on your debian

5. the UniFi webUI can be reached via https://:8443/
UniFi Zipped Package
A zipped package is also provide for DIYers. See readme.txt for details.
UniFi.unix.zip
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
## include the API library
. unifi_sh_api
unifi_login
unifi_authorize_guest "e8:17:22:10:5d:4d" 30
unifi_logout

detailed change logs since 2.2.5
From 2.2.5->2.3.2

  • bandwidth limiting enhancement (make it more in sync with results from speedtest or wget, etc)
  • portal redirect enhancements
  • enhanced adoption/handling when DNS is not reachable
  • enable UAP-Outdoor's secondary ethernet port
  • Paypal to allow other currency
  • allow connectivity/uplink monitor to be disabled completely (for people who don't use wireless uplink and don't want wireless to be disabled when gateway is not reachable)
  • fix controller stopping issue when installed as Windows service
  • UI enhancements

From 2.3.2 -> 2.3.3

  • fix guest bypassing guest portal
  • fix UniFi start-up problem with fresh installation using Java 7
  • add Ubuntu 12.04 (precise) support
  • fix SSID validation
  • fix Paypal processing of Master Card
  • fix incorrect client count in the statistics
  • allow mail sender to be configurable for sending alerts

From 2.3.3 -> 2.3.4

  • fix DHCP option 43 broken in 2.3.x
  • Google Map fix - allows map type selection, saves as image (this is more of a workaround, before we get rid of Flash)

From 2.3.4 -> 2.3.5

  • SSID to allow all printable characters
  • fix last-seen in All Clients tab (add Disconnected/All filter as well)
  • minor UI fixes

From 2.3.5 -> 2.3.6

  • fix issues around wireless uplink and adoption for newer units with DC:9FMan Very HappyB OUI
  • use 64-bit JRE if installed
  • make Allowed Subnets more flexible (which in turn enables AirPrint in the guest network)
  • VoIP enhancement (mapping DSCP 46 to Voice, for getontoit)
  • portal redirect enhancements (thanks to jaffadog and coastcruiser)
  • security enhancements (credit to Moritz Frenzel)

From 2.3.6 -> 2.3.8

  • fix the PicoM2 -> UniFi conversion for newer units with DC:9FMan Very HappyB OUI
Highlighted
Ubiquiti Employee
Posts: 991
Registered: ‎05-04-2009
Posts: 991
Kudos: 510
Solutions: 17
Contributions: 1
Registered: 05-04-2009

UniFi - Release 2.3.9

2.3.9 is released as a hotfix to 2.3.8.
Release Note

  • fix AP stopping accepting client issue in certain environments
  • AP reset-default improvement - holding reset button during booting up (until LED turns off) to reset the config
  • UAP-Pro performance and compability improvements
  • allow Guest wireless to be turned off when controller is not reachable (see FAQ)
  • allow more flexible capitive portal subnets to be added (see FAQ)
  • controller performance improvement
  • UI enhancements
  • NOTE: Starting from 2.3.9, auto-upgrade is turned off by default. A rolling-upgrade mechanism is in the work.

How to perform the update
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

Downgrade
Assuming you have your configuration backup from, say, 2.2.5, you can remove 2.3.9, install 2.2.5, restore it. Then upgrade all the firmwares on the AP.
If you didn't backup and used auto-upgrade, there is a auto-backup done for you at /data/backup/2.2.5.unf
How to convert PicoM2 to run UniFi?
1. Download the firmware at HERE
2. In AirOS UI, upgrade with the firmware you downloaded
Notes:
- LED behaves differently and the first 2 LED cannot be disabled
- This process is one way. There's no plan to release a tool to reverse it
- While this firmware can be applied to other models running AirOS, UniFi cannot manage them and such action may void your warranty
Download
UniFi Controller for Mac
UniFi Controller for Windows
UniFi Controller APT howto
UniFi provides a debian package that you can update via APT
1. add mongoDB to apt souce.
UniFi Controller .dep package depends on mongoDB 2.0.0 or newer.
So please follow the steps HERE to add mongoDB into apt source list before install UniFi Controller.

## for most people with Ubuntu 9.10 and after
deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen
## for most people with Debian
deb http://downloads-distro.mongodb.org/repo/debian-sysvinit dist 10gen

2. edit /etc/apt/sources.list

## Ubuntu Precise (12.04):
deb http://www.ubnt.com/downloads/unifi/distros/deb/precise precise ubiquiti
## Ubuntu Oneiric (11.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/oneiric oneiric ubiquiti
## Ubuntu Natty (11.04):
deb http://www.ubnt.com/downloads/unifi/distros/deb/natty natty ubiquiti
## Ubuntu Maverick (10.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/maverick maverick ubiquiti
## Ubuntu Lucid (10.4):
deb http://www.ubnt.com/downloads/unifi/distros/deb/lucid lucid ubiquiti
## Ubuntu Karmic (9.10):
deb http://www.ubnt.com/downloads/unifi/distros/deb/karmic karmic ubiquiti
## Debian Lenny (5.0):
deb http://www.ubnt.com/downloads/unifi/distros/deb/lenny lenny ubiquiti
## Debian Squeeze (6.0):
deb http://www.ubnt.com/downloads/unifi/distros/deb/squeeze squeeze ubiquiti

3. add GPG Key

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv C0A52C50
# or over HTTP:
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv C0A52C50

4. update, install & 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), and unifi-beta (the cutting edge)
# you can install / switch between them
apt-get install unifi
# or you can do apt-get upgrade to upgrade all packages on your debian

5. the UniFi webUI can be reached via https://:8443/
UniFi Zipped Package
A zipped package is also provide for DIYers. See readme.txt for details.
UniFi.unix.zip
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
## include the API library
. unifi_sh_api
unifi_login
unifi_authorize_guest "e8:17:22:10:5d:4d" 30
unifi_logout
Reply