byUBNT-MikeD12-05-201710:43 AM - edited 12-28-201703:19 PM
How to play safe?
Make sure you always do a backup before any updates, especially if you plan to upgrade your existing installation.
It is also recommend to make a backup if you are on a controller version later than 5.6.26. Once you upgrade the firmware the controller will be on 5.6.26, so if you were on something different then you'll need to reinstall it and then restore your backup.
Using a release other than the one mentioned?
If you prefer to upgrade the firmware but still wish to continue using the controller version you were previously on, make sure to create a backup of your controller prior to upgrading. Then upgrade the firmware, purge unifi, install the previous version using the .deb file, then restore your controller backup during the setup wizard. This method will avoid the need to downgrade your controller, which isn't supported.
All system customizations are removed on firmware upgrade. This would include the UniFi VoIP controller, if you have it installed. Please make sure to backup your VoIP controller configuration, and any other customizations prior to firmware upgrade.
Please pay attention to the installation instructions below. If your Cloud Key is currently running firmware versions 0.8.1 to 0.8.4 then you cannot upgrade as you usually would, you need to follow one of the methods detailed below.
Changes since 0.8.2: ***SEE SPECIAL UPDATE INSTRUCTIONS BELOW***
Bundle UniFi Controller 5.6.26. SeeHERE for controller release notes.
Fix an issue with local admin credentials being set during controller setup wizard.
Update ubnt-tools to fix the update issue reportedHERE. This issue is only present on firmware 0.8.1-0.8.4.
How to update the latest firmware:
From UniFI Controller: Settings -> Maintenance -> CHECK FOR UPDATES (in CloudKey Firmware section) -> APPLY UPDATE
From UniFi Cloud Key WebUI: Maintanance -> CHECK FOR UPDATES (in FIRMWARE section) -> UPDATE NOW.
From UniFi Cloud Key WebUI: Maintanance -> UPDATE MANUALLY. From here you can either paste the URL, or if you downloaded the binary you can select the file locally on your computer.
The process is a little different. If you're on firmware 0.8.0 (and earlier), or if you've already have updated ubnt-tools, then you can skip straight to step 4 (via shell), upgrade via the controller UI, or paste the URL into the Update Manually option found on the Maintenance page of the UniFi Cloud Key Web UI.
If you're UCK is on firmware 0.8.1 to 0.8.4 then you need to perform extra steps. You can either upgrade the controller to 5.6.26, then run the UCK firmware upgrade from the controller web UI. Or you can perform the following steps.
Connect to the UniFi Cloud Key via SSH.
dpkg -l |grep ubnt-tools
If ubnt-tools is anything other than 0.9.7-1, then you need to update it. You can update it by issuing: