Spring naar de hoofdinhoud

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:

  • controller.jouworganisatie.net = het huidige subdomein waarop je huidige UniFi installatie bereikbaar is.
  • unifi.jouworganisatie.net = het nieuwe subdomein wat je gaat gebruiken voor je nieuwe UniFi server.

Aandachtspunten

  • Het is belangrijk dat alle toestellen de nieuwe UniFi server kunnen bereiken via een bestaande DNS hostname zoals bijvoorbeeld unifi.jouworganisatie.net.
  • Voor een site-migratie heb je een nieuw (sub)domein nodig omdat er gelijktijdig twee UniFi servers langs elkaar draaien. Dit kan een (sub)domein van jezelf zijn of een subdomein van Nexxwave.
  • De migratie gebeurt site-per-site, je kan dit niet in bulk doen.
  • Er kunnen meerdere bestaande UniFi installaties naar je nieuwe UniFi server gemigreerd worden.
  • In de 'nieuwe' UniFi interface is er nog niet de mogelijkheid om sites afzonderlijk te importeren. Daarom doen we een export een import nog via de 'legacy' interface.

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:

  • 3478/UDP - STUN
  • 8080/TCP - Applicatie communicatie

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

  • 8443/TCP - UniFi web-interface GUI
  • 6789/TCP - Mobile speed test

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

  • 8880/TCP - HTTPS omleiding
  • 8843/TCP - Gastenportaal

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 watdie wij gebruiken vind je op deze pagina.

Activeer de 'legacy' interface

Het importeren van site werkt voorlopig enkel in de 'legacy' UniFI interface en nog niet in de 'nieuwe' interface. Schakel daarom even terug naar de 'legacy' interface:

  1. Ga naar de instellingen.
  2. Klik op 'System'.
  3. Vink 'Enable' aan bij 'Legacy Interface'.

image-1653304007218.png

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 watdat 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 > Controller.System.
  2. Pas hier de 'ControllerDevice Name' aan en geef bij 'Controller Hostname/IP' je nieuw subdomein op (bijvoorbeeld unifi.jouworganisatie.net).aan.
  3. GeefVink indienhet gewenst ook je bestaande Google Maps API Key en mailserver gegevens in.
  4. Check verder of je aanpassingen wilt aanbrengen aan bv. devakje 'UserMulti-Site Interface',Management' of 'Backup' instellingen.aan.
  5. Klik onderaan op 'Apply Changes'.

image.png

De site-migratie uitvoeren

Om je nietzeker te vergissenzijn ofdat 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 navigeer naar de instellingen vanopen de site watdie je wilt migreren.

  1. Klik helemaal onderaan op deSettings knop> System.

    Klik op 'Export site'Site'.

  2. Klik in de pop-up op de knop 'Download backupthe file'.

    3. Site
  3. GeefExport ditFile' en bewaar het bestand eenop duidelijkeje naam,computer.

    bijvoorbeeld

    Klik deop naam'Continue'.

    van

    image.png

    de site.
    2021-10-04_15-47.png

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

  5. Klik bovenaan rechtslinks op 'Currenthet site'site-icoontje en vervolgensklik daarna op 'Import site'Site'.
    2021-10-04_15-52.png

  6. Geef een de sitesitenaam eenop, naam. Wewe raden aan om dedezelfde naam hetzelfdesitenaam te houdengebruiken.

    als op de oude UniFi installatie.
  7. Klik op 'Choose file' en selecteer

    Selecteer het bestand watdat je daarnetzonet geëxporteerdbewaard hebt.hebt Hiermeeen importeerklik jeop de'Import'.

    site

    image.png

    configuratie.
  8. Ga

    Navigeer terug naar je oude installatiecontroller.

    en

    Je klikziet innu dehet stapvenster 'Migrate site'Site'. Klik op de knop 'Confirm'Continue'.

    2021-10-04_15-57.pngimage.png

  9. Geef in de staphostname 'Migratevan devices' deje nieuwe domeinnaamcontroller op.op, Bijvoorbeeldbv. unifi.jouworganisatie.net.net Deen poort blijft ongewijzigd '8080'.

  10. Selecteervink alle toestellendevices wat je wilt migrerenaan en klik op de knop 'Migrate devices'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.

2021-10-04_15-59.pngimage.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. Zodra alle toestellen geadopteerd zijn, kan je in de laatste stap 'Migrate devices' de gemigreerde toestellen 'vergeten'. Je kan dit ook gerust overslaan en na afloop alle sites verwijderen.

Herhaal deze stappen voor iedere site wat je wilt migreren.

MoestAls een toestel niet online komenkomt of hebals je in de stap 'Migrate devices'Devices' een typefout gemaakt,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


Terug naar boven