[Top] [Prev] [Next] [Bottom]

Chapter 2

Router Diagnostic Program


This chapter describes the router diagnostic program including the two modes of operation and the error reporting/error logging functions. It includes the following sections:

General Description

Error Reporting

Error Logging

General Description

Using the router diagnostic program, you can do the following:

The CNX 600 standalone diagnostics can run from the DTE or DCE port. The port that receives the first character becomes the primary console port.

Figure 2-1 Router Diagnostic Menu Flow

If you did not boot the router diagnostic software, refer to Chapter 1. Once the router diagnostic program boots, the first menu that appears is the Mode Menu (Figure 2-1).

Figure 2-2 Mode Menu

Menu item 0 returns to the PROM monitor. Explanations of menu items 1 and 2 follow.

Automatic Mode

Automatic mode runs the diagnostic programs for all of the interface cards in the SRAM configuration using the default data values and flag settings of the router diagnostic system. It also displays the current hardware configuration which is initially obtained from the motherboard. You cannot change the hardware configuration while in automatic mode. Figure 2-2 shows a sample hardware configuration report.

Figure 2-3 Current Hardware Configuration Report

If the configurations on the current hardware configuration report are correct, enter y after the menu prompt. The router then executes the diagnostic programs for all of the network interface cards. If an interface card fails diagnostic testing, the console displays an error message and the router executes the next diagnostic program.

If the configurations on the current hardware configuration report are not correct, enter n. The console displays the following message and then returns to the Mode Menu.

Error in Configurations! Exiting automatic diagnostics 

If the configuration in SRAM is corrupted or empty, the console displays one of the following messages:

SRAM invalid.  Configure manually.

No configuration in SRAM. Configure manually.

To correct either condition, add the interface card to the system configuration using the Hardware Configuration Menu. To view additional information about an error, use the Error Log Display Menu. Both of these menus are available when the router is operating in manual mode which is explained in the next section.

Manual Mode

Manual mode executes the diagnostic programs for the network interface cards one at a time. It allows you to read, change, delete, and add to the hardware configuration. When you select manual mode, the console displays the Main Menu (Figure 2-4). The following sections describe the Main Menu items.

Figure 2-4 Main Menu

Start DDT Debugger

The DDT debugger is used by field service personnel.

Modify Hardware Configuration

This menu item allows you to read, change, delete, and add to the hardware configuration. It initially displays the current hardware configuration followed by the Hardware Configuration Menu (Figure 2-5).

Figure 2-5 Hardware Configuration Menu

Read Configuration from SRAM

This menu item reads the configuration in SRAM and displays the following message:

Reading from SRAM will overwrite any user altered configurations.

Do you want to continue? (y/n) [n]?

Enter n if you do not want to overwrite any configurations you have entered. Enter y to overwrite a configuration with the current configuration in SRAM.

Change One Interface's Configuration

This menu item changes the slot number for an interface card. There are two prompts to enter the current and new slot numbers. If you enter a slot number that is already configured, the console displays the message:

Slot # already configured

Enter a number that represents the new or current slot.

Delete One Interface's Configuration

This menu item deletes the configuration for a specific interface card. Enter the slot number of the interface card which you can obtain from the current hardware configuration report. If you enter a number that does not exist, the console displays the following message:

No such interface! Cannot delete.

Enter a new number or press Ò to exit the prompt and return to the Hardware Configuration Menu.

Add a Board to System Configuration

This menu item adds an interface card to the hardware configuration. Up to three interface cards are allowed in the configuration. If you attempt to add a fourth interface card, the console displays an error message. Select the type of interface card you want to add from the Configure a Board Menu (Figure 2-6) and a prompt appears to enter the slot number for that card.

Figure 2-6 Configure a Board Menu

Execute Diagnostics

This item displays the Diagnostic Execution Menu (Figure 2-7) which consists of two parts. The first part contains menu items 0 thru 4 which always appear on this menu. The second part lists each configured network interface card as an individual menu item. This part varies depending on the current hardware configuration.

The parentheses ( ) on the menu must contain a digit to run the diagnostic program for the specified card. Enter menu option 4 "Select All Diagnostics" to sequentially number all of the interface cards.

To select the interface cards individually, enter the menu item number listing the card and a number appears in the parentheses. To delete or change a number in the parentheses, enter the menu item number for the network interface card after the menu prompt. When you are done selecting the interface cards, enter menu option 3 "Execute Selected Diagnostics" to display the diagnostic main menu for the interface card numbered 1. Then, go to the chapter that describes the diagnostic program for the specific interface card.

Figure 2-7 Diagnostic Execution Menu

Setup Diagnostic Parameters

This menu item displays the Router Diagnostic Parameters Setup Menu (Figure 2-8) to configure various test parameters. To use the system defaults for items 1 thru 10, select menu item 11. Or, select each item individually and enter the value.

Menu Item Function
0. Return to previous menu Displays the previous menu.
1. Set Number of Passes
Displays the prompt:
How many passes would you like to
make [0 = forever] [1]:

2. Set Packet Size
Displays the prompts:
Enter data size in decimal bytes
[1 to 4500][100]:
Packet size transformation: [0 =
random; 1 = none; 2 = increment]
[0]:

3. Set Data Pattern
Displays the prompts: 
Select seed for packet pattern
generator [4 digits, hex] [0]:
Pattern transformation: [0 =
random; 1 = none; 2 = increment;
3 = rotate] [0]:

(continues)

Menu Item Function
4. Set Number of Packets
Displays the prompt: 
How many packets [1-4294967294][1]:

5. Set Network Interrupt Mode
Displays the prompt: 
Network interrupt mode: [0 =
interrupts disabled; 1 = interrupts
enabled] [0]:

6. Set DMA Mode
Displays the prompt: 
DMA mode: [0 = DMA disabled; 1 =
DMA enabled] [0]:

7. Set Node IP Address
Displays the prompt: 
Input IP address [128.185.124.38]:.

8. Set Destination Node IP Address
Displays the prompt:
Input IP address [128.185.124.39]:.

9. Set Delay Between Packets
Displays the prompt: 
Enter delay between packets [0 <=
delay <= FFFF] [0]:

10. Display Current
Parameter Setup
Displays the following current parameter settings:
Number of passes:
Packet size: Transfer Mode:
Data pattern: Transfer Mode:
Number of packets:
Network interrupt mode:
DMA:
Node IP address for port #::
Destination node IP address for
port #:
Inter packet delay:

11. Set Parameters to Default Values Sets menu items 1 through 10 to the system
defaults.

Figure 2-8 Router Diagnostic Parameters Setup Menu

Toggle Diagnostic Flags

This menu item displays the Router Diagnostic Flow Control Flags Menu (Figure 2-9) to toggle various diagnostic flags.

Figure 2-9 Router Diagnostic Flow Control Flags Menu

By default all of the flags are off. To turn a flag on, enter the menu item number after the prompt. To toggle the same flag off, enter the same menu item number after the prompt.

Item 10 turns all of the flags off. Item 11 displays the Error Log Menu. For details about this menu, refer to the section about error logging that appears later in this chapter.

To enable and view the error log messages and statistics, toggle the following flags off:

The diagnostic executive system uses the following flags:

Individual diagnostics use the following flags:

Execute Selected Diagnostics

Executes the interface diagnostic programs individually or as a group. To run the interface diagnostic programs one at a time, enter the menu item numbers listing the interface cards you want to test. A number appears in the menu item parentheses to indicate the running order for the diagnostic programs. Enter 3 to execute the diagnostic programs. A diagnostic main menu appears for the first interface diagnostic program. The chapter about the diagnostic program for the specific interface card describes this menu.

To run all of the interface diagnostic programs, select 4 from the Diagnostic Execution Menu. This sequentially numbers the interface cards as they are listed on the menu. Then, enter 3 to execute the diagnostic programs. When a diagnostic test fails, the console displays an error message and returns to the Diagnostic Execution Menu. If all of the diagnostic programs pass without errors, the console displays a pass message. The test suite repeats for the number of passes specified in the Router Diagnostic Parameters Setup Menu.

Select All Diagnostics

Selects all of the interface cards listed on the Diagnostic Execution Menu. Enter 3 on the Diagnostic Execution Menu to execute the selected diagnostic programs.

Deselect All Selected Diagnostics

Deselects the diagnostic programs currently selected.

CNX 600 I/O Tests

Tests the functionality of the floppy drive and internal modem and resets the motherboard. This menu item displays the CNX 600 I/O Tests Menu (Figure 2-10).

Menu Item Function
0. Return to previous menu Displays the previous menu.
1. Floppy Tests Writes to every track and tests whether the writes are to the correct header track. This item displays the Floppy Tests Menu (Figure 2-11).
CAUTION:

2. Modem Tests Tests the auto answer/auto dialing functions of the internal modem. This item displays the Modem Test Menu (Figure 2-12).
A. Toggle Diagnostic Flags Displays the Router Diagnostic Flow Control Flags Menu.
B. Setup Diagnostic Parameters Displays the Router Diagnostic Parameters Setup Menu.
C. Reset Motherboard Initializes and resets the motherboard.

Figure 2-10 CNX 600 I/O Tests Menu

Menu Item Function
0. Return to previous menu Displays the previous menu.
1. Floppy Tests Test whether writes to every track on the diskette occur.
CAUTION:

2. Modem Tests Tests whether writes are made to the correct header track.
CAUTION:

A. Toggle Diagnostic Flags Displays the Router Diagnostic Flow Control Flags Menu.
B. Setup Diagnostic Parameters Displays the Router Diagnostic Parameters Setup Menu.
C. Reset Motherboard Initializes and resets the motherboard.

Figure 2-11 Floppy Tests Menu

Menu Item Function
0. Return to previous menu Displays the previous menu.
1. Auto Dialing Test Tests whether the internal modem can call the DTE modem. This item displays the Auto Dialing/Answer Test Menu (Figure 2-13) .
2. Auto Answer Test Tests whether the DTE modem calls the internal modem. This item displays the Auto Dialing/Answer Test Menu (Figure 2-13).
A. Toggle Diagnostic Flags Displays the Router Diagnostic Flow Control Flags Menu.
B. Setup Diagnostic Parameters Displays the Router Diagnostic Parameters Setup Menu.
C. Set Modem Parameters Displays the Set Modem Parameters Menu
(
Figure 2-14).
Note: Note: To run the modem tests, two analog phone lines are required.

Figure 2-12 Modem Test Menu

Menu Item Function
0. Return to previous menu Displays the previous menu.
1. Baud Rate: 300 Tests the modem at 300 bps.
2. Baud Rate: 1200 Tests the modem at 1200 bps.
3. Baud Rate: 2400 Tests the modem at 2400 bps.
4. All of the Above Tests the modem at 300, 1200, and 2400 bps.
A. Toggle Diagnostic Flags Displays the Router Diagnostic Flow Control Flags Menu.
B. Setup Diagnostic Parameters Displays the Router Diagnostic Parameters Setup Menu.
C. Set Modem Parameters Displays the Set Modem Parameters Menu (Figure 2-14).

Figure 2-13 Auto Dialing/Answer Test Menu

Menu Item Function
0. Return to previous menu Displays the previous menu.
A. Toggle Diagnostic Flags Displays the Router Diagnostic Flow Control Flags Menu.
B. Setup Diagnostic Parameters Displays the Router Diagnostic Parameters Setup Menu.
C. Set DTE Modem Phone Number Sets the phone number the DTE uses to call the internal modem.
D. Set Internal Modem Phone Number Sets the phone number the internal modem uses to call the DTE modem.

Figure 2-14 Set Modem Parameters Menu

Procedure to Run Modem Tests

To run the modem tests, the following are required:

The procedure to run the modem test is:

1. Select the option "Setup Modem Parameters" from the Modem Test Menu. This displays the Set Modem Parameters Menu.
2. Set the DTE and internal phone numbers by selecting options C and D from the Set Modem Parameters Menu.
3. Connect the internal modem to an analog phone line.
4. Connect the DTE port to its modem which is, in turn, connected to its analog phone line.
5. Return to the Auto Dialing/Answer Test Menu.
6. Select a baud rate from the Auto Dialing/Answer Test Menu to run the test.

Error Reporting

There is a standard error reporting mechanism for all of the diagnostic programs. However, the type of error report the system generates depends on whether the system is operating in automatic or manual mode. The following sections describe the report types for the two modes.

Error Report for Automatic Mode

At the end of each pass, the diagnostic executive system checks for errors. When an interface card fails a diagnostic test, the console displays the following single line error message:

board name at CSR = CSR address Board failed diagnostics

For example:

TOKEN-RING at CSR = 0x8000000 Board failed diagnostics

To view additional information about the error, use the Error Log Display Menu. The section that follows about error logging describes this menu.

Error Report for Manual Mode

When an interface card fails a diagnostic test in manual mode, an error report appears in the following format:

Name of Diagnostic  Slot # = #  INT LEVEL = #
Group Name:
Test Name:
Sub_test Name:
Error Message:

The name of the diagnostic, slot #, and int level # appear only on the first error message for the particular interface card. All of the reports include the Group Name, Test Name, and Error Message. The console displays the Sub_test Name only when applicable. Figure 2-15 is an example of an error report for a single Ethernet interface card.

If the Continue on Error flag from the Router Diagnostic Flow Control Flags Menu is off, the following message appears after the error report:

Please type `S' to stop or any other key to continue:  

Enter S to return to the previous menu, or press any other key to continue testing.

Figure 2-15 Error Report

Error Logging

To view the error log messages and statistics, select Display Error Log Menu from the Router Diagnostic Flow Control Flags Menu. The Error Log Display Menu (Figure 2-16) appears.

Figure 2-16 Error Log Display Menu

Return Back

Displays the previous menu.

Show Error Log Messages

Displays the currently logged error messages and includes the following prompt:

Please select N, P, E, +#, -#, ?[N]

Table 2-1 explains these prompt selections.

Table 2-1
Option Description
N Displays the next error message.
P Displays the previous error message.
E Returns to the Error Log Display Menu.
+# Skips the requested number of messages and displays that message.
-# Goes back the requested number of messages and displays that message.
? Displays the above information about these options.
Show Error Log Prompt Options

The default for the prompt is N to display the next message. After showing a message, the default changes to P to display the previous message.

If you enter an invalid error message number, the console displays the following message:

*** Out of range, please select again ***

Enter a valid number, and the console displays an error log message similar to
Figure 2-17.

Figure 2-17 Error Log Message

Show Error Log Statistics

This menu item displays the following information:

Clear Error Log

The error log system clears the error log buffers.



[Top] [Prev] [Next] [Bottom]

docs@openroute.com
Copyright © 1997, OpenROUTE Networks, Inc. All rights reserved.