cancel
Showing results for 
Search instead for 
Did you mean: 
cancel
63060
Views
66
Helpful
55
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.

55 Replies 55

Great initiative Shankar

Ben Skinner
Beginner
Beginner

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
Beginner
Beginner

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
Contributor
Contributor

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: