Feedback
Contents
Network Management Commands
This chapter contains all product dependent Network Management commands.
- debug spanning-tree
- ip wccp
- show ip sla statistics
- show monitor
- show platform ip wccp
- snmp-server enable traps
- snmp-server enable traps bgp
- snmp-server enable traps bridge
- snmp-server enable traps bulkstat
- snmp-server enable traps call-home
- snmp-server enable traps cef
- snmp-server enable traps cpu
- snmp-server enable traps envmon
- snmp-server enable traps errdisable
- snmp-server enable traps flash
- snmp-server enable traps isis
- snmp-server enable traps license
- snmp-server enable traps mac-notification
- snmp-server enable traps ospf
- snmp-server enable traps pim
- snmp-server enable traps port-security
- snmp-server enable traps power-ethernet
- snmp-server enable traps snmp
- snmp-server enable traps stackwise
- snmp-server enable traps storm-control
- snmp-server enable traps stpx
- snmp-server enable traps transceiver
- snmp-server enable traps vrfmib
- snmp-server enable traps vstack
- snmp-server enable traps wireless
- snmp-server engineID
- snmp-server host
- trapflags
debug spanning-tree
To enable debugging of spanning-tree activities, use the debug spanning-tree command in EXEC mode. To disable debugging, use the no form of this command.
debug spanning-tree { all | backbonefast | bpdu | bpdu-opt | config | csuf /csrt | etherchannel | events | exceptions | general | mstp | pvst | + | root | snmp | switch | synchronization | uplinkfast }
no debug spanning-tree { all | backbonefast | bpdu | bpdu-opt | config | csuf /csrt | etherchannel | events | exceptions | general | mstp | pvst | + | root | snmp | switch | synchronization | uplinkfast }
Syntax Description
all
Displays all spanning-tree debug messages.
backbonefast
Displays BackboneFast-event debug messages.
bpdu
Displays spanning-tree bridge protocol data unit (BPDU) debug messages.
bpdu-opt
Displays optimized BPDU handling debug messages.
config
Displays spanning-tree configuration change debug messages.
csuf/csrt
Displays cross-stack UplinkFast and cross-stack rapid transition activity debug messages.
This keyword is supported only on stacking-capable switches.
etherchannel
Displays EtherChannel-support debug messages.
events
Displays spanning-tree topology event debug messages.
exceptions
Displays spanning-tree exception debug messages.
general
Displays general spanning-tree activity debug messages.
mstp
Debugs Multiple Spanning Tree Protocol events.
pvst+
Displays per-VLAN spanning-tree plus (PVST+) event debug messages.
root
Displays spanning-tree root-event debug messages.
snmp
Displays spanning-tree Simple Network Management Protocol (SNMP) handling debug messages.
synchronization
Displays the spanning-tree synchronization event debug messages.
switch
Displays switch shim command debug messages. This shim is the software module that is the interface between the generic Spanning Tree Protocol (STP) code and the platform-specific code of various switch platforms.
uplinkfast
Displays UplinkFast-event debug messages.
Command History
Usage Guidelines
The undebug spanning-tree command is the same as the no debug spanning-tree command.
When you enable debugging on a switch stack, it is enabled only on the active switch. To enable debugging on a stack member, you can start a session from the active switch by using the session switch-number EXEC command. Then enter the debug command at the command-line prompt of the stack member. You also can use the remote command stack-member-number LINE EXEC command on the active switch to enable debugging on a member switch without first starting a session.
ip wccp
To enable the web cache service, and specify the service number that corresponds to a dynamic service that is defined by the application engine, use the ip wccp global configuration command on the switch. Use the no form of this command to disable the service.
ip wccp { web-cache | service-number} [ group-address groupaddress] [ group-list access-list] [ redirect-list access-list] [ password encryption-number password]
no ip wccp { web-cache | service-number} [ group-address groupaddress] [ group-list access-list] [ redirect-list access-list] [ password encryption-number password]
Syntax Description
web-cache Specifies the web-cache service (WCCP Version 1 and Version 2).
service-number Dynamic service identifier, which means the service definition is dictated by the cache. The dynamic service number can be from 0 to 254. The maximum number of services is 256, which includes the web-cache service specified with the web-cache keyword.
group-address groupaddress (Optional) Specifies the multicast group address used by the switches and the application engines to participate in the service group.
group-list access-list (Optional) If a multicast group address is not used, specifies a list of valid IP addresses that correspond to the application engines that are participating in the service group.
redirect-list access-list (Optional) Specifies the redirect service for specific hosts or specific packets from hosts.
password encryption-number password (Optional) Specifies an encryption number. The range is 0 to 7. Use 0 for not encrypted, and use 7 for proprietary. Also, specifies a password name up to seven characters in length. The switch combines the password with the MD5 authentication value to create security for the connection between the switch and the application engine. By default, no password is configured, and no authentication is performed.
Command History
Usage Guidelines
WCCP transparent caching bypasses Network Address Translation (NAT) when Cisco Express Forwarding switching is enabled. To work around this situation, configure WCCP transparent caching in the outgoing direction, enable Cisco Express Forwarding switching on the content engine interface, and specify the ip wccp web-cache redirect out command. Configure WCCP in the incoming direction on the inside interface by specifying the ip wccp redirect exclude in command on the router interface facing the cache. This configuration prevents the redirection of any packets arriving on that interface.
You can also include a redirect list when configuring a service group. The specified redirect list will deny packets with a NAT (source) IP address and prevent redirection.
This command instructs a switch to enable or disable support for the specified service number or the web-cache service name. A service number can be from 0 to 254. Once the service number or name is enabled, the router can participate in the establishment of a service group.
When the no ip wccp command is entered, the switch terminates participation in the service group, deallocates space if none of the interfaces still has the service configured, and terminates the WCCP task if no other services are configured.
The keywords following the web-cache keyword and the service-number argument are optional and may be specified in any order, but only may be specified once.
Examples
Example
The following example configures a web cache, the interface connected to the application engine or the server, and the interface connected to the client:
Switch(config)# ip wccp web-cache Switch(config)# interface gigabitethernet1/0/1 Switch(config-if)# no switchport Switch(config-if)# ip address 172.20.10.30 255.255.255.0 Switch(config-if)# no shutdown Switch(config-if)# exit Switch(config)# interface gigabitethernet1/0/2 Switch(config-if)# no switchport Switch(config-if)# *Dec 6 13:11:29.507: %LINK-3-UPDOWN: Interface GigabitEthernet1/0/3, changed state to down Switch(config-if)# ip address 175.20.20.10 255.255.255.0 Switch(config-if)# no shutdown Switch(config-if)# ip wccp web-cache redirect in Switch(config-if)# ip wccp web-cache group-listen Switch(config-if)# exitshow ip sla statistics
To display current or aggregated operational status and statistics of all Cisco IOS IP Service Level Agreement (SLA) operations or a specified operation, use the show ip sla statistics command in user EXEC or privileged EXEC mode.
show ip sla statistics [ operation-number [ details] | aggregated [ operation-number | details] | details]
Syntax Description
operation-number (Optional) Number of the operation for which operational status and statistics are displayed. Accepted values are from 1 to 2147483647.
details Specifies detailed output.
aggregated Specifies the IP SLA aggregated statistics.
Command History
Usage Guidelines
Use the show ip sla statistics to display the current state of IP SLA operations, including how much life the operation has left, whether the operation is active, and the completion time. The output also includes the monitoring data returned for the last (most recently completed) operation. This generated operation ID is displayed when you use the show ip sla configuration command for the base multicast operation, and as part of the summary statistics for the entire operation.
Enter the show command for a specific operation ID to display details for that one responder.
Examples
Examples
The following is sample output from the show ip sla statistics command:
Switch# show ip sla statistics Current Operational State Entry Number: 3 Modification Time: *22:15:43.000 UTC Sun Feb 11 2001 Diagnostics Text: Last Time this Entry was Reset: Never Number of Octets in use by this Entry: 1332 Number of Operations Attempted: 2 Current Seconds Left in Life: 3511 Operational State of Entry: active Latest Completion Time (milliseconds): 544 Latest Operation Start Time: *22:16:43.000 UTC Sun Feb 11 2001 Latest Oper Sense: ok Latest Sense Description: 200 OK Total RTT: 544 DNS RTT: 12 TCP Connection RTT: 28 HTTP Transaction RTT: 504 HTTP Message Size: 9707show monitor
To display information about all Switched Port Analyzer (SPAN) and Remote SPAN (RSPAN) sessions, use the show monitor command in EXEC mode.
Syntax Description
Command History
Usage Guidelines
The output is the same for the show monitor command and the show monitor session all command.
Examples
Examples
This is an example of output for the show monitor user EXEC command:
Switch# show monitor Session 1 --------- Type : Local Session Source Ports : RX Only : Gi4/0/1 Both : Gi4/0/2-3,Gi4/0/5-6 Destination Ports : Gi4/0/20 Encapsulation : Replicate Ingress : Disabled Session 2 --------- Type : Remote Source Session Source VLANs : TX Only : 10 Both : 1-9 Dest RSPAN VLAN : 105This is an example of output for the show monitor user EXEC command for local SPAN source session 1:
Switch# show monitor session 1 Session 1 --------- Type : Local Session Source Ports : RX Only : Gi4/0/1 Both : Gi4/0/2-3,Gi4/0/5-6 Destination Ports : Gi4/0/20 Encapsulation : Replicate Ingress : DisabledThis is an example of output for the show monitor session all user EXEC command when ingress traffic forwarding is enabled:
Switch# show monitor session all Session 1 --------- Type : Local Session Source Ports : Both : Gi4/0/2 Destination Ports : Gi4/0/3 Encapsulation : Native Ingress : Enabled, default VLAN = 5 Ingress encap : DOT1Q Session 2 --------- Type : Local Session Source Ports : Both : Gi4/0/8 Destination Ports : Gi4/012 Encapsulation : Replicate Ingress : Enabled, default VLAN = 4 Ingress encap : Untaggedshow platform ip wccp
To display platform-dependent Web Cache Communication Protocol (WCCP) information, use the show platform ip wccp privileged EXEC command.
Syntax Description
cache-engines
Displays WCCP cache engines.
interfaces
Displays WCCP interfaces.
service-groups
Displays WCCP service groups.
switch switch-number
(Optional) Displays WCCP information only for specified switch-number.
Command History
Usage Guidelines
Use this command only when you are working directly with a technical support representative while troubleshooting a problem. Do not use this command unless a technical support representative asks you to do so.
This command is available only if your switch is running the IP services feature set.
Examples
The following example displays WCCP interfaces:
Switch# show platform ip wccp interfaces WCCP Interfaces **** WCCP Interface Gi1/0/3 iif_id:0x104a60000000087 (#SG:1), vrf:0 Ingress le_handle:0x565dd208 IPv4 Sw-Label:3, Asic-Label:3 * Service group id:0 type: Well-known token:126 vrf:0 (ref count:1) Open service prot: PROT_TCP l4_type: Dest ports priority: 240 port[0]: 80snmp-server enable traps
To enable the switch to send Simple Network Management Protocol (SNMP) notifications for various traps or inform requests to the network management system (NMS), use the snmp-server enable traps command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps [ auth-framework | bgp | bridge | bulkstat | call-home | cef | config | config-copy | config-ctid | copy-config | cpu | cpu threshold | eigrp | entity | envmon | errdisable | event-manager | flash | flowmon | fru-ctrl | ipmulticast | ipsla | isis | license | local-auth | mac-notification | memory | msdp | ospf | pim | port-security | power-ethernet | rf | snmp | stackwise | storm-control | stpx | syslog | transceiver | tty | vlan-membership | vlancreate | vlandelete | vrfmib | vstack | vtp | wireless ]
no snmp-server enable traps [ auth-framework | bgp | bridge | bulkstat | call-home | cef | config | config-copy | config-ctid | copy-config | cpu | cpu threshold | eigrp | entity | envmon | errdisable | event-manager | flash | flowmon | fru-ctrl | ipmulticast | ipsla | isis | license | local-auth | mac-notification | memory | msdp | ospf | pim | port-security | power-ethernet | rf | snmp | stackwise | storm-control | stpx | syslog | transceiver | tty | vlan-membership | vlancreate | vlandelete | vrfmib | vstack | vtp | wireless ]
Syntax Description
auth-framework
(Optional) Enables SNMP CISCO-AUTH-FRAMEWORK-MIB traps.
bgp
(Optional) Enables BGP traps.*
bridge
(Optional) Enables SNMP STP Bridge MIB traps.*
bulkstat
(Optional) Enables Data-Collection-MIB Collection notification traps.*
call-home
(Optional) Enables SNMP CISCO-CALLHOME-MIB traps.*
cef
(Optional) Enables cluster traps.*
config
(Optional) Enables SNMP configuration traps.
config-copy
(Optional) Enables SNMP configuration copy traps.
Syntax Description
config-ctid
(Optional) Enables SNMP configuration CTID traps.
copy-config
(Optional) Enables SNMP copy-configuration traps.
cpu
(Optional) Enables CPU notification traps.*
cpu threshold
(Optional) Enables CPU threshold notification traps.
eigrp
(Optional) Enables SNMP EIGRP traps.
entity
(Optional) Enables SNMP entity traps.
envmon
(Optional) Enables SNMP environmental monitor traps.*
errdisable
(Optional) Enables SNMP errdisable notification traps.*
event-manager
(Optional) Enables SNMP Embedded Event Manager traps.
flash
(Optional) Enables SNMP FLASH notification traps.*
flowmon
(Optional) Enables SNMP flowmon notification traps.
fru-ctrl
(Optional) Generates entity field-replaceable unit (FRU) control traps. In a switch stack, this trap refers to the insertion or removal of a switch in the stack.
ipmulticast
(Optional) Enables IP multicast routing traps.
ipsla
(Optional) Enables SNMP IP SLA traps.
isis
(Optional) Enables IS-IS traps.*
license
(Optional) Enables license traps.*
local-auth
(Optional) Enables SNMP local auth traps.
mac-notification
(Optional) Enables SNMP MAC Notification traps.*
memory
(Optional) Enables MEMORY traps.
msdp
(Optional) Enable Multicast Source Discovery Protocol (MSDP) traps.
ospf
(Optional) Enables OSPF traps.*
pim
(Optional) Enables SNMP PIM traps.*
port-security
(Optional) Enables SNMP port security traps.*
Syntax Description
power-ethernet
(Optional) Enables SNMP power ethernet traps.*
rf
(Optional) Enables all SNMP traps defined in CISCO-RF-MIB.
snmp
(Optional) Enables SNMP traps.*
stackwise
(Optional) Enables SNMP stackwise traps.*
storm-control
(Optional) Enables SNMP storm-control trap parameters.*
stpx
(Optional) Enables SNMP STPX MIB traps.*
syslog
(Optional) Enables SNMP syslog traps.
transceiver
(Optional) Enables SNMP transceiver traps.*
tty
(Optional) Sends TCP connection traps. This is enabled by default.
vlan-membership
(Optional) Enables SNMP VLAN membership traps.
vlancreate
(Optional) Enables SNMP VLAN-created traps.
vlandelete
(Optional) Enables SNMP VLAN-deleted traps.
vrfmib
(Optional) Enables SNMP vrfmib traps.*
vstack
(Optional) Enables SNMP Smart Install traps.*
vtp
(Optional) Enables VLAN Trunking Protocol (VTP) traps.
wireless
(Optional) Enables wireless traps.
Command History
Usage Guidelines
*The command options marked with an asterisk in the table above have sub-commands. For more information on these sub-commands, see the Related Topics section below.
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
When supported, use the snmp-server enable traps command to enable sending of traps or informs.
Note
Though visible in the command-line help strings, the fru-ctrl, insertion, and removal keywords are not supported on the switch. The snmp-server enable informs global configuration command is not supported. To enable the sending of SNMP inform notifications, use the snmp-server enable traps global configuration command combined with the snmp-server host host-addr informs global configuration command.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
Related Commands
Command
Description
Specifies the recipient (host) of a SNMP notification operation.
Generates STP bridge MIB traps.
Enables data-collection-MIB notifications
Enables SNMP CISCO-CALLHOME-MIB traps
Enables SNMP CEF traps
Enables CPU notifications
Enables SNMP environmental traps.
Enables SNMP errdisable notifications
Enables SNMP flash notifications
Enables license traps
Enables SNMP MAC notification traps
Enables SNMP PIM traps.
Enables SNMP PoE traps.
Enables SNMP traps.
Enables SNMP stackwise traps
Enables SNMP storm-control trap parameters
Enables SNMP STPX MIB traps
Enable SNMP transceiver traps
Allows SNMP vrfmib traps
Command to configure trap for wireless parameters.
Enables the switch to send SNMP notifications for BGP state-change traps to the NMS,
Enables IS-IS traps
Enables SNMP port security traps.
Enables SNMP smart install traps
snmp-server enable traps bgp
To enable the switch to send Simple Network Management Protocol (SNMP) notifications for Border Gateway Protocol (BGP) state-change traps to the network management system (NMS), use the snmp-server enable traps bgp command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps bgp [ threshold prefix | state-changes [ all [ backward-trans [ limited ] ] ]
no snmp-server enable traps bgp prefix
Syntax Description
state-changes
(Optional) Enable finite state machine (FSM) state-change traps.
all
(Optional) Enable a CISCO specific trap for all FSM state changes.
backward-trans
(Optional) Enable traps for FSM state changes.
limited
(Optional) Enable a trap for standard backward transition and established.
threshold
(Optional) Enable traps for threshold events.
prefix
(Optional) Enable a CISCO specific trap for prefix threshold events.
Command History
Usage Guidelines
This command is available only when the IP services feature set is enabled on the switch.
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
When supported, use the snmp-server enable traps command to enable sending of traps or informs.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps bridge
To generate STP bridge MIB traps, use the snmp-server enable traps bridge command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps bridge [ newroot] [ topologychange]
no snmp-server enable traps bridge [ newroot] [ topologychange]
Syntax Description
newroot
(Optional) Enable SNMP STP Bridge MIB new root traps.
topologychange
(Optional) Enable SNMP STP Bridge MIB topology change traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps bulkstat
To enable data-collection-MIB traps, use the snmp-server enable traps bulkstat command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps bulkstat [ collection | transfer]
no snmp-server enable traps bulkstat [ collection | transfer]
Syntax Description
collection
(Optional) Enables data-collection-MIB collection traps.
transfer
(Optional) Enables data-collection-MIB transfer traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps call-home
To enable SNMP CISCO-CALLHOME-MIB traps, use the snmp-server enable traps call-home command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps call-home [ message-send-fail | server-fail]
no snmp-server enable traps call-home [ message-send-fail | server-fail]
Syntax Description
message-send-fail
(Optional) Enables SNMP message-send-fail traps.
server-fail
(Optional) Enable SNMP server-fail traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps cef
To enable SNMP Cisco Express Forwarding (CEF) traps, use the snmp-server enable traps cef command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps cef [ inconsistency | peer-fib-state-change | peer-state-change | resource-failure]
no snmp-server enable traps cef [ inconsistency | peer-fib-state-change | peer-state-change | resource-failure]
Syntax Description
inconsistency
(Optional) Enables SNMP CEF Inconsistency traps.
peer-fib-state-change
(Optional) Enables SNMP CEF Peer FIB State change traps.
peer-state-change
(Optional) Enables SNMP CEF Peer state change traps.
resource-failure
(Optional) Enables SNMP CEF Resource Failure traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps cpu
To enable CPU notifications, use the snmp-server enable traps cpu command in global configuration mode. Use the no form of this command to return to the default setting.
Syntax Description
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps envmon
To enable SNMP environmental traps, use the snmp-server enable traps envmon command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps envmon [ fan | shutdown | status | supply | temperature]
no snmp-server enable traps envmon [ fan | shutdown | status | supply | temperature]
Syntax Description
fan
(Optional) Enables fan traps.
shutdown
(Optional) Enables environmental monitor shutdown traps.
status
(Optional) Enables SNMP environmental status-change traps.
supply
(Optional) Enables environmental monitor power-supply traps.
temperature
(Optional) Enables environmental monitor temperature traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps errdisable
To enable SNMP notifications of error disabling, use the snmp-server enable traps errdisable command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps errdisable [ notification-rate number-of-notifications]
no snmp-server enable traps errdisable [ notification-rate number-of-notifications]
Syntax Description
notification-rate number-of-notifications
(Optional) Specifies number of notifications per minute as the notification rate. Accepted values are from 0-4294967295.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps flash
To enable SNMP flash notifications, use the snmp-server enable traps flash command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps flash [ insertion | removal]
no snmp-server enable traps flash [ insertion | removal]
Syntax Description
insertion
(Optional) Enables SNMP flash insertion notifications.
removal
(Optional) Enables SNMP flash removal notifications.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps isis
To enable intermediate system-to-intermediate system (IS-IS) link-state routing protocol traps, use the snmp-server enable traps isis command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps isis [ errors | state-change]
no snmp-server enable traps isis [ errors | state-change]
Syntax Description
errors
(Optional) Enables IS-IS error traps.
state-change
(Optional) Enables IS-IS state change traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps license
To enable license traps, use the snmp-server enable traps license command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps license [ deploy | error | usage]
no snmp-server enable traps license [ deploy | error | usage]
Syntax Description
deploy
(Optional) Enables license deployment traps.
error
(Optional) Enables license error traps.
usage
(Optional) Enables license usage traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps mac-notification
To enable SNMP MAC notification traps, use the snmp-server enable traps mac-notification command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps mac-notification [ change | move | threshold]
no snmp-server enable traps mac-notification [ change | move | threshold]
Syntax Description
change
(Optional) Enables SNMP MAC change traps.
move
(Optional) Enables SNMP MAC move traps.
threshold
(Optional) Enables SNMP MAC threshold traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps ospf
To enable SNMP Open Shortest Path First (OSPF) traps, use the snmp-server enable traps ospf command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps ospf [ cisco-specific | errors | lsa | rate-limit rate-limit-time max-number-of-traps | retransmit | state-change]
no snmp-server enable traps ospf [ cisco-specific | errors | lsa | rate-limit rate-limit-time max-number-of-traps | retransmit | state-change]
Syntax Description
cisco-specific
(Optional) Enable Cisco-specific traps.
errors
(Optional) Enable error traps.
lsa
(Optional) Enable link-state advertisement (LSA) traps.
rate-limit
(Optional) Enable rate-limit traps.
rate-limit-time
(Optional) Specifies window of time in seconds for rate-limit traps. Accepted values are 2 - 60.
max-number-of-traps
(Optional) Specifies maximum number of rate-limit traps to be sent in window time.
retransmit
(Optional) Enable packet-retransmit traps.
state-change
(Optional) Enable state-change traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps pim
To enable SNMP Protocol-Independent Multicast (PIM) traps, use the snmp-server enable traps pim command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps pim [ invalid-pim-message | neighbor-change | rp-mapping-change]
no snmp-server enable traps pim [ invalid-pim-message | neighbor-change | rp-mapping-change]
Syntax Description
invalid-pim-message
(Optional) Enable invalid PIM message traps.
neighbor-change
(Optional) Enable PIM neighbor-change traps.
rp-mapping-change
(Optional) Enable rendezvous point (RP)-mapping change traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps port-security
To enable SNMP port security traps, use the snmp-server enable traps port-security command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps port-security [ trap-rate value]
no snmp-server enable traps port-security [ trap-rate value]
Syntax Description
trap-rate value
(Optional) Set the maximum number of port-security traps sent per second. The range is from 0 to 1000; the default is 0 (no limit imposed; a trap is sent at every occurrence).
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps power-ethernet
To enable SNMP power-over-Ethernet (PoE) traps, use the snmp-server enable traps power-ethernet command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps power-ethernet { group name | police }
no snmp-server enable traps power-ethernet { group name | police }
Syntax Description
group name
Enable inline power group-based traps for the specified group number or list.
police
Enable inline power policing traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps snmp
To enable SNMP traps, use the snmp-server enable traps snmp command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps snmp [ authentication | coldstart | linkdown | linkup | warmstart ]
no snmp-server enable traps snmp [ authentication | coldstart | linkdown | linkup | warmstart ]
Syntax Description
authentication
(Optional) Enables authentication traps.
coldstart
(Optional) Enables cold start traps.
linkdown
(Optional) Enables linkdown traps.
linkup
(Optional) Enables linkup traps.
warmstart
(Optional) Enables warmstart traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps stackwise
To enable SNMP stackwise traps, use the snmp-server enable traps stackwise command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps stackwise [ GLS | ILS | SRLS | insufficient-power | invalid-input-current | invalid-output-current | member-removed | member-upgrade-notification | new-master | new-memberport-change | power-budget-warning | power-invalid-topology | power-link-status-changed | power-oper-status-changed | power-priority-conflict | power-version-mismatch | ring-redundant | stack-mismatch | unbalanced-power-supplies | under-budget | under-voltage]
no snmp-server enable traps stackwise [ GLS | ILS | SRLS | insufficient-power | invalid-input-current | invalid-output-current | member-removed | member-upgrade-notification | new-master | new-memberport-change | power-budget-warning | power-invalid-topology | power-link-status-changed | power-oper-status-changed | power-priority-conflict | power-version-mismatch | ring-redundant | stack-mismatch | unbalanced-power-supplies | under-budget | under-voltage]
Syntax Description
GLS
(Optional) Enables stackwise stack power GLS trap.
ILS
(Optional) Enables stackwise stack power ILS trap.
SRLS
(Optional) Enables stackwise stack power SRLS trap.
insufficient-power
(Optional) Enables stackwise stack power unbalanced power supplies trap.
invalid-input-current
(Optional) Enables stackwise stack power invalid input current trap.
invalid-output-current
(Optional) Enables stackwise stack power invalid output current trap.
member-removed
(Optional) Enables stackwise stack member removed trap.
member-upgrade-notification
(Optional) Enables stackwise member to be reloaded for upgrade trap.
new-master
(Optional) Enables stackwise new master trap.
Syntax Description
new-member
(Optional) Enables stackwise stack new member trap.
port-change
(Optional) Enables stackwise port change trap.
power-budget-warning
(Optional) Enables stackwise stack power budget warning trap.
power-invalid-topology
(Optional) Enables stackwise stack power invalid topology trap.
power-link-status-changed
(Optional) Enables stackwise stack power link status changed trap.
power-oper-status-changed
(Optional) Enables stackwise stack power port oper status changed trap.
power-priority-conflict
(Optional) Enables stackwise stack power priority conflict trap.
power-version-mismatch
(Optional) Enables stackwise stack power version mismatch discovered trap.
ring-redundant
(Optional) Enables stackwise stack ring redundant trap.
stack-mismatch
(Optional) Enables stackwise stack mismatch trap.
unbalanced-power-supplies
(Optional) Enables stackwise stack power unbalanced power supplies trap.
under-budget
(Optional) Enables stackwise stack power under budget trap.
under-voltage
(Optional) Enables stackwise stack power under voltage trap.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps storm-control
To enable SNMP storm-control trap parameters, use the snmp-server enable traps storm-control command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps storm-control { trap-rate number-of-minutes}
no snmp-server enable traps storm-control { trap-rate number-of-minutes}
Syntax Description
trap-rate number-of-minutes
(Optional) Specifies the SNMP storm-control trap rate in minutes. Accepted values are from 0-1000.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps stpx
To enable SNMP STPX MIB traps, use the snmp-server enable traps stpx command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps stpx [ inconsistency | loop-inconsistency | root-inconsistency]
no snmp-server enable traps stpx [ inconsistency | loop-inconsistency | root-inconsistency]
Syntax Description
inconsistency
(Optional) Enables SNMP STPX MIB inconsistency update traps.
loop-inconsistency
(Optional) Enables SNMP STPX MIB loop inconsistency update traps.
root-inconsistency
(Optional) Enables SNMP STPX MIB root inconsistency update traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps transceiver
To enable SNMP transceiver traps, use the snmp-server enable traps transceiver command in global configuration mode. Use the no form of this command to return to the default setting.
Syntax Description
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps vrfmib
To allow SNMP vrfmib traps, use the snmp-server enable traps vrfmib command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps vrfmib [ vnet-trunk-down | vnet-trunk-up | vrf-down | vrf-up]
no snmp-server enable traps vrfmib [ vnet-trunk-down | vnet-trunk-up | vrf-down | vrf-up]
Syntax Description
vnet-trunk-down
(Optional) Enables vrfmib trunk down traps.
vnet-trunk-up
(Optional) Enables vrfmib trunk up traps.
vrf-down
(Optional) Enables vrfmib vrf down traps.
vrf-up
(Optional) Enables vrfmib vrf up traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps vstack
To enable SNMP smart install traps, use the snmp-server enable traps vstack command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps vstack [ addition | failure | lost | operation]
no snmp-server enable traps vstack [ addition | failure | lost | operation]
Syntax Description
addition
(Optional) Enables client added traps.
failure
(Optional) Enables file upload/download failure traps.
lost
(Optional) Enables client lost trap.
operation
(Optional) Enables operation mode change traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server enable traps wireless
To enable sending Simple Network Management Protocol (SNMP) notifications for various wireless traps or inform requests to the network management system (NMS), use the snmp-server enable traps wireless command in global configuration mode. Use the no form of this command to return to the default setting.
snmp-server enable traps wireless [ AP | RRM | bsn80211SecurityTrap | bsnAPParamUpdate | bsnAPProfile | bsnAccessPoint | bsnMobileStation | bsnRogue | client | mfp | rogue ]
no snmp-server enable traps wireless [ AP | RRM | bsn80211SecurityTrap | bsnAPParamUpdate | bsnAPProfile | bsnAccessPoint | bsnMobileStation | bsnRogue | client | mfp | rogue ]
Syntax Description
AP Enables sending AP related traps.
RRM Enables sending RRM traps.
bsn80211SecurityTrap Enables security related traps.
bsnAPParamUpdate Enables sending traps for AP parameters that get updated.
bsnAPProfile Enables bsn AP profile traps.
bsnAccessPoint Enables access point traps.
bsnMobileStation Controls wireless client traps.
bsnRogue Enables rogue related traps.
client Enables client traps.
mfp Enables MFP traps.
rogue Enables rogue traps.
Command History
Usage Guidelines
Specify the host (NMS) that receives the traps by using the snmp-server host global configuration command. If no trap types are specified, all trap types are sent.
Note
Informs are not supported in SNMPv1.
To enable more than one type of trap, you must enter a separate snmp-server enable traps command for each trap type.
snmp-server engineID
To configure a name for either the local or remote copy of SNMP, use the snmp-server engineID command in global configuration mode.
snmp-server engineID { local engineid-string | remote ip-address [ udp-port port-number] engineid-string}
Syntax Description
local engineid-string The engineid-string is a 24-character ID string with the name of the copy of SNMP. You need not specify the entire 24-character engine ID if it has trailing zeros. Specify only the portion of the engine ID up to the point where only zeros remain in the value. The example below configures an engine ID of 123400000000000000000000.
remote ip-address Specifies the remote SNMP copy. If you select remote , specify the ip-address of the device that contains the remote copy of SNMP.
udp-port port-number (Optional) Specifies the User Datagram Protocol (UDP) port on the remote device. The default is 162.
Command History
snmp-server host
To specify the recipient (host) of a Simple Network Management Protocol (SNMP) notification operation, use the snmp-server host global configuration command on the switch. Use the no form of this command to remove the specified host.
snmp-server host { host-addr } [ vrf vrf-instance ] [ informs | traps] [ version { 1 | 2c | 3 { auth | noauth | priv} } ] { community-string [ notification-type] }
no snmp-server host { host-addr } [ vrf vrf-instance ] [ informs | traps] [ version { 1 | 2c | 3 { auth | noauth | priv} } ] { community-string [ notification-type] }
Syntax Description
host-addr
Name or Internet address of the host (the targeted recipient).
vrf vrf-instance
(Optional) Virtual private network (VPN) routing instance and name for this host.
informs | traps
(Optional) Sends SNMP traps or informs to this host.
version 1 | 2c | 3
(Optional) Version of the SNMP used to send the traps.
These keywords are supported:
1—SNMPv1. This option is not available with informs.
2c—SNMPv2C.
3—SNMPv3. One of the authorization keywords (see next table row) must follow the Version 3 keyword.
auth | noauth | priv
auth (Optional)—Enables Message Digest 5 (MD5) and Secure Hash Algorithm (SHA) packet authentication.
noauth (Default)—The noAuthNoPriv security level. This is the default if the auth | noauth | priv keyword choice is not specified.
priv (Optional)—Enables Data Encryption Standard (DES) packet encryption (also called privacy).
community-string
Password-like community string sent with the notification operation. Though you can set this string by using the snmp-server host command, we recommend that you define this string by using the snmp-server community global configuration command before using the snmp-server host command.
Note The @ symbol is used for delimiting the context information. Avoid using the @ symbol as part of the SNMP community string when configuring this command.
notification-type
(Optional) Type of notification to be sent to the host. If no type is specified, all notifications are sent. The notification type can be one or more of the these keywords:
- auth-framework—Sends SNMP CISCO-AUTH-FRAMEWORK-MIB traps.
- bgp—Send Border Gateway Protocol (BGP) state change traps. This keyword is available only when the IP services feature set is enabled on the switch or the active switch.
- bridge—Sends SNMP Spanning Tree Protocol (STP) bridge MIB traps.
- bulkstat—Sends Data-Collection-MIB Collection notification traps.
- call-home—Sends SNMP CISCO-CALLHOME-MIB traps.
- cef—Sends SNMP CEF traps.
- config—Sends SNMP configuration traps.
- config-copy—Sends SNMP config-copy traps.
- config-ctid—Sends SNMP config-ctid traps.
- copy-config—Sends SNMP copy configuration traps.
- cpu—Sends CPU notification traps.
- cpu threshold—Sends CPU threshold notification traps.
- eigrp—Sends SNMP EIGRP traps.
- entity—Sends SNMP entity traps.
notification-type (cont.)
(Optional) Type of notification (cont.):
- envmon—Sends environmental monitor traps.
- errdisable—Sends SNMP errdisable notification traps.
- event-manager—Sends SNMP Embedded Event Manager traps.
- flash—Sends SNMP FLASH notifications.
- flowmon—Sends SNMP flowmon notification traps.
- ipmulticast—Sends SNMP IP multicast routing traps.
- ipsla—Sends SNMP IP SLA traps.
- isis—Sends IS-IS traps.
- license—Sends license traps.
- local-auth—Sends SNMP local auth traps.
- mac-notification—Sends SNMP MAC notification traps.
- msdp—Sends SNMP Multicast Source Discovery Protocol (MSDP) traps.
- ospf—Sends Open Shortest Path First (OSPF) traps.
- pim—Sends SNMP Protocol-Independent Multicast (PIM) traps.
- port-security—Sends SNMP port-security traps.
- power-ethernet—Sends SNMP power ethernet traps.
- rtr—Sends SNMP Response Time Reporter traps.
- snmp—Sends SNMP-type traps.
- storm-control—Sends SNMP storm-control traps.
- stpx—Sends SNMP STP extended MIB traps.
- syslog—Sends SNMP syslog traps.
- transceiver—Sends SNMP transceiver traps.
- tty—Sends TCP connection traps.
- vlan-membership— Sends SNMP VLAN membership traps.
- vlancreate—Sends SNMP VLAN-created traps.
- vlandelete—Sends SNMP VLAN-deleted traps.
- vrfmib—Sends SNMP vrfmib traps.
- vstack—Sends SNMP Smart Install traps.
- vtp—Sends SNMP VLAN Trunking Protocol (VTP) traps.
- wireless—Sends wireless traps.
Command Default
This command is disabled by default. No notifications are sent.
If you enter this command with no keywords, the default is to send all trap types to the host. No informs are sent to this host.
If no version keyword is present, the default is Version 1.
If Version 3 is selected and no authentication keyword is entered, the default is the noauth (noAuthNoPriv) security level.
Note
Though visible in the command-line help strings, the fru-ctrl keyword is not supported.
Command History
Usage Guidelines
SNMP notifications can be sent as traps or inform requests. Traps are unreliable because the receiver does not send acknowledgments when it receives traps. The sender cannot determine if the traps were received. However, an SNMP entity that receives an inform request acknowledges the message with an SNMP response PDU. If the sender never receives the response, the inform request can be sent again. Thus, informs are more likely to reach their intended destinations.
However, informs consume more resources in the agent and in the network. Unlike a trap, which is discarded as soon as it is sent, an inform request must be held in memory until a response is received or the request times out. Traps are also sent only once, but an inform might be retried several times. The retries increase traffic and contribute to a higher overhead on the network.
If you do not enter an snmp-server host command, no notifications are sent. To configure the switch to send SNMP notifications, you must enter at least one snmp-server host command. If you enter the command with no keywords, all trap types are enabled for the host. To enable multiple hosts, you must enter a separate snmp-server host command for each host. You can specify multiple notification types in the command for each host.
If a local user is not associated with a remote host, the switch does not send informs for the auth (authNoPriv) and the priv (authPriv) authentication levels.
When multiple snmp-server host commands are given for the same host and kind of notification (trap or inform), each succeeding command overwrites the previous command. Only the last snmp-server host command is in effect. For example, if you enter an snmp-server host inform command for a host and then enter another snmp-server host inform command for the same host, the second command replaces the first.
The snmp-server host command is used with the snmp-server enable traps global configuration command. Use the snmp-server enable traps command to specify which SNMP notifications are sent globally. For a host to receive most notifications, at least one snmp-server enable traps command and the snmp-server host command for that host must be enabled. Some notification types cannot be controlled with the snmp-server enable traps command. For example, some notification types are always enabled. Other notification types are enabled by a different command.
The no snmp-server host command with no keywords disables traps, but not informs, to the host. To disable informs, use the no snmp-server host informs command.
Examples
This example shows how to configure a unique SNMP community string named comaccess for traps and prevent SNMP polling access with this string through access-list 10:
Switch(config)# snmp-server community comaccess ro 10 Switch(config)# snmp-server host 172.20.2.160 comaccess Switch(config)# access-list 10 deny anyThis example shows how to send the SNMP traps to the host specified by the name myhost.cisco.com. The community string is defined as comaccess:
Switch(config)# snmp-server enable traps Switch(config)# snmp-server host myhost.cisco.com comaccess snmpThis example shows how to enable the switch to send all traps to the host myhost.cisco.com by using the community string public:
Switch(config)# snmp-server enable traps Switch(config)# snmp-server host myhost.cisco.com publicYou can verify your settings by entering the show running-config privileged EXEC command.
Related Commands
Command
Description
Enables the switch to send SNMP notifications for various traps or inform requests to the NMS.
trapflags
To enable trapflags for various parameters, use the trapflags command. To disable, use the no form of the command.
trapflags { ap | { interfaceup | register } | client | { dot11 | excluded } | dot11-security | { ids-sig-attack | wep-decrypt-error } | mesh | rougeap | rrm-params | { channels | tx-power } | rrm-profile | { coverage | interference | load | noise } }
no trapflags { ap | { interfaceup | register } | client | { dot11 | excluded } | dot11-security | { ids-sig-attack | wep-decrypt-error } | mesh | rougeap | rrm-params | { channels | tx-power } | rrm-profile | { coverage | interference | load | noise } }
Syntax Description
ap Enables sending AP related Traps.
interfaceup Enables Trap when a Cisco AP Interface(A or B) comes up.
register Enables Trap when a Cisco AP registers with Cisco switch.
client Enables sending Client related Dot11 Traps.
dot11 Enables Dot11 Traps for Clients.
excluded Enables Excluded Trap for Clients.
dot11-security Enables sending 802.11 Security related Traps.
ids-sig-attack Enables IDS Signature attack traps.
wep-decrypt-error Enables WEP Decrypt Error for Clients.
mesh Enables Mesh Trap.
rougeap Enables RogueAP Detection Trap.
rrm-params Enables sending RRM Paramemeter Update related traps.
channels Enables Trap when RF Manager automatically changes Channel Number for Cisco AP interface.
tx-power Enables Trap when RF Manager automatically changes Tx-Power Level for Cisco AP interface.
rrm-profile Enables sending RRM Profile related Traps.
coverage Enables Trap when Coverage profile maintained by RF Manager fails.
interference Enables Trap when Interference profile maintained by RF Managerfails.
load Enables Trap when Load profile maintained by RF Manager fails.
noise Enables Trap when Noise profile maintained by RF Manager fails.
Command History
