Background Image

Blog Post

Mar 01

Cisco AP Migration Tool - Part 2

Cisco WLAN Migration Tool

In this second article on how to seamlessly upgrade your Cisco WLC, we explore the migration process and how to use the free tool IPTel have built for the purpose.

If you've not see the other two articles in this series, you can catch up with the two links below - check the caveats, hints and tips before you start any upgrades:

Cisco AP Migration Tool Part 1: Exploration of HA and pre-requisites to seamless code upgrades

Cisco AP Migration Tool Part 3: Caveats, Hints and Tips on WLC code upgrades

Cisco AP Migration Process

There are caveats later in this blog – familiarise yourself with these – if you are unsure of what you are doing do not run this script on a live network. Practice in your lab environment until you are happy with the process.

Access the tool from the IPTel website – here’s the link:

You will need to make a choice when moving APs – do you upgrade the spare WLC to the new code and upgrade APs on their way over, or just do a straight move then upgrade the primary WLC and upgrade them on the way back. There’s pros and cons to each method.

At some point you need to upload the new WLC code to your controller – this can be done at any stage prior to, or after offloading all the APs.

A screen shot of the tool is shown below:



Prime AP Migration Tool – Entry Screen

The process is as follows:

Select the ‘Move AP Script’ radio button

Enter the ‘From’ details in the Controllers section (hostname and IP address of your current Primary WLC)

Enter the ‘To’ details for the spare / holding platform WLC to move the APs to

In the Access Points box, paste in a list of all your APs

Click the generate button

This will generate a list of commands to be pasted to the WLC GUI. When pasted into the GUI, APs will have the order of their Primary controller changed – the APs will then move to the secondary platform (as long as AP fallback is enabled on the controller they are moving from).

Once all APs are moved, you can upgrade the primary WLC (or HA if its in HA mode) without affecting any of the APs.

When you’re ready to move the APs back to the original WLC, simply follow the same process from the start.


To reduce the impact of the upgrade (speed up the process), pre-download the new AP image to the APs before moving them to a WLC that uses a different code version. Note that without a pre-download, APs will have to download the correct image then reload to boot that image when you move them between WLCs with different code versions! To do a pre-download, you need to download the new code onto the WLC but don't reboot onto it. You will then be able to pre-download that code to all APs (or a single AP at a time if you want to test) either via the GUI or the CLI.

Liability Disclaimer

We supply the tools on this website free of charge for the wireless community use. Note with all our tools the liability disclaimer – we do our best to make these tools as useful as we can, but accept no liability for their use or misuse:



Add Comment:
Please login or register to add your comment or get notified when a comment is added.