Een bestaande UniFi installatie migreren naar Nexxwave

Een migratie van je bestaande UniFi Network Application naar een nieuwe server die wij voor jou beheren kan op meerdere manieren gebeuren. Wij stellen enkele manieren voor zodat je de stappen eenvoudig kan volgen.

Een migratie via backup/restore

Bij dit proces zal je een export nemen van je huidige UniFi installatie en deze importeren op je nieuwe UniFi server. We maken hierbij gebruik van je eigen, bestaande, domeinnaam.

Een andere manier om een migratie uit te voeren is via site-migratie. Meer weten? Neem dan een kijkje op onze site-migratie handleiding.

Aandachtspunten

Voorbereiding

Controleer je firewall

Je nieuwe UniFi server is voor je apparaten bereikbaar via IPv4 en IPv6. Controleer deze firewall instellingen:

Controleer of alle beheerde UniFi apparaten verbinding kunnen maken met je nieuwe UniFi server op deze poorten:

Om je nieuwe UniFi server te beheren, dan heb je deze uitgaande poorten nodig:

Als je het gastenportaal gebruikt, dan heb je deze uitgaande poorten nodig:

Het is perfect mogelijk om je firewall instellingen te beperken tot het IP adres van je nieuwe UniFi server. Let op dat je zowel het IPv4 als het IPv6 adres in je firewall configureert. Beide IP-adressen kan je eenvoudig achterhalen door een ping te sturen naar je nieuwe UniFi server (die kan je terugvinden in je welkomstmail). Bijvoorbeeld:

ping -4 clnXXX-prd-unifi00X.nexxwave.net
ping -6 clnXXX-prd-unifi00X.nexxwave.net

Controleer je DNS beheer

Je zal het DNS record wat verwijst naar je huidige UniFi installatie moeten aanpassen. Controleer of je dit zelf kan doen, of dat je dit moet aanvragen bij je DNS beheerder.

Controleer de versie van je huidige UniFi installatie

Het importeren van een back-up kan enkel gebeuren wanneer de versies van beide installaties overeen komen of wanneer de server waarvan je migreert ouder is. We raden aan om je huidige UniFi installatie naar dezelfde versie te updaten als de huidige versie wat wij op dit moment aanbieden. De huidige versie wat wij gebruiken vind je op deze pagina.

De migratie uitvoeren

DNS TTL record aanpassen

Je apparaten vinden jouw huidige UniFi installatie via zijn DNS hostname. Het IP-adres van deze hostname ga je in de volgende stap aanpassen. Om ervoor te zorgen dat je apparaten deze wijziging zo vlug mogelijk opmerken, raden we aan om de TTL (Time To Live) van je huidig DNS record zo laag mogelijk te zetten, bijvoorbeeld op 5 minuten of minder.

Wacht minimaal 24u (of indien mogelijk 48u) om door te gaan naar de volgende stap. Zo is er voldoende tijd om deze wijzigingen overal laten door te vloeien. Doe deze DNS aanpassing bijvoorbeeld op een vrijdag zodat je maandag de migratie kan starten.

Exporteer je configuratie

Je huidige UniFi installatie exporteer je via Settings > Backup. Download een back-up.

image.png

Voer vanaf dit punt geen aanpassingen aan je configuratie meer uit, want deze worden dan niet mee geëxporteerd naar je nieuwe UniFi server.

Instellen of aanpassen van het DNS CNAME record

Voer deze stap pas uit wanneer je volledig klaar bent voor de migratie. Je apparaten gaan na deze aanpassing hun verbinding met de huidige UniFi installatie verliezen.

Best plan je deze stap samen met ons in, want wij moeten een nieuw TLS/SSL certificaat voor jouw hostname aanvragen en op jouw nieuwe UniFi server importeren. Stuur hiervoor een e-mail naar help@nexxwave.be en we spreken een dag en tijdstip af.

Voeg in het DNS beheer van jouw domein een CNAME-record toe wat verwijst naar de hostname van jouw nieuwe UniFi server. Mogelijk moet je eerst je huidig A-record verwijderen. De hostname van je nieuwe UniFi server kan je terugvinden in je welkomstmail. We raden aan om de TTL ook nog even zo laag mogelijk te houden. Moest er onverhoopt iets fout gaan, dan kan je vrij vlug terug omschakelen. Bijvoorbeeld:

unifi.jouworganisatie.net   300   IN   CNAME   clnXXX-prd-unifi00X.nexxwave.net

Meld ons dat je DNS instelling werd gewijzigd

Nu je hostname verwijst naar je nieuwe Nexxwave UniFi server, kunnen wij je nieuw TLS/SSL certificaat aanvragen. Contacteer ons op help@nexxwave.be en wij zorgen hier zo spoedig mogelijk voor.

Importeer je configuratie

Zodra je DNS bijgewerkt is en je TLS/SSL certificaat actief is, dan kan je surfen naar je eigen hostname, bijvoorbeeld https://unifi.jouworganisatie.net. Daar zal je verwelkomt worden met het UniFi welkomstscherm. Je kan hier je geëxporteerde configuratie uploaden.

Zodra je configuratie geüpload is, zal je doorgestuurd worden naar het aanmeldscherm. Navigeer naar de 'devices' en volg op of alle apparaten terug online komen; afhankelijk van het aantal devices kan dit een tijdje duren.

Nazorg

Het kan even duren voordat alle apparaten terug online verschijnen. Moest een apparaat niet online komen, log dan via SSH op het apparaat in en adopteer het opnieuw via set-inform. Bijvoorbeeld:

set-inform http://unifi.jouworganisatie.net:8080/inform

DNS TTL record aanpassen

Wanneer je overtuigd bent dat de migratie geslaagd is, dan kan je de TTL van je CNAME record opnieuw verlengen. Bijvoorbeeld naar 1 uur:

unifi.jouworganisatie.net   3600   IN   CNAME   clnXXX-prd-unifi00X.nexxwave.net

Een migratie via site-migratie

Bij dit proces zal je een export nemen van je huidige UniFi sites en deze importeren op je nieuwe UniFi server. We maken hierbij gebruik van een eigen nieuw subdomein of een gratis subdomein van Nexxwave.

Een andere manier om een migratie uit te voeren is via backup/restore. Meer weten? Neem dan een kijkje op onze backup/restore handleiding.

Als voorbeeld gaan we in dit artikel deze domeinnamen gebruiken:

Aandachtspunten

Voorbereiding

Controleer je firewall

Je nieuwe UniFi server is voor je apparaten bereikbaar via IPv4 en IPv6. Controleer deze firewall instellingen:

Controleer of alle beheerde UniFi apparaten verbinding kunnen maken met je nieuwe UniFi server op deze poorten:

Om je nieuwe UniFi server te beheren, heb je deze uitgaande poorten nodig:

Als je het gastenportaal gebruikt, dan heb je deze uitgaande poorten nodig:

Het is perfect mogelijk om je firewall instellingen te beperken tot het IP adres van je nieuwe UniFi server. Let op dat je zowel het IPv4 als het IPv6 adres in je firewall configureert. Beide IP-adressen kan je eenvoudig achterhalen door een ping te sturen naar je nieuwe UniFi server (die kan je terugvinden in je welkomstmail). Bijvoorbeeld:

ping -4 clnXXX-prd-unifi00X.nexxwave.net
ping -6 clnXXX-prd-unifi00X.nexxwave.net

Controleer je DNS beheer

Je zal een nieuw record in je DNS beheer moeten configureren. Controleer of je dit zelf kan doen, of dat je dit moet aanvragen bij je DNS beheerder.

Controleer de versie van je huidige UniFi installatie

Het migreren kan enkel gebeuren wanneer de versies van beide installaties overeen komen of wanneer de server waarvan je migreert ouder is. We raden aan om je huidige UniFi installatie naar dezelfde versie te updaten als de huidige versie wat wij op dit moment aanbieden. De huidige versie die wij gebruiken vind je op deze pagina.

Je DNS configureren

Gebruik je een Nexxwave subdomein? Dan maken wij het DNS record voor jou aan. Je kan rechtstreeks doorgaan met de volgende stap om je nieuwe UniFi server te configureren.

Nieuw DNS record aanmaken

Voeg in het DNS beheer van jouw domeinnaam een CNAME record toe dat verwijst naar de hostname van jouw nieuwe UniFi server. Dat adres kan je terugvinden in je welkomstmail. Bijvoorbeeld:

unifi.jouworganisatie.net   3600   IN   CNAME   clnXXX-prd-unifi00X.nexxwave.net

Meld ons dat je DNS record aangemaakt werd

Nu je nieuw subdomein verwijst naar je nieuwe Nexxwave UniFi server, kunnen wij je nieuw TLS/SSL certificaat aanvragen. Geef ons een seintje op help@nexxwave.be en wij zorgen hier zo spoedig mogelijk voor.

Je nieuwe UniFi server configureren

Zodra je TLS/SSL certificaat geactiveerd is, dan kan je surfen naar je nieuwe controller. Bijvoorbeeld unifi.jouworganisatie.net. Je wordt verwelkomt door het UniFi welkomstscherm. Doorloop deze installatiestappen. De opties voor het toevoegen van een (draadloos) netwerk kan je overslaan.

De UniFi server is nu nog helemaal leeg. In de volgende stappen gaan we alle sites importeren waarbij alle site-instellingen teruggeplaatst worden. Maar eerst kan je nu enkele algemene basisinstellingen van je UniFi configuratie instellen.

  1. Navigeer naar Settings > System.
  2. Pas de 'Device Name' aan.
  3. Vink het vakje 'Multi-Site Management' aan.
  4. Klik onderaan op 'Apply Changes'.

image.png

De site-migratie uitvoeren

Om zeker te zijn dat je onderstaande handelingen uitvoert op je oude of je nieuwe UniFi server, raden we aan om beide installaties in een apart webbrowser venster te openen en bij iedere handeling steeds de URL te controleren.

Log in op je huidige controller, bijvoorbeeld controller.jouworganisatie.net, en open de site die je wilt migreren.

Klik op Settings > System.

Klik op 'Export Site'.

Klik op 'Download the Site Export File' en bewaar het bestand op je computer.

Klik op 'Continue'.

image.png

Log in op je nieuwe controller, bijvoorbeeld unifi.jouworganisatie.net.

Geef een de sitenaam op, we raden aan om dezelfde sitenaam te gebruiken.

Selecteer het bestand dat je zonet bewaard hebt en klik op 'Import'.

image.png

Navigeer terug naar je oude controller.

Je ziet nu het venster 'Migrate Site'. Klik op 'Continue'.

image.png

Geef de hostname van je nieuwe controller op, bv. unifi.jouworganisatie.net en vink alle devices aan en klik op 'Migrate Devices'.

Triple check de schrijfwijze van de domeinnaam. Je oude UniFi installatie zal een set-inform commando sturen naar alle geselecteerde apparaten. Als je een typefout maakt, dan zullen je apparaten de nieuwe UniFi server niet vinden.

image.png

In het volgend venster kan je kiezen om de gemigreerde devices op je oude controller te verwijderen. We raden aan om dit te skippen en ze later manueel te verwijderen.

Controleer op je nieuwe UniFi server of de gemigreerde toestellen geadopteerd worden. Dit kan enkele minuten duren.

Herhaal deze stappen voor iedere site wat je wilt migreren.

Als een toestel niet online komt of als je in de stap 'Migrate Devices' een typefout gemaakt hebt, log dan via SSH op het apparaat in en adopteer het opnieuw via het set-inform commando. Bijvoorbeeld:

set-inform http://unifi.jouworganisatie.net:8080/inform