cc/td/doc/product/aggr/10000/tblshoot
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table Of Contents

Online Offline Diagnostics—Field Diagnostics on Cisco 10000 Series Routers User's Guide

Field Diagnostics Overview

Field Diagnostic Image Information

Field Diagnostic Test Information

Benefits

System Requirements

Things to Do Before Running a Field Diagnostic Test

Downloading the Required Software for Field Diagnostic Testing

Downloading a Field Diagnostic Image

Running a Field Diagnostic Test

Verifying a Line Card Is Supported by the Field Diagnostic Image

Deciding Which Field Diagnostic Tests to Run

Loading the Field Diagnostic Image onto a Line Card and Starting a Field Diagnostic Test

Checking the Testing Process

Interpreting Test Results

Reviewing Test Results

Removing a Field Diagnostic Image from a Line Card and Resuming Normal Line Card Operation

Specifying Testing Options

Stopping an In-Progress Field Diagnostic Test

Limitations and Restrictions

Command Reference

diagnostic event-log size

diagnostic load

diagnostic ondemand action-on-failure

diagnostic ondemand iterations

diagnostic start

diagnostic stop

diagnostic unload

show diagnostic content

show diagnostic events

show diagnostic ondemand settings

show diagnostic result

show diagnostic status


Online Offline Diagnostics—Field Diagnostics on Cisco 10000 Series Routers User's Guide


The purpose of this document is to explain how to use Online Offline Field Diagnostics on Cisco 10000 series routers.

This document contains the following sections:

Field Diagnostics Overview

Benefits

System Requirements

Things to Do Before Running a Field Diagnostic Test

Downloading the Required Software for Field Diagnostic Testing

Running a Field Diagnostic Test

Interpreting Test Results

Specifying Testing Options

Limitations and Restrictions

Command Reference

Field Diagnostics Overview

The Online Offline Diagnostics (OOD) feature introduces a Field Diagnostic tool that provides customers with a method of testing and verifying line card hardware problems.

If you would like to perform a hardware diagnostic test on any line card in your Cisco 10000 series router, an OOD Field Diagnostic image can be downloaded free of charge from Cisco Systems and used to test whether the line card problems are indeed due to faulty hardware. The test results will verify whether or not the hardware is faulty.


Note For the rest of this document, the OOD Field Diagnostics feature is simply referred to as Field Diagnostics.


Field Diagnostic Image Information

A Field Diagnostic image is used to run diagnostic tests on a line card. The Field Diagnostic image is loaded from the TFTP server onto the line card in order to perform Field Diagnostic tests. Once Field Diagnostic testing is complete, the Field Diagnostic image must be unloaded off the line card to resume normal line card operation.

A few notes regarding Field Diagnostic images:

The Field Diagnostic image is a separate image that cannot function as an IOS image.

The Field Diagnostic image is downloaded onto the line card. When the Field Diagnostic image is downloaded onto a line card, the line card is automatically taken offline. Once Field Diagnostic testing is complete and the test results have been gathered, the Field Diagnostic image must be unloaded off the line card before normal line card operation can resume. Normal line card operation will resume automatically once the Field Diagnostic image has been unloaded off the line card.

Field Diagnostic Test Information

The individual Field Diagnostic tests themselves as well as per-port tests are not currently relevant for troubleshooting purposes unless Field Diagnostic tests have already been run. If you want to run Field Diagnostic tests, we recommend selecting the all, basic, or default tests. The following explanations provide an overview of each test:

All: The all test suite performs all available tests for the specified line card, including external loopback tests.

Default: The default test suite performs all available tests for a specified line card except the external loopback test. If no specific test is specified, the default test is performed automatically.

Basic: The basic test suite will catch the majority of hardware failures and will not take as long to run as the all or default test suites. The basic test will save time but it does not completely test the line card hardware.

The estimates for the amount of time required to run each type of line card are given in the Field Diagnostics release notes.

Individual tests are useful for verification testing purposes. For instance, if a default test suite is run and all of the tests pass except test 5, test 5 can be run individually to confirm the test result of fail without having to run an entire test suite.

Benefits

On-Site Fault Detection

Field Diagnostics is used to verify if a line card problem is due to a hardware fault; therefore, Field Diagnostics can be used to confirm if a problem is indeed hardware-related and a line card needs to be returned.

Additional Uptime

Field Diagnostics can increase network uptime by ensuring that line cards are not mistakenly taken offline when a problem is elsewhere.

System Requirements

For information on the software and hardware requirements for Field Diagnostic images, see the Release Notes for the Field Diagnostic image.

Things to Do Before Running a Field Diagnostic Test

Console logging is often disabled on Cisco 10000 series routers for reasons unrelated to Field Diagnostics. Field Diagnostic testing can still occur when console logging is disabled, but it is important to note that some Field Diagnostic messages may not be seen because of the console logging setting.

A Field Diagnostic image will take the line card offline, meaning the line card cannot receive and transmit packets as usual when a Field Diagnostic image is loaded onto the line card. Therefore, you may want to schedule downtime for the line card being tested before performing Field Diagnostic tests.

Before perfuming any Field Diagnostic test, we recommend unplugging all cables on the device that connect to other interfaces. If the cables that connect interfaces are not unplugged, some Field Diagnostic tests may send packets to connected devices. Although these packets are harmless and will not impact network performance, packet counters on the receiving interfaces will be incremented when receiving these packets.

Downloading the Required Software for Field Diagnostic Testing

The following sections provide instructions on downloading the software required to run Field Diagnostic tests. It covers the following topics:

Downloading a Field Diagnostic Image

Downloading a Field Diagnostic Image


Note These instructions assume the Field Diagnostic image is downloaded using TFTP. In most cases, TFTP is the easiest method for downloading the Field Diagnostic image and Cisco Systems highly recommends downloading using TFTP unless there is a compelling reason to load the Field Diagnostic image using another method.


A Field Diagnostic image first must be downloaded to a TFTP server in order to run a Field Diagnostic test on a line card.

Downloading the Field Diagnostic image to a TFTP server can be accomplished by completing the following steps:


Step 1 Go to the following URL:

http://www.cisco.com/cgi-bin/tablebuild.pl/10000fdi 

Step 2 Double-click the Field Diagnostic image that you would like to download.The Field Diagnostic image for the Cisco 10000 series routers will start with the "c10k" file-naming convention (for example, c10k-fdiagslc-mz.2.0.bin)

Step 3 Browse to your TFTP server and place the image into your TFTP folder.


Running a Field Diagnostic Test

The following sections provide the instructions for running a Field Diagnostic test on a line card after the Cisco IOS image has been successfully loaded on the router and a Field Diagnostic image has been loaded onto the TFTP server.

This section covers the following topics:

Verifying a Line Card Is Supported by the Field Diagnostic Image

Deciding Which Field Diagnostic Tests to Run

Loading the Field Diagnostic Image onto a Line Card and Starting a Field Diagnostic Test

Checking the Testing Process

Reviewing Test Results

Removing a Field Diagnostic Image from a Line Card and Resuming Normal Line Card Operation

Verifying a Line Card Is Supported by the Field Diagnostic Image

To see which line cards in your chassis support Field Diagnostic testing on the Cisco 10000 ESR series router, enter the show diagnostic status command.

In the following example, show diagnostic status is used to see if the line cards support Field Diagnostic testing. The support for the Field Diagnostic image is listed in the FDiag Support column of the show diagnostic status output:


Note Note that the output of show diagnostic status can be used to determine if a line card is a full-slot or half-slot line card by checking the slot column of the output. If the slot column is a single number, the line card is a full-slot line card. If the slot column is a single number following by a slash (such as 3/0 in this example), the card is a half-slot line card.
This information becomes important when specifying line cards for other commands; if you want to specify that a full-slot line card in a slot be tested, you can specify slot number in many of the diagnostic commands (an example in the following output would be slot 1). If you want to specify a half-slot line card, subslot number must be specified (the lone example in the following output is subslot 3/0).


Router# show diagnostic status

==== ======================== ======= ========== =========== ==============
FDiag Loaded Overall Current
Slot Card Description Support Image Type Diag Result Card State
---- ------------------------ ------- ---------- ----------- --------------
A Primary PRE1-RP NO IOS N/A ONLINE
B Secondary PRE1-RP NO N/A N/A OFFLINE
1 6oc3pos-1 YES LCDOS N/A ONLINE
2 6oc3pos-1 YES Field Diag PASS DIAG READY
3/0 1gigethernet-hh-1 YES LCDOS N/A ONLINE
6 6cht3-1 YES LCDOS N/A ONLINE
==== ======================== ======= ========== =========== ==============

Deciding Which Field Diagnostic Tests to Run

The default test suite should be the selected test suite in most testing cases. The all test suite should only be used if all of the ports on the line card are ready for external loopback tests (in most cases, this means that all of the ports have been cabled using external loopback cables), and the basic test suite should only be used if time is critical and the line card cannot be down for more than a couple of extra minutes (in most cases, the default test only takes less than 5 extra minutes to run and it provides more complete testing coverage). To see the approximate time required to run each type of test, see the Release Notes for your Field Diagnostic image.

If you are unsure of which test suite to run, use the default test suite.

Loading the Field Diagnostic Image onto a Line Card and Starting a Field Diagnostic Test

To begin Field Diagnostic testing on a line card, the Field Diagnostic image must be loaded from the TFTP server onto the line card that will be tested. The following steps are required to download the Field Diagnostic image to the line card:


Note It is advisable to check cisco.com for the latest Field Diagnostic image before running any Field Diagnostic test. All Field Diagnostic images are available at the following URL:
http://www.cisco.com/cgi-bin/tablebuild.pl/10000fdi 

The
show diag command can be used to see the current Field Diagnostic image version (Note that this is the show diag command, not the show diagnostic command. The show diag and show diagnostic commands will produce completely different outputs).



Step 1 If desired, shutdown the line card using the shut command. This is not a required step, but if you think the card's performance is impacting the performance of the entire system, this will ensure that the line card does not come back online after Field Diagnostic testing is complete.

Step 2 The first step in loading the Field Diagnostic image depends on whether you want to begin Field Diagnostic testing immediately. If you want to begin Field Diagnostic testing immediately, follow the instructions in a. If you want to start testing after loading the image, to run individual tests, or to run more than one test and have already run the first test, follow the directions in b.


Note When specifying a full-height line card for testing, use slot when entering diagnostic load. When specifying a half-height line card for testing, use subslot.
For additional information on when to specify slot or subslot, see the "Verifying a Line Card Is Supported by the Field Diagnostic Image" section.


a. If you already know which Field Diagnostic tests you want to run, enter the diagnostic load {slot slot-number | subslot slot-number/subslot-number} image-url autostart test [basic | default ] command and ensure that the autostart option is entered. This command loads the Field Diagnostic image onto the line card and will start Field Diagnostic testing automatically if the autostart keyword is entered.


Note The per-port and all test options were intentionally left off the explanation above. These options usually should not be used until after a default test is run, but they will appear if the ? help option is used.
See the "Running a Per-Port or All Test" section section of this document for information on running per-port and all tests.


In the following example, the Field Diagnostic image would be downloaded from the assigned TFTP server to the line card in slot 2 and the full Field Diagnostic test suite would be run:

Router# diagnostic load slot 2 tftp://126.1.1.1/myfolder/c10k-fdiagslc-mz.1.1.bin autostart test default

b. If you do not want to autostart testing, enter the diagnostic load {slot slot-number | subslot slot-number/subslot-number} image-url command and ensure the autostart option is not entered.

The following example shows the Field Diagnostic image is loaded from the TFTP server to the line card in slot 6. Note that the Field Diagnostic image has only been loaded onto the line card; Field Diagnostic testing has not begun.

Router# diagnostic load slot 6 tftp://126.1.1.1/mytftpfolder/c10k-fdiagslc-mz.1.1.bin

Note If the Field Diagnostic image is loaded onto a line card but no tests are being run, the line card is still offline and can therefore not send and receive traffic. The diagnostic image can be removed from the line card using the diagnostic unload command if normal line card operation needs to be resumed.



Step 3 If Field Diagnostic testing was not autostarted using the diagnostic load command, or you'd like to run a second test and the Field Diagnostic image is still loaded onto the line card, enter the diagnostic start {slot slot-number | subslot slot-number/subslot-number} test [basic | default] to begin Field Diagnostic testing on the line card.


Note The per-port and all test options were intentionally left off the explanation above. These options should not be used until after a default test is run, but they will appear if the ? help option is used.
See the "Reviewing Test Results" section of this document for information on running per-port and all tests.


In the following example, a Field Diagnostic test with the default test suite is started on slot 6. The example assumes that a Field Diagnostic image has been loaded onto the line card in slot 6.

Router# diagnostic start slot 6 test default


Note If this is your first time running a Field Diagnostics test, be aware that the Field Diagnostic image should not be unloaded off the line card until the test results have been analyzed (see the "Interpreting Test Results" section section for information on analyzing test results). However, normal line card operation cannot resume until the Field Diagnostic image has been unloaded off the line card.


Checking the Testing Process

Some individual tests take longer to run than others and the the lack of feedback on the console for a period of time may be worrisome even though the tests are running properly.

If you are unsure if Field Diagnostic tests are still running, the show diagnostic status target detail command can be used to verify if the Field Diagnostic testing is running.

Interpreting Test Results


Note Test results should be analyzed before unloading the Field Diagnostic image off the line card since some information cannot be gathered after the Field Diagnostic image is unloaded off the line card. If you want to resume normal line card operation, analyze the test results, take the steps recommended in this section, and then unload the Field Diagnostic image. Normal line card operation cannot resume until the Field Diagnostic image is unloaded off the line card.


After running a Field Diagnostic test, an overall test result for the selected tests is displayed on the console. The overall test result is either pass or fail.


Note The overall results shown in the show diagnostic result and show diagnostic status commands displays the overall results of all previously run tests, not just the most recently selected test or test suite. In the outputs of show diagnostic result and show diagnostic status, the test results are listed as either Pass, Minor Error, or Major Error. These test results have the following meanings:
Pass: All of the Field Diagnostic tests passed.
Minor Error: This result is only seen with per-port and all tests. This error indicates that the tested interface is faulty but the other interfaces on the line card are not necessarily faulty.
Major Error: This result indicates a hardware problem with the entire line card and the line card should not be used.
Use the recommendations based on the last test results below when deciding how to proceed after running any OOD Field Diagnostic test.


Fail Result: If a test fails when a test suite is run, rerun the failed test or tests (not the entire test suite, just the test or tests that failed) by entering the diagnostic start target test failed-test-id command. This will confirm that the fail result is correct.

If the test fails again, copy any messages on the console exactly as they appear and gather the outputs of show diagnostic result and show diagnostic result detail and contact a customer support representative with the gathered information.

Pass Result:


Note Each one of these tests suggests performing an external loopback test. The external loopback test is supported on most, but not all, interfaces.
To see if external loopback testing is supported on an interface, enter the show diagnostic content command and see if the L attribute is available for an individual test. For information on running an external loopback test, proceed to the next section.


Default Test Pass

If your test passed and you ran a default test, attach an external loopback cable to a problem port (if you think the problem is in a particular port) or to all ports if possible and use the diagnostic start slot slot-number test per-port port-number command to test the ports if your interface supports external loopback tests (see the note above for information on checking for external loopback support). If you run all of these tests and are still getting a pass result or external loopback testing is not supported on the interface, recable the router, unload the Field Diagnostic image, and place the line card back online. The problem is likely elsewhere.

Basic Test Pass

If your test passed and you ran a basic test or individual tests, run a default test. If your default test passes, attach a loopback cable to each port (if external loopback testing is supported) and enter diagnostic start slot slot-number test per-port all to check each port (if you do not have enough cables to perform this task, check as many individual ports as possible using the diagnostic start slot slot-number test per-port port-id command) if the interface supports external loopback testing. If you run all of these tests and are still getting a pass result or the interface does not support external loopback testing, recable the router, unload the Field Diagnostic image, and place the line card back online. The problem is likely elsewhere.

All Test Pass

If you ran all of these tests and got a pass result, recable the router, unload the Field Diagnostic image, and place the line card back online. The problem is likely not in the line card hardware.

Running a Per-Port or All Test

The external loopback test is supported on most, but not all, interfaces.
To see if external loopback testing is supported on an interface, enter the show diagnostic content command and see if the L attribute is available for an individual test.

For information on cabling DB-15 and RJ-45 connections for external loopback tests, see the Hard Plug Loopback Tests for E1 Lines document. Refer to other Cisco documentation regarding loopback cabling for particular cables and connector types.

A per-port Field Diagnostic test is used to test a specific port for hardware problems. A per-port test should only be run after a default test has been run and no problems were found on the other line card components. The all test suite is a test suite that includes the default test as well as all of the per-port tests. The all test suite should only be run if all of the interfaces are cabled with external loopback cables.

Per-port tests utilize external loopbacks to test the interface hardware. In most, but not all, cases, the interfaces to be tested need to be cabled with external loopback cables before per-port or all testing can begin. It is important to note that not all interfaces support external loopback testing.

In the following example, a per-port test is run on port 1 of the line card in slot 2:

Router# diagnostic start slot 2 test per-port port 1

In the following example, all tests including all per-port diagnostic tests will be run on the line card in slot 2:

Router# diagnostic start slot 2 test all

Reviewing Test Results

After completing a Field Diagnostic test, a message will appear on the console indicating your overall test results. Additional show commands must be entered to gather test results and events information, however.

For additional information on diagnostic events and results, enter one of the following commands:

Table 1  Field Diagnostic show Commands for Viewing Test Results

Command
Description

show diagnostic result [all | slot slot-number detail | subslot slot-number/subslot-number detail]

Shows additional detail on the diagnostic test results. For various statistical information on each individual diagnostic test, use the detail option with this command.

Note The show diagnostic result output is erased when a Field Diagnostic image is removed from a line card. If you want to retain Field Diagnostic test results, enter show diagnostic result and copy and paste the output into a separate file before unloading the Field Diagnostic image.

show diagnostic status [slot slot-number | subslot subslot-number] [detail]

Shows detailed status information, including which tests passed, failed, or were not run during a particular test.

show diagnostic events [event-type {error | info | warning} | {slot slot-number} | {subslot slot-number/subslot-number]}

Displays the history of all Field Diagnostic events since the last system reload.


The following example is the show diagnostic result output for the last Field Diagnostic test run on the line card in slot 2. The output reveals which tests passed, failed, and were not run (untested).

Router# show diagnostic result slot 2

Slot 2: 6oc3pos-1, 6 ports

Overall diagnostic result: PASS

Test results: (. = Pass, F = Fail, U = Untested)

1) MPC8260 Register Test ---------------------> .
2) MPC8260 Timer Test ------------------------> .
3) 6P OC3 POS MPC8260 Port I/O Test ----------> .
4) march_dram_64 -----------------------------> .
5) bus_float_dram_64 -------------------------> .
6) data_pins_dram_64 -------------------------> .
7) SDRAM ECC Test ----------------------------> .
8) SRAM Test ---------------------------------> .
9) CPLD Register Test ------------------------> .
10) BariumRegTest -----------------------------> .
11) BariumIntTest -----------------------------> .
12) FIBRegTest_pm -----------------------------> .
13) FIBIntTest_pm -----------------------------> .
14) FIBSdramMemTest_pm ------------------------> .
15) FIBChanMemTest_pm -------------------------> .
16) FIBStatMemTest_pm -------------------------> .
17) FIBDescMemTest_pm -------------------------> .
18) TIBRegTest_pm -----------------------------> .
19) TIBIntTest_pm -----------------------------> .
20) TIBSdramMemTest_pm ------------------------> .
21) TIBChanMemTest_pm -------------------------> .
22) TIBStatMemTest_pm -------------------------> .
23) TIBCtrlMemTest_pm -------------------------> .
24) TIBSdramParityTest_pm ---------------------> .
25) TIBCtrlParityTest_pm ----------------------> .
26) PM5351RegTest_1 ---------------------------> .
27) PM5351IntTest_1 ---------------------------> .
28) PM5351RegTest_2 ---------------------------> .
29) PM5351IntTest_2 ---------------------------> .
30) PMBariumLpbkTest --------------------------> .
31) BariumCRCTest -----------------------------> .
32) PMParallelLpbkTest ------------------------> .
33) PMSerialLpbkTest --------------------------> .
34) PMExternalLpbkTest:

Port 0  1 2 3 4 5
----------------------
U U U U U U

The following output shows detailed information for each Field Diagnostic test:

Router# show diagnostic result slot 2 detail

Slot 2: 6oc3pos-1, 6 ports

Overall diagnostic result: PASS

Test results: (. = Pass, F = Fail, U = Untested)

___________________________________________________________________________

1) MPC8260 Register Test ---------------------> .

Error code ----------------------------> 0 (DIAG_SUCCESS)
Total run count -----------------------> 4
Last test execution time --------------> Apr 02 2003 12:36:25
First test failure time ---------------> n/a
Last test failure time ----------------> n/a
Last test pass time -------------------> Apr 02 2003 12:36:25
Total failure count -------------------> 0
Consecutive failure count -------------> 0
___________________________________________________________________________

2) MPC8260 Timer Test ------------------------> .

Error code ----------------------------> 0 (DIAG_SUCCESS)
Total run count -----------------------> 4
Last test execution time --------------> Apr 02 2003 12:36:26
First test failure time ---------------> n/a
Last test failure time ----------------> n/a
Last test pass time -------------------> Apr 02 2003 12:36:26
Total failure count -------------------> 0
Consecutive failure count -------------> 0

...(Additional display text omitted from this example)

The following example provides sample show diagnostic events output. This output provides a list of previous diagnostic events with a brief description of each event.

Router# show diagnostic events
Diagnostic events (storage for 500 events, 122 events recorded)
Event Type (ET): I - Info, W - Warning, E - Error

Time Stamp ET [Card] Event Message
------------------ -- --------------------------------------------------------
04/02 06:50:19.903 I [3/0] Card detected: 1gigethernet-hh-1, S/N:cab061406qc
04/02 06:50:23.907 I [2] Card detected: 6oc3pos-1, S/N:CAB0531JXEF
04/02 06:50:25.207 I [1] Card detected: 6oc3pos-1, S/N:CAB0531JXEE
04/02 06:50:55.419 I [6] Card detected: 6cht3-1, S/N:N/A
04/02 06:51:36.935 I [2] Loading Field Diag image into 6oc3pos-1
04/02 06:52:12.435 I [2] Field Diag image is loaded and booting
04/02 06:52:14.575 I [2] Test list retrieval is completed
04/02 06:58:45.551 I [2] Starting MPC8260 Register Test {ID=1}
04/02 06:58:45.599 I [2] MPC8260 Register Test {ID=1} passed
04/02 06:58:45.755 I [2] Field Diag passed for selected tests
04/02 06:59:06.207 I [2] Field Diag image is unloaded
04/02 06:59:24.107 I [2] Card detected: 6oc3pos-1, S/N:CAB0531JXEF
04/02 12:24:02.662 I [2] Loading Field Diag image into 6oc3pos-1
04/02 12:24:38.570 I [2] Field Diag image is loaded and booting
04/02 12:24:40.706 I [2] Test list retrieval is completed
04/02 12:28:51.638 I [2] Starting MPC8260 Register Test {ID=1}
04/02 12:28:51.686 I [2] MPC8260 Register Test {ID=1} passed
04/02 12:28:51.742 I [2] Starting MPC8260 Timer Test {ID=2}

...(Additional display text omitted from this example)

Removing a Field Diagnostic Image from a Line Card and Resuming Normal Line Card Operation


Note Before unloading a Field Diagnostic image from a line card, copy and paste the output of show diagnostic result into a separate file if you would like to retain the results of your Field Diagnostic test. The show diagnostic result output cannot be generated if the Field Diagnostic image has been unloaded from the line card.


The diagnostic unload {slot slot-number | subslot slot-number/subslot-number} command can be used to unload a Field Diagnostic image as long as a Field Diagnostic test is not in progress. If you want to unload a Field Diagnostic image while a test is in progress, use the diagnostic stop {slot slot-number | subslot slot-number/subslot-number} command to stop the test, followed by the diagnostic unload {slot slot-number | subslot slot-number/subslot-number} command to unload the Field Diagnostic image.

Normal line card operation should resume after removing the Field Diagnostic image from the line card.

In the following example, the Field Diagnostic image is unloaded off the line card in slot 2 and normal line card operation will resume. Note that the Field Diagnostic image unloading process does not begin until y is entered at the prompt to verify the operation.

Router# diagnostic unload slot 2
******************************************************************************
WARNING:All Field Diagnostics test results and information will be
unavailable to both the "show diagnostic result <target>" and
"show diagnostic content <target>" commands.
To save the test results, cancel the unloading process and enter
the "show diagnostic result <target>" command. Copy the output
into a file, then re-enter the "diagnostic unload <target>" command
to restore normal line card operation.
******************************************************************************
% Are you sure that you want to perform this operation? [no]:y
FDIAG [slot 2]> Unloading the Field Diagnostics image and restoring the original run-time image, please wait ...
FDIAG [slot 2]> Field Diagnostics image was successfully unloaded

Specifying Testing Options

The following table provides a list of optional commands that can be entered before performing a Field Diagnostic test. None of these commands have to be entered to perform a Field Diagnostic test and most Field Diagnostic test cases will not require these commands.

See the "Command Reference" section of this document for additional information on any of these commands:

Table 2  Field Diagnostics Pre-Testing Options

Command
Description

diagnostic event-log size event-size

This global configuration command sets the size of the event table. The default event-size is 500.

diagnostic ondemand iterations iteration-count

This EXEC command sets the number of times each specified Field Diagnostic test will be run when the diagnostic load command is used to start a Field Diagnostic test. The default iteration-count is 1.

diagnostic ondemand action-on-failure [continue failure-limit | stop]

This EXEC command sets the number of failed tests that can occur during a Field Diagnostic test before the entire series of tests is stopped. By default, the Field Diagnostic tests will run to completion even if a testing error occurs.


The following example shows how to change the size of the event table to 250. Note that the event table size is changed in global configuration mode.

Router# configure terminal
Router(config)# diagnostic event-log size 250

The following example shows how to change diagnostic on-demand settings and then verify the changed diagnostic ondemand settings.

Router# diagnostic ondemand iterations 2
Router# diagnostic ondemand action-on-failure stop
Router# show diagnostic ondemand settings

Test iterations = 2
Action on test failure = stop

Stopping an In-Progress Field Diagnostic Test

To stop an in-progress Field Diagnostic test, enter the diagnostic stop {slot slot-number | subslot slot-number/subslot-number} command while a test is in progress.


Note The diagnostic stop command can be entered at any time, even if a prompt is not present because the console is displaying diagnostic testing events. However, hitting Enter on your keyboard while a test is in progress will display a router prompt and will make entering the diagnostic stop command easier in some cases.


The following example shows a diagnostic test being started and then stopped:

Router# diagnostic start slot 2 test basic
Router#
FDIAG [slot 2]> Test ID(s) selected: 1-2,4,7,9-29,32-33

FDIAG [slot 2]> Running Field Diagnostics [Iteration #1] ...
FDIAG [slot 2]> Running MPC8260 Register Test {ID=1} ...
FDIAG [slot 2]> MPC8260 Register Test {ID=1} passed

FDIAG [slot 2]> Running MPC8260 Timer Test {ID=2} ...
FDIAG [slot 2]> MPC8260 Timer Test {ID=2} passed

FDIAG [slot 2]> Running march_dram_64 {ID=4} ...

Router# diagnostic stop slot 2
FDIAG [slot 2]> march_dram_64 {ID=4} passed

FDIAG [slot 2]> Testing is being aborted

FDIAG [slot 2]> Total testing time = 00:00:05.500

Router#
FDIAG [slot 2]> Field Diagnostics was successfully stopped

Limitations and Restrictions

Field Diagnostics for the Cisco 10000 series router should not be used for either card in an Automatic Protection Switching (APS) configuration. Neither the active nor the standby line card in the APS configuration should be tested using the Field Diagnostic image.

If you would like to perform a Field Diagnostic test on a card in an APS configuration, unconfigure APS using the following commands before downloading the Field Diagnostic image to one of the line cards.

Router(config)# redundancy
Router(config-r)# no associate slot slot-number

For additional information on disabling APS, see the "Disabling Redundancy to Disable SONET APS" section of Configuring Automatic Protection Switching. 

When accessing a router via telnet and running a Field Diagnostic test, testing progress messages will not appear on the screen while a Field Diagnostic test is being run.

Some packets may leave the interface during certain Field Diagnostic tests.

If a switchover occurs during a Field Diagnostic test, the Field Diagnostic test will stop immediately and the line card run-time image will automatically replace the Field Diagnostic image on the line card.

Command Reference

This section documents the new commands introduced with Field Diagnostics on the Cisco 10000 series router. All other commands used with this feature are documented in the Cisco IOS Release 12.2 command reference publications.

diagnostic event-log size

diagnostic load

diagnostic ondemand action-on-failure

diagnostic ondemand iterations

diagnostic start

diagnostic stop

diagnostic unload

show diagnostic content

show diagnostic events

show diagnostic ondemand settings

show diagnostic result

show diagnostic status

diagnostic event-log size

To set the size of the event table, use the diagnostic event-log size command.

diagnostic event-log size event-size

Syntax Description

event-size

Specifies the number of events that are allowed in the event table.


Defaults

The default event-size is 500.

Command Modes

Global configuration

Command History

Release
Modification

Release 12.2(16)BX

This command was introduced.


Usage Guidelines

The diagnostic event-log size command sets the number of events that are saved in the event log. The event log can be viewed by entering the show diagnostic events command.

Examples

In the following example, the event table size is expanded to 501 events.

Router(config)# diagnostic event-log size 501

Related Commands

Command
Description

diagnostic load

Loads the Field Diagnostic image onto the line card.

diagnostic ondemand action-on-failure

Sets the number of errors allowed in the Field Diagnostic test before the Field Diagnostic test is stopped.

diagnostic ondemand iterations

Sets the number of times each specific Field Diagnostic test will be run when a Field Diagnostic test is initiated.

diagnostic start

Starts Field Diagnostic testing on the line card.

diagnostic stop

Stops an in-progress Field Diagnostic test.

diagnostic unload

Unloads the Field Diagnostic image from the line card and restores normal line card operation.

show diagnostic content

Shows the Field Diagnostic test list for a particular line card.

show diagnostic events

Displays the history of Field Diagnostic events since the last system reload.

show diagnostic ondemand settings

Shows the diagnostic on-demand settings.

show diagnostic result

Shows the results of the Field Diagnostic test.

show diagnostic status

Displays various status information, such as line card slot and name, Field Diagnostic image status, and previous Field Diagnostic test results.


diagnostic load

To load a Field Diagnostic image to the line card for Field Diagnostic testing, enter the diagnostic load command.

diagnostic load {slot slot-number | subslot slot-number/subslot-number} image-url [autostart test {all [port port-number | WORD]}| basic | default | per-port port-number}]

Syntax Description

slot

Specifies that the line card downloading the Field Diagnostic image is in a full slot as opposed to a subslot.

subslot

Specifies that the line card downloading the Field Diagnostic image is in a subslot (in other words, a half-height line card) as opposed to a full slot.

slot-number

Specifies the number of the slot where the line card downloading the Field Diagnostic image is located on the router.

subslot-number

Specifies the number of the subslot where the line card downloading the Field Diagnostic image is located on the router.

image-url

Specifies the path where the Field Diagnostic image is being downloaded from.

If the Field Diagnostic image was saved to the router's Flash file system, enter the file system (such as disk0: or disk1:) as the image-url.

If the Field Diagnostic image was saved to a TFTP server, the image-url will include tftp://path, where path is the path to the file on the TFTP server where the Field Diagnostic image has been saved.

autostart

If autostart is specified, the diagnostic testing process for the line card will begin automatically once the Field Diagnostic image has been loaded onto the line card.

test

The test option is used to specify which type of testing will occur. If the test option is not entered, the default test is used.

all

When used after the test option, specifies that all Field Diagnostic tests will be run during the testing period, including the external loopback test.
When used after the port option, specifies that external loopback tests should be run on all ports on the line card.

port port-number

Specifies the port number on the interface that should perform the external loopback test.

WORD

Specifies a range of ports.

basic

Specifies that basic Field Diagnostic test suite will be run. The basic test suite will catch most hardware problems but not run each individual test like the all option. The advantage of running the basic test suite is that it takes less time to run than the other test suites.

default

Specifies that the default test suite will be run. The default test suite will run all Field Diagnostic tests for the particular line card with the exception of the external loopback test.

If no test suite or test is specified when requesting a test, the default test suite is run.

per-port

Specifies that an external loopback test should be run.


Defaults

If the autostart option is entered but no test is specified, the default test suite is the suite used to test the line card.

Command Modes

Priviliged EXEC

Command History

Release
Modification

Release 12.2(16)BX

This command was introduced.


Usage Guidelines

Entering this command and successfully downloading the Field Diagnostic image will disrupt normal line card operation. To remove the Field Diagnostic image from a line card and restore normal line card operation, use the diagnostic unload command.

If the autostart option is not specified, diagnostic tests can be run on the line card after the Field Diagnostic image has been loaded by entering the diagnostic start command.

Examples

In the following example, the diagnostic load command is used to download the Field Diagnostic image in TFTP server 127.1.1.1/mytftpfolder to the line card in slot 2. If yes is entered at the prompt below, the router will be placed in Field Diagnostic mode.

Router# diagnostic load slot 2 tftp://127.1.1.1/mytftpfolder/c10k-fdiagslc-mz.1.1.bin
******************************************************************************
WARNING:The specified line card will be taken offline, please ensure that
all traffic has been redirected before executing this command.
NOTE:The "diagnostic unload <target>" command must be used after diagnostic
testing to resume normal line card operation.
******************************************************************************
Field Diagnostics Image Loading Parameters
==============================================================================
Slot:2 (6oc3pos-1)
Image URL:tftp://127.1.1.1/mytftpfolder/c10k-fdiagslc-mz.1.1.bin
Auto-Start:disabled
==============================================================================
% Are you sure that you want to perform this operation? [no]:

Related Commands

Command
Description

diagnostic event-log size

Sets the size of the event table.

diagnostic ondemand action-on-failure

Sets the number of errors allowed in the Field Diagnostic test before the Field Diagnostic test is stopped.

diagnostic ondemand iterations

Sets the number of times each specific Field Diagnostic test will be run when a Field Diagnostic test is initiated.

diagnostic start

Starts Field Diagnostic testing on the line card.

diagnostic stop

Stops an in-progress Field Diagnostic test.

diagnostic unload

Unloads the Field Diagnostic image from the line card and restores normal line card operation.

show diagnostic content

Shows the Field Diagnostic test list for a particular line card.

show diagnostic events

Displays the history of Field Diagnostic events since the last system reload.

show diagnostic ondemand settings

Shows the diagnostic on-demand settings.

show diagnostic result

Shows the results of the Field Diagnostic test.

show diagnostic status

Displays various status information, such as line card slot and name, Field Diagnostic image status, and previous Field Diagnostic test results.


diagnostic ondemand action-on-failure

To set an error count limit or to stop testing once a diagnostic error event is detected, use the diagnostic ondemand action-on-failure command.

diagnostic ondemand action-on-failure [continue failure-limit | stop]

Syntax Description

continue failure-limit

Specifies that Field Diagnostic testing should continue on the line card after a failed test occurs. The failure-limit specifies the number of failed tests that can be detected before testing on the line card should stop. A failure-limit of 0 means testing should continue regardless of the number of failed tests.

Note The failure-limit is the number of failed tests, not errors within a single test. For example, if four errors occur during a single test, the failure-limit for that individual test would be 1, not 4.

stop

Specifies that Field Diagnostic testing should stop when an error event occurs.


Defaults

If this command is not entered, a default failure-limit of 0 is used. Therefore, testing will continue regardless of the number of errors unless the diagnostic ondemand action-on-failure command is used to change the default setting.

Command Modes

Priviliged EXEC

Command History

Release
Modification

Release 12.2(16)BX

This command was introduced.


Usage Guidelines

The diagnostic ondemand action-on-failure settings cannot be saved to an IOS configuration file. Therefore, the diagnostic ondemand action-on-failure command will need to be re-entered each time a router is reset or power cycled if the action-on-failure settings should be maintained.

The show diagnostic ondemand settings command can be used to verify the diagnostic ondemand action-on-failure setting.

The show diagnostic events event-type error command can be used to gather additional information about an error event.

Examples

In the following example, the diagnostic on-demand iteration and action-on-failure settings are changed using diagnostic ondemand iterations and diagnostic ondemand action-on-failure. The changed settings are then confirmed using show diagnostic ondemand settings.

Router# diagnostic ondemand iterations 2
Router# diagnostic ondemand action-on-failure stop
Router# show diagnostic ondemand settings

Test iterations = 2
Action on test failure = stop

Related Commands

Command
Description

diagnostic event-log size

Sets the size of the event table.

diagnostic load

Loads the Field Diagnostic image onto the line card.

diagnostic ondemand iterations

Sets the number of times each specific Field Diagnostic test will be run when a Field Diagnostic test is initiated.

diagnostic start

Starts Field Diagnostic testing on the line card.

diagnostic stop

Stops an in-progress Field Diagnostic test.

diagnostic unload

Unloads the Field Diagnostic image from the line card and restores normal line card operation.

show diagnostic content

Shows the Field Diagnostic test list for a particular line card.

show diagnostic events

Displays the history of Field Diagnostic events since the last system reload.

show diagnostic ondemand settings

Shows the diagnostic on-demand settings.

show diagnostic result

Shows the results of the Field Diagnostic test.

show diagnostic status

Displays various status information, such as line card slot and name, Field Diagnostic image status, and previous Field Diagnostic test results.


diagnostic ondemand iterations

To set the number of times a diagnostic tests or set of tests will be run when the diagnostic start command is entered, enter the diagnostic ondemand iterations command.

diagnostic ondemand iterations iteration-count

Syntax Description

iteration-count

The number of tests to be run each time a Field Diagnostic test is started. For instance, if the iteration-count is set at 2 and the Field Diagnostic test specifies that tests 1, 5, and 10 will be run, tests 1, 5, and 10 will all be run twice. If basic or default testing is specified and the iteration-count is 2, all basic or complete tests will be run twice.


Defaults

The default iteration-count is 1.

Command Modes

Priviliged EXEC

Command History

Release
Modification

Release 12.2(16)BX

This command was introduced.


Usage Guidelines

The diagnostic ondemand iterations settings cannot be saved to an IOS configuration file. Therefore, the diagnostic ondemand iterations command will need to be re-entered each time a router is reset or power cycled if a nondefault setting needs to be maintained.

The show diagnostic ondemand settings command can be used to verify the diagnostic ondemand iterations setting.

Examples

In the following example, the diagnostic on-demand iteration and action-on-failure settings are changed using diagnostic ondemand iterations and diagnostic ondemand action-on-failure. The changed settings are then confirmed using show diagnostic ondemand settings.

Router# diagnostic ondemand iterations 2
Router# diagnostic ondemand action-on-failure stop
Router# show diagnostic ondemand settings

Test iterations = 2
Action on test failure = stop

In the following example, the diagnostic ondemand iterations command is first used to change the number of iterations per test to 2. Therefore, a Field Diagnostic test is run twice (note that the output of the diagnostic start command reflects the test being run twice).

After the initial test, the iteration-count is then changed to 3 and the same test is run. Note that the output of diagnostic start shows each test being run three times as opposed to two after the iteration-count was changed using the diagnostic ondemand iterations 3 command.

Router# diagnostic ondemand iterations 2
Router# diagnostic start slot 8 test 1
Slot 8: Running test(s) 1 may generate packets out of the card interface.

Do you want to run the selected test(s)? [no]: y
Router#

FDIAG [slot 8]> Running Field Diagnostics [Iteration #1] ...
FDIAG [slot 8]> Running MPC860 Register Test {ID=1} ...
FDIAG [slot 8]> MPC860 Register Test {ID=1} passed


FDIAG [slot 8]> Running Field Diagnostics [Iteration #2] ...
FDIAG [slot 8]> Running MPC860 Register Test {ID=1} ...
FDIAG [slot 8]> MPC860 Register Test {ID=1} passed

FDIAG [slot 8]> Total testing time = 00:00:00.500

FDIAG [slot 8]> Field Diagnostics passed with the selected test(s)

*Jun 13 16:05:48.987: %DIAG_C10K-5-TESTING_PASSED: Field Diagnostics passed with the selected test(s) for card in slot 8
Router# diagnostic ondemand iterations 3
Router# diagnostic start slot 8 test 1
Slot 8: Running test(s) 1 may generate packets out of the card interface.

Do you want to run the selected test(s)? [no]: y
Router#

FDIAG [slot 8]> Running Field Diagnostics [Iteration #1] ...
FDIAG [slot 8]> Running MPC860 Register Test {ID=1} ...
FDIAG [slot 8]> MPC860 Register Test {ID=1} passed


FDIAG [slot 8]> Running Field Diagnostics [Iteration #2] ...
FDIAG [slot 8]> Running MPC860 Register Test {ID=1} ...
FDIAG [slot 8]> MPC860 Register Test {ID=1} passed


FDIAG [slot 8]> Running Field Diagnostics [Iteration #3] ...
FDIAG [slot 8]> Running MPC860 Register Test {ID=1} ...
FDIAG [slot 8]> MPC860 Register Test {ID=1} passed

FDIAG [slot 8]> Total testing time = 00:00:00.600

FDIAG [slot 8]> Field Diagnostics passed with the selected test(s)

*Jun 13 16:06:07.291: %DIAG_C10K-5-TESTING_PASSED: Field Diagnostics passed with the selected test(s) for card in slot 8

Related Commands

Command
Description

diagnostic event-log size

Sets the size of the event table.

diagnostic load

Loads the Field Diagnostic image onto the line card.

diagnostic ondemand action-on-failure

Sets the number of errors allowed in the Field Diagnostic test before the Field Diagnostic test is stopped.

diagnostic start

Starts Field Diagnostic testing on the line card.

diagnostic stop

Stops an in-progress Field Diagnostic test.

diagnostic unload

Unloads the Field Diagnostic image from the line card and restores normal line card operation.

show diagnostic content

Shows the Field Diagnostic test list for a particular line card.

show diagnostic events

Displays the history of Field Diagnostic events since the last system reload.

show diagnostic ondemand settings

Shows the diagnostic on-demand settings.

show diagnostic result

Shows the results of the Field Diagnostic test.

show diagnostic status

Displays various status information, such as line card slot and name, Field Diagnostic image status, and previous Field Diagnostic test results.


diagnostic start

To begin a Field Diagnostic test after downloading the Field Diagnostic image to the line card, enter the diagnostic start command.

diagnostic start {{slot slot-number | subslot slot-number/subslot-number} test {all [port port-number | WORD | all]} | basic | default | per-port port-number | test-id-number | WORD}

Syntax Description

slot

Specifies that the line card downloading the Field Diagnostic image is in a full slot as opposed to a subslot.

subslot

Specifies that the line card downloading the Field Diagnostic image is in a subslot as opposed to a full slot.

slot-number

Specifies the number of the slot where the line card downloading the Field Diagnostic image is located on the router.

subslot-number

Specifies the number of the subslot where the line card downloading the Field Diagnostic image is located on the router.

test

Specifies the test to be run.

all

When used after the the test option, specifies that all of the Field Diagnostic tests that are available will be run on the specified line card, including the external loopback test.

When used after the all option, specifies that all interfaces on the line card should be tested using the external loopback test.

port

Indicates that a port for external loopback testing will need to be specified.

port-number

Specifies the port on the line card where the external loopback test should be run.

WORD

When used after the port option, specifies a range of ports to be tested using the external loopback test.

When used after the test option, specifies a specific test or range of tests to run. When using the WORD option, a test can be specified by number or a range of numbers (for instance, 1-4 to specify tests 1, 2, 3, and 4). A comma with no space afterward can be used to specify multiple tests or range of tests (for instance, a user can enter 1-3,7 to specify tests 1, 2, 3, and 7.)

The tests that are available on a particular line card and their associated numbers can be obtained by entering the show diagnostic content command.

basic

Specifies that the tests marked as basic (the tests marked as B in the show diagnostic content output) will be run during the test. Basic testing will find most hardware errors but does not run each individual test; basic testing is faster than other types of testing, however.

default

Specifies that the default test suite should be run. The default test suite for each line card is all of the individual tests except the external loopback test.
If no test is specified when entering the diagnostic start command, the default test suite is used.

per-port

Specifies that an external loopback test should be run

test-id-number

Specifies a specific test by number. The numbers that are associated with specific tests are given in the diagnostic start slot slot-number test ? command or show diagnostic content output.


Defaults

No default behavior or values.

Command Modes

Priviliged EXEC

Command History

Release
Modification

Release 12.2(16)BX

This command was introduced.


Usage Guidelines

This command can only be entered successfully if a Field Diagnostic image has already been loaded onto the line card that will be tested. The diagnostic load command is used to load a diagnostic image onto a line card.

The show diagnostic content command can be used to see which tests are run when basic or all is specified as the testing option. The show diagnostic content command also displays the tests that are available on a particular line card and their associated test numbers.

Examples

In the following example, the default test list is run for the line card in slot 2. The final lines of the output are shown to show that the line card passed the Field Diagnostic test.


Note If you enter the diagnostic start command during a telnet session, the test update messages (the messages that start with FDIAG [slot 2]> in the output below) will not appear as they do in the example below.


Router# diagnostic start slot 2 test default
Router#
FDIAG [slot 2]> Test ID(s) selected: 1-33

FDIAG [slot 2]> Running Field Diagnostics [Iteration #1] ...
FDIAG [slot 2]> Running MPC8260 Register Test {ID=1} ...
FDIAG [slot 2]> MPC8260 Register Test {ID=1} passed

FDIAG [slot 2]> Running MPC8260 Timer Test {ID=2} ...
FDIAG [slot 2]> MPC8260 Timer Test {ID=2} passed

FDIAG [slot 2]> Running 6P OC3 POS MPC8260 Port I/O Test {ID=3} ...
FDIAG [slot 2]> 6P OC3 POS MPC8260 Port I/O Test {ID=3} passed

FDIAG [slot 2]> Running march_dram_64 {ID=4} ...
FDIAG [slot 2]> march_dram_64 {ID=4} passed

FDIAG [slot 2]> Running bus_float_dram_64 {ID=5} ...
FDIAG [slot 2]> bus_float_dram_64 {ID=5} passed

FDIAG [slot 2]> Running data_pins_dram_64 {ID=6} ...
FDIAG [slot 2]> data_pins_dram_64 {ID=6} passed

FDIAG [slot 2]> Running SDRAM ECC Test {ID=7} ...
FDIAG [slot 2]> SDRAM ECC Test {ID=7} passed

(Additional display text ommitted)

Related Commands

Command
Description

diagnostic event-log size

Sets the size of the event table.

diagnostic load

Loads the Field Diagnostic image onto the line card.

diagnostic ondemand action-on-failure

Sets the number of errors allowed in the Field Diagnostic test before the Field Diagnostic test is stopped.

diagnostic ondemand iterations

Sets the number of times each specific Field Diagnostic test will be run when a Field Diagnostic test is initiated.

diagnostic stop

Stops an in-progress Field Diagnostic test.

diagnostic unload

Unloads the Field Diagnostic image from the line card and restores normal line card operation.

show diagnostic content

Shows the Field Diagnostic test list for a particular line card.

show diagnostic events

Displays the history of Field Diagnostic events since the last system reload.

show diagnostic ondemand settings

Shows the diagnostic on-demand settings.

show diagnostic result

Shows the results of the Field Diagnostic test.

show diagnostic status

Displays various status information, such as line card slot and name, Field Diagnostic image status, and previous Field Diagnostic test results.


diagnostic stop

To stop an in-progress Field Diagnostic test, enter the diagnostic stop command.

diagnostic stop {slot slot-number | subslot slot-number/subslot-number}

Syntax Description

slot

Specifies that the line card running the Field Diagnostic test is in a full slot as opposed to a subslot.

subslot

Specifies that the line card running the Field Diagnostic test is in a subslot as opposed to a full slot.

slot-number

Specifies the number of the slot where the Field Diagnostic test is running.

subslot-number

Specifies the number of the subslot where the Field Diagnostic test is running.


Defaults

No default behavior or values.

Command Modes

Priviliged EXEC

Command History

Release
Modification

Release 12.2(16)BX

This command was introduced.


Usage Guidelines

The diagnostic stop command can be entered at any time, even if a prompt is not present because the console is displaying diagnostic testing events. However, hitting Enter on your keyboard while a test is in progress will give you a router prompt and will make entering the diagnostic stop command easier.

This command is used to stop a diagnostic test that had been started previously using the diagnostic start command or was started automatically when the autostart option was entered when using the diagnostic load command. This command only stops the test; it does not remove the Field Diagnostic image from the line card. If you want to stop the Field Diagnostic test and put the line card online, use diagnostic unload after entering diagnostic stop.

Examples

In the following example, a diagnostic test on the line card in slot 6 is started and then stopped using the diagnostic stop command.

Router# diagnostic start slot 6 test all
Slot 6: Running test(s) 1-31 may disrupt normal system operation

Do you want to run disruptive tests? [no]: y
Router#

FDIAG [slot 6]> Running Field Diagnostics [Iteration #1] ...
FDIAG [slot 6]> Running MPC860 Register Test {ID=1} ...
FDIAG [slot 6]> MPC860 Register Test {ID=1} passed

FDIAG [slot 6]> Running MPC860 Register2 Test {ID=2} ...
FDIAG [slot 6]> MPC860 Register2 Test {ID=2} passed

FDIAG [slot 6]> Running MPC860 Timer Test {ID=3} ...
FDIAG [slot 6]> MPC860 Timer Test {ID=3} passed

FDIAG [slot 6]> Running OC12 POS MPC860 Port IO Test {ID=4} ...
FDIAG [slot 6]> OC12 POS MPC860 Port IO Test {ID=4} passed

FDIAG [slot 6]> Running march_dram_1 {ID=5} ...
Router# diagnostic stop slot 6
FDIAG [slot 6]> march_dram_1 {ID=5} stopped

FDIAG [slot 6]> Total testing time = 00:00:07.500

*May 14 11:16:47.489: %DIAG-6-DIAG_STOPPED: Slot 6: Diagnostic is stopped.

Related Commands

Command
Description

diagnostic event-log size

Sets the size of the event table.

diagnostic load

Loads the Field Diagnostic image onto the line card.

diagnostic ondemand action-on-failure

Sets the number of errors allowed in the Field Diagnostic test before the Field Diagnostic test is stopped.

diagnostic ondemand iterations

Sets the number of times each specific Field Diagnostic test will be run when a Field Diagnostic test is initiated.

diagnostic start

Starts Field Diagnostic testing on the line card.

diagnostic unload

Unloads the Field Diagnostic image from the line card and restores normal line card operation.

show diagnostic content

Shows the Field Diagnostic test list for a particular line card.

show diagnostic events

Displays the history of Field Diagnostic events since the last system reload.

show diagnostic ondemand settings

Shows the diagnostic on-demand settings.

show diagnostic result

Shows the results of the Field Diagnostic test.

show diagnostic status

Displays various status information, such as line card slot and name, Field Diagnostic image status, and previous Field Diagnostic test results.


diagnostic unload

To unload the Field Diagnostic on the line card and resume normal line card operation, enter the diagnostic unload command.

diagnostic unload {slot slot-number | subslot slot-number/subslot-number}

Syntax Description

slot

Specifies that the line card unloading the Field Diagnostic image is in a full slot as opposed to a subslot.

subslot

Specifies that the line card unloading the Field Diagnostic image is in a subslot as opposed to a full slot.

slot-number

Specifies the number of the slot where the line card unloading the Field Diagnostic image is located on the router.

subslot-number

Specifies the number of the subslot where the line card unloading the Field Diagnostic image is located on the router.


Defaults

No default behavior or values.

Command Modes

Priviliged EXEC

Command History

Release
Modification

Release 12.2(16)BX

This command was introduced.


Usage Guidelines

The show diagnostic result output will be lost once a Field Diagnostic image is successfully unloaded off a line card. If you want to retain the results of the Field Diagnostic test, enter show diagnostic result and copy the output into a separate file before entering diagnostic unload to unload the Field Diagnostic image off the line card.

Entering this command successfully will resume normal line card operation.

If a line card needs to be placed back online immediately and a Field Diagnostic test is in progress, enter diagnostic stop to stop the in-progress Field Diagnostic test before entering diagnostic unload to unload the Field Diagnostic image off the line card.

Examples

In the following example, the Field Diagnostic image is unloaded off of the line card in slot 2. Note that the command is not successfully executed until confirmed at the screen prompt.

Router# diagnostic unload slot 2
******************************************************************************
WARNING:All Field Diagnostics test results and information will be
unavailable to both the "show diagnostic result <target>" and
"show diagnostic content <target>" commands.
To save the test results, cancel the unloading process and enter
the "show diagnostic result <target>" command. Copy the output
into a file, then re-enter the "diagnostic unload <target>" command
to restore normal line card operation.
******************************************************************************
% Are you sure that you want to perform this operation? [no]:y
FDIAG [slot 2]> Unloading the Field Diagnostics image and restoring the original run-time image, please wait ...
FDIAG [slot 2]> Field Diagnostics image was successfully unloaded

Related Commands

Command
Description

diagnostic event-log size

Sets the size of the event table.

diagnostic load

Loads the Field Diagnostic image onto the line card.

diagnostic ondemand action-on-failure

Sets the number of errors allowed in the Field Diagnostic test before the Field Diagnostic test is stopped.

diagnostic ondemand iterations

Sets the number of times each specific Field Diagnostic test will be run when a Field Diagnostic test is initiated.

diagnostic start

Starts Field Diagnostic testing on the line card.

diagnostic stop

Stops an in-progress Field Diagnostic test.

show diagnostic content

Shows the Field Diagnostic test list for a particular line card.

show diagnostic events

Displays the history of Field Diagnostic events since the last system reload.

show diagnostic ondemand settings

Shows the diagnostic on-demand settings.

show diagnostic result

Shows the results of the Field Diagnostic test.

show diagnostic status

Displays various status information, such as line card slot and name, Field Diagnostic image status, and previous Field Diagnostic test results.


show diagnostic content

To show the Field Diagnostic test list for a line card with a loaded Field Diagnostic image, use the show diagnostic content command.

show diagnostic content {all | slot slot-number | subslot slot-number/subslot-number}

Syntax Description

all

Shows the test list for all line cards on the system.

slot

Shows the test list for the line card in a specified slot.

subslot

Shows the test list for the line card in a specified subslot.

slot-number

Specifies the slot number of the line card whose test list will be viewed.

subslot-number

Specifies the subslot number of the line card whose test list will be viewed.


Defaults

No default behavior or values.

Command Modes

EXEC and priviliged EXEC modes

Command History

Release
Modification

Release 12.2(16)BX

This command was introduced.


Usage Guidelines

It is important to note that the show diag and show diagnostic commands produce completely different outputs. Therefore, the show diagnostic output cannot be gathered using show diag because the autocomplete function will generate the show diag, not the show diagnostic, output. If you want to abbreviate the show diagnostic command, the shortest possible abbreviation is show diagn.

The output for the show diagnostic content command varies based on whether a Field Diagnostic image is or is not loaded onto a line card. If the line card contains a loaded Field Diagnostic image, the available test list will be presented in the show diagnostic content output. If the line card does not contain a loaded Field Diagnostic image, the output will indicate that a Field Diagnostic image is not available and will also contain a note regarding Field Diagnostic testing availability for the particular line card.

Examples

The following show diagnostic content output occurs when no Field Diagnostic image is loaded onto the line card in slot 2.

Router# show diagnostic content slot 2

Diagnostic[Slot 2]: Diagnostic is not available.

NOTE: The Field Diagnostic test suite is supported for this line card.
To run Field Diagnostic tests, download the Field Diagnostic image from
cisco.com to a TFTP server or a flash card and enter the "diagnostic
load" command.

The following show diagnostic content output occurs when a Field Diagnostic image is loaded onto the line card in slot 2. Note that the output assigns a test number to each test and reveals if the test is run when basic testing coverage is specified.

Router#show diagnostic content slot 2

Slot 2: 6oc3pos-1, 6 ports

Diagnostics test suite attributes:
B/* - Basic ondemand test / NA
P/V/* - Per port test / Per device test / NA
D/N/* - Disruptive test / Non-disruptive test / NA
S/* - Only applicable to standby unit / NA
U/* - Default non-intervention test / NA
L/* - External loopback test / NA

ID Test Name Attributes
==== ============================================ ============
1) MPC8260 Register Test ---------------------> B***U*
2) MPC8260 Timer Test ------------------------> B***U*
3) 6P OC3 POS MPC8260 Port I/O Test ----------> ****U*
4) MarchingPattern DRAM (64 Bit Access) ------> B***U*
5) BusFloat DRAM (64 Bit Access) -------------> ****U*
6) DataPins DRAM (64 Bit Access) -------------> ****U*
7) SDRAM ECC Test ----------------------------> B***U*
8) SRAM Test ---------------------------------> ****U*
9) CPLD Register Test ------------------------> B***U*
10) Barium Register Test ----------------------> B***U*
11) Barium Interrupt Test ---------------------> B***U*
12) FIB Register Test -------------------------> B***U*
13) FIB Interrupt Test ------------------------> B***U*
14) FIB SDRAM Memory Test ---------------------> B***U*
15) FIB Channel Memory Test -------------------> B***U*
16) FIB Statistic Memory Test -----------------> B***U*
17) FIB Descriptor Memory Test ----------------> B***U*
18) TIB Register Test -------------------------> B***U*
19) TIB Interrupt Test ------------------------> B***U*
20) TIB SDRAM Memory Test ---------------------> B***U*
21) TIB Channel Memory Test -------------------> B***U*
22) TIB Statistics Memory Test ----------------> B***U*
23) TIB Control Memory Test -------------------> B***U*
24) TIB SDRAM Parity Test ---------------------> B***U*
25) TIB Control Parity Test -------------------> B***U*
26) PM5351 1 Register Test --------------------> B***U*
27) PM5351 1 Interrupt Test -------------------> B***U*
28) PM5351 2 Register Test --------------------> B***U*
29) PM5351 2 Interrupt Test -------------------> B***U*
30) Barium Lpbk Datapath Test -----------------> ****U*
31) Barium CRC Test ---------------------------> ****U*
32) Parallel Lpbk Datapath Test ---------------> B***U*
33) Serial Lpbk Datapath Test -----------------> B***U*
34) External Lpbk Datapath Test ---------------> *P***L




Table 3 describes the significant fields shown in the display.

Table 3 show diagnostic content Field Descriptions 

Field
Description

ID

Provides the test ID number associated with a particular test.

Test Name

Provides the name of a specific test. It is important to note that the information in this field is not significant for users but is important for Cisco personnel attempting to troubleshoot a problem.

Attributes

The attributes section is organized by row and each row provides various information about the specific test. Each row contains one character that signifies.

Row 1 will contain one of the following characters:

B—Indicates the test is part of the basic test suite.

*—Indicates the test is not part of the basic test suite.

Row 2 will contain one of the following characters:

P—Indicates the test is a per-port test.

*—Indicates the test is not a per-port test.

Row 3 will contain one of the following characters:

*—This row will always contain this attribute. It means that the test cannot be run while the line card is online.

Row 4 will contain one of the following characters:

*—This row will always contain this attribute and this attribute has no meaning at this time.

Row 5 will contain one of the following characters:

U—Indicates the test is a non-intervention test.

*—Indicates the test is not a non-intervention test.

Row 6 will contain one of the following characters:

L—Indicates the test is an external loopback test.

*—Indicates the test is not an external loopback test.


Related Commands

Command
Description

diagnostic event-log size

Sets the size of the event table.

diagnostic load

Loads the Field Diagnostic image onto the line card.

diagnostic ondemand action-on-failure

Sets the number of errors allowed in the Field Diagnostic test before the Field Diagnostic test is stopped.

diagnostic ondemand iterations

Sets the number of times each specific Field Diagnostic test will be run when a Field Diagnostic test is initiated.

diagnostic start

Starts Field Diagnostic testing on the line card.

diagnostic stop

Stops an in-progress Field Diagnostic test.

diagnostic unload

Unloads the Field Diagnostic image from the line card and restores normal line card operation.

show diagnostic events

Displays the history of Field Diagnostic events since the last system reload.

show diagnostic ondemand settings

Shows the diagnostic on-demand settings.

show diagnostic result

Shows the results of the Field Diagnostic test.

show diagnostic status

Displays various status information, such as line card slot and name, Field Diagnostic image status, and previous Field Diagnostic test results.


show diagnostic events

To display the history of all Field Diagnostic events since the last system reload, enter the show diagnostic events command.

show diagnostic events [event-type {error | info | warning} | {slot slot-number | subslot slot-number/subslot-number}]

Syntax Description

event-type error

Shows only error-type events. An error-type event occurs when a test failure is detected by a Field Diagnostic test.

event-type info

Shows only info-type events. An info-type event could be one of many pieces of information regarding Field Diagnostic tests.

event-type warning

Shows only warning-type events. A warning-type event is any abnormal occurrence regarding the testing process itself that occurs with the Field Diagnostic image or the actual test.

slot

Specifies that the viewed diagnostic events will be from a full-slot line card.

subslot

Specifies that the viewed diagnostic events will be from a line card subslot.

slot-number

Specifies the slot number of the line card whose events will appear in the command output.

subslot-number

Specifies the subslot number of the line card whose events will appear in the command output.


Defaults

No default behavior or values.

Command Modes

EXEC and priviliged EXEC mode

Command History

Release
Modification

Release 12.2(16)BX

This command was introduced.


Usage Guidelines

It is important to note that the show diag and show diagnostic commands produce completely different outputs. Therefore, the show diagnostic output cannot be gathered using show diag because the autocomplete function will generate the show diag, not the show diagnostic, output. If you want to abbreviate the show diagnostic command, the shortest possible abbreviation is show diagn.

Examples

In the following example, a listing of error-type events is provided:

Router# show diagnostic events event-type error
Diagnostic events (storage for 500 events, 135 events recorded)
Event Type (ET): I - Info, W - Warning, E - Error

Time Stamp ET [Card] Event Message
------------------ -- --------------------------------------------------------
05/14 00:34:43.491 E [6/0] Timeout waiting for Field Diag image response
05/14 10:11:08.133 E [8/0] Failed to load Field Diag image for 4oc3atm-1
05/14 11:29:20.545 E [6/0] Minor Error Detected
05/14 11:31:57.677 E [6/0] Minor Error Detected
05/14 11:34:18.017 E [6/0] Minor Error Detected
05/14 11:34:49.353 E [6/0] Minor Error Detected
05/14 11:41:10.629 E [6/0] Minor Error Detected
05/14 11:41:55.793 E [6/0] Minor Error Detected

In the following example, a listing of info-type events is provided:


Router# show diagnostic events event-type info
Diagnostic events (storage for 500 events, 135 events recorded)
Event Type (ET): I - Info, W - Warning, E - Error

Time Stamp ET [Card] Event Message
------------------ -- --------------------------------------------------------
05/14 00:34:33.739 I [6/0] Loading Field Diag image in 1oc12pos-1
05/14 00:35:28.311 I [6/0] Field Diag image is loaded and running
05/14 10:10:45.665 I [8/0] Loading Field Diag image in 4oc3atm-1
05/14 10:23:24.797 I [6/0] MPC860 Register Test Passed
05/14 10:23:24.909 I [6/0] MPC860 Register2 Test Passed
05/14 10:23:25.373 I [6/0] MPC860 Timer Test Passed
05/14 10:23:59.065 I [6/0] march_dram_1 Passed
05/14 10:23:59.201 I [6/0] Sky4302RegTest_1 Passed

...(Additional display text omitted from this example)

In the following example, a listing of warning-type events is provided:


Router# show diagnostic events event-type warning
Diagnostic events (storage for 500 events, 135 events recorded)
Event Type (ET): I - Info, W - Warning, E - Error

Time Stamp ET [Card] Event Message
------------------ -- --------------------------------------------------------

No diagnostic log entry matches specified search criteria

Router#show diagnostic events slot 6
Diagnostic events (storage for 500 events, 135 events recorded)
Event Type (ET): I - Info, W - Warning, E - Error

Time Stamp ET [Card] Event Message
------------------ -- --------------------------------------------------------
05/14 00:34:33.739 I [6/0] Loading Field Diag image in 1oc12pos-1
05/14 00:34:43.491 E [6/0] Timeout waiting for Field Diag image response
05/14 00:35:28.311 I [6/0] Field Diag image is loaded and running
05/14 10:23:24.797 I [6/0] MPC860 Register Test Passed
05/14 10:23:24.909 I [6/0] MPC860 Register2 Test Passed
05/14 10:23:25.373 I [6/0] MPC860 Timer Test Passed
05/14 10:23:59.065 I [6/0] march_dram_1 Passed

...(Additional display test omitted from this example)

Table 4 show diagnostic events Field Descriptions 

Field
Description

Time Stamp

Provides the date and time of the message.

ET

Provides the event type information. This output will be one of the following three event types:

E—Error-type diagnostic event. An error-type event occurs when a test failure is detected by a Field Diagnostic test.

I—Info-type diagnostic event. An info-type event could be one of many pieces of information regarding Field Diagnostic tests.

W—Warning-type diagnostic event. A warning-type event is any abnormal occurence regarding the testing process itself that occurs with the Field Diagnostic image or the actual test.

Card

Specifies the slot of the line card where the diagnostic event occured.

Event Message

A text explanation of the diagnostic event.


Related Commands

Command
Description

diagnostic event-log size

Sets the size of the event table.

diagnostic load

Loads the Field Diagnostic image onto the line card.

diagnostic ondemand action-on-failure

Sets the number of errors allowed in the Field Diagnostic test before the Field Diagnostic test is stopped.

diagnostic ondemand iterations

Sets the number of times each specific Field Diagnostic test will be run when a Field Diagnostic test is initiated.

diagnostic start

Starts Field Diagnostic testing on the line card.

diagnostic stop

Stops an in-progress Field Diagnostic test.

diagnostic unload

Unloads the Field Diagnostic image from the line card and restores normal line card operation.

show diagnostic content

Shows the Field Diagnostic test list for a particular line card.

show diagnostic ondemand settings

Shows the diagnostic on-demand settings.

show diagnostic result

Shows the results of the Field Diagnostic test.

show diagnostic status

Displays various status information, such as line card slot and name, Field Diagnostic image status, and previous Field Diagnostic test results.


show diagnostic ondemand settings

To display the diagnostic on-demand settings, such as the run iteration and the action-on-failure settings, enter the show diagnostic ondemand settings command.

show diagnostic ondemand settings

Syntax Description

No keywords or variables.

Defaults

No default behavior or values.

Command Modes

EXEC and priviliged EXEC modes

Command History

Release
Modification

Release 12.2(16)BX

This command was introduced.


Usage Guidelines

It is important to note that the show diag and show diagnostic commands produce completely different outputs. Therefore, the show diagnostic output cannot be gathered using show diag because the autocomplete function will generate the show diag, not the show diagnostic, output. If you want to abbreviate the show diagnostic command, the shortest possible abbreviation is show diagn.

To change an on-demand setting, use the diagnostic ondemand command.

When viewing the output from this command, it is important to note that diagnostic on-demand settings are not saved to a configuration file. Therefore, if the diagnostic on-demand settings do not match a previous configuration, a likely reason is that the router has been reloaded since the settings were last configured. The desired settings can be set again using the diagnostic ondemand command.

Examples

In the following example, the diagnostic on-demand iteration and action-on-failure settings are changed using diagnostic ondemand iterations and diagnostic ondemand action-on-failure. The changed settings are then confirmed using show diagnostic ondemand settings.

Router# diagnostic ondemand iterations 2
Router# diagnostic ondemand action-on-failure stop
Router# show diagnostic ondemand settings
Ondemand Run Iterations = 2

Ondemand Action-on-Failure = STOP

Table 5 show diagnostic ondemand settings Field Descriptions 

Field
Description

Ondemand Run Interations

Shows the diagnositic ondemand run iteration setting, which is the number of times each individual diagnostic test will be run when tests are started.

Ondemand Action-on-Failure

Shows the action-on-failure setting. The action-on-failure setting is the instruction of what should be done when a test failure is detected. The following output can be generated using this command:

continue failure-limit—Specifies that testing should continue until the failure-limit, a digit representing a number of failed tests, is reached.

stop—Specifies that testing should stop when the first test failure is detected.


Related Commands

Command
Description

diagnostic event-log size

Sets the size of the event table.

diagnostic load

Loads the Field Diagnostic image onto the line card.

diagnostic ondemand action-on-failure

Sets the number of errors allowed in the Field Diagnostic test before the Field Diagnostic test is stopped.

diagnostic ondemand iterations

Sets the number of times each specific Field Diagnostic test will be run when a Field Diagnostic test is initiated.

diagnostic start

Starts Field Diagnostic testing on the line card.

diagnostic stop

Stops an in-progress Field Diagnostic test.

diagnostic unload

Unloads the Field Diagnostic image from the line card and restores normal line card operation.

show diagnostic content

Shows the Field Diagnostic test list for a particular line card.

show diagnostic events

Displays the history of Field Diagnostic events since the last system reload.

show diagnostic result

Shows the results of the Field Diagnostic test.

show diagnostic status

Displays various status information, such as line card slot and name, Field Diagnostic image status, and previous Field Diagnostic test results.


show diagnostic result

To show the results of the Field Diagnostic tests, use the show diagnostic result command.

show diagnostic result [{slot slot-number | subslot slot-number/subslot-number}] [detail]

Syntax Description

slot

Specifies that the test results will be viewed for a line card in a full slot.

subslot

Specifies that the test results will be viewed for a line card in a subslot.

slot-number

Specifies the slot number of the line card whose tests results will appear in the command output.

subslot-number

Specifies the subslot number of the line card whose tests results will appear in the command output.

detail

Specifies that the testing results be displayed in detailed format that includes statistical information for each line card.


Defaults

No default behavior or values.

Command Modes

EXEC and priviliged EXEC mode

Command History

Release
Modification

Release 12.2(16)BX

This command was introduced.


Usage Guidelines

The show diagnostic result command only generates output if the Field Diagnostic image is still loaded onto the line card. If the Field Diagnostic image has been unloaded from the line card, the show diagnostic result command will not display any test result output. If you want to unload the Field Diagnostic image from the line card and retain the diagnostic test results, enter show diagnostic result and copy and paste the output into a separate file before entering diagnostic unload to unload the Field Diagnostic image off the line card.

If a Field Diagnostic image has not been loaded onto a line card and show diagnostic result is entered, the show diagnostic result command output will indicate that a Field Diagnostic image has not been downloaded and a note will be generated that states whether the line card is supported by a Field Diagnostic image.

It is important to note that the show diag and show diagnostic commands produce completely different outputs. Therefore, the show diagnostic output cannot be gathered using show diag because the autocomplete function will generate the show diag, not the show diagnostic, output. If you want to abbreviate the show diagnostic command, the shortest possible abbreviation is show diagn.

Examples

In the following example, a diagnostic test has already been run on the line card in slot 6 and the results are now being viewed using the show diagnostic result command.

Router# show diagnostic result slot 6

Slot 6: 1oc12pos-1, 1 port

Overall diagnostic result: PASS

Test results: (. = Pass, F = Fail, U = Untested)

1) MPC860 Register Test ----------------------------> .
2) MPC860 Register2 Test ---------------------------> .
3) MPC860 Timer Test -------------------------------> .
4) OC12 POS MPC860 Port IO Test --------------------> .
5) march_dram_1 ------------------------------------> .
6) bus_float_dram_1 --------------------------------> .
7) data_pins_dram_1 --------------------------------> .
8) Sky4302ResetTest_1 ------------------------------> .
9) Sky4302RegTest_1 --------------------------------> .
10) Sky4302AISTest_1 --------------------------------> .
11) Sky4302InterruptTest_1 --------------------------> .
12) IbFpgaResetTest_fib -----------------------------> .
13) FIBRegTest_fib ----------------------------------> .
14) march_packet_mem_fib ----------------------------> .
15) OC12POSIbFpgaInterruptTest_fib ------------------> .
16) OC12POSIbFpgaParityTest_fib ---------------------> .
17) IbFpgaResetTest_tib -----------------------------> .
18) TIBRegTest_tib ----------------------------------> .
19) march_packet_mem_tib ----------------------------> .
20) OC12POSIbFpgaInterruptTest_tib ------------------> .
21) OC12POSIbFpgaParityTest_tib ---------------------> .
22) diag_plx_reset_0 --------------------------------> .
23) diag_plx_rw_0 -----------------------------------> .
24) diag_plx_int_0 ----------------------------------> .
25) diag_barium_reset_1 -----------------------------> .
26) diag_barium_rw_1 --------------------------------> .
27) OC12POSBariumInterruptTest_1 --------------------> .
28) OC12POSInternalLoopbackTest_1 -------------------> .
29) OC12POSTerminalLoopbackTest_1 -------------------> .
30) OC12POSSystembusLoopbackTest_1 ------------------> .
31) OC12POSBariumBpLoopbackTest_1 -------------------> .

Table 6 show diagnostic result Field Descriptions 

Field
Description

Overall diagnostic result

Provides the result of your last test.

Test results

Each section in the Test Results Output contains a test number, a test description, and the result. An example:

1) MPC860 Register Test--------------------------->.

In this line, the test ID is 1, the test description is "MPC860 Register Test", and the test passed (the "." is a character that indicates the test passed).

The following characters are used to indicate the test result:

.—Pass

F—Fail

U—Untested.


The following output shows detailed information for each Field Diagnostic test:

Router# show diagnostic result slot 6 detail

Slot 6: 4oc3atm-1, 4 ports

Overall diagnostic result: PASS

Test results: (. = Pass, F = Fail, U = Untested)

___________________________________________________________________________

1) MPC8260 Register Test ---------------------------> .

Error code ----------------------------------> 0 (DIAG_SUCCESS)
Total run count -----------------------------> 1
Last test execution time --------------------> Jan 30 2003 16:33:04
First test failure time ---------------------> n/a
Last test failure time ----------------------> n/a
Last test pass time -------------------------> Jan 30 2003 16:33:04
Total failure count -------------------------> 0
Consecutive failure count -------------------> 0
___________________________________________________________________________

2) MPC8260 Timer Test ------------------------------> .

Error code ----------------------------------> 0 (DIAG_SUCCESS)
Total run count -----------------------------> 1
Last test execution time --------------------> Jan 30 2003 16:33:05
First test failure time ---------------------> n/a
Last test failure time ----------------------> n/a
Last test pass time -------------------------> Jan 30 2003 16:33:05
Total failure count -------------------------> 0
Consecutive failure count -------------------> 0

...(Additional display text omitted from this example)


Table 7 show diagnostic result Field Descriptions 

Field
Description

Error code

Either 0 or 1. 0 means the test passed and 1 means the test failed.

Total run count

The total number of times the test has been run with the currently downloaded Field Diagnostic image. This number is reset to 0 if the Field Diagnostic image is unloaded off the line card.

Last test execution time

The last time the test was run with the currently downloaded Field Diagnostic image. This number is reset to 0 if the Field Diagnostic image is unloaded off the line card.

First test failure time

The first time a test failed during a test run by the currently downloaded Field Diagnostic image. This number is reset to 0 if the Field Diagnostic image is unloaded off the line card.

Last test failure time

The last time a test failed during a test run by the current Field Diagnostic image. This number is reset to 0 if the Field Diagnostic image is unloaded off the line card.

Last test pass time

The last time a test passed using the current Field Diagnostic image. This number is reset to 0 if the Field Diagnostic image is unloaded off the line card.

Total failure count

The total number of times the test has failed using the current Field Diagnostic image. This number is reset to 0 if the Field Diagnostic image is unloaded off the line card.

Consecutive failure count

The number of consecutive times the test has failed. This number is reset to 0 if the Field Diagnostic image is unloaded off the line card.



In the following example, the Field Diagnostic image is not loaded onto a line card and therefore produces a different output:

Router# show diagnostic result slot 2

Diagnostic[Slot 2]: Diagnostic is not available.

NOTE: The Field Diagnostic test suite is supported for this line card.
To run Field Diagnostic tests, download the Field Diagnostic image from
cisco.com to a TFTP server or a flash card and enter the "diagnostic
load" command.

Related Commands

Command
Description

diagnostic event-log size

Sets the size of the event table.

diagnostic load

Loads the Field Diagnostic image onto the line card.

diagnostic ondemand action-on-failure

Sets the number of errors allowed in the Field Diagnostic test before the Field Diagnostic test is stopped.

diagnostic ondemand iterations

Sets the number of times each specific Field Diagnostic test will be run when a Field Diagnostic test is initiated.

diagnostic start

Starts Field Diagnostic testing on the line card.

diagnostic stop

Stops an in-progress Field Diagnostic test.

diagnostic unload

Unloads the Field Diagnostic image from the line card and restores normal line card operation.

show diagnostic content

Shows the Field Diagnostic test list for a particular line card.

show diagnostic events

Displays the history of Field Diagnostic events since the last system reload.

show diagnostic ondemand settings

Shows the diagnostic on-demand settings.

show diagnostic status

Displays various status information, such as line card slot and name, Field Diagnostic image status, and previous Field Diagnostic test results.


show diagnostic status

To display status information, such as the line card slot and name, Field Diagnostic image status, and overall results from previous diagnostic tests, enter the show diagnostic status command.

show diagnostic status [slot slot-number | subslot slot-number/subslot-number] [detail]

Syntax Description

slot

Specifies that the status information will be viewed for a line card in a full slot.

subslot

Specifies that the status information will be viewed for a line card in a subslot.

slot-number

Specifies the slot number of the line card whose status information will appear in the command output.

subslot-number

Specifies the subslot number of the line card whose status information will appear in the command output.

detail

Specifies that the detailed status results will be displayed in the command output.


Defaults

No default behavior or values.

Command Modes

EXEC and priviliged EXEC mode

Command History

Release
Modification

Release 12.2(16)BX

This command was introduced.


Usage Guidelines

The show diagnostic status output reveals if a line card supports Field Diagnostic testing and if the line card has already downloaded a Field Diagnostic image. Therefore, the show diagnostic status command is useful as a reference before loading the Field Diagnostic image onto the line card.

It is important to note that the show diag and show diagnostic commands produce completely different outputs. Therefore, the show diagnostic output cannot be gathered using show diag because the autocomplete function will generate the show diag, not the show diagnostic, output. If you want to abbreviate the show diagnostic command, the shortest possible abbreviation is show diagn.

Examples

In the following example, the show diagnostic status command is used to view status information of the line card.

Router# show diagnostic status

==== ======================== ======= ========== =========== ==============
FDiag Loaded Overall Current
Slot Card Description Support Image Type Diag Result Card State
---- ------------------------ ------- ---------- ----------- --------------
A Secondary PRE1-RP NO IOS N/A OFFLINE
B Primary PRE1-RP NO IOS N/A ONLINE
2    6cht3-1 YES LCDOS N/A ONLINE
3/1 1gigethernet-hh-1 YES Field Diag PASS DIAG READY
6    4oc3atm-1 YES LCDOS N/A ONLINE
==== ======================== ======= ========== =========== ==============


Table 8 show diagnostic result Field Descriptions 

Field
Description

Slot

Identifies the slot on the router.

Card Description

A text explanation of the card in the specified slot.

FDiag Support

Indicates whether the car din the specific slot supports Field Diagnostic testing.

Yes—the card in the slot supports Field Diagnostic testing.

No—the card in the slot does not support Field Diagnostic testing.

Loaded Image Type

Specifies the runtime image for each card.

Field Diag—Indicates that the Field Diagnostic image is loaded on the line card. A line card will either have the Field Diagnostic or LCDOS image.

IOS—Specifies that the processor is running IOS.

LCDOS—line card DOS. The LCDOS image is the image the line card is running during normal router operation. It is removed temporarily when a Field Diagnostic image is loaded onto the line card and loaded back onto a line card when a Field Diagnostic image is unloaded.

Overall Diag Result

Displays the result of the last performed Field Diagnostic test, assuming the Field Diagnostic image has not been removed since the last test.

Pass—This card passed the last diagnostic test.

Fail—At least one Field Diagnostic test failed during the last diagnostic test.

N/A—This card has not been tested.

Current Card State

The current card state:

Diag Ready—a diagnostic image is loaded onto the card and Field Diagnostic tests can be run.

Offline—the card is not currently passing traffic and no Field Diagnostic image has been downloaded onto the card.

Online—the card is active and can pass traffic.



In the following example, the show diagnostic status command detailed results are shown.

Router# show diagnostic status slot 2 detail

Detail testing progress for card in slot 2:

Current card state:RUNNING DIAG
Test
ID Test Name [Selected To Run (Y/N)] Status
==== ============================================== =======
1) MPC8260 Register Test .................... [Y] Passed
2) MPC8260 Timer Test ....................... [Y] Passed
3) 6P OC3 POS MPC8260 Port I/O Test ......... [Y] Passed
4) march_dram_64 ............................ [Y] Running
5) bus_float_dram_64 ........................ [Y] Not Run
6) data_pins_dram_64 ........................ [Y] Not Run
7) SDRAM ECC Test ........................... [Y] Not Run
8) SRAM Test ................................ [Y] Not Run
9) CPLD Register Test ....................... [Y] Not Run
10) BariumRegTest ............................ [Y] Not Run
11) BariumIntTest ............................ [Y] Not Run
12) FIBRegTest_pm ............................ [Y] Not Run
13) FIBIntTest_pm ............................ [Y] Not Run
14) FIBSdramMemTest_pm ....................... [Y] Not Run
15) FIBChanMemTest_pm ........................ [Y] Not Run
16) FIBStatMemTest_pm ........................ [Y] Not Run
17) FIBDescMemTest_pm ........................ [Y] Not Run
18) TIBRegTest_pm ............................ [Y] Not Run
19) TIBIntTest_pm ............................ [Y] Not Run
20) TIBSdramMemTest_pm ....................... [Y] Not Run
21) TIBChanMemTest_pm ........................ [Y] Not Run
22) TIBStatMemTest_pm ........................ [Y] Not Run
23) TIBCtrlMemTest_pm ........................ [Y] Not Run
24) TIBSdramParityTest_pm .................... [Y] Not Run
25) TIBCtrlParityTest_pm ..................... [Y] Not Run
26) PM5351RegTest_1 .......................... [Y] Not Run
27) PM5351IntTest_1 .......................... [Y] Not Run
28) PM5351RegTest_2 .......................... [Y] Not Run
29) PM5351IntTest_2 .......................... [Y] Not Run
30) PMBariumLpbkTest ......................... [Y] Not Run
31) BariumCRCTest ............................ [Y] Not Run
32) PMParallelLpbkTest ....................... [Y] Not Run
33) PMSerialLpbkTest ......................... [Y] Not Run
34) PMExternalLpbkTest ....................... [N] -------
==== ============================================== =======




Table 9 show diagnostic result Field Descriptions 

Field
Description

Current card state

Specifies the card state. This field can generate the following states:

R

ID

The test identification number.

Test Name

The name of the test.

Selected to Run

Specifies whether the test was specified to run. Y means the test will be run and N means the test will not be run.

Test Status

Provides the current test status.



Related Commands

Command
Description

diagnostic event-log size

Sets the size of the event table.

diagnostic load

Loads the Field Diagnostic image onto the line card.

diagnostic ondemand action-on-failure

Sets the number of errors allowed in the Field Diagnostic test before the Field Diagnostic test is stopped.

diagnostic ondemand iterations

Sets the number of times each specific Field Diagnostic test will be run when a Field Diagnostic test is initiated.

diagnostic start

Starts Field Diagnostic testing on the line card.

diagnostic stop

Stops an in-progress Field Diagnostic test.

diagnostic unload

Unloads the Field Diagnostic image from the line card and restores normal line card operation.

show diagnostic content

Shows the Field Diagnostic test list for a particular line card.

show diagnostic events

Displays the history of Field Diagnostic events since the last system reload.

show diagnostic ondemand settings

Shows the diagnostic on-demand settings.

show diagnostic result

Shows the results of the Field Diagnostic test.



hometocprevnextglossaryfeedbacksearchhelp

Posted: Fri Feb 2 07:05:10 PST 2007
All contents are Copyright © 1992--2007 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.