Cisco MAC Tracer

Trace a host MAC address through Cisco access switches

• This Script works only for L2 Cisco Access Switches
• First step the Script will ask if you want to Collect MAC address table from L2 Cisco Access Switches.
• If yes then a list of all interfacess that are not configured as Access port (such as Trunk, Port-channel, etc...) will be place for each device
• The Previous list will be used to extract MAC address table for Interfaces configured as Access only.
• Each MAC address table output will be save in a file with its device Hostname for searching process later.
• Then the Script will ask for a Host (PC, Printer, or any end device) IP address
• The IP address will be used in Router ARP table to get its MAC address.
• A Searching process will start with each ouput file to find the exact interface that match the wanted MAC address
• After that you will be asked if you want to access L2 Switch containing the extracted MAC address and show run int (connected)

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites:

• Linux OS (Recommended for Ubuntu 18.04)
• Python >=3.5 (pre-installed)

python3 --version

• SSH enabled and tested (connectivity)

ssh cisco@192.168.1.10

Installing:

• Download the repository into a directory

git clone https://github.com/omarthe95/Cisco-MAC-Tracer.git

• Run setup.sh note: last step the script will ask you if you want to delete the setup (downloaded) directory, no mater if you delete it or not after finishing the setup process you will be able to run the script from any where, because it will be placed in (/home/bin/) directory.

bash setup.sh

• Edit L3 Cisco Routers (Gateway devices) IPaddress_Routers.txt file with your own management IP address, each device IP per line

nano IPaddress_Routers.txt

• Edit L2 Cisco Switches IPaddress_Switches.txt file with your own management IP address, each device IP per line

nano IPaddress_Switches.txt

• You may change the access credentials inside each python script individually, because the default access credentials into network devices is cisco:Cisco123

Running the Scripts

We will start each step with GIF

Project-1.py

Running the Script from any where (directory) is possible because of setup file

Project-1.py

MultiThreading vs. Asynchronous

Authors

• Omar Adil - Network Engineer - Linkedin

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

Kirk Byers
Python for Network Engineers
https://pynet.twb-tech.com