Difference between revisions of "Unifi"

From SME Server
Jump to navigationJump to search
 
(9 intermediate revisions by 2 users not shown)
Line 15: Line 15:
 
|category= Category you want
 
|category= Category you want
 
|tags=wifi, ubnt, ubiquity,  
 
|tags=wifi, ubnt, ubiquity,  
−
}}{{Warning box|Beware this is still alpah stage. Use only for testing purpose}}
+
}}
  
 
===Maintainer===
 
===Maintainer===
Line 31: Line 31:
  
 
=== Installation ===
 
=== Installation ===
 +
<tabs container><tab name="For SME 10">
 +
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 {{#var:smecontribname}} --enablerepo=smecontribs,smedev,epel,mongodb3.6
  
 +
</tab><tab name="For SME 9">
 
First install the needed repositories.
 
First install the needed repositories.
 
  yum install smeserver-extrarepositories-centos-sclo-rh smeserver-extrarepositories-epel  
 
  yum install smeserver-extrarepositories-centos-sclo-rh smeserver-extrarepositories-epel  
Line 42: Line 48:
 
  signal-event smeserver-unifi-install
 
  signal-event smeserver-unifi-install
 
  config set UnsavedChanges no
 
  config set UnsavedChanges no
−
 
+
</tab>
 +
</tabs>
  
 
you can now access to your UniFi controller using : https://YOURSERVERIP:8443
 
you can now access to your UniFi controller using : https://YOURSERVERIP:8443
Line 60: Line 67:
  
 
First you will need to find the current installed version :<syntaxhighlight lang="bash">
 
First you will need to find the current installed version :<syntaxhighlight lang="bash">
−
# config getprop VersionToInstall
+
# config getprop unifi VersionToInstall
 
5.6.30
 
5.6.30
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
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<syntaxhighlight>
+
Then you will need to check what is the version needed to upgrade to the desired version. Check there: https://www.ui.com/download/unifi/default/default/unifi-network-application-7168-debianubuntu-linux-and-unifi-cloud-key/
 +
 
 +
Let's say 6.0.43 : https://community.ui.com/releases/UniFi-Network-Controller-6-0-43/b28bb453-927a-4dd8-82f7-40af28505510<syntaxhighlight>
 +
 
 
6.0.43 and earlier 6.0.x versions.
 
6.0.43 and earlier 6.0.x versions.
 
5.14.25 and earlier 5.14.x versions.
 
5.14.25 and earlier 5.14.x versions.
Line 77: Line 87:
 
Most earlier versions are also supported for direct upgrade, going back to 3.1.0.
 
Most earlier versions are also supported for direct upgrade, going back to 3.1.0.
  
−
</syntaxhighlight>check the lowest release needed  is available<syntaxhighlight>
+
</syntaxhighlight>
 +
 
 +
or  5.10.25
 +
https://community.ui.com/releases/UniFi-Network-Controller-Stable-5-10-25/fc76945d-c918-4d8d-8cd1-094d05287f45
 +
<syntaxhighlight>
 +
    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.
 +
 
 +
</syntaxhighlight>
 +
 
 +
check the lowest release needed  is available<syntaxhighlight>
 
# wget https://www.ubnt.com/downloads/unifi/5.6.42/UniFi.unix.zip -O UniFi.unix.5.6.42.zip
 
# 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
 
--2021-01-12 15:15:16--  https://www.ubnt.com/downloads/unifi/5.6.42/UniFi.unix.zip
Line 97: Line 122:
  
 
</syntaxhighlight>then set your update release, and launch event to do the upgrade :<syntaxhighlight lang="bash">
 
</syntaxhighlight>then set your update release, and launch event to do the upgrade :<syntaxhighlight lang="bash">
−
# config setprop VersionToInstall 5.6.42
+
# config setprop unifi VersionToInstall 5.6.42
 
# signal-event smeserver-unifi-install
 
# signal-event smeserver-unifi-install
 
</syntaxhighlight>then finally update to desired version<syntaxhighlight lang="bash">
 
</syntaxhighlight>then finally update to desired version<syntaxhighlight lang="bash">
−
# config setprop VersionToInstall 6.0.43
+
# config setprop unifi VersionToInstall 5.10.25
 
# signal-event smeserver-unifi-install
 
# signal-event smeserver-unifi-install
 
</syntaxhighlight>
 
</syntaxhighlight>
Line 107: Line 132:
 
here are the available configurations:
 
here are the available configurations:
  
−
* access : default is local, you can set it to public to allow access from the outside network
+
* 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
 
* status : enabled
−
* TCPPort : 8080,8443,8880,8843
+
* TCPPorts : 8080,8443,8880,8843
−
* VersionToInstall: here is the version number you want to install. Default is usually the version number of the rpm, currently 5.6.30 for smeserver-unifi-5.6.30. But you can force to install another version, if needed
+
* 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.
−
=== Workaround ===
 
−
You might get the following warining in logs for mongodb
 
−
<syntaxhighlight lang="text">
 
−
WARNING: soft rlimits too low. rlimits set to 1024 processes, 4096 files. Number of processes should be at least 2048 : 0.5 times number of files
 
−
</syntaxhighlight>
 
−
 
 
−
the way to fix
 
−
<syntaxhighlight lang="bash" highlight="1" start="1" line="">
 
−
sed -i s/1024/2048/ /etc/security/limits.d/90-nproc.conf
 
−
</syntaxhighlight>
 
  
 
=== Bugs ===
 
=== Bugs ===
Line 139: Line 154:
  
 
<!-- Please keep there the template revision  number as is -->
 
<!-- Please keep there the template revision  number as is -->
−
==Requirements==
 
−
'''Operating System:'''
 
−
*Ubuntu Desktop / Server 14.04 or later (LTS Releases, 16.04 recommended)
 
−
*Debian 7 “Wheezy” or later (LTS Releases, 8 recommended)
 
−
*macOS Mavericks 10.9 or later (10.12 recommended)
 
−
*Windows 7 or later (10 recommended)
 
−
*Windows Server 2008 or later (2016 recommended)
 
−
'''CPU:''' x86-64 Processor (Intel / AMD x64 Processors)*
 
−
 
−
'''RAM:''' 1GB for Headless Servers; 2GB for GUI*
 
−
 
−
'''Network:''' 100Mbps Wired Ethernet*
 
−
 
−
'''HDD:''' Minimum 10GB free (20GB or more preferred)*
 
−
 
−
'''Java:''' Java Runtime Environment (JRE) 8
 
−
 
−
'''Web Browser:''' Google Chrome
 
−
 
−
'''MongoDB:''' version 2.6.10. (Mongo is offered bundled, so most users will not need to acquire separately. Some distros might use a slightly older version, but v2.6.10 is the one typicallybundled in the Windows/Mac packages, and hence what we will recommend here).
 
−
 
−
https://help.ubnt.com/hc/en-us/articles/115009221227-UniFi-Recommended-Minimum-System-Requirements
 
 
==Sources==
 
==Sources==
 
*https://community.ubnt.com/t5/UniFi-Wireless/Unifi-Controller-software-license/m-p/1744454#M194230
 
*https://community.ubnt.com/t5/UniFi-Wireless/Unifi-Controller-software-license/m-p/1744454#M194230
Line 168: Line 161:
 
*https://gist.github.com/olegslavkin/6120d931f56bd781a75e
 
*https://gist.github.com/olegslavkin/6120d931f56bd781a75e
 
*https://community.ubnt.com/t5/UniFi-Wireless/initial-set-up-cannot-connect-to-Unifi/td-p/747972
 
*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

Latest revision as of 05:51, 4 August 2022

Geographylogo.png Languages: 

English




unifi
NeedImage.svg
unifi logo
MaintainerUnnilennium
Urlhttps://wiki.contribs.org
Licenceproprietary
Category

Category you want

Tags wifi, ubnt, ubiquity, 


Maintainer

Jean-Philippe Pialasse

Version

Contrib 10:
Contrib 9:
smeserver-unifi
The latest version of smeserver-unifi is available in the SME repository, click on the version number(s) for more information.


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

  1. find the version you want to update to, and list of allowed to upgrade release from
  2. find your current version release, and update to the minimal needed release
  3. 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. Check there: https://www.ui.com/download/unifi/default/default/unifi-network-application-7168-debianubuntu-linux-and-unifi-cloud-key/

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:

No open bugs found.

Changelog

Only released version in smecontrib are listed here.

smeserver-unifi Changelog: SME 10 (smecontribs)
2022/12/26 Jean-Philippe Pialasse 5.6.30-5.sme
- fix execution bit again [SME: 12225]
2022/11/18 Jean-Philippe Pialasse 5.6.30-4.sme
- add execution bit [SME: 12225]
2022/10/22 Jean-Philippe Pialasse 5.6.30-3.sme
- 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]

- add to core backup [SME: 12027]
2018/03/09 Jean-Philipe Pialasse 5.6.30-1.sme
- initial release

Sources

Retrieved from "https://wiki.koozali.org/index.php?title=Unifi&oldid=41539"