run diagnostics

run diagnostics [extended | normal | stack-port] {slot [slot | A | B]}

Description

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.

Syntax Description

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.

Default

N/A.

Usage Guidelines

Depending on your platform, use this command to run diagnostics on the switch, slot, management module, or stack port.

Running Diagnostics--BlackDiamond X8 Switches Only

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.

Running Diagnostics--BlackDiamond X8 Series Switches and BlackDiamond 8800 Series Switches Only

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

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.

Running Diagnostics--Summit Family Switches Only

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.

Viewing Diagnostics

To view results of the last diagnostics test run, use the following command:

show diagnostics {[cr] | slot [slot | A | B]}
Note

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.

BlackDiamond X8 switch example.

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.

Sample Console Output while running Diagnostics on BlackDiamond X8 MM.

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

BlackDiamond 8800 series switch example

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.

Summit family switch example

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.

History

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.

Platform Availability

This command is available on all platforms.