Table Of Contents
QoS: CBQoS MIB Index Enhancements
Finding Feature Information
Contents
Prerequisites for the QoS: CBQoS MIB Index Enhancements
Restrictions for the QoS: CBQoS MIB Index Enhancements
Information About the QoS: CBQoS MIB Index Enhancements
Feature Overview of the QoS: CBQoS MIB Index Enhancements
Benefits of the QoS: CBQoS MIB Index Enhancements
How to Configure the QoS: CBQoS MIB Index Enhancements
Enabling Cisco IOS MIB and CBQoS MIB Index Persistence
Verifying CBQoS MIB Index Persistence
Configuration Examples for the QoS: CBQoS MIB Index Enhancements
Enabling Cisco IOS MIB and CBQoS MIB Index Persistence: Example
Verifying Cisco IOS MIB and CBQoS MIB Index Persistence: Examples
Additional References
Related Documents
Standards
MIBs
RFCs
Technical Assistance
Feature Information for the QoS: CBQoS MIB Index Enhancements
Glossary
QoS: CBQoS MIB Index Enhancements
First Published: October 31, 2005
Last Updated: June 30, 2009
The QoS: Class-Based Quality of Service (CBQoS) MIB Index Enhancements feature introduces persistence across all CBQoS MIB indexes including cbQosConfigIndex, cbQosObjectsIndex, and cbQosPolicyIndex.
Finding Feature Information
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 for the QoS: CBQoS MIB Index Enhancements" section.
Use Cisco Feature Navigator to find information about platform support and Cisco IOS XE software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Contents
•
Prerequisites for the QoS: CBQoS MIB Index Enhancements
•
Restrictions for the QoS: CBQoS MIB Index Enhancements
•
Information About the QoS: CBQoS MIB Index Enhancements
•
How to Configure the QoS: CBQoS MIB Index Enhancements
•
Configuration Examples for the QoS: CBQoS MIB Index Enhancements
•
Additional References
•
Feature Information for the QoS: CBQoS MIB Index Enhancements
•
Glossary
Prerequisites for the QoS: CBQoS MIB Index Enhancements
You must enable ifMIB persistence by issuing the snmp-server ifindex persist command. Then issue the snmp mib persist cbqos command to enable CBQoS MIB index persistence.
Note
If you issue the snmp mib persist cbqos command before the snmp-server ifindex persist command, you receive a prompt requesting you to enable ifIndex persistence first.
Restrictions for the QoS: CBQoS MIB Index Enhancements
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.
Information About the QoS: CBQoS MIB Index Enhancements
To use the QoS: CBQoS MIB Index Enhancements feature, you should understand the following concepts:
•
Feature Overview of the QoS: CBQoS MIB Index Enhancements
•
Benefits of the QoS: CBQoS MIB Index Enhancements
Feature Overview of the QoS: CBQoS MIB Index Enhancements
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.
Benefits of the QoS: CBQoS MIB Index Enhancements
Provide a Method to Produce MIB Indexes
These enhancements provide a repeatable method for generating MIB indexes so that they do not change between reboots.
Reduce Complexity for Network Management Applications
The complexity of configuring and correlating statistics objects is reduced, making it easier for network management applications to gather accurate information.
How to Configure the QoS: CBQoS MIB Index Enhancements
This section contains the following procedures:
•
Enabling Cisco IOS MIB and CBQoS MIB Index Persistence (required)
•
Verifying CBQoS MIB Index Persistence (optional)
Enabling Cisco IOS MIB and CBQoS MIB Index Persistence
Perform this task to enable Cisco IOS MIB and CBQoS MIB index persistence.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
snmp-server ifindex persist
4.
snmp mib persist [cbqos | v3mibs]
5.
end
6.
write mib-data
or
write
DETAILED STEPS
| |
Command or Action
|
Purpose
|
Step 1
|
enable
Example:
Router> enable
|
Enables privileged EXEC mode.
• Enter your password if prompted.
|
Step 2
|
configure terminal
Example:
Router# configure terminal
|
Enters global configuration mode.
|
Step 3
|
snmp-server ifindex persist
Example:
Router(config)# snmp-server ifindex persist
|
Enables Cisco IOS MIB index (ifIndex) persistence.
|
Step 4
|
snmp mib persist [cbqos | v3mibs]
Example:
Router(config)# snmp mib persist cbqos
|
Enables MIB persistence.
• The optional cbqos keyword enables CBQoS MIB persistence.
• The optional v3mibs keyword enables v3 MIB persistence.
Note If you have not enabled Cisco IOS MIB index (ifIndex) persistence (Step 3.), the following message appears when you issue the snmp mib persist cbqos command:
Enable 'snmp-server ifindex persist' for persist cbqos index
|
Step 5
|
end
Example:
Router(config)# end
|
Returns to privileged EXEC mode.
|
Step 6
|
write mib-data
or
write
Example:
Router# write mib-data
or
Router# write
|
Saves CBQoS MIB data to NVRAM.
|
Verifying CBQoS MIB Index Persistence
Perform the following task to verify that CBQoS MIB index persistence has been enabled.
SUMMARY STEPS
1.
enable
2.
show running-config | include cbqos
3.
exit
DETAILED STEPS
| |
Command or Action
|
Purpose
|
Step 1
|
enable
Example:
Router> enable
|
Enables privileged EXEC mode.
• Enter your password if prompted.
|
Step 2
|
show running-config | include cbqos
Example:
Router# show running-config | include cbqos
|
Displays the configuration information that is currently running on the router.
Note The information should include snmp mib persist cbqos.
|
Step 3
|
exit
Example:
Router# exit
|
Returns to user EXEC mode.
|
Configuration Examples for the QoS: CBQoS MIB Index Enhancements
This section provides the following configuration examples:
•
Enabling Cisco IOS MIB and CBQoS MIB Index Persistence: Example
•
Verifying Cisco IOS MIB and CBQoS MIB Index Persistence: Examples
Enabling Cisco IOS MIB and CBQoS MIB Index Persistence: Example
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
Verifying Cisco IOS MIB and CBQoS MIB Index Persistence: Examples
The following examples verify that Cisco IOS MIB (ifIndex) and CBQoS MIB index persistence have been configured:
Router# show running-config | include cbqos
Router# show running-config | include persist
snmp-server ifindex persist
Additional References
The following sections provide references related to the QoS: CBQoS MIB Index Enhancements feature.
Related Documents
Standards
Standard
|
Title
|
No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.
|
—
|
MIBs
MIB
|
MIBs Link
|
CISCO-CLASS-BASED-QOS-MIB, Revision 13
Note The CISCO-CLASS-BASED-QOS-MIB is actually two MIBs: the CISCO-CLASS-BASED-QOS-MIB and the CISCO-CLASS-BASED-QOS-CAPABILITY-MIB.
|
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:
http://www.cisco.com/go/mibs
|
RFCs
RFC
|
Title
|
RFC 2233
|
The Interfaces Group MIB Using SMIv2
|
Technical Assistance
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.
|
http://www.cisco.com/techsupport
|
Feature Information for the QoS: CBQoS MIB Index Enhancements
Table 1 lists the release history for this feature.
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which Cisco IOS XE software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Note
Table 1 lists only the Cisco IOS XE software release that introduced support for a given feature in a given Cisco IOS XE software release train. Unless noted otherwise, subsequent releases of that Cisco IOS XE software release train also support that feature.
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.
|
Glossary
LSR—label switch router. A Multiprotocol Label Switching (MPLS) node that can forward native Layer 3 packets. The LSR forwards a packet based on the value of a label attached to the packet.
MIB—Management Information Base. A database of network management information that is used and maintained by a network management protocol such as Simple Network Management Protocol (SNMP). The value of a MIB object can be changed or retrieved by using SNMP commands, usually through a network management system. MIB objects are organized in a tree structure that includes public (standard) and private (proprietary) branches.
MQC—Modular Quality of Service (QoS) Command-Line Interface (CLI). A way to specify a traffic class independently of QoS policies by defining a common command syntax and resulting set of QoS behaviors across platforms. This model replaces the previous one of defining unique syntax for each QoS feature and for each platform.
NMS—network management station. A powerful, well-equipped computer (typically an engineering workstation) that is used by a network administrator to communicate with other devices in the network. An NMS is typically used to manage network resources, gather statistics, and perform a variety of network administration and configuration tasks.
policy map—Any defined rule that determines the use of resources within the network. A QoS policy map identifies the traffic class to which it applies and the instructions for one or more actions to take on that traffic.
QoS—quality of service. A measure of performance for a transmission system that reflects its transmission quality and service availability. Quality of service focuses on achieving appropriate network performance for networked applications; it is superior to best effort performance.
SNMP—Simple Network Management Protocol. A management protocol used almost exclusively in TCP/IP networks. SNMP provides a means for monitoring and controlling network devices and for managing configurations, statistics collection, performance, and security.
CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco Ironport, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco Nurse Connect, Cisco Stackpower, Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flip Video, Flip Video (Design), Flipshare (Design), Flip Ultra, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Store, and Flip Gift Card are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website 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. (0907R)
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.
©2005-2009 Cisco Systems, Inc. All rights reserved.