About This Book

This guide that describes operational, SNMP, and informational traps generated by the LightStream 2020 enterprise ATM switch. The guide presents a trap overview and a description of each trap. The trap descriptions include the name of the trap, trap text, an explanation, and possible user actions.

Audience

The LightStream 2020 Traps Reference Guide is intended for anyone who operates or manages a LightStream network.

Users of the LightStream document set are expected to have a general understanding of basic data communications concepts, some knowledge of UNIX, and a familiarity with the interfaces used by the devices connecting to their LightStream network.

It is recommended that you have a working knowledge of TCP/IP networks. For more information about TCP/IP networks, refer to Internetworking with TCP/IP, Volume 1, Principals, Protocols, and Architecture, by Douglas E. Comer (Prentice-Hall Inc., 1991, ISBN 0-13-468505-9).

Operational TrapssDescribes the operational traps that may be generated by the LightStream switch.

SNMP TrapsDescribes the SNMP traps that may be generated by the LightStream switch.

Informational TrapsDescribes the informational traps that may be generated by the LightStream switch

Related Documentation

The following is a list of LightStream manuals and other material relevant to LightStream users.

LightStream 2020 System Overview

The system overview explains what a LightStream switch is and how it works. It outlines ATM technology and describes LightStream hardware and software.

LightStream 2020 Site Planning and Cabling Guide

The site planning and cabling guide (SPCG) tells you how to prepare your site to receive LightStream hardware. It includes space, environmental and electrical requirements, rack selection guidelines, requirements for the management workstation, and information on cables and connectors.

LightStream 2020 Installation and Troubleshooting Manual

The installation and troubleshooting manual (I&TM) tells you how to install LightStream hardware and software, how to diagnose hardware problems, and how to replace faulty hardware components.

LightStream 2020 Configuration Guide

The configuration guide provides the information you need to configure LightStream switches. It describes the configuration tools and how to use them. It describes the configuration database and defines all configurable attributes and their settings. The guide also provides step-by-step configuration procedures.

LightStream 2020 Operations Guide

The operations guide is a task-oriented book that tells you how to operate a network of LightStream switches. The guide presents an overview of network operations tasks, describes the command line interface (CLI), and presents procedures for performing monitor and control tasks such as displaying the status of nodes, cards and ports, viewing statistics, and creating collections of traffic data.

LightStream 2020 Administration Guide

The administration guide describes LightStream network management functions such as setting up a new network, troubleshooting, and optimizing the load across trunks. The guide describes network management tools, then presents step-by-step procedures for performing the functions.

LightStream 2020 Command and Attribute Reference Guide

The reference guide provides detailed descriptions of the syntax and functions of all CLI commands. It also indicates CLI equivalents of configuration procedures, describes the LightStream private MIB, and gives UNIX-style manual pages for selected LynxOS commands.

LightStream 2020 Command Line Interface (CLI) Reference Card

The reference card compactly summarizes the syntax and arguments of all CLI commands.

LightStream 2020 Release Notes

The release notes provide a software upgrade procedure and describe new features and special considerations, including information on known software bugs.

Note The release notes contain important information that does not appear in other documents.

Before attempting to install, configure, operate, or troubleshoot a network of LightStream switches, read the LightStream 2020 System Overview. This overview provides important background information about the LightStream product and the ATM technology on which the product is based. After reading the LightStream 2020 System Overview, refer to the Table 1-1 to determine which manuals you should read next

1We recommend that you review the release notes before attempting to install, configure, operate, or troubleshoot a LightStream switch. The release notes contain important information that does not appear in other documents.

Text Conventions

Table 1-2 describes conventions used to distinguish different types of text.

Table 1-2 Text Conventions

Convention

Purpose

Example

Bold screen

literal type

Screen

literal type

Boldface type

Italic type

Angle brackets <>

Square brackets

[ ]

Caret symbol

^

Curly braces

{ }

Represents user input.

Represents system output

Denotes names of commands, command arguments, and switches. Command names are case sensitive; enter them exactly as they appear in the text.

Used for titles of documents and for emphasis.

Indicate user-specified parameters or classes of user responses. When you see this notation in a syntax statement, make the substitution but do not type the angle brackets.

Indicate keys on the keyboard, or optional arguments or parameters for commands. You can omit optional arguments and parameters in any command.

When the caret symbol precedes a character, it refers to the control key.

Indicate a choice of arguments or parameters for commands. Arguments or parameters are separated by a vertical line {|}, and you must select one.

$ date

Wed May 6 17:01:03 EDT 1994

Issue the clear command.

LightStream 2020 Configuration Guide

File names are case sensitive.

If you see:
set port <c.p> <state>

you might type:

set port 4.3 active

Press [Return].

cli> help [<topic>]

^X is the same as [Control] X

cli> set cli traplevel {off|info|oper|trace|debug}

Traps Overview

LightStream 2020 enterprise ATM switches generate traps error and event messagesto indicate that a problem has occurred in your network or to tell you about a change in the status of the network. Refer to the chapters in this manual for details about the traps and instructions on how to respond (if necessary) to the traps. If you need further help interpreting traps, contact your customer support representative.

Trap Types

LightStream switches generate five types of traps:

SNMP

Operational

Informational

Trace

Debug

This manual devotes chapters to the SNMP, operational and informational traps you may encounter. Trace and debug traps, which are turned off in most networks, are not discussed in this manual.

SNMP Traps

The SNMP traps displayed by the LightStream switch are the standard SNMP traps defined by the SNMP MIB-2 specifications. These traps include the following information:

LightStream node name

System up time when the trap occurred

Trap name

Trap generation time

Port number associated with the trap

Operational Traps

Operational traps are divided into three categories:

Traps that provide information only

Note Traps in this category provide information only, such as the notification that a line card has come up.

Traps that require a response

Note Traps in this category indicate problems that you can usually fix by following the procedures described in this manual.

Traps that you should contact your customer support representative about

Note Traps in the this category indicate that there may be a problem with the LightStream software. These traps are very unlikely to occur. If you receive a trap from this category, it is important that you record it and contact your customer support representative immediately, so he or she can determine what actions should be taken.

To distinguish between the operational traps that you can respond to and the traps that you should contact your customer support representative about, look at the trap number. Trap numbers begin with a prefix for the software module in which they occur. The prefix is followed by a number between 1 and 1999. Operational traps that you can respond to using the information provided in this book are numbered between 1 and 999. Operational traps that you should contact your customer support representative about are numbered between 1000 and 1999.

Operational traps numbered over 999 are not listed in this document.

Informational Traps

Informational traps provide supplemental details on problems that are reported by operational and SNMP traps. Informational traps are used by customer support representatives to do advanced troubleshooting and software debugging. The following example shows the traps that a LightStream switch displays.

CAC Traps

mitLimit|caMinIntervalCaInfo> Mib Variable Hasn't Been Set by NMS, Defaulted to <default value>

Description

This trap indicates that the specified congestion avoidance attribute has not been configured for a particular line card. The trap appears each time the line card is started.

Action

Configure the three congestion avoidance attributes for each card using the configuration program.

Cardmon Traps

This section lists traps for the Card Monitor (CARDMON) module.

Trap Name

CARDMON_1

Trap Text

<number of discrepancies> table discrepancies on line card <card #>

Description

This trap lists the number of table discrepancies between the VCIs on a card and the VCIs in the NP software.

Possible Cause

Memory is corrupted or there is a software problem.

Action

1. Wait 30 seconds after receiving the trap and then use the check command from the cardmon tool to retest for discrepancies.

2. If you still have some discrepancies, wait 30 more seconds, then run the checkcommand again.

3. If you still have discrepancies and you know that the network is stable (connections are not being rerouted), either reboot the line card or call your customer support representative. If the network is not currently stable, wait until it is, then rerun the check command.

This trap reports that an attempt was made to configure the port to support a protocol that cannot be supported by the edge card as it is currently configured.

Possible Cause

This is typically caused by misconfiguring a port. Mixing edge and trunk port protocols on the same card is not allowed. Also, the selection of a card's protocols follows port 0. If port 0 is configured as an edge, all ports on that card will be restricted to edge protocols. If port 0 is configured as a trunk, all ports on that card will be restricted to trunk protocols.

Action

1. Send the correct configuration to the chassis that is sending the trap.

2. Configure all ports as either edge or trunk ports.

3. Configure port 0, even if it must be configured as a disabled port.

This trap reports that an attempt was made to configure the port to support a protocol that required a different edge card configuration. The EEPROM on the edge card will be changed and the card rebooted. When the line card restarts it should support the type of protocol that port 0 was configured with.

Possible Cause

This trap will often be sent when a new line card is put into a chassis. It will also occur when port 0 is changed from a trunk to an edge port or from an edge port to a trunk.

Action

1. This problem should be self-correcting.

2. The line card should automatically reconfigure and restart with no operator intervention.

3. If this trap recurs, run diagnostics on the line card. (Refer to the LightStream 2020 Installation and Troubleshooting Manual for instructions.)

This trap indicates that the MIB variable chassisId does not match the chassis ID configured in the EEPROM in the midplane.

Possible Cause

Your chassis ID has not been configured correctly or the midplane has been replaced and the correct chassis ID has not been configured.

Action

If you are just starting a new system, verify that the chassis ID in your configuration database matches the chassis ID in the EEPROM of the midplane. To see the chassis ID in the midplane, use the CLI command show tcs <SA|SB> midplane. If the configuration database does not use the same chassis ID, reconfigure the chassis ID in the configuration program.

If you have replaced the midplane, verify that the chassis ID for replacement midplane has been set to the same value as the chassis ID in the original midplane. (To set the chassis ID in the EEPROM, type set tcs <SA|SB> midplane nodeaddress <chassis ID>.The chassis ID is stored in two EEPROMs on the midplane and they must match. Issue the command twice, once for SA and once for SB. A detailed procedure for setting chassis IDs is provided in the LightStream 2020 Installation and Troubleshooting Manual.)

This trap indicates that the software checks provided by the LightStream configuration program failed to discover an overlap between the internal IP network and the ethernet IP network.

Possible Cause

There is a problem with the configuration program and the configured addresses.

Action

1. Use the configuration program to reconfigure these addresses on the screen titled IP Addresses Menu for LightStream 2020 Chassis.

2. Download the new configuration.

Trap Name

NPIP_4

Trap Text

configuration error: the internal IP network address is the same as the ethernet IP address

Description

This trap indicates that the software checks provided by the LightStream configuration program failed to discover that the internal IP network address and the ethernet IP address have been configured to the same value.

Possible Cause

There is a problem with the configuration program and the configured addresses.

Action

1. Use the configuration program to reconfigure these addresses on the screen titled IP Addresses Menu for LightStream 2020 Chassis.

2. Download the new configuration.

Trap Name

NPIP_5

Trap Text

configuration error: the default router is not on the same IP network as the ethernet interface

Description

This trap indicates that the software checks provided by the LightStream configuration program failed to discover that the default router is not configured correctly.

Possible Cause

There is a problem with the configuration program and the address.

Action

1. Use the configuration program to reconfigure this address on the screen titled IP Addresses Menu for LightStream 2020 Chassis.

2. Download the new configuration.

Trap Name

NPIP_6

Trap Text

configuration error: the primary and secondary NP IP addresses are not on the same IP network

Description

This trap indicates that the software checks provided by the LightStream configuration program failed to discover that the primary and secondary NP IP addresses are not configured correctly.

Possible Cause

There is a problem with the configuration program and the NP IP addresses.

Action

1. Use the configuration program to reconfigure these addresses on the screen titled IP Addresses Menu for LightStream 2020 Chassis.

NPTMM Traps

Initiating Card <1-10> Reset Due To Planned Cutover To Switch <A or B>

Description

Performing a cutover from one switch card to the other may cause other cards in the LightStream switch to automatically reset. This trap indicates which cards are reset as a result of planned cutover.

Action

No action is required.

Trap Name

NPTMM_2

Trap Text

Bulk Power Supply <A or B> Failed

Description

One of the bulk power supplies failed.

Action

Remove the failed power supply and replace it with a spare, as described in the LightStream 2020 Installation and Troubleshooting Manual. If your switch has two power supplies, the second one can fully power the switch while the failed one is being replaced.

Trap Name

NPTMM_4

Trap Text

Initiating Card <1-10> Reset Due To Unplanned Cutover to Switch <A or B>

Description

Cutting over from one switch card to the other may cause other cards in the LightStream switch to automatically reset. This trap indicates which cards are reset as a result of an unplanned cutover.

Action

If the switch card failed, you must replace it. (Refer to the LightStream 2020 Installation and Troubleshooting Manual for instructions.)

Trap Name

NPTMM_5

Trap Text

Operator Initiated Cutover to Switch <A or B>

Description

This trap is provided for information only. A user has instructed the system to make the backup switch card become the active (primary) switch card.

Action

No action is required.

Trap Name

NPTMM_6

Trap Text

<parameter name> of card <card #> is outside of the normal range

where

<parameter name> =

Temperature #1

Temperature #2

TCS VCC Voltage

VCC Voltage

SCSI Voltage (for NP)

VEE Voltage

VPP Voltage

Paddle Card Temperature #1

Paddle Card Temperature #2

Description

The specified value, monitored by the TCS, is outside of its normal range.

Action

1. For the temperature-related traps, verify that the ambient temperature in the room is within the range specified in the LightStream 2020 Site Planning and Cabling Guide. Also verify that the blowers are operating properly and that the air intakes on the LightStream switch are not blocked. See the LightStream 2020 Installation and Troubleshooting Manual for more troubleshooting information.

2. For the voltage-related traps, contact your customer support representative.

Trap Name

NPTMM_7

Trap Text

Clock From Switch <A or B> Failed On Card <card number>

Description

This trap indicates that the clock provided to the line cards from the switch card has failed. This indicates that there might be a hardware problem.

Action

Run diagnostics on the specified line card.

Trap Name

NPTMM_8

Trap Text

Card <card #> POST Failed; Download Is Not Initiated

Description

This trap indicates the power on self test failed. This indicates there might be a hardware problem.

Action

1. Review the results of the POST.

2. Reset the specified card and rerun the POST.

3. If the problem persists, run diagnostics on the specified card. If the diagnostics fail or if the card will not come up, replace the card. (Refer to the LightStream 2020 Installation and Troubleshooting Manual for instructions.)

Trap Name

NPTMM_9

Trap Text

Card <card #> Download Failed More Than <number of times download failed, default=2> Times; New Download Is Not Initiated

Description

This trap indicates the download of the specified card has failed multiple times. This indicates there may be a hardware problem.

Action

Run diagnostics on the specified card. If the diagnostics fail or if the card will not come up, replace the card. (Refer to the LightStream 2020 Installation and Troubleshooting Manualfor instructions.)

This trap indicates that a MIB object that you are monitoring has fallen below or has exceeded its threshold level.

Action

Varies depending on the object that is being monitored.

TRUNKMON Traps

This section lists traps for the Trunk Monitor (trunkmon) module. (Refer to the LightStream 2020 Administration Guide for a discussion of the trunkmon program.)

Trap Name

TRUNKMON_1

Trap Text

<number of discrepancies> discrepancies on port <nodename.card#.port#> (<# of seconds> second retry)

Description

This trap lists the number of discrepancies in the VCCs between two ports. If there are no discrepancies, the VCCs on both ports should match. If you receive this trap, the system has already retested once at the time interval specified in the trap. The default retry timer is 15 seconds.

Possible Cause

Memory is corrupted or there is a software problem.

Action

1. Wait 30 seconds after receiving the trap and then use the check command from the trunkmon tool to retest for discrepancies.

2. If you still have some discrepancies, wait 30 more seconds, then run the checkcommand again.

3. If you still have discrepancies and you know that the network is stable (connections are not being rerouted), deactivate the port on one end of the line, then reactivate it, or call your customer support representative. If the network is not currently stable, wait until it is, then rerun the checkcommand.

Watchdog Traps

The NDD process monitors all processes in the network and restarts them automatically when necessary. The watchdog process is used to monitor the status of NDD itself and determine when NDD needs to be restarted. This trap indicates that NDD has failed and that the watchdog process is rebooting the system to restart NDD. Once NDD is restarted, all other processes are restarted by NDD.

Action

This trap is provided for information only. If it occurs repeatedly, contact your customer support representative.

SNMP Traps

This chapter lists SNMP traps. If you need help interpreting these traps, contact your customer support representative.

SNMP Traps Listing

This section lists the SNMP traps for the LightStream 2020 enterprise ATM switch process that runs on the network processor.