By Robert Keith
A discussion on documenting where each switch port is connected within the configuration of the switch to simplify managing racks of server hardware
Iron Networks Products: IronPOD Family of Products, Microsoft CPS
Hardware Components: Mellanox Switches, Cisco Switches, Cisco IOS Compliant Switches
Connection details where each switch port is connected can be difficult to maintain in all but the most static configurations.
A very useful place to have the switch cross-connection documentation is within the switch configuration itself.
When changes are made in the switch, the documentation can be updated at the same time with the same user interface used to manage the switch.
Each port has a “Description” field which can be used to document the usage of the switch port. This may include the server or device connected, or anything else desired.
When displaying the port details, the description will contain what device is connected.
COMMAND LINE INTERFACE
is the same for most switches which follow the Cisco IOS standard:
SHOW INTERFACE ETHERNET <port#>
In this case the description shows the switch port, the server name connected, and the port details on the server (Adapter 2 on the Left Side)
The SHOW INTERFACE command can also include filters.
So for example, displaying all the ports with details is cumbersome.
To list just the switch ports and corresponding connections, the CLI command does this:
SHOW INTERFACE ETHERNET | INCLUDE
In this example, we listed just the Compute Servers.
We could have listed every switch port by using the string “Description”.
Here we have listed only the connections on the servers on the second chassis cluster.
Naturally we can get creative and list only ports of specific device types, only devices plugged into Adapter #2, etc.
To enter this data manually from the CLI, use the following sequence:
- CONFIG TERMINAL
- INTERFACE ETHERNET <port#>
- DESCRIPTION <user specified text>