UniFi - Migrating Sites with Site Export Wizard


Overview


This article will explain in detail how to use the UniFi Site Export Wizard to quickly and easily export sites from one Controller (including configuration and devices) to another.

NOTES & REQUIREMENTS:
The Site Export Wizard is compatible with UniFi Controller versions 5.4.11 and above. 
The new Controller version (the one you will be migrating the site to) must be the same or newer than the original Controller's. 

Table of Contents


  1. Introduction
  2. Steps - How to Migrate a Site with the Site Export Wizard
  3. Related Articles

Introduction


Back to Top

The Site Export Wizard allows UniFi administrators to export sites from one UniFi Controller to be managed by a different or new UniFi Controller. This was previously possible with manual configuration, but the wizard offers a more convenient, and user-friendly way to do this. This process can work to/from any type of UniFi Controller including locally hosted Controllers, Cloud Keys, and UniFi Cloud Controllers, so long as Controller version is 5.4.11 or later.

The migration process is virtually seamless, with a downtime of about a minute as devices provision and a few minutes for devices to appear in the new controller between steps 10 and 11 when changing the "inform URL". 


How-to/Instructions


Back to Top

NOTE: To minimize complications, make sure to complete every step of the process and to not skip any steps. Please verify that the new Controller version (the one you will be migrating the site to) is the same or newer than the original Controller's.

To get started, open the Controller and site that is to be exported.

1. Go to Settings > Site

UniFi.png

2. Select the gray “Export Site” button in the bottom-right of the page. This will initiate the wizard.

UniFi_and_UniFi_-_Migrating_Sites_with_Site_Export_Wizard.png

3. In the first step, click “Download Backup File” to download the file that contains the site configuration to be imported into the Controller you are migrating to.

4. Next, import this site into the new controller. To do so, open up the second controller web UI, click “Current Site - (Site Name)” in top-right of the display. Within this drop-down box select “Import Site” as shown:

UniFi.png

5. The site input will need a name (it does not have to match the original site name). Once the site has been named, select “Choose file” and select the backup file that was just downloaded i.e. "5.9.29_default.unf"

6. Once the import has finished, a confirmation that the site was imported will appear. Once the import step has been completed, go back to the export controller and click "confirm".

7. Once import step has been completed (step 5) click "Confirm".

The following steps will migrate the devices. To do so:

8. First, find the URL or IP of the destination Controller. In this case, the new controller has an IP of 192.168.1.8. So that is what is entered into the "Custom Inform URL" input field.

9. Next, select the devices that are to migrated over by clicking the boxes next to one otherwise select the entire group.

10. Click “Migrate Devices”.

11. As the last step verify that all devices are connected to the new controller and are visible on the devices page. Note this may take a few minutes. Once verification of the devices showing "connected" in the new controller site select "forget devices". 

IMPORTANT: Verify that the devices are visible and appear as connected in the new Controller's Devices section before clicking Forget Devices.

Once the site export wizard has completed with success, the devices will be configurable in the new controller. At this time, unless the site was a default site, it should be safe to remove the site from the previous controller. 


Related Articles


Back to Top

UniFi - How to Create and Restore a Backup

UniFi - Advanced Adoption of a "Managed By Other" UAP

UniFi - Device Adoption Methods for Remote UniFi Controllers


We're sorry to hear that!