run diagnostics cable ports

run diagnostics cable ports [port_list | all]

Description

Run cable diagnostics on a port or a set of ports on the switch. Diagnostics can be done only on copper ports and can't be run on extended BPE ports, stacking ports, or fiber ports.

Syntax Description

port_listSpecifies to run diagnostics on a given port or set of ports.
all Specifies to run diagnostics on all active ports.

Default

N/A.

Usage Guidelines

This command provides wired cable diagnostics using the Time Domain Reflectometry capability of the PHY chips. Cable diagnostics can be used to locate cable breaks for individual twisted pairs in copper cable interfaces. If no breaks are found, it reports "Ok" for the individual twisted pairs.

Example

The following example runs diagnostics on port 14:

 # run diagnostics cable ports 14
Do you want to continue cable diagnostics? (y/N) Yes
cablediag: 1.1.0.14


+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+                             C A U T I O N                             +
+   cablediag will momentarily interfere with traffic on active ports   +
+-----------------------------------------------------------------------+
+   Ports: 14                                                           +
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Collecting port cable diagnostic information may take a moment...
port 14: cable (4 pairs, length +/- 10 meters)
        pair A Ok, length 0 meters
        pair B Ok, length 0 meters
        pair C Ok, length 4 meters
        pair D Ok, length 4 meters
 

History

This command was first available in ExtremeXOS 22.5.

Platform Availability

This command is available on all platforms.