Table Of Contents
Preface
Document Revision History
Audience
Organization
Obtaining Documentation and Submitting a Service Request
Preface
Revised: December 2008, OL-15724-02
This guide describes the implementation of the Simple Network Management Protocol (SNMP) for Cisco Cable Modem Termination System (CMTS) routers.
SNMP provides a set of commands for setting and retrieving the values of operating parameters on the router. Router information is stored in a virtual storage area called a Management Information Base (MIB), which contains many objects that describe router components and provides information about the status of the components. This Preface provides an overview of this guide with the following sections:
•
Document Revision History
•
Audience
•
Organization
•
Obtaining Documentation and Submitting a Service Request
Document Revision History
The following Revision History tables record technical changes, additions, and corrections to this document. The table shows the release number and document revision number for the change, the date of the change, and a brief summary of the change.
Cisco IOS Release
|
Cisco RF Switch Firmware Version
|
Part Number
|
Publication Date
|
12.2(33)SCB
|
3.90
|
OL-15724-02
|
December 2008
|
Description of Changes
•
Added the following MIBs to support DOCSIS 3.0:
–
CLAB-TOPO-MIB
–
DOCS-IF3-MIB
–
DOCS-DIAG-MIB
–
DOCS-DRF-MIB
–
DOCS-QOS3-MIB
–
DOCS-IETF-CABLE-DEVICE-NOTIFICATION-MIB
–
DOCS-IETF-BPI2-MIB
–
DOCS-IETF-QOS-MIB
•
Added the following MIBs to support DOCSIS 2.0:
–
DOCS-IFEXT2-MIB
–
DOCS-TEST-MIB
Cisco IOS Release
|
Cisco RF Switch Firmware Version
|
Part Number
|
Publication Date
|
12.2(33)SCA
|
3.90
|
OL-15724-01
|
February 2008
|
Description of Changes
•
Cisco RF Switch Firmware Version 3.90, installed on Cisco RF Switch, provides the following changes or enhancements to be used with Cisco IOS release 12.3(21)BC through Cisco IOS release 12.2(33)SCA:
–
The updated Firmware version 3.90 resolves the Address Resolution Protocol (ARP) cache handling issue and ensures ARP updates after timeout.
–
Version 3.90 provides for enhancement in the telnet server to negotiate with the client regarding the desired setting of the echo mode. The user can set the initial state of the local echoing using the set telnet echo command. However, the telnet server can bypass this and use the client's setting if the client supports echo options negotiation.
–
In version 3.90, the Trivial File Transfer Protocol (TFTP) is enhanced to display the number of bytes as transfer progresses.
–
In version 3.90, the command-line interface (CLI) task priority is pushed below that of the network task. From this release, ping command has higher priority than an interface command.
–
In version 3.90, the command show version is modified so that the full cyclic redundancy check (CRC) validation is not done on the flash contents. It now validates only the file header contents. To perform a full CRC check, use the command show files.
–
Version 3.90 allows RF Switch to accept passwords that match CLI keywords. In version 3.80, they were not accepted and shown as Invalid Syntax.
–
Version 3.90 updates real-time operating system (RTOS) kernel to be compatible with new IP stack.
•
Added a new MIB, DOCSIS-L2VPN-MIB, in Chapter 3, "MIB Specifications" to support L2VPN support over Cable. The Layer 2 VPN (L2VPN) Support over Cable feature on the Cisco CMTS provides point-to-point Transparent LAN Service (TLS) to support the Business Services over DOCSIS (BSOD) CableLabs specification. Key features of L2VPN support are:
–
Supports point-to-point L2VPN forwarding mode.
–
Supports up-to 4 VPN IDs per cable modem (CM).
–
Supports multiple upstream service flows (SFs) per CM, with one or more SFs belonging to the same VPN ID.
–
Supports a single Ethernet Network System Interface (NSI) that serves as a trunking port for one or more L2VPN tunnels on the Cisco CMTS router.
–
Supports Baseline Privacy Interface Plus (BPI+) encryption using primary Security Association Identifier (SAID) of the CM.
–
Supports L2VPN encodings in the CM configuration file and CM registration (REG-REQ with L2VPN encoding).
–
Supports upstream L2VN tunnel in support of per-CM and per-SF forwarding.
–
Supports synchronization and recovery of the L2VPN database and upstream and downstream SFs during PRE2 NSF/SSO and N+1 line card redundancy switchovers.
–
Supports Quality of Service (QoS) in upstream and downstream.
–
Supports stacked IEEE 802.1q tags.
–
Supports exclusion of traffic from the L2VPN tunnel for a single Embedded Service/Application Functional Entity (eSAFE) host.
–
Supports Layer 2 classifier via Cable Modem Interface Mask (CMIM) and priority.
–
Supports detection of provisioning errors such as duplicate VLAN IDs across CMs or existing VLAN IDs in use and moves a CM offline with a corresponding error message.
–
Supports coexistence of L2VPN and non-L2VPN traffic on the same RF MAC domain, with non-L2VPN traffic isolation from other tunnel traffic.
•
Added three new MIBs (CISCO-TAP2-MIB, CISCO-IP-TAP-MIB, and CISCO-802-TAP-MIB) in Chapter 3, "MIB Specifications" to support Service Independent Intercept (SII) on the Cisco CMTS. The SII feature enhances the current Lawful Intercept (LI) capability for the Cisco uBR7246VXR and Cisco uBR10012 Universal Broadband Routers using Simple Network Management Protocol Version 3 (SNMPv3). SII extends this LI capability in Cisco IOS Release 12.2(33)SCA by adding support for CPE-based and CM-based MAC intercepts using SNMPv3. SII is designed to provide data intercepts via SNMPv3, while PacketCable intercepts are designed for voice IP intercepts using a Common Open Policy Service (COPS) interface. Key features of SII feature are:
–
Allows multiple law enforcement agencies (LEAs) to run a lawful intercept on the same target without each other's knowledge.
–
Does not affect subscriber services on the router.
–
Cannot be detected by the target.
–
Allows LEAs to perform lawful intercepts without the knowledge of service providers.
–
Uses SNMPv3 and security features like the View-based Access Control Model (SNMP-VACM-MIB) and User-based Security Model (SNMP-USM-MIB) to restrict access to lawful intercept information and components.
–
Supports intercepts of Layer 3 and Layer 2 traffic.
–
Supports Layer 2 intercepts for upstream and downstream traffic.
–
Hides information about lawful intercepts from all but the most privileged users. An administrator must set up access rights to enable privileged users to access lawful intercept information.
–
Provides two secure interfaces for performing an intercept: one for setting up the wiretap and another for sending the intercepted traffic to the mediation device.
–
Coexists with Packet Intercept (PI). To support Packet Intercept (PI) in a PacketCable environment for voice intercepts, you must enable PacketCable operation on the CMTS and perform any other related PacketCable configurations as required.
Cisco IOS Release
|
Part Number
|
Publication Date
|
12.3(23)BC
|
OL-4952-08
|
December 2007
|
Description of Changes
Cisco IOS Release 12.3(23)BC introduces support for DOCSIS 3.0 Downstream Solution on the Cisco uBR10012 router and Cisco SIP and SPA. The following MIBs are introduced or enhanced further in Cisco IOS Release 12.3(23)BC for DOCSIS 3.0 Downstream Solution on the Cisco CMTS:
•
CISCO-CABLE-SPECTRUM-MIB
•
CISCO-CABLE-WIDEBAND-MIB
•
CISCO-DOCS-EXT-MIB
•
DOCS-DSG-IF-MIB
•
DOCS-IF-MIB
•
DTI-MIB
•
DOCS-BPI-PLUS-MIB
•
DOCS-CABLE-DEVICE-MIB
•
DOCS-CABLE-DEVICE-TRAP-MIB
•
ENTITY-MIB
•
IF-MIB
Cisco IOS Release
|
Cisco RF Switch Firmware Version
|
Part Number
|
Publication Date
|
12.3(21)BC
|
3.80
|
OL-4952-06
|
August 2007
|
Description of Changes
Cisco RF Switch Firmware Version 3.80, installed on the Cisco RF Switch, supports the following changes or enhancements for SNMP MIBs on the Cisco RF Switch, to be used with Cisco IOS release 12.3BC on the Cisco CMTS:
•
SNMP MIB get and set variables can be saved to cache in the AdminState MIB module. The SNMP Cache can be disabled or reenabled using the system-level set snmp cache firmware command. The setting for this command is stored in non-volatile memory on the Cisco RF Switch.
•
Cisco RF Switch Firmware Version 3.80 adds a new MIB object identifier (OID) to control caching on the Cisco CMTS. To control caching in this manner, use the SNMP object nruCacheSnmpData, which is a read/write integer at OID 1.3.6.1.4.1.6804.2.1.1.9.
•
Three system-level Cisco RF Switch firmware commands have been introduced or enhanced to reflect these additional caching functions and options:
–
set snmp cache
–
show config
–
show module
Refer to the following document on Cisco.com for additional command information:
•
Release Notes for Cisco RF Switch Firmware, Version 3.80
http://www.cisco.com/en/US/docs/cable/rfswitch/ubr3x10/release/notes/rfswrn36.html
Cisco IOS Release
|
Part Number
|
Publication Date
|
12.3(21)BC
|
OL-4952-05
|
February 2007
|
Description of Changes
•
CISCO-CABLE-WIDEBAND-MIB support on the Cisco uBR10012 universal broadband router. Cisco Wideband Protocol supports downstream wideband channels consisting of multiple bonded RF channels.
Note
CISCO-CABLE-WIDEBAND-MIB support is only on the uBR100012 CMTS router and is a Cisco proprietary MIB that supports the DOCSIS 3.0 standard.
–
Updated the ENTITY-MIB with the new wideband shared port adapter card, SPA-24XWBD-SFP support, OID 1.3.6.1.4.1.9.12.3.1.9.2.145. See Cisco uBR100012 SPA-24XWBD-SFP Shared Port Adapter, page 78 for the shared port adapter physical entities and values in the ENTITY-MIB.
–
Update the IF-MIB for interface wideband management support.
–
Added ccwbFiberNodeTable which provides configuration and topology information for Fiber nodes. See CISCO-CABLE-WIDEBAND-MIB, page 17.
–
Updated Cisco SNMP Notifications, page 3 with wideband cable trap support.
•
Enhanced the CISCO-DOCS-EXT-MIB, page 26 with new table objects that can query both CM and CPE information.
•
Added tables (docsQosParamSetEntry, docsQosServiceFlowEntry, docsQosServiceFlowStatsEntry, docsQosPHSEntry, docsQosPktClassEntry, docsQosUpstreamStatsEntry) to support SNMP enhancements in the DOCS-QOS-MIB. This enhancement significantly improves QoS MIB query time in a large scale system with much less CPU consumption.
•
Enhanced CISCO-CABLE-SPECTRUM-MIB, page 15 with new tables and objects to support the retrieval of spectrum group information using SNMP query.
•
Updated Cisco CMTS platform support for unique device identifier (UDI) compliance. Added support for the unique device identifier (UDI) standard which displays information from any Cisco product that has electronically stored identity information. See Overview of the ENTITY-MIB, page 79.
•
Updated the CISCO-CABLE-METERING-MIB with the ccmtrCollectionSrcIfIndex object which is used to specify the source interface for billing packets.
•
Added the docsIfCmtsChannelUtilizationInterval object to the DOCS-IF-MIB. This object provides operators with a mechanism to evaluate the load/utilization of both upstream and downstream physical channels. This information may be used for capacity planning and incident analysis, and may be particularly helpful in provisioning of high value QOS.
•
Added support on the uBR10012and uBR7246VXR router platforms for the CISCO-CABLE-ADMISSION-CTRL-MIB
Note
For detailed information about admission control for Cisco CMTS, go to the following URL:
http://www.cisco.com/en/US/docs/cable/cmts/feature/guide/ufg_adm.html
Cisco IOS Release
|
Part Number
|
Publication Date
|
12.3(17a)BC2
|
OL-4952-04
|
July 2006
|
Description of Changes
•
Added the DOCS-DSG-IF-MIB, page 65.
•
Added cable traps, Cable MIB Notifications, page 20.
•
Added section describing the DOSCS-DSG-IF-MIB validation capabilities. See, DOCS-DSG-IF-MIB Validation Requirements, page 41.
•
The CISCO-ENHANCED-MEMPOOL-MIB is supported on cable line cards.
•
Added cable device traps. SeeCable MIB Notifications, page 20.
•
DOCS-IF-MIB, page 60 is updated to draft-ietf-ipcdn-docs-rfmibv2-05.txt.
•
IF-MIB, page 85 supports subinterfaces in the ifTable.
•
Updated the CISCO-DOCS-EXT-MIB, page 26 for the Dynamic Shared Secret feature.
Cisco IOS Release
|
Part Number
|
Publication Date
|
12.3(17a)BC
|
OL-4952-03
|
February 2006
|
Description of Changes
•
Added table (Table 3-2 on page 7) of cable-specific MIBs.
•
Updated the following MIBs:
–
CISCO-CLASS-BASED-QOS-MIB—This MIB is now supported on the Cisco uBR10012 router
–
CISCO-DOCS-EXT-MIB—Supports the dynamic shared secret (DMIC) feature which ensures that every online cable modem uses the DOCSIS configuration file assigned to it. This protects against theft-of-service attempts from subscribers and safeguards operators against stolen or fraudulently downloaded configuration files.
–
ENTITY-MIB
–
CISCO-ENTITY-VENDORTYPE-OID-MIB—Updated OIDs.
–
CISCO-ENVMON-MIB
–
CISCO-CABLE-SPECTRUM-MIB notifications. See Cable MIB Notifications, page 20.
–
DOCS-QOS-MIB—MIB object information is updated to support DCC for load balancing.
•
Updated Chapter 4, "Monitoring Notifications"—Added the following information:
–
Brief description—What the event indicates
–
Probable cause—What might have caused the notification
–
Recommended action—Recommendation as to what should be done when the particular notification occurs
•
Added the usage-based billing support feature to section, Usage-Based Billing, page 36. This feature was introduced on Cisco uBR7246VXR and Cisco uBR10012 universal broadband routers.
Feature support includes the new CISCO-CABLE-METERING-MIB, which contains objects that provide subscriber account and billing information in the Subscriber Account Management Interface Specification (SAMIS) format
For complete documentation about using the Usage-Based Billing feature for Cisco CMTS, go to:
http://www.cisco.com/en/US/docs/cable/cmts/feature/ubrsamis.html
Cisco IOS Release
|
Part Number
|
Publication Date
|
12.3(9a)BC
12.1(20)EC
|
OL-4952-02
|
September 2004 (no revision table available).
|
Audience
This guide is intended for system and network administrators who must configure the router for operation and monitor its performance in the network.
This guide may also be useful for application developers who are developing management applications for the router.
Organization
This guide contains the following chapters:
•
Chapter 1, "Cisco CMTS Router MIB Overview," provides background information about SNMP and its implementation on Cisco CMTS routers.
•
Chapter 2, "Configuring SNMP and MIB Support," provides instructions for configuring SNMP management support on the router.
•
Chapter 3, "MIB Specifications," describes each MIB included in the software image. Each description lists any constraints as to how the MIB is implemented on the router.
•
Chapter 4, "Monitoring Notifications," describes the SNMP traps and notifications supported by the router.
•
Appendix A, "Using Cisco CMTS MIBs," describes how to perform common tasks on the router.
•
Appendix B, "Relationship Between MIB Objects and CLI Show Commands," provides a cross-reference between commonly used objects in the MIBs and the related cable-related show commands.
•
Glossary—Glossary provides a list of terms and the definitions.
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS Version 2.0.