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
Cisco recommends that 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:
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.
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 in order 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 . |
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 . 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 . 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 in order 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:
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