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: https://www.iptel.com.au/ap-migration-tool.html
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.
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: