Ubiquiti UniFi Controller 5 installeren op een Raspberry Pi 3B

Onlangs heb ik 2 Ubiquiti Access Points AC Pro geinstalleerd voor mijn thuisnetwerk. In dit artikel laat ik zien hoe je de Ubiquiti UniFi controller 5 installeerd op een Raspberry Pi 3B.

Helaas kon ik de controllersoftware niet op mijn NAS draaien, anders had ik dat gedaan. Om deze reden heb ik de UniFi controller op een Raspberry Pi 3b geinstalleerd.

Inmiddels is het netwerk met 2 Ubiquiti 8 poort (150 watt) Switches uitgebreid en ook deze heb ik gekoppeld aan de UniFi controller. De instructie is aangepast op 15 februari 2019 voor versie 5.10.17.

Benodigdheden

  • Raspberry Pi 3B
  • Raspberry behuizing
  • Micro SD kaartje (ik gebruik een 16 GB kaart, waarop Rasbian Pixel al geinstalleerd is)
  • Toetsenbord en muis (USB) 
  • HDMI kabel
  • HDMI monitor
  • Netwerkkabel (kan ook Wifi gebruiken)
  • Ubiquiti AC-Pro. 
  • Putty als SSH client. Download deze via de website https://www.putty.org/ 

 

Stappen

Bouwen Raspberry PI

Ik had een starterskit besteld bij SOS Solutions (https://www.sossolutions.nl/starterkit3bc-compleet).

Het is heel eenvoudig, het Raspberry moederbordje voorzichtig in de behuizing plaatsen, dit kan maar op 1 manier.

  1. Open de behuizing, plaats het moederbordje en druk deze voorzichting op zijn plek, plaats de deksel weer terug.
  2. Plaats het Micro SD kaartje in het daarvoor bestemde slot aan de onderkant.
  3. Sluit alle randapparatuur aan zoals, muis, toetsenbord en je monitor.
  4. Sluit de netwerkkabel aan, via Wifi kan ook, ik heb de netwerkkabel gebruikt.
  5. Sluit als laatste de stroomkabel aan (de Raspberry heeft geen aan en uit knop).

De Raspberry Pi start op en is daarna al klaar voor gebruik.
Deze instructie is getest met Raspbain Jessie (Pixel) (April 2017), UniFi 5.10.17.

 

Inloggen Raspberry Pi

De standaard inloggegevens voor je Raspberry Pi zijn:

Gebruikersnaam: Pi
Wachtwoord: Raspbian

 

Installeren Putty op je Windows PC

Download Putty via de website: https://www.putty.org/ 

Dubbel klik op het bestand nadat deze gedownload is. De rest van de stappen wijzen voor zich (Volgende, Volgende etc.).

 

Activeren SSH

Nadat de Raspberry Pi geinstalleerd is dien je SSH te activeren indien jij je Pi remote wil kunnen beheren. Log in op de desktop van je Pi, klik op het Startmenu en klik op Voorkeuren gevolgd door Raspberry pi Configuratie programma. Klik dan op het tabblad Interfaces en selecteer bij SSH de optie Aan (SSH staat default uitgeschakeld).

 

Toekennen vast IP adres

Is is verstandig om voor je Raspberry Pi een vast IP adres in te stellen, hoe dat gaat leg ik in dit hoofdstuk uit. Pas het dhcpconfig file aan /etc/dhcpcd.conf dat kan op de volgende manier:

Type de volgende code in, of kopier en plak de code in de SSH commandline.

sudo nano /etc/dhcpcd.conf 

Scrol naar het einde van het script en voeg de volgende regels toe:

interface eth0

static ip_address=192.168.0.2/24
static routers=192.168.0.1
static domain_name_servers=192.168.0.1

interface wlan0

static ip_address=192.168.0.2/24
static routers=192.168.0.1
static domain_name_servers=192.168.0.1


Sla het bestand op met de toetscombinatie <Ctrl> + <o> en sluit het bestand af via <Ctrl> + <x>.

Raspberry Pi zal nu elke keer opstarten met het IP Adres 192.168.0.2; Ik heb in dit voorbeeld niet het IP adres 192.168.0.1 gebruikt omdat deze gereserveerd is voor de router. Je kunt uiteraard elk ander IP adres gebruiken. Maar in dit voorbeeld kun je een IP Adres gebruiken in de reeks tussen 192.168.0.2 en 192.168.0.254.

Herstart je Raspberry via het Reboot commando:

sudo reboot

 

Bovenstaand kan ook via de grafische interface gedaan worden mocht je een volledig Lunix OS installeren (desktop variant).

  1. Klik hiervoor met je rechtermuis in de startbalk op de het icoontje met de pijltjes omhoog en omlaag en kies dan Wireless & Wired Network Settings. Selecteer naast Interface de optie eth0.
  2. Je kunt de optie Disable IPv6 aanvinken indien je geen gebruik maakt van IPv6.
  3. Type bij IPv4 het gewenste IP Adres in.bijvoorbeeld 192.168.0.2.
  4. Type bij Router het IP Adres van je Router in.
  5. Type bij DNS Server het IP Adres van je Router in.
  6. Type bij DNS Search bijvoorbeeld het IP Adres van Google in 8.8.8.8
  7. Klik op Toepassen en dan Sluiten. Start je Pi opnieuw op.
  8. Klik hiervoor op het startmenu en kies de optie Shutdown en klik dan op Reboot.
  9. De Pi wordt opnieuw opgestart.

De rest van de stappen doe ik via de SSH met Putty.
 

Updaten van Rasbian Pixel software 

Je doet er verstandig aan om je Rasbian software bij te werken zodat deze up-to-date is.

Log in op de Rasberry en start de command line of SSH shell (met Putty).

Kopieer onderstaand commando (of type deze over).

sudo apt-get update && sudo apt-get upgrade -y

Updaten van Raspberry Pi 3B firmware

Indien je de Raspberry wil voorzien van de meest recente firmware dan kun je de volgende commando;

sudo apt-get install rpi-update

Om de software kun je het volgende commando gebruiken:

sudo rpi-update

Installatie UniFi Controller

Zo laten we nu gaan installeren en upgraden! Onderstaande commando's zullen de repositories vernieuwen en upgraden van de eventueel bestaande installatie.

Betreft de noodzakelijke Java software:

sudo apt-get update && sudo apt-get upgrade

 

echo "deb http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main" | sudo tee /etc/apt/sources.list.d/webupd8team-java.list


echo "deb-src http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main" | sudo tee -a /etc/apt/sources.list.d/webupd8team-java.list


sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys EEA14886 

Na het invoeren van bovenstaande code kreeg ik deze melding in beeld, geen dirmngr:

geen drmngr

Oplossing is het installeren van drmng via het volgende commando:

sudo apt-get install dirmngr

Daarna heb ik de code opnieuw ingevoerd en toen ging het wel goed.

 

sudo apt-get update
 
sudo apt-get install oracle-java8-installer


Er komt eem venster in beeld, druk op OK gevolgd door YES.

 

Tot slot de installatie van de UniFi controller

Hieronder de commando's om de laatste stabiele versies van de UniFi controller te downloaden voor Debian (deze werkt ook voor Rasbian).

echo 'deb http://www.ubnt.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 06E85760C0A52C50


Je kunt de commando's kopiëren en plakken om te voorkomen dat er typefouten insluipen.

Installeer ten slotte UniFi door het uitvoeren van de volgende opdrachten:

sudo apt-get update

sudo apt-get install unifi

Er kan een melding in beeld komen, bevestig deze met J.
Dit neemt een paar minuten in beslag, maar zodra het klaar is, is de UniFi controller geïnstalleerd!

Ten slotte, om de UniFi controller sneller te maken, is het aanbevolen om het volgende pakket te  installeren. Betreft een pakket genaamd Haveged. Dat kan via deze opdracht:

sudo apt-get install haveged

 

Nu alles wat je hoeft te doen is verbinding maken met de Controller via browser:

https://192.168.1.2:8443

 

Je kunt nu inloggen en starten met het instellen van de controller, dat gaat via de  volgende loginpagina. 

UniFi inlogvenster

Na het inloggen zie je het volgende scherm:

UniFi scherm na inloggen

 

Bronnen:

https://www.sossolutions.nl/starterkit3bc-compleet 

https://thepiguy.altervista.org/raspberry-pi-as-a-unifi-controller/ 

Onderstaand werkt op een Rasbberry Stretch.

https://lazyadmin.nl/home-network/installing-unifi-controller-on-a-raspberry-pi-in-5-min/  

Inmiddels gebruik ik een 2e Raspberry PI met daarop geinstalleerd Domoticz: http://www.domoticz.com/ hierop heb ik een weerstation geinstalleerd (online versie) en een P1 Slimme Meter.