PREV NEXT INDEX

Avici Systems Inc.


SNMP

The Simple Network Management Protocol (SNMP) communicates management information between the network management stations and an SNMP agent on the Avici router.

Use the procedures described in this chapter to configure the SNMP agent on the Avici router to send reports (traps) to up to five network management stations when certain events or errors occur.

This chapter describes the procedures to:

Related Information

Administrators should be familiar with SONET and IP operation and theory before configuring the Avici router to run SNMP. The following are recommended as further reading:

RFC Information

This implementation of SNMP Version 3 complies with the following RFCs:

Configuring SNMP

There are two distinct sets of tasks to configure SMNP on the Avici router:

Configuring Global SNMP

Use the procedures described in this section to configure the global attributes of SNMP on the Avici router.

PROCEDURE: Use the following steps to configure SNMP hosts, administrative information, and enable SNMP on the Avici router:

Step 1 Use the snmp-server host command to:

Table 10-1. SNMP Trap Categories
Trap-category Description

bay-controller

Allows bay controller traps

bgp

Allows BGP state change traps

comp-link

Allows Composite Link traps

environment

Allows environmental monitoring traps, including:

  • fans

  • temperature

  • voltage

gbe

Allow gigabit ethernet traps

ldp

Allow LDP traps

link-up-down

Allows Link Up/Down traps.

module

Allows module traps.

msdp

Allows MSDP traps.

ospf

Allows OSPF traps.

pim

Allows PIM (Multicast) traps.

rmon

Allows RMON traps.

snmp

Allows SNMP traps.

sonet

Allows SONET traps.

te

Allows Traffic Engineering traps

qos

Allows Quality of Service traps

Step 2 Repeat Step 1 for up to 5 SNMP hosts.

Step 3 Use the snmp-server community command to:

Table 10-2. Traps Disabled by Default 
Traps Disabled by Default Description

sonet-line-far-end

Generates a SNMP trap when the number of cv-rising, es-rising, ses-rising, or uas-rising errors encountered by a SONET/SDH path entity in a particular 15 minute interval rise above thresholds defined by the sonet threshold line-far-end command.

sonet-path-far-end

Generates a SNMP trap when the number of cv-rising, es-rising, ses-rising, or uas-rising errors encountered by a SONET/SDH path entity in a particular 15 minute interval rise above thresholds defined by the sonet threshold path-far-end command.

sonet line cv-rising

Generates a SNMP trap when the number of Coding Violations (CV) encountered by a SONET/SDH line entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold line command.

sonet line es-rising

Generates a SNMP trap when the number of Errored Seconds (ES) encountered by a SONET/SDH line entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold line command.

sonet line

ses-rising

Generates a SNMP trap when the number of Severely Errored Seconds (SES) encountered by a SONET/SDH line entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold line command.

sonet line

uas-rising

Generates a SNMP trap when the number of Unavailable Seconds (UAS) encountered by a SONET/SDH line entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold line command.

sonet path cv-rising

Generates a SNMP trap when the number of Coding Violations (CV) encountered by a SONET/SDH path entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold path command.

sonet path es-rising

Generates a SNMP trap when the number of Errored Seconds (ES) encountered by a SONET/SDH path entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold path command.

sonet path ses-rising

Generates a SNMP trap when the number of Severely Errored Seconds (SES) encountered by a SONET/SDH path entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold path command.

sonet path uas-rising

Generates a SNMP trap when the number of Unavailable Seconds (UAS) encountered by a SONET/SDH path entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold path command.

sonet section cv-rising

Generates a SNMP trap when the number of Coding Violations (CV) encountered by a SONET/SDH section in a particular 15 minute interval rises above a threshold defined by the sonet threshold section command.

sonet section es-rising

Generates a SNMP trap when the number of Errored Seconds (ES) encountered by a SONET/SDH section in a particular 15 minute interval rises above a threshold defined by the sonet threshold section command.

sonet section sefs-rising

Generates a SNMP trap when the number of Severely Errored Framing Seconds (SEFS) encountered by a SONET/SDH section in a particular 15 minute interval rises above a threshold defined by the sonet threshold section command.

sonet section ses-rising

Generates a SNMP trap when the number of Severely Errored Seconds (SES) encountered by a SONET/SDH section in a particular 15 minute interval rises above a threshold defined by the sonet threshold section command.

Step 8 Use the show snmp command to display the SNMP configuration.

In the following example:

router#show snmp

Name:router

Contact:snmp@avici.comshow sn

Location:Sunnyvale Lab Bldg. 14 Row 7

EngineId : 0011223344556677P8899

Engine Boots : 0

Name: router

Contact: Avici Systems, Inc.

101 Billerica AveNorth Billerica, MA 01862

Phone: 1-TSR-BY-AVICI (1-877-292-8424)

Email: support@avici.com

Web: www.avici.comLocation: Massachusetts

28 SNMP Packets Input

          0 SNMP Errors

0 Bad SNMP Version Errors

0 Bad Community Name Errors

0 Bad Community Uses Errors

0 ASN Parse Errors

0 Too Big Errors

0 No Such Name Errors

0 Bad Values Errors

0 Read Only Errors

          0 General Errors

          0 Unknown Security Models

          0 Unavailable Contexts

0 Total Request Variables

0 Get Requests

0 Get-Next Requests

0 Set Requests

0 Total Set Variables

42 SNMP Packets Output

          0 Too Big Errors

0 No Such Name Errors

0 Bad Values Errors

         0 General Errors          Unavailable Contexts

0 Get Response

  42 Traps Sent

0 SNMP Errors

          0 Invalid Message Report PDUs

          0 Unknown PDU Handler Report PDUs

          0 Unknown Context Report PDUs

          0 Unsupported Security Level Report PDUs

          0 Not in time Window Report PDUs

          0 Unknown Username Report PDUs

          0 Unknown Engine ID Report PDUs

          0 Wrong Digest Report PDUs

          0 Decryption Error Report PDUs

Trap Configuration

SNMP Authentication Enabled

Fan Enabled

Temperature Enabled

Voltage Enabled

Link Up/Down Enabled

Sonet Enabled

BGP Enabled

OSPF Enabled

Bay Controller Enabled

Module Enabled

Rmon Enabled

PIM Enabled

       SNMP     LDP Enabled

TE Enabled

QoS Enabled



Host   : 192.32.228.11    Type          : trap    User          : SNMP_trap    Security Model: V2    Security Level: noauth    Trap Category  : bgp environment link-up-down ospf rmon snmp    sonet                     bay-controller module pim msdp ldp te comp-link qos gbe

Host   : 10.5.1.110    Type          : trap    User          : SNMP_trap    Security Model: V1    Security Level: noauth    Trap Category  : bgp environment link-up-down ospf rmon snmp    sonet                     bay-controller module pim msdp ldp te comp-link qos gbe

SNMP View

      View Name : internetview    Subtree OID : internet    View Type : included    View Name : v1default    Subtree OID : iso    View Type : included

SNMP Group

      Group Name : Boston22    Security Model : V3    Security Level : noauth    Read View : v1default    Write View : <none>    Notify View : notifyname     Access List : level2users

SNMP User

       User Name : engineerbill     Auth Protocol : md5     Priv Protocol : des56     Access List : <none>

Configuring SNMP on Interfaces

Use the procedures described in this section to:

SNMP Default Settings

IPriori includes a variety of default settings for SNMP. You can accept many of these defaults and therefore skip some steps of configuring SNMP on a POS interface. The defaults are as follows:

Table 10-3. SNMP Default Settings 
Command Trap(s) Enabled by Default Description of Default Setting

snmp trap link-status

Link-up/link-down.

Generates a SNMP trap when a link state changes from up to down or down to up.

snmp trap sonet line

Failure traps reported:

  • AIS-failure

  • RFI failure

Failure traps and failure clear traps are reported. All other traps disabled.

snmp trap sonet link-status

SONET link up/link down traps.

Generates a SONET link up/link down trap after the setting or clearing of SONET interface defect conditions.

snmp trap sonet line-far-end

None.

snmp trap sonet path

Failure traps reported:

  • AIS-failure

  • LOP-failure

  • PLM failure

  • RFI-failure

  • UNEQ-failure

Failure traps and failure clear traps are reported. All other traps disabled.

snmp trap sonet path-far-end

None.

snmp trap sonet section

Failure traps reported:

  • LOF-failure

  • LOS-failure

Failure traps and failure clear traps are reported. All other traps disabled.

Modifying SNMP Settings

Use the procedures described in this section to modify the SNMP default settings.

Modifying Link-Status

By default, SNMP sends a trap every time an interface changes state from link-up to link-down or vice versa.

Use the no snmp trap link-status command to disable the interface from sending the link-up/link-down traps:

router#configure terminal

Enter configuration commands, one per line. End with CNTL/Z.

router(config)#interface pos 1/1/1

router(config-if)#no snmp trap link-status

router(config-if)#end

Modifying SONET Link Up/Link Down Traps

By default, SNMP sends a trap every time a SONET interface experiences a defect and a second trap when the defect clears. Defects include:

Use the no snmp trap sonet link-status command to disable SNMP sending SONET link up/link down SNMP traps:

router#configure terminal

Enter configuration commands, one per line. End with CNTL/Z.

router(config)#interface pos 1/15/1

router(config-if)#no snmp trap sonet link-status

router(config-if)#end

router#

Modifying SONET Line Traps

IPriori supports the following SONET line traps:

Table 10-4. SONET Line Traps Supported
Line Traps Descriptions

ais-failure

Generates a SNMP trap when an Alarm Indication Signal (AIS) is received.

ais-failure-cleared

Generates a SNMP trap when an alarm indication signal is cleared.

cv-rising

Generates a SNMP trap when the number of Coding Violations (CV) encountered by a SONET/SDH line entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold line command.

es-rising

Generates a SNMP trap when the number of Errored Seconds (ES) encountered by a SONET/SDH line entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold line command.

rfi-failure

Generates a SNMP trap when a Remote Failure Indication (RFI) is received

rfi-failure-cleared

Generates a SNMP trap when a remote failure indication is cleared.

ses-rising

Generates a SNMP trap when the number of Severely Errored Seconds (SES) encountered by a SONET/SDH line entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold line command.

uas-rising

Generates a trap when UAS is rising about a defined threshold.

By default, the failure traps and failure clear traps are enabled and all other SONET line traps are disabled.

Use the snmp trap sonet line command to enable additional traps:

router#configure terminal

Enter configuration commands, one per line. End with CNTL/Z.

router(config)#interface pos 1/1/1

router(config-if)#snmp trap sonet line ses-rising

router(config-if)#end

Enabling SONET Line-Far-End Traps

IPriori supports the following SONET Line-Far-End traps:

Table 10-5. SONET Line-Far-End Traps Supported
Traps Descriptions

cv-rising

Generates a SNMP trap when the number of Coding Violations (CV) encountered by a SONET/SDH line-far-end entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold line-far-end command.

es-rising

Generates a SNMP trap when the number of Errored Seconds (ES) encountered by a SONET/SDH line-far-end entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold line-far-end command.

ses-rising

Generates a SNMP trap when the number of Severely Errored Seconds (SES) encountered by a SONET/SDH line-far-end entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold line-far-end command.

uas-rising

Generates a SNMP trap when the number of UnAvailable Seconds (UAS) encountered by a SONET/SDH line entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold line-far-end command.

By default, these traps are not enabled.

Use the snmp trap sonet line-far-end command to enable one or more of these traps:

router#configure terminal

Enter configuration commands, one per line. End with CNTL/Z.

router(config)#interface pos 1/1/1

router(config-if)#snmp trap sonet line-far-end es-rising

router(config-if)#snmp trap sonet line-far-end ses-rising

router(config-if)#snmp trap sonet line-far-end uas-rising

router(config-if)#end

router#

Modifying SONET Path Traps

IPriori supports the following SONET path traps:

Table 10-6. SONET Path Traps Supported 
Path Description

ais-failure

Generates a SNMP trap when an Alarm Indication Signal (AIS) is received.

ais-failure-cleared

Generates a SNMP trap when an alarm indication signal event is cleared.

cv-rising

Generates a SNMP trap when the number of Coding Violations (CV) encountered by a SONET/SDH path entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold path command.

es-rising

Generates a SNMP trap when the number of Errored Seconds (ES) encountered by a SONET/SDH path entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold path command.

lop-failure

Generates a SNMP trap when a Loss Of Pointer defect (LOP) is received

lop-failure-cleared

Generates a SNMP trap when an loss of pointer event is cleared.

plm-failure

Generates a SNMP trap when a Path Label Mismatch (PLM) defect is received

plm-failure-cleared

Generates a SNMP trap when a path label mismatch defect is cleared.

rfi-failure

Generates a SNMP trap when a Remote Failure Indication (RFI) is received

rfi-failure-cleared

Generates a SNMP trap when a remote failure indication is cleared.

ses-rising

Generates a SNMP trap when the number of Severely Errored Seconds (SES) encountered by a SONET/SDH path entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold path command.

uas rising

Generates a SNMP trap when the number of UnAvailable Seconds (UAS) encountered by a SONET/SDH path entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold path command.

uneq-failure

Generates a SNMP trap when an Unequipped (UNEQ) defect is received

uneq-failure-cleared

Generates a SNMP trap when a unequipped event is cleared.

By default, the failure traps and failure clear traps are enabled, and all other SONET path traps are disabled.

Use the snmp trap sonet path command to enable additional trap(s):

router#configure terminal

Enter configuration commands, one per line. End with CNTL/Z.

router(config)#interface pos 1/1/1

router(config-if)#snmp trap sonet path ses-rising

router(config-if)#end

router#

Enabling SONET Path-Far-End Traps

IPriori supports the following SONET Path-Far-End traps:

Table 10-7. SONET Path-Far-End Traps Supported 
Path Description

cv-rising

Generates a SNMP trap when the number of Coding Violations (CV) encountered by a SONET/SDH line entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold path-far-end command.

es-rising

Generates a SNMP trap when the number of Errored Seconds (ES) encountered by a SONET/SDH line entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold path-far-end command.

ses-rising

Generates a SNMP trap when the number of Severely Errored Seconds (SES) encountered by a SONET/SDH line entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold path-far-end command.

uas-rising

Generates a SNMP trap when the number of UnAvailable Seconds (UAS) encountered by a SONET/SDH line entity in a particular 15 minute interval rises above a threshold defined by the sonet threshold path-far-end command.

By default, these traps are not enabled.

Use the snmp trap sonet path-far-end command to enable one or more of these traps:

router#configure terminal

Enter configuration commands, one per line. End with CNTL/Z.

router(config)#interface pos 1/1/1

router(config-if)#snmp trap sonet path-far-end es-rising

router(config-if)#snmp trap sonet path-far-end ses-rising

router(config-if)#snmp trap sonet path-far-end uas-rising

router(config-if)#end

router#

Modifying SNMP Section Traps

IPriori supports the following SONET section traps:

Table 10-8. SONET Section Traps Supported 
Path Description

cv-rising

Generates a SNMP trap when the number of Coding Violations (CV) encountered by a SONET/SDH section in a particular 15 minute interval rises above a threshold defined by the sonet threshold section command.

es-rising

Generates a SNMP trap when the number of Errored Seconds (ES) encountered by a SONET/SDH section in a particular 15 minute interval rises above a threshold defined by the sonet threshold section command.

lof-failure

Generates a SNMP trap when a Loss Of Frame defect (LOF) is received

lof-failure-cleared

Generates a SNMP trap when an loss of frame event is cleared.

los-failure

Generates a SNMP trap when a Loss Of Signal defect (LOS) is received

los-failure-cleared

Generates a SNMP trap when an loss of signal event is cleared.

sefs-rising

Generates a SNMP trap when the number of Severely Errored Framing Seconds (SEFS) encountered by a SONET/SDH section in a particular 15 minute interval rises above a threshold defined by the sonet threshold section command.

ses-rising

Generates a SNMP trap when the number of Severely Errored Seconds (SES) encountered by a SONET/SDH section in a particular 15 minute interval rises above a threshold defined by the sonet threshold section command.

By default, only the failure traps and failure clear traps are enabled and all other SONET section traps are disabled.

Use the snmp trap sonet section command to enable additional SONET section traps:

router#configure terminal

Enter configuration commands, one per line. End with CNTL/Z.

router(config)#interface pos 1/1/1

router(config-if)#snmp trap sonet section sefs-rising

router(config-if)#end

router#

Modifying Event Thresholds

SONET thresholds control how many times an event occurs on a SONET connection within a 15 minute interval before an SNMP trap is generated.

By default, all thresholds are set at 1.

NOTE These commands define the thresholds for various events that occur on a SONET section. You must use the associated snmp trap sonet command to send traps when these thresholds are exceeded.

Use the procedures described in this section to change the thresholds for individual POS interfaces.

Modifying SONET Line Thresholds

SONET line thresholds are threshold values for events occurring in the line layer of a SONET connection.

SONET line thresholds are configured using the sonet threshold line command.

SONET line-far-end thresholds are threshold values for events occurring in the line layer at the remote end of a SONET connection.

SONET line-far-end thresholds are configured using the sonet threshold line-far-end command.

In the following example, the sonet threshold line ses command configures POS interface 1/1/1 to send an SNMP trap when the number of SES encountered by a SONET/SDH line in a particular 15 minute interval rises above a threshold of 5:

router#configure terminal

Enter configuration commands, one per line. End with CNTL/Z.

router(config)#interface pos 1/1/1

router(config-if)#sonet threshold line ses 5

router(config-if)#end

router#

In the following example, the sonet threshold line-far-end es command configures POS interface 1/1/1 to send an SNMP trap when the number of ES encountered by a SONET/SDH line in a particular 15 minute interval rises above a threshold of 10:

router#configure terminal

Enter configuration commands, one per line. End with CNTL/Z.

router(config)#interface pos 1/1/1

router(config-if)#sonet threshold line-far-end es 10

router(config-if)#end

router#

Modifying SONET Path Thresholds

SONET path thresholds are threshold values for events occurring in the path layer at the local end of a SONET connection.

SONET path thresholds are configured using the sonet threshold path command.

SONET path-far-end thresholds are threshold values for events occurring in the path layer at the remote end of a SONET connection.

SONET path-far-end thresholds are configured using the sonet threshold path-far-end command.

In the following example, the sonet threshold path ses command configures POS interface 1/1/1 to send an SNMP trap when the number of ES encountered by the local end of the SONET/SDH path layer in a particular 15 minute interval rises above a threshold of 3:

router#configure terminal

Enter configuration commands, one per line. End with CNTL/Z.

router(config)#interface pos 1/1/1

router(config-if)#sonet threshold path ses 3

router(config-if)#end

router#

In the following example, the sonet threshold path-far-end ses command configures POS interface 1/1/1 to send an SNMP trap when the number of severely error seconds (SES) encountered by the remote end of a SONET/SDH path in a particular 15 minute interval rises above a threshold of 4:

router#configure terminal

Enter configuration commands, one per line. End with CNTL/Z.

router(config)#interface pos 1/1/1

router(config-if)#sonet threshold path-far-end ses 4

router(config-if)#end

router#

Modifying SONET Section Thresholds

SONET section thresholds are threshold values for events occurring in the local end of the section layer of a SONET connection.

SONET section thresholds are configured using the sonet threshold section command.

In the following example, the sonet threshold section command configures POS interface 1/1/1 to send an SNMP trap when the number of SEFS encountered by a SONET/SDH section in a particular 15 minute interval rises above a threshold of 5:

router#configure terminal

Enter configuration commands, one per line. End with CNTL/Z.

router(config)#interface pos 1/1/1

router(config-if)#sonet threshold section sefs 5

router(config-if)#end

Enabling SNMP Debugging

You can use the SNMP debugging commands to display SNMP packets and traps, or the type of variable bindings in SNMP packets.

SNMP debugging is supported for one session per Avici router. The session can be either a console session or a telnet session. If one SNMP debug session is already underway, using this command results in the following error message:

Error: SNMP Debug has already started

Debugging SNMP Headers

Use the debug snmp headers command to configure SNMP to display more information about SNMP headers. Use the debug snmp headers log to direct the debug output to the log file.

In the following example, the debug snmp headers command enables SNMP debugging:

router#debug snmp headers

SNMP packet header debugging is on

Sample output from a get next request with debug snmp headers enabled, appears as follows:

SNMP: Packet received via UDP from 10.1.2.183

SNMP: Get next, reqid 3, errstat 0, erridx 0

SNMP: Response, reqid 3, errstat 0, erridx

SNMP: Packet received via UDP from 10.1.2.183

SNMP: Get bulk request, reqid 4, errstat 0, erridx 1

SNMP: Response, reqid 4, errstat 0, erridx 0

Debugging SNMP Packets

Use the debug snmp dump-packets command to display the type of variable bindings in SNMP packets.

In the following example, the debug snmp dump-packets command enables SNMP packet debugging:

router#debug snmp dump-packets

SNMP packet header debugging is on

Sample output from a get next request with debug snmp dump-packets enabled, appears as follows:

DEBUG:SNMP:dump-packets: Dumping received packets

30 2a 02 01 00 04 09 53 4e 4d 50 5f 74 72 61 70            * 0 *.....SNMP_trap*

a1 1a 02 02 00 c3 02 01 00 02 01 00 30 0e 30 0c *.......0.0.*

06 08 2b 06 01 02 01 04 02 00 05 00             *..+....0.*


PREV NEXT INDEX

Copyright © 2005 Avici Systems Inc.
Avici® and TSR® is a registered trademark of Avici Systems Inc.
IPriori™, Composite Links™, SSR™, QSR, and NSR® are trademarks of Avici Systems Inc.

   Source File Name: SNMP.fm
    HTML File Name: SNMP.html
    Last Updated: 02/25/05 at 15:19:26

Please email suggestions and comments to: doc@avici.com