Runs normal or extended diagnostics on the switch, slot, node, or management module. On the Summit family switches, this command also runs diagnostics on the stacking ports.
This command is not supported in stacking mode. But if you issue the show diagnostics command from the master node, it will show the diagnostic results for all the nodes.
extended | Runs an extended diagnostic
routine. Takes the ports offline, and performs
extensive ASIC and packet loopback tests on all of
the ports. BlackDiamond 8800 series switches only—If you have a Power over Ethernet (PoE) module installed, the switch also performs an extended PoE test, which tests the functionality of the inline power adapter. |
normal | Runs a normal diagnostic routine. Takes the ports offline, and performs a simple ASIC and packet loopback test on all of the ports. |
stack-port | Runs the diagnostic routine on
the stack ports. Note: This parameter is available only on Summit
family switches that are not operating in stacking mode.
|
slot | Specifies the slot number of
an I/O module. Note: BlackDiamond X8 switches only - The slot
argument is used to refer to both I/O and fabric modules.
Note: This parameter is available only on modular switches.
|
A | B |
Specifies which MSM/MM to run diagnostics on. A specifies the MSM/MM installed in slot A.B specifies the MSM/MM installed in slot B.Note: This parameter is available
only on modular switches.
|
N/A.
Depending on your platform, use this command to run diagnostics on the switch, slot, management module, or stack port.
If you run the diagnostic routine on an I/O or Fabric module, that module is taken offline while the diagnostic test is performed. The module does not forward traffic. Once the diagnostic test is completed, the I/O or Fabric module is automatically reset and becomes operational again. On a management module, the module is taken offline while the diagnostics test is performed. Once the diagnostic test is completed, the management module (MM) reboots, and becomes operational again.
After the switch runs the diagnostic routine, test results are saved in the module's EEPROM and messages are logged to the syslog. On an I/O or Fabric or MM module, the extended diagnostic routine can require significantly more time to complete.
If you run the diagnostic routine on an I/O module, that module is taken offline while the diagnostic test is performed. The ports on the module do not forward traffic. Once the diagnostic test is completed, the I/O module is automatically reset and becomes operational again.
After the switch runs the diagnostic routine, test results are saved in the module‘s EEPROM and messages are logged to the syslog.
On an I/O module, the extended diagnostic routine can require significantly more time to complete, depending on the number of ports on the module.
On a management module, the module is taken offline while the diagnostics test is performed. Once the diagnostic test is completed, the MSM reboots, and becomes operational again.
Note
BlackDiamond 8810 switch—If you run diagnostics on slots 5 and 6 with an MSM installed in those slots, the diagnostic routine tests the I/O subsystem of the MSM. BlackDiamond 8806 switch—if you run diagnostics on slots 3 and 4 with an MSM installed in those slots, the diagnostic routine tests the I/O subsystem of the MSM. BlackDiamond 8800 series switches—To run diagnostics on the management portion of the master MSM, specify slot A or B.If you run the diagnostic routine on the switch, it reboots and then performs the diagnostic test. During the test, traffic to and from the ports on the switch is temporarily unavailable. When the diagnostic test is complete, the switch reboots and becomes operational again.
To run the diagnostic routine on the stack ports, you need a dedicated stacking cable that connects stack port 1 to stack port 2, which are located at the rear of the switch. The stacking cable is available from Extreme Networks. The switch performs a hardware test to confirm that the stack ports are operational; traffic to and from the ports on the switch is temporarily unavailable. This Bit Error Rate Test (BERT) provides an analysis of the number of bits transmitted in error.
After the switch runs the diagnostic routine, test results are saved to the switch‘s EEPROM and messages are logged to the syslog.
To run diagnostics on a Summit switch that is in a SummitStack, first disable stacking on that switch, then restart the switch. Once restarted, log into the switch via its console port, and run diagnostics. The switch will perform the diagnostic tests and then restart. Once restarted, log into the switch via its console port and enable stacking, then reboot the switch. Once restarted, the switch will rejoin the stack.
To view results of the last diagnostics test run, use the following command:
show diagnostics {[cr] | slot [slot | A | B]}Note
The slot, A, and B parameters are available only on modular switches.If the results indicate that the diagnostic failed on a module, replace the module with another module of the same type.
If the results indicate that the diagnostic failed on the switch, contact Extreme Networks Technical Support.
The following example runs normal diagnostics on the I/O module installed in slot 2 :
run diagnostics normal slot 2
The switch displays a warning similar to the following about the impact of this test. You also have the opportunity to continue or cancel the test:
Running Diagnostics will disrupt network traffic. Are you sure you want to continue? (y/n)
Enter y to continue and run the diagnostics. Enter n to cancel the operation.
The following example runs normal diagnostics on the first Fabric module :
run diagnostics extended slot fm-1
The switch displays a warning similar to the following about the impact of this test. You also have the opportunity to continue or cancel the test:
Running Diagnostics will disrupt network traffic. Are you sure you want to continue? (y/n)
Enter y to continue and run the diagnostics. Enter n to cancel the operation.
The following example runs normal diagnostics on the MM-A :
run diagnostics extended slot a
The switch displays a warning similar to the following about the impact of this test. You also have the opportunity to continue or cancel the test:
Running Diagnostics will disrupt network traffic. Are you sure you want to continue? (y/n)
Enter y to continue and run the diagnostics. Enter n to cancel the operation.
Initializing operational diagnostics... Version 1.8 Image Release built by project BDX Management Module detected in slot A Board Rev : 0x0 FPGA Build : 0x14 FPGA Minor Rev : 0x 1 Running Diags in normal mode (0x 1) PCI unit 0: Dev 0xb842, Rev 0x01, Chip BCM56842_A0, Driver BCM56840_B0 SOC unit 0 attached to PCI device BCM56842_A0 Running Power On Self Test...(Normal) Test temperature start - PASS Test sdram - PASS Test boot flash - PASS Test internal cf card - PASS Test usb - PASS Test south bridge - PASS Test mgmt loopback - PASS Test nvram - PASS Test dump flash - PASS Test voltage check - PASS Test fpga reg - PASS Test fpga mem - PASS Test port loopback - PASS Test port snake - PASS Test asic0 mem - PASS Test asic0 reg - PASS Test temperature report - PASS Diagnostics passes! Current Time: Tue Jan 24 15:42:59 2012
The following example runs normal diagnostics on the I/O module installed in slot 2 of a BlackDiamond 8800 series switch:
run diagnostics normal slot 2
The switch displays a warning similar to the following about the impact of this test. You also have the opportunity to continue or cancel the test:
Running Diagnostics will disrupt network traffic. Are you sure you want to continue? (y/n)
Enter y to continue and run the diagnostics. Enter n to cancel the operation.
The following example runs normal diagnostics on the Summit family switch:
run diagnostics normal
The switch displays a warning similar to the following about the impact of this test. You also have the opportunity to continue or cancel the test:
Running Diagnostics will disrupt network traffic. Are you sure you want to continue? (y/n)
Enter y to continue and run the diagnostics. Enter n to cancel the operation.
The following command runs diagnostics on the stack ports on a Summit family switch:
run diagnostics stack-port
If you issue this command with a console connection, the switch displays the following information. You also have the opportunity to continue or cancel the test:
Summit Diagnostics Mode Enabled, Starting Diagnostics.... Found X440a-24T in Motherboard Motherboard CPLD Revision: 2 Starting stacking port diagnostics ***************************************************************** * * * Please connect a cable between Stack Port 1 and Stack Port 2. * * * * Press S to skip test, ENTER key to continue. * * * *****************************************************************
Press [Enter] to continue and run the diagnostics. Enter s to cancel the operation.
If you continue with diagnostics, the switch displays messages similar to the following:
Stack Port 1 and Stack Port 2 BERT ...................................................................................... ................................................................................... Stacking ports Port 1 (Device 0 - Device port 26) Lane 0 PASSED. Lane 1 PASSED. Lane 2 PASSED. Lane 3 PASSED. Port 2 (Device 0 - Device port 27) Lane 0 PASSED. Lane 1 PASSED. Lane 2 PASSED. Lane 3 PASSED. DIAGNOSTIC PASS: run test bert stacking Summit Diagnostics completed, rebooting system...
If you issue this command with a Telnet connection, the switch displays a warning similar to the following about the impact of this test. You also have the opportunity to continue or cancel the test:
Running Diagnostics will disrupt network traffic. Are you sure you want to continue? (y/n)
Enter y to continue and run the diagnostics. Enter n to cancel the operation.
This command was first available in ExtremeXOS 10.1.
This command was modified in ExtremeXOS 11.0 to run diagnostics on management modules from the command line interface (CLI).
The stack-port parameter for the Summit family switches was added in ExtremeXOS 11.5.
This command is available on all platforms.