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.