Trace Cables to Switchports with CDPR

Essential Open Source Network Administration Tools


1. Introduction
1.1. Document conventions
2. Install CDPR
2.1. Install MacPorts
2.2. Install CDPR
3. Use CDPR
4. Support Information

1. Introduction

Cisco Discovery Protocol Reporter (CDPR) is an application that uses the Cisco Discovery Protocol (CDP) to locate the Cisco switchport to which a host running CDPR is connected. It is very useful for performing network moves, adds, and changes since that frequently requires tracing data jacks to Ethernet switchports. Enter CDPR, which finds the switchport to which a given data jack is connected. Just as Cisco administrators use “show cdp neighbor” on Cisco switches to locate or test for adjacent switches, you may use CDPR running on a PowerBook or Macbook to locate the switch and switchport to which a given data jack is connected.

1.1. Document conventions

Here are the conventions used to distinguish Unix terminal window input and output.

%% Commands to be typed into a terminal window.
Command output to a terminal window.
File text.

2. Install CDPR

This section covers installing general support software required for Ntop.

2.1. Install MacPorts

You may install the MacPorts package manager with these instructions, which include instructions for installing XWindows (X11). Follow the instructions carefully and perform all non-optional steps.

2.2. Install CDPR

Perform this MacPorts' command to install CDPR. After the install finishes, CDPR is ready for use.

%% sudo port install cdpr

3. Use CDPR

Execute the cdpr command as the root user.

%% sudo cdpr

CDPR displays a menu of the network interfaces available as shown.

cdpr - Cisco Discovery Protocol Reporter
Version 2.2.1
Copyright (c) 2002-2006 - MonkeyMental.com

1. en0 (No description available)
2. en1 (No description available)
3. lo0 (No description available)
Enter the interface number (1-3): 1

Enter your interface selection. You may choose a wired or wireless interface.

Enter the interface number (1-3): 1

Now CDPR displays switch's hostname, TCP/IP address, and port description.

Using device en0

Waiting for CDP advertisement:

(default config is to transmit CDP packets every 60 seconds)

Device ID
   value:  Cisco-Marketing
Addresses
   value: 10.10.10.22
Port ID
   value:  GigabitEthernet0/5

4. Support Information

For more information see the help file /opt/local/share/doc/cdpr/README.