Page 1
Cisco Broadband Cable Command Reference Guide January 2005 Corporate Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 526-4100 Text Part Number: OL-1581-09...
Page 2
CCSP, the Cisco Square Bridge logo, Cisco Unity, Follow Me Browsing, FormShare, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, and iQuick Study are service marks of Cisco Systems, Inc.; and Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, Cisco, the Cisco...
C O N T E N T S Preface Document Objectives Audience Document Organization Related Documents Cisco CMTS Hardware Installation and Software Configuration Guides Cisco Cable CPE Hardware Installation and Software Configuration Guides Document Conventions Obtaining Documentation viii Cisco.com viii Ordering Documentation...
Page 4
Contents Cisco CMTS Debugging Commands C H A P T E R Supported Platforms and Cisco IOS Releases Debug Commands Cable CPE Commands C H A P T E R Supported Platforms and Cisco IOS Releases Cable CPE Commands Debug Commands...
– Cisco CVA122 and Cisco CVA122E cable voice adapters. – This guide documents only the cable specific commands. For description of all other Cisco IOS Note commands, see the command reference documentation for Cisco IOS Release 12.2, available on Cisco.com and the Documentation CD-ROM.
Related Documents This section lists the documents that provide more detailed hardware and software information about the Cisco CMTS routers and Cisco Cable CPE devices documented in this guide. These documents are available on Cisco.com and the customer documentation CD-ROM.
• Cisco Cable Modem Termination System Feature Guide • Cisco Cable CPE Hardware Installation and Software Configuration Guides For detailed information about the Cisco cable CPE devices, see the following documents: • Cisco uBR904 Installation and Configuration Guide • Cisco uBR905/uBR925 Software Configuration Guide Cisco uBR905 Hardware Installation Guide •...
Cisco provides several ways to obtain documentation, technical assistance, and other technical resources. These sections explain how to obtain technical information from Cisco Systems. Cisco.com You can access the most current Cisco documentation on the World Wide Web at this URL: http://www.cisco.com/univercd/home/home.htm You can access the Cisco website at this URL: http://www.cisco.com...
24 hours a day, 365 days a year. Accessing all the tools on the Cisco TAC website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a login ID or password, register at this URL: http://tools.cisco.com/RPF/register/register.do...
Obtaining Additional Publications and Information TAC Case Priority Definitions To ensure that all cases are reported in a standard format, Cisco has established case priority definitions. Priority 1 (P1)—Your network is “down” or there is a critical impact to your business operations. You and Cisco will commit all necessary resources around the clock to resolve the situation.
C H A P T E R Supported Platforms and Cisco IOS Releases This chapter identifies the supported platforms and Cisco IOS Releases for the CMTS and cable CPE technologies. The Cable CMTS commands operate on the Cisco uBR7100 series routers, Cisco uBR7200 series routers, and Cisco uBR10012 Cable Modem Termination Systems (CMTS) universal broadband routers.
Page 12
Cisco uBR925 cable access router Release 12.2(2)XA, 12.2(15)T and later 1. The Cisco uBR904 and Cisco uBR924 cable access routers have reached their end-of-life. These routers are being maintained in their respective mainline trains but are not being updated with any new features.
Table 2-1 shows the minimum supported Cisco IOS releases documented at time of this publication. Not all Cisco IOS releases support all Cisco CMTS platforms. See the release notes for each Cisco IOS Note release for details on which platforms are supported.
Page 14
• cable submgmt default • Cisco IOS Release 12.2(15)BC2 Cisco uBR7100 series routers, The 12.2 BC train is the Cisco cable-specific early Cisco uBR7200 series routers, deployment release train that provides DOCSIS 1.1 and Cisco uBR10012 router other new feature support.
Page 21
Related Commands Command Description cable config-file Creates a DOCSIS configuration file and enters configuration file mode. channel-id Specifies upstream channel ID. cpe max Specifies CPE information. Cisco Broadband Cable Command Reference Guide OL-1581-08...
Page 22
Provides config-file options. privacy Specifies privacy options for baseline privacy images. service-class Specifies service class definitions for the configuration file. snmp manager Specifies Simple Network Management Protocol (SNMP) options. timestamp Enables time-stamp generation. Cisco Broadband Cable Command Reference Guide 2-10 OL-1581-08...
Page 23
If the optional enforce keyword has been specified for an enforce-rule, the CMTS automatically switches over-consuming subscribers to the enforced QoS profile (see the enforced qos-profile command). The enforced QoS profile remains in force during the penalty time period (see the penalty- period command). Cisco Broadband Cable Command Reference Guide 2-11 OL-1581-08...
Page 24
Specifies the quality of service (QoS) profile that should be enforced when users violate their assigned QoS profiles. monitoring-duration Specifies the time period and sample rate to be used for monitoring subscribers. Cisco Broadband Cable Command Reference Guide 2-12 OL-1581-08...
Page 25
Displays the quality of service (QoS) enforce-rules that are currently enforce-rule defined. show cable Displays subscribers that are violating their registered quality of service subscriber-usage (QoS) profiles. Cisco Broadband Cable Command Reference Guide 2-13 OL-1581-08...
Page 26
Occasionally, you might want to use the no cable arp and clear arp-cache commands to block out new ARP requests and clear the existing ARP table. In this situation, the Cisco CMTS will retain the ARP addresses of currently online CMs (CMs with a known IP address) and will continue to send ARP requests for those CMs when those ARP entries time out or are cleared, so that those CMs can continue to remain online.
Page 27
The following example shows how to activate cable ARP requests for port 0 on the cable interface line card installed in slot 6, subinterface 1, of the Cisco CMTS: router(config)# interface cable 6/0.1 router(config-subif)# cable arp...
Page 28
Defaults ARP packets are not filtered, which means the Cisco CMTS router accepts all ARP reply packets and sends all ARP request packets. Cisco Broadband Cable Command Reference Guide 2-16...
Page 29
Cable interface configuration Command History Release Modification 12.2(15)BC2 This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012 universal broadband routers. 12.3(9a)BC The values of number and window-size are optional for the the respetive reply-accept and request-send settings. Usage Guidelines Viruses, worms, and theft-of-service attacks can generate a large volume of ARP requests on a cable interface.
Page 30
Displays debugging messages about the filtering of ARP broadcasts. show cable arp-filter Displays the total number of ARP replies and requests that have been sent and received, including the number of requests that have been filtered. Cisco Broadband Cable Command Reference Guide 2-18 OL-1581-08...
You must specify all generic IP networking information (IP address, routing protocols, switching • modes, and so on) on the bundle master interface. Do not specify generic IP networking information on bundle slave interfaces. Cisco Broadband Cable Command Reference Guide 2-19 OL-1581-08...
Page 32
If you have configured an IP address on a bundled interface and the interface is not the master • interface, a warning message appears. Do not create subinterfaces on a slave interface. In Cisco IOS Release 12.2(15)BC2 and later • releases, this is specifically prohibited. In prior releases, a warning message appeared when trying to create a subinterface on a slave interface, but the subinterface was still created.
Page 33
Layer 3 IP information on the interface, before cable modems can resume communicating on that interface. Related Commands Command Description show cable bundle Displays the forwarding table for the specified interface bundle. Cisco Broadband Cable Command Reference Guide 2-21 OL-1581-08...
Page 34
This command supports the Cisco CMTS clock feature set, which provides a synchronized clock for improved Voice-over-IP (VoIP) operations. The clock feature set requires one of the following configurations: A Cisco uBR10012 router with one or two TCC+ cards that are connected to an external national • clock source.
Page 35
Cisco CMTS Configuration Commands cable clock clear-counters Each CM or STB must also support VoIP applications and the clock feature set. For example, the Cisco uBR924, running Cisco IOS Release 12.0(7)T or later releases, supports the clock card feature automatically. show controllers clock-reference...
Page 36
CMs or set-top boxes (STBs) attached to the specific network segments. You can use other cable interface cards, such as the Cisco uBR-MC16C, with the clock card, but these other cable interfaces will not synchronize their downstream SYNC messages with the external clock source.
Page 37
Cisco CMTS Configuration Commands cable clock force Each CM or STB must also support VoIP applications and the clock feature set. For example, the Cisco uBR924, running Cisco IOS Release 12.0(7)T or later releases, supports the clock card feature automatically. Examples...
Page 38
CMs or set-top boxes (STBs) attached to the specific network segments. You can use other cable interface cards, such as the Cisco uBR-MC16C, with the clock card, but these other cable interfaces will not synchronize their downstream SYNC messages with the external clock source.
Page 39
Chapter 2 Cisco CMTS Configuration Commands cable clock source-midplane Related Commands Command Description show cable clock Displays status information for the cable clock card. Cisco Broadband Cable Command Reference Guide 2-27 OL-1581-08...
Page 40
MIB. By default, the Cisco CMTS uses the current list if it is less than 3 minutes old. If the current list is older than 3 minutes, the Cisco CMTS considers it invalid and rebuilds a new list. This prevents the CMTS from having to build a new list for every query, which could impact system performance.
Page 41
If CPU usage dramatically increases when performing SNMP queries of the cdxCmCpeTable table, use this command to increase the valid list time so that the Cisco CMTS does not have to rebuild the CM/CPE list more often than needed to respond to the queries.
Page 42
The DOCSIS specification defines the format of the DOCSIS configuration files, which can be created by any number of tools. In addition to the other tools that Cisco provides for this purpose, the cable config-file command can be used to create the DOCSIS configuration files needed for your network.
Page 43
The following is a portion of a typical Cisco IOS configuration file that shows the above two DOCSIS configuration files, as well as a typical DHCP server configuration: router# show running-config service udp-small-servers max-servers no-limit cable time-server cable config-file test.cm...
Page 44
For complete information on DOCSIS configuration files, see Appendix C in the DOCSIS 1.1 Radio Note Frequency (RF) Interface Specification, available on the DOCSIS Cable Labs official web site at http://www.cablemodem.com/specifications.html. Cisco Broadband Cable Command Reference Guide 2-32 OL-1581-08...
Page 45
DCI-REQ messages and then restarts this process when it receives the twelfth DCI-REQ message. Defaults The Cisco CMTS responds to DCI-REQ messages from all CMs by sending a DCI-RSP response with the confirmation code of Success (0). Command Modes...
Page 46
Configures the cable interface so that it transmits an Upstream Transmitter Disable (UP-DIS) message instead of a DCI-RSP message to a particular CM. debug cable dci Enables debugging of DCI-REQ, DCI-RSP, and UP-DIS messages. Cisco Broadband Cable Command Reference Guide 2-34 OL-1581-08...
Page 47
CM sends a DCI-REQ message, the CMTS responds by sending an UP-DIS response. disable Disables the sending of UP-DIS messages to a particular CM. Defaults The Cisco CMTS does not transmit UP-DIS messages to any CMs. Command Modes Interface configuration (cable interface only) Command History Release Description 12.1(4)CX...
Page 48
Related Commands Command Description cable dci-response Configures how the cable interface responds to DCI-REQ messages from CMs on that interface. debug cable dci Enables debugging of DCI-REQ, DCI-RSP, and UP-DIS messages. Cisco Broadband Cable Command Reference Guide 2-36 OL-1581-08...
Page 49
Command Modes Interface configuration (cable interface only) Command History Release Modification 12.2(8)BC1 This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers. 12.2(15)BC2 This command is superceded by the cable upstream fragment-force command. Usage Guidelines The DOCSIS 1.0 specification allows CMs to register without specifying a maximum upstream burst...
Page 50
Router(config-if)# The following example shows the default maximum burst size to 0, which means that a CM must specify a valid burst profile before the Cisco CMTS allows it to register and come online: Router(config)# interface cable 5/1 Router(config-if)# cable default-phy-burst 0...
Page 51
To remove an access group, use the no access-group option of this command. cable device {ip-address | mac-address} [no] access-group {access-list | access-name} | {[vrf vrf-name] ip-address [no] access-group [access-list | access-name]} The cable device command is not supported on the Cisco uBR10012 universal broadband router. Note Syntax Description ip-address IP address for the device.
Page 52
Clears the host from the table. show cable device access-group Display the CMs and the hosts behind the CMs on the network. show cable host access-group Displays the hosts behind the CMs on the network. Cisco Broadband Cable Command Reference Guide 2-40 OL-1581-08...
Page 53
GIADDR IP address as the source IP address in the forwarded DHCP OFFER packet. By default when using the policy option, the Cisco CMTS changes the source IP address in the DHCPOFFER packet to match that of the primary address on the cable interface. Use the strict option to...
Page 54
[strict] command. Caution You cannot use the strict option with the internal DHCP server that is onboard the Cisco CMTS router, because the strict option requires the use of DHCP relay operation, which is not performed by DHCP termination points such as the internal DHCP server.
Page 55
Enables the system to insert the CM MAC address into a option DHCP packet received from a CM or host and forward the packet to a DHCP server. ip dhcp smart-relay Monitors client retransmissions when address pool depletion occurs. Cisco Broadband Cable Command Reference Guide 2-43 OL-1581-08...
Page 56
1 to 4095, with no default. The switches acting as the bridge aggregators might support a lower Note number of VLAN IDs. If so, the Cisco CMTS should be configured within the limits of the switches’ maximum number of VLANs. cust-name (Optional) Identifies the customer using this VLAN.
Page 57
Displays debugging messages for the Layer 2 mapping of cable modems to particular PVCs or VLANs. show cable l2-vpn Displays the mapping of one or all cable modems to VLANs on the router’s dot1q-vc-map Ethernet interfaces. Cisco Broadband Cable Command Reference Guide 2-45 OL-1581-08...
On the Cisco uBR-MC16U and Cisco uBR-MC28U (with integrated upconverter), the IF frequency is fixed at 44 MHz for both Annex A and Annex B modes of operation. On the Cisco uBR-MC16X and Cisco uBR-MC28X (without integrated upconverter), the IF frequency is set to 36.125 MHz in Annex A mode and 44 MHz in Annex B mode.
Page 59
This command can be used to change the symbol rate, alpha, and other parameters for compliance with Note EuroDOCSIS (annex A), or DOCSIS (annex B). Annex A is not supported on the Cisco uBR-MC1xC, Cisco uBR-MC16B, Cisco uBR-MC16S, and Cisco uBR-MC28C cable interface line cards. Annex B is not supported on the Cisco uBR-MC16E card and on the Cisco uBR7111E and Cisco uBR7114E universal broadband routers.
Page 60
Use this command to make sure that each downstream channel has a unique ID when there are multiple Cisco CMTS routers at a headend facility. Cisco IOS assigns the default ID number of each downstream channel in the order in which devices connected to the downstream channels appear to the CMTS. The downstream channel connected to the first device that appears to the CMTS is configured with a default ID of 1, the downstream channel connected to the second device that appears is configured with an ID of 2, and so on.
The no form of this command is supported only on the Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, Note and Cisco uBR-MC5X20S/U cable interface line cards, and on the Cisco uBR7100 series universal broadband router.
Page 62
Usage Guidelines This command is either optional or required, depending on the cable interface line card being used. On the Cisco uBR7100 series routers using the integrated upconverter (the DS0 RF output), and on • cable interfaces that support integrated upconverters (such as the Cisco uBR-MC16U, Cisco uBR-MC28U, and Cisco uBR-MC5X20U), this command configures the frequency for the integrated upconverter.
Page 63
Enables or disables the RF output from the integrated upconverter. shutdown show controllers cable Displays status and configuration information for the cable interface. On supported cable interfaces, this includes information about the integrated upconverter. Cisco Broadband Cable Command Reference Guide 2-51 OL-1581-08...
Page 64
• interface. The interface remains shut down until you reactive the downstream using the cable downstream if-output command. Cisco Broadband Cable Command Reference Guide 2-52 OL-1581-08...
Page 65
(the signals are verified by a spectrum analyzer...) router#(config-if)# no cable downstream if-output (the downstream is checked to verify no signals are being sent on it...) router#(config-if)# cable downstream if-output router#(config-if)# exit router#(config)# Cisco Broadband Cable Command Reference Guide 2-53 OL-1581-08...
Page 66
This command was modified to support Annex A operation (which uses a 12.(0)SC,12.1(2)EC1 fixed interleave). This command is not supported on the Cisco uBR-MC16E cable interface line card or on the Note Cisco uBR7111E and Cisco uBR7114E universal broadband routers, because the interleave on the EuroDOCSIS downstream is fixed.
Page 67
However, on cable plants with exceptionally low noise levels, Cisco recommends initially using the default value of 32, and then trying an interleave of either 16 or 8 to see if this increases performance without increasing the number of errors that result from noise.
Examples The following example shows how to set the downstream modulation to 256-QAM: Router# configure terminal Router(config)# interface cable 3/0 Router(config-if)# cable downstream modulation 256qam Router(config-if)# Cisco Broadband Cable Command Reference Guide 2-56 OL-1581-08...
Page 69
Because frequency override is enabled by default, this command does not appear as part of a cable Note interface’s configuration section in the Cisco CMTS configuration file unless the no cable downstream override command has been given. Examples...
Page 70
Valid values are from 1 to 4. Defaults In Cisco IOS Release 12.1 EC and earlier releases, the system defaults to monitoring the traffic to and from each CM over each 1-second period, and if the CM exceeds its bandwidth quota for that second, the CMTS drops packets for the rest of the second (no cable downstream rate-limit).
Page 71
84 kbps. If you are using a 64 kbps downstream traffic rate on a Cisco CMTS that is running Cisco IOS Release 12.2 BC, you should set the max-delay option to 256 milliseconds to avoid a performance impact on TCP/IP traffic that uses packets larger than 1024 bytes (such as FTP or HTTP web traffic).
Page 72
For more information about the DOCSIS 1.1 rate-limiting specifications, see section C.2.2.5.2, Maximum Sustained Traffic Rate, in the DOCSIS 1.1 specification. Examples The following example shows how to apply the token-bucket filter algorithm on a Cisco uBR7200 series router running Cisco IOS Release 12.1 EC: Router(config)# interface cable 6/0...
Page 73
To set the RF power output level on an integrated upconverter on the Cisco uBR7100 series router, Cisco uBR-MC16U, Cisco uBR-MC28U or Cisco uBR10-MC5X20S/U cable interface line card, use the cable downstream rf-power command in cable interface configuration mode. To reset the RF output power level to its default value, use the no form of this command.
Page 74
Working interface configuration, and then download that configuration to the router from the TFTP server. Take care that if you manually edit Cisco IOS configuration files that you specify these options only on Protect interfaces. If you specify the hccp-delta or hccp-override option on a Working interface, the router will modify the configured downstream power with the given power delta or override value.
Page 75
Enables or disables the RF output from the integrated upconverter. shutdown debug cable upconverter Enables debugging of the internal upconverter operation. show controllers cable Displays status and configuration information for the cable interface, including the integrated upconverter, if present. Cisco Broadband Cable Command Reference Guide 2-63 OL-1581-08...
Page 76
The cable interface must be enabled using the no shutdown command on the cable interface. • This command does not affect the IF output from the DS0 downstream port on the Cisco uBR7100 series Note router. The Cisco uBR10-MC5X20S/U, Cisco uBR-MC16U, and Cisco uBR-MC28U cable interface line cards do not provide IF output for their downstream ports.
Page 77
Cisco CMTS Configuration Commands cable downstream rf-shutdown Examples The following example enables the integrated upconverter on the Cisco uBR7100 series router: router(config)# cable interface 1/0 router(config-if)# no cable downstream rf-shutdown The following example enables the second integrated upconverter on a Cisco uBR-MC5X20S cable...
Page 78
Command History Release Modification 12.2(15)BC2 This command was introduced for the Cisco uBR7100 series and Cisco uBR7246VXR routers. Usage Guidelines This command enables DSG operations on the cable interface, creating a DSG tunnel that uses the specified IGMP multicast address and well-known MAC address. If you specify a tunnel MAC address of 0.0.0, the command converts it into an Ethernet multicast MAC address, using the following...
Page 79
• operations, using the ip multicast rate-limit out group-list command. For best performance, fast switching of IP multicast should be enabled on incoming and outgoing • interfaces, using the ip mroute-cache command. Cisco Broadband Cable Command Reference Guide 2-67 OL-1581-08...
Page 80
DSG operations, DSG traffic does not continue after a switchover. Examples The following example shows how to configure a cable interface on a Cisco uBR7246VXR router to enable the DSG feature on cable interface 3/0, using a well-known MAC address of 0001.0002.0003 and a destination IP address of 225.2.3.4:...
Page 81
Router(config-if)# end Router# The following example shows the error message that appears when a unicast IP address is specified instead of a multicast IP address: Router(config-if)# cable dsg 1.1.1 172.68.13.10 cisco Only multicast is supported for current version. Router(config-if)# Related Commands...
Page 82
Cisco uBR7246VXR routers. Usage Guidelines By default, the Cisco CMTS does not send keepalive messages on any DSG tunnels. When keepalives are enabled using the cable dsg keepalive command, the Cisco CMTS sends one keepalive message each second on each DSG tunnel on each downstream. In Cisco IOS Release 12.2(15)BC2, the keepalive packet is a null packet.
Page 83
Resets counters related to DOCSIS Set-Top Gateway (DSG) tunnels. debug cable dsg Enables the display of debugging messages for the operation of the DOCSIS Set-Top Gateway (DSG) feature. show cable dsg Displays the current DOCSIS Set-Top Gateway (DSG) tunneling parameters. Cisco Broadband Cable Command Reference Guide 2-71 OL-1581-08...
Page 84
(Optional) Specifies that the filename for DOCSIS configuration files should not be encrypted when the Cisco CMTS sends the files to CMs. The CMTS instead transmits the files using their original filenames. The nocrypt option slightly decreases the security provided by the...
Page 85
If these shared secrets are configured, the Cisco CMTS continues to use them to validate the original DOCSIS configuration file that is downloaded from the TFTP server. If the DOCSIS Cisco Broadband Cable Command Reference Guide...
Page 86
Do not use the cable dynamic-secret command along with the ip tftp-source command in Cisco IOS Release 12.2(15)BC1, because this could result in certain models of CMs not being able to come online but instead be stuck in the init(o) state. This restriction is removed in Cisco IOS Release 12.2(15)BC2 and later releases.
Page 87
By default, the cable dynamic-secret command encrypts the original filename for a DOCSIS configuration file when the Cisco CMTS transmits the file to the CM. This filename changes in a semi- random manner, making it difficult for users to predict the filename for the file that should be downloaded to the CM.
Page 88
• Examples The following example shows how to configure a cable interface on a Cisco uBR7200 series router with the mark option, so that CMs that fail the MIC verification are allowed to register but are marked in the show cable modem displays so that their situation can be further investigated:...
Page 89
%Profile qos-id to lock modem does not exist The following example shows how to configure a cable interface on a Cisco uBR7200 series router, so that CMs that fail the MIC verification are not allowed to register and must reregister with a valid...
Page 90
CM undergoing the same state changes. The following describes the relationship between these commands and the attributes in the CISCO-DOCS-EXT-MIB MIB: The cable enable-trap cmonoff-notification command sets the cdxCmtsCmOnOffTrapEnable •...
Page 92
To configure the event reporting flags for DOCSIS event messages, which determines how the Cisco CMTS reports these events, use the cable event priority command in global configuration mode. To return to the default settings found in the MIB, use the no form of this command.
Page 93
DOCS-CABLE-DEVICE-MIB (RFC 2669) with the same value. This command affects only the DOCSIS event messages, and does not affect how the Cisco IOS software Note handles event messages. If SYSLOG traps are enabled on the Cisco CMTS (using the snmp-server enable traps syslog command), they continue to be sent, regardless of the cable event priority configuration.
Page 94
Chapter 2 Cisco CMTS Configuration Commands cable event priority The following commands configure the Cisco CMTS so that it reports the lowest priority messages only to the local volatile log and SYSLOG server: Router# configure terminal Router(config)# cable event priority debug 0x30...
Page 95
Cisco CMTS begins generating event messages that conform to the DOCSIS 1.1 specifications. This format is similar to but not identical to the format that is used by the Cisco IOS software. For example, the following message is in the typical Cisco IOS format: %UBR7200-4-DCC_ACK_REJ_MSG_SYNTAX_ERROR: DCC-ACK rejected message syntax error The same error message appears as follows when using the DOCSIS 1.1 format:...
Page 96
Cisco CMTS Configuration Commands cable event syslog-server You can use the same SYSLOG server for both Cisco IOS event messages and for DOCSIS-style event Note messages, but it might be more convenient to use separate servers for the two different message formats.
Page 98
To configure how the Cisco CMTS throttles the SNMP traps and SYSLOG messages it generates for DOCSIS event messages, use the cable event throttle-adminStatus command in global configuration mode. To restore the default behavior, use the no form of this command.
Page 99
Router(config)# cable event throttle adminStatus maintainBelowThreshold Router(config)# The following commands configure the Cisco CMTS for the default behavior, so that it does not throttle SNMP traps and SYSLOG messages. The configured throttle interval and threshold are ignored. Router# configure terminal...
Page 100
Cisco CMTS can generate during that period. The threshold value counts DOCSIS events, not SNMP traps or SYSLOG messages. If a DOCSIS event generates both an SNMP trap and a SYSLOG message, the Cisco CMTS counts it as only one event. cable event throttle-interval...
Page 101
Cisco CMTS Configuration Commands cable event throttle-interval Examples The following commands configure the Cisco CMTS so that it can generate a maximum number of 30 SNMP traps and SYSLOG messages for DOCSIS events over a 90-second period: Router# configure terminal...
Page 102
Cisco CMTS can generate during that period. The threshold value counts DOCSIS events, not SNMP traps or SYSLOG messages. If a DOCSIS event generates both an SNMP trap and a SYSLOG message, the Cisco CMTS counts it as only one event. cable event throttle-interval...
Page 103
Cisco CMTS router, see the Cisco CMTS Error Message manual. Examples The following commands configure the Cisco CMTS so that it can generate a maximum number of 25 SNMP traps and SYSLOG messages for DOCSIS events over a two-minute period:...
Page 104
ANDing the tos-mask with the packet’s actual TOS value. The filter considers it a match if the two values are the same. The default values for both parameters matches all ToS values. Note Cisco Broadband Cable Command Reference Guide 2-92 OL-1581-08...
Page 105
12.1(6)EC1 This command was introduced on the Cisco uBR7100 series and Cisco uBR7200 series routers. 12.2(2)XF, 12.2(4)BC1 This command was supported on the Cisco uBR10012 routers. 12.2(8)BC2 The status option was added to allow filter groups to be activated and deactivated without removing the filter group’s configuration.
Page 106
If the two values are the same, the filter matches the packet. See the description of the docsSubMgtPktFilterTable table in this MIB for further information. DOCS-SUBMGT-MIB MIB is supported only on Cisco IOS Release 12.2(8)BC2 and later 12.2 BC Note releases.
Page 107
Flapping refers to the rapid disconnecting and reconnecting of a CM that is having problems holding its connection to the CMTS. A flap list is a table maintained by the Cisco CMTS for every modem (active or not) that is having communication difficulties. The flap list contains modem MAC addresses and logs the time of the most recent activity.
Page 108
Sends a DOCSIS ping to a CM and increments the flap-list counters as appropriate. show cable flap-list Displays the current contents of the flap list. Cisco Broadband Cable Command Reference Guide 2-96 OL-1581-08...
Page 109
Specifies the number of days to keep a CM in the flap-list table before aging it out of the table. cable flap-list miss- Specifies miss threshold for recording a flap-list event. threshold Cisco Broadband Cable Command Reference Guide 2-97 OL-1581-08...
Page 110
Sends a DOCSIS ping to a CM and increments the flap-list counters as appropriate. show cable flap-list Displays the current contents of the flap list. Cisco Broadband Cable Command Reference Guide 2-98 OL-1581-08...
Page 111
RF plant problems, such as intermittent upstream problems, fiber laser clipping, or common-path distortion. Examples The following example shows how to set the miss threshold to 5: Router(config)# cable flap-list miss-threshold 5 Cisco Broadband Cable Command Reference Guide 2-99 OL-1581-08...
Page 112
Sends a DOCSIS ping to a CM and increments the flap-list counters as appropriate. show cable flap-list Displays the current contents of the flap list. Cisco Broadband Cable Command Reference Guide 2-100 OL-1581-08...
Page 113
This command controls the operation of a flapping modem detector. When the power adjustment of a CM exceeds the configured threshold value, the modem is placed in the flap list. A power adjustment threshold of less than 2 dB might cause excessive flap-list event recording. Cisco Note recommends setting this threshold value to 3 dB or higher.
Page 114
Sends a DOCSIS ping to a CM and increments the flap-list counters as appropriate. show cable flap-list Displays the current contents of the flap list. Cisco Broadband Cable Command Reference Guide 2-102 OL-1581-08...
Page 115
Clears all the entries in the flap-list table. debug cable flap Displays information about the operation of the CM flap list that is maintained for the cable interfaces. Cisco Broadband Cable Command Reference Guide 2-103 OL-1581-08...
Page 116
Command Description ping docsis Sends a DOCSIS ping to a CM and increments the flap-list counters as appropriate. show cable flap-list Displays the current contents of the flap list. Cisco Broadband Cable Command Reference Guide 2-104 OL-1581-08...
Page 117
To configure the Cisco CMTS router for the range of frequencies that are acceptable on upstreams, use the cable freq-range command in global configuration mode. To restore the default value (which is based on the cable interface and on the Annex A/B configuration), use the no form of this command.
Page 118
You must configure the downstream for Annex A for EuroDOCSIS operations and Annex B for DOCSIS operations. You can configure certain cable interface cards (such as the Cisco uBR-MC28U) for both the DOCSIS Annex B mode and the EuroDOCSIS frequency range, but this violates the DOCSIS specifications and should not be used on standard DOCSIS networks.
Page 119
Return Frequency in HZ Router(config-if)# The following example shows how to configure the Cisco CMTS router to support the extended Japanese upstream frequency range of 5 MHz to 55 MHz. The router then displays a list of the cable interface line cards, if any, that do not support this range.
Page 120
The following example shows all of the commands that are needed to configure the cable interface and upstream on a Cisco uBR-MC28U/X cable interface line card to support a frequency in the EuroDOCSIS upstream frequency range of 5 MHz to 65 MHz:...
Page 121
DOCSIS networks to allow separate helper addresses for CMs and hosts. Use only the cable helper-address command on cable interfaces, and use the ip helper-address command on all non-cable interfaces. Cisco Broadband Cable Command Reference Guide 2-109 OL-1581-08...
Page 122
You can repeat this command to specify any number of helper addresses, but the Cisco IOS software uses only the first 16 valid addresses that are configured on each interface (using either the cable helper- address command or the ip helper-address command) when forwarding DHCP requests.
Page 123
Enables the system to insert the CM MAC address into a DHCP option packet received from a CM or host and forward the packet to a DHCP server. ip dhcp smart-relay Monitors client retransmissions when address pool depletion occurs. Cisco Broadband Cable Command Reference Guide 2-111 OL-1581-08...
Page 124
{ip-address | mac-address} no access-group The cable host command, and its SNMP equivalent, cdxCmCpeAccessGroup, are not supported on the Note Cisco uBR10012 universal broadband router. On this router, use the standard DOCSIS MIB, DOCS-SUBMGT-MIB, instead. Syntax Description ip-address IP address for the device.
Page 125
Clears the host from the table. show cable device access-group Display the CMs and the hosts behind the CMs on the network. show cable host access-group Displays the hosts behind the CMs on the network. Cisco Broadband Cable Command Reference Guide 2-113 OL-1581-08...
Page 126
Usage Guidelines Use this command to specify the minimum and maximum duration between initial ranging opportunities that appear in MAP messages sent by the Cisco CMTS. MAP messages define the precise time intervals during which CMs can send. The default insertion interval setting (automatic) configures the Cisco CMTS to optimize the initial ranging times available to new CMs that attempt to join the network.
Page 127
Router(config-if)# cable insertion-interval 100 Router(config-if)# Related Commands Command Description cable upstream data-backoff Specifies automatic or fixed start and stop values for data backoff. cable upstream range- Specifies automatic or configured initial ranging backoff backoff calculation. Cisco Broadband Cable Command Reference Guide 2-115 OL-1581-08...
Page 128
An IP route to the specified IP address must exist, and IP connectivity to that device must be present for the traffic to be captured. Before Cisco IOS Release 12.1(11b)EC, the data collecting system must be within two routing hops of the Cisco CMTS.
Page 129
This command cannot be used on subinterfaces. To monitor traffic on a subinterface, configure the cable intercept command on the main interface, and the Cisco CMTS router will match on the packets’ MAC address to filter the appropriate traffic.
Page 130
Support was added for the Cisco uBR7100 series routers. Usage Guidelines By default, broadcast IP packets that arrive on the upstream at the Cisco CMTS are not forwarded on the downstream ports so that they would be delivered to the other CMs and CPE devices. This behavior prevents broadcast storms in which such packets are repeatedly looped through the network.
Page 131
Chapter 2 Cisco CMTS Configuration Commands cable ip-broadcast-echo Related Commands Command Description cable ip-multicast-echo Enables IP multicast echo so that the Cisco CMTS can echo multicast packets. Cisco Broadband Cable Command Reference Guide 2-119 OL-1581-08...
Page 132
To enable IP multicast echo so that the Cisco CMTS can echo multicast packets, use the cable ip- multicast-echo command in cable interface or subinterface configuration mode. To disable IP multicast echo, use the no form of this command.
Page 133
The following example shows how to enable IP multicast echo in the cable subinterface configuration mode: router(config)# interface cable 6/0.1 router(config-subif)# cable ip-multicast-echo Related Commands Command Description cable ip-broadcast-echo Enables upstream IP broadcast echo so that the Cisco CMTS can echo broadcast packets. Cisco Broadband Cable Command Reference Guide 2-121 OL-1581-08...
Page 134
Command History Release Modification 12.2(11)BC3 This command was introduced for Cisco uBR7100 series and Cisco uBR7200 series routers. Usage Guidelines This command enables the use of Layer 2 tunnels on all cable and ATM interfaces in the router—which in turn allows you to map cable modems, on the basis of their hardware (MAC) addresses, to particular PVCs on an ATM interface—using the...
Page 135
Command History Release Modification 12.2(15)BC2 This command was introduced for Cisco uBR7246VXR universal broadband routers. Usage Guidelines This command enables the use of Layer 2 tunnels, using IEEE 802.1Q VLAN tagging, on all cable interfaces in the router. This in turn allows you to map traffic to and from cable modems, on the basis of the modems’...
Page 136
Displays debugging messages for the Layer 2 mapping of cable modems to particular PVCs or VLANs. show cable l2-vpn Displays the mapping of one or all cable modems to IEEE 802.1Q Virtual dot1q-vc-map Local Area Networks (VLANs) on the router’s Ethernet interfaces. Cisco Broadband Cable Command Reference Guide 2-124 OL-1581-08...
Page 137
Command History Release Modification 12.2(15)BC1 This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012 routers. Usage Guidelines The cable load-balance exclude command allows you to specify that particular cable modems should not participate in one or more types of load-balancing operations. This might be done for cable modems that are currently provisioned for premium services, for cable modems that do not respond appropriately to upstream channel change (UCC) or channel override messages, or for other reasons.
Page 138
• proper target channel in the Downstream Frequency Override or an Upstream Channel ID Override field in the registration response (REG-RSP) message that the Cisco CMTS sends to the cable modem. This is the default form of registration-based load balancing.
Page 139
Configures the frequency of the load-balancing policy updates. group interval cable load-balance Configures how the Cisco CMTS should load balance cable modems with group policy ugs active unsolicited grant service (UGS) service flows. cable load-balance Configures the threshold values that a load-balance group should use for group threshold load-balancing operations.
Page 140
(modem option). Note If you do not create any load-balance groups, the Cisco CMTS defaults to using a form of registration- based load balancing that attempts to equally distribute cable modems among upstreams at the time the cable modems register and come online.
Page 141
The cable load-balance command creates a load-balance group, which can then be assigned to a number of upstream and downstream cable interfaces to allow the Cisco CMTS to load balance cable modems as needed. The Cisco CMTS can use the load-balance groups for static, passive, and dynamic load balancing of both upstream and downstream channels.
Page 142
1.6 MHz and the other upstream is configured for a channel width of 3.2 MHz, the Cisco CMTS allocates twice as many SFIDs to the second upstream, because its channel width is twice as large as the first upstream’s channel width.
Page 143
Examples The following example shows how to create a load-balance group numbered 10, using the default method of modem, which specifies that the Cisco CMTS uses the actual number of cable modems that are online to determine load-balancing operations. Router# config terminal...
Page 144
Assigns an upstream to a load-balance group. balance group clear cable load- Clears the counters or state machine used to track load-balancing balance operations. show cable load- Displays real-time statistical and operational information for load- balance balancing operations. Cisco Broadband Cable Command Reference Guide 2-132 OL-1581-08...
Page 145
Command Modes Interface configuration (cable interface only) Command History Release Modification 12.2(15)BC1 This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012 routers. Usage Guidelines After you have used the cable load-balance group (global configuration) command to initially create...
Page 146
This command is informational-only on cable interfaces that use an external upconverter, but it is required for load balancing, so that the Cisco CMTS knows where to move cable modems when it is load balancing downstreams.
Page 147
Cisco uBR10012 routers. Usage Guidelines To properly perform load balancing, the Cisco CMTS must determine the actual load on an interface on a periodic basis. This frequency of the updates also determines how frequently cable modems can be moved to achieve balanced loads. One cable modem, at most, is moved during each update period.
Page 148
Assigns a downstream to a load-balance group. group (interface configuration) cable load-balance Configures how the Cisco CMTS should load balance cable modems with group policy ugs active unsolicited grant service (UGS) service flows. cable load-balance Configures the threshold values that a load-balance group should use for group threshold load-balancing operations.
Page 149
To avoid this, the default configuration (cable load-balance group policy ugs) of this command allows the Cisco CMTS to move cable modems to a new upstream or downstream, even if they have active UGS service flows. This enables the Cisco CMTS to perform optimum load balancing, but it could cause a momentary interruption in the voice call—users on the voice call might hear a momentary drop during...
Page 150
Router# config terminal Router(config)# cable load-balance group 13 policy ugs Router(config)# The following example shows how to configure a load-balance group so that the Cisco CMTS does not move cable modems with active UGS service flows (default configuration): Router# config terminal...
Page 151
Specifies the maximum load difference, as expressed in a percentage of total load, that can exist between interfaces in a load-balance group before the Cisco CMTS performs load balancing. If the load between interfaces is greater than the value specified by load-value, cable modems that are registering are assigned to the lesser-utilized interface until the load difference is once again below this value.
Page 152
10 percent, which means that two upstreams or two downstreams can have usage rates that vary up to 10 percent before the Cisco CMTS begins rebalancing the load usage. This rebalancing, however, is done only when cable modems first register with the Cisco CMTS—the Cisco CMTS does not switch cable modems that are already online.
Page 153
Cisco CMTS begins moving calls. For example, if the band-value threshold is at its default of 70 percent, the Cisco CMTS does not begin moving cable modems with active UGS service flows until UGS usage on an upstream or downstream reaches 70 percent of the total available bandwidth.
Page 154
30 percent or more. The Cisco CMTS will also begin moving cable modems with active UGS service flows when UGS service flows reach 60 percent of the total bandwidth available on the upstream channel.
Page 155
Cisco CMTS generates a BADIPSOURCE error message in the console logs. In previous Cisco IOS releases, the Cisco CMTS generated these particular error messages for every IP packet that contained a bad IP source address. This can create a large volume of error messages that can make it difficult to see other error messages in the console logs.
Page 156
Be cautious when specifying the buffer size, because the Cisco CMTS could run out of memory for other Note tasks.
Page 157
Removes all error messages about bad IP source addresses on the cable interfaces from the error log buffer. show cable logging Displays the log of error messages about bad IP source addresses on the cable interfaces. Cisco Broadband Cable Command Reference Guide 2-145 OL-1581-08...
Page 158
Syntax Description This command has no additional arguments or keywords. Defaults DOCSIS events are saved to the general logging buffer on the Cisco CMTS by default. Command Modes Global configuration mode Command History Release Modification 12.3(9a)BC...
Page 159
CM is now offline, so that the MAP advance algorithm can be updated accordingly. 12.2(8)BC1 The range for the max-delay option was changed to the current values of between 100 and 2000 microseconds. Cisco Broadband Cable Command Reference Guide 2-147 OL-1581-08...
Page 160
(!) next to its offset value in the show cable modem display. In dynamic MAP operation, Cisco IOS 12.1(10)EC also implements a regular polling of the furthest CM, to determine if that CM is now offline. If the furthest CM has gone offline, the CMTS scans the currently online CMs to determine which CM is now the furthest offline and updates the dynamic MAP advance algorithm with the new value.
Page 161
12.0(6)SC, 12.1(2)EC1 Support was added on the Cisco IOS 12.0 SC and 12.1 EC release trains. Usage Guidelines The Cisco CMTS uses three commands set the maximum number of hosts for a particular CM, for all CMs on a particular cable interface, or for all CMs using the Cisco CMTS router: cable modem max-hosts—Sets the maximum number of hosts for a particular CM.
Page 162
Changes the downstream frequency or upstream channel ID. frequency cable modem max-cpe Sets the maximum number of hosts for all CMs using the Cisco CMTS router. cable modem max- Sets the maximum number of hosts for a particular CM.
Page 163
This command is not available for cable subinterfaces. For additional information on configuring for multicast operations, see the chapters on IP Multicast in the Release 12.2 Cisco IOS IP Configuration Guide and in Volume 3 of the Cisco IOS IP Command Reference.
Page 164
The following example shows how to specify that the multicast stream defined by the access list number 102 be encrypted: router(config)# interface c3/0 router(config-if)# cable match address 102 Related Commands Command Description ip access-list Defines an IP access list by name. Cisco Broadband Cable Command Reference Guide 2-152 OL-1581-08...
Page 165
EXEC mode. To disable the specification, use the no access-group form of this command. cable modem {mac-addr | ip-addr} access-group [access-list | access-name] cable modem {mac-addr | ip-addr} no access-group The cable modem access-group command is not supported on the Cisco uBR10012 universal Note broadband router.
Page 166
Command Description cable modem max- Specifies the maximum hosts for a CM. hosts cable modem qos Specifies the QoS profile for a CM. profile show cable modem Displays CM configuration settings. Cisco Broadband Cable Command Reference Guide 2-154 OL-1581-08...
Page 167
This command was introduced. Usage Guidelines This command allows the CMTS administrator to change the downstream frequency for a CM, overriding the DOCSIS configuration file setting. This command is not applicable on Cisco IOS Release 12.1(3a)EC. Examples The following example shows how to change the downstream frequency of the CM having IP address 172.172.172.12 to 570 MHz:...
Page 168
DHCP server. The Cisco CMTS uses three commands set the maximum number of hosts for a particular CM, for all CMs on a particular cable interface, or for all CMs using the Cisco CMTS router: cable modem max-hosts—Sets the maximum number of hosts for a particular CM.
Page 169
For more information on how these commands interact to set the maximum CPE values, see the chapter Maximum CPE or Host Parameters for the Cisco Cable Modem Termination System in the Cisco CMTS Feature Guide, available on Cisco.com and the Documentation CD-ROM.
Page 170
This command was introduced. Usage Guidelines The Cisco CMTS uses three commands set the maximum number of hosts for a particular CM, for all CMs on a particular cable interface, or for all CMs using the Cisco CMTS router: cable modem max-hosts—Sets the maximum number of hosts for a particular CM.
Page 171
Sets the maximum number of hosts for all CMs on a particular cable interface. cable modem max-cpe Sets the maximum number of hosts for all CMs using the Cisco CMTS router. cable modem qos Specifies the QoS profile for a CM.
Page 172
Specifies the MAC address for the CM. qos-profile-index Specifies QoS profile index values. The valid range is 1 to 255, with no default. In Cisco IOS Release 12.2(15)BC1 and later releases, this profile must be created on the Cisco CMTS using the cable qos profile command.
Page 173
(the CM will return to using its registered profile.) When the no-persistence option is specified, the QoS profile is not applied when a cable modem reboots. Instead, the Cisco CMTS allows the cable modem to use the QoS profile that is specified in its DOCSIS configuration file.
Page 174
With Cisco IOS Release 12.2BC and 12.1EC, difficulty has been observed when attempting to remove the remote-query feature from the Cisco CMTS. The no form of this command does not remove the cable modem remote-query once configured on the Cisco CMTS. This restriction applies to Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers, and is being tracked as caveat number CSCdy10666.
Page 175
It does not indicate how long the Cisco CMTS spends in each polling cycle, which depends on the number of cable modems being polled. To calculate the approximate time for a polling cycle, assume 4 to 5 CMs per second (100 to 200 milliseconds per CM).
Page 176
Displays DOCSIS PHY layer information for one or more CMs. show cable modem remote- Displays the statistics accumulated by the remote-query feature. query snmp-server enable traps Enables traps that are sent when the remote polling of CMs has been cable completed. Cisco Broadband Cable Command Reference Guide 2-164 OL-1581-08...
Page 177
You can also use the no cable modem vendor command to remove the association between an OUI and a vendor name. The show cable modem vendor command then displays only the OUI as the vendor name. Cisco Broadband Cable Command Reference Guide 2-165 OL-1581-08...
Page 178
Router(config)# default cable modem vendor 00000C The following shows an example of the no cable modem vendor command being used to remove the association between Cisco and an OUI of 00:0A:42. If any CMs exist with that OUI, the show cable modem vendor command will display the OUI (“00:0A:42”) as the vendor name.
Page 180
200 to 299, depending on the cable interface. The system creates profile 241 as the default DOCSIS 2.0 A-TDMA profile. In Cisco IOS Release 12.2(15)CX and later releases, you can create a maximum of 10 profiles for each mode of operation, for a total of 30 profiles.
Page 181
Guard time in symbols. The time between successive bursts, with a range from 22 to 255. (In Cisco IOS Release 12.2(15)BC2 and earlier releases, the minimum guard time was 0 symbols, but we do not recommend using a guard time smaller than 22 symbols.) Modulation.
Page 182
Modulation profile 1 is defined as a qpsk Time Division Multiple Access (TDMA) profile. In Cisco IOS Release 12.2(15)CX, Release 12.2(15)BC2 and later releases, additional modulation profiles are defined as the default mixed TDMA/A-TDMA profile and the default Advanced TDMA (A- TDMA) profile.
Page 183
141 to 150, default=141 241 to 250, default=241 1. Only 8 modulation profiles are supported in Cisco IOS software releases before 12.2(15)BC1, so in these releases the valid range is from 1 to 8. Cisco Broadband Cable Command Reference Guide...
Page 184
DOCSIS 2.0 Support Cisco IOS Release 12.2(11)CY, 12.2(15)BC1, and later releases support 10 modulation profiles for each of the three DOCSIS modes (DOCSIS 1.X, DOCSIS 2.0, and mixed mode), for a total maximum of 30 modulation profiles. In addition, the router also creates several default modulation profiles (1, 21, 41, 101, 121, 141, 201, 221, and 241, depending on the cable interface line cards that are installed).
Page 186
See the show cable modulation-profile command for a description of the output display fields. Related Commands Command Description cable upstream modulation-profile Assigns a modulation profile to an interface. show cable modulation-profile Displays a modulation profile group’s information. Cisco Broadband Cable Command Reference Guide 2-174 OL-1581-08...
Page 187
Specifies the service ID for the packets that should be forwarded (1 to 16384). Note This option is supported only in Cisco IOS releases that support DOCSIS 1.1 operations. packet-type (Optional) Specifies whether data or MAC packets are forwarded.
Page 188
The cable monitor command allows an external LAN packet analyzer to monitor inbound and outbound data packets for specific types of traffic between the Cisco CMTS and the CMs on a cable interface. This feature enables the CMTS administrator to analyze traffic problems with customer data exchanges.
Page 189
Cisco CMTS Configuration Commands cable power cable power To manually power a cable interface line card on or off on a Cisco uBR10012 router, use the cable power command in privileged EXEC mode. cable power [on | off] slot/card Syntax Description Turns on power to the specified cable interface line card.
Page 190
TCC+ card is not a supported configuration. Examples The following example shows how to power off the first cable interface card in a Cisco uBR10012 chassis (card 5, slot 0). It also shows the output from the show interface cable command, with a line that indicates that the hardware is not present.
Page 191
Displays configuration and status information for a cable interface line card. show version Displays the basic configuration of the router, including whether an active TCC+ card is present. shutdown Disables or enables the interface on a line card. Cisco Broadband Cable Command Reference Guide 2-179 OL-1581-08...
Page 192
This command affects only CMs that are provisioned for DOCSIS 1.1 operations and that are currently Note online all cable interfaces on the Cisco CMTS. Information is not preserved for DOCSIS 1.1- provisioned CMs that went offline before this command was given. The service-flow information for CMs that are provisioned for DOCSIS 1.0 operations is always preserved, regardless of how this...
Page 193
Enables service flow logging and configures the number and duration of entries in the log. show cable modem Displays downstream and upstream traffic counters for one or more CMs. counters Cisco Broadband Cable Command Reference Guide 2-181 OL-1581-08...
Page 194
| mandatory | oaep-support | dsx-support] Syntax Description 40-bit-des (Optional) Uses 40-bit DES encryption. Cisco discourages the use of 40-bit DES encryption because Note it is not as secure as the other available methods of encryption. accept-self-signed-certificate (Optional) Allows cable modems to register using self-signed manufacturer certificates, as opposed to a manufacturer certificate that is chained to the DOCSIS root certificate.
Page 195
Sets traffic encryption keys and timeout periods. option Determines whether a specific CM is online. show cable privacy Displays information about BPI status and operation. debug cable privacy Displays debug messages for BPI operation. Cisco Broadband Cable Command Reference Guide 2-183 OL-1581-08...
Page 197
Sets traffic encryption keys and timeout periods. option Determines whether a specific CM is online. show cable privacy Displays information about BPI status and operation. debug cable privacy Displays debug messages for BPI operation. Cisco Broadband Cable Command Reference Guide 2-185 OL-1581-08...
Page 198
Usage Guidelines This command is applicable only on images that support BPI or BPI+ encryption. The cable privacy hotlist command is not supported on the Cisco uBR10012 router. To add a Note manufacturer’s or CM certificate to the hotlist on the Cisco uBR10012 router, use SNMP commands to set the appropriate attributes in DOCS-BPI-PLUS-MIB.
Page 199
Sets traffic encryption keys and timeout periods. option Determines whether a specific CM is online. show cable privacy Displays information about BPI status and operation. debug cable privacy Displays debug messages for BPI operation. Cisco Broadband Cable Command Reference Guide 2-187 OL-1581-08...
Page 200
The grace-time keyword is used to assign a temporary key to a CM to access the network. The life-time keyword is used to assign a more permanent key to a CM. A CM that has a grace-time or life-time key assigned by the Cisco CMTS requests a new key before the current one expires.
Page 201
Displays information about BPI status and operation. show interface cable Displays the current values of the KEK and TEK timers for an interface. privacy debug cable privacy Displays debug messages for BPI operation. Cisco Broadband Cable Command Reference Guide 2-189 OL-1581-08...
Page 202
The TEK is assigned to a CM when its KEK has been established. The TEK is used to encrypt data traffic between the CM and the Cisco CMTS. TEKs can be set to expire based on a grace-time or a life-time value.
Page 203
Displays information about BPI status and operation. show interface cable Displays the current values of the KEK and TEK timers for an interface. privacy debug cable privacy Displays debug messages for BPI operation. Cisco Broadband Cable Command Reference Guide 2-191 OL-1581-08...
Page 204
CMTS, even if the destination CM is on the same subnet. The cable proxy-arp command enables the Cisco CMTS to act as a proxy for ARP requests generated by the CMs, which allows CMs on the same cable subnet to communicate directly which each other, without the traffic having to be routed first through the CMTS.
Page 206
Use the exit command to leave enforce-rule configuration mode and to return to global configuration mode. In Cisco IOS Release 12.2(15)BC1, you can create a maximum of 20 enforce-rules. If you have created Note 20 enforce-rules and want to create another new rule, you must first delete one of the existing rules.
Page 207
Displays debugging messages the use of the cable qos enforce-rule subscriber-monitoring command to enforce a particular quality of service (QoS) profile. enabled Activates an enforce-rule and begins subscriber traffic management. Cisco Broadband Cable Command Reference Guide 2-195 OL-1581-08...
Page 208
Displays the quality of service (QoS) enforce-rules that are currently enforce-rule defined. show cable subscriber- Displays subscribers that are violating their registered quality of service usage (QoS) profiles. Cisco Broadband Cable Command Reference Guide 2-196 OL-1581-08...
Page 209
CMTS. Valid values are from 1 to 255. Both the originally provisioned QoS profile and the enforced Note QoS profile must be created on the Cisco CMTS. This option does not support profiles that are created by the CM. modems Permits creation of QoS table entries by modem registration requests.
Page 210
Configures a QoS profile. show cable qos Displays the status of permissions for changing QoS tables for a cable router. permission show cable qos profile Displays the QoS profiles that have been defined. Cisco Broadband Cable Command Reference Guide 2-198 OL-1581-08...
Page 211
CMTS not implementing fragmentation. Note The CM enforces the maximum upstream transmit burst limit. The Cisco CMTS does not enforce this limit, but this command can still be used for documentation and troubleshooting purposes. Cisco Broadband Cable Command Reference Guide...
Page 212
QoS on the backbone. Each parameter is an 8-bit hexadecimal value that ranges from 0x00 to 0xFF. The default value is 0xFF starting with Cisco IOS Release 12.2(15)BC2 and later, and the default is 0x00 in earlier releases. The new TOS value is calculated using the following formula: New ToS = ((Original ToS) AND (NOT tos-mask)) OR tos-value This formula is how the TOS was calculated in DOCSIS 1.0+...
Page 213
In Cisco IOS Release 12.2(15)BC21, the ip-precedence and max-downstream options were removed. If you are supporting DOCSIS 1.0+ CMs that require these parameters for voice over IP (VoIP) traffic and other real-time traffic, use the following Cisco Vendor-Specific Fields (VSIF) in the CM’s DOCSIS configuration file:...
Page 214
Sets the parameters for DOCSIS 1.1 cable service class. show cable qos Displays the status of permissions for changing QoS tables for a cable router. permission show cable qos profile Displays the QoS profiles that have been defined. Cisco Broadband Cable Command Reference Guide 2-202 OL-1581-08...
Page 215
CMs using that interface. Examples The following example shows the registration timeout value being increased from 3 minutes to 10 minutes: router# configure terminal router#(config)# interface c6/0 router(config-if)# cable registration-timeout 10 router(config-if)# exit router(config)# Cisco Broadband Cable Command Reference Guide 2-203 OL-1581-08...
Page 216
This functionality enables the use of DHCP Option 82 to allow a DHCP server to identify the CM sending the request and to initiate the appropriate action based on this information. On Cisco IOS Release 12.0 and later releases, use the...
Page 217
Enables the system to insert the CM MAC address into a DHCP option packet received from a CM or host and forward the packet to a DHCP server. ip dhcp smart-relay Monitors client retransmissions when address pool depletion occurs. Cisco Broadband Cable Command Reference Guide 2-205 OL-1581-08...
Page 218
2–Best-Effort Schedule Type 3–Non-Real-Time Polling Service Schedule Type (supported only in Cisco 12.2(4)BC and later releases) 4–Real-Time Polling Service Schedule Type 5–Unsolicited Grant Service with Activity Detection Schedule Type 6–Unsolicited Grant Service Schedule Type Cisco Broadband Cable Command Reference Guide 2-206 OL-1581-08...
Page 219
New IP TOS = ((Original TOS value AND and-mask) OR or-mask). (For a description of the previous method of calculating the TOS value, see the cable qos profile command.) The default is to leave the TOS value unchanged (no overwrite). Cisco Broadband Cable Command Reference Guide 2-207 OL-1581-08...
Page 220
Router(config)# cable service class 4 max-concat-burst 1522 Router(config)# cable service class 4 req-trans-policy 0x0 Router(config)# cable service class 4 tos-overwrite 0x1F 0xE0 Router(config)# cable service class 4 activity-timeout 30 Router(config)# cable service class 4 admission-timeout 30 Cisco Broadband Cable Command Reference Guide 2-208 OL-1581-08...
Page 221
Router(config)# cable service class 5 admission-timeout 30 Related Commands Command Description cable qos profile Creates a DOCSIS 1.0 QoS profile. show cable service- Displays the service classes that have been created. class Cisco Broadband Cable Command Reference Guide 2-209 OL-1581-08...
Page 222
USG-AD services and configures the CMTS to provide only UGS services. This will prevent a CM that registered for USG-AD services from being able to obtain upstream transmission opportunities, resulting in a significant loss of bandwidth when a large number of CMs are requesting UGS-AD service flows. Cisco Broadband Cable Command Reference Guide 2-210 OL-1581-08...
Page 223
Sets the amount of time a dynamic service-flow can be present in the system inactivity-timeout without any activity (DOCSIS 1.0 operation). show controllers cable Displays information for the cable interface. Cisco Broadband Cable Command Reference Guide 2-211 OL-1581-08...
Page 224
Sets the amount of time a dynamic service-flow can be present in the system inactivity-threshold without any activity (DOCSIS 1.1 operation). cable qos permission Specifies permission for updating the cable router QoS table. Cisco Broadband Cable Command Reference Guide 2-212 OL-1581-08...
Page 226
These attributes are defined in the Data Over Cable System Interface Specification Quality of Service Management Information Base (DOCSIS-QOS MIB) internet draft. Cisco IOS Release 12.2(15)BC1 supports version 4 of this DOCSIS-QOS MIB draft, which is available on the IETF Internet-Drafts web site: http://http://www.ietf.org/ID.html...
Page 227
However, the Cisco uBR10012 router still maintains only one log table for all deleted service flows. For example, if the max-entry value is set to 10,000 on a Cisco uBR7200 series router, the service flow log table holds a maximum of 10,000 entries for all cable line cards in the chassis. If the max-entry value...
Page 228
CMTS. If the CM does not have the proper encryption string, it will be unable to calculate the proper MIC value, and the show cable modem command will show reject(m) for the modem to indicate a MIC authentication failure. Cisco Broadband Cable Command Reference Guide 2-216 OL-1581-08...
Page 229
Create DOCSIS configuration files that use the shared-secret encryption string to create the MD5 • MIC value. This can be done using the Cisco DOCSIS Configurator tool by entering the shared- secret string in the CMTS Authentication field in the Miscellaneous parameters.
Page 230
Requires that all CMs on a cable interface attempt to download a DOCSIS configuration file using the Trivial File Transfer Protocol (TFTP) through the cable interface before being allowed to register and come online. Cisco Broadband Cable Command Reference Guide 2-218 OL-1581-08...
Page 231
CMTS. If the CM does not have the proper encryption string, it will be unable to calculate the proper MIC value, and the show cable modem command will show reject(m) for the modem to indicate a MIC authentication failure. Cisco Broadband Cable Command Reference Guide 2-219 OL-1581-08...
Page 232
Cisco IOS Release 12.2 BC changed the encryption algorithm used for the cable shared-secret command. If you are upgrading from a Cisco IOS 12.1 EC or 12.0 SC release, you cannot cut and paste the cable shared-secret configuration lines that include an encrypted password. Instead, you must re- enter the original shared secret passwords at the CLI prompt, and then resave the configuration.
Page 233
Requires that all CMs on a cable interface attempt to download a DOCSIS configuration file using the Trivial File Transfer Protocol (TFTP) through the cable interface before being allowed to register and come online. Cisco Broadband Cable Command Reference Guide 2-221 OL-1581-08...
Page 234
(Optional) Specifies that queries will be sent to verify unknown source IP addresses in upstream data packets. Do not enable the local DHCP server on the Cisco CMTS and Note configure local DHCP address pools, using the ip dhcp pool command, when using this option, because this prevents DHCP address validation.
Page 235
CPU utilization of DHCP Receive and ISR processes when the Cisco CMTS is configured with the cable source-verify dhcp and no cable arp commands. In current Cisco IOS Release 12.1 EC and 12.2 BC software images, the Cisco CMTS can crash with a Caution “bus error exception”...
Page 236
URL: http://www.ietf.org/internet-drafts/draft-ietf-dhc-leasequery-06.txt Do not enable the local DHCP server on the Cisco CMTS and configure local DHCP address pools, using Caution the ip dhcp pool command, when you are also enabling the cable source-verify dhcp command, because the DHCP server on the Cisco CMTS can intercept the LEASEQUERY messages and prevent them from reaching the external DHCP server.
Page 237
Router(config-if)# ip verify unicast source reachable-via rx Router(config-if)# Examples The following example shows how to turn on CM upstream verification and configures the Cisco CMTS router to send DHCP LEASEQUERIES to verify unknown source IP addresses in upstream data packets: Router# configure terminal...
Page 238
IP address appears in the routing tables as belonging to that interface, so as to prevent spoofed IP source addresses. Cisco Broadband Cable Command Reference Guide 2-226 OL-1581-08...
Page 239
To control the number of Dynamic Host Configuration Protocol (DHCP) LEASEQUERY request messages that are sent for unknown IP addresses on all cable downstream interfaces on the Cisco Cable Modem Termination System (CMTS) router, use the cable source-verify leasequery-filter downstream command in global configuration mode.
Page 240
Examples The following example shows how to configure the Cisco CMTS router so that it allows a maximum of 10 DHCP lease query requests per SID over each five-second interval on all downstream cable interfaces.
Page 241
To prevent such a large volume of LEASEQUERY requests on the upstreams on a cable interface, use the cable source-verify leasequery-filter upstream command. After configuring this command, the Cisco CMTS allows only a certain number of DHCP LEASEQUERY requests in the upstream direction within each interval time period.
Page 242
Examples The following example shows how to configure the Cisco CMTS router so that it allows a maximum of five DHCP lease query requests per SID over each two-second interval on all upstreams on a particular cable interface.
Page 243
Specifies a range of center frequencies the Cisco CMTS can scan to find an hz up-freq2-hz acceptable channel to which the spectrum group may hop. The valid range for up- freq1-hz is 5,000,000 Hz to 42,000,000 Hz (DOCSIS), 55,000,000 Hz (Japan), or 65,000,000 (EuroDOCSIS), but up-freq2-hz must be greater than up-freq1-hz.
Page 244
Modification 12.0(13)SC, 12.1(4)EC, The allowable frequency range was increased to 65 MHz to 12.2(4)BC1 support the EuroDOCSIS frequency range of the Cisco uBR- MC16E cable interface line card. 12.2(15)BC2 The maximum number of spectrum groups was increased from 32 to 40 groups per router.
Page 245
Cisco CMTS Configuration Commands cable spectrum-group (global configuration) If both an Cisco uBR-MC16E cable interface line card and a Cisco uBR-MC16C or a Cisco uBR- Note MC16S cable interface line card are present in the chassis, a spectrum group in the 42-MHz to 65-MHz range should not be assigned.
Page 246
Activates or shuts down a specified upstream cable interface. cable upstream hopping blind Disengages the advanced spectrum management features of the Cisco uBR-MC16S and Cisco uBR-MC5X20S cable interface line cards by enabling blind frequency hopping behavior. show controllers cable Displays information about the cable interface, including the upstream center frequency.
Page 247
Specifies the spectrum group that should be used as the default group for the upstreams on this cable interface. The valid range is from 1 to 32, or from 1 to 40, depending on the Cisco IOS software release. Defaults No default behavior or values.
Page 248
Disengages the advanced spectrum management features of the Cisco uBR-MC16S and Cisco uBR-MC5X20S cable interface line cards by enabling blind frequency hopping behavior. cable upstream spectrum- Assigns a spectrum group to an individual upstream on a cable group interface line card.
Page 249
1 to 300 seconds (Cisco IOS Release 12.2(8)BC1 or later). Defaults Before Cisco IOS Release 12.2(15)BC1: 25 seconds Cisco IOS Release 12.2(15)BC1 and later releases: 20 seconds when N+1 HCCP redundancy is not configured, and 15 seconds when N+1 HCCP redundancy is configured on the cable interface Command Modes...
Page 250
CM starts ranging on the upstream. Note The hop period should be set to at least 25 seconds on the Cisco uBR-MC16S and Cisco uBR- MC5X20S/U cards so that transient network problems that are unrelated to ingress noise do not generate unnecessary frequency hops.
Page 251
Usage Guidelines The Cisco CMTS sends a station maintenance message to each CM at least once every 25 to 30 seconds. If a CM does not respond to a station maintenance message within that time period, the CMTS then resends station maintenance messages at a faster rate (typically one second apart) in an attempt to restore connectivity with the CM.
Page 252
The following example shows how to set the threshold that triggers frequency hop to 25 percent of station maintenance messages on the upstream that is assigned to spectrum-group 4: router# configure terminal router(config)# cable spectrum-group 4 hop threshold 25 router(config)# Cisco Broadband Cable Command Reference Guide 2-240 OL-1581-08...
Page 253
Configures an upstream for one modulation profile (static profile) or two modulation-profile modulation profiles (Dynamic Upstream Modulation). show cable hop Displays the current hop period and threshold for an upstream, along with other statistics. Cisco Broadband Cable Command Reference Guide 2-241 OL-1581-08...
Page 254
Modification 12.1 T This command was introduced. 12.2(11)BC3 Support was added for this command on the Cisco uBR-LCP2-MC16S card on the Cisco uBR10012 router. 12.2(15)BC2 The maximum number of spectrum groups was increased from 32 to 40 groups per router.
Page 255
Specifies a hop threshold for a cable spectrum group. threshold cable upstream hopping blind Disengages the advanced spectrum management features of the Cisco uBR-MC16S and Cisco uBR-MC5X20S cable interface line cards by enabling blind frequency hopping behavior. show controllers cable Displays information about the cable interface, including the upstream center frequency.
Page 256
To set the default values for attributes in the Subscriber Management MIB (DOCS-SUBMGT-MIB), and to enable Cisco Static CPE Override on the Cisco CMTS, use the cable submgmt default global configuration command. To restore the original defaults, use the no form of this command.
Page 257
CMs and CPE devices being serviced by the Cisco CMTS. The CMTS creates rows in these tables for each CM and CPE device when the CM registers with the CMTS, and if the CM does not specify a value for an attribute in this table, the CMTS uses the defaults specified by the cable submgmt default command.
Page 258
SNMP SET commands. The cable submgmt default command, however, allows the new defaults to be included in the Cisco IOS configuration file so that the defaults are automatically reconfigured whenever the CMTS reboots or reloads.
Page 259
CPE devices, the CMTS defaults to allowing only one CPE device. Learning also is disabled, so that one CPE device, therefore, must be specified in the DOCSIS configuration file that the CM uses to register. Cisco Broadband Cable Command Reference Guide 2-247 OL-1581-08...
Page 260
The above example assumes that filter groups 1, 20, and 21 have already been created on the CMTS using Note the appropriate SNMP commands. Related Commands For additional information about configuring Static CPE Override on the Cisco CMTS, refer to the following document on Cisco.com: Cisco CMTS Static CPE Override •...
Page 261
To specify the interval between successive sync message transmissions from the Cisco CMTS, use the cable sync-interval command in cable interface configuration mode. To return the sync message interval to its default value, use the no form of this command.
Page 262
Indicates the service provider descriptor (SPD) that the telco-return factory-default CM uses during the initialization process. cable telco-return spd Enables the telco-return CM to operate in manual-dial mode. manual-dial Cisco Broadband Cable Command Reference Guide 2-250 OL-1581-08...
Page 263
Sets the number of failed dial-up connections that can occur before the threshold CM indicates a connection failure. cable telco-return spd Sets the username that the telco-return CM uses for authentication username when establishing a PPP connection. Cisco Broadband Cable Command Reference Guide 2-251 OL-1581-08...
Page 264
Indicates the service provider descriptor (SPD) that the telco-return factory-default CM uses during the initialization process. cable telco-return spd Enables the telco-return CM to operate in manual-dial mode. manual-dial Cisco Broadband Cable Command Reference Guide 2-252 OL-1581-08...
Page 265
Sets the number of failed dial-up connections that can occur before the threshold CM indicates a connection failure. cable telco-return spd Sets the username that the telco-return CM uses for authentication username when establishing a PPP connection. Cisco Broadband Cable Command Reference Guide 2-253 OL-1581-08...
Page 266
This command sets the Registration IP Address parameter in TSI messages. By default, the downstream channel IP address of the Cisco CMTS is also used for the registration IP address. When this cable telco- return registration-ip command is configured, telco-return CMs send their registration requests to this IP address instead of to the downstream channel IP address.
Page 267
Sets the number of failed dial-up connections that can occur before the threshold CM indicates a connection failure. cable telco-return spd Sets the username that the telco-return CM uses for authentication username when establishing a PPP connection. Cisco Broadband Cable Command Reference Guide 2-255 OL-1581-08...
Page 268
Defines the interval for sending TCD and Termination System Information (TSI) messages. cable telco-return Selects a different IP address for the telco-return CM to send its registration-ip registration requests. Cisco Broadband Cable Command Reference Guide 2-256 OL-1581-08...
Page 269
Sets the number of failed dial-up connections that can occur before the threshold CM indicates a connection failure. cable telco-return spd Sets the username that the telco-return CM uses for authentication username when establishing a PPP connection. Cisco Broadband Cable Command Reference Guide 2-257 OL-1581-08...
Page 270
2 dhcp-server 192.168.255.255 Related Commands Command Description cable telco-return enable Enables telco-return functionality. cable telco-return interval Defines the interval for sending TCD and Termination System Information (TSI) messages. Cisco Broadband Cable Command Reference Guide 2-258 OL-1581-08...
Page 271
Sets the number of failed dial-up connections that can occur before the threshold CM indicates a connection failure. cable telco-return spd Sets the username that the telco-return CM uses for authentication username when establishing a PPP connection. Cisco Broadband Cable Command Reference Guide 2-259 OL-1581-08...
Page 272
2 dial-timer 7200 Related Commands Command Description cable telco-return enable Enables telco-return functionality. cable telco-return interval Defines the interval for sending TCD and Termination System Information (TSI) messages. Cisco Broadband Cable Command Reference Guide 2-260 OL-1581-08...
Page 273
Sets the number of failed dial-up connections that can occur before the threshold CM indicates a connection failure. cable telco-return spd Sets the username that the telco-return CM uses for authentication username when establishing a PPP connection. Cisco Broadband Cable Command Reference Guide 2-261 OL-1581-08...
Page 274
Defines the interval for sending TCD and Termination System Information (TSI) messages. cable telco-return Selects a different IP address for the telco-return CM to send its registration-ip registration requests. Cisco Broadband Cable Command Reference Guide 2-262 OL-1581-08...
Page 275
Sets the number of failed dial-up connections that can occur before the threshold CM indicates a connection failure. cable telco-return spd Sets the username that the telco-return CM uses for authentication username when establishing a PPP connection. Cisco Broadband Cable Command Reference Guide 2-263 OL-1581-08...
Page 276
Selects a different IP address for the telco-return CM to send its registration-ip registration requests. cable telco-return spd dhcp- Indicates that telco-return CMs must use a specific DHCP server. authenticate Cisco Broadband Cable Command Reference Guide 2-264 OL-1581-08...
Page 277
Sets the number of failed dial-up connections that can occur before the threshold CM indicates a connection failure. cable telco-return spd Sets the username that the telco-return CM uses for authentication username when establishing a PPP connection. Cisco Broadband Cable Command Reference Guide 2-265 OL-1581-08...
Page 278
Defines the interval for sending TCD and Termination System Information (TSI) messages. cable telco-return Selects a different IP address for the telco-return CM to send its registration-ip registration requests. Cisco Broadband Cable Command Reference Guide 2-266 OL-1581-08...
Page 279
Sets the number of failed dial-up connections that can occur before the threshold CM indicates a connection failure. cable telco-return spd Sets the username that the telco-return CM uses for authentication username when establishing a PPP connection. Cisco Broadband Cable Command Reference Guide 2-267 OL-1581-08...
Page 280
The following example shows how to set the primary phone number to 9255551212. If the CM fails to connect using that number, it tries the next phone number, 9255551234: router(config-if)# cable telco-return spd 2 phonenum 9255551212 router(config-if)# cable telco-return spd 2 phonenum 9255551234 Cisco Broadband Cable Command Reference Guide 2-268 OL-1581-08...
Page 281
Sets the number of failed dial-up connections that can occur before threshold the CM indicates a connection failure. cable telco-return spd Sets the username that the telco-return CM uses for authentication username when establishing a PPP connection. Cisco Broadband Cable Command Reference Guide 2-269 OL-1581-08...
Page 282
This command is available only in images that support telco-return. These images have a “t” as part of Note the image name. Examples The following example requires the CM to perform CHAP authentication: router(config-if)# cable telco-return spd 2 ppp-authenticate chap Cisco Broadband Cable Command Reference Guide 2-270 OL-1581-08...
Page 283
Sets the number of failed dial-up connections that can occur before threshold the CM indicates a connection failure. cable telco-return spd Sets the username that the telco-return CM uses for authentication username when establishing a PPP connection. Cisco Broadband Cable Command Reference Guide 2-271 OL-1581-08...
Page 284
Defines the interval for sending TCD and Termination System Information (TSI) messages. cable telco-return Selects a different IP address for the telco-return CM to send its registration-ip registration requests. Cisco Broadband Cable Command Reference Guide 2-272 OL-1581-08...
Page 285
Sets the number of failed dial-up connections that can occur before the threshold CM indicates a connection failure. cable telco-return spd Sets the username that the telco-return CM uses for authentication username when establishing a PPP connection. Cisco Broadband Cable Command Reference Guide 2-273 OL-1581-08...
Page 286
Selects a different IP address for the telco-return CM to send its registration-ip registration requests. cable telco-return spd dhcp- Indicates that telco-return CMs must use a specific DHCP server. authenticate Cisco Broadband Cable Command Reference Guide 2-274 OL-1581-08...
Page 287
Sets the number of failed dial-up connections that can occur before the threshold CM indicates a connection failure. cable telco-return spd Sets the username that the telco-return CM uses for authentication username when establishing a PPP connection. Cisco Broadband Cable Command Reference Guide 2-275 OL-1581-08...
Page 288
2 threshold 20 Related Commands Command Description cable telco-return enable Enables telco-return functionality. cable telco-return interval Defines the interval for sending TCD and Termination System Information (TSI) messages. Cisco Broadband Cable Command Reference Guide 2-276 OL-1581-08...
Page 289
Includes the service provider name in the SPD. service-provider cable telco-return spd Sets the username that the telco-return CM uses for authentication username when establishing a PPP connection. Cisco Broadband Cable Command Reference Guide 2-277 OL-1581-08...
Page 290
Defines the interval for sending TCD and Termination System Information (TSI) messages. cable telco-return Selects a different IP address for the telco-return CM to send its registration-ip registration requests. Cisco Broadband Cable Command Reference Guide 2-278 OL-1581-08...
Page 291
Includes the service provider name in the SPD. service-provider cable telco-return spd Sets the number of failed dial-up connections that can occur before the threshold CM indicates a connection failure. Cisco Broadband Cable Command Reference Guide 2-279 OL-1581-08...
Page 292
The cable tftp-enforce cable interface configuration command requires all cable modems on a cable interface to attempt a TFTP request for the DOCSIS configuration file through the cable interface with the Cisco CMTS router before being allowed to register and come online. This can help prevent the following situations from occurring: •...
Page 293
PRE1 module has notified the line card whether the modem did download the proper file from the TFTP server. In previous Cisco IOS releases, these cable modems were not allowed to come online (or marked as TFTP violators) even if they had successfully downloaded the appropriate DOCSIS configuration file.
Page 294
3/0. These cable modems must attempt a TFTP download of the DOCSIS configuration file through the cable interface with the Cisco CMTS. If they do not, they are not allowed to register or come online, and they are marked as having either a registration error—reject(c)—in the show cable modem command.
Page 295
The following example of the mark-only option shows how that cable modems that do not attempt a TFTP download through the Cisco CMTS are allowed to register and come online, but they are marked with a pound sign (#) when using the show cable modem command.
Page 296
DOCSIS configuration file and register with the CMTS. debug cable registration Displays debug messages for the CM registration process. show cable modem Displays information for the registered and unregistered CMs. Cisco Broadband Cable Command Reference Guide 2-284 OL-1581-08...
Page 297
Cisco CMTS Configuration Commands cable time-server cable time-server To enable the integrated time-of-day (ToD) server on the Cisco CMTS series, enter the cable time- server command in global configuration mode. To disable the time-of-day server function, use the no form of this command.
Page 298
100 percent. When setting admission control to other values, scale the bandwidth values in Table 2-9 accordingly, so as to plan for the maximum number of CMs effectively allowed per upstream port. Cisco Broadband Cable Command Reference Guide 2-286 OL-1581-08...
Page 299
For example, the following command output shows that this upstream has allocated a total bandwidth of 2.5 Mbit/sec to those online CMs that were assigned a guaranteed upstream bandwidth in their DOCSIS configuration files. Cisco Broadband Cable Command Reference Guide 2-287 OL-1581-08...
Page 300
0.75 10.128.1.57 0030.1976.6fa1 Related Commands Command Description debug cable mac-scheduler Displays information for the MAC layer’s scheduler and admission control activities. debug cable us-adm-ctrl Displays debug messages for upstream admission control activity. Cisco Broadband Cable Command Reference Guide 2-288 OL-1581-08...
Page 301
Displays statistics for a CM, including its upstream port and primary SID. show interface cable Displays the interface configuration, which for an upstream upstream includes the current admission control policy, if any. Cisco Broadband Cable Command Reference Guide 2-289 OL-1581-08...
Page 302
(A-TDMA-only) mode. last-choice-width (Cisco uBR-MC16S, Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, and Cisco uBR-MC5x20S/U only) The upstream channel width in hertz. The valid values are the same as those for the first-choice-width parameter, but for proper operation, the last-choice-width should be equal to or less than the first-choice-width value. Use this parameter with supported cards to enable symbol rate management algorithms.
Page 303
When using this command to change channel-widths for an upstream interface on the Cisco uBR-MC5X20S cable interface line card, some DOCSIS 1.1 CMs can go offline if you do not also change the minislot size to the corresponding value. See the following examples for the correct channel-...
Page 304
“DSA MULTIPLE ERRORS”. Examples The following example shows upstream port 2 on a Cisco uBR-MCXXC card being configured with a channel width of 200,000 Hz (which is equivalent to a symbol rate of 160 kilosymbols/second):...
Page 305
Cisco CMTS Configuration Commands cable upstream channel-width Command Description cable upstream Disables optimum frequency hopping on the Cisco uBR-MC16S and hopping blind Cisco uBR-MC5X20S cable interface line cards. cable upstream Specifies the minislot size (in ticks) for a specific upstream interface.
Page 306
CM due to the inherent request-to-grant round-trip latency of the hybrid fiber-coaxial (HFC) cable system incurred by every packet. To increase this per-CM upstream throughput, the Cisco CMTS driver has been enhanced to receive a concatenated burst of multiple MAC frames from the same CM.
Page 307
To map an upstream port to a physical port on the Cisco uBR-MC5X20S/U cable interface line card for use with a particular downstream, use the cable upstream connector command in cable interface configuration mode. To remove the mapping and shut down the upstream port, use the no form of this command.
Page 308
Table 2-10 shows the default port mapping. Table 2-10 Default Upstream Port Assignments for the Cisco uBR-MC5X20S/U Cable Interface Line Card Physical Ports (upstream, as labeled on the card) Physical Ports (downstream)
Page 309
0 and 15; a value of 10 indicates a window between 0 and 1023. Cisco recommends that you use the automatic settings for data backoff. If you decide to manually specify the data-backoff values, use the following formula as a guideline for the start and end binary exponents: 0.33 = (2**stop - 2**start)/n...
Page 310
Configures the interval between consecutive initial ranging slots on an upstream. cable upstream range- Specifies automatic or configured initial ranging backoff backoff calculation. show controllers cable Displays the backoff window setting for the configured upstream port. Cisco Broadband Cable Command Reference Guide 2-298 OL-1581-08...
Page 311
Router(config-if)# cable upstream 0 description "SJ-Node1-Upstream 0" Router(config-if)# cable upstream 1 description "SJ-Node1-Upstream 1 (Unused)" Router(config-if)# Related Commands Command Description show interface cable Displays the current configuration and status of a cable interface. Cisco Broadband Cable Command Reference Guide 2-299 OL-1581-08...
Page 312
Examples The following example shows how to enable differential encoding for upstream port 2: Router(config-if)# cable upstream 2 differential-encoding Router(config-if)# Cisco Broadband Cable Command Reference Guide 2-300 OL-1581-08...
Page 313
Note The advanced hardware-based spectrum management features for the Cisco uBR-MC16S/U/X, Cisco uBR-MC28U/X, and Cisco uBR-MC5X20S/U cards are supported only in the DOCSIS 1.0/1.1 TDMA-only mode. They cannot be used in the mixed or A-TDMA-only modes. Cisco Broadband Cable Command Reference Guide...
Page 314
• modulation profiles. The CMTS does not allow DOCSIS 1.0 and DOCSIS 1.1 cable modems to register and come online these upstreams. The Cisco uBR-MC5X20S/U, Cisco uBR-MC16U/X, and Cisco uBR-MC28U/X cards also support 6,400,000 Hz (5,120,000 symbols/sec) when operating in DOCSIS 2.0 (A-TDMA-only) mode.
Page 315
The following example shows how to configure the first four upstreams for the first downstream on the Cisco uBR-MC28U/X cable interface line card in slot 5/0. The first two upstreams are configured for A- TDMA mode and the last two upstreams are configured for mixed TDMA/A-TDMA mode.
Page 316
Assigns one or two modulation profiles to an upstream port. modulation-profile show cable modulation- Displays the modulation profile information for a Cisco CMTS. profile show interface cable mac- Displays the current time-slot scheduling state and statistics. scheduler...
Page 317
16-QAM mode. The cable upstream equalization-coefficient command enables the use of this adaptive equalization on an upstream. When pre-equalization is disabled, the Cisco CMTS uses the spectrum adjustments given in section 4.2, Upstream, of the DOCSIS 1.1 specification. The CMTS uses an equalization scheme that matches the configuration of the upstream. When the upstream is configured for DOCSIS 1.0 and DOCSIS 1.1 modulation profiles, the CMTS enables and...
Page 318
Examples The following example shows how to enable the use of the equalization coefficient on upstream 0 on the cable interface line card in slot 5/1 on the Cisco uBR10012 router: Router# configure terminal Router(config)# interface cable 5/1/0...
Page 319
This command was introduced. Usage Guidelines The Cisco CMTS uses FEC to attempt to correct any upstream data that might have been corrupted. To use this feature, you need to activate FEC on the upstream RF carrier. When FEC is activated, the Cisco CMTS commands all CMs on the network to activate FEC.
Page 320
Specifies an upstream channel width for a headend cable router. channel-width cable upstream fec Enables the upstream FEC. cable upstream Disables optimum frequency hopping on the Cisco uBR-MC16S and hopping blind Cisco uBR-MC5X20S/U cable interface line cards. cable upstream Overrides modulation types specified in the modulation profile for the modulation-profile specified upstream channel.
Page 321
Defaults By default, fragmentation is enabled for all upstream ports on ASIC line cards (Cisco uBR-MC11C, Cisco uBR-MC12C, Cisco uBR-MC14C, Cisco uBR-MC16C, Cisco uBR-MC16S, and Cisco uBR- MC28C) and disabled for all upstream ports on old FPGA line cards.
Page 322
CMs that do not specify their own value. cable upstream Specifies that a cable interface line card should fragment DOCSIS frames on fragment-force an upstream when the frame exceeds a particular size. Cisco Broadband Cable Command Reference Guide 2-310 OL-1581-08...
Page 323
Do not use a fragment size greater than 2,000 bytes on the Cisco uBR-MC5X20S/U cable interface line cards, and do not use a fragment size greater than 3,500 bytes on all other cable interface line cards, unless otherwise instructed by a Cisco TAC engineer.
Page 324
Specifies a value for the upstream Maximum Traffic Burst parameter for burst CMs that do not specify their own value. cable upstream Enables fragmentation of DOCSIS frames on a particular upstream. fragmentation Cisco Broadband Cable Command Reference Guide 2-312 OL-1581-08...
Page 325
Router(config-if)# cable upstream 0 freq-adj averaging 50 Related Commands Command Description cable upstream power-adjust Controls power-adjustment methods on the Cisco CMTS. show cable flap-list Displays a list of CMs that have exceeded the threshold number of power adjustments. show cable modem Displays CM configuration settings.
(42000000 Hz), 55 MHz (55000000 Hz), or 65 MHz (65000000 Hz), depending on the cable interface line card being used. If you wish to have the Cisco CMTS dynamically specify a center frequency for the given upstream interface, do not enter any frequency value.
Page 327
If both a Cisco uBR-MC16E cable interface line card and a Cisco uBR-MC16C and/or a Cisco uBR-MC16S cable interface line card are present in the chassis, a spectrum group in the 42 MHz to 65 MHz range should not be assigned.
Page 328
Router(config-if)# exit Router(config)# exit Router# The following example shows how to allow the Cisco CMTS to dynamically specify a center frequency for the upstream port 0: Router(config-if)# no cable upstream 0 frequency The following command example from Cisco IOS Release 12.3 BC illustrates the allowable upstream...
Page 329
CNR threshold value for the current modulation profile: The Cisco uBR-MC16S changes to a new frequency, if a clean frequency is available in its spectrum group. Cisco Broadband Cable Command Reference Guide...
Page 330
If the noise levels still exceed the CNR threshold value for the secondary modulation profile, and if the upstream has been configured for a range of channel widths, the Cisco uBR-MC16S narrows the channel width of the upstream by half. If the noise levels are still excessive, the channel width is...
Page 331
Do not use this command unless you have a specific reason to disable optimum hopping configurations. Note For example, if you are experimenting with a Cisco uBR-MC16S or Cisco uBR-MC5X20S/U card, you can use this command to enforce blind hopping on individual upstream channels.
Page 332
Cisco CMTS Configuration Commands cable upstream hopping blind Command Description cable upstream power-level Specifies the upstream cable interface receive power level in dBmV. cable upstream shutdown Activates or shuts down a specified upstream cable interface. Cisco Broadband Cable Command Reference Guide 2-320 OL-1581-08...
Page 333
When you enable ingress noise cancellation on an upstream, the Cisco CMTS periodically schedules a 256-symbol idle slot on the upstream channel. The interval option specified in the cable upstream ingress-noise-cancellation command determines how often this idle slot is generated.
Page 334
This command is available only on the Cisco uBR-MC5X20U, Cisco uBR-MC16U/X and Note Cisco uBR-MC28U/X cable interface line card. It cannot be used on other cable interface line cards. Examples The following example shows how to configure the first upstream on a Cisco uBR-MC16U/X or...
Page 335
Command Modes Interface configuration (cable interface only) Command History Release Modification 12.2(15)BC1 This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012 routers. Usage Guidelines After you have used the cable load-balance group (global configuration) command to initially create...
Page 336
Configures the frequency of the load-balancing policy updates. group interval cable load-balance Configures how the Cisco CMTS should load balance cable modems with group policy ugs active unsolicited grant service (UGS) service flows. cable load-balance Configures the threshold values that a load-balance group should use for group threshold load-balancing operations.
Page 337
Cisco CMTS changes their upstream modulation rate in an upstream channel descriptor (UCD) message. When you configure an upstream with the cable upstream maintain-psd command, the Cisco CMTS sets TLV 15 (Maintain Power Spectral Density) to ON in the UCD messages it sends to the CMs on that upstream.
Page 338
Router(config)# interface cable c5/1/0 Router(config-if)# no cable upstream 0 maintain-psd Router(config-if)# exit Router(config)# exit Router# Related Commands Command Description cable upstream docsis-mode Configures an upstream to use either DOCSIS 1.x or DOCSIS 2.0 modulation profiles. Cisco Broadband Cable Command Reference Guide 2-326 OL-1581-08...
Page 339
6 upstreams for the downstream, the valid range for upstreams will be 0 to 5. Examples The following example shows how to configure all of the downstreams on a Cisco uBR-MC5X20S card for a maximum number of 6 upstreams.
Page 340
Router(config)# exit Router# Related Commands Command Description cable upstream connector Maps an upstream port to a physical port on the Cisco uBR-MC5X20S cable interface line card for use with a particular downstream. Cisco Broadband Cable Command Reference Guide 2-328 OL-1581-08...
Page 341
128 (2048 symbols at 3.2 MHz channel width) Defaults The default settings vary, depending on the upstream’s channel width. The default values were changed in Cisco IOS Release 12.2(15)BC1 and later releases to better optimize data and voice traffic on the upstream. Table 2-12 on page 2-330 lists the default minislot values for each channel width for Cisco IOS releases before and after Cisco IOS Release 12.2(15)BC1.
Page 342
32 symbols per minislot, as required by the DOCSIS specifications. Table 2-12 lists the default minislot sizes for each channel width for Cisco IOS releases before and after Cisco IOS Release 12.2(15)BC1. Table 2-12 Default Minislot Sizes Releases Earlier than Cisco IOS Release Cisco IOS Release 12.2(15)BC1 and Later...
Page 343
The default minislot sizes provide for 8 or 16 bytes per minislot, depending on Cisco IOS release. If the default setting provides 8 bytes per minislot, then the maximum possible burst is 8 bytes * 255 minislots, or 2040 total bytes, which might not be sufficient for certain users with high guaranteed upstream speeds.
Page 344
Default modulation profiles are created, using profile numbers 1, 21, 41, 101, 121, 201, 221, and 241, depending on DOCSIS mode and the cable interface line cards being used. See Table 2-5 on page 2-171 for the list of supported profiles and cable interface line cards. Cisco Broadband Cable Command Reference Guide 2-332 OL-1581-08...
Page 345
The cable upstream modulation-profile command can assign a single modulation profile to an upstream port on the Cisco uBR7100 series routers and on all cable interface line cards that are available for the Cisco CMTS routers. This modulation profile affects all CMs and set-top boxes that are using that upstream port.
Page 346
• The upstream port is on a Cisco uBR-MC16S line card that is used on Cisco CMTS routers using Cisco IOS Release 12.1(7)CX1 or later release, or on a Cisco uBR-MC5X20S/U line card.
Page 347
Determines the order of the corrective actions to be taken when ingress priority noise exceeds the allowable value for an upstream. show cable modulation- Displays the cable modulation profiles that have been created. profile Cisco Broadband Cable Command Reference Guide 2-335 OL-1581-08...
Page 348
Cisco CMTS Configuration Commands cable upstream power-adjust cable upstream power-adjust To control power-adjustment methods on the Cisco CMTS, use the cable upstream power-adjust command in cable interface configuration mode. To return to the default values, use the no form of this command.
Page 349
0 dB because this means that the CMTS will command all CMs to continually change their power levels until the CMTS measures the power levels at exactly 0 dBmV. Cisco recommends that you set the threshold parameter to a minimum of its default value of 1 dB so that the CMs do not change their power levels continually for minuscule RF plant variations.
Page 350
CMTS will average its CM power readings before sending any power adjustments to the CMs. When a CM is in power averaging mode, the show cable flap-list show cable modem commands Note shows an asterisk (*) for that particular CM. Cisco Broadband Cable Command Reference Guide 2-338 OL-1581-08...
Page 351
Sets the input power level for the upstream radio frequency (RF) carrier. show cable flap-list Displays a list of CMs that have exceeded the threshold number of power adjustments. show cable modem Displays CM configuration settings. Cisco Broadband Cable Command Reference Guide 2-339 OL-1581-08...
Page 352
Usage Guidelines The Cisco CMTS controls the output power levels of the CMs to meet the desired upstream input power level. The nominal input power level for the upstream RF carrier is specified in decibels per millivolt (dBmV).
Page 353
5 dB within 30 seconds, the CMs on your network will be forced to re-range. When setting upstream power levels, Cisco recommends that the adjacent channels of equal bandwidth not have a large variation. The recommended maximum input power variance is 5 to 6 dB.
Page 354
CMTS. The Cisco CMTS router specifies backoff window values for both data and initial ranging and sends these values downstream as part of the Bandwidth Allocation Map (MAP) MAC message.
Page 355
Router(config-if)# Related Commands Command Description cable insertion-interval Configures the interval between consecutive initial ranging slots on an upstream. cable upstream data-backoff Specifies automatic or fixed start and stop values for data backoff. Cisco Broadband Cable Command Reference Guide 2-343 OL-1581-08...
Page 356
Upstream rate limiting allows upstream bandwidth requests from rate-exceeding CMs to be buffered without incurring TCP-related timeouts and retransmits. This enables the Cisco CMTS to enforce the peak upstream rate for each CM without degrading overall TCP performance for the subscriber CPE devices.
Page 358
0 scrambler# Related Commands Command Description cable upstream fec Enables the upstream FEC. cable upstream frequency Enters a fixed frequency of the upstream RF carrier for an upstream port. Cisco Broadband Cable Command Reference Guide 2-346 OL-1581-08...
Page 359
Cisco CMTS Configuration Commands cable upstream scrambler Command Description cable upstream power-level Sets the input power level for the upstream RF carrier in decibels per millivolt (dBmV). cable upstream shutdown Disables the upstream port. Cisco Broadband Cable Command Reference Guide 2-347 OL-1581-08...
Examples The following example shows how to disable the upstream port: router(config-if)# cable upstream 0 shutdown Related Commands Command Description shutdown Shuts down (disables) an interface and all of its ports. Cisco Broadband Cable Command Reference Guide 2-348 OL-1581-08...
Page 361
The following example shows how to assign spectrum group 12 to the first upstream on the cable interface line card in slot 5/0: Router(config)# interface cable 5/0 Router(config-if)# cable upstream 0 spectrum-group 12 Router(config-if)# exit Router(config)# Cisco Broadband Cable Command Reference Guide 2-349 OL-1581-08...
Page 362
Specifies the upstream ports in a spectrum group can share the same upstream frequency. cable upstream hopping blind Disengages the advanced spectrum management features of the Cisco uBR-MC16S and Cisco uBR-MC5X20S/U cable interface line cards by enabling blind frequency hopping behavior. Cisco Broadband Cable Command Reference Guide 2-350...
Page 363
Carrier-to-Noise Ration (CNR), use the cable upstream snr-polling command in cable interface configuration mode. cable upstream n snr-polling interval-in-ms This command can be used only on upstreams on the Cisco uBR-MC16S cable interface line cards. Note Syntax Description Specifies the upstream port number.
Page 364
Command Description show cable hop Displays the current hop period and threshold for an upstream, along with other statistics. show cable modulation- Displays the cable modulation profiles that have been created. profile Cisco Broadband Cable Command Reference Guide 2-352 OL-1581-08...
Page 365
This command can be used only on upstreams on the Cisco uBR-MC16S cable interface line cards. Note Syntax Description Specifies the upstream port number. Valid values start with 0 for the first upstream port on the cable interface line card.
Page 366
Command History Release Modification 12.1(7)CX1 This command was introduced for Cisco CMTS routers using the Cisco uBR-MC16S cable interface line card. 12.2(8)BC2 Support was added for the Cisco uBR10012 router and the Cisco uBR-LCP2-MC16S cable interface line card. Also, the ranges and defaults for the correctable and uncorrectable FEC error thresholds were changed.
Page 367
The cable timing-adjust command is applicable only on Cisco IOS Release 12.0(12)SC and Cisco IOS Note Release 12.1(3)T.
Page 368
The following example shows how to set the upstream time adjustment ranging value to 5 seconds: CMTS01(config-if)# cable upstream 0 time-adjust continue 5 The following example shows how to set the threshold value to the default of 12 seconds: CMTS01(config-if)# cable upstream 0 time-adjust threshold 12 Cisco Broadband Cable Command Reference Guide 2-356 OL-1581-08...
Page 369
The following example shows the jitter being set to 10 milliseconds (10,000 microseconds) for upstream port 0 on cable interface 2/0: Router# configure terminal Router(config)# interface c2/0 Router(config-if)# cable upstream 0 unfrag-slot-jitter limit 10000 Router(config-if)# Cisco Broadband Cable Command Reference Guide 2-357 OL-1581-08...
Page 370
Global configuration Command History Release Modification 12.2(11)BC3 This command was introduced for Cisco uBR7100 series and Cisco uBR7246VXR universal broadband routers. 12.2(15)BC2 Support for the customer option was added. Usage Guidelines This command maps a cable modem, on the basis of its hardware (MAC) address, to a particular PVC on an ATM interface.
Page 371
Displays debugging messages for the Layer 2 mapping of cable modems to a particular PVC on an ATM interface. show cable l2-vpn vc- Displays the mapping of one or all cable modems to PVCs on the ATM interfaces. Cisco Broadband Cable Command Reference Guide 2-359 OL-1581-08...
Page 372
Note The list of supported card types depends on the Cisco IOS software release being used. See the release notes for your release for the complete list of cards that are supported. Defaults An empty card slot is not preprovisioned and cannot be configured or displayed.
Page 373
Cisco uBR-MC5X20U cable interface line cards. Usage Guidelines This command preprovisions a slot in the Cisco uBR10012 router to accept a particular line card, so that you can configure the interface without the card being physically present in the chassis. This command allows system administrators to plan for future configurations, without having to wait for the physical hardware to first arrive.
Page 374
ENTITY-MIB, which shows only the equipment that is physically installed in the router. When a line card is inserted in the Cisco uBR10012 chassis, the router performs the following actions, depending on whether the card slot is preprovisioned for the card: If the inserted line card matches the type of line card preprovisioned for the slot, the system applies •...
Page 375
0 output errors, 0 collisions, 0 interface resets 0 output buffer failures, 0 output buffers swapped out Router# Related Commands Command Description show interface cable Displays the current configuration and status of a cable interface. Cisco Broadband Cable Command Reference Guide 2-363 OL-1581-08...
Page 376
CM cannot obtain this upstream channel, it does not come online. router(config)# cable config-file channeloverride.cm router(config-file)# channel-id 3 router(config-file)# exit Related Commands Command Description cable config-file Creates a DOCSIS configuration file and enters configuration file mode. access-denied Disables access to the network. Cisco Broadband Cable Command Reference Guide 2-364 OL-1581-08...
Page 377
Provides config-file options. privacy Specifies privacy options for baseline privacy images. service-class Specifies service class definitions for the configuration file. snmp manager Specifies Simple Network Management Protocol (SNMP) options. timestamp Enables time-stamp generation. Cisco Broadband Cable Command Reference Guide 2-365 OL-1581-08...
Page 378
Command History Release Modification 12.2(15)BC2 This command was introduced for the Cisco uBR7100 series and Cisco uBR7246VXR routers. Usage Guidelines DSG operation is disabled using the no cable dsg command, but this does not clear out the DSG-related counter (“mapping entry is used”), so that you can retain its value in case you intend to restart DSG operations again.
Page 379
Enables the display of debugging messages for the operation of the DOCSIS Set-Top Gateway (DSG) feature. show cable dsg Displays the current DOCSIS Set-Top Gateway (DSG) tunneling parameters. Cisco Broadband Cable Command Reference Guide 2-367 OL-1581-08...
Page 380
To reset the flap-list table for a specific CM or for all CMs connected to the Cisco CMTS, use the clear cable flap-list command in privileged EXEC mode. clear cable flap-list {mac-addr | all} [save-counters]...
Page 381
Sends a DOCSIS ping to a CM and increments the flap-list counters as appropriate. show cable flap-list Displays the current contents of the flap list. Cisco Broadband Cable Command Reference Guide 2-369 OL-1581-08...
Page 382
You can clear the counters for all interfaces on the Cisco CMTS, for one specific interface (one downstream and its associated upstreams), or for a specific upstream on a cable interface. Examples...
Page 383
The following example shows how to clear the frequency hop counters on a specific upstream on the Cisco CMTS: Router# clear cable hop c5/1/0 upstream 2 Router# Related Commands Command Description show cable hop Displays cable-hop statistics on a Cisco CMTS. show cable modem Displays CM configuration settings. Cisco Broadband Cable Command Reference Guide 2-371 OL-1581-08...
Page 384
This command removes a host’s IP and MAC addresses from the router’s internal address tables. This might be necessary to allow a new host to come online from the previous host’s CM. If the cleared host continues communicating through the CM, the Cisco CMTS adds the host back to its Note internal address tables, and the show interface cable interface modem command shows it as having a “static”...
Page 385
Command Description show cable device Display the CMs and the hosts behind the CMs on the network. access-group show cable host Displays only the hosts behind the CMs on the network. access-group Cisco Broadband Cable Command Reference Guide 2-373 OL-1581-08...
Page 386
Privileged EXEC Command History Release Modification 12.2(15)BC1 This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012 routers. Examples The following example shows how to clear all of the counters that track load-balancing operations, resetting them all to zero:...
Page 387
Command Description cable load-balance Configures how the Cisco CMTS should load balance cable modems with group policy ugs active unsolicited grant service (UGS) service flows. cable load-balance Configures the threshold values that a load-balance group should use for group threshold load-balancing operations.
Page 388
BADIPSOURCE error messages that the Cisco CMTS generates when it discovers a CM or CPE device using an unauthorized IP address. When the buffer becomes full, the oldest messages are deleted to make room for newer messages.
Page 389
Enables verification of IP addresses for CMs and CPE devices on the upstream. show cable logging Displays the log of error messages about bad IP source addresses on the cable interfaces. Cisco Broadband Cable Command Reference Guide 2-377 OL-1581-08...
Page 390
(Optional) Identifies the a interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 391
The following example shows how to clear the counters for all CMs that are currently in one of the reject states: Router# clear cable modem reject counters Router# If running Cisco IOS Release 12.2(15)BC1 or later, use the clear cable modem flap-counters command Note to clear the CM flap-list counters.
Page 392
(Optional) Identifies the a interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 393
CMs to simultaneously reset and reregister with the Cisco CMTS. In addition, if HCCP N+1 redundancy has also been configured, using the clear cable modem delete command can trigger a switchover to one or more Protect interfaces, unless no keepalive has also been configured on the cable interfaces.
Page 394
Identifies the a interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 395
Router# clear cable modem 172.12.23.45 flap-counters Router# The following example shows how to clear the counters for all CMs that have a OUI that has been defined as having the vendor name of Cisco using the cable modem vendor command:...
Page 396
Identifies the a interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 397
The following example shows how to clear the locks for all CMs that have a OUI that has been defined as having the vendor name of Cisco using the cable modem vendor command: Router# clear cable modem oui Cisco lock...
Page 398
(Optional) Identifies the a interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 399
Resets the lock on one or more CMs. lock clear cable modem Removes a CM from the Station Maintenance List and resets the CM. reset show cable modem Displays information for the registered and unregistered CMs. Cisco Broadband Cable Command Reference Guide 2-387 OL-1581-08...
(Optional) Identifies the a interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 401
CMs to simultaneously reset and reregister with the Cisco CMTS. You can also specify the MAC address or IP address for a CPE device or host, and the Cisco CMTS resets the CM that is associated with that CPE device in its internal database.
Page 402
Removes all offline CMs from the internal address and routing tables, or offline clears all flap list counters for offline CMs. show cable modem Displays the current status for one or more CMs. Cisco Broadband Cable Command Reference Guide 2-390 OL-1581-08...
Page 403
Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 404
5/0 that are using SID 113 and IP address 10.10.17.3: Router# clear cable secondary-ip interface cable 5/0 sid 113 10.10.17.3 Router# Related Commands Command Description show interface cable Displays information for a particular SID, including the known secondary IP addresses. Cisco Broadband Cable Command Reference Guide 2-392 OL-1581-08...
Page 405
This command was introduced for the Cisco uBR7200 series routers. 12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card. 12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012 12.2(4)BC1 router and Cisco uBR-LCP-MC28C card. 12.2(8)BC2...
Page 406
Displays information for all cable interfaces on which one or more HCCP groups and authentication modes have been configured. show hccp interface Displays group information for a specific cable interface on which one or more groups and authentication modes have been configured. Cisco Broadband Cable Command Reference Guide 2-394 OL-1581-08...
Page 407
Privileged EXEC Command History Release Modification 12.2(8)BC2 This command was introduced for the Cisco uBR7200 series universal broadband router. 12.2(15)BC1 Support was added for the Cisco uBR10012 router. Usage Guidelines This command clears the counter that tracks the total number of gates that the CMTS has moved into the COMMITTED state since the CMTS was last reset or since the counters were last cleared.
Page 408
The CM enforces the limitation imposed by the cpe max command, but the CMTS might enforce its own lower number of CPE devices. On Cisco CMTS routers, a cpe-num value of 0 enables an unlimited number of hosts, but on some CMs, this value provides only 0 hosts.
Page 410
{image filename [oui oui-list] | server ip-address} no download {image filename [oui oui-list] | server ip-address} Because of conflicts with other Cisco IOS commands, you cannot abbreviate the no form of this Note command. You must specify the complete command name and option, such as no download image or no download server.
Page 411
Provides config-file options. privacy Specifies privacy options for baseline privacy images. service-class Specifies service class definitions for the configuration file. snmp manager Specifies Simple Network Management Protocol (SNMP) options. timestamp Enables time-stamp generation. Cisco Broadband Cable Command Reference Guide 2-399 OL-1581-08...
Page 412
Router(enforce-rule)# exit Router(config)# The following example shows an enforce-rule being disabled. The rule remains in the CMTS configuration file: Router# configure terminal Router(config)# cable qos enforce-rule residential Router(enforce-rule)# no enabled Router(enforce-rule)# exit Router(config)# Cisco Broadband Cable Command Reference Guide 2-400 OL-1581-08...
Page 413
Displays the quality of service (QoS) enforce-rules that are currently enforce-rule defined. show cable Displays subscribers that are violating their registered quality of service subscriber-usage (QoS) profiles. Cisco Broadband Cable Command Reference Guide 2-401 OL-1581-08...
Page 414
0. Both the originally provisioned QoS profile and the enforced Note QoS profile must be created on the Cisco CMTS. This option does not support profiles that are created by the CM. no-persistence (Optional) Specifies that the enforced QoS profile should not remain in force when a cable modem reboots.
Page 415
When the no-persistence option is specified, the enforced QoS profile is still automatically applied to subscribers that violate their bandwidth requirements. However, when the cable modem reboots, the Cisco CMTS allows the cable modem to use the QoS profile that is specified in its DOCSIS configuration file.
Page 416
Displays the quality of service (QoS) enforce-rules that are currently enforce-rule defined. show cable Displays subscribers that are violating their registered quality of service subscriber-usage (QoS) profiles. Cisco Broadband Cable Command Reference Guide 2-404 OL-1581-08...
Page 417
CM cycles offline each time the configuration file is received. Examples The following example shows how to specify the downstream center frequency for a DOCSIS configuration file: router(config)# cable config-file fixedfreq.cm router(config-file)# frequency 453000000 router(config)# exit Cisco Broadband Cable Command Reference Guide 2-405 OL-1581-08...
Page 418
Provides config-file options. privacy Specifies privacy options for baseline privacy images. service-class Specifies service class definitions for the configuration file. snmp manager Specifies Simple Network Management Protocol (SNMP) options. timestamp Enables time-stamp generation. Cisco Broadband Cable Command Reference Guide 2-406 OL-1581-08...
Page 419
This command was introduced for the Cisco uBR7200 series routers. 12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card. 12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012 12.2(4)BC1 router and Cisco uBR-LCP-MC28C card. 12.2(8)BC2...
Page 420
Displays information for all cable interfaces on which one or more HCCP groups and authentication modes have been configured. show hccp interface Displays group information for a specific cable interface on which one or more groups and authentication modes have been configured. Cisco Broadband Cable Command Reference Guide 2-408 OL-1581-08...
Page 421
This command was introduced for the Cisco uBR7200 series routers. 12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card. 12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012 12.2(4)BC1 router and Cisco uBR-LCP-MC28C card. 12.2(8)BC2...
Page 422
Displays information for all cable interfaces on which one or more HCCP groups and authentication modes have been configured. show hccp interface Displays group information for a specific cable interface on which one or more groups and authentication modes have been configured. Cisco Broadband Cable Command Reference Guide 2-410 OL-1581-08...
Page 423
Cisco RF Switch. Usage Guidelines By default, the Cisco CMTS verifies that the Working and Protect cable interfaces are using the same versions of software and hardware, so as to avoid potential incompatibilities during a switchover. The hardware check verifies that the Working and Protect cable interface line cards are compatible. The software check verifies that the two cards are running the same major versions of software.
Page 424
The following example shows how to disable the hardware and software version checks for HCCP group number 20. After giving this command, the Cisco CMTS will switchover from the Working to Protect interface in group 20 without first verifying the cards’ compatibility:...
Page 425
To configure the Cisco CMTS so that a Cisco RF Switch or VCom (Wavecom) upconverter becomes a Hot Standby Connection-to-Connection Protocol (HCCP) member in a particular HCCP group, use the hccp channel-switch command in cable interface configuration mode. To remove the configuration for the Cisco RF Wwitch or upconverter, use the no form of this command.
Page 426
The valid range is 1 to 255. Defaults The CMTS is not configured to use a Cisco RF Switch by default, and no cable interfaces are configured for N+1 redundancy by default.
Page 427
IP address of 10.97.1.21. The upconverter’s module number 2 (B) is used for the Protect interface, and module number 16 (P) is used for the Working interface. The interface uses the Cisco RF Switch at IP address 10.97.1.20, using a module bitmap of AA200000 in switch slot 1.
Page 428
Cisco RF Switch. Usage Guidelines By default, the Cisco CMTS verifies that the Working and Protect cable interfaces are using the same versions of software and hardware, so as to avoid potential incompatibilities during a switchover. The hardware check verifies that the Working and Protect cable interface line cards are compatible. The software check verifies that the two cards are running the same major versions of software.
Page 429
Displays information for all cable interfaces on which one or more HCCP groups and authentication modes have been configured. show hccp interface Displays group information for a specific cable interface on which one or more groups and authentication modes have been configured. Cisco Broadband Cable Command Reference Guide 2-417 OL-1581-08...
Page 430
This command has been deprecated in current Cisco IOS releases and has been replaced by the hccp Note channel-switch command.
Page 431
(replaces the hccp ds-switch command). hccp protect Allows you to configure a Cisco CMTS to be a Protect CMTS for a specified Working CMTS in a 1+1 redundancy environment. hccp working Allows you to designate a Cisco CMTS to be a Working CMTS in a 1+1 redundancy environment.
Page 432
This command was introduced for the Cisco uBR7200 series routers. 12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card. 12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012 12.2(4)BC1 router and Cisco uBR-LCP-MC28C card. 12.2(8)BC2...
Page 433
Displays information for all cable interfaces on which one or more HCCP groups and authentication modes have been configured. show hccp interface Displays group information for a specific cable interface on which one or more groups and authentication modes have been configured. Cisco Broadband Cable Command Reference Guide 2-421 OL-1581-08...
Page 434
The protect cable interface must be configured identically to the working cable interface, which typically means the interfaces must be the same card type. However, when the Cisco uBR-MC16S card is used, it can be used with either another Cisco uBR-MC16S card or a Cisco uBR-MC16C card.
Page 435
Cisco uBR-MC16C performs only blind frequency hopping. Cisco uBR-MC16S Cisco uBR-MC16S The protect card initially uses the same upstream frequency as the working card, but after the system stabilizes, the protect card continues using the enhanced spectrum management features of the Cisco uBR-MC16S card.
Page 436
Cisco RF Switch. Usage Guidelines The Cisco CMTS automatically synchronizes the Working and Protect interfaces to ensure that when a switchover occurs, the Protect interface will run with a configuration that is identical to that of the Working interface. However, if you are troubleshooting HCCP problems, you can manually resynchronize the databases using the hccp resync command before performing any switchover tests.
Page 437
Displays information for all cable interfaces on which one or more HCCP groups and authentication modes have been configured. show hccp interface Displays group information for a specific cable interface on which one or more groups and authentication modes have been configured. Cisco Broadband Cable Command Reference Guide 2-425 OL-1581-08...
Page 438
This command was introduced for the Cisco uBR7200 series routers. 12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card. 12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012 12.2(4)BC1 router and Cisco uBR-LCP-MC28C card. 12.2(8)BC2...
Page 439
Displays information for all cable interfaces on which one or more HCCP groups and authentication modes have been configured. show hccp interface Displays group information for a specific cable interface on which one or more groups and authentication modes have been configured. Cisco Broadband Cable Command Reference Guide 2-427 OL-1581-08...
Page 440
This command was introduced for the Cisco uBR7200 series routers. 12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card. 12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012 12.2(4)BC1 router and Cisco uBR-LCP-MC28C card. 12.2(8)BC2...
Page 441
Displays information for all cable interfaces on which one or more HCCP groups and authentication modes have been configured. show hccp interface Displays group information for a specific cable interface on which one or more groups and authentication modes have been configured. Cisco Broadband Cable Command Reference Guide 2-429 OL-1581-08...
Page 442
This command was introduced for the Cisco uBR7200 series routers. 12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card. 12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012 12.2(4)BC1 router and Cisco uBR-LCP-MC28C card. 12.2(8)BC2...
Page 443
Displays information for all cable interfaces on which one or more HCCP groups and authentication modes have been configured. show hccp interface Displays group information for a specific cable interface on which one or more groups and authentication modes have been configured. Cisco Broadband Cable Command Reference Guide 2-431 OL-1581-08...
Page 444
This command was introduced for the Cisco uBR7200 series routers. 12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card. 12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012 12.2(4)BC1 router and Cisco uBR-LCP-MC28C card. 12.2(8)BC2...
Page 445
Displays information for all cable interfaces on which one or more HCCP groups and authentication modes have been configured. show hccp interface Displays group information for a specific cable interface on which one or more groups and authentication modes have been configured. Cisco Broadband Cable Command Reference Guide 2-433 OL-1581-08...
Page 446
This command was introduced for the Cisco uBR7200 series routers. 12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card. 12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012 12.2(4)BC1 router and Cisco uBR-LCP-MC28C card. 12.2(8)BC2...
Page 447
Configuration keepalive or no keepalive no keepalive keepalive or no keepalive Examples The following example shows switchover behavior being enabled on a Cisco CMTS in group 2: Router(config)# interface c3/0 Router(config-if)# hccp 2 track Router(config-if)# keepalive Router(config-if)# The following example shows two Cisco uBR-LCP2-MC28C cards being used in a Cisco uBR10012 router, with each downstream being configured for a separate HCCP group.
Page 448
A global configuration command that allows you to specify the keepalive message transmission interval on a Working CMTS or Protect CMTS. For more specific information, see the Cisco IOS Interface Command Reference on Cisco.com. show hccp Displays information for all cable interfaces on which one or more HCCP groups and authentication modes have been configured.
Page 449
This command was introduced for the Cisco uBR7200 series routers. 12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card. 12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012 12.2(4)BC1 router and Cisco uBR-LCP-MC28C card. 12.2(8)BC2...
Page 450
Displays information for all cable interfaces on which one or more HCCP groups and authentication modes have been configured. show hccp interface Displays group information for a specific cable interface on which one or more groups and authentication modes have been configured. Cisco Broadband Cable Command Reference Guide 2-438 OL-1581-08...
Page 451
The Protect cable interface must be configured identically to the Working cable interface, which typically means the interfaces should be the same card type. However, when the Cisco uBR-MC16S is used, it can be used with either another Cisco uBR-MC16S card or a Cisco uBR-MC16C card.
Page 452
Cisco uBR-MC16C performs only blind frequency hopping. Cisco uBR-MC16S Cisco uBR-MC16S The protect card initially uses the same upstream frequency as the working card, but after the system stabilizes, the protect card continues using the enhanced spectrum management features of the Cisco uBR-MC16S card.
To configure the Cisco CMTS so that it inserts the MAC address of a CM into the DHCP packet received from a CM or host before it forwards the packet to a DHCP server, use the ip dhcp relay information option in global configuration mode.
Page 454
Identifies the IP address of the Dynamic Host Configuration Protocol server (DHCP) server that the telco-return CM must access. ip dhcp smart-relay Monitors client retransmissions when the IP DHCP address pool depletion occurs. Cisco Broadband Cable Command Reference Guide 2-442 OL-1581-08...
Page 455
CM or host and forward the packet to a DHCP server. cable source-verify Turns on CM upstream verification. cable telco-return spd dhcp- Enforces the telco-return CM to use a specific DHCP server. authenticate Cisco Broadband Cable Command Reference Guide 2-443 OL-1581-08...
Page 456
Enables the system to insert the CM MAC address into a DHCP option packet received from a CM or host and forward the packet to a DHCP server. Cisco Broadband Cable Command Reference Guide 2-444 OL-1581-08...
Page 457
The sample-rate interval must be less than or equal to the monitoring-duration period. If you attempt Note to set the sample-rate to a value greater than the monitor-duration period, the command is ignored and the parameters are unchanged. Cisco Broadband Cable Command Reference Guide 2-445 OL-1581-08...
Page 458
Specifies the number of bytes that a subscriber can transmit during the count monitoring period. cable qos enforce-rule Creates an enforce-rule to be used to enforce a particular quality of service (QoS) profile and enters enforce-rule configuration mode. Cisco Broadband Cable Command Reference Guide 2-446 OL-1581-08...
Page 459
Displays the quality of service (QoS) enforce-rules that are currently enforce-rule defined. show cable Displays subscribers that are violating their registered quality of service subscriber-usage (QoS) profiles. Cisco Broadband Cable Command Reference Guide 2-447 OL-1581-08...
Page 460
These options are defined in the DOCSIS Radio Frequency (RF) Interface Specification. However, certain options are not allowed because they are either reserved for DOCSIS use or because they are specified using other cable config-file commands. Cisco Broadband Cable Command Reference Guide 2-448 OL-1581-08...
Page 461
For example, Cisco CMs support a vendor-specific suboption (128) that instructs the CM to download and execute a Cisco IOS configuration file. The data for this suboption is the fully qualified path name of the Cisco IOS configuration file on the TFTP server. Other vendors, however, could define vendor- specific suboption 128 to have a totally different function.
Page 462
TLV format. The TLV for the Cisco vendor ID would be 08:03:00:00:0C, where 08 is the suboption type, 03 is the length, and 00:00:0C is the Cisco OUI vendor ID. If the Cisco IOS filename is ios.cfg, the second TLV would be 80:07:69:6F:73:2E:63:66:67, where 80 is the suboption type (128 decimal), 07 is the length of the data, and the data is the filename expressed in hexadecimal ASCII values.
Page 463
The following example shows how to configure a Cisco uBR924, Cisco uBR925, or Cisco CVA122 so that it downloads a Cisco IOS configuration file named ios.cfg and configures the router for two voice ports. Three vendor-specific options are included: suboption 8, which specifies the vendor ID, suboption 128, which specifies the configuration file name, and suboption 10, which specifies the number of active voice ports.
Page 464
Chapter 2 Cisco CMTS Configuration Commands option Table 2-22 lists the two TLVs shown in this example: Table 2-22 TLV Values to Enable the Cisco Cable Monitor Type Length Value TLV 1—Vendor ID, Suboption 8 00:00:0C (the ID for Cisco cable equipment) TLV2—Cisco IOS Command, Suboption 131...
Page 465
PacketCable operations. In Cisco IOS Release 12.2(11)BC1 and later releases, this command also automatically creates a random Element ID for the CMTS that is in the range of 0 and 99,999. To ensure that this Element ID is unique...
Page 466
Displays information about one or more gates in the gate database. show packetcable gate Displays the total number of committed gates since system reset or since the counter commit counter was last cleared. show packetcable Displays the current PacketCable configuration. global Cisco Broadband Cable Command Reference Guide 2-454 OL-1581-08...
Page 467
To allow Unsolicited Grant Service (UGS) service flows without a proper PacketCable gate ID when PacketCable operations are enabled on the Cisco CMTS, use the packetcable authorize vanilla-docsis- mta command in global configuration mode. To prevent CMs from requesting non-PacketCable UGS service flows when PacketCable operations are enabled, use the no form of this command.
Page 468
Resets the counters that track the total number of committed gates. counter commit packetcable Enables PacketCable operations on the Cisco CMTS. packetcable element- Configures the PacketCable Event Message Element ID. packetcable gate Changes the maximum number of PacketCable gate IDs in the gate database maxcount on the Cisco CMTS.
Page 469
To configure the PacketCable Event Message Element ID on the Cisco CMTS, use the packetcable element-id command in global configuration mode. To reset the counter to its default value, use the no form of this command.
Page 470
Cisco CMTS Configuration Commands packetcable element-id Related Commands Command Description packetcable Enables PacketCable operations on the Cisco CMTS. packetcable authorize Allows Unsolicited Grant Service (UGS) service flows without a proper vanilla-docsis-mta PacketCable gate ID when PacketCable operations are enabled on the Cisco CMTS.
Page 471
To change the maximum number of PacketCable gate IDs in the gate database on the Cisco CMTS, use the packetcable gate maxcount command in global configuration mode. To reset the counter to its default value, use the no form of this command.
Page 472
Related Commands Command Description packetcable Enables PacketCable operations on the Cisco CMTS. packetcable authorize Allows Unsolicited Grant Service (UGS) service flows without a proper vanilla-docsis-mta PacketCable gate ID when PacketCable operations are enabled on the Cisco CMTS.
Page 473
Global Configuration Command History Release Modification 12.2(8)BC2 This command was introduced for the Cisco uBR7200 series universal broadband router. 12.2(11)BC2 The T2 and T5 timers were removed to conform to the requirements of the PacketCable DQoS Engineering Change Notice (ECN) 02148.
Page 474
Router(config)# packetcable timer T0 20000 Router(config)# Related Commands Command Description packetcable Enables PacketCable operations on the Cisco CMTS. packetcable authorize Allows Unsolicited Grant Service (UGS) service flows without a proper vanilla-docsis-mta PacketCable gate ID when PacketCable operations are enabled on the Cisco CMTS.
Page 475
If a cable modem has multiple service flows, and the cable modem enters the penalty period because one Note of its service flows has exceeded its allowable bandwidth, monitoring on the other service flows stops until the modem exits the penalty period. Cisco Broadband Cable Command Reference Guide 2-463 OL-1581-08...
Page 476
Displays the quality of service (QoS) enforce-rules that are currently enforce-rule defined. show cable Displays subscribers that are violating their registered quality of service subscriber-usage (QoS) profiles. Cisco Broadband Cable Command Reference Guide 2-464 OL-1581-08...
Support was added to the Release 12.2 BC train. Usage Guidelines The DOCSIS ping is a unique Cisco patented technology that allows a cable operator to quickly diagnose the health of a channel between the CMTS and any particular DOCSIS cable CPE device. The DOCSIS ping is similar in concept to the IP ping but uses the lower MAC layer instead of the datalink or transport layers.
Page 478
If a CM is already in the flap list, the ping docsis command increments the hit, miss, and power- Note adjustment fields for it in the cable flap list. Cisco Broadband Cable Command Reference Guide 2-466 OL-1581-08...
Page 479
CM that has not yet registered with the CMTS. router# ping docsis 192.168.100.111 Cable modem with IP address 192.168.100.111 not registered. Please try using MAC address instead. router# ping docsis 0123.4567.89ab Cable modem with MAC address 0123.4567.89ab not registered. router# Cisco Broadband Cable Command Reference Guide 2-467 OL-1581-08...
Page 480
Clears all the entries in the flap-list table. ping Outputs one or more IP ping requests to a particular IP address. show cable flap-list Displays the current contents of the flap list. Cisco Broadband Cable Command Reference Guide 2-468 OL-1581-08...
Page 481
Specifying the privacy command without any of the keywords and arguments enables BPI encryption and decryption for the CM. In addition to this command, you must also specify the service-class privacy command to enable BPI operations on the cable modem. Cisco Broadband Cable Command Reference Guide 2-469 OL-1581-08...
Page 482
The privacy command appears and is supported only in images with support for BPI or BPI+ encryption. Note This option configures the CM for BPI or BPI+ encryption. To use BPI encryption, the Cisco CMTS must also be configured for BPI or BPI+ encryption, using the cable privacy command.
Page 483
QoS profile are no longer managed by the Subscriber Traffic Management feature. Instead, the rule begins managing those cable modems that use the new registered QoS profile. The registered QoS profile must be created on the Cisco CMTS before you can assign it to an enforce- Note rule.
Page 484
QoS profile. show cable qos Displays the quality of service (QoS) enforce-rules that are currently enforce-rule defined. show cable Displays subscribers that are violating their registered quality of service subscriber-usage (QoS) profiles. Cisco Broadband Cable Command Reference Guide 2-472 OL-1581-08...
Page 485
7 is the highest-priority service-class setting. privacy Enables baseline privacy interface (BPI). Defaults Service-class is not set by default. A CM cannot register on a Cisco CMTS unless at least one parameter in a service class is specified. Command Modes Cable config-file configuration...
Page 486
Specifies download information for the configuration file. frequency Specifies downstream frequency. option Provides config-file options. privacy Specifies privacy options for baseline privacy images. snmp manager Specifies Simple Network Management Protocol (SNMP) options. timestamp Enables time-stamp generation. Cisco Broadband Cable Command Reference Guide 2-474 OL-1581-08...
12.2(4)BC1 Support was added to the Release 12.2 BC train. Usage Guidelines For SNMP commands that affect the operation of the CMTS, see the Cisco IOS Configuration Fundamentals Command Reference Guide. Examples The following example shows how to specify the IP address of the SNMP manager in a DOCSIS configuration file: router(config)# cable config-file snmp.cm...
Page 488
Chapter 2 Cisco CMTS Configuration Commands snmp manager Command Description privacy Specifies privacy options for baseline privacy images. service-class Specifies service class definitions for the configuration file. timestamp Enables time-stamp generation. Cisco Broadband Cable Command Reference Guide 2-476 OL-1581-08...
Page 489
CISCO-DOCS-REMOTE-QUERY-MIB. dmic-lock Enables traps that are sent when a cable modem fails the dynamic shared- secret security checks, as defined in CISCO-DOCS-EXT-MIB. enfrule-violation Enables traps that are sent when a user violates their quality of service (QoS) profile, as defined in the CISCO-CABLE-QOS-MONITOR-MIB.
Page 490
12.2(15)BC21 The dmic-lock and usage options were added. Usage Guidelines For other SNMP commands that affect the operation of the CMTS, see the Cisco IOS Configuration Fundamentals Command Reference Guide. Examples The following example shows how to enable all traps for cable-related events except HCCP switchovers...
Page 491
RSP) requests. Defaults No SNMP traps for DOCSIS-related events are enabled. When the snmp-server enable traps docsis- cmts command is given without any options, all DOCSIS-related traps are enabled. Command Modes Global configuration Cisco Broadband Cable Command Reference Guide 2-479 OL-1581-08...
Page 492
This command enables traps that are defined in the DOCS-CABLE-DEVICE-TRAP-MIB MIB. For other SNMP commands that affect the operation of the CMTS, see the Cisco IOS Configuration Fundamentals Command Reference Guide. Examples The following example shows how to enable traps for the failure of DOCSIS registration-related events...
Page 493
Disables access to the network. channel-id Specifies upstream channel ID. cpe max Specifies CPE information. download Specifies download information for the configuration file. frequency Specifies downstream frequency. option Provides config-file options. Cisco Broadband Cable Command Reference Guide 2-481 OL-1581-08...
Page 494
Cisco CMTS Configuration Commands timestamp Command Description privacy Specifies privacy options for baseline privacy images. service-class Specifies service class definitions for the configuration file. snmp manager Specifies Simple Network Management Protocol (SNMP) options. Cisco Broadband Cable Command Reference Guide 2-482 OL-1581-08...
Page 495
To configure the Cisco CMTS router for the range of frequencies that are acceptable on upstreams, use the upstream freq-range command in global configuration mode. To restore the default value of North American ranges, use the no form of this command.
Page 496
The following example shows all of the commands that are needed to configure the cable interface and upstream on a Cisco uBR-MC28U/X cable interface line card to support a frequency in the EuroDOCSIS upstream frequency range of 5 MHz to 65 MHz:...
Page 497
Cisco IOS releases documented at time of this publication. Note Not all Cisco IOS releases support all Cisco CMTS platforms. See the release notes for each Cisco IOS release for details on which platforms are supported.
Page 498
• • show tech-support Cisco IOS Release 12.2(15)BC1 Cisco uBR7100 series routers, The 12.2 BC train is the Cisco cable-specific early Cisco uBR7200 series routers, deployment release train that provides DOCSIS 1.1 and Cisco uBR10012 router other new feature support.
Page 499
The show cable commands display the most current information for standard cable interface line cards, such as the Cisco uBR-MC16C, Cisco uBR-MC16S, and Cisco uBR-MC28C cards. If the card itself is down, the show cable commands still show whatever information is appropriate (such as offline cable modems and flap list information).
Page 500
• show cable modem registered • show cable modem remote-query • show cable modem rogue • show cable modem summary • show cable modem unregistered • show cable modem vendor • Cisco Broadband Cable Command Reference Guide OL-1581-08...
Page 501
• show interface cable upstream • • show packetcable event show packetcable gate • show packetcable gate counter commit • show packetcable global • show tech-support • show version • Cisco Broadband Cable Command Reference Guide OL-1581-08...
Page 502
Displays information for all CMs on the specified cable interface and downstream port on the Cisco uBR7246VXR router. On the Cisco uBR7246VXR router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 503
Examples The following example shows the typical output from the show cable arp-filter command on a Cisco uBR10012 router. The displays for other Cisco CMTS platforms are similar. Router# show cable arp-filter Cable5/0/0 ARP Filter statistics for Cable5/0/0:...
Page 504
Router# show cable arp-filter c5/0/0 replies-filtered 200 MAC Address IP Address Req-Filtered Req-For-IP-Filtered Rep-Filtered 0006.53b6.562f 50.3.81.6 2358 Router# show cable arp-filter c5/0/0 replies-filtered 200 MAC Address IP Address Req-Filtered Req-For-IP-Filtered Rep-Filtered 0006.53b6.562f 50.3.81.6 4016 Router# Cisco Broadband Cable Command Reference Guide OL-1581-08...
Page 505
Rep-Filtered 0006.2854.72d7 10.3.81.4 0007.0e02.b747 10.3.81.31 0007.0e03.2c51 10.3.81.31 12407 00C0.c726.6b14 10.3.81.31 Router# clear counter cable 5/1/0 Clear "show interface" counters on this interface [confirm] y 08:17:53.968: %CLEAR-5-COUNTERS: Clear counter on interface Cable5/1/0 by console Cisco Broadband Cable Command Reference Guide OL-1581-08...
Page 506
Clears the ARP table on the router. clear counters Clears the packet counters on all interfaces or on a specific interface. debug cable arp filter Displays debugging messages about the filtering of ARP broadcasts. Cisco Broadband Cable Command Reference Guide 3-10 OL-1581-08...
Page 508
The value of the sublink pointer for this bundle entry. This value is useful only to TAC engineers during debugging. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 509
To display the upstream data burst profiles used to configure the upstream PHY, use the show cable burst-profile command in privileged EXEC mode. show cable burst-profile This command has been deprecated and removed in the current versions of the Cisco IOS software for Note all Cisco CMTS routers.
Page 510
Scrambl Indicates whether scramble is enabled (yes) or not (no). In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands...
Page 511
This command supports the Cisco CMTS clock feature set, which provides a synchronized clock for improved Voice-over-IP (VoIP) operations. The clock feature set requires one of the following configurations: A Cisco uBR10012 router with one or two TCC+ cards that are connected to an external national • clock source.
Page 512
Cable4/0 Timestamp clock reference is from Clockcard The following sample output from the show cable clock command on a Cisco uBR10012 router shows that both external sources are available and that the TCC+ card in slot 1/1 is providing the clock...
Page 513
To display a list of CMs and their customer premises equipment (CPE) devices, along with their access groups, use the show cable device access group command in privileged EXEC mode. show cable device [ip-address] access-group The show cable device access-group command is not supported on the Cisco uBR10012 universal Note broadband router.
Displays the access group name or number in use (if any) for this CM or CPE device. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 515
Displays the hosts behind the CMs in the network, along with their access groups. show cable modem access-group Displays the access groups for the CMs on a particular cable interface. Cisco Broadband Cable Command Reference Guide 3-19 OL-1581-08...
Page 516
Privileged EXEC Command History Release Modification 12.2(15)BC2 This command was introduced for the Cisco uBR7100 series and Cisco uBR7246VXR routers. Examples The following example shows a typical display for the show cable dsg tunnel command: Router# show cable dsg tunnel...
Page 517
The Received, Forwarded, and Dropped counters are not displayed when an interface is shut down. Router(config)# interface c5/1 Router(config-if)# shutdown Router(config-if)# exit Router(config)# exit Router# show cable dsg stats vendor CCC DSG statistics information Cisco Broadband Cable Command Reference Guide 3-21 OL-1581-08...
Page 518
The field is not shown when an interface is shut down, but the counter continues to increase as long as the multicast group is receiving traffic. When the interface is reenabled, the counter shows the latest number of packets received. Cisco Broadband Cable Command Reference Guide 3-22 OL-1581-08...
Page 519
Resets counters related to DOCSIS Set-Top Gateway (DSG) tunnels. debug cable dsg Enables the display of debugging messages for the operation of the DOCSIS Set-Top Gateway (DSG) feature. Cisco Broadband Cable Command Reference Guide 3-23 OL-1581-08...
Page 520
Modification 12.1(6)EC1 This command was introduced on the Cisco uBR7100 series and Cisco uBR7200 series routers. 12.2(2)XF, 12.2(4)BC1 This command was supported on the Cisco uBR10012 routers. 12.2(8)BC2 An option was added to the cable filter group command to allow filter groups to be activated and deactivated without removing the filter group’s...
Page 521
Note Related Commands Command Description cable filter group Creates, configures, and activates a DOCSIS 1.1 filter group that filters packets on the basis of the TCP/IP and UDP/IP headers. Cisco Broadband Cable Command Reference Guide 3-25 OL-1581-08...
Page 522
Cisco CMTS Show Commands show cable flap-list show cable flap-list To display the cable flap-list on a Cisco CMTS, use the show cable flap-list command in user EXEC or privileged EXEC mode. show cable flap-list show cable flap-list cable {slot/port | slot/subslot/port} [upstream port] [sort-flap | sort-int | sort-...
Page 523
Usage Guidelines The sort options operate differently on the different Cisco CMTS routers. On the Cisco uBR7100 series and Cisco uBR7200 series routers, the sort options apply to all cable interface line cards and merge the output into a single display.
Page 524
Time The most recent time that the CM dropped the connection. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands...
Page 525
Sends a DOCSIS ping to a CM and increments the flap-list counters as appropriate. show cable modem Displays information about all CMs on an interface or about a particular CM. show cable modem Displays flap list statistics for one or more cable modems. flap Cisco Broadband Cable Command Reference Guide 3-29 OL-1581-08...
Page 526
Cisco CMTS Show Commands show cable hop show cable hop To display cable-hop statistics on a Cisco CMTS, use the show cable hop command in user EXEC or privileged EXEC mode. show cable hop [cable slot/port [upstream uport] ] show cable hop [cable slot/subslot/port [upstream uport] ]...
Page 527
FEC errors per packets, where a packet could contain multiple codewords. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 528
Clears the forward error corrections (FEC) hop counters on one or all cable interfaces on a Cisco CMTS. show cable host Displays the statistics for the host behind the CM. access-group show cable modem Displays CM configuration settings. Cisco Broadband Cable Command Reference Guide 3-32 OL-1581-08...
Page 529
EXEC mode. show cable host [ip-address | mac-address] access-group The show cable host command is not supported on the Cisco uBR10012 universal broadband router. Note Syntax Description mac-addr (Optional) Specifies the 48-bit hardware address for a particular CM or host.
Page 530
Displays the access group name or number in use (if any) for this CPE device. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 531
Command Modes Privileged EXEC Command History Release Modification 12.2(15)BC2 This command was introduced for Cisco uBR7246VXR universal broadband routers. Usage Guidelines This command displays the cable modem to VLAN mappings that have been defined using the cable dot1q-vc-map command. It displays the MAC address, service ID (SID), and cable interface being used by the cable modem, and the interface and VLAN ID to which it has been mapped.
Page 532
Total US pkts/bytes Total number of packets and bytes sent on the upstream to the Layer 2 tunnel by this cable modem. Total DS pkts/bytes Total number of packets and bytes received on the downstream from the Layer 2 tunnel by this cable modem. Cisco Broadband Cable Command Reference Guide 3-36 OL-1581-08...
Page 533
Maps a cable modem to a particular VLAN on a local outbound Ethernet interface. debug cable l2-vpn Displays debugging messages for the Layer 2 mapping of cable modems to particular PVCs or VLANs. Cisco Broadband Cable Command Reference Guide 3-37 OL-1581-08...
Page 534
Privileged EXEC Command History Release Modification 12.2(11)BC3 This command was introduced for Cisco uBR7100 series and Cisco uBR7246VXR universal broadband routers. 12.2(15)BC2 Support was added for the customer option. Usage Guidelines This command displays the cable modem to ATM PVC mappings that have been defined using the...
Page 535
Maps a cable modem to a particular PVC on an ATM interface. debug cable l2-vpn Displays debugging messages for the Layer 2 mapping of cable modems to particular PVC on an ATM interface. Cisco Broadband Cable Command Reference Guide 3-39 OL-1581-08...
Page 536
The show cable leasequery-filter command displays the total number of DHCP LEASEQUERY requests that have been filtered on a Cisco Cable Modem Termination System (CMTS) router and on a particular cable interface. This command can also optionally display details for each particular cable modem on an interface that has had DHCP lease queries filtered.
Page 537
IP addresses on all cable downstream interfaces on the downstream Cisco CMTS router. cable source-verify Controls the number of DHCP lease query messages that are sent for leasequery-filter unknown IP addresses per each service ID (SID) on an upstream. upstream Cisco Broadband Cable Command Reference Guide 3-41 OL-1581-08...
Page 538
Command Modes Privileged EXEC Command History Release Modification 12.2(15)BC1 This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012 routers. Usage Guidelines Use the show cable load-balance command to display the current, real-time statistics for load-balancing operations. Examples The following example shows typical output for the default display for the show cable load-balance...
Page 539
Cable5/0/0 (669 MHz) up Cable5/0/0/U0 Cable5/0/0/U1 [enforce] Cable5/0/0/U1 initial Cable5/0/0/U2 down Cable5/0/0/U3 down Cable6/0/0 (663 MHz) up 453 MHz Cable6/0/0/U0 Cable6/0/0/U2 [enforce] Cable6/0/0/U2 Cable6/0/0/U2 suspicious 1 Cable6/0/0/U3 Cable8/0/0 (453 MHz) up Cable8/0/0/U0 Cisco Broadband Cable Command Reference Guide 3-43 OL-1581-08...
Page 540
Fields for the Default Displays and for the load Option Interface Cable interface (downstream or upstream) that belongs to a load-balance group. Group Number of the load-balance group to which this cable interface has been assigned. Cisco Broadband Cable Command Reference Guide 3-44 OL-1581-08...
Page 541
Percentage of bandwidth that is currently reserved by unsolicited grant service (UGS) service flows. Modems Number of cable modems currently online this cable interface. Flows Number of active service flows currently on this cable interface. Cisco Broadband Cable Command Reference Guide 3-45 OL-1581-08...
Page 542
Additional Fields When Displaying Load-Balance Groups Interval How often, in seconds, the Cisco CMTS determines the current load on each cable interface in the load balance group, as configured using the cable load-balance group interval command.
Page 543
Hardware (MAC) address for the cable modem that is current in the process of being moved as part of load balancing operations. Source interface Downstream or upstream cable interface on which the cable modem is currently online. Cisco Broadband Cable Command Reference Guide 3-47 OL-1581-08...
Page 544
Configures the frequency of the load-balancing policy updates. group interval cable load-balance Configures how the Cisco CMTS should load balance cable modems with group policy ugs active unsolicited grant service (UGS) service flows. cable load-balance Configures the threshold values that a load-balance group should use for group threshold load-balancing operations.
Page 545
BADIPSOURCE error messages that the Cisco CMTS generates when it discovers a CM or CPE device using an unauthorized IP address. Similarly, the cable logging layer2events command creates a buffer to contain the system messages that are generated for DOCSIS-layer (Layer2) events.
Page 546
The Broadband Processing Engine (BPE) cable interface line cards (such as the Cisco uBR-MC16U/X and Cisco uBR-MC28U/X) contain an onboard processor that also maintains its own log buffer. To display the contents of this log, add the card’s slot number after the show cable logging command.
Page 547
Enables verification of IP addresses for CMs and CPE devices on the upstream. clear cable logging Removes all error messages about bad IP source addresses on the cable interfaces from the error log buffer. Cisco Broadband Cable Command Reference Guide 3-51 OL-1581-08...
On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface. cable slot/subslot/port (Optional) Displays information for all CMs on the specified cable interface on the Cisco uBR10012 router.
Page 549
Release Modification 12.0(7)XR and The output of this command was enhanced to show that the Cisco CMTS 12.1(1a)T1 has detected an unstable return path for a particular CM and has compensated with a power adjustment. An asterisk (*) appears in the power adjustment field for a modem when a power adjustment has been made;...
Page 550
Cisco CMTS Show Commands show cable modem You can also specify the MAC address or IP address for a CPE device, and the Cisco CMTS will display the information for the CM that is associated with that CPE device in its internal database.
Page 551
Prim RxPwr Timing Num State (db) Offset CPEs Enbld 0010.7bb3.fcd1 10.20.113.2 C5/0/U5 online 0.00 1624 The following shows a typical display for a Cisco uBR10012 router: Router# show cable modem MAC Address IP Address Prim RxPwr Timing Num BPI State...
Page 552
Offset CPE Enb Router# The following example shows sample output when the Cisco CMTS router contains only Broadband Processing Engine (BPE) cable interface line cards and none of the cable interface line cards are up: Router# show cable modem Router# The following example shows sample output for the verbose option for a particular CM: Router# show cable modem 0010.7bb3.fcd1 verbose...
Page 553
CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases). The show cable modem command displays the CM timing offset in DOCSIS ticks, while other...
Page 554
With default settings, 0 dBmV is considered optimal, but a range of -1 to 1 dBmV is allowable. When CMs exceed this range, older Cisco IOS releases supported a drop to as low as -2 dBmV. Recent Cisco IOS releases support a drop to as low as -4 dBmV.
Page 555
“Excluded”. Note This field displays a value only when the cable dynamic-secret command has been used on the CMTS interface. Cisco Broadband Cable Command Reference Guide 3-59 OL-1581-08...
Page 556
Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed. init(t) Time-of-day (TOD) exchange has started. Cisco Broadband Cable Command Reference Guide 3-60 OL-1581-08...
Page 557
If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check. Cisco Broadband Cable Command Reference Guide 3-61 OL-1581-08...
Page 558
DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command. In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.
Page 559
1. The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the CISCO-DOCS-EXT-MIB. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 560
Displays station maintenance (SM) error statistics for one or more CMs. maintenance show cable modem Displays a list of the CMs that are marked as offline with the Cisco CMTS. offline show cable modem Displays the DOCSIS PHY layer information for one or more CMs.
Page 561
Cisco uBR7100 series and Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 562
Protocol (HCCP) Configuration” section on page 3-54. Examples The following example shows sample output for the show cable modem access-group command on a Cisco uBR7200 series router for a particular CM: Router# show cable modem 0010.7bb3.fcd1 access-group MAC Address IP Address Access-group 0010.7bb3.fcd1 10.20.113.2...
Page 563
Chapter 3 Cisco CMTS Show Commands show cable modem access-group In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands...
Page 564
26054 0000.399f.a44f upstream active 6432 26121 0000.399f.a44f downstream active 1182 6430 26055 0000.399f.a44f downstream active 3934 Router# Table 3-17 describes the fields that are shown in the show cable modem classifiers display: Cisco Broadband Cable Command Reference Guide 3-68 OL-1581-08...
Page 565
Matches Number of packets that have been matched to this service flow. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 566
EXEC mode. show cable modem {ip-address | mac-address} cnr This command can be used for cable modems that are using interfaces on a Cisco uBR-MC16S, Note Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, and Cisco uBR-MC5X20S/U cable interface line cards only.
Page 567
The IP address that the DHCP server has assigned to the CM. The cable interface line card providing the upstream for this CM. MAC State The current state of the MAC layer (see Table 3-15 on page 3-60). Cisco Broadband Cable Command Reference Guide 3-71 OL-1581-08...
Page 568
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 569
On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface. cable slot/subslot/port (Optional) Displays information for all CMs on the specified cable interface on the Cisco uBR10012 router.
Page 570
%online Online time Offline time online Online May 30 2000 4 99.85 48:20 11h34m 1d2h23m 00:01 00:59 03:00 Router# Table 3-19 describes the information shown in the show cable modem connectivity displays: Cisco Broadband Cable Command Reference Guide 3-74 OL-1581-08...
Page 572
Router# When using the rate option, each line of the display shows the following information: A timestamp showing the number of minutes and seconds from which the first CM came online. • Cisco Broadband Cable Command Reference Guide 3-76 OL-1581-08...
Page 573
A tilde (~) represents a gap of more than one second appears between two lines. • In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 574
Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 575
Table 3-20 Descriptions for the show cable modem counters Fields Field Description MAC Address MAC address for the CM. US Packets Number of packets this CM has transmitted on the upstream. Cisco Broadband Cable Command Reference Guide 3-79 OL-1581-08...
Page 576
DS Bytes Number of byte this CM has received on the downstream. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
00b0.4a9b.bc8c 10.14.30.101 00b0.4a9b.bc8d Router# In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Cisco Broadband Cable Command Reference Guide 3-81 OL-1581-08...
Page 578
Displays information collected by the remote-query feature. remote-query show cable Displays modulation profile group information. modulation-profile show interface cable Displays information about the CMs connected to a particular cable modem interface. show interface cable Displays cable interface information. Cisco Broadband Cable Command Reference Guide 3-82 OL-1581-08...
Page 579
On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface. cable slot/subslot/port (Optional) Displays information for all CMs on the specified cable interface on the Cisco uBR10012 router.
Page 580
(HCS) error from this CM. HCS errors could indicate the same sort of plant problems as CRC errors. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 581
Displays station maintenance (SM) error statistics for one or more cable maintenance modems. show interface cable Displays information about the CMs connected to a particular cable modem interface. Cisco Broadband Cable Command Reference Guide 3-85 OL-1581-08...
Page 582
On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface. cable slot/subslot/port (Optional) Displays information for all CMs on the specified cable interface on the Cisco uBR10012 router.
Page 583
Miss The number of times the CM misses the MAC layer keepalive message. An 8 percent miss rate is normal for the Cisco cable interface line cards. It can indicate intermittent upstream, laser clipping, or common-path distortion. The number of cyclic redundancy check (CRC) errors from this CM. It can indicate intermittent upstream, laser clipping, or common-path distortion.
Page 584
Chapter 3 Cisco CMTS Show Commands show cable modem flap In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands...
Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 586
Command History Release Modification 12.1(4)CX and This command was introduced for the Cisco uBR7100 series, 12.2(4)BC1 Cisco uBR7200 series, and Cisco uBR10012 routers. 12.2(8)BC2 This command was enhanced to show whether a CM is capable of operating in DOCSIS 1.0 or DOCSIS 1.1 mode, and the version for which it is...
Page 587
Number of upstream service IDs (SIDs) used by this CM. Summary and Total Options The following example shows the same display for the show cable modem mac summary command: Router# show cable modem mac summary Cable Modem Summary Cisco Broadband Cable Command Reference Guide 3-91 OL-1581-08...
Page 588
DOC 1.0 registered for DOCSIS 1.0 operations. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Cisco Broadband Cable Command Reference Guide...
Page 589
Displays the DOCSIS PHY layer information for one or more CMs. show interface cable Displays information about the CMs connected to a particular cable modem interface. show interface cable Displays cable interface information. Cisco Broadband Cable Command Reference Guide 3-93 OL-1581-08...
On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface. cable slot/subslot/port (Optional) Displays information for all CMs on the specified cable interface on the Cisco uBR10012 router.
Page 591
Prim SM Exhausted SM Aborted Count Time Count Time 0010.7bb3.fcd1 C5/0/U5 Jun 1 10:24:52 0 Jan 1 00:00:00 Router# Table 3-25 describes the fields shown in the show cable modem maintenance displays: Cisco Broadband Cable Command Reference Guide 3-95 OL-1581-08...
Page 592
Time Maintenance period, typically because the CM has been reset. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands...
To display a list of the CMs that are marked as offline with the Cisco CMTS, use the show cable modem offline command in privileged EXEC mode. show cable modem [ip-address | mac-address] offline...
Page 594
The following example shows sample output for the show cable modem offline command for a single CM, as identified by its MAC address: Router# show cable modem 0030.946a.5d61 offline Interface MAC address Prim Previous Offline State Time Power Exhaust Count Cisco Broadband Cable Command Reference Guide 3-98 OL-1581-08...
Page 595
Exhaust Count field for all offline CMs to zero and resets the Offline Time field for all offline CMs to the current time. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 596
Displays the vendor name or Organizational Unique Identifier (OUI) for the vendor CMs on each cable interface. show interface cable Displays information about the CMs connected to a particular cable modem interface. show interface cable Displays cable interface information. Cisco Broadband Cable Command Reference Guide 3-100 OL-1581-08...
Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 598
Table 3-27 Descriptions for the show cable modem phy Fields Field Description MAC Address The MAC address for the CM. The cable interface on the CMTS that is providing services for this CM. Service ID that this CM is using. Cisco Broadband Cable Command Reference Guide 3-102 OL-1581-08...
Page 599
CMTS. This field shows the CNR value for cable interfaces that support onboard hardware-based spectrum management, such as the Cisco uBR-MC16S card, and shows the SNR value for other cable interfaces. Although the field name shows the value as being given in dBmV, the Note actual value should be interpreted in dB.
Page 600
Chapter 3 Cisco CMTS Show Commands show cable modem phy In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands...
Page 601
The following example shows sample output for the show cable modem qos command for a particular CM, as identified by its IP address: Router# show cable modem 22.1.1.10 qos Sfid Dir Curr Sched Prio MaxSusRate MaxBrst MinRsvRate Throughput State Type 3044 Cisco Broadband Cable Command Reference Guide 3-105 OL-1581-08...
Page 602
Maximum Concatenated Burst : 1522 bytes Scheduling Type : Best Effort Request/Transmission policy : 0x0 IP ToS Overwrite[AND-mask, OR-mask] : 0xFF, 0x0 Current Throughput : 0 bits/sec, 0 packets/sec Sfid Current State : Active Cisco Broadband Cable Command Reference Guide 3-106 OL-1581-08...
Page 603
Timeout for active Qos parameters, in seconds, which specifies the maximum amount of time that resources can remained unused on an active service flow. Maximum Latency Maximum downstream latency allowed for packets using this service flow, in microseconds. Cisco Broadband Cable Command Reference Guide 3-107 OL-1581-08...
Page 604
Chapter 3 Cisco CMTS Show Commands show cable modem qos In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands...
To display a list of the CMs that have registered with the Cisco CMTS, use the show cable modem registered command in privileged EXEC mode. show cable modem [ip-address | mac-address] registered...
Page 606
An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command. Cisco Broadband Cable Command Reference Guide 3-110 OL-1581-08...
Page 607
MAC Address The MAC address for the CM. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Cisco Broadband Cable Command Reference Guide...
Page 608
Displays the CPE devices accessing the cable interface through a particular show cable modem Displays a list of the CMs that are marked as offline with the Cisco CMTS. offline show cable modem Displays a list of the CMs that are marked as unregistered with the unregistered Cisco CMTS.
Page 609
In Cisco IOS Release 12.1 CX, Cisco IOS Release 12.2 BC, and later, use the show cable Note modem phy command instead of the show cable modem remote-query command. The information shown by this command can also be displayed by querying the attributes in the CISCO- DOCS-REMOTE-QUERY-MIB.
Page 610
44.0 - 1.0 8795 online(d) Router# The following example shows typical output from the show cable modem remote-query command when the remote-query feature has not been configured. Router# show cable modem remote-query Cisco Broadband Cable Command Reference Guide 3-114 OL-1581-08...
Page 611
10.200.71.11 0050.f112.5123 offline Router# In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands Command Description cable modem remote-query Enables and configures the remote-query feature to gather CM performance statistics on the CMTS.
Page 612
Command History Release Modification 12.2(15)BC1 This command was introduced for Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers. Usage Guidelines This command displays a list of cable modems that attempted to register with a DOCSIS configuration file that does not pass the authentication required by the cable dynamic-secret command.
Page 613
To account for possible network problems, such as loss of packets and Note congestion, the Cisco CMTS will allow a cable modem to attempt to register twice before marking it as having failed the dynamic shared- secret authentication checks.
Page 614
Cisco CMTS Show Commands show cable modem rogue Command Description show interface cable Displays information about the CMs connected to a particular cable modem interface. show interface cable sid Displays cable interface information. Cisco Broadband Cable Command Reference Guide 3-118 OL-1581-08...
• cable slot/port—On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface. cable slot/subslot/port—On the Cisco uBR10012 router, slot can range •...
Page 616
Cable5/0/U0 Line 41/1 Cable6/0/U0 Line 42/2 Router# The Description field appears in Cisco IOS Release 12.1(11b)EC, 12.2(15)BC2, and later releases, and Note shows the string configured for the upstream using the cable upstream description command. The following example shows typical output for the show cable modem summary command with the...
Page 617
Router# The following example shows sample output for the show cable modem summary total command for all enabled upstreams on a specific cable interface line card on a Cisco uBR7200 series router: Router# show cable modem summary c5/0 total Interface...
Page 618
Description entered for this upstream using the cable upstream description command. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Cisco Broadband Cable Command Reference Guide...
Page 619
Displays the CPE devices accessing the cable interface through a particular show cable modem Displays a list of the CMs that are marked as offline with the Cisco CMTS. offline show cable modem Displays a list of the CMs that are marked as registered with the registered Cisco CMTS.
To display a list of the CMs that are marked as unregistered with the Cisco CMTS, use the show cable modem unregistered command in privileged EXEC mode. show cable modem [ip-address | mac-address] unregistered...
Page 621
An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command. Cisco Broadband Cable Command Reference Guide 3-125 OL-1581-08...
Page 622
MAC Address The MAC address for the CM. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Cisco Broadband Cable Command Reference Guide...
Page 623
Displays the CPE devices accessing the cable interface through a particular show cable modem Displays a list of the CMs that are marked as offline with the Cisco CMTS. offline show cable modem Displays a list of the CMs that are marked as registered with the registered Cisco CMTS.
Page 624
Release Modification 12.2(8)BC2 This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers. Usage Guidelines This command displays the vendor name for each CM. If the vendor name has not been defined by the cable modem vendor command, the command displays the OUI value for the modem’s vendor.
Page 625
The vendor name for the indicated CM, as specified by the cable modem vendor command. If no name for this vendor has been specified, displays the modem’s OUI value. MAC Address The MAC address for the CM. Cisco Broadband Cable Command Reference Guide 3-129 OL-1581-08...
Page 626
CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases). The following example shows typical output for the show cable modem vendor summary command, displaying the total numbers for each vendor and OUI, along with the total numbers of those vendor’s...
Page 627
Displays information collected by the remote-query feature. remote-query show interface cable Displays information about the CMs connected to a particular cable modem interface. show interface cable Displays cable interface information. Cisco Broadband Cable Command Reference Guide 3-131 OL-1581-08...
Page 628
Cisco CMTS Show Commands show cable modulation-profile show cable modulation-profile To display modulation profile group information for a Cisco CMTS, use the show cable modulation- profile command in privileged EXEC mode. show cable modulation-profile [profile [verbose] ] [iuc-code] show cable modulation-profile cable {slot/port | slot/subslot/port} [upstream port]...
Page 629
Long Grant Burst (long) IUC 12 Not used 1. The Cisco CMTS recognizes the reqdata burst type but does not use it. Modulation Profile Ranges The ranges for modulation profiles depends on the cable interface being used and the type of modulation profile being created.
Page 630
141 to 150, default=141 241 to 250, default=241 Cisco uBR-MC28U/X 1. Only 8 modulation profiles are supported in Cisco IOS software releases before 12.2(15)BC1, so in these releases the valid range is 1 to 8. Default modulation profiles are created for each type of card and operation mode. You cannot delete the Note default modulation profiles (1, 21, 41, 101, 121, 201, 221, and 241).
Page 631
0xC8 0x152 0 qpsk0 no Router# The following shows sample output from the show cable modulation-profile command for two DOCSIS 2.0 modulation profiles (A-TDMA) on the Cisco uBR-MC5X20S cable interface line card: Router# show cable modulation-profile 221 Mod IUC Type...
Page 633
Preamble length: Differential Encoding: FEC parity T bytes: FEC codeword length K bytes: 0xDC Scrambler seed: 0x152 Max short burst size B bytes: Guard time size in symbols: Shortened last codeword: Cisco Broadband Cable Command Reference Guide 3-137 OL-1581-08...
Page 634
(DOCSIS 2.0 modulation profiles) The bits to be used for the preamble value. Pre Type (DOCSIS 2.0 modulation profiles) The A-TDMA preamble type (qpsk0 or qpsk1). (DOCSIS 2.0 modulation profiles) The A-TDMA RS encoding type. Cisco Broadband Cable Command Reference Guide 3-138 OL-1581-08...
Page 635
Chapter 3 Cisco CMTS Show Commands show cable modulation-profile In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands Command...
Page 636
Chapter 3 Cisco CMTS Show Commands show cable noise show cable noise To display cable noise statistics on a Cisco CMTS, use the show cable noise command in EXEC mode. show cable {slot/port | slot/subslot/port} noise Syntax Description slot/port Identifies the cable interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers.
Page 637
Cable Root certificate chain: <certificate dump> Router# In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Cisco Broadband Cable Command Reference Guide...
Page 638
Configures certificates for BPI+ encryption. certificate cable privacy Enables and configures BPI+ encryption on a cable interface. show cable modem Displays the CM configuration settings. show interface cable Displays the KEK and TEK key values. privacy Cisco Broadband Cable Command Reference Guide 3-142 OL-1581-08...
Page 640
(QoS) profile and enters enforce-rule configuration mode. enabled Activates an enforce-rule and begins subscriber traffic management. enforced qos-profile Specifies the quality of service (QoS) profile that should be enforced when users violate their assigned QoS profiles. Cisco Broadband Cable Command Reference Guide 3-144 OL-1581-08...
Page 641
Specifies the registered Quality of Service (QoS) profile that should be used for this enforce-rule. show cable Displays subscribers that are violating their registered quality of service subscriber-usage (QoS) profiles. Cisco Broadband Cable Command Reference Guide 3-145 OL-1581-08...
Page 642
Cisco CMTS Show Commands show cable qos permission show cable qos permission To display the status of permissions for changing quality-of-service (QoS) tables on a Cisco CMTS, use the show cable qos permission command in privileged EXEC mode. show cable qos permission Syntax Description This command has no keywords or arguments.
Page 643
Sets the amount of time a dynamic service-flow can be present in the system inactivity-timeout without any activity. show controllers cable Displays cable router QoS profiles. show interface cable Displays the DOCSIS 1.1 QoS parameter sets. qos paramset Cisco Broadband Cable Command Reference Guide 3-147 OL-1581-08...
Page 644
Cisco CMTS Show Commands show cable qos profile show cable qos profile To display quality-of-service (QoS) profiles for a Cisco CMTS, use the show cable qos profile command in privileged EXEC mode. show cable qos profile profile-index [verbose] Syntax Description profile-index Displays cable QoS table.
Page 645
DOCSIS configuration file, unless overwritten using the cable qos profile command. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Cisco Broadband Cable Command Reference Guide...
Page 646
Displays quality of service (QoS) and service flow information for a particular CM. show cable noise Displays the status of permissions for changing QoS tables. show interface cable qos Displays the DOCSIS 1.1 QoS parameter sets. paramset Cisco Broadband Cable Command Reference Guide 3-150 OL-1581-08...
Page 649
0 usecs Parameter Presence Bitfield: {0xDE8, 0x0} Router# In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands cable service class Defines and modifies a service class.
Page 650
Cisco CMTS Show Commands show cable spectrum-group show cable spectrum-group To display information about spectrum groups on a Cisco CMTS, use the show cable spectrum-group command in user EXEC or privileged EXEC mode. show cable spectrum-group [groupnum] [detail] Syntax Description...
Page 652
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 653
Usage Guidelines The show cable subscriber-usage command displays the current usage statistics for all subscribers on the Cisco CMTS, all subscribers on a particular cable interface, or for only those subscribers that are marked as over-consuming bandwidth. Cisco Broadband Cable Command Reference Guide...
Page 654
The following example shows typical output for the show cable subscriber-usage command for one upstream on a particular cable interface: Router# show cable subscriber-usage c6/0/1 upstream 0 Sfid Mac Address Enforce-rule Total-Kbyte Last-detect Last-penalty Name Count time time Flag Cisco Broadband Cable Command Reference Guide 3-158 OL-1581-08...
Page 655
Specifies the time period and sample rate to be used for monitoring subscribers. penalty-period Specifies the time period that an enforced quality of service (QoS) profile should be used for subscribers that violate their registered QoS profile. Cisco Broadband Cable Command Reference Guide 3-159 OL-1581-08...
Page 656
Specifies the registered Quality of Service (QoS) profile that should be used for this enforce-rule. show cable qos Displays the quality of service (QoS) enforce-rules that are currently enforce-rule defined. Cisco Broadband Cable Command Reference Guide 3-160 OL-1581-08...
Page 657
Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 658
The show cable tech-support command displays a large amount of configuration, run-time status, and other information about the cable interfaces on the Cisco CMTS. The output of this command can be provided to technical support representatives when reporting a problem.
Page 659
To capture this output so it can be sent to Cisco TAC, use a Telnet program that allows you to capture the output directly to disk. In Cisco IOS Release 12.3(9a)BC and later releases, the output of the show cable tech-support command was considerably shortened, so that users with large numbers of online cable modems can collect the necessary information without monopolizing the console for dozens of minutes.
Page 660
Type State IP address method MAC address In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands Command Description show controllers cable Displays information about a specific line card's interface controllers.
Page 661
Chapter 3 Cisco CMTS Show Commands show checkpoint show checkpoint To display information about the Checkpoint Facility (CF) subsystem on a Cisco CMTS, use the show checkpoint command in privileged EXEC mode. show checkpoint {clients | statistics} Syntax Description clients Displays a list of current checkpoint clients.
Page 662
Specifies the downstream upconverter module for a Working CMTS or Protect CMTS (deprecated command). hccp protect Allows you to configure a Cisco CMTS to be a Protect CMTS for a specified Working CMTS in a 1+1 redundancy environment. hccp working Allows you to designate a Cisco CMTS to be a Working CMTS in a 1+1 redundancy environment.
Page 663
To display information about the interface controllers for a cable interface on the Cisco CMTS router, use the show controllers cable command in user EXEC or privileged EXEC mode. show controllers cable {slot/port | slot/subslot/port} [downstream | upstream [port] | [mem-stat]...
Page 664
Engine (BPE) cable interface line cards, such as the Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, and Cisco uBR-MC5X20S/U cards. This allows you to obtain information that is specific for that particular cable interface card, as opposed to having to run these commands on the entire router.
Page 665
R7000 CPU at 262MHz, Implementation 39, Rev 2.1, 256KB L2 Cache 6 slot midplane, Version 1.0 The following is sample output for the downstream connection for slot 3 on port 0 on Cisco CMTS router from the show controllers cable downstream command:...
Page 666
Chapter 3 Cisco CMTS Show Commands show controllers cable The following is typical output for a downstream on the Cisco uBR-MC28U cable interface line card, or other cable interface card with integrated upconverter: ubr7246vxr# show controllers cable 6/0 downstream Interface Cable6/0 Hardware is MC28U (F-connector) with Integrated Up-converter Primary rommon version is: 11.4...
Page 667
DES Ctrl Reg#0 = C00C0C43, Reg#1 = 0 Router# The following example shows typical output for a cable interface line card that includes onboard hardware-based spectrum management capabilities (such as the Cisco uBR-MC16S and Cisco uBR- MC28U/X cards): Router# show controllers cable 3/0 upstream 3 Cable6/0 Upstream 3 is up Frequency 24.600 MHz, Channel Width 3.200 MHz, 64-QAM Symbol Rate 2.560 Msps...
Page 668
Table 3-45 show controllers cable upstream Command Field Descriptions Field Description Cable Slot number/port number indicating the location of the Cisco cable interface line card. Upstream is up/administratively Indicates the administrative state of the upstream (whether it is down shutdown or not).
Page 669
<card-name> CNR measurement Estimate for the overall carrier-to-noise ratio (CNR) for the upstream for cable interfaces that include onboard hardware-based spectrum management (such as the Cisco uBR-MC16S or Cisco uBR-MC5X20S). When the CNR measurement exceeds 40 dB, this line states “better than 40 dB.” As a general rule, the CNR is greater than the SNR value.
Page 670
+/- 1 dBmV depending on the transient noise that is occuring when the power is measured. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 671
Displays the noise levels for a particular CM or displays the background upstream spectrum noise for an entire upstream (Cisco uBR-MC16 line card only). show interface cable Displays information about interface controllers for a specific cable access router card slot.
Page 672
To display the noise levels for a particular CM or to display the background noise for an entire upstream on the Cisco uBR-MC16 line card, use the show controllers cable upstream spectrum command in user EXEC or privileged EXEC mode.
Page 673
Cisco uBR-LCP2-MC16S cable interface line card. Usage Guidelines Cisco IOS Release 12.3(9a)BC adds the tech-support keyword to the show controllers cable command. This change allows users with large numbers of online cable modems to collect the necessary line card information without consuming the console session for a long period of time.
Page 675
02:15:54: 11451: 02:15:54: 11463: 02:15:54: 11475: 02:15:54: 11487: In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands Command Description cable modulation-profile Creates a cable modulation profile.
Page 676
This command supports the Cisco CMTS clock feature set, which provides a synchronized clock for improved Voice-over-IP (VoIP) operations. The clock feature set requires one of the following configurations: A Cisco uBR10012 router with one or two TCC+ cards that are connected to an external national • clock source.
Page 677
Holdovers :0, HW faults :0 Router# The following is sample output from the show controllers clock-reference command for a Cisco uBR10012 router with two TCC+ cards. Each TCC+ card—Active and Backup—has its own separate set of registers. Note Router# show controllers clock-reference...
Page 678
PEM A Power = 0w, PEM B Power = 343w Router# show controllers clock-reference command might display compare errors on the Cisco uBR10012 Note router because there could be a slight delay at system startup before the TCC+ cards synchronize with each other.
Page 679
0x4053—This TCC+ card is the active card, the other card is the backup card, and an LCD • Display is present. 0x4065—This TCC+ card has assumed the active card role, because the other card had been active • but is now unresponsive. The LCD Display is present. Cisco Broadband Cable Command Reference Guide 3-183 OL-1581-08...
Page 680
Presence Status Reg. The upper eight bits of this register are unused. The Line Card Presence Status Reg displays the line card state as determined by the Cisco IOS Note software, while the LC Presence Input Reg displays the state as determined by the chassis hardware.
Page 681
Clears the counters displayed with the show controllers clock- reference command. cable power On the Cisco uBR10012 routers, turns a cable interface line card on or off, which updates the LC Power off Status registers displayed with the show controllers clock-reference command. show cable clock Displays the status of the Cisco cable clock card and the TCC+ card.
Page 682
12.3(9a)BC This command was introduced. Usage Guidelines You can use the unsupported command test cable generate in privileged EXEC mode to force the Cisco Note CMTS to register the root certificate. For additional information about using the show crypto commands on the Cisco CMTS, refer to the “Configuring DOCSIS 1.1 on the Cisco CMTS”...
Page 683
To display the Root certificate that the Cisco CMTS has learned after the first cable modem has registered with BPI+ encryption, use the show crypto ca trustpoints command in privileged EXEC mode.
Page 684
Chapter 3 Cisco CMTS Show Commands show crypto ca trustpoints Related Commands Command Description show crypto ca Displays all certificates (Root, Manufacturers, cable modem) that the certificates Cisco CMTS has learned. Cisco Broadband Cable Command Reference Guide 3-188 OL-1581-08...
Page 685
Chapter 3 Cisco CMTS Show Commands show diag show diag To display the revision-level information for a Cisco CMTS cable interface, use the show diag command in privileged EXEC mode. show diag [slot] Syntax Description slot (Optional) Identifies the Cisco CMTS chassis slot number to be displayed.
Page 687
Version number of the EEPROM format. EEPROM contents (hex) Dumps of EEPROM programmed data. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands...
Page 688
The current clock source, its input, and priority. In this example, the clock card is providing the clock source. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 689
12.1(3a)EC This command was introduced. 12.2(4)BC1 The detail option was added. 12.2(8)BC2 The current time to resync and current wait to restore values were added to the display for the brief option. Cisco Broadband Cable Command Reference Guide 3-193 OL-1581-08...
Page 690
Ca7/0/0 Working active In Cisco IOS Release 12.2(8)BC2 and later 12.2 BC releases, the brief option also shows the amount of time left before the next resynchronization and the time left before a restore: Router# show hccp brief Interface Config...
Page 692
. . . Router# In Cisco IOS Release 12.2(15)BC2 and later releases, the show hccp detail command shows the critical and non-critical synchronized CLI commands in separate lists for each cable interface and subinterface: Router# show hccp detail HCCP software version 3.0...
Page 695
1522 Router# In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. The following example shows a detailed display for the Cisco uBR-MC5X20S cable interface line card: Router# show hccp detail mac-address 0005.00e4.1236...
Page 696
Cisco CMTS Show Commands show hccp Related Commands Command Description show hccp interface Displays group information for a specific cable interface on which one or more groups and authentication modes have been configured. Cisco Broadband Cable Command Reference Guide 3-200 OL-1581-08...
Page 697
12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR7246VXR router and Cisco uBR-MC16C, Cisco uBR-MC16S, and Cisco uBR-MC28C cards. Examples The following examples are from the show hccp interface cable 4/0 and show hccp interface cable 4/0...
Page 698
Cisco CMTS Show Commands show hccp interface In Cisco IOS Release 12.2(8)BC2 and later 12.2 BC releases, the brief option also shows the amount of time left before the next resynchronization and the time left before a restore: Router# show hccp interface cable 4/0 brief...
Cisco uBR7100 series and Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 700
Chapter 3 Cisco CMTS Show Commands show interface cable For information on the non-cable specific options, see the Cisco IOS Release 12.2 documentation on Note Cisco.com and the Customer Documentation CD-ROM. Command Modes Privileged EXEC Command History Release Modification 11.3 XA This command was introduced.
Page 701
The rate then drops to 90 pps at the end of the second time interval, and so forth. packets input Total number of error-free packets received by the system. bytes input Total number of bytes, including data and MAC encapsulation, in the error-free packets received by the system. Cisco Broadband Cable Command Reference Guide 3-205 OL-1581-08...
Page 702
The rate then drops to 90 pps at the end of the second time interval, and so forth. packets input Total number of error-free packets received by the system. bytes input Total number of bytes, including data and MAC encapsulation, in the error-free packets received by the system. Cisco Broadband Cable Command Reference Guide 3-206 OL-1581-08...
Page 703
Table 3-50 show interface cable Field Descriptions (continued) Field Description When using bundled cable interfaces on Cisco uBR7200 series routers, the input packet Note counters for the master interface also include the packet counts for slave interfaces, except when using a Broadband Processing Engine (BPE) cable interface (such as the Cisco uBR-MC16U/X and Cisco uBR-MC28U/X).
Page 704
Number of times the output buffer has been swapped out. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 705
Cable6/0: Downstream is up 111947771 packets output, 1579682655 bytes, 0 discarded 0 output errors The following is sample output from the show interface cable downstream command for Cisco IOS releases that support only DOCSIS 1.1 operation: Router# show interface cable 4/0 downstream...
Page 706
Total number of packets that were not transmitted on the downstream, because of an error, such as a buffer overrun, the Cisco CMTS running out of memory, or the frame being larger than the cable interface’s MTU value. output errors Total number of packets that could not be transmitted on this downstream cable interface because of all errors.
Page 707
Displays information by service identifier (SID) of each CM on the network. show interface cable Displays information about the cable signal quality. signal-quality show interface cable Displays information about one or all upstreams on the cable interface. upstream Cisco Broadband Cable Command Reference Guide 3-211 OL-1581-08...
Page 708
Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 709
Chapter 3 Cisco CMTS Show Commands show interface cable intercept In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands...
Page 710
Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 711
3/64 indicates that the queue has a depth of 64 slots available and that 3 are currently in use. Number of packets dropped because the queue already had 64 • requests pending and a free slot was therefore not available. Cisco Broadband Cable Command Reference Guide 3-215 OL-1581-08...
Page 712
Avg percent initial ranging Total upstream bandwidth that is currently being used, on average, for slots initial ranging requests for cable modems coming online, expressed as an average percentage of total minislots being used. Cisco Broadband Cable Command Reference Guide 3-216 OL-1581-08...
Page 713
(NRTPS) service flows, and the current bandwidth reserved by these SIDs, in bits per second. Displays the number of service IDs (SIDs) being used for Best-Effort (BE) service flows, and the current bandwidth reserved by these SIDs, in bits per second. Cisco Broadband Cable Command Reference Guide 3-217 OL-1581-08...
Page 714
50 percent, it indicates that cable modems on that upstream are currently using (0.5 * 8.9 Mbps) or 4.45 Mbps. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 715
Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 716
The current state of the MAC layer for this SID and CM (see Table 3-15 on page 3-60). For hosts or multicast broadcasts, the state will always be unknown. IP address Identifies the IP address for the CM using this SID. Cisco Broadband Cable Command Reference Guide 3-220 OL-1581-08...
Page 717
State field. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands...
Page 718
Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 719
Encap DOCSIS encapsulation. Type Forwarded packets with Ethernet encapsulation. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands Command...
Page 720
Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 721
Valid range is 300 to 1,800 seconds. Default is 600 seconds (10 minutes). In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 722
Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 723
Grants per Interval: IP ToS Overwrite [AND-mask,OR-mask]: 0x0,0x0 In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands show cable qos Displays the status of permissions for changing QoS tables.
Page 724
Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 725
Usage Guidelines In Cisco IOS Release 12.2(4)BC1 and later, the optional keywords classifiers, counters, phs, qos, and verbose can be used only when requesting information for a specific service flow ID. When a service flow ID is specified, the verbose keyword can be used by itself or by any of the other optional keywords.
Page 726
Destination IP Address : 172.16.2.35 Destination IP Address Mask : 255.255.255.255 IP Protocol Type : 17 Source Port Low : 53456 Source Port High : 53456 Destination Port Low : 7052 Destination Port High : 7052 Cisco Broadband Cable Command Reference Guide 3-230 OL-1581-08...
Page 727
When PacketCable services are enabled to allow PacketCable-based Voice over IP (VoIP) traffic, the Nominal Grant Interval reflects the packetization interval that is configured on the VoIP call agent. Router# show interface c4/0 service-flow counters Sfid Packets Bytes PacketDrops Bits/Sec Packets/Sec Cisco Broadband Cable Command Reference Guide 3-231 OL-1581-08...
Page 729
PHS Field. 8-bit values that defines the header bytes that should be suppressed. Note The PHS packet counters are not supported on the Cisco uBR-MC5X20 card and always shows 0 or N/A, depending on the software release. Related Commands cable service class Sets the parameters for DOCSIS 1.1 cable service class.
Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 731
An explicit error message was added if this command is used with a cable subinterface, instructing the user to use the main interface instead. 12.1(13)EC The secondary-ip keyword was added for the Cisco uBR7100 series and Cisco uBR7200 series universal broadband routers. 12.2(11)BC1 Support for the secondary-ip keyword was added for the Cisco uBR10012 universal broadband router.
Page 732
IP ToS Overwrite [AND-mask, OR-mask] : 0x0, 0x0 Current Throughput : 0 bits/sec, 0 packets/sec When using DOCSIS 1.1 software, such as Cisco IOS Release 12.2 BC, the show interface sid counter command provides the following display: Router# show interface c5/0 sid counter Req-polls...
Page 733
Fragmentation headers received : 0 Fragmentation headers discarded: 0 Router# The following example shows typical verbose output for the SID counters on the Cisco uBR-MC5X20S cable interface line card: Router# show interface c4/0 sid 3 counters verbose Request polls issued...
Page 734
IP address of the modem owning this SID. MAC address MAC address of the modem owning this SID. BW requests received Number of bandwidth requests received by this SID. Grants issued Number of bandwidth requests granted by this SID. Cisco Broadband Cable Command Reference Guide 3-238 OL-1581-08...
Page 735
(VPN) operation. Fragment reassembly completed Number of packets that were subject to DOCSIS fragmentation that were successfully reassembled. This counter is not supported on the Cisco uBR-MC5X20 Note card and always shows 0 or N/A, depending on the software release.
Page 736
Fragmentation headers discarded Number of upstream fragments discarded and not assembled into a valid upstream packet. (See docsQosUpstreamFragDiscards in DOCS-QOS-MIB.) In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands...
Page 737
Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 738
Related Commands Command Description show interface cable Displays cable interface information. downstream show interface cable sid Displays information by SID of each cable access router on the network. Cisco Broadband Cable Command Reference Guide 3-242 OL-1581-08...
Page 739
Identifies the cable interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 740
Total Modems On This Upstream Channel : 147 (142 active) Router# The following is sample output for the upstream cable interface located for the Cisco uBR-MC5X20S and Cisco uBR-MC28U/X cards, which provides information about the error counters maintained by the card’s onboard MAC controller for each upstream interface:...
Page 741
Packets with at least one frame with an uncorrectable error On Broadband Processing Engines (BPE) cable interface line cards, such as the Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, and Cisco uBR-MC5X20S/U cards, this counter also counts conditions such as HCS/CRC errors and collisions that occur during initial ranging requests and bandwidth requests.
Page 742
Engines (BPE) cable interface line cards, such as the Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, and Cisco uBR-MC5X20S/U cards, because these cards count only uncorrectable codewords, not frames. As a result, this field always shows 0 or N/A for these cards, depending on the software release.
Page 743
JIB counters for ifInErrors Error counters for the upstream interface that are maintained by the MAC controller that is onboard certain cable interface line cards (such as the Cisco uBR-MC5X20S and Cisco uBR-MC28U/X): us_error_frame_drop = Number of frames dropped from the •...
Page 744
Maximum number of UGS service flows, minimum number of min, avg) UGS service flows, and average number of UGS service flows that have been allocated on the upstream over the last hour and last five minute period. Cisco Broadband Cable Command Reference Guide 3-248 OL-1581-08...
Page 745
Chapter 3 Cisco CMTS Show Commands show interface cable upstream In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode. Related Commands...
Page 746
This command displays information about the authentication, authorization, and accounting (AAA) servers that are configured on the Cisco CMTS router for PacketCable operations. These include DF servers (used for CALEA redirection of event messages and traffic), RADIUS servers (used for authentication), and RKS servers (used for billing).
Page 747
Resets the counters that track the total number of committed gates. counter commit packetcable Enables PacketCable operations on the Cisco CMTS. show packetcable gate Displays the total number of committed gates since system reset or since the counter commit counter was last cleared.
Page 748
Support was added for the Cisco uBR10012 router. Usage Guidelines This command displays information about one or more gates in the gate database on the Cisco CMTS. You can display a summary for all currently active gates, for all downstream or all upstream gates, or you can display detailed information about a specific gate.
Page 749
Field Description GateID Unique number identifying the local gate. Slot Cable interface on the Cisco CMTS. Subscriber ID IP address for the subscriber for this service request. GC-Addr IP address for the gate controller that is responsible for this gate.
Page 750
Resets the counters that track the total number of committed gates. counter commit packetcable Enables PacketCable operations on the Cisco CMTS. show packetcable gate Displays the total number of committed gates since system reset or since the counter commit counter was last cleared.
Page 751
COMMITTED state. Examples The following example shows that 132 gates have been committed since the Cisco CMTS was last reset or since the counters were last cleared: Router# show packetcable gate counter commit...
Page 752
Cisco CMTS Show Commands show packetcable gate counter commit Command Description show packetcable gate Displays information about one or more gates in the gate database. show packetcable Displays the current PacketCable configuration. global Cisco Broadband Cable Command Reference Guide 3-256 OL-1581-08...
Page 753
User EXEC, Privileged EXEC Command History Release Modification 12.2(8)BC2 This command was introduced for the Cisco uBR7200 series universal broadband router. 12.2(11)BC1 Support was added to display the Element ID for the CMTS. 12.2(11)BC2 Support was added to display whether non-PacketCable UGS service flows are authorized or not.
Page 754
200000 milliseconds (200 seconds). Related Commands Command Description packetcable Enables PacketCable operations on the Cisco CMTS. packetcable authorize Allows Unsolicited Grant Service (UGS) service flows without a proper vanilla-docsis-mta PacketCable gate ID when PacketCable operations are enabled on the Cisco CMTS.
Page 755
To display general information about the Cisco CMTS router when reporting a problem to Cisco technical support, use the show tech-support command in privileged EXEC mode. show tech-support [page] [password] [cef | ipmulticast | isis | rsvp]...
Page 756
Usage Guidelines The show tech-support command displays a large amount of configuration, run-time status, and other information about the Cisco CMTS for troubleshooting problems. The output of this command can be provided to technical support representatives when reporting a problem.
Page 757
To capture this output so it can be sent to Cisco TAC, use a Telnet program that allows you to capture the output directly to disk. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
This command was modified to include information about the cable clock card. Examples The following is sample output from the show version command for a Cisco uBR7246 VXR with the cable clock card installed: Router# show version Cisco Internetwork Operating System Software IOS (tm) 7200 Software (UBR7200-P-M), Version 12.1(10)EC, RELEASE SOFTWARE...
Page 759
If such error messages appear, report the complete text of this message to your technical support specialist. In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Page 760
Chapter 3 Cisco CMTS Show Commands show version Cisco Broadband Cable Command Reference Guide 3-264 OL-1581-08...
Page 761
Chapter 5, “Cisco CMTS Debugging Commands.” Performance Routing Engine Overview The majority of the Layer 2 and Layer 3 processing on the Cisco uBR10012 universal broadband router is done by the Performance Routing Engine (PRE) module. The PRE module uses advanced application-specific integrated circuit (ASIC) technology, which supports very high performance throughput of IP services over each port.
Page 762
The exact processing function assigned to each XMC is flexible and can change as new features are added to the Cisco IOS software. Within each PXF network processor, the 16 XMC processors are linked together in four parallel pipelines, which each pipeline contains four XMC processors arranged as a systolic array.
The RP also has memory-mapped access to all of the state information used by the XMCs on the FP. The RP is responsible for configuring the tables and lists used by the XMCs. The RP also includes such standard Cisco IOS facilities as Flash memory, NVRAM for storing configuration files, and Ethernet connections for network management.
Chapter 4 Commands for the Cisco uBR10012 Router Command Reference Command Reference This section describes the following commands that are specific to the Cisco uBR10012 universal broadband router: associate • auto-sync • clear facility-alarm • • clear pxf • clear redundancy exception pxf •...
Page 765
For information on the other, cable-specific commands for the Cisco uBR10012 router, see Chapter 2, “Cisco CMTS Configuration Commands” Chapter 3, “Cisco CMTS Show Commands.” information about debugging commands for the Cisco uBR10012 router and other Cisco CMTS routers, Chapter 5, “Cisco CMTS Debugging Commands.” Cisco Broadband Cable Command Reference Guide OL-1581-08...
Page 766
Specifies the slot that contains the working (primary) card. The valid range is 1 to 8 (odd numbers only), but on the Cisco uBR10012 router, the only usable numbers are 1 and 3, and the card must support APS redundancy.
Page 767
Chapter 4 Commands for the Cisco uBR10012 Router associate Router(config-r)# associate slot 1 2 Router(config-r)# The following example does the same as above, but the router automatically assumes that the card in slot 2 is the redundant card: Router# config t...
Page 768
For example, if you have configured the active and standby PRE1 modules to run different versions of Cisco IOS software, you might want to use different configuration files as well. In this case, you would not synchronize the startup configuration file.
Page 769
Chapter 4 Commands for the Cisco uBR10012 Router auto-sync router(config-r)# main-cpu router(config-r-mc)# auto-sync startup-config router(config-r-mc)# exit router(config-r)# exit router(config)# The following example shows how to configure the system to synchronize all system files except for the startup configuration file. This typically is done when the two PRE1 modules are running different software images.
Page 770
To clear some or all of the facility alarms on the Cisco uBR10012 router, use the clear facility-alarm command in privileged EXEC mode. clear facility-alarm [critical | major | minor | source pem {0 | 1}]...
Page 771
Chapter 4 Commands for the Cisco uBR10012 Router clear facility-alarm Router# clear facility-alarm source pem 0 Router# clear facility-alarm source pem 1 Router# Related Commands Command Description facility-alarm Sets the temperature thresholds at which the processor generates a critical, major, or minor alarm to warn of potential equipment damage.
Page 772
Note The clear pxf xcm counters command is supported only on the PRE1 and later processors for the Cisco uBR10012 router. This command is not supported on the PRE processor. Examples The following example shows how to clear the DMA counters for the PXF processor: Router# clear pxf dma counters The following example shows how to clear the ECC counters for the PRE1 module’s two XCM memory...
Page 773
Chapter 4 Commands for the Cisco uBR10012 Router clear pxf Command Description debug pxf Enables debugging of the PXF subsystems on the active PRE1 module on the Cisco uBR10012 router. show pxf cpu Displays the display different statistics about the operation of the CPU processor during PXF processing.
Page 774
Command Modes Privileged EXEC Command History Release Modification 12.2(4)XF1 This command was introduced for the Cisco uBR10012 router. Usage Guidelines The clear redundancy command clears the following information, which is shown by the show redundancy command: counters—Maintain the number of messages sent and received, buffers used, and synchronization •...
Page 775
Examples The following example shows how to specify that the Cisco uBR10012 router should create a minimal core-dump file for PXF exceptions, and that this file should be named ubr10k-pxf and be written to the...
Page 776
Chapter 4 Commands for the Cisco uBR10012 Router exception pxf Router(config)# exception pxf flash disk1: Router(config)# Related Commands Command Description show pxf xcm Displays the current state of error checking and correcting (ECC) for the External Column Memory (XCM) on the Parallel eXpress Forwarding (PXF) processor.
Page 777
67 (critical), 49 (major), and 40 (minor) degrees Centigrade. In Cisco IOS releases previous to Cisco IOS Release 12.2(11)BC1, a critical alarm automatically shuts down the router after two minutes to prevent temperature damage. In Cisco IOS Release 12.2(11)BC1 and later, a critical alarm by default does not shut down the router.
Page 778
However, high temperatures could still cause damage to other components if the problem is not quickly resolved. Examples The following example shows how to configure the Cisco uBR10012 router so that it generates a minor alarm when the intake temperature exceed 55°C: Router# configure terminal...
Page 779
Router(config)# Related Commands Command Description clear facility-alarm Clears some or all of the facility alarms on the Cisco uBR10012 router. show facility-alarm Displays the current temperature thresholds that will trigger a facility status alarm. Cisco Broadband Cable Command Reference Guide...
Page 780
The hw-module reset command typically is used to reset a standby PRE1 module so that it can load a new version of Cisco IOS software. However, this command can also be used to reset the active PRE1 module, as well as any other line card in the Cisco uBR10012 chassis.
Page 781
Chapter 4 Commands for the Cisco uBR10012 Router hw-module reset Examples The following example shows the standby PRE1 module being reset: Router# hw-module sec-cpu reset Router# The following example shows the active PRE1 module being reset and kept in the reset state (which will...
Page 782
Release Modification 12.2(4)XF This command was introduced for the Cisco uBR10012 router. Usage Guidelines The hw-module shutdown command shuts down a PRE1 module or line card in a controlled manner. The PRE1 module or line card resets shutdown until it is reset with the hw-module reset command.
Page 783
Chapter 4 Commands for the Cisco uBR10012 Router hw-module shutdown The following example shows the PRE1 module in PRE1 slot B being shut down: Router(config)# hw-module pre B shutdown Router(config)# The hw-module pre B shutdown command shuts down the PRE1 module that is physically present in Note slot B, regardless of whether the module is the active or standby PRE1 module.
Page 784
You must first use the hw-module slot pos command to preconfigure a line card slot for POS operation of the Cisco uBR10012 OC-48 DPT card before you can configure the card with any further commands. You must also use the card 1oc48dpt/pos-1 command to configure the card slot for the proper card type.
Page 785
Chapter 4 Commands for the Cisco uBR10012 Router hw-module slot pos Router# card 4/0 1oc48dpt/pos-1 Related Commands Command Description hw-module reset Resets a PRE1 module or line card. hw-module shutdown Shuts down a PRE1 module or line card. hw-module slot srp Configures a line card slot for SRP operation.
Page 786
You must first use the hw-module slot srp command to preconfigure a line card slot for SRP operation of a pair of Cisco uBR10012 OC-48 DPT cards before you can configure the cards with any further commands. You must also use the card 1oc48dpt/pos-1 command to configure each card slot for the proper card type.
Page 787
Chapter 4 Commands for the Cisco uBR10012 Router hw-module slot srp The following example shows the Cisco uBR10012 OC-48 DPT line cards in slots 3 and 4 being reconfigured from POS operation to SRP operation: Router# no hw-module slot 3 pos...
Page 788
After you enter main-CPU redundancy configuration mode, you can use the auto-sync command to specify which files are synchronized between the active and standby PRE1 modules. In Cisco IOS Release 12.2(11)BC3 and later releases, you can also use the switchover timeout...
Page 789
Chapter 4 Commands for the Cisco uBR10012 Router main-cpu Related Commands Command Description associate Associates two line cards for Automatic Protection Switching (APS) redundancy protection. auto-sync Configures which files are synchronized between the active and standby PRE1 modules. redundancy Enters redundancy configuration mode.
Page 790
This command was introduced for the Cisco uBR10012 router. Usage Guidelines When the Cisco uBR10012 router is configured with redundant PRE1 modules, the active PRE1 module automatically synchronizes the configuration, network state information, and other information with the standby PRE1 module, so that if a switchover occurs, the standby module can restore normal operations quickly.
Page 791
Chapter 4 Commands for the Cisco uBR10012 Router maintenance-mode Related Commands Command Description auto-sync Configures which files are synchronized between the active and standby PRE1 modules. redundancy Enters redundancy configuration mode. Cisco Broadband Cable Command Reference Guide 4-31 OL-1581-08...
Page 792
By default, the Cisco uBR10012 router automatically loads all required microcode on to the PXF processors and other line cards when it loads the Cisco IOS software image. Also, the PRE1 module automatically reloads the microcode on a card when certain faults occur, allowing the card to recover from the fault.
Page 793
Chapter 4 Commands for the Cisco uBR10012 Router microcode version=1.1.0, description=Release Software created Wed 17-Jul-02 16:58 <<list of interfaces going down or coming up>> 00:49:42: !!pxf clients started, forwarding code operational!! Router(config)# The following example shows how to reload the microcode on the PXF processors on the PRE1 module,...
Page 794
By default, the Cisco uBR10012 router automatically loads all required microcode on to the PXF processors and other line cards when it loads the Cisco IOS software image. Also, the PRE1 module automatically reloads the microcode on a card when certain faults occur, allowing the card to recover from the fault.
Page 795
The following example shows a typical list of devices that you can use when loading microcode for the PXF processors. This list might vary, depending on whether a standby PRE1 module is installed and depending on the version of Cisco IOS software being used. Router# microcode reload pxf ?
Page 796
Command History Release Modification 12.2(4)XF This command was introduced for the Cisco uBR10012 router. Usage Guidelines When you enter redundancy configuration mode, the prompt changes to the following: Router(config-r)# After you enter redundancy configuration mode, you can use the main-cpu command to enter main-CPU redundancy configuration mode, which allows you to specify which files are synchronized between the active and standby Performance Routing Engine (PRE1) modules.
Page 797
Chapter 4 Commands for the Cisco uBR10012 Router redundancy Command Description maintenance-mode Configures the PRE1 modules on the router for maintenance mode. redundancy Forces a switchover so that the standby PRE1 module becomes the active force-failover PRE1 module. main-cpu Cisco Broadband Cable Command Reference Guide...
Page 798
• • You have upgraded the Cisco IOS software on the standby PRE1 module and want the standby PRE1 module to begin using the new software image. This also allows you to upgrade the software on the former active PRE1 module without interrupting systems operations.
Page 799
PRE1 modules are ready for the switch. In Cisco IOS Release 12.2(11)BC3 and later releases, the active PRE1 module will not initiate a new switchover until a current switchover is complete and the system has stabilized.
This command was introduced for the Cisco uBR10012 router. Usage Guidelines The redundancy reload peer command reloads the Cisco IOS software on the standby PRE1 module, which does not have an impact on router operations, assuming a switchover is not required while the standby module is resetting.
Page 801
Chapter 4 Commands for the Cisco uBR10012 Router redundancy reload The following example shows how to reload both PRE1 modules: Router# redundancy reload shelf Reload the entire shelf [confirm] y Preparing to reload entire shelf Pressing enter or y confirms the action and begins the reload of both modules. Pressing any other key Note aborts the reload and returns control to the current active PRE1 module.
Page 802
Command History Release Modification 12.2(4)XF1 This command was introduced for the Cisco uBR10012 router. Usage Guidelines The redundancy switch-activity command is similar to the redundancy force-failover main-cpu command, except that it includes an option to force the switchover, overriding any configuration checks or other checks in the software that could prevent the switchover.
Page 803
Chapter 4 Commands for the Cisco uBR10012 Router redundancy switch-activity Related Commands Command Description associate Associates two line cards for Automatic Protection Switching (APS) redundancy protection. redundancy Enters redundancy configuration mode so that the synchronization parameters can be configured. redundancy reload Resets the standby PRE1 module or to reset both the active and standby PRE1 modules.
Page 804
Redundancy configuration, main-cpu mode Command History Release Modification 12.2(11)BC3 This command was introduced for the Cisco uBR10012 router. Examples The following example shows how to enable the auxiliary port on the standby PRE1 module. Router# config t Router(config)# redundancy Router(config-r)# main-cpu...
Page 805
The show cr10k-rp command displays information that the PRE remote processor (RP) module has about a particular SID. This information includes configuration information about the SID, as well as internal status information that is useful only to Cisco engineers in troubleshooting problems. Examples...
Page 806
Chapter 4 Commands for the Cisco uBR10012 Router show cr10k-rp prio=9, sip=0.0.0.0, sip mask=0.0.0.0 dip=0.0.0.0, dip mask=0.0.0.0, prot=17, tos=A0,E0 sport = 0,65535, dport = 0,65535 matches = 0 id=3, sfid=12 CFR Index 16394 RP sfindex 16394, prio=8, sip=9.0.0.0, sip mask=255.255.0.0 dip=1.11.22.0, dip mask=255.255.255.0, prot=256, tos=0,FF...
Page 807
Chapter 4 Commands for the Cisco uBR10012 Router show cr10k-rp sport = 1000,500, dport = 1000,500 matches = 0 --------------------------------------------------------- Router# The following example shows typical output for the mac-rw-index option: Router# show cr10k-rp c8/0/0 1 mac-rw-index CPE Information for Interface Cable8/0/0 SID 1:...
Page 808
Chapter 4 Commands for the Cisco uBR10012 Router show cr10k-rp Related Commands Command Description show cr10k-rp queue Displays information about the versatile traffic management system (VTMS) packet queues for a cable interface. Cisco Broadband Cable Command Reference Guide 4-48 OL-1581-08...
Page 809
The show cr10k-rp queue command displays information about the VTMS queues on the Cisco uBR10012 router. VTMS is a predictive scheduler that uses traffic shaping and link bandwidth usage to control the order and frequency in which output queues are serviced.
Page 811
Related Commands Command Description clear facility-alarm Clears some or all of the facility alarms on the Cisco uBR10012 router. facility-alarm Sets the temperature thresholds at which the processor generates a critical, major, or minor alarm to warn of potential equipment damage.
Page 812
Chapter 4 Commands for the Cisco uBR10012 Router show hardware pxf show hardware pxf In Cisco IOS Release 12.2(15)BC2 and later releases, all show hardware pxf commands were renamed as show pxf, as follows: show pxf cable • show pxf cable interface •...
Page 813
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cable show pxf cable To display information about the multicast echo, packet intercept, or source-verify features for one or all cable interfaces, use the show pxf cable command in user EXEC or privileged EXEC mode.
Page 814
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cable Examples The following example shows a typical display for the show pxf cable feature-table command for all cable interfaces: Router# show pxf cable feature-table Interface SWInterface VCCI McastEcho Intercept...
Page 815
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cable Table 4-1 show pxf cable feature-table Field Descriptions Field Description VCCI Displays the Virtually Cool Common Index (VCCI) for this cable interface or subinterface. The VCCI is an index that uniquely identifies every interface or subinterface on the PXF processor, and that quickly maps that interface to the appropriate set of services and features.
Page 816
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cable Cable5/0/0 Cable7/0/0 Cable7/0/1 Router# The following example shows a typical display for the show pxf cable multicast-echo command for a particular multicast address: Router# show pxf cable multicast-echo 230.1.1.1...
Page 817
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cable Table 4-3 show pxf cable multicast-echo Field Descriptions Field Description Packets Number of packets sent to this address. Bytes Number of bytes sent to this address. The following example shows a typical display for the show pxf cable source-verify command:...
Page 818
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cable interface show pxf cable interface To display information about a particular service ID (SID) on a particular cable interface, use the show pxf cable command in user EXEC or privileged EXEC mode.
Page 819
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cable interface id=2, sfid=92 CFR Index 16462 RP sfindex 16462, prio=6, sip=0.0.0.0, sip mask=0.0.0.0 dip=1.11.22.2, dip mask=255.255.255.255, prot=256, tos=0,FF sport = 0,65535, dport = 0,65535 matches = 0 id=0, sfid=0 CFR Index 0 RP sfindex 0, prio=0, sip=0.0.0.0, sip mask=0.0.0.0...
Page 820
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cable interface Router# The following example shows a typical display for SID 1 on cable interface c8/0/0 for the show pxf cable interface service-flow ds command: Router# show pxf cable interface c8/0/0 1 service-flow ds...
Page 821
Displays information about the memory usage and routing tables in the PXF ip-address mask] processors for Cisco Express Forwarding (CEF) operation. Optionally displays detailed information about memory usage and about a particular entry in the virtual private network (VPN) routing/forwarding (VRF) tables.
Page 822
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cpu statistics Displays statistics for the packets that the PXF has processed. The default [diversion | drop is to display all packet statistics, or you can optionally specify one of the...
Page 823
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cpu IP Dest (MS) 1/128 0/32 16384 IP Dest (LS) 1/128 0/32 16384 TCP/UDP Src Port 1/128 0/32 16384 TCP/UDP Dest Port 1/128 0/32 16384 TCP Flags/Fragment 1/128 0/32 16384...
Page 824
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cpu Table 4-5 describes the fields shown in the show pxf cpu access-list command: Table 4-5 Field Descriptions for the show pxf cpu access-list Command Field Description Identifies the access list (ACL) in use, by either name or number.
Page 825
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cpu Buffers The following example shows a typical display for the buffers option: Router# show pxf cpu buffers FP buffers pool size # buffer available allocate failures --------------------------------------------------------- 9216 3203...
Page 826
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cpu 164.120.151.128/25 0.0.0.0/0 164.120.151.128/32 164.120.151.128/25 164.120.151.129/32 164.120.151.128/25 166.135.216.255/32 166.135.216.128/25 221.222.140.0/22 0.0.0.0/0 221.222.140.0/32 221.222.140.0/22 221.222.141.1/32 221.222.140.0/22 221.222.143.255/32 221.222.140.0/22 223.255.254.0/24 0.0.0.0/0 ======================================== 26 routes with less specific overlapping parent route FP CEF/MFIB/TFIB XCM Type usage:...
Page 827
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cpu Table 4-7 Field Descriptions for the show pxf cpu cef Command (continued) Field Description Parent Parent of this prefix’s leaf or node entry in the adjacency table. FP CEF/MFIB/TFIB XCM Type usage—The following fields display the memory usage of the shadow forwarding information base (FIB).
Page 828
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cpu only once, but some types of packets can require more than one pass through these columns, and each additional pass through the PXF processor is referred to as feedback. This counter represents the amount of traffic that cannot be processed in an optimal manner.
Page 829
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cpu Mroute The following example shows a typical display for the mroute option: Router# show pxf cpu mroute Shadow G/SG[5624]: s: 0.0.0.0 g: 224.0.1.40 uses: 0 bytes 0 flags: [D ] LNJ...
Page 830
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cpu wq_buffer_drop wq_limit_drop wq_invalid_enq_wqb_drop 0 wq_invalid_deq_wqb_drop 0 wq_rnd_pkt_drop wq_rnd_byte_drop wq_static_qlen_drop wq_len Packet xmit 69647 Byte xmit 41230926 Router# The following example shows a typical display for the queue option for a particular cable interface:...
Page 831
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cpu Router# Table 4-10 describes the fields shown in the show pxf cpu schedule command: Table 4-10 Field Descriptions for the show pxf cpu schedule Command Field Description Interface Identifies the cable interface or subinterface.
Page 834
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cpu mac length mismatch bad ip checksum ip length mismatch ip length short ip length long ip version mismatch bad rpf acl failure police unreachable mlp_frag_received mlp_unexpected_pkt df_multicast encap_not_supported mtu_too_wee...
Page 835
IP address is noroute 0.0.0.0. This counter also increases whenever the Cisco Express Forwarding (CEF) adjacency tables drop a packet because it has a null, discard, or drop adjacency.
Page 836
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cpu Table 4-11 show pxf cpu subblocks Field Descriptions Field Description Interface Identifies the interface or subinterface. Status Displays the status of the interface: Administ—The interface has been shut down and is in the •...
Page 837
Chapter 4 Commands for the Cisco uBR10012 Router show pxf cpu Table 4-11 show pxf cpu subblocks Field Descriptions Field Description VCCI map Displays the memory address for the Virtually Cool Common Index (VCCI) map table for this particular VCCI. The VCCI is an index that uniquely identifies every interface or subinterface on the PXF processor and that quickly maps that interface to the appropriate set of services and features.
Page 838
PXF processor. The buffers and registers options display information that is useful primarily to Cisco TAC engineers that are troubleshooting problems. The counters option displays a set of packet and error counters that can help diagnose and resolve problems with memory on the PXF processor.
Page 840
Chapter 4 Commands for the Cisco uBR10012 Router show pxf dma The following example shows a typical display for the dma counters option: Router# show pxf dma counters PXF DMA IOS Counters: To RP Counters: Packets: 874165, Cumulative Bytes: 531976708...
Page 841
Chapter 4 Commands for the Cisco uBR10012 Router show pxf dma PXF DMA PCI System Error: 0 PXF DMA PCI Target Abort: 0 PXF DMA PCI Master Abort: 0 PXF DMA PCI Retry Timeout: 0 PXF DMA Single Bit SDRAM Error: 0...
Page 842
Chapter 4 Commands for the Cisco uBR10012 Router show pxf dma The following example shows a typical display for the dma registers option: Router# show pxf dma registers PXF DMA PCI Registers: Vendor and Device ID: 0x00001137 Command and Status: 0x02A00147...
Page 844
Chapter 4 Commands for the Cisco uBR10012 Router show pxf dma Related Commands Command Description clear pxf Clears the direct memory access (DMA) and error checking and correcting (ECC) error counters on the PXF processor. debug pxf Enables debugging of the PXF subsystems on the active PRE1 module on the Cisco uBR10012 router.
Page 845
The PXF processors onboard the Performance Routing Engine (PRE1) module automatically load their microcode at the same time that the Cisco IOS image is loaded into the PRE1 module. A fault situation can cause one or both of the PXF processors to reload the microcode as needed. You can use the show pxf microcode command to display the version of microcode currently loaded, as well as the number of times the microcode has been loaded since the Cisco IOS software was loaded at system bootup.
Page 846
Identifies the number of times the PXF processor has loaded the microcode attempted since the Cisco IOS image was loaded at system bootup. Also shows the time (in days and hours) since the last successful load of the microcode. DISABLE_BOOTSTR Displays the current state of operation for the PXF processor.
Page 847
Chapter 4 Commands for the Cisco uBR10012 Router show pxf microcode Command Description show pxf dma Displays information for the current state of the PXF DMA buffers, error counters, and registers. show pxf xcm Displays the current state of ECC for the External Column Memory (XCM) on the PXF processor.
Page 848
The show pxf xcm command is supported only on the PRE1 and later processors for the Note Cisco uBR10012 router. This command is not supported on the PRE module. Examples The following example shows a typical display for the show pxf xcm command for a PRE1 module:...
Page 849
Chapter 4 Commands for the Cisco uBR10012 Router show pxf xcm ECC is enabled for column 1 XCM Control Register: 0x00000001 XCM Exception Type Register: 0x00000000 SDRAM-A Counters Number of ECC single bit errors: 0 SDRAM-B Counters Number of ECC single bit errors: 0...
Page 850
Chapter 4 Commands for the Cisco uBR10012 Router show pxf xcm Table 4-14 describes the fields displayed by the show pxf xcm command. Table 4-14 show pxf xcm Field Descriptions Field Description The following fields appear for each PXF processor Toaster 0, Toaster 1 Identifies the PXF processor.
(primary) Performance Routing Engine (PRE1) module, the status of the standby (secondary) PRE1 module, and the values for the standby PRE1 module’s boot variables and configuration register. In Cisco IOS Release 12.2(13)BC1 and later releases, it also shows the version of Cisco IOS software that is running on the standby PRE module.
Page 852
FP: 0x7234CB58, RA: 0x6051F61C Router# The following example shows a typical display from the show redundancy command in Cisco IOS Release 12.2(15)BC1 and earlier releases. The active PRE1 module is in PRE slot A, and the standby PRE1 module is in PRE slot B:...
Page 853
Secondary version: Cisco Internetwork Operating System Software IOS (tm) 10000 Software (UBR10K-K8P6-M), Released Version 12.2(11)BC3 Copyright (c) 1986-2003 by cisco Systems, Inc. Compiled Mon 03-Mar-03 11:28 by texbnt Router# The following example shows the same display but after a switchover has occurred. The show...
Page 854
Chapter 4 Commands for the Cisco uBR10012 Router show redundancy Counters Display The following example shows a typical display for the show redundancy counters command: Router# show redundancy counters Redundancy Facility OMs comm link up = 1 comm link down down = 0...
Page 855
Chapter 4 Commands for the Cisco uBR10012 Router show redundancy my state = 13 -ACTIVE peer state = 8 -STANDBY HOT Mode = Duplex Unit = Primary Unit ID = 0 Redundancy Mode = Hot Standby Redundancy Maintenance Mode = Disabled...
Page 856
Release Modification 12.2(15)BC2 This command was introduced for the Cisco uBR10012 router. Usage Guidelines The PXF processors that are onboard the PRE1 module automatically restart themselves if a crash occurs. Occasional crashes could be expected, but repeated crashes could indicate a hardware problem.
Page 857
Chapter 4 Commands for the Cisco uBR10012 Router switchover pxf restart Router(config-f)# exit Router(config)# Related Commands Command Description main-cpu Enters main-CPU redundancy configuration mode, so that you can configure the synchronization of the active and standby Performance Routing Engine (PRE1) modules.
Page 858
Release Modification 12.2(11)BC3 This command was introduced for the Cisco uBR10012 router. Usage Guidelines The switchover timeout command specifies how long the standby PRE module should wait when it does not detect a heartbeat from the active PRE module before initiating a switchover and assuming responsibility as the active PRE module.
Page 859
Chapter 4 Commands for the Cisco uBR10012 Router switchover timeout Command Description redundancy Configures the synchronization of system files between the active and standby PRE1 modules. redundancy Forces a manual switchover between the active and standby PRE1 modules. force-failover main-cpu...
Page 860
Chapter 4 Commands for the Cisco uBR10012 Router switchover timeout Cisco Broadband Cable Command Reference Guide 4-100 OL-1581-08...
Debug Commands, page 5-4—Describes the cable-specific commands that are used to troubleshoot • the Cisco CMTS configuration and operation, and to troubleshoot the operation of a connected cable modem (CM). This chapter documents only cable-specific debugging commands. For non-cable-specific debugging...
Debug Output to the Console Can Be Incomplete Cable interface line cards that have their own onboard processor, such as the Cisco uBR-MC5X20S and Cisco uBR-MC28U/X cards, initially collect the debug messages and then pass them on to the processor card using interprocess communications (IPC) messages.
Cisco IOS releases documented at time of this publication. Not all Cisco IOS releases support all Cisco CMTS platforms. See the release notes for each Cisco IOS Note release for details on which platforms are supported.
Page 865
Most debug commands assume that the network administrator or cable operator is familiar with DOCSIS Note networks and the DOCSIS specifications (see http://www.cablemodem.com/specifications.html for the current copies of the DOCSIS 1.0 and 1.1 specifications.) Cisco Broadband Cable Command Reference Guide OL-1581-08...
Page 866
The last message displayed above, “unable to find CM with SID 0,” is typically generated by the show Note cable commands and can be ignored. Related Commands Command Description debug cable interface Enables debugging on a specific cable interface. Cisco Broadband Cable Command Reference Guide OL-1581-08...
CMs, because the resulting volume of debug output could impact system performance. Cisco recommends that when you use the debug cable arp command, you limit its output to a particular interface or CM, using the...
Page 868
Command History Release Modification 12.2(15)BC2 This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012 universal broadband routers. Usage Guidelines If you suspect a particular CM is generating a large volume of ARP traffic, you can enable debugging for that particular CM using the debug cable arp command. If the ARP traffic is excessive, you can enable ARP filtering on the associated cable interface using the cable arp filter command.
Page 869
Enables debugging for a particular CM. mac-address show cable arp-filter Displays the total number of ARP replies and requests that have been sent and received, including the number of requests that have been filtered. Cisco Broadband Cable Command Reference Guide OL-1581-08...
Page 870
This command was introduced. Usage Guidelines This command activates debugging of the BPI feature. When this command is activated, the Cisco CMTS displays debugging information for any BPI-related messages that the CMTS sends or receives. Note This command is supported only on images that support BPI or BPI+ encryption.
Page 871
Enables debugging on a specific cable interface. debug cable keyman Displays debugging information about BPI key management. debug cable privacy Displays debugging information whenever the BPI state changes or a BPI event occurs. Cisco Broadband Cable Command Reference Guide 5-11 OL-1581-08...
Page 872
The debug cable bundle pkt command does not display information about multicast packets on the Note Cisco uBR10012 router. Use the show ip mroute count and show hardware pxf cpu mroute commands to display this information on the Cisco uBR10012 router.
Page 873
Chapter 5 Cisco CMTS Debugging Commands debug cable bundle Related Commands Command Description debug cable interface Enables debugging on a specific cable interface. Cisco Broadband Cable Command Reference Guide 5-13 OL-1581-08...
Page 874
Router# show debug CMTS: CMTS config file debugging is on Router# When debugging is turned on, the Cisco CMTS displays the following message when it generates a DOCSIS configuration file for transmission to a CM: Cisco Broadband Cable Command Reference Guide 5-14...
Page 875
Displays the current run-time configuration, which includes any configuration files that have been defined. show startup-config Displays the current saved configuration, which includes any configuration files that have been defined and saved. Cisco Broadband Cable Command Reference Guide 5-15 OL-1581-08...
Page 876
CMs, because the resulting volume of debug output could impact system performance. Cisco recommends that when you use the debug cable dcc command, you limit its output to a particular interface or CM, using the debug cable interface command.
Page 877
62,500 Hz, which is required by the DOCSIS specification: 00:07:28: Found DCC TLV 00:07:28: US Channel ID 2 00:07:28: Found DCC TLV 00:07:28: Init Tech 4 00:07:28: Found DCC TLV 00:07:28: ERROR: DS frequency not a multiple of 62500Hz. Cisco Broadband Cable Command Reference Guide 5-17 OL-1581-08...
Page 878
00:07:28: Not able to parse the TLVs. Displays debugging messages about the TLV values used for service Related Commands debug cable tlvs flow encodings, classifier encodings, and PHS rules. Cisco Broadband Cable Command Reference Guide 5-18 OL-1581-08...
Page 879
12.2(4)BC1 Support was added to the Release 12.2 BC train. Usage Guidelines This command shows debugging messages about the DCI-REQ messages that the Cisco CMTS receives from CMs. See the DOCSIS 1.1 specification (revision SP-RFIv1.1-I05-000714 and above) for additional Note information on the DCI-REQ, DCI-RSP, and Upstream Transmitter Disable (UP-DIS) messages.
Page 880
CMs, because the resulting volume of debug output could impact system performance. Cisco recommends that when you use the debug cable dhcp command, you limit its output to a particular interface or CM, using the...
Page 881
Enables debugging of encapsulated PPPoE packets that are transmitted over the cable interface. debug cable interface Enables debugging on a specific cable interface. debug cable Enables debugging for a particular CM. mac-address Cisco Broadband Cable Command Reference Guide 5-21 OL-1581-08...
Page 882
Command History Release Modification 12.2(15)BC2 This command was introduced for the Cisco uBR7100 series and Cisco uBR7246VXR routers. Usage Guidelines Because this command can produce a large volume of debug information, use this command only when you have also enabled debugging for a particular interface or MAC address, using the...
Page 883
MAC address: DSG: mac 0001.0002.0003 is resolved for 225.2.2.2 on Cable5/0 The following sample messages show that the Cisco CMTS is using its internal DSG tables to find the appropriate MAC address for an IP multicast group: DSG: got mac 0001.0002.0003 for group 225.2.2.2 on Cable5/0...
Page 884
Command History Release Modification 12.2(15)BC1 This command was introduced for Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers. Usage Guidelines Because this command can produce a large volume of debug information, use this command only when you have also enabled debugging for a particular interface or MAC address, using the debug cable interface and debug cable mac-address commands, respectively.
Page 885
02:16:15: Added Service Class Data TLV: 02:16:15: 0x0000: 01 07 01 01 01 02 02 00 01 02:16:15: REG-RSP Status : ok (0) 02:16:15: Closing file for modem 00c0.2345.6789: New modem state from init(o) to online Cisco Broadband Cable Command Reference Guide 5-25 OL-1581-08...
Page 886
TFTP server: 16:11:33: Could not locate bootfile name for 0102.0304.0506 16:11:33: Cannot locate config-file.cm requested by CM 0102.0304.0506 16:11:33: Closing file for modem 0102.0304.0506: New modem state from init(rc) to offline Cisco Broadband Cable Command Reference Guide 5-26 OL-1581-08...
Page 887
Enables debugging output for a specific cable interface. debug cable Enables debugging output for the cable modems that match the specified mac-address hardware (MAC) address or range of addresses. Cisco Broadband Cable Command Reference Guide 5-27 OL-1581-08...
Page 888
DOCSIS MAC-layer debugging. Examples The following example shows typical output displayed by the debug cable dynsrv command: Router# debug cable interface c3/0 Router# debug cable dynsrv CMTS dynsrv debugging is on Cisco Broadband Cable Command Reference Guide 5-28 OL-1581-08...
Page 889
Enables debugging on a specific cable interface. debug cable mac-address Enables debugging for MAC-layer information for a specific CM. debug cable tlvs Enables debugging for the Type/Length/Value encodings (TLVs) parsed by the DOCSIS 1.1 TLV parser/encoder. Cisco Broadband Cable Command Reference Guide 5-29 OL-1581-08...
Page 890
CMs, because the resulting volume of debug output could impact system performance. Cisco recommends that when you use the debug cable encap command, you limit its output to a particular interface or CM, using the...
Page 891
Enables debugging of the Dynamic Host Configuration Protocol on the cable interface. debug cable interface Enables debugging on a specific cable interface. debug cable Enables debugging for a particular CM. mac-address Cisco Broadband Cable Command Reference Guide 5-31 OL-1581-08...
Page 892
To display information about the Cisco CMTS physical environment, including internal temperature, midplane voltages, fan performance, and power supply voltages, use the debug cable env command in privileged EXEC mode. To disable debugging output, use the no form of this command.
Page 893
Chapter 5 Cisco CMTS Debugging Commands debug cable envm Related Commands Command Description show environment Displays the temperature and voltage information for the chassis. Cisco Broadband Cable Command Reference Guide 5-33 OL-1581-08...
Page 894
This command was introduced. Usage Guidelines This command displays unexpected DOCSIS MAC protocol messages. When the Cisco CMTS does not to expect to receive a specific MAC message, or if a packet contains errors in size or content, an error message and a hex dump of the packet are printed.
Page 895
Support for this command was added to the Release 12.2 BC train. Usage Guidelines This command shows debugging messages about the internal configuration file editor on the Cisco CMTS. For more information about the internal configuration file editor, see the cable config-file command and its subcommands.
Page 896
Chapter 5 Cisco CMTS Debugging Commands debug cable flap When debugging is turned on, the Cisco CMTS displays the following message when a CM is added to the flap list: Cable modem <<mac address>> added to flap-list When debugging is turned on, the Cisco CMTS displays the following message when a CM is removed from the flap list: Cable modem <<mac address>>...
Page 897
CMTS freqhop debugging is on router# Sep 27 10:36:41.202: Cable5/0 U0: last hop delta: 1 Sep 27 10:36:42.202: Cable5/0 U0: last hop delta: 2 Cisco Broadband Cable Command Reference Guide 5-37 OL-1581-08...
Page 898
The following shows how to enable debug cable hw-spectrum debugging. Router# debug cable hw-spectrum CMTS spectrum analyzer debugging is on Router# Related Commands Command Description debug cable specmgmt Displays debugging output for the CMTS spectrum analyzer process. Cisco Broadband Cable Command Reference Guide 5-38 OL-1581-08...
Page 899
Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
Page 900
Displays debugging information about DOCSIS 1.1 dynamic service flow messages. debug cable mac-address Enables debugging on traffic from CMs with the specific MAC address or within the specific MAC address range. Cisco Broadband Cable Command Reference Guide 5-40 OL-1581-08...
This command activates debugging of the TEK and KEK baseline privacy key activity. When this command is activated, all activity related to KEK and TEK keys is displayed on the Cisco CMTS console. This command is used to display encryption key management debugging output.
Page 902
Description debug cable bpiatp Displays debugging information for BPI-related messages that the CMTS sends or receives. debug cable privacy Displays debugging information whenever the BPI state changes or a BPI event occurs. Cisco Broadband Cable Command Reference Guide 5-42 OL-1581-08...
Page 903
Release Modification 12.2(11)BC3 This command was introduced for Cisco uBR7100 series and Cisco uBR7246VXR universal broadband routers to debug the Layer 2 mapping of cable modems to a PVC on an Asynchronous Transfer Mode (ATM) interface. 12.2(15)BC2 Support was added for the debugging of the Layer 2 mapping of cable modems to a virtual local area network (VLAN) on an outbound Ethernet interface.
Page 904
6d00h: Fwd pkt size 74 from 000C.0807.0605 on Cable4/0:0x1 to 0900.2b00.000f on ATM2/0:1/1 6d00h: Fwd pkt size 74 from 000C.0807.0605 on Cable4/0:0x1 to 0900.07ff.ffff on ATM2/0:1/1 6d00h: Fwd pkt size 1028 from 000C.0807.0605 on Cable4/0:0x1 to 0002.4a1d.dc1d on ATM2/0:1/1 Cisco Broadband Cable Command Reference Guide 5-44 OL-1581-08...
Page 905
Displays the mapping of one or all cable modems to IEEE 802.1Q Virtual dot1q-vc-map Local Area Networks (VLANs) on the router’s Ethernet interfaces. show cable l2-vpn Displays the mapping of one or all cable modems to PVCs on the ATM vc-map interfaces. Cisco Broadband Cable Command Reference Guide 5-45 OL-1581-08...
Page 906
Because this command can produce a large volume of debug information, Cisco recommends that you limit debugging output to a particular interface or MAC address, using the debug cable interface and debug cable mac-address commands, respectively.
Page 907
Configures the frequency of the load-balancing policy updates. group interval cable load-balance Configures how the Cisco CMTS should load balance cable modems with group policy ugs active unsolicited grant service (USG) service flows. cable load-balance Configures the threshold values that a load-balance group should use for group threshold load-balancing operations.
Page 908
In this case, the latest debugging information supersedes the previous debugging information. Do not use this command if you have a large number of CMs on your network. The Cisco CMTS will Note become flooded with console printouts.
Page 909
CM comes online with the CMTS. debug cable tlvs Enables debugging for the Type/Length/Value encodings (TLVs) parsed by the DOCSIS 1.1 TLV parser/encoder. show controllers cable Displays interface controller information for the specified slot. Cisco Broadband Cable Command Reference Guide 5-49 OL-1581-08...
Page 910
12.1 T This command was introduced. Usage Guidelines Do not use this command if you have a large number of CMs on your network. The Cisco CMTS will become flooded with console printouts. Examples The following example shows the return for the MAC layer:...
Page 911
Displays debugging output for the registration messages sent when a CM comes online with the CMTS. show controllers cable Displays interface controller information for the specified slot. Cisco Broadband Cable Command Reference Guide 5-51 OL-1581-08...
Page 912
Cisco uBR10012 routers. Usage Guidelines Do not use this command if you have a large number of CMs on your network. The Cisco CMTS will become flooded with console printouts. The debug commands are primarily intended for use in controlled test and troubleshooting situations Caution with a limited volume of traffic.
Page 913
Displays debugging output for the CMs that match the specified address or mac-address range of addresses. debug cable Displays debug messages for the MAC-layer protocol. mac-protocol debug cable Displays debug messages for upstream admission control activity. us-adm-ctrl Cisco Broadband Cable Command Reference Guide 5-53 OL-1581-08...
This command activates debugging of messages generated in the PHY system, which is the physical layer where upstream and downstream activity between the Cisco CMTS and the HFC network is controlled. When this command is activated, any messages generated in the PHY system are displayed on the Cisco CMTS console.
Page 919
Displays debugging information about the BPI-related messages that the CMTS sends or receives. debug cable interface Enables debugging output for a specific cable interface. debug cable keyman Displays debugging information about BPI key management. Cisco Broadband Cable Command Reference Guide 5-59 OL-1581-08...
This command was introduced. Usage Guidelines This command activates debugging of QoS. When this command is activated, any messages related to QoS parameters are displayed on the Cisco CMTS console. Examples The following is typical output from the debug cable qos command: CMTS_QOS_LOG_NO_MORE_QOS_INDEX Modems cannot add more entries to the class of service table.
3E 1E 3F FF 00 00 59 BF 01 15 F8 01 A7 00 0C F0 The following output shows typical output when a CM first seeks to establish a link to the Cisco CMTS. The service identifier (SID) value of 0 indicates that the modem has no assigned SID. The CM mac address is the MAC address of the modem's radio frequency (RF) interface, not its Ethernet interface.
Page 922
Ranging has been successful for SID 2 on Interface Cable3/0/U0 Output occurs when the modem is polled by the CMTS during station maintenance. Polling happens at a minimum rate of once every 10 seconds. Cisco Broadband Cable Command Reference Guide 5-62 OL-1581-08...
Page 923
CMTS debug Rx debugging is on The debug cable receive command was disabled in Cisco IOS Release 12.1 T, 12.1 EC, and later releases, although it still appears in the CLI until Cisco IOS Release 12.1(11b)EC. To monitor the packets received from the CMs, use the debug ip packet command instead.
Page 924
Jul 4 14:31:37.475: The MAX US RATE : 2000000 Jul 4 14:31:37.475: This TLV is GOOD Jul 4 14:31:37.475: Found vendor extensions Jul 4 14:31:37.475: Cisco Vendor ID Field found(ok) Jul 4 14:31:37.475: No. of requested phone lines is 2 Jul 4 14:31:37.475: This TLV is GOOD Jul 4 14:31:37.475: Found vendor extensions...
Page 925
CMS calculate the MIC value only over the length of the registration TLV parameters. The Cisco CMTS attempts to verify the MIC and shared secret values using the first technique, and if that fails, the CMTS then uses the second technique to verify the CM.
Page 926
The following example shows typical output when a CM attempts to come online without downloading a DOCSIS configuration file from a TFTP server through the Cisco CMTS cable interface, when the cable tftp-enforce command has been used.
Page 927
Community string if modified will not be reflected The polling interval will be changed but to change the community string, you must unconfigure Note the snmp-server community command and reconfigure it with the new community string. Cisco Broadband Cable Command Reference Guide 5-67 OL-1581-08...
Page 928
CMTS. show cable modem Displays the statistics accumulated by the remote-query feature. remote-query snmp-server enable traps Enables traps that are sent when the remote polling of CMs has been cable completed. Cisco Broadband Cable Command Reference Guide 5-68 OL-1581-08...
Page 929
The following shows typical output from the debug cable reset command: Router# debug cable reset CMTS reset debugging is on Router# Resetting CMTS interface. Num SIDs = 32 Ranging count = 10 Elapsed time: 21 seconds Cisco Broadband Cable Command Reference Guide 5-69 OL-1581-08...
Page 932
When this command is activated, any messages generated due to spectrum group activity will be displayed on the Cisco CMTS console. Spectrum group activity can be additions or changes to spectrum groups, or frequency and power lever changes controlled by spectrum groups.
Page 933
This command activates debugging of the channel allocations on the HFC network. When this command is activated, any messages generated when channels are allocated to CMs on the HFC network are displayed on the Cisco CMTS console. This command should be used for development testing only, not in production setting.
Page 934
Creates an enforce-rule to be used to enforce a particular quality of service (QoS) profile and enters enforce-rule configuration mode. debug cable interface Enables debugging output for a specific cable interface. Cisco Broadband Cable Command Reference Guide 5-74 OL-1581-08...
Page 935
Enables debugging output for the cable modems that match the specified mac-address hardware (MAC) address or range of addresses. show cable qos Displays the quality of service (QoS) enforce-rules that are currently enforce-rule defined. Cisco Broadband Cable Command Reference Guide 5-75 OL-1581-08...
Page 936
10.10.10.10 Registration IP address:10.10.10.10 CMTS boot time: 3080626752 DS channel ID: Epoch: Related Commands Command Description debug cable telco-return msg Displays the Telephony Channel Descriptor (TCD) and Termination System Information (TSI) messages. Cisco Broadband Cable Command Reference Guide 5-76 OL-1581-08...
Page 937
Sending TSI message: DS channel IP address: 10.10.10.10 Registration IP address:10.10.10.10 CMTS boot time: 3080626752 DS channel ID: Epoch: Related Commands Command Description debug cable telco-return Displays debug messages for telco-return events. Cisco Broadband Cable Command Reference Guide 5-77 OL-1581-08...
Page 938
Modification 12.1(4)CX This command was introduced. 12.2(4)BC1 This command was supported on the Cisco uBR7100 series and Cisco uBR10012 universal broadband routers. Usage Guidelines This command displays the TLVs for service flow encodings, classifier encodings, and PHS rules. Do not use this command when you have a large number of active CMs on your network because it could generate a huge amount of output to the console port.
Page 940
Displays debugging information about DOCSIS 1.1 dynamic service flow messages. debug cable interface Enables debugging on a specific cable interface. debug cable mac-address Enables debugging for MAC-layer information for a specific CM. Cisco Broadband Cable Command Reference Guide 5-80 OL-1581-08...
Page 941
To display debugging for the local time-of-day (ToD) server on the Cisco CMTS, use the debug cable tod command in privileged EXEC mode. To disable debugging output, use the no form of this command.
Page 942
CMTS debug transmit debugging is on Router# The debug cable transmit command was disabled in Cisco IOS Release 12.1 T, 12.1 EC, and later releases, although it still appears in the CLI until Cisco IOS Release 12.1(11b)EC. To monitor the packets transmitted by the CMs, use the debug ip packet command instead.
This command activates debugging of any upstream channel change (UCC) messages generated when CMs request or are assigned a new channel. When this command is activated, any messages related to upstream channel changes are displayed on the Cisco CMTS console. Examples...
Page 944
Cable modems that are configured to use enhanced upstream channels use these UCD messages to identify and select an enhanced upstream channel to use. When this command is activated, any messages related to upstream channel descriptors are displayed on the Cisco CMTS console. Examples...
Page 947
Cisco uBR10012 router. Usage Guidelines This command activates hardware debugging of the internal upconverter that is onboard the Cisco uBR7100 series or the Cisco uBR10-MC5X20S cable interface line card on the Cisco uBR10012 router. Examples The following command shows how to enable the debug cable upconverter output:...
Page 948
Privileged EXEC Command History Release Modification 12.1(4)CX This command was introduced for the Cisco uBR10012 router. 12.2(4)BC1 Support for this command was added to the Release 12.2 BC train for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.
Page 949
Related Commands Command Description cable upstream Determines the percentage of overbooking allowed on the upstream channel. admission-control debug cable Displays information for the MAC layer’s scheduler and admission control mac-scheduler activities. Cisco Broadband Cable Command Reference Guide 5-89 OL-1581-08...
Page 950
Cisco CMTS Debugging Commands debug checkpoint debug checkpoint To enable debugging of the Checkpointing Facility (CF) subsystem on the Cisco uBR10012 router, use the debug checkpoint command in privileged EXEC mode. To disable debugging output, use the no form of the command.
Page 951
To enable debugging of the subsystems on the active Performance Routing Engine (PRE1) module on the Cisco uBR10012 router, use the debug cr10k-rp pkt command in privileged EXEC mode. To disable debugging output, use the no form of the command.
Page 952
In Cisco IOS Release 12.2(11)BC2 and later releases, you can use the conditional option, together with the debug cable mac-address and debug cable interface commands, to display information about selected packets.
Page 953
Additionally, peeking inside transmitted pkts at offset 92 Both types of packet debugging generate output similar to the following example: Jun 19 13:07:32.316: RPTX: Using Downstream Service Flow ID : 16939, SID : 2 Cisco Broadband Cable Command Reference Guide 5-93 OL-1581-08...
Page 954
(Cable 7/0/0:1) Release frequency (12800000, 1600000) from group 2 (Cable 7/0/0:1) Frequency request (12000000 - 15200000) from group 2 approved (Cable 7/0/0:2) Frequency request (20000000 - 21600000) from group 22 approved (Cable 7/0/0:2) Release frequency (20800000, 1600000) from group 22 Cisco Broadband Cable Command Reference Guide 5-94 OL-1581-08...
Page 955
HCCP and DOCSIS protocol subsystems to synchronize after a switchover. Router# debug cable interface c6/1/0 Router# debug cr10k-rp ha-msg CR10K RP debug High Availability msg PRE_HA_BUGMSG PRE REDUNDANCY: Bulk sync completed PRE REDUNDANCY: Recv bulk sync complete - sending ack Cisco Broadband Cable Command Reference Guide 5-95 OL-1581-08...
Page 956
PRE_HA: <Cable I/F> Unable to start the data recovery process Related Commands Command Description debug cable interface Enables debugging on a specific cable interface. debug cable Enables debugging for a specific CM, as identified by its hardware (MAC) mac-address address. Cisco Broadband Cable Command Reference Guide 5-96 OL-1581-08...
Page 957
Command History Release Modification 12.1(3a)EC This command was introduced. 12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012 12.2(4)BC1 router. 12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR7246VXR router.
Page 959
Mar 7 10:12:21:HCCP: snmp request failed Mar 7 10:12:21:HCCP: snmp request cancelled Mar 7 11:51:50:HCCP: group 1 member 1 Working is loading config Mar 7 11:51:52:HCCP: group 1 member 1 Working finished loading config Cisco Broadband Cable Command Reference Guide 5-99 OL-1581-08...
Page 960
Displays debug messages for HCCP-related messages sent between the router’s control plane and data backplane. debug hccp sync Displays debug messages for HCCP synchronization messages. debug hccp timing Displays debug messages for the timing of HCCP events. Cisco Broadband Cable Command Reference Guide 5-100 OL-1581-08...
Page 961
Displays debug messages for HCCP-related messages sent between the router’s control plane and data backplane. debug hccp sync Displays debug messages for HCCP synchronization messages. debug hccp timing Displays debug messages for the timing of HCCP events. Cisco Broadband Cable Command Reference Guide 5-101 OL-1581-08...
Page 962
Command History Release Modification 12.1(3a)EC This command was introduced. 12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012 12.2(4)BC1 router. 12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR7246VXR router.
Page 963
Displays authentication debug messages for HCCP groups. authentication debug hccp events Displays debug messages for all HCCP group interaction. debug hccp inter-db Displays debug messages for the inter-database events during HCCP operations. Cisco Broadband Cable Command Reference Guide 5-103 OL-1581-08...
Page 964
Displays debug messages for HCCP-related messages sent between the router’s control plane and data backplane. debug hccp sync Displays debug messages for HCCP synchronization messages. debug hccp timing Displays debug messages for the timing of HCCP events. Cisco Broadband Cable Command Reference Guide 5-104 OL-1581-08...
Page 965
Command History Release Modification 12.1(3a)EC This command was introduced. 12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012 12.2(4)BC1 router. 12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR7246VXR router.
Page 966
Displays debug messages for HCCP-related messages sent between the router’s control plane and data backplane. debug hccp sync Displays debug messages for HCCP synchronization messages. debug hccp timing Displays debug messages for the timing of HCCP events. Cisco Broadband Cable Command Reference Guide 5-106 OL-1581-08...
Page 967
Cisco uBR7246VXR router. The syncpulse option also was added. Usage Guidelines The processor card and line cards on the Cisco uBR10012 router chassis communicate with each other using the control plane (which is on the processor card) and the data backplane (the backplane into which the line cards are installed).
Page 968
Displays debug messages for the inter-database events during HCCP operations. debug hccp sync Displays debug messages for HCCP synchronization messages. debug hccp timing Displays debug messages for the timing of HCCP events. Cisco Broadband Cable Command Reference Guide 5-108 OL-1581-08...
Page 969
12.1(3a)EC This command was introduced. 12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012 12.2(4)BC1 router. Also, the cable message-specific options were added to allow the debugging of a particular set of messages without overloading the console.
NO Apr 24 17:17:16.467: HCCP of offered band HCCP: get offered_band data for US 0 freq 12400000 chnnl-width 1600000 ip-pwr-lvl 0, spec-grp 12, modulation 1, awacs NO, shared spectrum NO Cisco Broadband Cable Command Reference Guide 5-110 OL-1581-08...
Page 971
Displays debug messages for the timing of HCCP events. debug packetcable Enables debugging messages for events that are related to Hot Standby hccp Connection-to-Connection Protocol (HCCP) N+1 redundancy synchronization for PacketCable operations. Cisco Broadband Cable Command Reference Guide 5-111 OL-1581-08...
Page 972
Command History Release Modification 12.1(3a)EC This command was introduced. 12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012 12.2(4)BC1 router. 12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR7246VXR router.
Page 973
Displays debug messages related to an RF or channel switch that is being channel-switch used for HCCP N+1 (1:n) redundancy. debug hccp events Displays debug messages for all HCCP group interaction. debug hccp inter-db Displays debug messages for the inter-database events during HCCP operations. Cisco Broadband Cable Command Reference Guide 5-113 OL-1581-08...
Page 974
Command Description debug hccp plane Displays debug messages for HCCP-related messages sent between the router’s control plane and data backplane. debug hccp sync Displays debug messages for HCCP synchronization messages. Cisco Broadband Cable Command Reference Guide 5-114 OL-1581-08...
Page 975
PacketCable debugging for one or more IP addresses before the debug packetcable all command displays any output. To display detailed debugging output in Cisco IOS Release 12.2(15)BC1 and later releases, use the Note verbose option when you enable PacketCable debugging output using the...
Page 977
Displays debugging messages related to the COPS protocol. debug packetcable Enables debugging of Common Open Policy Service (COPS) messages and cops errors that are related to PacketCable operations on the Cisco CMTS router. debug packetcable Displays general debugging messages related to specific PacketCable gate gate events and messages.
Page 978
Command Description debug packetcable ipc Enables interprocess communications (IPC) messages related to PacketCable operations on the Cisco uBR10012 router. debug packetcable Enables PacketCable debugging for a specific subscriber IP address. subscriber Cisco Broadband Cable Command Reference Guide...
Page 979
To enable debugging of Common Open Policy Service (COPS) messages and errors that are related to PacketCable operations on the Cisco CMTS router, use the debug packetcable cops command in privileged EXEC mode. To turn off this debugging, use the no form of this command.
Page 980
Connection-to-Connection Protocol (HCCP) N+1 redundancy synchronization for PacketCable operations. debug packetcable ipc Enables interprocess communications (IPC) messages related to PacketCable operations on the Cisco uBR10012 router. debug packetcable Enables PacketCable debugging for a specific subscriber IP address. subscriber Cisco Broadband Cable Command Reference Guide...
Page 981
12.2(15)BC1 The coordination and detail options were removed, and the process option was added. Support was also added for the Cisco uBR10012 router. In addition, most options no longer display any output until PacketCable debugging has been enabled for one or more IP addresses, using the...
Page 982
In Cisco IOS Release 12.2(15)BC1 and later, you must also enable debugging for one or more IP addresses, using the debug packetcable subscriber command, before the debug packetcable gate command displays any output.
Page 985
The following example shows typical debugging messages for gate coordination events. Omit the verbose option if you do not want to display the header and message contents. The coordination option was removed in Cisco IOS Release 12.2(15)BC1. Note Router# debug packetcable subscriber 192.168.78.21 verbose...
Page 986
Jul 25 16:17:29 UTC: Pktcbl(gdb): request to transition gate ID 2359392 direction downstream to state 2 Jul 25 16:17:29 UTC: Pktcbl(gdb): Stopped gate [id 2359392] timer [type 1] Jul 25 16:17:29 UTC: Pktcbl(gdb): Started gate [id 2359392] timer t1 [300 sec] Cisco Broadband Cable Command Reference Guide 5-126 OL-1581-08...
Page 988
Displays general debugging messages for all PacketCable events. debug packetcable Enables debugging of Common Open Policy Service (COPS) messages and cops errors that are related to PacketCable operations on the Cisco CMTS router. debug packetcable Enables debugging messages for events that are related to Hot Standby hccp Connection-to-Connection Protocol (HCCP) N+1 redundancy synchronization for PacketCable operations.
Page 989
Use this command to enable debugging for events that are related to HCCP redundancy operations that are related to PacketCable operations on the Cisco CMTS. These debugging messages show errors that occurred when the Cisco CMTS was synchronizing the PacketCable databases and state information between the Working and Protect interfaces.
Page 990
Description debug packetcable Enables debugging of Common Open Policy Service (COPS) messages and cops errors that are related to PacketCable operations on the Cisco CMTS router. debug packetcable Displays general debugging messages related to specific PacketCable gate gate events and messages.
Page 991
This command enables debugging for the IPC messages that are sent between the PRE1 module and cable interface line cards on the Cisco uBR10012 router during PacketCable operations. This command is not supported on the Cisco uBR7200 series router because this router does not use IPC messaging for PacketCable operations.
Page 992
Displays general debugging messages for all PacketCable events. debug packetcable Enables debugging of Common Open Policy Service (COPS) messages and cops errors that are related to PacketCable operations on the Cisco CMTS router. debug packetcable Displays general debugging messages related to specific PacketCable gate gate events and messages.
Page 993
In Cisco IOS Release 12.2(15)BC1 and later releases, you must use the debug packet subscriber command to enable debugging for at least one IP address before the following debug packetcable...
Page 994
Displays general debugging messages for all PacketCable events. debug packetcable Enables debugging of Common Open Policy Service (COPS) messages and cops errors that are related to PacketCable operations on the Cisco CMTS router. debug packetcable Displays general debugging messages related to specific PacketCable gate gate events and messages.
Page 995
To enable debugging of the Parallel eXpress Forwarding (PXF) subsystems on the active Performance Routing Engine (PRE1) module on the Cisco uBR10012 router, use the debug pxf command in privileged EXEC mode. To disable debugging output, use the no form of the command.
Page 998
00:05:29: Statcoll read simple_octet...: NULL params (hwsb=0xFF, tt_info=0x%C0) debug pxf subblocks The following example shows how to enable debugging of the subblocks on the PXF processors: Router# debug pxf subblocks PXF Subblocks debugging is on Router# Cisco Broadband Cable Command Reference Guide 5-138 OL-1581-08...
Page 999
Displays identifying information for the microcode being used on the microcode processor. show hardware pxf Displays the current state of ECC for the External Column Memory (XCM) on the PXF processor. Cisco Broadband Cable Command Reference Guide 5-139 OL-1581-08...
Command Modes Privileged EXEC Command History Release Modification 12.2(4)XF1 This command was introduced for the Cisco uBR10012 router. 12.2(11)BC3 The fsm option was renamed to rf-fsm. Examples The following example shows all redundancy debugging messages being enabled: Router# debug redundancy all...