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

High Level Design

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

  1. Install python3 pip package
    $ sudo apt install python3-pip
  2. Install packages from the requirements file.
    $ sudo pip3 install -r requirements.txt
  3. Change the Webex Teams bearer in usr_info.py.
  4. Run the application
    $ python3 app.py

Use

From any browser enter http://ip_address:5000 or http://localhost:5000

published

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.
View code on GitHub

Code Exchange Community

Get help, share code, and collaborate with other developers in the Code Exchange community.View Community
Disclaimer:
Cisco provides Code Exchange for convenience and informational purposes only, with no support of any kind. This page contains information and links from third-party websites that are governed by their own separate terms. Reference to a project or contributor on this page does not imply any affiliation with or endorsement by Cisco.