Migrating UniFi APs to another controller

Defaut template

Migrating UniFi APs to another controller



Print

Migrating UniFi APs to another controller

You can easily adopt your access points to a new controller.  Follow these steps to automatically migrate.

Prerequisites

  • The new controller must be online and accessible via the internet
  • You must be on the latest controller version
  • The APs you wish to migrate must be connected (online)

Steps overview

Follow the steps very carefully.  The basic steps are:

  1. Export a backup file from the controller (UNF file)
  2. Import that file  onto the new controller
  3. Initiate the migration from the old controller
  4. Check they have correctly provisioned on the new controller
  5. Remove device footprints from the old controller (“Forget” the APs)

1. Click settings

mceclip0.png

2. Scroll to the bottom and choose EXPORT SITE

mceclip1.png

3. Click DOWNLOAD BACKUP FILE

mceclip2.png

4. On the destination controller, choose IMPORT SITE

mceclip3.png

5. Choose a site name

mceclip4.png

6. Click CHOOSE FILE and select file you downloaded from the old controller

This will import all settings, including the Access Points.  However at this stage they will show disconnected, since we have not migrated them yet.

We are now ready to initiate the migration.

7. On the old controller Click Confirm

mceclip5.png

8. Enter the full URL of your new controller

mceclip6.png

If you have ever manually adopted APs using SSH, you will recognise the /inform command at the end.

Be sure to enter 8080, not the controller interface port which is on 8443

9. Click MIGRATE DEVICES

mceclip7.png

IMPORTANT: Wait for the APs to migrate fully to the new server.  DO NOT click Forget Devices until you can see them correctly provisioned on the new controller.

Table of Contents