The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
The SNMP Cache Engine Enhancement feature caches the SNMP information on the Supervisor.
Your software release may not support all the features that are documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. The Feature Information Table at the end of this document provides information about the documented features and lists the releases in which each feature is supported.
 Note |
The hardware components that are introduced in a given Cisco IOS-XE Release are supported in all subsequent releases unless otherwise specified. |
The time interval for which the cached information is available on the Supervisor is 5 seconds.
The SNMP Cache Engine Enhancement feature caches the information on the Supervisor for the MIB tables, which need to retrieve the data from the interface cards. When a MIB table item is queried from the interface card, the next N items are retrieved and cached on the Supervisor.
For example, if SNMP client queries the docsIf3CmtsCmRegStatusMacAddr.1, the interface card bundles docsIf3CmtsCmRegStatusMacAddr.1, docsIf3CmtsCmRegStatusMacAddr.2, docsIf3CmtsCmRegStatusMacAddr.3, to docsIf3CmtsCmRegStatusMacAddr.N together in one IPC response, and sends it to the Supervisor. The Supervisor caches all the items locally. When the SNMP client queries the docsIf3CmtsCmRegStatusMacAddr.2 later, the information is available in the Supervisor cache directly instead of sending another IPC message to interface card. The number N depends on the single MIB item size and maximum IPC message buffer size.
The MIB table information for following MIBs are retrieved and cached on the Supervisor:
DOCS-IF-MIB
DOCS-IFEXT2-MIB
DOCS-QOS-MIB
DOCS-IF3-MIB
DOCS-IF31-MIB
DOCS-QOS3-MIB
DOCS-IETF-QOS-MIB
DOCS-BPI-PLUS-MIB
DOCS-LOADBALANCING-MIB
DOCS-LOADBAL3-MIB
DOCS-DSG-IF-MIB
CISCO-DOCS-EXT-MIB
CISCO-CABLE-WIDEBAND-MIB
CISCO-CABLE-SPECTRUM-MIB
This feature is enabled by default on the Cisco cBR routers. The time interval for which the SNMP cache information is stored on the Supervisor is known as age and set to 5 seconds.
You must configure the service internal command in global configuration mode to enable or disable SNMP Cache Engine Enhancement.
| Command or Action | Purpose | |||
|---|---|---|---|---|
| Step 1 |
enable Example: |
Enables privileged EXEC mode.
|
||
| Step 2 |
configure terminal Example: |
Enters global configuration mode. |
||
| Step 3 |
cable snmp cache active Example: |
Sets the SNMP cache status to active.
|
||
| Step 4 |
exit Example: |
Exits the global configuration mode and enters the privileged EXEC mode. |
Use the show cable snmp cache-status command to display the current SNMP cache engine status.
Important |
You must configure the service internal command in global configuration mode to verify the SNMP cache engine status. |
Following is a sample output of the command.
Router# show cable snmp cache-status
Cache engine is ON, age: 5 seconds
Use the test cable snmp counter-show command to display the cache counters information.
Router# test cable snmp counter-show
========== cache counters ==========
ubrcce_snmp_cache_hit_counter:0.
ubrcce_snmp_cache_get_from_lc_counter:1.
ubrcce_snmp_cache_miss_counter:0.
ubrcce_snmp_cache_ipc_fail_counter:0.
ubrcce_snmp_cache_buffer_full_counter:0.
hit and mis are the historic information for the SNMP cache after the system bootup. hit indicates the number of times the SNMP queries are hit in the cache and mis indicates the number of times the SNMP queries are missed in the SNMP cache.
| Description | Link |
|---|---|
|
The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies. To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds. Access to most tools on the Cisco Support website requires a Cisco.com user ID and password. |
Use Cisco Feature Navigator to find information about the platform support and software image support. Cisco Feature Navigator enables you to determine which software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An account on the Cisco.com page is not required.
Note |
The following table lists the software release in which a given feature is introduced. Unless noted otherwise, subsequent releases of that software release train also support that feature. |
|
Feature Name |
Releases |
Feature Information |
|---|---|---|
|
SNMP Cache Engine Enhancement |
Cisco IOS XE Everest 16.6.1 |
This feature was integrated into Cisco IOS XE Everest 16.6.1 on theCisco cBR Series Converged Broadband Routers. |
Feedback