ME 3800x and ME 3600x Switches Software Configuration Guide, Release 15.2(4)S
Configuring Online Diagnostics
Downloads: This chapterpdf (PDF - 120.0KB) The complete bookPDF (PDF - 11.82MB) | Feedback

Configuring Online Diagnostics

Table Of Contents

Configuring Online Diagnostics

Understanding Online Diagnostics

Configuring Online Diagnostics

Running Online Diagnostic Tests

Starting Online Diagnostic Tests

Displaying Online Diagnostic Tests and Results


Configuring Online Diagnostics


This chapter describes how to configure the online diagnostics on the Cisco ME 3800X and ME 3600X switch.


Note For complete syntax and usage information for the commands used in this chapter, see the command reference for this release.


Understanding Online Diagnostics

Configuring Online Diagnostics

Running Online Diagnostic Tests

Understanding Online Diagnostics

With online diagnostics, you can test and verify the hardware functionality of the switch while the switch is connected to a live network. The online diagnostics contain packet switching tests that monitor different hardware components and verify the data path and the control signals.

The online diagnostics detect problems in these areas:

Hardware components

Interfaces (Ethernet ports and so forth)

Solder joints

Table 49-1 lists the diagnostic test IDs and names. For information about test attributes, see the output from the show diagnostic content privileged EXEC command.

Table 49-1 Diagnostic Tests

Test ID Number
Test Name

1

TestPortAsicMem [B*D*R**]

2

TestPortAsicCam [B*D*R**]

3

TestPortAsicLoopback[B*D*R**]

4

TestPortLoopback [B*D*R**]

5

TestFpga [B*D*R**]


Online diagnostics are categorized as on-demand, scheduled, or health-monitoring diagnostics.

On-demand diagnostics run from the CLI.

Scheduled diagnostics run at user-designated intervals or at specified times when the switch is connected to a live network.

Configuring Online Diagnostics

You must configure the failure threshold and the interval between tests before enabling diagnostic monitoring. You can schedule online diagnostics to run at a designated time of day or on a daily, weekly, or monthly basis. Use the no form of this command to remove the scheduling. For detailed information about this command, see the command reference for this release.

Beginning in privileged EXEC mode, follow these steps to schedule online diagnostics:

 
Command
Purpose

Step 1 

configure terminal

Enter global configuration mode.

Step 2 

diagnostic schedule test {name | test-id | test-id-range | all | basic} {daily hh:mm | on mm dd yyyy hh:mm | weekly day-of-week hh:mm}

Schedule on-demand diagnostic tests for a specific day and time.

When specifying the tests to be scheduled, use these options:

name—Name of the test that appears in the show diagnostic content command output. See Table 49-1.

test-id—ID number of the test that appears in the show diagnostic content command output. See Table 49-1.

test-id-range—A range of test ID numbers separated by a hyphen or commas.

all—All of the diagnostic tests.

basic—Basic on-demand diagnostic tests.

You can schedule the tests for these time periods:

Daily—Use the daily hh:mm parameter.

Specific day and time—Use the on mm dd yyyy hh:mm parameter.

Weekly—Use the weekly day-of-week hh:mm parameter.

Step 3 

show diagnostic {content | schedule}

Verify the configured online diagnostic tests and schedule.

Enter show diagnostic content to display the configured online diagnostics.

Enter show diagnostic schedule to display the online diagnostics test schedule.

Step 4 

copy running-config startup-config

(Optional) Save your entries in the configuration file.

Use the no diagnostic schedule test {name | test-id | test-id-range | all | basic} {daily hh:mm | on mm dd yyyy hh:mm | weekly day-of-week hh:mm} global configuration command to remove the scheduled tests.

This example shows how to schedule diagnostic testing for a specific day and time and verify the schedule:

Switch(config)# diagnostic schedule test 1 on Dec 4 2008 10:22
Switch(config)# end
Switch# show diagnostic schedule      
Current Time = 10:21:24 UTC Thu Dec 4 2008
 
   
Diagnostic:
 
   
Schedule #1:
        To be run on December 4 2008 10:22
        Test ID(s) to be executed: 1.
 
   

At the scheduled time, the switch runs the test:

Switch# #
Dec  4 10:21:59.492: %DIAG-6-SCHED_RUNNING: : Performing Scheduled Online Diagnostic...
Dec  4 10:21:59.492: %DIAG-6-TEST_RUNNING: : Running TestPortAsicStackPortLoopback{ID=1} ..
Dec  4 10:22:00.498: %DIAG-6-TEST_OK: : TestPortAsicStackPortLoopback{ID=1} has completed 
successfully 
Dec  4 10:22:00.498: %DIAG-6-SCHED_COMPLETE: : Scheduled Online Diagnostic is completed
 
   

For more examples, see the "Examples" section for the diagnostic schedule test command in the command reference for this release.

Running Online Diagnostic Tests

After you configure online diagnostics, you can manually start diagnostic tests or display the test results. You can also see the tests configured for the switch and the tests that have already run.

Starting Online Diagnostic Tests

Displaying Online Diagnostic Tests and Results

Starting Online Diagnostic Tests

After you configure diagnostic tests to run on the switch, use the diagnostic start privileged EXEC command to begin diagnostic testing.


Note After starting the tests, you cannot stop the testing process.


Command
Purpose

diagnostic start test {name | test-id | test-id-range | all | basic }

Start the diagnostic tests.

Specify the tests by using one of these parameters:

name—Enter the name of the test. Use the show diagnostic content privileged EXEC command to display the test ID list. See Table 49-1.

test-id—Enter the ID number of the test. Use the show diagnostic content privileged EXEC command to display the test ID list. See Table 49-1.

test-id-range—Enter the range of test IDs by using integers separated by a comma and a hyphen. For more information, see the diagnostic start command in the command reference for this release.

all—Use this keyword when you want to run all of the tests.

basic—Use this keyword when you want to run the basic test suite.


This example shows how to start a diagnostic test by using the test name:

Switch# diagnostic start test TestPortAsicRingLoopback
 
   

This example shows how to start all of the basic diagnostic tests:

Switch# diagnostic start test all

Displaying Online Diagnostic Tests and Results

You can display the configured online diagnostic tests and review the test results by using the privileged EXEC show commands in Table 49-2.

Table 49-2 Commands for Diagnostic Test Configuration and Results 

Command
Purpose

show diagnostic content

Displays the online diagnostics configured for a switch.

show diagnostic status

Displays the running diagnostic tests.

show diagnostic result [detail | test {name | test-id | test-id-range | all [detail]}]

Displays the specified online diagnostics test results.

show diagnostic switch [detail]

Displays the online diagnostics test results.

show diagnostic schedule

Displays the online diagnostics test schedule.

show diagnostic post

Displays the POST results. (The output is the same as the show post command output.)


This is an example of the output from the show diagnostic result command:

Switch# show diagnostic result 
 
   
:   SerialNo : FOC1225U4CY
 
   
  Overall diagnostic result: PASS
 
   
  Test results: (. = Pass, F = Fail, U = Untested)
 
   
    1) TestPortAsicStackPortLoopback ---> .
    2) TestPortAsicLoopback ------------> U
    3) TestPortAsicCam -----------------> U
    4) TestPortAsicRingLoopback --------> U
    5) TestMicRingLoopback -------------> U
    6) TestPortAsicMem -----------------> U
 
   

This is an example of the output from the show diagnostic post command:

Switch# show diagnostic post 
Stored system POST messages:
 
   
Switch 1
---------
 
   
POST: CPU MIC register Tests : Begin
POST: CPU MIC register Tests : End, Status Passed
 
   
POST: PortASIC Memory Tests : Begin
POST: PortASIC Memory Tests : End, Status Passed
 
   
POST: CPU MIC interface Loopback Tests : Begin
POST: CPU MIC interface Loopback Tests : End, Status Passed
 
   
POST: PortASIC RingLoopback Tests : Begin
POST: PortASIC RingLoopback Tests : End, Status Passed
 
   
POST: Thermal, Fan Tests : Begin
POST: Thermal, Fan Tests : End, Status Passed
 
   
POST: PortASIC CAM Subsystem Tests : Begin
POST: PortASIC CAM Subsystem Tests : End, Status Passed
 
   
POST: PortASIC Port Loopback Tests : Begin
POST: PortASIC Port Loopback Tests : End, Status Passed
 
   
POST: EMAC Loopback Tests : Begin
POST: EMAC Loopback Tests : End, Status Passed
 
   

For more examples of other show diagnostic command outputs, see the "Examples" section of the show diagnostic command in the command reference for this release.