cancel
Showing results for 
Search instead for 
Did you mean: 
cancel
68872
Views
68
Helpful
59
Replies

WLC Config Converter (AireOS, IOS-XE)

Shankar Ramanathan
Cisco Employee
Cisco Employee

 

WLC Config Converter (AireOS, IOS-XE)

 

External Link: https://cway.cisco.com/wlc-config-converter/ 

Goal of this tool is to provide easy config migration between various wireless platforms.One tool can perform following operations:

 

  1. AireOS(2500/3500/5500/7500/8500/WISM2) to Cat 9800 Wireless LAN Controller conversion: For folks looking to migrate from any AireOS platform to the latest Catalyst 9800 series Wireless LAN Controllers. Inputs required: TFTP config backup from AireOS or "show run-config startup-commands" output. Please refer Note below for more details.
  2. AireOS to IOS-XE(Converged Access) conversion: For folks looking to migrate from AireOS platforms 2500/3500/5500/7500/8500/WISM2/vWLC controllers to IOS-xe/Denali platforms 3650/3850/4500 S8E/5760. Inputs required: TFTP config backup from AireOS or "show run-config startup-commands" output Phase1: Only provide WLAN migration
  3. IOS-XE(Converged Access) to AireOS conversion: For folks looking to migrate from IOS-XE/Denali platforms 3650/3850/4500 S8E/5760 controllers to AireOS platforms 2500/3500/5500/7500/8500/WISM2/vWLC. Inputs required: "show running-config" output from IOS-xe/Denali based platforms Phase1: Only provides WLAN migration
  4. AireOS to AireOS(5520/8540) conversion: For folks looking to migrate from older AireOS platforms 2500/5500/7500/8500/WISM2/vWLC controllers to newer AireOS platforms 5520/8540. Inputs required: TFTP config backup from AireOS or "show run-config startup-commands" output
  5. AireOS(5520/8540) to AireOS conversion: For folks looking to migrate from newer AireOS platforms 5520/8540 controllers to older AireOS platforms 2500/5500/7500/8500/WISM2/vWLC. Inputs required: TFTP config backup from AireOS or "show run-config startup-commands" output

 

Usage:

 

1. Click on tool link: https://cway.cisco.com/wlc-config-converter

2. Upload the required input file 

3. Select the conversion option

4. Hit Run for the output

 

Note:

  1. For AireOS WLC's please do not confuse "show run-config startup-commands" output with "show run-config". Only"show run-config startup-commands" or TFTP config backup is a supported input format for AireOS migration.
  2. For Catalyst 9800 config migration – Please download the CFG file directly from the tool post-conversion and upload the translated .cfg file to 9800 "bootflash:”. Then execute: “copy bootflash: running-config>” on your WLC 9800 for config migration.

Release Notes Update (Sep 2020) for AireOS--> Cat 9800 Conversion:

 

------------------------------------------------------------------------
Fixes available in release 0.4.6 :
------------------------------------------------------------------------
1: Need to merge service-policy under policy-profile.
2: TACACS+ http auth was given group name instead of the method name.
3: wireless policy Profile description should not exceed 64 characters
4: Need to Move CCx configs ( l2raom rf-params Cli) to unsupported list
5: Client RSSI level value need to be modified
6: ip name-server config shows twice with same IP Address.
7: Need to remove name-server IP address config they have address 0.0.0.0
8: Need to add note or default manager user/password credentials for AP in ap-profile
9: line console timeout command is giving error
10: config database size, config mgmtuser telnet should be in not applicable category.
11: VLAN description name having "" command is failing when I apply this config on ewlc.
12: arptimeoout configuration command mapped to unmapped cli list.

------------------------------------------------------------------------

Fixes available in release 0.4.5 :

------------------------------------------------------------------------

1: prompt configuration should be avoided for C9800

2: user-name cli config have duplicate entries for type, privilege and password.

3: CTS SXP wrong replacement rule

4: IP helper add and dhcp ser in profile policy needs to remove when dhcp proxy is disable

5: Generate all the class map in single go for avc profile to avoid multiple airos config

6: Optimize class-map the qos-map migration one entry for the same user priority

7: SNMP community global configuration failed to unconfig

8: Need to add comments before enabling lag in ap-profile


------------------------------------------------------------------------
Release: 0.4.4
------------------------------------------------------------------------


------------------------------------------------------------------------
Best practices:
------------------------------------------------------------------------
Please upload the following:
AireOS: "show run-config startup-commands" output or TFTP config backup
Please download the CFG file directly from the tool post conversion. Use C9800-GUI -> Configuration -> Services -> AireOS Config Translator to apply configuration on C9800.

Note:
1: Lines start with prefix "!$" need to be taken care before applying to C9800.
2: Lines start with prefix "!%" have note and sample examples, about feature and steps to follow.


------------------------------------------------------------------------
Fixes available in release 0.4.4 :
------------------------------------------------------------------------
1: "wireless autoqos policy-profile <> mode" need to be configure in exec mode.
2: regex markup "{mf_mac_delimiter}" not getting replaced with actual value.
3: Guide to configure mobility group name
4: SNMP trapflags
5: Uncomment exit in radius config and add exit for TACACS config
6: Need shut VLAN first after that we have to make unshut
7: MDNS gateway need to be configured globally prior to interface Vlan.
8: MDNS gateway config added by default for all interfaces
9: TACACS server multiple time with same address
10: Existing the submode before executing next command

------------------------------------------------------------------------
Fixes available in release 0.4.3 :
------------------------------------------------------------------------
1: config interface dhcp service-port disable
2: "ap country US" config coming twice.
3: "ip name-server" config coming multiple times.
4: "mdns-sd service-definition" config coming multiple times.
5: Service policy config issue under mdns-sd gateway for a vlan
6: Flow monitor config issues.
7: Updated the not supported and not applicable list.
8: Unmapped trap flags categorized as unsupported.
9: SNMP syslocation, syscontact changes
10: Hostname max 16 chars
11: Guide to configure parameter-map.
12: Added the exit command for the ap profile, radius servers, site tag configs.
13: AP country list support was added.
14: ACL syntax issues.

59 Replies 59

Great initiative Shankar

Ben Skinner
Level 1
Level 1

Great, Thanks for this.

Worked great in the Lab

Jason Horne
Cisco Employee
Cisco Employee

Hi Shankar,

When I upload config from 5760's output from the show running-config command it just hangs.  I've tried it in Firefox, safari and Chrome.

chrisaoyagi
Level 1
Level 1

Is this tool still working?   I used it several months ago and it worked great, but I just tried and it tells me that "file failed to upload to cisco".     I was attempting to convert a tftp config from a 5508 to 5520. 

I've the same problem.

 

"Failed to upload files to Cisco" message is usually seen when there is a pop-up blocker in browser blocking the file upload. Can you pls relax the pop-up blocker rules for the tool website https://cway.cisco.com/tools/WirelessConfigConverter and try. Try alternate browsers too.

that worked, popups blocked in Chrome.   thanks Shankar!!!

sclements
Level 5
Level 5

Hello! When will this support the 3504?

  -Sam

Hi Sam,

Specifically what conversion are you looking for 3504? 

AireOS -> AireOS - ideally supporting *from* 2504, 5508, WiSM2 to 3504.

  -Sam

Will test if there are any issues with the current conversion logic as-is.. Pls expect an update next week on this topic..

sorry for delayed update on this. 3504 migration should work fine.

So I assume you mean that if we are going from a 5508 to 3504 we should use option 3.
3. AireOS to AireOS(5520/8540) conversion: For folks looking to migrate from older AireOS platforms 2500/5500/7500/8500/WISM2/vWLC controllers to newer AireOS  platforms 5520/8540.

Yes. 

Getting Started

Find answers to your questions by entering keywords or phrases in the Search bar above. New here? Use these resources to familiarize yourself with the community: