topic Great, Thanks for this. in Wireless

WLC Config Converter (AireOS, IOS-XE)

Shankar Ramanathan — Fri, 08 Jul 2022 13:33:34 GMT

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:

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.
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
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
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
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:

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

Great initiative Shankar

Rasika Nayanajith — Wed, 08 Jun 2016 20:16:56 GMT

Great initiative Shankar

Great, Thanks for this.

Ben Skinner — Thu, 16 Jun 2016 01:35:06 GMT

Great, Thanks for this.

Worked great in the Lab

Hi Shankar,

Jason Horne — Wed, 14 Sep 2016 12:59:02 GMT

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.

Is this tool still working?

chrisaoyagi — Fri, 14 Jul 2017 14:44:59 GMT

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.

Mon, 17 Jul 2017 14:47:52 GMT

I've the same problem.

Shankar Ramanathan — Mon, 17 Jul 2017 15:51:31 GMT

"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

chrisaoyagi — Mon, 17 Jul 2017 20:24:04 GMT

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

Hello! When will this support

sclements — Fri, 28 Jul 2017 21:30:51 GMT

Hello! When will this support the 3504?

-Sam

Hi Sam,

Shankar Ramanathan — Fri, 28 Jul 2017 21:34:13 GMT

Hi Sam,

Specifically what conversion are you looking for 3504?

AireOS -> AireOS - ideally

sclements — Fri, 28 Jul 2017 21:38:01 GMT

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

-Sam

Will test if there are any

Shankar Ramanathan — Fri, 28 Jul 2017 21:41:36 GMT

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

Re: Will test if there are any

Shankar Ramanathan — Tue, 19 Sep 2017 17:23:51 GMT

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

Re: WLC Config Converter

Kevin-H — Thu, 21 Sep 2017 18:26:38 GMT

Hello is there road map item to add support to convert ACL's between IOS & AireOS formats?

Honestly I think that's more useful than converting WLAN's, because it doesn't take too long to manually re-create WLAN's in either platform, but it takes forever to create ACL in AireOS, whether you do it via GUI or CLI.

Re: Will test if there are any

Andy J — Wed, 19 Dec 2018 20:16:40 GMT

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.

Re: WLC Config Converter

Shankar Ramanathan — Wed, 19 Dec 2018 20:18:24 GMT

This feature should now be available for the AireOS to Cat 9800 IOS-XE conversion

Re: Will test if there are any

Shankar Ramanathan — Wed, 19 Dec 2018 20:19:04 GMT

Yes.

Re: WLC Config Converter

Rich R — Fri, 21 Dec 2018 15:04:20 GMT

So 9800 is supported? (even though it's not mentioned at all in the descriptions)

Re: WLC Config Converter

Shankar Ramanathan — Fri, 21 Dec 2018 16:10:13 GMT

Yes AireOS to c9800 conversion is now supported and the description will be updated shortly

Re: Will test if there are any

Andy J — Mon, 14 Jan 2019 21:50:00 GMT

What is the best method to get the new converted config onto the new controller?