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 QoS: Class-Based Quality of Service (CBQoS) MIB Index Enhancements feature introduces persistence across all CBQoS MIB indexes including cbQosConfigIndex, cbQosObjectsIndex, and cbQosPolicyIndex.
Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the Feature Information Table at the end of this document.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
You must enable ifMIB persistence by issuing the snmp-server ifindex persistcommand. Then issue the snmp mib persist cbqoscommand to enable CBQoS MIB index persistence.
Note |
If you issue the snmp mib persist cbqoscommandbeforethe snmp-server ifindex persistcommand, you receive a prompt requesting you to enable ifIndex persistence first. |
If the internal hashing of configuration strings causes too many collisions, NVRAM storage may become tight. You can issue the more nvram command to display a new collision file called cbqos-mib to help you keep track of the size.
The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
Table 1 | Feature Information for the QoS CBQoS MIB Index Enhancements |
Feature Name |
Releases |
Feature Information |
---|---|---|
QoS CBQoS MIB Index Enhancements |
Cisco IOS XE Release 2.4 |
The CBQoS MIB Index Enhancements feature introduces persistence across all CBQoS MIB indexes including cbQosConfigIndex, cbQosObjectsIndex, and cbQosPolicyIndex.
|
The cbQosConfigIndex, cbQosObjectsIndex, and cbQosPolicyIndex are volatile because when a networking device reboots, the index numbers may change. This happens because system rebooting can cause the order of the Modular QoS CLI (MQC) configuration to differ from the actual configuration order, which is user-driven and unpredictable. As a result, you must read the MIB frequently to extract statistical and configuration information. Therefore, once a reload has occurred, the MIB has to be repolled to reestablish the indexes to the data stored in the CBQoS MIB.
Traditionally, MIB persistence is handled by Cisco IOS APIs, which save the index and key information to NVRAM. The data is then retrieved and repopulated after reloading. However, this approach does not work well for the current implementation of the cbQosObjectsIndex because of the large amount of information that needs to be saved.
An index encoding scheme based on configuration entries instead of operational sequence is being implemented to provide persistent indexes on router reload so that MIB information retains the same set of object values each time that a networking device reboots.
The index encoding scheme has been changed to handle the performance/scalability issue. Each service policy is uniquely identified by an index called cbQosPolicyIndex, and its cbQosObjectsIndex is uniquely identified under the service policy.
Note |
As a result of this change in the index encoding scheme, an application must not assume that the cbQosPolicyIndex is usually identical to its cbQosObjectsIndex as a policy-map. |
These enhancements provide a repeatable method for generating MIB indexes so that they do not change between reboots.
The complexity of configuring and correlating statistics objects is reduced, making it easier for network management applications to gather accurate information.
Command or Action | Purpose | |||
---|---|---|---|---|
|
Example: Router> enable |
Enables privileged EXEC mode.
|
||
|
Example: Router# configure terminal |
Enters global configuration mode. |
||
|
Example: Router(config)# snmp-server ifindex persist |
Enables Cisco IOS MIB index (ifIndex) persistence. |
||
|
Example: Router(config)# snmp mib persist cbqos |
Enables MIB persistence.
|
||
|
Example: Router(config)# end |
Returns to privileged EXEC mode. |
||
|
Example: write Example: Router# write mib-data Example: Router# write |
Saves CBQoS MIB data to NVRAM. |
The following example enables Cisco IOS MIB (ifIndex) and CBQoS MIB index persistence:
Router# configure terminal Enter configuration commands, one per line. End with CNTL/Z. Router(config)# snmp-server ifindex persist Router(config)# snmp mib persist cbqos
The following examples verify that Cisco IOS MIB (ifIndex) and CBQoS MIB index persistence have been configured:
Router# show running-config | include cbqos snmp mib persist cbqos Router# show running-config | include persist snmp-server ifindex persist snmp mib persist cbqos
Related Topic |
Document Title |
---|---|
QoS commands |
Cisco IOS Quality of Service Solutions Command Reference |
SNMP commands |
Cisco IOS Network Management Command Reference |
SNMP configuration tasks, MIB persistence |
"Configuring SNMP Support" module |
Other documentation |
For information on using SNMP MIB features, see the appropriate documentation for your network management system. |
Standard |
Title |
---|---|
No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature. |
-- |
MIB |
MIBs Link |
||
---|---|---|---|
CISCO-CLASS-BASED-QOS-MIB, Revision 13
|
To locate and download MIBs for selected platforms, Cisco IOS XE software releases, and feature sets, use Cisco MIB Locator found at the following URL: |
RFC |
Title |
---|---|
RFC 2233 |
The Interfaces Group MIB Using SMIv2 |
Description |
Link |
---|---|
The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password. |
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.