SNMP Server Commands Chapter Map

clear snmp counters

To clear the Simple Network Management Protocol (SNMP) packet statistics shown by the show snmp command, use the clear snmp counters command in XR EXEC mode.

clear snmp counters

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The clear snmp counters command provides the ability to clear all SNMP counters used in the show snmp command without restarting any processes.

Task ID

Task ID

Operations

snmp

read, write

Examples

The following example shows how to clear the SNMP counters:


RP/0/RP0/CPU0:router# clear snmp counters 
           

index persistence

To enable index persistence on an Simple Network Management Protocol (SNMP) interface, use the index persistence command in SNMP interface configuration mode. To restore the default conditions with respect to this command, use the no form of this command.

index persistence

no index persistence

Syntax Description

This command has no keywords or arguments.

Command Default

Index persistence is disabled.

Command Modes

SNMP interface configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the index persistence command to enable ifIndex persistence for individual entries (corresponding to individual interfaces) in the ifIndex table of the IF-MIB. IfIndex persistence retains the mapping between the ifName object values and the ifIndex object values (generated from the IF-MIB) across reboots, allowing for consistent identification of specific interfaces using SNMP.

Task ID

Task ID

Operations

snmp

read, write

Examples

The following example shows how to assign ifIndex persistence on interface 0/0/1/0:


RP/0/RP0/CPU0:router(config)# snmp-server interface tengige 0/0/1/0 
RP/0/RP0/CPU0:router(config-snmp-if)# index persistence 
  
         

notification linkupdown

To enable or disable linkUp and linkDown trap notifications on a Simple Network Management Protocol (SNMP) interface, use the notification linkupdown command in SNMP interface configuration mode. To revert to the default setting, use the no form of this command.

notification linkupdown disable

no notification linkupdown disable

Syntax Description

disable

Disables linkUp and linkDown trap notifications on an SNMP interface.

Syntax Description

This command has no keywords or arguments.

Command Default

By default, for all main interfaces the linkUp and linkDown trap notifications are enabled; for all subinterfaces they are disabled.

Command Modes

SNMP interface configuration

SNMP interface subset configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Enabling of linkUp and linkDown notifications is performed globally using the snmp-server traps snmp command. Issue the notification linkupdown command to disable linkUp and linkDown notifications on an interface.

Use the no form of this command to enable linkUp and linkDown notifications on an interface, if linkUp and linkDown notifications have been disabled.

You can also use the snmp-server interface subset command to enable or disable groups of interfaces.

Task ID

Task ID

Operations

snmp

read, write

Examples

The following example shows how to disable linkUp and linkDown trap notifications on interface 0/0/1/0:


RP/0/RP0/CPU0:router(config)# snmp-server interface tengige 0/0/1/0
RP/0/RP0/CPU0:router(config-snmp-if)# notification linkupdown disable
                     

script snmp

To configure the checksum of the newly added script file, use the script snmp command in XR Config mode.

script snmp file-name checksum sha256 checksum-value

no script snmp file-name checksum sha256 checksum-value

Syntax Description

file-name

The name of the script file.

checksum sha256 checksum-value

The checksum of the script file.

Command Default

None

Command Modes

XR Config

Command History

Release Modification
Release 7.5.3

This command was introduced.

Usage Guidelines

To use commands of this module, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using any command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

snmp

read,write

Examples

This example shows how to configure the checksum of the newly added script file.

Router(config)#script snmp show_lldp_string.py checksum sha256 156345c2cbfc1a2725b5f5ecdfb23d30d9a25e894604890d88929d724946e7b3

show snmp

To display the status of Simple Network Management Protocol (SNMP) communications, use the show snmp command in

EXEC

mode.

show snmp

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the show snmp command to show counter information for SNMP operations. It also displays the chassis ID string defined with the snmp-server chassis-id command.

Task ID

Task ID

Operations

snmp

read

Examples

This example shows sample output from the show snmp command:


RP/0/RP0/CPU0:router# show snmp
  
  Chassis: 01506199
  37 SNMP packets input
  0 Bad SNMP version errors
  4 Unknown community name
  0 Illegal operation for community name supplied
  0 Encoding errors
  24 Number of requested variables
  0 Number of altered variables
  0 Get-request PDUs
  28 Get-next PDUs
  0 Set-request PDUs
  78 SNMP packets output
  0 Too big errors (Maximum packet size 1500)
  0 No such name errors
  0 Bad values errors
  0 General errors
  24 Response PDUs
  13 Trap PDUs
  SNMP logging: enabled
  Logging to 172.25.58.33.162, 0/10, 13 sent, 0 dropped.
  
  

The following table describes the significant fields shown in the display.

Table 1. show snmp Field Descriptions

Field

Description

Chassis

Chassis ID string.

SNMP packets input

Total number of SNMP packets input.

Bad SNMP version errors

Number of packets with an invalid SNMP version.

Unknown community name

Number of SNMP packets with an unknown community name.

Illegal operation for community name supplied

Number of packets requesting an operation not allowed for that community.

Encoding errors

Number of SNMP packets that were improperly encoded.

Number of requested variables

Number of variables requested by SNMP managers.

Number of altered variables

Number of variables altered by SNMP managers.

Get-request PDUs

Number of get requests received

Get-next PDUs

Number of get-next requests received.

Set-request PDUs

Number of set requests received.

SNMP packets output

Total number of SNMP packets sent by the device.

Too big errors

Number of SNMP packets that were larger than the maximum packet size.

Maximum packet size

Maximum size of SNMP packets.

No such name errors

Number of SNMP requests that specified a MIB object that does not exist.

Bad values errors

Number of SNMP set requests that specified an invalid value for a MIB object.

General errors

Number of SNMP set requests that failed due to some other error. (It is not a noSuchName error, badValue error, or any of the other specific errors.)

Response PDUs

Number of responses sent in reply to requests.

Trap PDUs

Number of SNMP traps sent.

SNMP logging

Enabled or disabled logging.

sent

Number of traps sent.

dropped

Number of traps dropped. Traps are dropped when the trap queue for a destination exceeds the maximum length of the queue, as set by the snmp-server queue-length command.

show snmp context

To display the enhanced SNMP context mappings, use the show snmp context command in EXEC mode.

show snmp context

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the show snmp context command to display the protocol instance, topology and VRF mappings associated with an SNMP context.

Task ID

Task ID Operation

snmp

read

Examples

This example illustrates sample output from the show snmp context command:


RP/0/RP0/CPU0:router# show snmp context

Tue Dec 21 03:41:08.065 PST
Context-name       Vrf-name      Topology-Name   Instance-Name             Feature
con5                  vf5           tp5             in5                      OSPF
con6                  vf6           tp6             in6                      OSPF
con7                  vf7           tp7             in7                      OSPF
con8                  vf8           tp8             in8                      OSPF
   

show snmp context-mapping

To display the SNMP context mapping table, use the show snmp context-mapping command in

EXEC

mode.

show snmp context-mapping

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The SNMP agent handles queries based on SNMP contexts created by client features. Use the show snmp context-mapping command to display the SNMP context mapping table. Each entry in the table includes the name of an SNMP context created by a client instance and the name of the client that created the context.

Task ID

Task ID

Operations

snmp

read

Examples

The following example shows sample output from the show snmp context-mapping command:


RP/0/RP0/CPU0:router# show snmp context-mapping              
  
Wed Aug 6 01:42:35.227 UTC 
Context-name                  Feature-name                  Feature 
ControlEthernet0_RP0_CPU0_S0  ControlEthernet0_RP0_CPU0_S0  BRIDGEINST 
ControlEthernet0_RP1_CPU0_S0     ControlEthernet0_RP1_CPU0_S0     BRIDGEINST

  
Table 2. show snmp context-mapping Field Descriptions

Field

Definition

Context-name

Name of an SNMP context.

Feature-name

Name of the instance that created the context.

Feature

Name of the client whose instance created the context.

show snmp engineid

To display the identification of the local Simple Network Management Protocol (SNMP) engine that has been configured on the router, use the show snmp engineid command in XR EXEC mode.

show snmp engineid

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

An SNMP engine is a copy of SNMP that can reside on a local device.

Task ID

Task ID

Operations

snmp

read

Examples

The following example shows sample output from the show snmp engineid command:


RP/0/RP0/CPU0:router# show snmp engineid
  
  Local SNMP engineID: 00000009020000000C025808
  

show snmp group

To display the names of groups on the router, security model, status of the different views, and storage type of each group, use the show snmp group command in

EXEC

mode.

show snmp group

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID

Operations

snmp

read

Examples

This example shows sample output from the show snmp group command:


RP/0/RP0/CPU0:router# show snmp group
  
  groupname: public security model:snmpv1
  readview : v1default writeview: -
  notifyview: v1default
  row status: nonVolatile
  
  groupname: public security model:snmpv2c
  readview : v1default writeview: -
  notifyview: v1default
  row status: nonVolatile
  
Table 3. show snmp group Field Descriptions

Field

Definition

groupname

Name of the Simple Network Management Protocol (SNMP) group or collection of users that have a common access policy.

readview

String identifying the read view of the group.

security model

Security model used by the group, either v1, v2c, or v3.

writeview

String identifying the write view of the group.

notifyview

String identifying the notify view of the group.

row status

Settings that are set in volatile or temporary memory on the device, or in nonvolatile or persistent memory where settings remain after the device is turned off and on again.

show snmp host

To display the configured Simple Network Management Protocol (SNMP) notification recipient host, User Datagram Protocol (UDP) port number, user, and security model, use the show snmp host command in

EXEC

mode.

show snmp host

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID

Operations

snmp

read

Examples

The following example shows sample output from the show snmp host command:


RP/0/RP0/CPU0:router# show snmp host
  
  Notification host: 10.50.32.170 udp-port: 2345 type: trap
  user: userV3auth security model: v3 auth
  
  Notification host: 10.50.32.170 udp-port: 2345 type: trap
  user: userV3noauth security model: v3 noauth
  
  Notification host: 10.50.32.170 udp-port: 2345 type: trap
  user: userV3priv security model: v3 priv
  
  Notification host: 10.50.32.170 udp-port: 2345 type: trap
  user: userv2c security model: v2c
    
Table 4. show snmp host Field Descriptions

Field

Definition

Notification host

Name or IP address of target host.

udp-port

UDP port number to which notifications are sent.

type

Type of notification configured.

user

Security level of the user.

security model

Version of SNMP used to send the trap, either v1, v2c, or v3.

show snmp informs details

To show the details about the informs generated for each host, the drop and retry count and the timestamp, use the show snmp informs details command in XR EXEC mode.

show snmp informs details

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The show snmp informs details command shows these details:

Field

Description

InformOID

Generated inform.

Sent

Number of times the Inform is sent from the inform host and port configiured.

Drop

Number of times the Inform is sent from the inform host and port configiured.

Retry

Number of times the Inform retries from the inform host and port configiured

Last-sent

Time stamp when the last inform was sent from the host and port.

Last-drop

Time stamp when the last inform dropped from the host and port.

Host

Configured address of the host to receive traps.

udp-port

Configured port to receive traps.

Task ID

Task ID

Operations

snmp

read, write

Examples


RP/0/RP0/CPU0:router# show snmp informs details 
Mon Apr  7 17:14:17.212 UTC
HOST:9.22.24.150, udp-port:5555
------------------------------
InformOID                           Sent    Drop    Retry   Last-sent                   Last-drop
ciscoConfigManMIB.2.0.1             8       2       6       Mon Apr 07 14 17:12:54      Mon Apr 07 14 17:12:42
ciscoFlashDeviceInsertedNotif       4       1       3       Mon Apr 07 14 17:12:55      Mon Apr 07 14 17:12:42
ciscoFlashDeviceRemovedNotif        4       1       3       Mon Apr 07 14 17:12:54      Mon Apr 07 14 17:12:42
ciscoMgmt.117.2.0.1                 8       2       6       Mon Apr 07 14 17:12:53      Mon Apr 07 14 17:12:42
ciscoMgmt.117.2.0.2                 4       1       3       Mon Apr 07 14 17:12:52      Mon Apr 07 14 17:12:42|

show snmp interface

To display the interface index identification numbers (ifIndex values) for all the interfaces or a specified interface, use the show snmp interface command in the appropriate mode.

show snmp interface [type interface-path-id ifindex]

Syntax Description

type

(Optional) Interface type. For more information, use the question mark (?) online help function.

interface-path-id

(Optional) Physical interface or virtual interface.

Note

 

Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (? ) online help function.

ifindex

(Optional) Displays the ifIndex value for the specified interface.

Command Default

Enter the show snmp interface command without keywords or arguments to display the ifIndex value for all interfaces.

Command Modes

EXEC

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID

Operations

snmp

read

Examples

This example displays the ifIndex value for a specific interface:


RP/0/RP0/CPU0:router# show snmp interface pos 0/1/0/1 ifindex 
  
ifName : POS0/1/0/1            ifIndex : 12
    

The following example displays the ifIndex value for all interfaces:


RP/0/RP0/CPU0:router# show snmp interface 
  
  ifName : Loopback0             ifIndex : 1
  ifName : POS0/1/0/1            ifIndex : 12
  ifName : POS0/1/4/2            ifIndex : 14
  ifName : POS0/1/4/3            ifIndex : 15
  ifName : POS0/6/0/1            ifIndex : 2
  ifName : POS0/6/4/4            ifIndex : 18
  ifName : POS0/6/4/5            ifIndex : 19
  ifName : POS0/6/4/6            ifIndex : 20
  ifName : Bundle-POS24          ifIndex : 4
  ifName : Bundle-Ether28        ifIndex : 5
  ifName : Bundle-Ether28.1      ifIndex : 7
  ifName : Bundle-Ether28.2      ifIndex : 8
  ifName : Bundle-Ether28.3      ifIndex : 9
  ifName : MgmtEth0/RP0/CPU0/0   ifIndex : 6
  ifName : MgmtEth0/RP1/CPU0/0   ifIndex : 10
  ifName : GigabitEthernet0/1/5/0  ifIndex : 11
  ifName : GigabitEthernet0/1/5/1  ifIndex : 13
  ifName : GigabitEthernet0/1/5/2  ifIndex : 3
  ifName : GigabitEthernet0/6/5/1  ifIndex : 16
  ifName : GigabitEthernet0/6/5/2  ifIndex : 17
  ifName : GigabitEthernet0/6/5/7  ifIndex : 21
    
Table 5. show snmp interface Field Descriptions

Field

Definition

ifName

Interface name.

ifIndex

ifIndex value.

show snmp interface notification

To display the linkUp and linkDown notification status for a subset of interfaces, use the show snmp interface notification command in EXEC mode.

show snmp interface notification {subset subset-number | regular-expression expression | [type interface-path-id]}

Syntax Description

subset subset-number

Specifies the identifier of the interface subset. The subset-number argument is configured using the snmp-server interface subset command.

regular-expression expression

Specifies a subset of interfaces matching a regular expression, for which to display information.

type

(Optional) Interface type. For more information, use the question mark (?) online help function.

interface-path-id

(Optional) Physical interface or virtual interface.

Note

 

Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark ( ? ) online help function.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Regular expressions have two constraints:

  • Regular expressions must always be entered within double quotes to ensure that the CLI interprets each character correctly.

  • All characters that are part of a regular expression are considered regular characters with no special meaning. In order to enter special characters, such as "\" or "?," they must be preceded by the backslash character "\." For example, to enter the regular expression ([A-Z][A-Z0-9]*)\b[^>]*>(.*?)</\1, you would enter ([A-Z][A-Z0-9]*)\\b[^>]*>(.*\?)</\\1.

Refer to the Understanding Regular Expressions, Special Characters, and Patterns module in for more information regarding regular expressions.

When using the subset or regular-expression keywords, the actual display might not match the configuration if there are higher priority subset-number values that actually apply to the interface. This can happen for a set of interfaces that are included in two or more configured regular expressions or where an individual interface configuration is enabled.

Task ID

Task ID Operation
snmp

read

Examples

The following example illustrates how to display linkUp and linkDown notification status for a subset of interfaces identified by a specific subset-number :

RP/0/RP0/CPU0:router# show snmp interface notification subset 3

This example illustrates how to display linkUp and linkDown notification status for a subset of interfaces identified by a regular expression:

RP/0/RP0/CPU0:router# show snmp interface notification regular-expression "^Gig[a-zA-Z]+[0-9/]+\."

show snmp interface regular-expression

To display interface names and indices assigned to interfaces that match a regular expression, use the show snmp interface regular-expression command in EXEC mode.

show snmp interface regular-expression expression

Syntax Description

expression

Specifies a subset of interfaces matching a regular expression, for which to display information.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

All characters that are part of a regular expression are considered regular characters with no special meaning. In order to enter special characters, such as "\" or "?," they must be preceded by the backslash character "\." For example, to enter the regular expression ([A-Z][A-Z0-9]*)\b[^>]*>(.*?)</\1, you would enter ([A-Z][A-Z0-9]*)\\b[^>]*>(.*\?)</\\1.

Refer to the Understanding Regular Expressions, Special Characters, and Patterns module in for more information regarding regular expressions.

Task ID

Task ID Operation
snmp

read

Examples

This example illustrates how to display information for interfaces that match the given regular expression:


RP/0/RP0/CPU0:router# show snmp interface regular-expression "^Gig[a-zA-Z]+[0-9/]+\." 
  

show snmp mib

To display a list of MIB module object identifiers (OIDs) registered on the system, use the show snmp mib command in

EXEC

mode.

show snmp mib [object-name | dll]

Syntax Description

object-name

(Optional) Specific MIB object identifier or object name.

dll

(Optional) Displays a list of all MIB DLL filenames and the OID supported by each DLL filename on the system.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the show snmp mib command to display a list of the MIB module instance identifiers registered on the system.

Although the show snmp mib command can be used to display a list of MIB OIDs registered on the system, the use of a Network Management System (NMS) application is the recommended alternative for gathering this information.

The show snmp mib command is intended only for network managers who are familiar with Abstract Syntax Notation One (ASN.1) syntax and the Structure of Management Information (SMI) of Open Systems Interconnection (OSI) Reference Model.

SNMP management information is viewed as a collection of managed objects residing in a virtual information store termed the MIB. Collections of related objects are defined in MIB modules. These modules are written using a subset of ASN.1 termed the SMI.

The definitions for the OIDs displayed by this command can be found in the relevant RFCs and MIB modules. For example, RFC 1907 defines the system.x, sysOREntry.x, snmp.x, and snmpTrap.x OIDs, and this information is supplemented by the extensions defined in the CISCO-SYSTEM-MIB.

Use the detailed keyword to display a list of the MIB module instance identifiers registered on the system. The output displays additional details, such as DLL and configuration information.

Use the dll keyword to display a list of the MIB modules loaded into the agent. This command can be used to find the supported MIBs.


Note


This command produces a high volume of output if SNMP is enabled on the system. To exit from a --More-- prompt, press Crtl-Z.


Task ID

Task ID

Operations

snmp

read

Examples

The following example shows sample output from the show snmp mib command:


RP/0/RP0/CPU0:router# show snmp mib 
  
1.3.6.1.2.1.47.1.1.1.1.2 
1.3.6.1.2.1.47.1.1.1.1.3 
1.3.6.1.2.1.47.1.1.1.1.4 
1.3.6.1.2.1.47.1.1.1.1.5 
1.3.6.1.2.1.47.1.1.1.1.6 
1.3.6.1.2.1.47.1.1.1.1.7 
1.3.6.1.2.1.47.1.1.1.1.8 
1.3.6.1.2.1.47.1.1.1.1.9 
1.3.6.1.2.1.47.1.1.1.1.10 
1.3.6.1.2.1.47.1.1.1.1.11 
1.3.6.1.2.1.47.1.1.1.1.12 
1.3.6.1.2.1.47.1.1.1.1.13 
1.3.6.1.2.1.47.1.1.1.1.14 
1.3.6.1.2.1.47.1.1.1.1.15 
1.3.6.1.2.1.47.1.1.1.1.16 
1.3.6.1.2.1.47.1.2.1.1.2 
1.3.6.1.2.1.47.1.2.1.1.3 
1.3.6.1.2.1.47.1.2.1.1.4 
1.3.6.1.2.1.47.1.2.1.1.5 
1.3.6.1.2.1.47.1.2.1.1.6 
1.3.6.1.2.1.47.1.2.1.1.7 
1.3.6.1.2.1.47.1.2.1.1.8 
1.3.6.1.2.1.47.1.3.1.1.1 
--More-  
  

This example shows sample output from the show snmp mib command with the detailed keyword:


RP/0/RP0/CPU0:router# show snmp mib detailed 
  
Entitymib:dll=/pkg/lib/mib/libEntitymib.dll, config=Entity.mib, loaded
1.3.6.1.2.1.47.1.1.1.1.2
1.3.6.1.2.1.47.1.1.1.1.3
1.3.6.1.2.1.47.1.1.1.1.4
1.3.6.1.2.1.47.1.1.1.1.5
1.3.6.1.2.1.47.1.1.1.1.6
1.3.6.1.2.1.47.1.1.1.1.7
1.3.6.1.2.1.47.1.1.1.1.8
1.3.6.1.2.1.47.1.1.1.1.9
1.3.6.1.2.1.47.1.1.1.1.10
1.3.6.1.2.1.47.1.1.1.1.11
1.3.6.1.2.1.47.1.1.1.1.12
1.3.6.1.2.1.47.1.1.1.1.13
1.3.6.1.2.1.47.1.1.1.1.14
1.3.6.1.2.1.47.1.1.1.1.15
1.3.6.1.2.1.47.1.1.1.1.16
1.3.6.1.2.1.47.1.2.1.1.2
1.3.6.1.2.1.47.1.2.1.1.3
1.3.6.1.2.1.47.1.2.1.1.4
1.3.6.1.2.1.47.1.2.1.1.5
1.3.6.1.2.1.47.1.2.1.1.6
1.3.6.1.2.1.47.1.2.1.1.7
1.3.6.1.2.1.47.1.2.1.1.8
--More--
  

This example shows sample output from the show snmp mib command with the dll keyword:


RP/0/RP0/CPU0:router# show snmp mib dll
  
Entitymib:dll=/pkg/lib/mib/libEntitymib.dll, config=Entity.mib, loaded
bgp4mib:dll=/pkg/lib/mib/libbgp4mib.dll, config=bgp4.mib, loaded
cdpmib:dll=/pkg/lib/mib/libcdpmib.dll, config=cdp.mib, loaded
ciscoprocessmib:dll=/pkg/lib/mib/libciscoprocessmib.dll, 
 config=ciscoprocess.mib, loaded
ciscosyslogmib:dll=/pkg/lib/mib/libciscosyslogmib.dll, 
 config=ciscosyslog.mib, loaded
ciscosystemmib:dll=/pkg/lib/mib/libciscosystemmib.dll, 
 config=ciscosystem.mib, loaded
confcopymib:dll=/pkg/lib/mib/libconfcopymib.dll, config=confcopy.mib, 
 loaded
configmanmib:dll=/pkg/lib/mib/libconfigmanmib.dll, config=configman.mib, 
 loaded
dot3admib:dll=/pkg/lib/mib/libdot3admib.dll, config=dot3ad.mib, 
 loaded
fabhfrmib:dll=/pkg/lib/mib/libfabhfrmib.dll, config=fabhfr.mib, 
 loaded
fabmcastapplmib:dll=/pkg/lib/mib/libfabmcastapplmib.dll, 
 config=fabmcastappl.mib, loaded
fabmcastmib:dll=/pkg/lib/mib/libfabmcastmib.dll, config=fabmcast.mib, 
 loaded
flashmib:dll=/pkg/lib/mib/libflashmib.dll, config=flash.mib,  
 loaded
hsrpmib:dll=/pkg/lib/mib/libhsrpmib.dll, config=hsrp.mib, loaded
icmpmib:dll=/pkg/lib/mib/libicmpmib.dll, config=icmp.mib, loaded
ifmib:dll=/pkg/lib/mib/libifmib.dll, config=if.mib, loaded
ipmib:dll=/pkg/lib/mib/libipmib.dll, config=ip.mib, loaded
mempoolmib:dll=/pkg/lib/mib/libmempoolmib.dll, config=mempool.mib,  
 loaded
mplsldpmib:dll=/pkg/lib/mib/libmplsldpmib.dll, config=mplsldp.mib, 
 loaded
.
.
.
  

show snmp mib ifmib cache

To show the Ifindex that has exceeded the threshold time for processing, the request type and the time stamp, use the show snmp mib ifmib cache command in XR EXEC mode. The threshold time for the data to create an entry is 500 milli seconds.

show snmp mib ifmib cache

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

This command displays the latest 500 entries. An entry will be added when the difference between Cache in and Cache out time is more than 500 milli seconds. The timeout value cannot be changed.

The show snmp mib ifmib cache command shows these details:

Field

Description

Index

Interface index.

MIB IN

Time stamp of the request when IFMIB starts processing.

Cache In

Time stamp in milli seconds when data retrieval from the cache starts for the request. It is offset from MIB IN time stamp.

Cache Out

Time stamp in milli seconds when data is retrieved from cache. It is offset from MIB IN time stamp.

MIB Out

Time stamp in milli seconds of the response from IF MIB. It is offset from MIB IN time stamp.

Task ID

Task ID

Operations

snmp

read, write

Examples


RP/0/RP0/CPU0:router# show snmp mib ifmib cache 
IFIndex    Type          MIB IN                     CACHE IN[ms]          CACHE OUT[ms]          MIB OUT[ms]        

2          NEXT          Mar 18 07:14:41.815            4                    701                    701                   

2          NEXT          Mar 18 07:15:36.815            0                    679                    679                   

2          NEXT          Mar 18 07:16:00.735            0                    684                    684   

show snmp mib ifmib general

To show how many requests get data from internal cache and how many requests are sent to statsd to get data, use the show snmp mib ifmib general command in XR EXEC mode.

show snmp mib ifmib general

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Default IFMIB internal cache is 15 seconds. To change the duration, use the command:
snmp-server ifmib internal cache max-duration <0-60>
The default duration is 15 seconds, 0 seconds to disable the IFMIB internal cache.
To service the requests from Stats cache instead of Drivers, use the command:
snmp-server ifmib stats cache

The show snmp mib ifmib general command shows these details:

Field

Description

Cache Hit

Number of times the request retrieves data from IFMIB internal cache.

Cache Miss

Number of times the request processed from statsd, and not from IFMIB internal cache

Last Access Time

Latest time stamp of corresponding hit or miss.

Count

Number of times the data is retrieved.

The Cache Hit and Cache Miss are 32 bit counters. The maximum value is 2^31 and reset to 0 if the maximum value is exceeded.

Task ID

Task ID

Operations

snmp

read, write

Examples


RP/0/RP0/CPU0:router# Show snmp mib ifmib general 
 Fri Mar 14 05:05:50.408 PDT

Type                    Count            Last Access Time     

Cache Hit               328              Mar 14 05:05:47.480  

Cache Miss               2               Mar 14 05:05:47.386

show snmp mib ifmib statsd

To show the Ifindex that has exceeded the threshold time for processing, the request type and the time stamp, use the show snmp mib ifmib statsd command in XR EXEC mode. The threshold time for the data to create an entry is 500 milli seconds.

show snmp mib ifmib statsd

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

This command displays the latest 500 entries. An entry will be added when the difference between Stats in and Stats out time is more than 500 milli seconds. The timeout value cannot be changed.

The show snmp mib ifmib statsd command shows these details:

Field

Description

Index

Interface index.

MIB IN

Time stamp of the request when IFMIB starts processing.

Stats In

Time stamp in milli seconds when data retrieval from the Statsd starts for the request. It is offset from MIB IN time stamp.

Stats Out

Time stamp in milli seconds when data is retrieved from Statsd. It is offset from MIB IN time stamp.

MIB Out

Time stamp in milli seconds of the response from IF MIB. It is offset from MIB IN time stamp.

Task ID

Task ID

Operations

snmp

read, write

Examples


RP/0/RP0/CPU0:router# show snmp mib ifmib statsd 
IFIndex    Type          MIB IN                     STATS IN[ms]      STATS OUT[ms]     MIB OUT[ms]        

2          NEXT          Mar 18 07:14:41.815         4                   701              701                   

2          NEXT          Mar 18 07:15:36.815         0                   679              679                   

2          NEXT          Mar 18 07:16:00.735         0                   684              684     

show snmp request drop summary

To show the summary of overall packet drop, use the show snmp request drop summary command in XR EXEC mode.

show snmp request drop summary

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The show snmp request drop summary command shows these details:

Field

Description

NMS Address

Address of network management station from which request is received.

IN Q

Number of packets dropped in incoming queue as the dropped packets are not processed more than 10 seconds.

Encode

Number of packets dropped because of encode errors.

Duplicate

Number of requests dropped with duplicate request feature.

Stack

Numbers of requests are dropped in stack.

AIPC

Number of packets dropped at AIPC module.

Overload

Number of packets dropped because of overload control notification.

Timeout

Number of packets are dropped because of slow response from MIB.

Internal

Number of packets dropped because of internal failures.

Task ID

Task ID

Operations

snmp

read, write

Examples


RP/0/RP0/CPU0:router# show snmp request drop summary 
 Fri Mar 14 05:32:31.732 PDT
NMS Address          INQ   Encode    Duplicate   Stack    AIPC   Overload   Timeout   Internal
 1.2.3.4              0     0         0            0      0         218        0         0    
NMS Address : 1:2:3::4
INQ      Encode     Duplicate    Stack    AIPC    Overload     Timeout     Internal
0         0           0             0       0       109           0           0   

show snmp request duplicates

To display the number of duplicate protocol data unit (PDU) requests dropped by the SNMP agent, use the show snmp request duplicates command in

EXEC

mode.

show snmp request duplicates

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
snmp

read

Examples

This example illustrates sample output from the show snmp request duplicates command:


RP/0/RP0/CPU0:router# show snmp request duplicates

No of Duplicate request received/Dropped : 0
  

show snmp request incoming-queue detail

To show the details of the queue of incoming SNMP requests, use the show snmp request incoming-queue detail command in XR EXEC mode.

show snmp request incoming-queue detail

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

This command shows an output for maximum of 15 queues and an additional general queue. The entry will be deleted when any queue is not polled for 30 minutes.

This command shows these details:

Field

Description

NMS Address

Source address (IPv4 or IPv6) of network management system (NMS) queue. Specifies the NMS packet requests in this queue.

Q Depth

Number of packets to be processed in the queue.

Deque Count

Number of packets that are processed.

Priority

Priority of queue with packets to be processed. The priority ranges from 1 to 5, 1 indicates low priority and 5 indicates high priority.

Enque time

Time stamp of last request in the queue.

Task ID

Task ID

Operations

snmp

read, write

Examples


RP/0/RP0/CPU0:router# show snmp request incoming-queue detail 
 Wed Mar 12 05:16:59.505 PDT

NMS ADDRESS          Q Depth      Deque count          Priority              Enque time

4.5.6.7               0                1223              1                    Wed Mar 12 05:16:25 

1.2.3.4               0                1193              1                    Wed Mar 12 05:15:06 

General Q             0                 0                0                    Wed Mar 12 05:14:49 

NMS ADDRESS       : 4:5:6::7

  Q Depth     Deque count           Priority                Enque time

  0                1220                1                     Wed Mar 12 05:16:02 

NMS ADDRESS       : 1:2:3::4

  Q Depth     Deque count          Priority                Enque time

  0               1221                 1                      Wed Mar 12 05:15:37

show snmp request overload stats

To show the number of packets dropped due to overload feature, use the snmp request overload stats command in XR EXEC mode.

show snmp request overload stats

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

This command displays the latest 100 entries.

The show snmp request overload stats command shows these details:

Field

Description

StartTime

Time when overload control notification is received.

InQInDrop

Number of packet drops before inserting in incoming queue.

InQOutDrop

Number of packets dropped from incoming queue.

EndTime

Time when overload control notification ends.

Task ID

Task ID

Operations

snmp

read, write

Examples


RP/0/RP0/CPU0:router# show snmp request overload stats 
Thu Mar 13 07:00:45.575 UTC
StartTime                           InQInDrop        InQOutDrop                 EndTime                 
Thu Mar 13 07:00:28                    1                0                         Thu Mar 13 07:00:38

show snmp request type detail

To shows the group that is polled frequently and from which network management system (NMS), use the show snmp reqest type detail command in XR EXEC mode.

show snmp request type detail

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The show snmp request type detail command shows these details:

Field

Description

NMS Address

Address of Network Management Station from which the request is received.

Request

Number of requests from NMS.

SNMPD

Number of requests to snmpd.

Interface

Number of requests to mibd_interface.

Entity

Number of requests to mibd_entity.

Route

Number of requests to mibd_route.

Infra

Number of requests to mibd_infra.

Task ID

Task ID

Operations

snmp

read, write

Examples


RP/0/RP0/CPU0:router# show snmp request type detail 
Wed Mar 12 05:17:34.838 PDT
NMS Address      Request    AGENT    INTERFACE    ENTITY    ROUTE    INFRA
1.2.3.4          1193       52          742        70       267        123       
4.5.6.7          1223       52          742        100      267        123       
1:2:3::4         1221       52          742        100      265        123       
4:5:6::7         1220       52          742        100      265        122  

show snmp request type summary

To show the types of requests sent from each network management system (NMS), use the show snmp request type summary command in XR EXEC mode.

show snmp request type summary

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The show snmp request type summary command shows these details:

Field

Description

NMS address

IP address of the NMS that sent the request.

Get

Number of requests of Get type.

Getnext

Number of requests of Getnext type.

Getbulk

Number of requests of Getbulk type.

Set

Number of requests of Set type.

Test

Number of requests of Test type that is part of Set request.

Task ID

Task ID

Operations

snmp

read, write

Examples


RP/0/RP0/CPU0:router# show snmp request type summary 
 Wed Mar 12 05:17:14.643 PDT
NMS Address          Get      GetNext      GetBulk      Set      Test
 1.2.3.4             0          1254         0           0         0       
 4.5.6.7             0          5101         0           0         0       

NMS Address : 1:2:3::4
 Get      GetNext      GetBulk      Set      Test
  0          2536        0           0         0       
NMS Address : 4:5:6::7
 Get      GetNext      GetBulk      Set      Test
  0          3817        0           0         0

show snmp statistics oid group

To show the statistics of object ID (OID), use the show snmp statistics oid group command in XR EXEC mode.

show snmp statistics oid group {interface | infra | route | entity}

Syntax Description

interface

mibd_interface sub-agent process

infra

mibd_infra sub-agent process

route

mibd_route sub-agent process

entity

mibd_entity sub-agent process

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The latest 500 entries for each group is displayed and a maximum of 2000 entries is displayed for four groups.

The show snmp statistics oid group command shows these details:

Field

Description

SerNum

Unique serial number for each request processing in sub-agents.

Type

Request type.

NumObj

Number of OIDs processing in this request.

MIBMGR-IN

Time stamp of request received from AIPC.

PDU-IN

Time stamp of request sent to MIB for processing. This will be offset in milli seconds from MIBMGR_IN time stamp.

FROM-MIB

Time stamp of response sent from MIB after processing. This will be offset in milli seconds from MIBMGR_IN time stamp.

PDU-OUT

Time stamp of response sent to SNMP through AIPC . This will be offset in milli seconds from MIBMGR_IN.

OID

OID info processing this request.

MIB-IN

Time stamp of the request sent to MIB for each OID.

MIB-OUT

Time stamp of response sent from MIB after processing. This will be offset in milli seconds from MIB-IN.

ExpNext

Request Exp-Next.

Task ID

Task ID

Operations

snmp

read, write

Examples


RP/0/RP0/CPU0:router# show snmp statistics oid group interface 
Thu Mar 13 07:10:30.310 UTC
SerNum: 2489   Type: GETNEXT     NumObj: 1
  MIBMGR-IN    PDU-IN[ms]         PDU-OUT[ms]         MIBMGR-OUT[ms]
  Mar 13 07:00:49.933                1030                1030   
    OID: 1.3.6.1.2.1.10.32.4.2.0      Exp-Next: Yes
      MIB-IN : Mar 13 07:00:49.933   MIB-OUT[ms] : 1030
SerNum: 10203    Type: GETNEXT     NumObj: 1
  MIBMGR-IN      PDU-IN[ms]         PDU-OUT[ms]           MIBMGR-OUT[ms]
  Mar 13 06:36:16.976    0             1031                 1031   
    OID: 1.3.6.1.2.1.10.32.4.2.0  Exp-Next: Yes
      MIB-IN : Mar 13 06:36:16.976   MIB-OUT[ms] : 1031

show snmp statistics pdu

To show if processing time of any protocol data unit (PDU) is more than threshold limit, use the show snmp statistics pdu nms command in XR EXEC mode.

show snmp statistics pdu nms [address]

Syntax Description

nms [address]

Address of Network Management Station from which request has arrived. The PDU statistics is filtered for each NMS.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The PDU processing time can exceed the threshold limit in these scenarios:
  • SNMPD not able to dispatch the request to MIB because of any failures in snmpd.

  • MIB response after threshold limit.

  • MIB does not respond to SNMPD.

Default threshold limit is 2 seconds. To change the default threshold value, use the command:
Snmp-server timeouts pdu stats <1-10>
The maximum number of entries per network management system (NMS) is 500 and the maximum number of NMS is 30.
This command shows these details:

Field

Description

NMS

Address of Network Management Station from which request has arrived.

Port

Port number of application that requested the SNMP query.

REQID

Request ID for each PDU.

Type

Type of PDU.

SerNum

The unique number generated for every request and sent to all MIBDs.

Timeout

If the request was timeout out set to TRUE, else set to FALSE.

InputQ-In

Time stamp of the PDU when queued into input Q.

InputQ-Out

Time stamp of the PDU when queued into input Q, This will be in milliseconds, Offset from INPUT-IN time stamp.

ProcQ-In

Time stamp of the PDU when queued into Processing Q. This will be in milliseconds, Offset from INPUT-IN time stamp.

Response

Time stamp in milli seconds of the PDU when response is received from sub agents. Offset from INPUT-IN time stamp.

Task ID

Task ID

Operations

snmp

read, write

Examples


RP/0/RP0/CPU0:router# show snmp statistics pdu nms 
 Thu Mar 13 08:03:17.322 UTC
NMS: 64.103.222.6   PORT: 35028
  REQID:962974264  TYPE: 161  SerNum: 9428 TIMEOUT: No
  INPUTQ-IN                     INPUTQ-OUT[ms]       PROCQ-IN[ms]        RESPONSE[ms]
 Mar 13 08:03:15.269             0                   0                   1056  

show snmp statistics poll oid all

To show all object IDs (OIDs) polled from all network management system (NMS) and how many times it has polled, use the show snmp statistics poll oid all command in XR EXEC mode.

For this command to work, the following configuration has to be committed:

(config)#snmp-server oid-poll-stats

show snmp statistics poll oid all

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The maximum number of entries equals the number of OIDs that were polled. The maximum number of NMS details for each OID is 15.

The show snmp statistics poll oid all command shows these details:

Field

Description

Object ID

OID requested from NMS.

NMS

List of NMS IP address requested for each OID.

Count

Number of times OID is polled for each NMS.

Task ID

Task ID

Operations

snmp

read, write

Examples


RP/0/RP0/CPU0:router# show snmp statistics poll oid all 
 Object ID   :   1.3.6.1.2.1.1.3
 NMS                  COUNT                     
 10.2.1.3               10                     
 10.3.1.2               30                     
 10.4.1.3               20                     
 10.12.1.3              5                          

Object ID    :    1.3.6.1.2.1.1.4 
NMS                    COUNT        
10.2.1.3                10                     
10.3.1.2                5                       
10.4.1.3                20                     
10.12.1.3               30                         

Object ID   :  1.3.6.1.2.1.1.5
NMS                  COUNT  
10.2.1.3                10                     
10.3.1.2                3                       
10.4.1.3                2

Show snmp statistics poll oid nms

To show which object ID (OID) is polled from which network management system (NMS) and how many times it has polled, use the show snmp statistics poll oid nms command in XR EXEC mode.

show snmp statistics poll oid nms <V4 / V6 address>

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The show snmp statistics poll oid nms command shows these details:

Field

Description

Object ID

OID requested from NMS.

NMS

List of NMS IP address requested for each OID.

Count

Number of times OID is polled for each NMS.

Task ID

Task ID

Operations

snmp

read, write

Examples


RP/0/RP0/CPU0:router# show snmp statistics poll nms 1.2.3.4 
 NMS Address   : 1.2.3.4
Object ID                   Count
1.3.6.1.2.1.2.2.1.2         14  

show snmp statistics slow oid

To show the object ID (OID) that has exceeded beyond the threshold time for processing and the number of times that the threshold limit is exceeded with the latest timestamp, use the show snmp statistics slow oid command in XR EXEC mode.

show snmp statistics slow oid

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Default threshold limit for this data as 500 milli seconds. To change the default value, use the command:
Snmp-server logging threshold oid-processing < <0-20000>
The latest 500 entries for each sub agent is displayed and a total of upto 2000 entries is maintained.

The show snmp statistics slow oid command shows these details:

Field

Description

Type

Request type for slow OID.

Exact OID

Requested OID from NMS.

Resp OID

Response OID for the Request type and EXACT OID.

Slow Count

Number of times OID is slow.

Slow Time

Time taken for processing the OID in milli seconds.

Time Stamp

Time stamp of the slow OID when MIB responded to MIBD.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows a slow OIDs that exceeds the specified threshold time.


RP/0/RP0/CPU0:router# show snmp statistics slow oid 
 Group:agent

  TYPE                : GETNEXT
  REQ_OID          : 1.3.6.1.2.1.1.1.0
  RESP_OID        : 1.3.6.1.2.1.1.1.2
  COUNT             : 2
  TIME[ms]          : 0
  TIME_STAMP    : Mar 13 05:36:52.279

Group:infra

Group:route

  TYPE              : GETNEXT
  REQ_OID        : 1.3.6.1.2.1.4.34.1.3.4.20.254.128.0.0.0.0.0.0.0.254.8.255.254.203.38.197.0.0.0.2
  RESP_OID      : 1.3.6.1.2.1.4.34.1.3.4.20.254.128.0.0.0.0.0.0.0.254.8.255.254.203.38.197.0.0.0.2
  COUNT           : 4
  TIME[ms]        : 14
  TIME_STAMP  : Mar 13 05:36:52.279
  TYPE              : GET
  REQ_OID        : 1.3.6.1.2.1.4.34.1.3.4.20.254.128.0.0.0.0.0.0.0.254.8.255.254.203.38.197.0.0.0.2
  RESP_OID      : 1.3.6.1.2.1.4.34.1.3.4.20.254.128.0.0.0.0.0.0.0.254.8.255.254.203.38.197.0.0.0.2
  COUNT           : 4
  TIME[ms]        : 14
  TIME_STAMP  : Mar 13 05:36:52.279

Group:entity

Group:interface

  TYPE               : GETNEXT
  REQ_OID         : 1.3.6.1.2.1.2.1
  RESP_OID       : 1.3.6.1.2.1.2.1.0
  COUNT            : 1
  TIME[ms]         : 0
  TIME_STAMP   : Mar 13 05:36:52.279

show snmp statistics slow oid [after/before] hh:mm:ss day mday year

To show the object ID (OID) that has exceeded beyond the threshold time for processing and the number of times that the threshold limit is exceeded with the latest timestamp, use the show snmp statistics slow oid [after/before] hh:mm:ss day mday year command in XR EXEC mode.

show snmp statistics slow oid [after/before] hh:mm:ss day mday year

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Default threshold limit for this data as 500 milli seconds. To change the default value, use the command:
Snmp-server logging threshold oid-processing < <0-20000>
The latest 500 entries for each sub agent is displayed and a total of upto 2000 entries is maintained.

The show snmp statistics slow oid [after/before] hh:mm:ss day mday year command shows these details:

Field

Description

Type

Request type for slow OID.

Exact OID

Requested OID from NMS.

Resp OID

Response OID for the Request type and EXACT OID.

Slow Count

Number of times OID is slow.

Slow Time

Time taken for processing the OID in milli seconds.

Time Stamp

Time stamp of the slow OID when MIB responded to MIBD.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows a slow OIDs that exceeds the specified threshold time.


RP/0/RP0/CPU0:router# show snmp statistics slow oid 
Group:agent

  TYPE                : GETNEXT
  REQ_OID          : 1.3.6.1.2.1.1.1.0
  RESP_OID        : 1.3.6.1.2.1.1.1.2
  COUNT             : 2
  TIME[ms]          : 0
  TIME_STAMP    : Mar 13 05:36:52.279

Group:infra
Group:route
  TYPE              : GETNEXT
  REQ_OID        : 1.3.6.1.2.1.4.34.1.3.4.20.254.128.0.0.0.0.0.0.0.254.8.255.254.203.38.197.0.0.0.2
  RESP_OID      : 1.3.6.1.2.1.4.34.1.3.4.20.254.128.0.0.0.0.0.0.0.254.8.255.254.203.38.197.0.0.0.2
  COUNT           : 4
  TIME[ms]        : 14
  TIME_STAMP  : Mar 13 05:36:52.279

  TYPE              : GET
  REQ_OID        : 1.3.6.1.2.1.4.34.1.3.4.20.254.128.0.0.0.0.0.0.0.254.8.255.254.203.38.197.0.0.0.2
  RESP_OID      : 1.3.6.1.2.1.4.34.1.3.4.20.254.128.0.0.0.0.0.0.0.254.8.255.254.203.38.197.0.0.0.2
  COUNT           : 4
  TIME[ms]        : 14
  TIME_STAMP  : Mar 13 05:36:52.279

Group:entity
Group:interface
  TYPE               : GETNEXT
  REQ_OID         : 1.3.6.1.2.1.2.1
  RESP_OID       : 1.3.6.1.2.1.2.1.0
  COUNT            : 1
  TIME[ms]         : 0
  TIME_STAMP   : Mar 13 05:36:52.279

show snmp traps details

To show the details about the traps generated for each host, the sent and drop count and the timestamp, use the show snmp traps details command in XR EXEC mode.

show snmp traps details

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The show snmp traps details command shows these details:

Field

Description

TrapOID

Generated trap.

Sent

Number of times the trap sent from the host and port configured.

Drop

Number of times the trap dropped from the host and port configured.

Last-sent

Time stamp when the last trap was sent from the host and port.

Last-drop

Time stamp when the last trap dropped from the host and port.

Host

Configured address of the host to receive traps

udp-port

Configured port to receive traps

Task ID

Task ID

Operations

snmp

read, write

Examples


RP/0/RP0/CPU0:router# show snmp traps details 
Mon Apr  7 17:14:07.241 UTC
HOST:9.22.24.150, udp-port:3333
------------------------------
TrapOID                             Sent    Drop     Last-sent                       Last-drop
ciscoConfigManMIB.2.0.1             2         0      Mon Apr 07 14 17:12:29          ~
ciscoFlashDeviceInsertedNotif       1         0      Mon Apr 07 14 17:12:28          ~
ciscoFlashDeviceRemovedNotif        1         0      Mon Apr 07 14 17:12:28          ~

show snmp users

To display information about the configured characteristics of Simple Network Management Protocol (SNMP) users, use the show snmp users command in

EXEC

mode.

show snmp users

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

An SNMP user must be part of an SNMP group, as configured using the snmp-server user command.

Use the show snmp users command to display information about all configured users.

When configuring SNMP, you may see the logging message “Configuring snmpv3 USM user.” USM stands for the User-Based Security Model (USM) for SNMP Version 3 (SNMPv3). For further information about USM, see RFC 3414, User-based Security Model (USM) for version 3 of the Simple Network Management Protocol (SNMPv3).

Task ID

Task ID

Operations

snmp

read

Examples

This example shows sample output from the show snmp users command:


RP/0/RP0/CPU0:router# show snmp users 
  
  User name:user1
  Engine ID:localSnmpID
  storage-type:nonvolatile active
    
Table 6. show snmp users Field Descriptions

Field

Definition

User name

String identifying the name of the SNMP user.

Engine ID

String identifying the name of the copy of SNMP on the device.

storage-type

Settings that are set in volatile or temporary memory on the device, or in nonvolatile or persistent memory where settings remain after the device is turned off and on again.

show snmp view

To display the configured views and the associated MIB view family name, storage type, and status, use the show snmp view command in

EXEC

mode.

show snmp view

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID

Operations

snmp

read

Examples

This example shows sample output from the show snmp view command:


RP/0/RP0/CPU0:router# show snmp view
  
  view1 1.3 - included nonVolatile active
  v1default 1.3.6.1 - included nonVolatile active
  

snmp-server trap authentication vrf disable

To disable authentication traps on VPNs, use the snmp-server trap authentication vrf disable command in

global configuration

mode.

snmp-server trap authentication vrf disable

Syntax Description

This command has no keywords or arguments.

Command Default

Authentication traps are enabled on VPNs by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
snmp

read, write

Examples

This example illustrates how to disable authentication traps on VPNs:


RP/0/RP0/CPU0:router(config)# snmp-server trap authentication vrf disable 
  

snmp-server chassis-id

To provide a message line identifying the Simple Network Management Protocol (SNMP) server serial number, use the snmp-server chassis-id command in

global configuration

mode. To restore the default value, if any, use the no form of this command.

snmp-server chassis-id serial-number

no snmp-server chassis-id

Syntax Description

serial-number

Unique identification string to identify the chassis serial number.

Command Default

On hardware platforms, where the serial number can be read by the device, the default is the serial number. For example, some Cisco devices have default chassis ID values of their serial numbers.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the snmp-server chassis-id command to provide a message line identifying the SNMP server serial number.

The chassis ID message can be displayed with the show snmp command.

Task ID

Task ID

Operations

snmp

read, write

Examples

The following example shows how to specify the chassis serial number 1234456:


RP/0/RP0/CPU0:router# snmp-server chassis-id 1234456              
         

snmp-server community

To configure the community access string to permit access to the Simple Network Management Protocol (SNMP), use the snmp-server community command in

global configuration

mode. To remove the specified community string, use the no form of this command.

snmp-server community [clear | encrypted] community-string [view view-name] [RO | RW] [SDROwner | SystemOwner] [access-list-name]

no snmp-server community community-string

Syntax Description

clear

(Optional) Specifies that the entered community-string is clear text and should be encrypted when displayed by the show running command.

encrypted

(Optional) Specifies that the entered community-string is encrypted text and should be displayed as such by the show running command.

community-string

Community string that acts like a password and permits access to the SNMP protocol. The maximum length of the community-string argument is 32 alphabetic characters.

If the clear keyword was used, community-string is assumed to be clear text. If the encrypted keyword was used, community-string is assumed to be encrypted. If neither was used, community-string is assumed to be clear text.

view view-name

(Optional) Specifies the name of a previously defined view. The view defines the objects available to the community.

RO

(Optional) Specifies read-only access. Authorized management stations are able only to retrieve MIB objects.

RW

(Optional) Specifies read-write access. Authorized management stations are able both to retrieve and to modify MIB objects.

SDROwner

(Optional) Limits access to the owner service domain router (SDR).

SystemOwner

(Optional) Provides system-wide access.

access-list-name

(Optional) Name of an access list of IP addresses allowed to use the community string to gain access to the SNMP agent.

Command Default

By default, an SNMP community string permits read-only access to all MIB objects.

By default, a community string is assigned to the SDR owner.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the snmp-server community command to configure the community access string to permit access to SNMP.

To remove the specified community string, use the no form of this command.

Use the clear keyword to specify that the clear text community string you enter is displayed encrypted in the show running command output. To enter an encrypted string, use the encrypted keyword. To enter a clear text community string that is not encrypted by the system, use neither of these keywords.

When the snmp-server community command is entered with the SDROwner keyword, SNMP access is granted only to the MIB object instances in the owner SDR.

When the snmp-server community command is entered with the SystemOwner keyword, SNMP access is granted to the entire system.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to assign the string comaccess to SNMP, allowing read-only access, and to specify that IP access list 4 can use the community string:


RP/0/RP0/CPU0:router(config)# snmp-server community comaccess ro 4 
                    

The following example shows how to assign the string mgr to SNMP, allowing read-write access to the objects in the restricted view:


RP/0/RP0/CPU0:router(config)# snmp-server community mgr view restricted rw              
                        

This example shows how to remove the community comaccess:


RP/0/RP0/CPU0:router(config)#no snmp-server community comaccess              
                     

snmp-server community-map

To associate a Simple Network Management Protocol (SNMP) community with an SNMP context, security name, or a target-list use the snmp-server community-map command in

global configuration

mode. To change an SNMP community mapping to its default mapping, use the no form of this command.

snmp-server community-map [clear | encrypted] community-string [context context-name] [security-name security-name] [target-list target]

no snmp-server community-map [clear | encrypted] community-string

Syntax Description

clear

(Optional) Specifies that the community-string argument is clear text.

encrypted

(Optional) Specifies that the community-string argument is encrypted text.

community-string

Name of the community.

context context-name

(Optional) Name of the SNMP context to which this community name is to be mapped.

security-name security-name

(Optional) Security name for this community. By default, the string is the security name.

target-list target

(Optional) Name of the target list for this community.

Command Default

The value of the community-string argument is also the security name.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the snmp-server community-map command to map an SNMPv1 or SNMPv2c community name to one or more of the following:

  • context name—Maps a community name to a specific SNMP context name. This allows MIB instances in an SNMP context to be accessed through SNMPv1 or SNMPv2c using this community name.
  • security name—By default, the community name is used to authenticate SNMPv1 and SNMPv2c. Configure a security name for a community name to override the default and authenticate SNMP with the security name.
  • target—Target list identifies a list of valid hosts from which SNMP access can be made using a specific security name. When such mapping is done for a particular community name, SNMP access is allowed only from hosts included in the target list.

Use the clear keyword to specify that the clear text community string you enter is displayed encrypted in the show running command output. To enter an encrypted string, use the encrypted keyword. To enter a clear text community string that is not encrypted by the system, use neither of these keywords.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example maps the community name “sample 2” to the SNMP context name “sample1”:


RP/0/RP0/CPU0:router(config)# snmp-server community-map sample2 context sample1
                     

snmp-server contact

To set the Simple Network Management Protocol (SNMP) system contact, use the snmp-server contact command in

global configuration

mode. To remove the system contact information, use the no form of this command.

snmp-server contact system-contact-string

no snmp-server contact

Syntax Description

system-contact-string

String that describes the system contact information. The maximum string length is 255 alphanumeric characters.

Command Default

No system contact is set.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the snmp-server contact command to set the system contact string. Use the no form of this command to remove the system contact information.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to specify a system contact string:


RP/0/RP0/CPU0:router(config)# snmp-server contact Dial System Operator at beeper # 27345              
                     

snmp-server context

To create a Simple Network Management Protocol (SNMP) context, use the snmp-server context command in

global configuration

mode. To remove an SNMP context, use the no form of this command.

snmp-server context context-name

no snmp-server context context-name

Syntax Description

context-name

Name of the SNMP context.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

This command creates an SNMP context. By default, all the SNMP MIB instances are in a default context. Create an SNMP context and map it to a particular feature to enable similar instances of the same object to co-exist in different SNMP contexts.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example creates a new SNMP context named “sample1:”


RP/0/RP0/CPU0:router(config)# snmp-server context sample1
            
         

snmp-server context mapping

To map an SNMP context with a protocol instance, topology or VRF entity, use the snmp-server context mapping command in global configuration mode.

snmp-server context mapping context-name [feature feature-name] [instance instance-name] [topology topology-name] [vrf vrf-name]

Syntax Description

context-name

Name of the SNMP context.

feature feature-name

Specifies the protocol for which to map the context. Available options are:

  • bridge —Layer 2 VPN bridge

  • vrf—Virtual Routing and Forwarding

instance instance-name

Maps the context to the specified protocol instance.

topology topology-name

Maps the context to the specified protocol topology.

vrf vrf-name

Maps the context to the specified VRF logical entity.

Command Default

No context mappings exist by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

A device can support multiple instances of a logical network entity, such as protocol instances or VRFs. Most existing MIBs cannot distinguish between these multiple logical network entities. For example, the original OSPF-MIB assumes a single protocol instance on a device, but you can now configure multiple OSPF instances on a device.

The snmp-server context mapping command maps a context to a protocol instance, topology or VRF logical entity.


Note


The snmp-server context mapping command does not work for OSPF and OSPFv3. Refer to the snmp context commands.


Task ID

Task ID Operation

snmp

read, write

Examples

This example illustrates how to map an snmp context to an OSPF instance:


RP/0/RP0/CPU0:router(config)# snmp-server context mapping con5 feature ospf instance in1

snmp-server drop report acl

To apply an ACL policy for restricting an SNMPv3 unknown engine-id report to be sent out to NMS, use the snmp-server drop report acl command in the configuration mode.

snmp-server drop report acl IPv4 IPv4-acl-name IPv6 IPv6-acl-name

Syntax Description

acl

Specifies IP Access Control Lists (ACL) policy

IPv4 IPv4-acl-name

Defines an IPv4 ACL name.

IPv6 IPv6-acl-name

Defines an IPv6 ACL name.

Command Default

Unknown engine-id reports will be sent to all polling stations (even if other ACLs are configured).

Command Modes

Configuration mode

Command History

Release

Modification

Release 6.2.3

This command was introduced.

Usage Guidelines

To drop an unknown engine-id report, you can either configure IPv4/IPv6 ACL name or both. When router is polled with wrong engine-id or no engine-id during a snmpv3 packet exchange, the unknown engine-id report will be sent based on the ACL policy that is configured.

Unknown engine-id reports will be sent only to polling station addresses that are permitted by ACL.

Task ID

Task ID Operation
snmp

read, write

Examples

This example shows how to configure the SNMP server to drop the unknown engin-id report:

RP/0/RP0/CPU0:router (config) #  snmp-server drop report acl IPv4 nms-block IPv6 nms-block-ipv6

snmp-server drop unknown-user

To avoid error PDUs being sent out of router when polled with incorrect SNMPv3 user name, use the snmp-server drop unknown-user command in the appropriate mode. If the configuration is not set, by default it will respond with error PDUs.

snmp-server drop unknown-user

Syntax Description

drop unknown-user

Drop the error PDUs to be sent when router is polled with incorrect SNMPv3 user name.

Command Default

Unknown error PDUs will be sent when router is polled with incorrect SNMPv3 user name.

Command Modes

XR config

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
snmp

read, write

Examples

This example shows how to configure the SNMP server to drop the error PDUs:

RP/0/RP0/CPU0:router (config) #  snmp-sever drop unknown-user

snmp-server engineid local

To specify Simple Network Management Protocol (SNMP) engine ID on the local device, use the snmp-server engineid local command in

global configuration

mode. To return the engine ID to the default, use the no form of this command.

snmp-server engineid local engine-id

no snmp-server engineid local engine-id

Syntax Description

engine-id

Character string that identifies the engine ID. Consists of up to 24 characters in hexadecimal format. Each hexadecimal number is separated by a colon (:).

Command Default

An SNMP engine ID is generated automatically.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to configure the SNMP engine ID on the local device:

RP/0/RP0/CPU0:router(config)# snmp-server engineID local 00:00:00:09:00:00:00:a1:61:6c:20:61
                     

snmp-server engineid remote

To specify a Simple Network Management Protocol (SNMP) engine ID on a remote device, use the snmp-server engineid remote command in

global configuration

mode. To return the engine ID to the default, use the no form of this command.

snmp-server engineid remote ip-address engine-id udp-port port

no snmp-server engineid remote ip-address engine-id udp-port port

Syntax Description

ip-address

IP address of remote SNMP notification host

engine-id

Character string that identifies the engine ID. Consists of up to 24 characters in hexadecimal format. Each hexadecimal number is separated by a colon (:).

udp-port port

(Optional) Specifies the User Datagram Protocol (UDP) port of the host to use. Range is from 1 to 65535. The default UDP port is 161.

Command Default

An SNMP engine ID is generated automatically.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation

snmp

read, write

Examples

This example shows how to configure the SNMP engine ID on the local device:

RP/0/RP0/CPU0:Router(config)# snmp-server engineID remote 172.16.4.1 00:00:00:09:00:00:00:a1:61:6c:20:61
                    

snmp-server entityindex persist

To enable the persistent storage of ENTITY-MIB data across process restarts, switchovers, and device reloads, use the snmp-server entityindex persist command in

global configuration

mode. To disable the persistent storage of ENTITY-MIB data, use the no form of this command.

snmp-server entityindex persist

no snmp-server entityindex persist

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
snmp

read, write

Examples

This example illustrates how to enable persistent storage of ENTITY-MIB indices:


RP/0/RP0/CPU0:router(config)# snmp-server entityindex persist
  

snmp-server group

To configure a new Simple Network Management Protocol (SNMP) group, or a table that maps SNMP users to SNMP views, use the snmp-server group command in

global configuration

XR Config

mode. To remove a specified SNMP group, use the no form of this command.

snmp-server group name {v1 | v2c | v3 {auth | noauth | priv}} [read view] [write view] [notify view] [context context-name] [access-list-name]

no snmp-server group name

Syntax Description

name

Name of the group.

v1

Specifies a group that uses the SNMPv1 security model. The SNMP v1 security model is the least secure of the possible security models.

v2c

Specifies a group that uses the SNMPv2c security model. The SNMPv2c security model is the second least secure of the possible security models.

v3

Specifies a group that uses the SNMPv3 security model. The SNMP v3 security is the most secure of the possible security models.

auth

Specifies authentication of a packet without encrypting it.

noauth

Specifies no authentication of a packet.

priv

Specifies authentication of a packet with encryption.

read view

(Optional) Specifies a read view string (not to exceed 64 characters) that is the name of the view that allows only the contents of the agent to be viewed.

write view

(Optional) Specifies a write view string (not to exceed 64 characters) that is the name of the view used to enter data and configure the contents of the agent.

notify view

(Optional) Specifies a notify view string (not to exceed 64 characters) that is the name of the view used to specify a notify or trap.

context context-name

(Optional) Specifies the SNMP context to associate with this SNMP group and associated views.

access-list-name

(Optional) Access list string (not to exceed 64 characters) that is the name of the access list.

Command Default

See snmp-server group.

Command Modes

Global configuration

XR Config

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

This table describes the default values for the different views:

Table 7. snmp-server group Default Descriptions

Default

Definition

read view

Assumed to be every object belonging to the Internet (1.3.6.1) object identifier (OID) space, unless the user uses the read option to override this state.

write view

Nothing is defined for the write view (that is, the null OID). You must configure write access.

notify view

Nothing is defined for the notify view (that is, the null OID). If a view is specified, any notifications in that view that are generated are sent to all users associated with the group (provided an SNMP server host configuration exists for the user).

Configuring Notify Views

Do not specify a notify view when configuring an SNMP group for the following reasons:

  • The snmp-server host command autogenerates a notify view for the user, and then adds it to the group associated with that user.

  • Modifying the notify view of the group affects all users associated with that group.

The notify view option is available for two reasons:

  • If a group has a notify view that is set using SNMP, you may need to change the notify view.
  • The snmp-server host command may have been configured before the snmp-server group command. In this case, reconfigure the snmp-server host command or specify the appropriate notify view.

Instead of specifying the notify view for a group as part of the snmp-server group command, use the following commands in global configuration mode:

  • snmp-server user —Configures an SNMP user.

  • snmp-server group —Configures an SNMP group, without adding a notify view.

  • snmp-server host —Autogenerates the notify view by specifying the recipient of a trap operation.

Working with Passwords and Digests

No default values exist for authentication or privacy algorithms when this command is configured. In addition, no default passwords exist. The minimum length for a password is one character, although we recommend using eight characters for security. A plain-text password or localized Message Digest 5 (MD5) password can be specified. Forgotten passwords cannot be recovered, and the user must be reconfigured.

SNMP Contexts

SNMP contexts provide Virtual Private Network (VPN) users with a secure way of accessing MIB data. When a VPN is associated with a context, that VPN’s specific MIB data exists in that context. Associating a VPN with a context enables service providers to manage networks with multiple VPNs. Creating and associating a context with a VPN enables a provider to prevent the users of one VPN from accessing information about users of other VPNs on the same networking device.

Task ID

Task ID

Operations

snmp

read, write

Examples

The following example shows how to configure an SNMP version 3 group named group1 that requires the authentication of packets with encryption:


Router(config)# snmp-server group group1 v3 priv
                     

snmp-server host

To specify the recipient of a Simple Network Management Protocol (SNMP) notification operation, use the snmp-server host command in

Global configuration

To remove the specified host, use the no form of this command.

snmp-server host address [clear | encrypted] [informs] [traps] [version {1 | 2c | 3 {auth | noauth | priv}}] community-string [udp-port port] [notification-type]

no snmp-server host address [clear | encrypted] [informs] [traps] [version {1 | 2c | 3 {auth | noauth | priv}}] community-string [udp-port port] [notification-type]

Syntax Description

address

Name or IP address of the host (the targeted recipient).

clear

(Optional) Specifies that the community-string argument is clear text.

encrypted

(Optional) Specifies that the community-string argument is encrypted text.

informs

(Optional) Specifies to send inform messages to this host.

traps

(Optional) Specifies that notifications should be sent as traps. This is the default.

version

(Optional) Specifies the version of the SNMP used to send the traps.

1

Specifies SNMPv1, the default.

2c

Specifies SNMPv2C.

3

Specifies SNMPv3. Version 3 is the most secure model because it allows packet encryption. If you specify the SNMPv3 keyword, you must specify the security level.

auth

Enables Message Digest 5 (MD5) algorithm and Secure Hash Algorithm (SHA) packet authentication.

noauth

Specifies that the noAuthNoPriv security level applies to this host. This is the default security level for SNMPv3.

priv

Enables Data Encryption Standard (DES) packet encryption (also called “privacy”).

community-string

Password-like community string sent with the notification operation. We recommend defining this string using the snmp-server community command prior to using the snmp-server host command.

udp-port port

(Optional) Specifies the User Datagram Protocol (UDP) port of the host to use. Range is from 1 to 65535. The default UDP port is 161.

notification-type

(Optional) Type of notification to be sent to the host. If no type is specified, all available notifications are sent. The notification type can be one or more of these keywords:

  • bgp —Enables SNMP Border Gateway Protocol Version 4 (BGPv4) traps.

  • config —Controls configuration notifications, as defined in the CISCO-CONFIG-MAN-MIB (enterprise 1.3.6.1.4.1.9.9.43.2). The notification type is (1) ciscoConfigManEvent.

  • copy-complete —Enables CISCO-CONFIG-COPY-MIB ccCopyCompletion traps.

  • entity —Controls Entity MIB modification notifications. This notification type is defined in the ENTITY-MIB (enterprise 1.3.6.1.2.1.47.2) as: (1) entConfigChange.

  • fabric —Enables SNMP fabric traps.

  • fru-ctrl —Enables SNMP entity field-replaceable unit (FRU) control traps.

  • mpls —Enables SNMP Multiprotocol Label Switching (MPLS) traps.

  • sensor —Enables SNMP entity sensor traps.

  • snmp —Enables SNMP traps.

  • syslog —Controls error message notifications (Cisco-syslog-MIB). Specify the level of messages to be sent with the logging history command.

Command Default

This command is disabled by default. No notifications are sent.

The default UDP port is 161.

When this command is entered without keywords, the default is to send all trap types to the host.

If no version keyword is entered, the default is version 1.

If version 3 is specified, but the security level is not specified, the default security level is noauth.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

SNMP notifications can be sent as traps. Traps are unreliable because the receiver does not send acknowledgments when it receives traps. The sender cannot determine if the traps were received. Traps are discarded as soon as they are sent. Traps are also sent only once.

When the snmp-server host command is not entered, no notifications are sent. To configure the device to send SNMP notifications, configure at least one snmp-server host command. When the command is entered without keywords, all trap types are enabled for the host.

To enable multiple hosts, issue a separate snmp-server host command for each host. You can specify multiple notification types in the command for each host.

When multiple snmp-server host commands are given for the same host and kind of notification (trap), each succeeding snmp-server host command overwrites the previous command. Only the last snmp-server host command is in effect. For example, if an snmp-server host command with the traps keyword is entered for a host and then another command with the traps keyword is entered for the same host, the second command replaces the first.

Either a host name or IP address can be used to specify the host. Both IPv4 and IPv6 IP address formats are supported.

The snmp-server host command is used with the snmp-server engineid command. Use the snmp-server traps command to specify which SNMP notifications are sent globally. For a host to receive most notifications, at least one snmp-server traps command and the snmp-server host command for that host must be enabled.

However, some notification types cannot be controlled with the snmp-server traps command. For example, some notification types are always enabled. Other notification types are enabled by a different command.

The availability of a notification-type depends on the device type and Cisco software features supported on the device.

To display which notification types are available on the system, use the question mark (? ) online help function at the end of the snmp-server host command.

The no snmp-server host command used with no keywords disables traps.

Use the clear keyword to specify that the clear text community string you enter is displayed encrypted in the show running command output. To enter an encrypted string, use the encrypted keyword. To enter a clear text community string that is not encrypted by the system, use neither of these keywords.

If the informs keyword is used, the SNMP version can be only SNMPv2C or SNMPv3.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to send RFC 1157 SNMP traps to the host specified by the name myhost.cisco.com. Other traps are enabled, but only SNMP traps are sent because only the snmp keyword is specified in the snmp-server host command. The community string is defined as comaccess.


Router(config)# snmp-server traps
Router(config)# snmp-server host myhost.cisco.com comaccess snmp 
                     

This example shows how to send the SNMP traps to address 172.30.2.160:


Router(config)# snmp-server traps snmp 
Router(config)# snmp-server host 172.30.2.160 public snmp
                    

This example shows how to enable the router to send all traps to the host, myhost.cisco.com, using the community string public:


Router(config)# snmp-server traps 
Router(config)# snmp-server host myhost.cisco.com public 
                     

This example shows how to prevent traps from being sent to any host. The BGP traps are enabled for all hosts, but only the configuration traps are enabled to be sent to a host.


Router(config)# snmp-server traps bgp
Router(config)# snmp-server host hostabc public config
                     

This example shows how to send SNMPv3 informs to a host:


Router(config)# snmp-server host 172.30.2.160 informs version 3
  

snmp-server ifindex persist

To enable ifIndex persistence globally on all Simple Network Management Protocol (SNMP) interfaces, use the snmp-server ifindex persist command in global configuration mode. To disable global interface persistence, use the no form of this command.

snmp-server ifindex persist

no snmp-server ifindex persist

Syntax Description

This command has no keywords or arguments.

Command Default

Global interface persistence is disabled.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the snmp-server ifindex persist command to enable ifIndex persistence on all interfaces that have entries in the ifIndex table of the IF-MIB. When enabled, this command retains the mapping between the ifName object values and the ifIndex object values (generated from the IF-MIB) persistent during reloads, allowing for consistent identification of specific interfaces using SNMP. Applications such as device inventory, billing, and fault detection depend on this feature.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to enable ifIndex persistence globally:


RP/0/RP0/CPU0:router(config)# snmp-server ifindex persist
                     

snmp-server ifmib internal cache max-duration

To configure the refresh interval for the IF-MIB statistics cache, use the snmp-server ifmib internal cache max-duration command in global configuration mode. To revert to the default cache interval, use the no form of this command.

snmp-server ifmib internal cache max-duration timeout

Syntax Description

timeout

Length of time before the cache is refreshed. Values can range from 0 to 60 seconds. The default is 15.

Command Default

timeout : 15 seconds

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The snmp-server ifmib internal cache max-duration command controls the refresh interval of the cache. If the timeout value in the snmp-server ifmib internal cache max-duration command is set to zero, the cache is disabled. By default, the counters are cached for 15 secs in the ifmib internal cache, after which it will be discarded.

Task ID

Task ID Operation

snmp

read, write

Examples

This example shows how to change the refresh interval for the IF-MIB statistics cache.


RP/0/RP0/CPU0:routerrouter(config)# snmp-server ifmib internal cache max-duration 60

snmp-server ifmib stats cache

To enable retrieval of cached statistics instead of real-time statistics, use the snmp-server ifmib stats cache command. To revert to the default, use the no form of this command.

snmp-server ifmib stats cache

no snmp-server ifmib stats cache

Syntax Description

This command has no keywords or arguments.

Command Default

Cached statistics are not enabled.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Cisco IOS XR statistics infrastructure maintains a cache of statistics for all interfaces. This cache is updated every 30 seconds. Use the snmp-server ifmib stats cache command to enable the IF-MIB to retrieve these cached statistics rather than real-time statistics. Accessing cached statistics is less CPU-intensive than accessing real-time statistics.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to enable the IF-MIB caches statistics:


RP/0/RP0/CPU0:router(config)# snmp-server ifmib stats cache 
RP/0/RP0/CPU0:router(config)# exit

Uncommitted changes found, commit them before exiting(yes/no/cancel)? [cancel]:yes
RP/0/RP0/CPU0:router#
  

snmp-server inform

To configure Simple Network Management Protocol (SNMP) inform message options, use the snmp-server inform command in global configuration mode. To revert to the default informs options, use the no form of this command.

snmp-server inform {pending max-no | retries no-retries | timeout seconds}

no snmp-server inform {pending max-no | retries no-retries | timeout seconds}

Syntax Description

pending max-no

Specifies the maximum number of inform messages to hold in the queue. The default is 25.

retries no-retries

Specifies the retry count for inform messages. Values can be from 1 to 100. The default is three.

timeout seconds

Specifies the inform message timeout value in seconds. The default is 15.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

To enable the sending of SNMP inform messages, use the snmp-server host command with the informs keyword. When SNMP server informs are enabled, the SNMP version can be only SNMPv2C or SNMPv3.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to configure SNMP inform messages:


RP/0/RP0/CPU0:router(config)# snmp-server host myhost.cisco.com informs comaccess
RP/0/RP0/CPU0:router(config)# snmp-server inform pending 40 
RP/0/RP0/CPU0:router(config)# snmp-server inform retries 10 
                     

snmp-server interface

To enable an interface to send Simple Network Management Protocol (SNMP) trap notifications and enter SNMP interface configuration mode, use the snmp-server interface command in global configuration mode. To disable the sending of SNMP trap notifications on an interface, use the no form of this command.

snmp-server interface type interface-path-id

no snmp-server interface type interface-path-id

Syntax Description

type

Interface type. For more information, use the question mark (? ) online help function.

interface-path-id

Physical interface or virtual interface.

Note

 

Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (? ) online help function.

Command Default

Ethernet interfaces are enabled to send SNMP trap notifications. SNMP trap notifications are disabled on all other physical and logical interfaces.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The snmp-server interface command enters SNMP interface configuration mode for you to configure the available SNMP options.


Note


In references to a Management Ethernet interface located on a route processor card, the physical slot number is and the module is CPU0. Example: interface .


Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to assign ifIndex persistence on Packet-over-SONET/SDH (POS) interface 0/0/1/0:


RP/0/RP0/CPU0:router(config)# snmp-server interface pos 0/0/1/0
RP/0/RP0/CPU0:router(config-snmp-if)#
    

snmp-server interface subset

To enter snmp-server interface subset configuration mode for a set of interfaces, use the snmp-server interface subset command in global configuration mode. To revert to the default interface settings, use the no form of this command.

snmp-server interface subset subset-number regular-expression expression

no snmp-server interface subset subset-number

Syntax Description

subset-number

Identifying number of the interface subset, which also indicates its relative priority.

regular-expression expression

Specifies for which subset of interfaces to enter snmp-server interface subset configuration mode. The expression argument must be entered surrounded by double quotes.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The subset-number argument is used to set the priority for an interface that matches more than one configured regular expressions. Lower values of the subset-number have a higher priority. If a single interface becomes part of a multiple-interface configured regular expression, the configuration with the lower subset-number value is applied.

Regular expressions have two constraints:

  • Regular expressions must always be entered within double quotes to ensure that the CLI interprets each character correctly.

  • All characters that are part of a regular expression are considered regular characters with no special meaning. In order to enter special characters, such as "\" or "?," they must be preceded by the backslash character "\." For example, to enter the regular expression ([A-Z][A-Z0-9]*)\b[^>]*>(.*?)</\1, you would enter ([A-Z][A-Z0-9]*)\\b[^>]*>(.*\?)</\\1.

Refer to the Understanding Regular Expressions, Special Characters, and Patterns module in for more information regarding regular expressions.

From the snmp-server interface mode of a subset of interfaces, SNMP linkUp and linkDown notifications can be enabled or disabled using the notification linkupdown disable command.

Task ID

Task ID Operation
snmp

read, write

Examples

This example illustrates how to configure all Gigabit Ethernet interfaces:


RP/0/RP0/CPU0:router# config
RP/0/RP0/CPU0:router(config)# snmp-server int subset 2 
    regular-expression "^Gig[a-zA-Z]+[0-9/]+\."
RP/0/RP0/CPU0:router(config-snmp-if-subset)# 
  

snmp-server ipv4 dscp

To mark packets with a specific differentiated services code point (DSCP) value, use the snmp-server ipv4 dscp command in global configuration mode. To remove matching criteria, use the no form of this command.

snmp-server ipv4 dscp value

no snmp-server ipv4 dscp [value]

Syntax Description

value

Value of the DSCP. The DSCP value can be a number from 0 to 63, or it can be one of the following keywords: default , ef , af11 , af12 , af13 , af21 , af22 , af23 , af31 , af32 , af33 , af41 , af42 , af43 , cs1 , cs2 , cs3 , cs4 , cs5 , cs6 , cs7 .

Command Default

The IP DSCP default value for SNMP traffic is 0.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the snmp-server ipv4 dscp command to specify an IP DSCP value to give SNMP traffic higher or lower priority in your network.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to configure the DSCP value to af32:


RP/0/RP0/CPU0:router(config)# snmp-server ipv4 dscp af32 
                     

snmp-server ipv4 precedence

To mark packets with a specific precedence level to use for packet matching, use the snmp-server ipv4 precedence command in global configuration mode. To restore the system to its default interval values, use the no form of this command.

snmp-server ipv4 precedence value

no snmp-server ipv4 precedence [value]

Syntax Description

value

Value of the precedence. The precedence value can be a number from 0 to 7, or it can be one of the following keywords:

critical

Set packets with critical precedence (5)

flash

Set packets with flash precedence (3)

flash-override

Set packets with flash override precedence (4)

immediate

Set packets with immediate precedence (2)

internet

Set packets with internetwork control precedence (6)

network

Set packets with network control precedence (7)

priority

Set packets with priority precedence (1)

routine

Set packets with routine precedence (0)

Command Default

The IP Precedence default value for SNMP traffic is 0.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the snmp-server ipv4 precedence command to specify an IP Precedence value to give SNMP traffic higher or lower priority in your network.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to set the precedence to 2:


RP/0/RP0/CPU0:router(config)# snmp-server ipv4 precedence 2 
                    

snmp-server location

To specify the system location for Simple Network Management Protocol (SNMP), use the snmp-server location command in

global configuration

mode. To remove the location string, use the no form of this command.

snmp-server location system-location

no snmp-server location

Syntax Description

system-location

String indicating the physical location of this device. The maximum string length is 255 alphanumeric characters.

Command Default

No system location string is set.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to specify a system location string:


RP/0/RP0/CPU0:router(config)# snmp-server location Building 3/Room 214 
            
         

snmp-server mibs cbqosmib persist

To enable persistent storage of the CISCO-CLASS-BASED-QOS-MIB data across process restarts, switchovers, and device reloads, use the snmp-server mibs cbqosmib persist command in global configuration mode. To disable persistent storage of the MIB data, use the no form of this command.

snmp-server mibs cbqosmib persist

no snmp-server mibs cbqosmib persist

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
snmp

read, write

Examples

This example illustrates how to enable persistent storage of CISCO-CLASS-BASED-QOS-MIB data:


RP/0/RP0/CPU0:router(config)# snmp-server mibs cbqosmib persist
  

snmp-server mibs cbqosmib cache

To enable and configure caching of the QoS MIB statistics, use the snmp-server mibs cbqosmib cache command in global configuration mode. To disable caching, use the no form of this command.

snmp-server mibs cbqosmib cache {refresh time time | service-policy count count}

no snmp-server mibs cbqosmib cache [refresh time time | service-policy count count]

Syntax Description

refresh

Enables QoS MIB caching with a specified cache refresh time.

time time

Specifies the cache refresh time, in seconds. The time argument can be between 5 and 60. The default is 30.

service-policy

Enables QoS MIB caching with a limited number of service policies to cache.

count count

Specifies the maximum number of service policies to cache. The count argument can be between 1 and 5000.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
snmp

read, write

Examples

This example illustrates how to enable QoS MIB caching with a refresh time:


RP/0/RP0/CPU0:router(config)# snmp-server mibs cbqosmib cache refresh time 45
  

This example illustrates how to enable QoS MIB caching with a service policy count limitation:


RP/0/RP0/CPU0:router(config)# snmp-server mibs cbqosmib cache service-policy count 10
  

snmp-server mibs eventmib congestion-control

To configure the generation of SNMP traps when congestion exceeds configured thresholds, use the snmp-server mibs eventmib congestion-control command in global configuration mode. To restore the default values, use the no form of this command.

snmp-server mibs eventmib congestion-control type interface-path-id falling lower-threshold interval sampling-interval rising upper-threshold

no snmp-server mibs eventmib congestion-control type interface-path-id

Syntax Description

type

Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Physical interface or virtual interface.

Note

 

Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

falling lower-threshold

Specifies the lower threshold for which to determine whether an mteTriggerFalling SNMP Trap is generated.

interval sampling-interval

Specifies how often the congestion statistics are polled. The interval argument, in minutes, can be between 5 and 1440; it must be a multiple of 5.

rising upper-threshold

Specifies the upper threshold for which to determine whether an mteTriggerRising SNMP Trap is generated.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines


Note


A maximum of 100 interfaces can be monitored for congestion.

Congestion configurations using the snmp-server mibs eventmib congestion-control command cannot be modified using SNMP SET and vice versa.


When the congestion between two intervals increases above the upper-threshold argument, an mteTriggerRising SNMP trap is generated. This trap is not generated until the congestion drops below the lower threshold and then rises above the upper threshold.

When the congestion between two intervals falls below the lower-threshold argument, and an SNMP mteTriggerRising trap was generated previously, an SNMP mteTriggerFalling trap is generated. The mteTriggreRising trap is not generated until the congestion goes above the upper threshold and then falls back below the lower threshold.

The lower-threshold value (falling) should be set to a value less than or equal to the upper-threshold value (rising).

The snmp-server mibs eventmib congestion-control command is configured on a specific interface and is supported on the following cards:

  • 8-port 10 Gigabit Ethernet PLIM

  • 16-port OC-48c/STM-16 POS/DPT PLIM

  • 1-port OC-768c/STM-256 POS PLIM

  • 4-port OC-192c/STM-64 POS/DPT PLIM

  • All Ethernet SPAs

  • 2-port and 4-port OC-3c/STM-1 POS SPAs

  • 2-port, 4-port, and 8-port OC-12c/STM-4 POS SPAs

  • 2-port and 4-port OC-48c/STM-16 POS/RPR SPAs

  • 1-port OC-192c/STM-64 POS/RPR SPA

Task ID

Task ID Operations
snmp read, write

Examples

This example shows how to configure the generation of SNMP traps in response to congestion:

RP/0/RP0/CPU0:router(config)# snmp-server mibs eventmib congestion-control pos 0/1/0/0 
    falling 1 interval 5 rising 2

snmp-server mibs eventmib packet-loss

To configure the generation of SNMP traps when packet loss exceeds configured thresholds, use the snmp-server mibs eventmib packet-loss command in global configuration mode. To restore the default values, use the no form of this command.

snmp-server mibs eventmib packet-loss type interface-path-id falling lower-threshold interval sampling-interval rising upper-threshold

no snmp-server mibs eventmib packet-loss type interface-path-id

Syntax Description

type

Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Physical interface or virtual interface.

Note

 

Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

falling lower-threshold

Specifies the lower threshold for which to determine whether an mteTriggerFalling SNMP Trap is generated.

interval sampling-interval

Specifies how often the packet loss statistics are polled. The interval argument, in minutes, can be between 5 and 1440; it must be a multiple of 5.

rising upper-threshold

Specifies the upper threshold for which to determine whether an mteTriggerRising SNMP Trap is generated.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines


Note


A maximum of 100 interfaces can be monitored for packet loss.

Packet loss configurations using the snmp-server mibs eventmib packet-loss command cannot be modified using SNMP SET and vice versa.


When the packet loss between two intervals increases above the upper-threshold argument, an mteTriggerRising SNMP trap is generated. This trap is not generated until the packet loss drops below the lower threshold and then rises above the upper threshold.

When the packet loss between two intervals falls below the lower-threshold argument, and an SNMP mteTriggerRising trap was generated previously, an SNMP mteTriggerFalling trap is generated. The mteTriggreRising trap is not generated until the packet loss goes above the upper threshold and then falls back below the lower threshold.

The lower-threshold value (falling) should be set to a value less than or equal to the upper-threshold value (rising).

The snmp-server mibs eventmib packet-loss command is configured on a specific interface and is supported on the following cards:

  • 8-port 10 Gigabit Ethernet PLIM

  • 16-port OC-48c/STM-16 POS/DPT PLIM

  • 1-port OC-768c/STM-256 POS PLIM

  • 4-port OC-192c/STM-64 POS/DPT PLIM

  • All Ethernet SPAs

  • 2-port and 4-port OC-3c/STM-1 POS SPAs

  • 2-port, 4-port, and 8-port OC-12c/STM-4 POS SPAs

  • 2-port and 4-port OC-48c/STM-16 POS/RPR SPAs

  • 1-port OC-192c/STM-64 POS/RPR SPA

Task ID

Task ID Operations
snmp read, write

Examples

This example shows how to configure the generation of SNMP traps in response to packet loss:

RP/0/RP0/CPU0:router(config)# snmp-server mibs eventmib packet-loss pos 0/1/0/0 
    falling 1 interval 5 rising 2

snmp-server mibs sensormib cache

To enable and configure caching for sensor mib values, use snmp-server mibs sensormib cache command in global configuration mode. To restore the default values, use the no form of this command.

snmp-server mibs sensormib cache

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

Global configuration mode.

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Examples

RP/0/RP0/CPU0:router(config)# snmp-server mibs sensormib cache

snmp-server mibs subscriber threshold access-if

To disable the per-session access notifications by the session monitoring process, use the snmp-server mibs subscriber threshold access-if in the global configuration mode. To enable notifications, use the no form of the command.

snmp-server mibs subscriber threshold access-if subsetnumber regular expression word notification rising-falling disable

no snmp-server mibs subscriber threshold access-if

Syntax Description

subset number

Subset number of the subscriber threshold. Lower the subset value, higher is the priority. Range is 1 to 255.

regular expression word

Regular expression to match the interface name. Traps on the corresponding access interface(s) are disabled.

notification

Name of the notification.

rising-falling

The rising and falling thresholds.

disable

Disables the access interface notifications.

Command Default

Session monitoring is enabled by default

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The regular expression keyword disables notifications of the access-interface.

Task ID

Task ID Operation
snmp

read, write

Examples

RP/0/RP0/CPU0:router (config) # snmp-server mibs subscriber threshold access-if subset 100 regular expression notification rising-falling disable 

snmp-server mibs subscriber threshold

To set the snmp-server mibs server threshold parameters, use the snmp-server mibs subscriber threshold command in the global configuration mode. To delete any of the set parameters, use the no form of the command.

snmp-server mibs subscriber threshold [ rising | falling | delta-loss percent | delta-loss evaluation ] [ access-if location interface-path-id interval seconds] [ session-count ]

no snmp-server mibs subscriber threshold

Syntax Description

rising

Rising threshold value. The set value triggers the traps. Traps are generated when the number of sessions exceed the rising threshold value.

falling

Falling threshold value. The set value triggers the traps. Traps are generated when the number of sessions are lesser than the falling threshold value.

delta-loss percent

Delta-loss percentage.

delta-loss evaluation

The actual subscriber sessions (after delta-loss) . This is based on the set delta-loss percentage. If the number of sessions exceed the loss percentage, traps are generated.

access-if

Access-interface.

location name

Location name.

interval seconds

Interval between the rising and the falling thresholds (in seconds).

session-count

Subscriber-session count.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The minimum delta loss interval is 30 seconds and can be incremented by 10 seconds till the time period reaches 5 minutes.

Task ID

Task ID Operation
snmp

read, write

Examples

RP/0/RP0/CPU0:router (config) # snmp-server mibs subscriber threshold delta-loss evaluation access-if tengige 0/4/0/0 interval 100

snmp-server notification-log-mib

To configure the NOTIFICATION-LOG-MIB, use the snmp-server notification-log-mib command in

global configuration

mode. To remove the specified configuration, use the no form of this command.

snmp-server notification-log-mib {globalAgeOut time | globalSize size | default | disable | size size}

no snmp-server notification-log-mib {globalAgeOut | globalSize | default | disable | size}

Syntax Description

globalAgeOut time

Specifies how much time, in minutes, a notification remains in the log. Values for the time argument can range from 0 to 4294967295; the default is 15.

globalSize size

Specifies the maximum number of notifications that can be logged in all logs. The default is 500.

default

Specifies to create a default log.

disable

Specifies to disable logging to the default log.

size size

Specifies the maximum number of notifications that the default log can hold. The default is 500.

Command Default

NOTIFICATION-LOG-MIB notifications are not logged.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Logging of NOTIFICATION-LOG-MIB notifications begins when the default log is created. Named logs are not supported, therefore only the default log can be created.

Task ID

Task ID

Operations

snmp

read, write

Examples

The following example creates a default log for notifications:


RP/0/RP0/CPU0:router(config)# snmp-server notification-log-mib default 
                    

This example removes the default log:


RP/0/RP0/CPU0:router(config)# no snmp-server notification-log-mib default 
                     

This example configures the size of all logs to be 1500:


RP/0/RP0/CPU0:router(config)# snmp-server notification-log-mib globalSize 1500 
                     

snmp-server packetsize

To establish control over the largest Simple Network Management Protocol (SNMP) packet size permitted when the SNMP server is receiving a request or generating a reply, use the snmp-server packetsize command in

global configuration

mode. To restore the default value, use the no form of this command.

snmp-server packetsize size

no snmp-server packetsize

Syntax Description

size

Packet size, in bytes. Range is from 484 to 65500. The default is 1500.

Command Default

size : 1500

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the snmp-server packetsize command to establish control over the largest SNMP packet size permitted when the SNMP server is receiving a request or generating a reply.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to set the maximum size of SNMP packets to 1024 bytes:


RP/0/RP0/CPU0:router(config)# snmp-server packetsize 1024
                     

snmp-server queue-length

To establish the message queue length for each trap host for Simple Network Management Protocol (SNMP), use the snmp-server queue-length command in

global configuration

mode. To restore the default value, use the no form of this command.

snmp-server queue-length length

no snmp-server queue-length

Syntax Description

length

Integer that specifies the number of trap events that can be held before the queue must be emptied. Range is from 1 to 5000.

Command Default

length : 100

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the snmp-server queue-length command to define the length of the message queue for each trap host. After a trap message is successfully sent, Cisco IOS XR software continues to empty the queue at a throttled rate to prevent trap flooding.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to set the SNMP notification queue to 20 events:


RP/0/RP0/CPU0:router(config)# snmp-server queue-length 20
                        

snmp-server script

To map the script file with custom OID, use the snmp-server script command in XR Config mode.

snmp-server script script-oid oid-number script-filename file-name

no snmp-server script script-oid oid-number script-filename file-name

Syntax Description

script-oidoid-number

The OID number to be added as custom OID. The custom OID number has to be followed by root OID 1.3.6.1.4.1.9.9.999998.

script-filename file-name

The name of the script file to be mapped.

Command Default

None

Command Modes

XR Config

Command History

Release Modification
Release 7.5.3

This command was introduced.

Usage Guidelines

To use commands of this module, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using any command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

snmp

read,write

Examples

This example shows how to map the script file with custom OID.

Router(config)#snmp-server script script-oid 1.3.6.1.4.1.9.9.999998.10 script-filename show_lldp_string.py

snmp-server target list

To create a Simple Network Management Protocol (SNMP) target list, use the snmp-server target list command in

global configuration

mode. To remove an SNMP target list, use the no form of this command.

snmp-server target list target-list {vrf vrf-name | host hostname}

no snmp-server target list target-list

Syntax Description

target-list

Name of the target list.

vrf vrf-name

Specifies the name of the VRF hosts included in the target list.

host hostname

Assigns a hostname to the target list. The hostname variable is a name or IP address.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use this command to create an SNMP target list and assign hosts to the list. When a target list is mapped to a community name using the snmp-server community-map command, SNMP access is restricted to the hosts in the target list (for that community name).

Task ID

Task ID

Operations

snmp

read, write

Examples

In this example, a new target list “sample3” is created and assigned to the vrf server “server2:”


RP/0/RP0/CPU0:router(config)# snmp-server target list sample3 vrf server2
                     

snmp-server trap throttle-time

To specify the throttle time for handling more Simple Network Management Protocol (SNMP) traps, use the snmp-server trap throttle-time command in

global configuration

mode. To restore the throttle time to its default value, use the no form of this command.

snmp-server trap throttle-time time

no snmp-server trap throttle-time

Syntax Description

time

Throttle time in milliseconds. Values can be from 10 to 500.

Command Default

250

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID

Operations

snmp

read, write

Examples

In the following example, the trap throttle time is set to 500 milliseconds:


RP/0/RP0/CPU0:router(config)# snmp-server trap throttle-time 500
                    

snmp-server trap-timeout

To define how often to try resending trap messages on the retransmission queue, use the snmp-server trap-timeout command in

global configuration

mode. To restore the default value, use the no form of this command.

snmp-server trap-timeout seconds

no snmp-server trap-timeout seconds

Syntax Description

seconds

Integer that sets the interval for resending the messages, in seconds). Value can be from 1 to 1000.

Command Default

seconds : 30

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Before Cisco IOS XR software tries to send a trap, it looks for a route to the destination address. If there is no known route, the trap is saved in a retransmission queue. Use the snmp-server trap-timeout command to determine the number of seconds between retransmission attempts.

Task ID

Task ID

Operations

snmp

read, write

Examples

The following example shows how to set an interval of 20 seconds to try resending trap messages on the retransmission queue:


RP/0/RP0/CPU0:router(config)# snmp-server trap-timeout 20
                     

snmp-server traps

To enable Simple Network Management Protocol (SNMP) trap notifications, use the snmp-server traps command in

global configuration

mode. To disable SNMP notifications, use the no form of this command.

snmp-server traps notification-type

no snmp-server traps [notification-type]

Syntax Description

notification-type

(Optional) Type of notification (trap) to enable or disable. If no type is specified, all notifications available on the device are enabled or disabled.

The notification type can be one or more of the following keywords:

bfd

Enables Bidirectional Forwarding Detection (BFD) traps.

bgp

Enables BGP4-MIB and CISCO-BGP4-MIB traps.

bridgemib

Enables SNMP traps for the Bridge MIB.

config

Controls configuration notifications, as defined in the CISCO-CONFIG-MAN-MIB (enterprise 1.3.6.1.4.1.9.9.43.2). The notification type is: (1) ciscoConfigManEvent.

copy-complete

Enables CISCO-CONFIG-COPY-MIB ccCopyCompletion traps.

ds1

Enables SNMP Cisco DS1 traps.

ds2

Enables SNMP Cisco DS2 traps.

entity

Controls Entity MIB modification notifications. This notification type is defined in the ENTITY-MIB (enterprise 1.3.6.1.2.1.47.2) as: (1) entConfigChange.

ethernet

Enables Ethernet link OAM and 802.1ag connectivity fault management traps.

flash insertion

Enables ciscoFlashDeviceInsertedNotif.

flash removal

Enables ciscoFlashDeviceRemovedNotif.

fru-ctrl

Enables SNMP entity field-replaceable unit (FRU) control traps.

hsrp

Enables SNMP HSRP traps.

ipsec tunnel start

Enables SNMP IPsec tunnel start traps.

ipsec tunnel stop

Enables SNMP IPsec tunnel stop traps.

isakmp

Enables ISAKMP traps.

l2vpn all

Enables all Layer 2 VPN traps.

l2vpn vc-down

Enables Layer 2 VPN VC down traps.

l2vpn vc-up

Enables Layer 2 VPN VC up traps.

mpls frr all

Enables all MPLS fast reroute MIB traps.

mpls frr protected

Enables MPLS fast reroute tunnel protected traps.

mpls ldp

Enables SNMP Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP) traps.

mpls traffic-eng

Enables SNMP MPLS traffic engineering traps.

msdp peer-state-change

Enables SNMP MSDP Peer state change traps.

ntp

Enables SNMP Cisco NTP traps.

otn

Enables SNMP Cisco optical transport network (OTN) traps.

pim

Enables SNMP PIM traps.

rf

Enables RF-MIB traps.

sensor

Enables SNMP entity sensor traps.

snmp

Enables SNMP traps.

sonet

Enables SONET traps.

syslog

Controls error message notifications (Cisco-syslog-MIB). Specify the level of messages to be sent with the logging history command.

system

Enables SNMP SYSTEMMIB-MIB traps.

vpls

Enables virtual private LAN service (VPLS) traps.

vrrp events

Enables Virtual Router Redundancy Protocol (VRRP) traps.

Note

 

To display the trap notifications supported on a platform, use the online help ( ? ) function.

Command Default

SNMP notifications are disabled by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the snmp-server traps command to enable trap requests for the specified notification types. To configure the router to send SNMP notifications, specify at least one snmp-server traps command. When the command is entered with no keyword, all notification types are enabled. When a notification type keyword is specified, only the notification type related to that keyword is enabled. To enable multiple types of notifications, issue a separate snmp-server traps command for each notification type.

More information about individual MIBs can be found in the SNMP Object Navigator, available through cisco.com at http://tools.cisco.com/Support/SNMP/do/BrowseMIB.do?local=en&step=2.

The snmp-server traps command is used with the snmp-server host command. Use the snmp-server host command to specify which host or hosts receive SNMP notifications.

Task ID

Task ID

Operations

snmp

read, write

Some SNMP trap notifications require additional Task IDs as indicated in the following table:

Notification Type

Task ID

Operations

bfd

bgp

read, write

ospf

read, write

isis

read, write

mpls-te

read, write

snmp

read, write

bgp

bgp

read, write

copy-complete

config-services

read, write

ipsec

crypto

read, write

isakmp

crypto

read, write

l2vpn

l2vpn

read, write

mpls frr

mpls-ldp

read, write

mpls-te

read, write

mpls l3vpn

ipv4

read, write

mpls-ldp

read, write

mpls-te

read, write

mpls ldp

mpls-ldp

read, write

mpls-te

read, write

mpls traffic-eng

mpls-ldp

read, write

mpls-te

read, write

ospf

ospf

read, write

syslog

sysmgr

read, write

vpls

l2vpn

read, write

Examples

This example shows how to enable the router to send all traps to the host specified by the name myhost.cisco.com, using the community string defined as public:


RP/0/RP0/CPU0:router(config)# snmp-server traps 
RP/0/RP0/CPU0:router(config)# snmp-server host myhost.cisco.com public
                     

snmp-server traps bgp

To enable Border Gateway Protocol (BGP) state-change Simple Network Management Protocol (SNMP) notifications, use the snmp-server traps bgp command in global configuration mode. To disable BGP state-change SNMP notifications, use the no form of this command.

snmp-server traps bgp

no snmp-server traps bgp

Syntax Description

This command has no keywords or arguments.

Command Default

SNMP notifications are disabled by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

SNMP notifications can be sent as traps.

Use the snmp-server traps bgp command to enable or disable BGP server state-change notifications, as defined in the BGP4-MIB (enterprise 1.3.6.1.2.1.15.7). The notifications types are:

  • bgpEstablished
  • bgpBackwardTransition

The BGP notifications are defined in the BGP-4 MIB as follows:


bgpTraps                OBJECT IDENTIFIER ::= { bgp 7 }
  
bgpEstablished NOTIFICATION-TYPE
OBJECTS { bgpPeerLastError,
bgpPeerState      }
STATUS  current
DESCRIPTION
"The BGP Established event is generated when the BGP FSM enters the ESTABLISHED 
state."
::= { bgpTraps 1 }

bgpBackwardTransition NOTIFICATION-TYPE
OBJECTS { bgpPeerLastError, 
bgpPeerState      }
STATUS  current
DESCRIPTION
"The BGPBackwardTransition Event is generated when the BGP FSM moves from a higher
numbered state to a lower numbered state."
::= {bgpTraps 2}
   

For a complete description of these notifications and additional MIB functions, see the BGP4-MIB in the SNMP Object Navigator, available through cisco.com at http://tools.cisco.com/Support/SNMP/do/BrowseMIB.do?local=en&step=2.

The snmp-server traps bgp command is used with the snmp-server host command. Use the snmp-server host command to specify which host or hosts receive SNMP notifications.

Task ID

Task ID

Operations

snmp

read, write

bgp

read, write

Examples

The following example shows how to enable the router to send BGP state-change notifications to the host at the address myhost.cisco.com using the community string defined as public:


RP/0/RP0/CPU0:router(config)# snmp-server traps bgp
RP/0/RP0/CPU0:router(config)# snmp-server host myhost.cisco.com version 2c public
            
         

snmp-server traps frequency synchronization

To enable frequency synchronization MIB traps, use the snmp-server traps frequency synchronization command in global configuration mode. To disable frequency synchronization MIB traps, use the no form of this command.

snmp-server traps frequency synchronization

no snmp-server traps frequency synchronization

Syntax Description

This command has no keywords or arguments.

Command Default

Frequency synchronization MIB traps are disabled.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation

snmp

read, write

Examples

This example shows how to enable frequency synchronization MIB traps:

RP/0/RP0/CPU0:router(config)# snmp-server traps frequency synchronization

snmp-server traps mpls l3vpn

To enable the sending of MPLS Layer 3 VPN Simple Network Management Protocol (SNMP) notifications, use the snmp-server traps mpls l3vpn command in global configuration mode. To disable MPLS Layer 3 VPN SNMP notifications, use the no form of this command.

snmp-server traps mpls l3vpn {all | max-threshold-cleared | max-threshold-exceeded | max-threshold-reissue-notif-time seconds | mid-threshold-exceeded | vrf-down | vrf-up}

no snmp-server traps mpls l3vpn

Syntax Description

all

Enables all MPLS Layer 3 VPN traps.

max-threshold-cleared

Enables maximum threshold cleared traps.

max-threshold-exceeded

Enables maximum threshold exceeded traps.

max-threshold-reissue-notif-time seconds

Specifies the time interval for reissuing a maximum threshold notification, in seconds.

mid-threshold-exceeded

Enables mid-threshold exceeded traps.

vrf-down

Enables VRF down traps.

vrf-up

Enables VRF up traps.

Command Default

SNMP notifications are disabled by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID

Operations

snmp

read, write

Examples

The following example shows how to enable the device to send MPLS Layer 3 VPN traps:


RP/0/RP0/CPU0:router(config)# snmp-server traps mpls l3vpn all             
                     

snmp-server traps ospf errors

To enable Open Shortest Path First (OSPF) error Simple Network Management Protocol (SNMP) notifications, use the snmp-server traps ospf errors command in global configuration mode. To disable OSPF error SNMP notifications, use the no form of this command.

snmp-server traps ospf errors {authentication-failure | bad-packet | config-error | virt-authentication-failure | virt-bad-packet | virt-config-error}

no snmp-server traps ospf errors {authentication-failure | bad-packet | config-error | virt-authentication-failure | virt-bad-packet | virt-config-error}

Syntax Description

authentication-failure

Enables SNMP traps for authentication failure errors on physical interfaces.

bad-packet

Enables SNMP traps for bad packet errors on physical interfaces.

config-error

Enables SNMP traps for configuration errors on physical interfaces.

virt-authentication-failure

Enables SNMP traps for authentication failure errors on virtual interfaces.

virt-bad-packet

Enables SNMP traps for bad packet errors on virtual interfaces.

virt-config-error

Enables SNMP traps for configuration errors on virtual interfaces.

Command Default

SNMP notifications are disabled by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

SNMP notifications can be sent as traps.

For a complete description of OSPF error notifications and additional MIB functions, see the OSPF-TRAP-MIB in the SNMP Object Navigator, available through cisco.com at http://tools.cisco.com/Support/SNMP/do/BrowseMIB.do?local=en&step=2.

The snmp-server traps ospf errors command is used with the snmp-server host command. Use the snmp-server host command to specify which host or hosts receive SNMP notifications.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to enable the router to send OSPF error notifications to the host at the address myhost.cisco.com using the community string defined as public:


RP/0/RP0/CPU0:router(config)# snmp-server traps ospf errors
RP/0/RP0/CPU0:router(config)# snmp-server host myhost.cisco.com version 2c public
                     

snmp-server traps ospf lsa

To enable Open Shortest Path First (OSPF) link-state advertisement Simple Network Management Protocol (SNMP) notifications, use the snmp-server traps ospf lsa command in global configuration mode. To disable OSPF link state SNMP notifications, use the no form of this command.

snmp-server traps ospf lsa {lsa-maxage | lsa-originate}

no snmp-server traps ospf lsa {lsa-maxage | lsa-originate}

Syntax Description

lsa-maxage

Enables SNMP traps for link-state advertisement maxage.

lsa-originate

Enables SNMP traps for new link-state advertisement origination.

Command Default

SNMP notifications are disabled by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

SNMP notifications can be sent as traps.

For a complete description of OSPF link-state advertisement notifications and additional MIB functions, see the OSPF-TRAP-MIB in the SNMP Object Navigator, available through cisco.com at http://tools.cisco.com/Support/SNMP/do/BrowseMIB.do?local=en&step=2.

The snmp-server traps ospf lsa command is used with the snmp-server host command. Use the snmp-server host command to specify which host or hosts receive SNMP notifications.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to enable the router to send OSPF link-state advertisement notifications to the host at the address myhost.cisco.com using the community string defined as public:


RP/0/RP0/CPU0:router(config)# snmp-server traps ospf lsa lsa-maxage
RP/0/RP0/CPU0:router(config)# snmp-server host myhost.cisco.com version 2c public
                    

snmp-server traps ospf retransmit

To enable Open Shortest Path First (OSPF) retransmission Simple Network Management Protocol (SNMP) notifications, use the snmp-server traps ospf retransmit command in global configuration mode. To disable OSPF retransmission SNMP notifications, use the no form of this command.

snmp-server traps ospf retransmit {packets | virt-packets}

no snmp-server traps ospf retransmit {packets | virt-packets}

Syntax Description

packets

Enables SNMP traps for packet retransmissions on physical interfaces.

virt-packets

Enables SNMP traps for packet retransmissions on virtual interfaces.

Command Default

SNMP notifications are disabled by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

SNMP notifications can be sent as traps.

For a complete description of OSPF retransmission notifications and additional MIB functions, see the OSPF-TRAP-MIB in the SNMP Object Navigator, available through cisco.com at http://tools.cisco.com/Support/SNMP/do/BrowseMIB.do?local=en&step=2.

The snmp-server traps ospf retransmit command is used with the snmp-server host command. Use the snmp-server host command to specify which host or hosts receive SNMP notifications.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to enable the router to send OSPF retransmission notifications to the host at the address myhost.cisco.com using the community string defined as public:


Router(config)# snmp-server traps ospf retransmit packets
Router(config)# snmp-server host myhost.cisco.com version 2c public
                     

snmp-server traps ospf state-change

To enable Simple Network Management Protocol (SNMP) notifications for Open Shortest Path First (OSPF) neighbor state change, use the snmp-server traps ospf state-change command in global configuration mode. To disable OSPF state-change SNMP notifications, use the no form of this command.

snmp-server traps ospf state-change {if-state-change | neighbor-state-change | virtif-state-change | virtneighbor-state-change}

no snmp-server traps ospf state-change {if-state-change | neighbor-state-change | virtif-state-change | virtneighbor-state-change}

Syntax Description

if-state-change

Enables SNMP traps for OSPF non-virtual interface state chages.

neighbor-state-change

Enables SNMP traps for OSPF neighbor state changes

virtif-state-change

Enables SNMP traps for OSPF virtual interface state changes.

virtneighbor-state-change

Enables SNMP traps for OSPF virtual neighbor state changes.

Command Default

SNMP notifications are disabled by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

SNMP notifications can be sent as traps.

Use the snmp-server traps ospf state-change command to enable or disable OSPF server state-change notifications, as defined in the MIB. One notification type is ospfNbrStateChange.

For example, the OSPF ospfNbrStateChange notification is defined in the OSPF MIB as follows:


!     ospfNbrStateChange NOTIFICATION-TYPE
!         OBJECTS {
!                     ospfRouterId, -- The originator of the trap
!                     ospfNbrIpAddr,
!                     ospfNbrAddressLessIndex,
!                     ospfNbrRtrId,
!                     ospfNbrState  -- The new state
!                   }
!         STATUS             current
    

For a complete description of these notifications and additional MIB functions, see the OSPF-TRAP-MIB in the SNMP Object Navigator, available through cisco.com at http://tools.cisco.com/Support/SNMP/do/BrowseMIB.do?local=en&step=2.

The snmp-server traps ospf state-change command is used with the snmp-server host command. Use the snmp-server host command to specify which host or hosts receive SNMP notifications.

Task ID

Task ID

Operations

snmp

read, write

Examples

The following example shows how to enable the router to send OSPF state-change notifications to the host at the address myhost.cisco.com using the community string defined as public:


RP/0/RP0/CPU0:router(config)# snmp-server traps ospf state-change neighbor-state-change
RP/0/RP0/CPU0:router(config)# snmp-server host myhost.cisco.com version 2c public
                     

snmp-server traps ospfv3 errors

To enable Open Shortest Path First (OSPF) Version 3 error Simple Network Management Protocol (SNMP) notifications, use the snmp-server traps ospfv3 errors command in global configuration mode. To disable OSPFv3 error SNMP notifications, use the no form of this command.

snmp-server traps ospfv3 errors [bad-packet | config-error | virt-bad-packet | virt-config-error]

no snmp-server traps ospfv3 errors [bad-packet | config-error | virt-bad-packet | virt-config-error]

Syntax Description

bad-packet

Enables SNMP traps for bad packet errors on physical interfaces.

config-error

Enables SNMP traps for configuration errors on physical interfaces.

virt-bad-packet

Enables SNMP traps for bad packet errors on virtual interfaces.

virt-config-error

Enables SNMP traps for configuration errors on virtual interfaces.

Command Default

SNMP notifications are disabled by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

SNMP notifications can be sent as traps.

For a complete description of OSPFv3 error notifications and additional MIB functions, see the OSPFV3-MIB in the SNMP Object Navigator, available through cisco.com at http://tools.cisco.com/Support/SNMP/do/BrowseMIB.do?local=en&step=2.

The snmp-server traps ospfv3 errors command is used with the snmp-server host command. Use the snmp-server host command to specify which host or hosts receive SNMP notifications.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to enable the router to send OSPF error notifications to the host at the address myhost.cisco.com using the community string defined as public:


RP/0/RP0/CPU0:router(config)# snmp-server traps ospfv3 errors
RP/0/RP0/CPU0:router(config)# snmp-server host myhost.cisco.com version 2c public
                     

snmp-server traps ospfv3 state-change

To enable Simple Network Management Protocol (SNMP) notifications for Open Shortest Path First (OSPF) Version 3 state changes, use the snmp-server traps ospfv3 state-change command in global configuration mode. To disable OSPFv3 state-change SNMP notifications, use the no form of this command.

snmp-server traps ospfv3 state-change [if-state-change | neighbor-state-change | nssa-state-change | restart-helper-status-change | restart-status-change | restart-virtual-helper-status-change | virtif-state-change | virtneighbor-state-change]

no snmp-server traps ospfv3 state-change [if-state-change | neighbor-state-change | nssa-state-change | restart-helper-status-change | restart-status-change | restart-virtual-helper-status-change | virtif-state-change | virtneighbor-state-change]

Syntax Description

if-state-change

Enables SNMP traps for OSPFv3 non-virtual interface state chages.

neighbor-state-change

Enables SNMP traps for OSPFv3 neighbor state changes

nssa-state-change

Enables SNMP traps for OSPFv3 not so stubby area (NSSA) status changes.

restart-helper-status-change

Enables SNMP traps for OSPFv3 restart helper status changes.

restart-status-change

Enables SNMP traps for OSPFv3 restart status changes.

restart-virtual-helper-status-change

Enables SNMP traps for OSPFv3 virtual helper restart status changes.

virtif-state-change

Enables SNMP traps for OSPFv3 virtual interface state changes.

virtneighbor-state-change

Enables SNMP traps for OSPFv3 virtual neighbor state changes.

Command Default

SNMP notifications are disabled by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

SNMP notifications can be sent as traps.

Use the snmp-server traps ospfv3 state-change command to enable or disable the various OSPFv3 server state-change notifications, as defined in the MIB.

The snmp-server traps ospfv3 state-change command is used with the snmp-server host command. Use the snmp-server host command to specify which host or hosts receive SNMP notifications.

Task ID

Task ID

Operations

snmp

read, write

Examples

The following example shows how to enable the router to send OSPFv3 NSSA state-change notifications to the host at the address myhost.cisco.com using the community string defined as public:


RP/0/RP0/CPU0:router(config)# snmp-server traps ospfv3 state-change nssa-state-change
RP/0/RP0/CPU0:router(config)# snmp-server host myhost.cisco.com version 2c public
                     

snmp-server traps pim interface-state-change

To enable Protocol Independent Multicast (PIM) interface status notification, use the snmp-server traps pim interface-state-change command in global configuration mode. To disable this command so no notification is sent, use the no form of this command.

snmp-server traps pim interface-state-change

no snmp-server traps pim interface-state-change

Syntax Description

This command has no keywords or arguments.

Command Default

Simple Network Management Protocol (SNMP) notifications are disabled by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the snmp-server host command to specify which host or hosts receive SNMP notifications.

Use the snmp-server traps pim interface-state-change command to send notifications when a PIM interface changes status from up to down. When the status is up, the notification signifies the restoration of a PIM interface. When the status is down, the notification signifies the loss of a PIM interface.

PIM notifications are defined in the CISCO-PIM-MIB.my and PIM-MIB.my files that can be accessed from the SNMP Object Navigator, available through cisco.com at http://tools.cisco.com/Support/SNMP/do/BrowseMIB.do?local=en&step=2.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to use the snmp-server traps pim interface-state-change command:


RP/0/RP0/CPU0:router(config)# snmp-server traps pim interface-state-change
RP/0/RP0/CPU0:router(config)# snmp-server host myhost.cisco.com version 2c public
                     

snmp-server traps pim invalid-message-received

To enable notifications for monitoring invalid Protocol Independent Multicast (PIM) protocol operations, such as invalid register received and invalid join or prune received, use the snmp-server traps pim invalid-message-received command in global configuration mode. To disable this command so that no notification is sent, use the no form of this command.

snmp-server traps pim invalid-message-received

no snmp-server traps pim invalid-message-received

Syntax Description

This command has no keywords or arguments.

Command Default

Simple Network Management Protocol (SNMP) notifications are disabled by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the snmp-server host command to specify which host or hosts receive SNMP notifications.

A router can receive a join or prune message in which the RP specified in the packet is not the RP for the multicast group. Or a router can receive a register message from a multicast group in which it is not the RP.

PIM notifications are defined in the CISCO-PIM-MIB.my and PIM-MIB.my files that can be accessed from the SNMP Object Navigator, available through cisco.com at http://tools.cisco.com/Support/SNMP/do/BrowseMIB.do?local=en&step=2.

Task ID

Task ID

Operations

snmp

read, write

Examples

The following example shows how to use the snmp-server traps pim invalid-message-received command:


RP/0/RP0/CPU0:router(config)# snmp-server traps pim invalid-message-received
RP/0/RP0/CPU0:router(config)# snmp-server host myhost.cisco.com version 2c public
                    

snmp-server traps pim neighbor-change

To enable Protocol Independent Multicast (PIM) neighbor status down notifications, use the snmp-server traps pim neighbor-change command in global configuration mode. To disable PIM neighbor down notifications, use the no form of this command.

snmp-server traps pim neighbor-change

no snmp-server traps pim neighbor-change

Syntax Description

This command has no keywords or arguments.

Command Default

PIM Simple Network Management Protocol (SNMP) notifications are disabled by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the snmp-server traps pim neighbor-change command to send notifications when a PIM neighbor changes status from up to down on an interface. Use the snmp-server host command to specify which host or hosts receive SNMP notifications.

PIM notifications are defined in the CISCO-PIM-MIB.my and PIM-MIB.my files that can be accessed from the SNMP Object Navigator, available through cisco.com at http://tools.cisco.com/Support/SNMP/do/BrowseMIB.do?local=en&step=2.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to enable the router to send PIM neighbor status down notifications to the host at the address myhost.cisco.com using the community string defined as public:


RP/0/RP0/CPU0:router(config)# snmp-server traps pim neighbor-change
RP/0/RP0/CPU0:router(config)# snmp-server host myhost.cisco.com version 2c public
                     

snmp-server traps pim rp-mapping-change

To enable notifications indicating a change in the rendezvous point (RP) mapping information due to either Auto-RP or bootstrap router (BSR) messages, use the snmp-server traps pim rp-mapping-change command in global configuration mode. To disable this command so no notification is sent, use the no form of this command.

snmp-server traps pim rp-mapping-change

no snmp-server traps pim rp-mapping-change

Syntax Description

This command has no keywords or arguments.

Command Default

PIM SNMP notifications are disabled by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the snmp-server host command to specify which host or hosts receive SNMP notifications.

PIM notifications are defined in the CISCO-PIM-MIB.my and PIM-MIB.my files that can be accessed from the SNMP Object Navigator, available through cisco.com at http://tools.cisco.com/Support/SNMP/do/BrowseMIB.do?local=en&step=2.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to use the snmp-server traps pim rp-mapping-change command:


RP/0/RP0/CPU0:router(config)# snmp-server traps pim rp-mapping-change
RP/0/RP0/CPU0:router(config)# snmp-server host myhost.cisco.com version 2c public
                    

snmp-server traps rsvp

To enable the sending of Resource Reservation Protocol (RSVP) notifications, use the snmp-server traps rsvp command in global configuration mode. To disable RSVP notifications, use the no form of this command.

snmp-server traps rsvp {all | lost-flow | new-flow}

Syntax Description

all

Enables the sending of both new flow lost flow traps.

lost-flow

Enables the sending of traps when a flow is deleted.

new-flow

Enables the sending of traps when a flow is created.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
mpls-te

read, write

ouni

read, write

snmp

read, write

Examples

This example illustrates how to enable all SNMP RSVP MIB traps.


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# snmp-server traps rsvp all

snmp-server traps selective-vrf-download role-change

To attempt to download only those prefixes and labels to a physical entity required to forward traffic through the physical entity, use the snmp-server trap selective-vrf-download role-change command in global configuration mode.

snmp-server trap selective-vrf-download role-change

This command has no keywords or arguments.

Command Default

Selective VRF downloads are disabled.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The selective VRF download feature makes a best effort to download only those prefixes and labels to a physical entity required to forward traffic through the physical entity. This is accomplished by characterizing roles for physical entities based on their configuration.

From a network management point of view the CISCO-SELECTIVE-VRF-DOWNLOAD-MIB:
  • Lists the state relating to the selective VRF download feature for each physical entity capable of forwarding packets.
  • Lists the role change history per address family (ipv4 and ipv6) for each physical entity capable of forwarding packets.
  • Lists the VRF tables selectively downloaded to each physical entity capable of forwarding packets.

Task ID

Task ID Operation

snmp

read, write

basic-services

read, write

Examples

This example shows how to enable the selective VRF downloads:


RP/0/RP0/CPU0:router(config)# snmp-server traps selective-vrf-download role-change

snmp-server traps snmp

To enable the sending of RFC 1157 Simple Network Management Protocol (SNMP) notifications, use the snmp-server traps snmp command in the appropriate configuration mode. To disable RFC 1157 SNMP notifications, use the no form of this command.

snmp-server traps snmp [authentication | coldstart | linkdown | linkup | warmstart]

no snmp-server traps snmp [authentication | coldstart | linkdown | linkup | warmstart]

Syntax Description

authentication

(Optional) Controls the sending of SNMP authentication failure notifications.

linkup

(Optional) Controls the sending of SNMP linkUp notifications

linkdown

(Optional) Controls the sending of SNMP linkDown notifications

coldstart

(Optional) Controls the sending of SNMP coldStart notifications.

warmstart

(Optional) Controls the sending of SNMP warmStart notifications.

Command Default

SNMP notifications are disabled by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The snmp-server traps snmp command is used with the snmp-server host command. Use the snmp-server host command to specify which host or hosts receive SNMP notifications.

The optional authentication keyword controls the sending of SNMP authentication failure notifications. In order to send notifications, you must configure at least one snmp-server host command. An authentication Failure (4) trap signifies that the sending device is the addressee of a protocol message that is not properly authenticated. The authentication method depends on the version of SNMP being used. For SNMPv1 or SNMPv2, authentication failure occurs for packets with an incorrect community string. For SNMPv3, authentication failure occurs for packets with an incorrect Secure Hash Algorithm (SHA) or Message Digest 5 (MD5) authentication key or for a packet that is outside the authoritative SNMP engine’s window, for example, the packets that are configured outside access lists or time ranges. In such an instance, only a report Protocol Data Unit (PDU) is generated, and authentication failure traps are not generated.

The optional linkup keyword controls the sending of SNMP linkUp notifications. The linkUp(3) trap signifies that the sending device recognizes one of the communication links represented in the agent's configuration coming up.

The optional linkdown keyword controls the sending of SNMP linkDown notifications. The linkDown(2) trap signifies that the sending device recognizes a failure in one of the communication links represented in the agent's configuration.

The snmp-server traps snmp command with the linkup or linkdown keywords globally enables or disables SNMP linkUp and linkDown traps. After enabling either of these traps globally, you can enable or disable these traps on specific interfaces using the no notification linkupdown disable command in interface configuration mode. According to RFC 2863, linkUp and linkDown traps are enabled for interfaces that do not operate on top of any other interface (as defined in the ifStackTable), and are disabled otherwise. This means that you do not have to enable linkUp and linkdown notifications on such interfaces. However, linkUp and linkDown notifications will not be sent unless you enable them globally using the snmp-server traps snmp command.

The optional coldstart keyword controls the sending of SNMP coldStart notifications. The coldStart(0) trap signifies that the sending device is reinitializing itself such that the agent's configuration or the protocol entity implementation may be altered.

The optional warmstart keyword controls the sending of SNMP coldStart notifications. The warmStart(1) trap signifies that the sending device is reinitializing itself such that neither the agent configuration nor the protocol entity implementation is altered.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to enable the device to send all traps to the host myhost.cisco.com using the community string defined as public:


RP/0/RP0/CPU0:router(config)# snmp-server traps snmp              
RP/0/RP0/CPU0:router(config)# snmp-server host myhost.cisco.com public snmp
         

The following example shows how to enable only linkUp and linkDown traps:


RP/0/RP0/CPU0:router(config)# snmp-server traps snmp linkup
RP/0/RP0/CPU0:router(config)# snmp-server traps snmp linkdown
  

snmp-server traps subscriber session-aggregation

To set the session aggregation parameters, use the snmp-server traps subscriber session command in global configuration mode. To delete the set parameters, use the no form of the command.

snmp-server traps subscriber session-agregation [ access-interface | node ]

no snmp-server traps subscriber session-agregation [ access-interface | node ]

Syntax Description

access-interface

Subscriber notification at access interface level.

node

Subscriber notification at node level.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the snmp-server traps subscriber session-agregation command to enable CISCO-SUBSCRIBER-SESSION-MIB notifications (traps). Notifications will include MIB's asynchronous events.

Task ID

Task ID Operation
snmp

read, write

Examples

RP/0/RP0/CPU0:router (config)# snmp-server traps subscriber session-aggregation node 

snmp-server traps syslog

To enable Simple Network Management Protocol (SNMP) notifications of Cisco-syslog-MIB error messages, use the snmp-server traps syslog command in the appropriate configuration mode. To disable these types of notifications, use the no form of this command.

snmp-server traps syslog

no snmp-server traps syslog

Syntax Description

This command has no keywords or arguments.

Command Default

SNMP notifications are disabled by default.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The snmp-server traps syslog command is used with the snmp-server host command. Use the snmp-server host command to specify which host or hosts receive SNMP notifications.

Task ID

Task ID

Operations

snmp

read, write

Examples

The following example shows how to enable Cisco-syslog-MIB error message notifications to the host at the address myhost.cisco.com, using the community string defined as public:


RP/0/RP0/CPU0:router(config)# snmp-server traps syslog
RP/0/RP0/CPU0:router(config)# snmp-server host myhost.cisco.com version 2c public
                     

snmp-server user

To configure a new user to a Simple Network Management Protocol (SNMP) group, use the snmp-server user command in

global configuration

mode. To remove a user from an SNMP group, use the no form of this command.

snmp-server user username groupname {v1 | v2c | v3 [auth {md5 | sha} {clear | encrypted} auth-password [priv {3des | aes aes-bit-encryption | des56} {clear | encrypted} priv-password]]} [SDROwner | SystemOwner] [access-list-name]

no snmp-server user username groupname

Syntax Description

username

Name of the user on the host that connects to the agent.

Note

 

The recommended range for a user-defined username is 2-253 characters.

groupname

Name of the group to which the user belongs.

v1

Specifies that the SNMPv1 security model should be used.

v2c

Specifies that the SNMPv2c security model should be used.

v3

Specifies that the SNMPv3 security model should be used.

auth

(Optional) Specifies which authentication level should be used. If this keyword is used, you must specify an authentication level and an authorization password.

md5

Specifies the HMAC-MD5-96 authentication level.

sha

Specifies the HMAC-SHA-96 authentication level.

clear

Specifies that an unencrypted password follows.

encrypted

Specifies that an encrypted password follows.

auth-password

Authentication password, which is a string (not to exceed 64 characters) that enables the agent to receive packets from the host.

priv

(Optional) Specifies that encryption parameters follow.

3des

Specifies the 168-bit Triple Data Encryption Standard (3DES) level of encryption for the user.

aes aes-bit-encryption

Specifies the Advanced Encryption Standard (AES) level of encryption for the user. Supported options are 128, 192 and 256 bit encryption.

des56

Specifies the 56-bit Data Encryption Standard (DES) level of encryption for the user.

priv-password

Privacy password, which can be clear or encrypted text, according to what is specified.

SDROwner

(Optional) Limits access to the agents for the owner secure domain router (SDR) only.

SystemOwner

(Optional) Provides system-wide access to the agents for all SDRs.

access-list-name

(Optional) Access list to be associated with this SNMP user. The access-list-name argument represents a value from 1 to 99, that is, the identifier of the standard IP access list.

Command Default

By default, access is limited to agents on the owner SDR only.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

To use 3DES and AES encryption standards, you must have installed the security package (k9sec). For information on installing software packages, see Upgrading and Managing Cisco IOS XR Software in System Management Configuration Guide for Cisco 8000 Series Routers.


Note


Only one remote host can be assigned to the same username for SNMP version 3. If you configure the same username with different remote hosts, only the last username and remote host combination will be accepted and will be seen in the show running configuration. In the case of multiple SNMP managers, multiple unique usernames are required.


Table 8. snmp-server user Default Descriptions

Characteristic

Default

passwords

Text strings are assumed.

access lists

Access from all IP access lists is permitted.

SDR and System-wide Access

When the snmp-server user command is entered with the SDROwner keyword, SNMP access is granted only to the MIB object instances in the owner SDR.

When the snmp-server user command is entered with the SystemOwner keyword, SNMP access is granted to the entire system.

Task ID

Task ID

Operations

snmp

read, write

Examples

The following example shows how to enter a plain-text password for the string abcd for user2 in group2:


RP/0/RP0/CPU0:router(config)# snmp-server user user2 group2 v3 auth md5 clear abcd
         

To learn if this user has been added to the configuration, use the show snmp user command.

If the localized Message Digest 5 (MD5) or Secure Hash Algorithm (SHA) digest is known, specify that string instead of the plain-text password. The digest should be formatted as AA:BB:CC:DD where AA, BB, CC, and DD are hexadecimal values. The digest should also be exactly 16 octets long.

This example shows how to specify the command with a digest name of 00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:


RP/0/RP0/CPU0:router(config)# snmp-server user user2 group2 v3 auth md5 encrypted
     00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF
         

snmp-server view

To create or update a Simple Network Management Protocol (SNMP) view entry, use the snmp-server view command in

global configuration

mode. To remove the specified server view entry, use the no form of this command.

snmp-server view view-name oid-tree {excluded | included}

no snmp-server view view-name oid-tree {excluded | included}

Syntax Description

view-name

Label for the view record being updated or created. The name is used to reference the record.

oid-tree

Object identifier (OID) of the ASN.1 subtree to be included or excluded from the view. To identify the subtree, specify a text string consisting of numbers, such as 1.3.6.2.4, or a word, such as system. Replace a single subidentifier with the asterisk (*) wildcard to specify a subtree family; for example 1.3.*.4.

excluded

Excludes the MIB family from the view.

included

Includes the MIB family in the view.

Command Default

No view entry exists.

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Other SNMP commands require a view as a keyword. Use the snmp-server view command to create a view to be used as keywords for other commands that create records including a view.

Instead of defining a view explicitly, you can rely on the following predefined views, which are supported by the SNMP agent:

all

Predefined view indicating that a user can see all objects.

CfgProt

Predefined view indicating that a user can see all objects except the SNMPv3 configuration tables.

vacmViewTreeFamilyEntry

Predefined view indicating that a user can see the default configuration of vacmViewTreeFamilyEntry.

The predefined views supported on Cisco IOS XR software, however, do not match the predefined views specified in RFC 3415.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example creates a view that includes all objects in the MIB-II subtree:


RP/0/RP0/CPU0:router(config)# snmp-server view mib2 1.3.6.1.2.1 included
                     

This example shows how to create a view that includes all objects in the MIB-II system group and all objects in the Cisco enterprise MIB:


RP/0/RP0/CPU0:router(config)# snmp-server view view1 1.3.6.1.2.1.1 included
RP/0/RP0/CPU0:router(config)# snmp-server view view1 1.3.6.1.4.1.9 included
                     

This example shows how to create a view that includes all objects in the MIB-II system group except for sysServices (System 7) and all objects for interface 1 in the MIB-II interfaces group:


RP/0/RP0/CPU0:router(config)# snmp-server view view1 1.3.6.1.2.1.1 included
RP/0/RP0/CPU0:router(config)# snmp-server view view1 1.3.6.1.2.1.1.7 excluded
RP/0/RP0/CPU0:router(config)# snmp-server view view1 1.3.6.1.2.1.2.2.1.*.1 included
                     

snmp-server vrf

To configure the VPN routing and forwarding (VRF) properties of Simple Network Management Protocol (SNMP), use the snmp-server vrf command in

global configuration

mode. To remove the configuration, use the no form of this command.

snmp-server vrf vrf-name [host address [clear | encrypted] [traps] [version {1 | 2c | 3 security-level}] community-string [udp-port port]] [context context-name]

no snmp-server vrf vrf-name

Syntax Description

vrf-name

Name of the VRF.

host address

(Optional) Specifies the name or IP address of the host (the targeted recipient).

clear

(Optional) Specifies that the community-string argument is clear text.

encrypted

(Optional) Specifies that the community-string argument is encrypted text.

traps

(Optional) Specifies that notifications should be sent as traps. This is the default.

version {1 | 2c | 3}

(Optional) Specifies the version of the SNMP used to send the traps. The default is SNMPv1. When the version keyword is used, one of these keywords must be specified:

  • 1—SNMPv1

  • 2c—SNMPv2C

  • 3—SNMPv3

security-level

(Optional) Security level for SNMPv3. Options are:

  • auth—authNoPriv

  • noauth—noAuthNoPriv

  • priv—authPriv

community-string

Specifies the community string for SNMPv1 and SNMPv2, or the SNMPv3 user.

udp-port port

(Optional) Specifies the UDP port to which notifications should be sent.

context context-name

(Optional) Name of the context that must be mapped to VRF identified by value of the vrf-name argument.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use this command to enter SNMP VRF configuration mode and configure an SNMP notification recipient on a VRF. You can also map a VRF to an SNMP context.

SNMP notification recipient that is reachable by way of a VRF can be configured. Notification is forwarded to the recipient represented by its address using the routing table instance identified by the VRF name.

The address argument can be either a host name or an IP address.

Use the clear keyword to specify that the clear text community string you enter is displayed encrypted in the show running command output. To enter an encrypted string, use the encrypted keyword. To enter a clear text community string that is not encrypted by the system, use neither of these keywords.

An SNMP context identified by the value of the context-name argument can be mapped to a VRF in this mode. This context must be created using snmp-server context command.

Task ID

Task ID

Operations

snmp

read, write

Examples

This example shows how to configure a host IP address for a VRF name:


RP/0/RP0/CPU0:router(config)# snmp-server vrf vrfa
RP/0/RP0/CPU0:router(config-snmp-vrf)# host 12.21.0.1 traps version 
2c public udp-port 2525