Guest

IP Application Services

How to Support and Configure Cisco Catalyst OS SNMP Traps

Document ID: 15455

Updated: Oct 26, 2005

   Print

Introduction

This document describes the traps that the Catalyst OS (CatOS) supports and how to configure them on the switch.

Trap operations allow Simple Network Management Protocol (SNMP) agents to send asynchronous notifications of the occurrence of an event. Traps are sent on a best-effort basis and without any method to verify their receipt.

Prerequisites

Requirements

Before you attempt this configuration, ensure that:

  • You have properly configured the SNMP community strings on the switch

Note: Refer to How to Configure SNMP Community Strings for more information.

Components Used

The information in this document is based on these software and hardware versions:

  • Catalyst 4500/4000, 5500/5000, and 6500/6000 series switches

  • CatOS version 7.3

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.

Conventions

For more information on document conventions, refer to Cisco Technical Tips Conventions.

How Do I Find Out What Traps Are Enabled on My Switch?

Issue the show snmp command in the enable mode. Here is a sample output:

6509 (enable) show snmp 

RMON:                       Enabled 
Extended RMON Netflow Enabled : None. 
Traps Enabled: 
Port,Module,Chassis,Bridge,Repeater,Vtp,Auth,ippermit,Vmps,config,entity,stpx,syslog
Port Traps Enabled: 2/1-2,3/1-48,4/1-8 

Community-Access     Community-String 
.... 
.... 

!--- Output suppressed.

How Do I Configure the SNMP Trap Receiver on the Switch?

Issue the command set snmp trap host string .

Note: The command syntax includes:

  • host —IP address or IP alias of the system to receive SNMP traps.

  • string —Community string to use in order to send authentication traps.

Here is an example:

6509 (enable) set snmp trap 1.1.1.1 public
SNMP trap receiver added.

Issue the show snmp command in order to verify the addition of this set snmp trap statement. Here is a sample output:

6509 (enable)  show snmp
6509 (enable)  show snmp 
RMON:                       Enabled 
Extended RMON Netflow Enabled : None. 

!--- Output suppressed.
 
.... 
.... 

!--- Output suppressed.
 
Trap-Rec-Address  Trap-Rec-Community
---------------       ----------------- 
1.1.1.1               public

How Do I Enable Traps on the Switch, and What Does Each Trap Mean?

Issue the set snmp trap command to enable or disable the different SNMP traps on the system. The command also adds an entry into the SNMP authentication trap receiver table.

Syntax

set snmp trap {enable | disable} [all | auth | bridge | chassis | config | entity | entityfru | envfan | envpower | envshutdown | ippermit | module | repeater | stpx | syslog | system | vmps | vtp]

Note: This command should be on one line.

Syntax Description

Keyword Description Trap MIB
enable Keyword to enable SNMP traps.    
disable Keyword to disable SNMP traps.    
all (Optional) Keyword to specify all trap types. Refer to the switch documentation before you use this option.    
auth (Optional) Keyword to specify the authenticationFailure trap from RFC 1157 leavingcisco.com.
authenticationFailure 
(.1.3.6.1.2.1.11.0.4)
SNMPv2-MIB
bridge (Optional) Keyword to specify the newRoot and topologyChange traps from RFC 1493 leavingcisco.com. Refer to BRIDGE-MIB.
newRoot (.1.3.6.1.2.1.17.0.1)
topologyChange (.1.3.6.1.2.1.17.0.2)
BRIDGE-MIB
chassis (Optional) Keyword to specify the chassisAlarmOn (.1.3.6.1.4.1.9.5.0.5) and chassisAlarmOff (.1.3.6.1.4.1.9.5.0.6) traps from the CISCO-STACK-MIB.
chassisAlarmOn (.1.3.6.1.4.1.9.5.0.5)
chassisAlarmOff (.1.3.6.1.4.1.9.5.0.6)
CISCO-STACK-MIB
config (Optional) Keyword to specify the sysConfigChange trap from the CISCO-STACK-MIB.
sysConfigChangeTrap 
(.1.3.6.1.4.1.9.5.0.9)
CISCO-STACK-MIB
entity (Optional) Keyword to specify the entityMIB trap from the ENTITY-MIB.
entConfigChange 
(.1.3.6.1.2.1.47.2.0.1)
ENTITY-MIB
entityfru (Optional) Keyword to specify the entity FRU1.
cefcModuleStatusChange 
(.1.3.6.1.4.1.9.9.117.2.0.1) 
cefcPowerStatusChange 
(.1.3.6.1.4.1.9.9.117.2.0.2) 
cefcFRUInserted 
(.1.3.6.1.4.1.9.9.117.2.0.3) 
cefcFRURemoved 
(.1.3.6.1.4.1.9.9.117.2.0.4)
CISCO-ENTITY-FRU-CONTROL-MIB
envfan (Optional) Keyword to specify the environmental fan.
ciscoEnvMonFanNotification 
(.1.3.6.1.4.1.9.9.13.3.0.4)
CISCO-ENVMON-MIB
envpower (Optional) Keyword to specify the environmental power.
ciscoEnvMonRedundantSupplyNotification 
(.1.3.6.1.4.1.9.9.13.3.0.5)
CISCO-ENVMON-MIB
envshutdown (Optional) Keyword to specify the environmental shutdown.
ciscoEnvMonShutdownNotification 
(.1.3.6.1.4.1.9.9.13.3.0.1)
CISCO-ENVMON-MIB
envtemp (Optional) Keyword to specify the environmental temperature notification.
ciscoEnvMonTemperatureNotification 
(.1.3.6.1.4.1.9.9.13.3.0.3)
CISCO-ENVMON-MIB
ippermit (Optional) Keyword to specify the IP Permit Denied access from the CISCO-STACK-MIB.
ipPermitDeniedTrap 
(.1.3.6.1.4.1.9.5.0.7)
CISCO-STACK-MIB
macnotification (Optional) Keyword that specifies MAC address notification.
cmnMacChangedNotification 
(.1.3.6.1.4.1.9.9.215.2.0.1)
CISCO-MAC-NOTIFICATION-MIB
module (Optional) Keyword to specify the moduleUp and moduleDown traps from the CISCO-STACK-MIB.
moduleUp (.1.3.6.1.4.1.9.5.0.3)
moduleDown (.1.3.6.1.4.1.9.5.0.4)
CISCO-STACK-MIB
repeater (Optional) Keyword to specify the rptrHealth, rptrGroupChange, and rptrResetEvent traps from RFC 1516 leavingcisco.com. Refer to SNMP-REPEATER-MIB.
rptrHealth (.1.3.6.1.2.1.22.0.1)
rptrGroupChange (.1.3.6.1.2.1.22.0.2) 
rptrResetEvent (.1.3.6.1.2.1.22.0.3)
SNMP-REPEATER-MIB
stpx (Optional) Keyword to specify the STPX2 trap.
stpxInconsistencyUpdate 
(.1.3.6.1.4.1.9.9.82.2.0.1) 
stpxLoopInconsistencyUpdate 
(.1.3.6.1.4.1.9.9.82.2.0.3) 
stpxRootInconsistencyUpdate 
(.1.3.6.1.4.1.9.9.82.2.0.2)
CISCO-STP-EXTENSIONS-MIB
syslog (Optional) Keyword to specify the syslog notification traps.
clogMessageGenerated 
(.1.3.6.1.4.1.9.9.41.2.0.1)
CISCO-SYSLOG-MIB
system (Optional) Keyword to specify the system.
ciscoSystemClockChanged 
(1.3.6.1.4.1.9.9.131.2.0.1)
CISCO-SYSTEM-MIB
vmps (Optional) Keyword to specify the vmVmpsChange trap from the CISCO-VLAN-MEMBERSHIP-MIB.
vmVmpsChange 
(.1.3.6.1.4.1.9.9.68.2.0.1)
CISCO-VLAN-MEMBERSHIP-MIB
vtp (Optional) Keyword to specify the VTP3 from the CISCO-VTP-MIB.
vtpConfigDigestError 
(.1.3.6.1.4.1.9.9.46.2.0.2) 
vtpConfigRevNumberError 
(.1.3.6.1.4.1.9.9.46.2.0.1) 
vlanTrunkPortDynamicStatusChange 
(.1.3.6.1.4.1.9.9.46.2.0.7) 
vtpVersionOneDeviceDetected 
(.1.3.6.1.4.1.9.9.46.2.0.6)
CISCO-VTP-MIB

1 FRU = field-replaceable unit

2 STPX = Spanning Tree Protocol Extensions

3 VTP = VLAN Trunk Protocol

How Do I Enable Traps on Individual Ports, Such as linkUp/linkDown?

Issue the set port trap command to enable or disable the operation of the standard SNMP link trap for a port or range of ports. By default, all port traps are disabled.

Note: The Network Analysis Module (NAM) does not support this command.

Syntax

set port trap mod/port {enable | disable}

Syntax Description

  • mod/port —Number of the module and the port on the module.

  • enable—Keyword to activate the SNMP link trap.

  • disable—Keyword to deactivate the SNMP link trap.

If you enable the traps, the corresponding traps that generate are linkUp (.1.3.6.1.2.1.11.0.3) and linkDown (.1.3.6.1.2.1.11.0.2). These traps are from the IF-MIB.

Example

This example shows how to enable the SNMP link trap for module 1, port 2:

Console> (enable) set port trap 1/2 enable
Port 1/2 up/down trap enabled.
Console> (enable)

What Other Traps Can the Catalyst Switch Send?

See this table:

MIB Object Name OID MIB
ciscoFlashCopyCompletionTrap
.1.3.6.1.4.1.9.9.10.1.3.0.1 CISCO-FLASH-MIB
ciscoFlashDeviceChangeTrap
.1.3.6.1.4.1.9.9.10.1.3.0.4 CISCO-FLASH-MIB
ciscoFlashMiscOpCompletionTrap
.1.3.6.1.4.1.9.9.10.1.3.0.3 CISCO-FLASH-MIB
coldStart
.1.3.6.1.6.3.1.1.5.1 RFC 1157-SNMP leavingcisco.com (SNMPv2-MIB)
warmStart
.1.3.6.1.6.3.1.1.5.2 RFC 1157-SNMP leavingcisco.com (SNMPv2-MIB)
tokenRingSoftErrExceededTrap
.1.3.6.1.4.1.9.5.0.10 CISCO-STACK-MIB
lerAlarmOn
.1.3.6.1.4.1.9.5.0.1 CISCO-STACK-MIB
lerAlarmOff
.1.3.6.1.4.1.9.5.0.2 CISCO-STACK-MIB
entSensorThresholdNotification
.1.3.6.1.4.1.9.9.91.2.0.1 CISCO-ENTITY-SENSOR-MIB
fallingAlarm
.1.3.6.1.2.1.16.0.2 RMON-MIB
risingAlarm
.1.3.6.1.2.1.16.0.1 RMON-MIB

Verify

There is currently no verification procedure available for this configuration.

Troubleshoot

There is currently no specific troubleshooting information available for this configuration.

Related Information

Updated: Oct 26, 2005
Document ID: 15455