Cisco Catalyst to Meraki MS Migration tool
This tool built to migrate Cisco Catalyst configuration of WC-29xx models to Meraki Switching line (MS). Currently, the tool is only covering the downlinks.
Below is the list of configurations the tool can read and migrate:
- Switch stack configuration (up to 8 switches)
- Interface description
- Interface type (Access / Trunk)
- VLANS allowed through the trunk interfaces
- Data VLAN
- Voice VLAN
- Port security
- MAC whitelist
- Enable / disable ports
After the configuration pushed to Meraki dashboard, the script will send a Webex Teams message with the summary of configured ports and the ones are not.
Solution Components
Once the python script is running, the below UI will be accessable to enter the required details to migrating the Catalyst configuration to Meraki MS.
Configuration
Obtain Meraki API key
Meraki API write Key is needed to allow the transfer of the configuration. Obtain Meraki API key here.
Cisco Catalyst show run
A show run of the Cisco Catalyst configuration needs to be uploaded to the tool, so make sure to keep the latest copy saved and it needs to be in txt format.
WEBEX_TEAMS_BEARER
Webex Teams bot is needed to get notification after finishing the migration. Create one here.
Installation
- Install python3 pip package
$ sudo apt install python3-pip
- Install packages from the requirements file.
$ sudo pip3 install -r requirements.txt
- Change the Webex Teams bearer in
usr_info.py
.
- Run the application
Use
From any browser enter http://ip_address:5000 or http://localhost:5000
Use Case
While Cisco Meraki offers an excellent dashboard for our end customers to manage Meraki products from easily, there is always a challenge for customers to move from what they currently familiar with to a new platform.
This tool helps customers to migrate Cisco Catalyst configuration to Meraki without the need to perform any copy/paste or even physically connect to any device. This tool helps in:
- Reducing human errors while migrating the config across
- Dynamically move parts of the configuration that might need manual copy/paste if you use the Meraki dashboard like description and MAC whitelisting.
Below is the list of configurations the tool can read and migrate:
- Switch stack configuration (up to 8 switches)
- Interface description
- Interface type (Access / Trunk)
- VLANS allowed through the trunk interfaces
- Data VLAN
- Voice VLAN
- Port security
- MAC whitelist
- Enable / disable ports
After the configuration pushed to Meraki dashboard, the script will send a Webex Teams message with the summary of configured ports and the ones are not.
Features to be added to the code later:
- Configure the uplink
- Link aggregation
- SNMP
- Hostname
- ssh to the Cisco Catalyst and allow the script to capture the running configuration
Business Summary
This tool helps customers/partners to migrate Cisco Catalyst configuration to Meraki without the need to perform any copy/paste or even physically connect to any device. This tool helps in: Reducing human errors while migrating the config across, Dynamically move parts of the configuration that might need manual copy/paste if you use the Meraki dashboard like description and MAC whitelisting.