Unifi
unifi logo | |
Maintainer | Unnilennium |
---|---|
Url | https://wiki.contribs.org |
Licence | proprietary |
Category | |
Tags | wifi, ubnt, ubiquity, |
Maintainer
Version
Description
Ubiquity network (ubnt) provides a UniFi controller which can run on a Linux server to monitor your UniFi devices. Those are WiFi and networking, professional grade devices. This contribution allow to install and follow the upgrade of this controller on a SME server . As this is proprietary software, we can not bundle it as a rpm and distribute it. This rpm is all you need to easily download and install with the least intervention on your SME.
Installation
yum install smeserver-extrarepositories-mongodb -y db yum_repositories setprop mongodb3.6 status enabled expand-template /etc/yum.smerepos.d/sme-base.repo yum install smeserver-unifi --enablerepo=smecontribs,smedev,epel,mongodb3.6
First install the needed repositories.
yum install smeserver-extrarepositories-centos-sclo-rh smeserver-extrarepositories-epel signal-event yum-modify
Install the SME Server Package
yum install smeserver-unifi --enablerepo=smecontribs,smedev,epel,centos-sclo-rh
Launch the download and installation of your installer.
signal-event smeserver-unifi-install config set UnsavedChanges no
you can now access to your UniFi controller using : https://YOURSERVERIP:8443
Follows the steps to configure the interface, and add your first devices.
Uninstall
yum remove smeserver-unifi unifi
you can then remove the content of : /opt/UniFi and /opt/Unifi_bak
Upgrade installed version
This will be a 3 steps upgrade
- find the version you want to update to, and list of allowed to upgrade release from
- find your current version release, and update to the minimal needed release
- update to the last version you want.
First you will need to find the current installed version :
# config getprop unifi VersionToInstall
5.6.30
Then you will need to check what is the version needed to upgrade to the desired version. Let's say 6.0.43 : https://community.ui.com/releases/UniFi-Network-Controller-6-0-43/b28bb453-927a-4dd8-82f7-40af28505510
6.0.43 and earlier 6.0.x versions.
5.14.25 and earlier 5.14.x versions.
5.13.33 and earlier 5.13.x versions.
5.12.72 and earlier 5.12.x versions.
5.11.52 and earlier 5.11.x versions.
5.10.27 and earlier 5.10.x versions.
5.9.33 and earlier 5.9.x versions.
5.8.30 and earlier 5.8.x versions.
5.7.28 and earlier 5.7.x versions.
5.6.42 and earlier 5.6.x versions.
Most earlier versions are also supported for direct upgrade, going back to 3.1.0.
or 5.10.25
https://community.ui.com/releases/UniFi-Network-Controller-Stable-5-10-25/fc76945d-c918-4d8d-8cd1-094d05287f45
Existing UniFi controllers must be on one of the following versions in order to upgrade directly to this version:
5.10.24 and earlier 5.10.x versions.
5.9.33 and earlier 5.9.x versions.
5.8.30 and earlier 5.8.x versions.
5.7.28 and earlier 5.7.x versions.
5.6.42 and earlier 5.6.x versions.
Most earlier versions are also supported for direct upgrade, going back to 3.1.0.
check the lowest release needed is available
# wget https://www.ubnt.com/downloads/unifi/5.6.42/UniFi.unix.zip -O UniFi.unix.5.6.42.zip
--2021-01-12 15:15:16-- https://www.ubnt.com/downloads/unifi/5.6.42/UniFi.unix.zip
Résolution de www.ubnt.com... 52.89.51.163, 52.36.159.148, 54.200.240.95
Connexion vers www.ubnt.com|52.89.51.163|:443...connecté.
requête HTTP transmise, en attente de la réponse...301 Moved Permanently
Emplacement: https://www.ui.com/downloads/unifi/5.6.42/UniFi.unix.zip [suivant]
--2021-01-12 15:15:16-- https://www.ui.com/downloads/unifi/5.6.42/UniFi.unix.zip
Résolution de www.ui.com... 52.40.47.125, 44.238.178.238, 52.33.211.203
Connexion vers www.ui.com|52.40.47.125|:443...connecté.
requête HTTP transmise, en attente de la réponse...301 Moved Permanently
Emplacement: https://dl.ubnt.com/unifi/5.6.42/UniFi.unix.zip [suivant]
--2021-01-12 15:15:16-- https://dl.ubnt.com/unifi/5.6.42/UniFi.unix.zip
Résolution de dl.ubnt.com... 13.225.199.94
Connexion vers dl.ubnt.com|13.225.199.94|:443...connecté.
requête HTTP transmise, en attente de la réponse...200 OK
Longueur: 63581448 (61M) [application/zip]
Sauvegarde en : «UniFi.unix.5.6.42.zip»
then set your update release, and launch event to do the upgrade :
# config setprop unifi VersionToInstall 5.6.42
# signal-event smeserver-unifi-install
then finally update to desired version
# config setprop unifi VersionToInstall 5.10.25
# signal-event smeserver-unifi-install
Configuration
here are the available configurations:
- access : default is private, you should NOT set it to public to allow access from the outside network, in fringe case you need access to https use forward port in server-manager to 8443 to LAN interface and put list of allowed host.
- status : enabled
- TCPPorts : 8080,8443,8880,8843
- UDPPorts : 3478,10001
- VersionToInstall: here is the version number you want to install. Default is usually the version number of the rpm, you can force to install another version, if needed, and this is the real way to upgrade your controller.
Bugs
Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-unifi component or use this link
Below is an overview of the current issues for this contrib:
Changelog
Only released version in smecontrib are listed here.
- fix execution bit again [SME: 12225]
- add execution bit [SME: 12225]
- fix [SME: 10534]
2022/08/03 Jean-Philippe Pialasse 5.6.30-2.sme
- systemd enabled [SME: 12139]
- update event [SME: 12139]
- update Ports [SME: 12139]
- use LE cert if available [SME: 10534]
- initial release
Sources
- https://community.ubnt.com/t5/UniFi-Wireless/Unifi-Controller-software-license/m-p/1744454#M194230
- https://www.stevejenkins.com/blog/2016/06/automated-script-unifi-controller-upgrade-linuxunix-systems/
- https://github.com/stevejenkins/unifi-linux-utils/blob/master/upgrade_unifi_controller.sh
- https://github.com/stevejenkins/unifi-linux-utils
- https://gist.github.com/olegslavkin/6120d931f56bd781a75e
- https://community.ubnt.com/t5/UniFi-Wireless/initial-set-up-cannot-connect-to-Unifi/td-p/747972
- http://reseaux85.fr/index.php?title=Ubiquiti_Networks_-_Serveur_Unifi