WLC Config Converter (AireOS, IOS-XE)

[Shankar Ramanathan]

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.

[Andy J]

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

[Shankar Ramanathan]

Hi Andy,

You can paste the translated config into c9800 CLI. Alternatively, you can also use the c9800 GUI>>Configuration>>AireOS Config Translator option to directly post your AireOS config file to apply translated changes via WebUI 

[Andy J]

I have a 3504 and bunch of stuff was erroring when I tried cut and paste.

[Shankar Ramanathan]

Are you trying to migrate to 3504 from another AireOS config ? If yes , then AireOS legacy to AireOS (3504) will not be direct plug and play . You would need to manually fix the encryption and port config on the highlighted sections of the configuration from the tool before pasting them into the 3504.

[Andy J]

5508 to 3504

[Kevin-H]

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.

[Shankar Ramanathan]

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

[Rich R]

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

[Shankar Ramanathan]

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

[anthonypriore]

I just tried to convert a 5508 to 5520 using the "Show Running-config" and a "TFTP" backup file and both have failed. The error returned is "The Input file is not an AireOS config file. Please collect the "show run-config commands" output from WLC".  Am I doing something wrong or is this not supported. I chose AIREOS -->AIREOS.

[Shankar Ramanathan]

Hi Anthony,

“Show run-config” is not a valid input . “Show run-config commands” or Tftp backup config should work . 

Pls use the feedback button in the tool so we can email you back requesting the logs you are trying to upload so we can test .

[lalitam]

Hi Shankar,

Can I use this tool to convert config of WLC 5508 to WLC 3504?

Kind Regards

Lalita

[Shankar Ramanathan]

Yes you can . Remember that AireOS(legacy) to AireOS(newer) conversion will only point the lines of encryption and port config that would need manual clean up .

[lalitam]

Hi Shankar,

I appreciate your quick response. I did not understand the statement, "conversion will only point the lines of encryption and port config that would need manual clean up .", which means the config will be completely converted? Need some manual config as well.

And the option to be selected is, AireOS--> AireOS(5520/8540) ?

Kind Regards

Lalita

[Scott Fella]

You will still need to manually add some config lines as it will not add anything that is hashed.