|
|
This section describes the cable-specific commands for the Cisco Cable Modem Termination System (CMTS) features supported on the Cisco uBR7200 series universal broadband routers. Refer to the following sections for more information:
The Cable CMTS commands operate on the Cisco uBR7200 series universal broadband routers (the Cisco uBR7223, the Cisco uBR7246, and the Cisco uBR7246 VXR). The following are the supported Cisco IOS Releases documented at time of this publication:
| Cisco IOS Release | Description |
|---|---|
Cisco IOS Release 12.1(3)T | The T train is the Cisco Technology release train. |
Cisco IOS 12.(3a)EC | The EC train is the Cisco cable-specific early deployment release train that, in most instances, introduces new feature sets. |
Cisco IOS Release 12.0(12)SC | The SC train is the Cisco cable-specific "stable" release train. This train excludes telco return, DOCSIS 1.0 extensions support, Cisco UBR7246VXR clock card feature set, and the Cisco uBR-MC16S-based hardware and software support. |
 |
Note This section documents only cable-specific commands. For non-cable-specific commands, see the command reference documentation for Cisco IOS Release 12.1, available on CCO and the Documentation CD-ROM. |
This section categorizes and summarizes key cable CMTS features that are supported on the Cisco uBR7200 series (the Cisco uBR7223, the Cisco uBR7246, and the Cisco uBR7246 VXR) universal broadband router.
Table 0-2 lists principle Cisco uBR7200 series features:
| Feature Category | Item | ||
|---|---|---|---|
Administration | Cisco Discovery Protocol (CDP) Simple Network Management Protocol (SNMP) v2 and SNMPv3 Integrated Dynamic Host Configuration Protocol (DHCP) server Trivial File Transfer Protocol (TFTP) client User Datagram Protocol (UDP) Internet Protocol (IP) v4/v5 Address Resolution Protocol (ARP) Domain Name System (DNS) | ||
Availability | Hot Standby 1+1 Redundancy to configure components and their backups in case of system failure; helps eliminate call drops in Voice over IP (VoIP) configurations | ||
Cable Interface Bundling and Subinterfaces | IP address conservation with routing capabilities over a two-way cable plant; supports sharing one IP subnet across multiple cable interfaces grouped into a cable interface bundle with support for bundle masters; can be used with generic routing encapsulation (GRE) tunnel setups and Multiprotocol Label Switching (MPLS) configurations
| ||
Caching | Web Cache Control Protocol (WCCP) and WCCP Version 2 (WCCPv2) support | ||
Clock Synchronization | Increased reliability for Voice over IP (VoIP) transmissions to synchronize VOCODEC with a clock source and data transmissions between end points | ||
Concatenation | Increased upstream throughput by handling concatenated bursts of multiple Media Access Control (MAC) frames from cable modems that support concatenation | ||
Debugging | Command-line interface (CLI) to help debug configuration and operational problems (for example, why CMs or set-top boxes (STBs) are not working properly on the CMTS:
| ||
Internal Modem Configurator File Editor | Offers built-in CM configuration file generation and storage as part of the Cisco uBR7200 series CLI | ||
Inter-Switch Link (ISL) Bridging on Noncable Interfaces | Cisco Inter-Switch Link (ISL) protocol support to maintain virtual local area network (VLAN) information | ||
Layer 3 Encapsulations | Cisco High-Level Data Link Control (HDLC) Frame Relay Point-to-Point Protocol (PPP) Multiprotocol Label Switching (MPLS) | ||
Multicast Services | Internet Group Management Protocol (IGMP) Protocol Independent Multicast (PIM) —PIM dense mode Distance Vector Multicast Routing (DVMRP) | ||
Packet Filtering Options | Ability to filter packets based on the combination of IP address, upper-layer protocol (for example, UDP, TCP, ICMP) and upper-layer protocol's port number or Internet Control Message Protocol (ICMP) type in the IP packet Ability to configure source IP address filtering on RF subnets to prevent subscribers from using source IP addresses not valid for the IP subnet they are physically connected to Per modem filters (per CM or host access lists)—Ability to filter incoming packets from individual hosts or CMs based on the source MAC or IP address; allows lists to be specified on a per-interface and per-direction basis Cable monitor—ability to filter a selection of MAC messages, map messages, and data packets to access lists, MAC address and upstream port numbers; enable time stamping of each packet, and permit the option of stripping away the DOCSIS header for data packets; this increases the CMTS administrator's ability to manage network variables, understand network issues that can affect application performance and functionality, and helps to resolve interoperability problems | ||
Provisioning and Maintenance Options | DHCP client ID or remote ID options to limit the number of customer premises equipment (CPE) devices per CM "Command max-CPE configuration file entry override"—Allows the CMTS administrator to override a CM's DOCSIS configuration file setting that specifies the maximum number of CPE devices the CM supports DHCP CM host ID (CM & host subnet addressing) to modify the giaddr field of DHCPDISCOVER packets based on whether the source is a CM or a host to help verify addresses Upstream address verification—Verifies CM and PC addresses to ensure CM SID and MAC addresses are consistent; this helps ensure addresses are not spoofed; CMTS administrator can determine the IP and MAC address of a given CM & the SID number that shows the IP and MAC addresses of all devices learned in the CM's MAC table. Using customer databases, the administrator can cross-reference the spoofing CM and PC and prevent use Enhanced source address verification—Verifies that each upstream data packet from a CM comes from the source IP address in the packet known to be associated with the CM Dynamic mobile hosts—Allows the CMTS administrator to bring up a PC behind one CM, then move it to another CM; software maintains host information in tables; supports "pinging" the host using the old service identifier (SID) to verify that the CM has indeed been moved Dynamic ranging support—Adds an intermediate "reset" state to the CM State List (for example, show cable modem) that identifies CMs ranging, responding, failing to respond, and being deprovisioned after the CM has failed to respond for a period of time; instead of removing the service identifier (SID) of a CM having problems, the CM is put into a reset, ranging request state for a few seconds before it is marked "offline" when it fails to register Downstream channel ID—Allows the CMTS administrator to assign unique downstream channel IDs, instead of using downstream frequencies to identify CMs
| ||
Provisioning and Maintenance Options (continued)
| Downstream frequency override—Allows the CMTS administrator to change the downstream frequency assigned to a CM, overriding the frequency set in the CM DOCSIS configuration file Configurable registration timeouts—Allows the CMTS administrator to change the CM registration value (the T9 timer) or reset to the default value CM power enhancement adjustments—Allows the CMTS administrator to calculate the average value of power corrections for CMs, making frequent power adjustments before the CM actually adjusts CM status display enhancements—Supports polling CMs to obtain parameter and status information Enhanced per modem error counters—Displays cyclic redundancy check (CRC) and header check sum (HCS) values on a CM to identify errors | ||
Quality of Service (QoS)—DOCSIS 1.0 and | DOCSIS 1.0 service class profiles:
To store requests from CMs or STBs with "best effort" (for example, no minimum upstream rate) or guaranteed-rate service queue (for example, minimum upstream rate on the upstream channel specified) DOCSIS 1.0 extensions:
| ||
Quality of Service—Generic | Committed Access Rate (CAR) Cisco express forwarding (CEF) Weighted Random Early Detection (WRED) TAG/NetFlow Switching including type of service (ToS) support Weighted Fair Queuing (WFQ) Weighted Fair Drop (WFD) enhancements to associate a maximum bandwidth in kbps with a particular setting of IP ToS bits; can be used to ensure that basic data traffic does not exceed pre-set rate limit and thereby interfere with higher-priority traffic such as voice Common Open Policy Service (COPS) for Resource Reservation Protocol (RSVP) to support admission control, bandwidth guarantee, media-independent reservation, data classification, and data policing | ||
Rate Limiting and Shaping—DOCSIS | Limiting the data rate to and from a CM or STB, and shaping traffic per DOCSIS such that TCP behavior is not adversely impacted by downstream and upstream rate limiting or shaping; MAC scheduler supports traffic shaping of upstream traffic to ensure a that single CM or STB does not consume all of the channel bandwidth and allow the CMTS administrator to configure different maximum data rates for different subscribers; traffic shaping feature delays the scheduling of upstream packets, which allows the TCP/IP stack to pace application traffic appropriately and approach throughput commensurate with the subscriber's defined QoS levels. The downstream packets rate shaping is done by the DOCSIS driver in the Cisco IOS software. | ||
Routing Protocols | Border Gateway Protocol (BGP) Intermediate System-to-Intermediate System (IS-IS) Open Shortest Path First (OSPF) Interior Gateway Routing Protocol (IGRP) Enhanced Interior Gateway Routing Protocol (EIGRP) Routing Information Protocol (RIP) | ||
Security Features—DOCSIS | 56-bit and 40-bit baseline privacy interface (BPI) Data Encryption Standard (DES) | ||
Security Features—Generic | Standard and extended access lists Authentication, Authorization, and Accounting (AAA) Radius authentication Terminal Access Controller Access Control System Plus (TACACS+) Cisco IOS firewall enhancements Hypertext Transfer Protocol (HTTP) security | ||
Service Assurance Agent | Application-aware agent that monitors network performance by measuring key service level agreement (SLA) metrics such as response time, availability, jitter (interpacket delay variance), connect time, throughput, packet loss and application performance; enhanced UDP latency reporting | ||
Spectrum Management | Supports creation of a maximum of 32 cable spectrum groups, allowing:
| ||
Telco Return Support and Configurable Termination System Information (TSI) messages | Supports configuring the Cisco uBR7200 series to support a mix of two-way and telco return traffic, as well as telco-return only, for plants yet to upgrade segments of their cable plant or the entire plant; supports termination system information (TSI) messages where the CMTS administrator can configure an alternate IP address to which the cable telco-return CM can send its registration requests | ||
Wiretap Support | Offers an interception (wire tapping) mechanism such that user-to-user traffic within a single CMTS can be captured to meet requirements in countries where regulatory issues mandate a method by which law enforcement agencies can view all traffic to and from an individual subscriber |
This sections documents commands the following CMTS commands:
To activate cable Address Resolution Protocol (ARP), use the cable arp command in cable interface or subinterface configuration mode. To disable cable ARP, use the no form of this command.
Syntax for the interface configuration mode:
cable arpSyntax for the subinterface configuration mode:
interface cable arp slot/port.n cable arp
Syntax Description
slot/port.n The slot and port specify the slot and port numbers. The n argument specifies the subinterface number. Valid values for n are 1 to 2990.
Defaults
ARP enabled
Command Modes
Cable interface configuration
Command History
12.1T This command was introduced. 12.0(6)SC This command was supported. 12.1(2) EC1 This command was supported. 12.1(3a)EC The subinterface support was added.
Release
Modification
Usage Guidelines
ARP is an Internet protocol used to map IP addresses to MAC addresses on computers and other equipment installed in a network. You must activate ARP requests so that the Cisco uBR7200 series can perform IP address resolution on the downstream path.
Examples
The following example shows how to activate cable ARP requests for port 0 on the cable modem card installed in slot 6 of the Cisco uBR7200 series:
router(config-if)# int cable 6/0 cable arp
The following example shows how to activate cable ARP requests for port 0 on the cable modem card installed in slot 6, subinterface 1, of the Cisco uBR7200 series:
router(config-subif)# int cable 6/0.1 cable arp
Related Commands
cable proxy-arp Activates cable proxy ARP on the cable interface.
Command
Description
To configure a cable interface to belong to an interface bundle, use the cable bundle interface configuration command. To delete a cable interface bundle definition, use the no form of this command.
cable bundle n [master]
Syntax Description
n Specifies the bundle identifier. Valid range is from 1 to 255. master (Optional) Defines the specified interface as the master.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
12.1(1a)T1 This command was introduced. 12.0(8) SC This command was supported. 12.1(2) EC1 This command was supported.
Release
Modification
Usage Guidelines
You can configure a maximum of four interface bundles. In each bundle, specify one interface as the master interface by using the optional master keyword. The cable interface that is designated as master is configured with layer 3 configuration such as primary and secondary IP addresses and other layer 3 specific configuration commands such as cable arp.
Configure an IP address only on the master interface. Any attempt to add an interface to a bundle is rejected, if an IP address is configured and the interface is not specified as master interface.
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.
If you attempt to add an interface to a bundle as slave interface and an IP address is assigned to this interface, the command fails. You must remove the IP address configuration before you can add the interface to a bundle.
If you have configured an IP address on a bundled interface and the interface is not the master interface, a warning message appears.
Specify generic (that is, not downstream or upstream) cable interface configurations, such as source-verify or Address Resolution Protocol (ARP) handling, on the master interface. Do not specify generic configuration on non-master interfaces.
If you configure an interface as part of a bundle and it is not the master interface, all generic cable configuration for this interface is removed. The master interface configuration then apply to all interfaces in the bundle.
The slave interfaces in cable bundle are not assigned any IP addresses or any other layer 3 configurations.
When creating subinterfaces over bundle master, the bundle master is not assigned any IP address and only the subinterfaces are assigned IP addresses, helper address, and other layer 3 configurations. The reason bundle master is not assigned any IP address is because cable modems are associated with subinterfaces rather than bundle master.
|
Note Cable interface bundling is applicable only in two-way cable configurations. It is not supported in telco-return configurations. |
If you shut down or remove the master interface in a bundle, no data packets is sent to any of the interfaces in this bundle. Packets are still physically received from non-master interfaces which have not been shut down, but those packets are discarded. This means that modems connected to those interfaces are not disconnected immediately, but modems coming online are not able to obtain an IP address, download their configuration file, or renew their IP address assignment if the DHCP lease expires.
If you shut down a slave interface, only this shut down interface is affected.
Examples
See the following example to configure interface 25 to be the master interface:
Router(config-if)# cable bundle 25 master Router(config-if)# 07:28:17: %UBR7200-5-UPDOWN: Interface Cable3/0 Port U0, changed state to down 07:28:18: %UBR7200-5-UPDOWN: Interface Cable3/0 Port U0, changed state to up
The following example shows the error message you get if you try to configure an interface with an IP address that is not the master interface:
Router(config-if)# cable bundle 5 Please remove ip address config first then reenter this command
Related Commands
show cable bundle Displays the forwarding table for the specified interface bundle.
Command
Description
To reset the counters that are displayed with the show controllers clock-reference command, use the cable clock clear-counters privileged EXEC command.
cable clock clear-countersSyntax Description
This command has no keywords or arguments.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1(1a)T1 This command was introduced. 12.1(2)EC1 This command was supported on the EC train.
Release
Modification
Usage Guidelines
This command resets any counters that were displayed from the last time the show controllers clock-reference command was used.
|
Note This command is not applicable on the SC train. |
|
Note To support the clock feature set in Voice over IP (VoIP) configurations, a Cisco uBR7246VXR chassis, equipped with a clock card; and a Cisco uBR-MC16S, a Cisco uBR-MC16E, or a Cisco uBR-MC28C cable modem card must be used running 12.1(1a)T1 or higher releases. Only these cable modem cards support the external clock card reference from a clock card to distribute that signal to cable modems (CMs) or set-top boxes (STBs) attached to the specific network segments. Each CM or STB must also support VoIP applications and the clock feature set. The Cisco uBR924, running 12.0(7)T or later releases, supports clock card feature automatically. |
Examples
The following example shows how to reset all counters that are displayed for the clock card:
router# cable clock clear-counters
Related Commands
Displays the cable clock card's hardware information.
Command
Description
To select the external timing source when the clock card is in holdover mode, use the cable clock force global configuration command. To disable the selection and return to the default, use the no form of this command.
cable clock force {primary | secondary}
Syntax Description
primary Forces the primary source to act as the clock reference. secondary Forces the secondary source to act as the clock reference.
Defaults
The clock card automatically uses the primary external source, if available. If the primary source fails, the clock card enters holdover mode, and after a few seconds, switches to the secondary external source. The clock card switches back to the primary source when it becomes available.
Command Modes
Global configuration
Command History
12.1(1a)T1 This command was introduced. 12.1(2)EC1 This command was supported on the EC train.
Release
Modification
Usage Guidelines
This command overrides the default behavior of the clock card when the clock card is in holdover mode. If the clock card is not in holdover mode, this command is ignored. You cannot force the reference to a port if the clock card is in free-running mode.
|
Note This command is not applicable on the SC train. |
|
Note The clock card enters holdover mode if the forced reference is lost, even if the other external reference is available. |
|
Note To support the clock feature set in Voice over IP (VoIP) configurations, a Cisco uBR7246VXR chassis, equipped with a clock card; and a Cisco uBR-MC16S, a Cisco uBR-MC16E, or a Cisco uBR-MC28C cable modem card must be used running 12.1(1a)T1 or later releases. Only these cable modem cards support the external clock card reference from a clock card to distribute that signal to cable modems (CMs) or set-top boxes (STBs) attached to the specific network segments. Each CM or STB must also support VoIP applications and the clock feature set. The Cisco uBR924, running 12.0(7)T or later releases, supports clock card feature automatically. |
Examples
The following example shows how to force the timing reference for the cable clock card to come from the secondary external source, when the clock card is in holdover mode:
router(config)# cable clock force secondary
Related Commands
Displays status information for the cable clock card. Displays hardware information, register values, and current counters for the cable clock card.
Command
Description
To make the midplane time-division multiplexing (TDM) clock the primary timing reference for the clock card, use the cable clock source-midplane global configuration command. To disable the selection and return to the default, use the no form of this command.
cable clock source-midplaneSyntax Description
This command has no keywords or arguments.
Defaults
The clock card does not get its timing reference from the midplane TDM clock.
Command Modes
Global configuration
Command History
12.1(1a)T1 This command was introduced. 12.1(2)EC1 This command was supported on the EC train.
Release
Modification
Usage Guidelines
Because the clock card automatically provides the timing reference to the midplane TDM clock, the midplane cannot in turn act as the reference for the clock card. This means that the cable clock source-midplane command does not take effect unless a port adapter is configured as the primary clock reference source for the midplane.
|
Note This command is not applicable on the SC train. |
|
Note To support the clock feature set in Voice over IP (VoIP) configurations, a Cisco uBR7246VXR chassis, equipped with a clock card; and a Cisco uBR-MC16S, a Cisco uBR-MC16E, or a Cisco uBR-MC28C cable modem card must be used running 12.1(1a)T1 or higher releases. Only these cable modem cards support the external clock card reference from a clock card to distribute that signal to cable modems (CMs) or set-top boxes (STBs) attached to the specific network segments. Each CM or STB must also support VoIP applications and the clock feature set. The Cisco uBR924, running 12.0(7)T or later releases, supports clock card feature automatically. |
Examples
The following example shows how to set the primary clock reference to the midplane TDM clock:
router(config)# cable clock source-midplane
Related Commands
Displays status information for the cable clock card.
Command
Description
To create a configuration filename for the Cisco uBR7200 series internal cable modem configuration file, use the cable config-file global configuration command. To remove the configuration filename, use the no form of this command.
cable config-file filename {subcommand}
Syntax Description
filename Specifies the configuration filename to edit. subcommand Use the following config-file subcommands to edit the configuration file: {access-denied | channel-id | cpe max | download | frequency | option | privacy | service-class | snmp manager | timestamp}. See the descriptions of these commands for more information.
Defaults
No default behaviors or values.
Command Modes
Global configuration mode
Command History
12.1(2)EC1 This command was introduced.
Release
Modification
Usage Guidelines
Cisco offers a number of provisioning tools to help automate the creation of DOCSIS cable modem (CM) configuration files. The CMTS administrator defines and pushes DHCP and DOCSIS configuration files to appropriate servers such that each CM or set top box (STB), when initialized, can transmit a DHCP request, receive its IP address, obtain its TFTP and time-of-day (ToD) server address, and download its DOCSIS configuration file. In the 12.1(2)EC1 and later releases, CMTS administrators can use the uBR7200 series embedded CM configuration file editor to create and store CM files as part of the uBR7200 series universal broadband router. CM configuration files are stored in the uBR7200 series flash memory.
If a configuration file does not exist, create it first. Use the following cable config-file subcommands in the configuration file interface mode to edit the configuration file:
In addition to the above cable config-file specific commands, the following commands are necessary to successfully configure and use the internal cable modem configuration files.
The following is a sample configuration for the configuration file:
service udp-small-servers max-servers no-limit ! cable time-server ! cable config-file test.cm
cpe max 4 service-class 1 priority 2 service-class 1 max-upstream 128 service-class 1 max-downstream 1000 timestamp ! ip dhcp pool modems-c3 network 10.30.128.0 255.255.240.0 bootfile test.cm next-server 10.30.128.1 default-router 10.30.128.1 option 7 ip 10.30.128.1 option 4 ip 10.30.128.1 option 2 hex 0000.0000 ! interface Cable3/0 ip address 10.30.128.1 255.255.240.0 no ip directed-broadcast ip pim dense-mode load-interval 30 no keepalive cable shared-secret 0 This is a shared Secret cable downstream annex B cable downstream modulation 64qam cable downstream interleave-depth 32 cable upstream 0 frequency 20208000 cable upstream 0 power-level 0 cable upstream 0 power-adjust continue 5 no cable upstream 0 shutdown cable dhcp-giaddr policy !
Examples
The following example shows how to create a cable modem configuration file:
router(config)# cable config-file test.cm
Related Commands
access-denied Disables access to network. channel-id Specifies upstream channel ID. cpe max Specifies customer premises equipment (CPE) information. download Specifies download information for the configuration file. frequency Specifies downstream frequency. option 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.
Command
Description
To disable network access to the CPE devices that are attached to the cable modem, use the access-denied cable config-file interface configuration command. To enable access, use the no form of this command.
access-deniedSyntax Description
This command has no arguments or keywords.
Defaults
Access to the cable network is permitted (no access-denied).
|
Note The default setting is required for normal operations. |
Command Modes
Cable config-file interface configuration mode
Command History
12.1(2)EC1 This command was introduced.
Release
Modification
Examples
The following example shows how to disable network access for all the customer premises equipment (CPE) devices that are connected to the cable modem:
router(config)# cable config-file test.cm
router(config-file)# access-denied
Related Commands
channel-id Specifies upstream channel ID. cpe max Specifies CPE information. download Specifies download information for the configuration file. frequency Specifies downstream frequency. option Provides config-file options. privacy Specifies privacy options for baseline privacy images. service-class Specifies service class definitions for the configuration file. timestamp Enables time-stamp generation. snmp manager Specifies Simple Network Management Protocol (SNMP) options. timestamp Enables timestamp generation.
Command
Description
To specify the upstream channel ID for a cable modem's configuration file, use the channel-id cable config-file interface configuration command. To remove the channel ID specification, use the no form of this command.
channel-id upstreamchan-id
Syntax Description
upstreamchan-id Specifies the upstream channel ID. Valid range is 0 to 255. Upstream channel IDs on an MC16x card are 0 to 5.
Defaults
If no upstream channel ID is specified, the cable modem contains its upstream channel from the Upstream Channel Description (UCD) messages it receives on the downstream channel.
Command Modes
Cable config-file interface configuration mode
Command History
12.1(2)EC1 This command was introduced.
Release
Modification
Usage Guidelines
Specifying an upstream channel ID in the configuration file forces a modem offline unless the channel ID in the configuration file belongs to the connected upstream port. If using a telco-return cable modem, the upstream channel must be 0.
Examples
The following example shows how to set the upstream channel ID for the configuration file to 3. If the cable modem cannot obtain this upstream channel, it will not come online.
router(config)# cable config-file test.cm
router(config-file)# channel-id 3
Related Commands
access-denied Disables access to network. cpe max Specifies CPE information. download Specifies download information for the configuration file. frequency Specifies downstream frequency. option 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.
Command
Description
To specify the maximum number of customer premises equipment (CPE) devices that can use the cable modem to connect to the cable network, use the cpe max cable config-file interface configuration command. To remove the CPE specification, use the no form of this command.
cpe max cpe-num
Syntax Description
cpe-num Specifies the number of CPEs. Valid range is 1 to 254.
Defaults
1
Command Modes
Cable config-file interface configuration mode
Command History
12.1(2)EC1 This command was introduced.
Release
Modification
Usage Guidelines
The cable modem enforces the cpe max limitation, but the Cable Modem Termination System (CMTS) might enforce its own lower number of CPE devices. On the Cisco uBR7200 series universal broadband router, a 0 cpe-num value enables unlimited number of hosts, which, on some modems, provide 0 hosts.
Examples
The following example shows how to set the maximum CPE value for the configuration file:
router(config)# cable config-file test.cm
router(config-file)# cpe max 5
Related Commands
access-denied Disables access to network. channel-id Specifies upstream channel ID. download Specifies download information for the configuration file. frequency Specifies downstream frequency. option 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.
Command
Description
To enable the cable modem to download a new software image, use the download cable config-file interface configuration command. To disable the specification, use the no form of this command.
download {image filename [oui oui-list] | server ip-address}
Syntax Description
image filename Specifies to download an image file. oui oui-list Specifies the list of OUIs. Maximum value is 8. OUI is the first 6 octets of the cable modem MAC address. server ip-address Specifies the TFTP server IP address. If no IP address is specified, the cable modem defaults to using the same TFTP server that provided the configuration file.
Defaults
The cable modem does not download a new software image.
Command Modes
Cable config-file interface configuration mode
Command History
12.1(2)EC1 This command was introduced.
Release
Modification
Usage Guidelines
If the oui-list parameter is specified, the download image filename is provided only to the modems that contain the OUIs. For each configuration file, multiple download images can be specified. Because each filename can only be listed once, entering a different list of OUIs for a single filename clears the old list. To support more than 8 OUIs with the same file, use a different download software image name, and create a duplicate file or alias on the TFTP server.
The download server address is included in the configuration file only if a download image filename is provided.
Examples
The following command shows how to download an image:
router(config)# cable config-file upgrade.cm router(config-file)# download image ubr920-k1v4y556i-mz.121-3a.T1 oui 00.50.73 00.D0.BA 00.D0.58 00.01.96
Related Commands
access-denied Disables access to network. channel-id Specifies upstream channel ID. cpe max Specifies CPE information. frequency Specifies downstream frequency. option 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.
Command
Description
To specify the center frequency for downstream channel for the configuration file of a cable modem, use the frequency cable config-file interface configuration command. To disable this function, use the no form of this command.
frequency freq
Syntax Description
freq Specifies the downstream frequency in multiples of 62500 Hz. Valid range is 88 to 860 MHz.
Defaults
The cable modem defaults to scanning the downstream for available downstream frequencies.
Command Modes
Cable config-file interface configuration mode
Command History
12.1(2)EC1 This command was introduced.
Release
Modification
Usage Guidelines
The frequency listed in the configuration file must match the output frequency of the upconverter; otherwise, the cable modem cycles offline each time the configuration file is received. Including the downstream frequency in the configuration file improves network stability. Should a cable modem ever lose downstream lock, the modem retries only the specified frequency instead of searching all possible downstream frequencies.
Should a downstream frequency plan reallocation be necessary (for example, if the DOCSIS carrier moves or is migrated to a new frequency), providing the same DOCSIS downstream carrier on the output of two upconverters simultaneously (using a splitter at IF), and including the new frequency in the configuration file assures that all DOCSIS modems are able to quickly locate the new frequency settings.
Examples
The following example shows how to specify the downstream center frequency for the cable modem:
router(config)# cable config-file upgrade.cm router(config-file)# frequency 453000000
Related Commands
access-denied Disables access to network. channel-id Specifies upstream channel ID. cpe max Specifies CPE information. download Specifies download information for the configuration file. option 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.
Command
Description
To specify vendor-specific information fields for the configuration file of a cable modem, use the option cable config-file interface configuration command. To remove the entry for this option, use the no form of this command.
option n [instance inst-num] {ascii string | hex hexstring | ip-address}
Syntax Description
n Specifies the configuration file option code. Valid range is 5 to 254. instance inst-num Specifies the option instance.Valid range for inst-num is 0 to 255. ascii string Specifies the data is a network verification tool (NVT) ASCII string. hex hexstring Specifies data in hexdecimal string. ip-address Specifies IP address specification field.
Defaults
No default behaviors or values.
Command Modes
Cable config-file interface configuration mode
Command History
12.1(2)EC1 This command was introduced.
Release
Modification
Usage Guidelines
The most common use of this option is to specify vendor-specific information field values. In this case, the value for n must be 43. The value for inst-num is defined by the cable modem vendor.
Examples
The following example shows how to configure the Cisco uBR924 so that in downloads a Cisco UOS configuration file named "ubr924.cfg":
router(config)# cable config-file router(config-file)# option 43 instance 128 ascii ubr924.cfg
Related Commands
access-denied Disables access to network. channel-id Specifies upstream channel ID. cpe max Specifies CPE information. download Specifies download information for the configuration file. frequency Specifies downstream frequency. service-class Specifies service class definitions for the configuration file. snmp manager Specifies Simple Network Management Protocol (SNMP) options. timestamp Enables time-stamp generation.
Command
Description
To enable the DOCSIS 1.0 Baseline Privacy Interface (BPI) option for the cable modem configuration file, use the privacy cable config-file interface configuration command. To disable the BPI for the cable modem, use the no form of this command.
privacy [grace-time [authorize | tek] | timeout [authorize | operate | reauthorize | reject| rekey]]
Syntax Description
grace-time BPI grace times. authorize Authorization grace time in seconds. Valid values are 1 to 1800 seconds. Default value is 600 seconds. tek TEK grace time in seconds. Valid range is 1 to 1800 seconds. Default is 600 seconds. timeout Baseline privacy timeout times. authorize Authorize wait timeout in seconds. Valid range is 1 to 30 seconds. Default value is 10 seconds. operate Operational Wait timeout in seconds. Valid range is 1 to 10 seconds. Default is 1 second. reauthorize Re-authorize wait timeout in seconds. Valid range is 1 to 20 seconds. reject Authorize reject wait timeout in seconds. Valid range is 1 to 600 seconds. Default is 60 seconds. rekey Rekey wait timeout in seconds. Valid range is 1 to 10 seconds. Default is 1 second.
Defaults
No default behaviors or values.
Command Modes
Cable config-file interface configuration mode
Command History
12.1(2)EC1 This command was introduced.
Release
Modification
Usage Guidelines
Specifying the privacy command without any of the keywords and arguments enables the baseline privacy interface (BPI) configuration setting. The privacy options are supported only in BPI images.
Examples
The following example shows how to set the cable modem privacy KEK gracetime to 1200 seconds:
router(config)# cable config-file router(config-file)# privacy kek grace-time 1200
Related Commands
access-denied Disables access to network. channel-id Specifies upstream channel ID. cpe max Specifies CPE information. download Specifies download information for the configuration file. frequency Specifies downstream frequency. option Provides config-file options. service-class Specifies service class definitions for the configuration file. snmp manager Specifies Simple Network Management Protocol (SNMP) options. timestamp Enables time-stamp generation.
Command
Description
To specify the service-class options for the cable modem configuration file, use the service-class cable config-file interface configuration command. To disable the specification, use the no form of this command.
service-class class {guaranteed-upstream us-bandwidth max-burst burst-size max-downstream max-dsbandwidth max-upstream max-usbandwidth priority priority-num privacy}
Syntax Description
class Specifies service class number. Valid range is 1 to 16. Default value is 1. guaranteed-upstream us-bandwidth Specifies the guaranteed upstream bandwidth in kbps. Valid range for us-bandwidth is 0 to 100000 kbps. Default value is 0. max-burst burst-size Specifies the maximum upstream burst size in bytes. Valid range for burst-size is 0 to 65535. Default value is 0, unlimited burst length. Recommended value range is 1600 to 1800 bytes. Using a value of 0 or greater than 1800 bytes can cause latency issues for Voice over IP. A value of less than 1500 bytes prevent upstream transmission of large ethernet frames for any modem or CMTS not implementing fragmentation (an optional feature in DOCSIS 1.0). max-downstream max-dsbandwidth Specifies the downstream bandwidth in kbps. Valid range for max-dsbandwidth is 0 to 100000 kbps. Default value is 0. max-upstream max-usbandwidth Specifies the upstream bandwidth in kbps. Valid range for max-usbandwidth is 0 to 100000 kbps. Default value is 0. priority priority-num Specifies the service class priority. Valid range for priority-num is 0 to 7, where 7 is the highest-priority service-class setting. privacy Enables baseline privacy interface (BPI).
Defaults
Service-class is not set by default. Cable modems cannot register on a Cisco CMTS unless one parameter in a service class is specified.
Command Modes
Cable config-file interface configuration mode
Command History
12.1(2)EC1 This command was introduced.
Release
Modification
Usage Guidelines
Default values can only be used if service-class class is specified. A single configuration file should not contain multiple service-class ID numbers. Thus, all parameters should be set using a single service-class ID. However, different configuration files can reuse the same service-class ID.
Examples
The following example shows how to specify the service-class options for the upgrade cable modem configuration file:
router(config)# cable config-file upgrade.cm router(config-file)# service-class 1 priority 0 router(config-file)# service-class 1 max-upstream 3247 router(config-file)# service-class 1 max-downstream 10000 router(config-file)# service-class 1 max-burst 1600 router(config-file)# service-class 1 privacy
Related Commands
access-denied Disables access to network. channel-id Specifies upstream channel ID. cpe max Specifies CPE information. download Specifies download information for the configuration file. frequency Specifies downstream frequency. option Provides config-file options. privacy Specifies privacy options for baseline privacy images. snmp manager Specifies Simple Network Management Protocol (SNMP) options. timestamp Enables time-stamp generation.
Command
Description
To specify the IP address for the Simple Network Management Protocol (SNMP) manager, use the snmp manager cable config-file interface configuration command. To disable this function, use the no form of this command.
snmp manager ip-address
Syntax Description
ip-address Specifies an IP address for the SNMP manager.
Defaults
SNMP manager is defined.
Command Modes
Cable config-file interface configuration mode
Command History
12.1(2)EC1 This command was introduced.
Release
Modification
Usage Guidelines
For other SNMP commands see the Cisco IOS Configuration Fundamentals Command Reference Guide.
Examples
The following example shows how to specify the IP address of the SNMP manager for the upgrade configuration file:
router(config)# cable config-file upgrade.cm router(config-file)# snmp manager 222.10.1.1
Related Commands
access-denied Disables access to network. channel-id Specifies upstream channel ID. cpe max Specifies CPE information. download Specifies download information for the configuration file. frequency Specifies downstream frequency. option Provides config-file options. privacy Specifies privacy options for baseline privacy images. service-class Specifies service class definitions for the configuration file. timestamp Enables time-stamp generation.
Command
Description
To enable time-stamp generation, use the timestamp cable config-file configuration command. To disable this function, use the no form of this command.
timestampSyntax Description
This command does not have arguments or keywords.
Defaults
No default behaviors or values.
Command Modes
Cable config-file interface configuration mode
Command History
12.1(2)EC1 This command was introduced.
Release
Modification
Examples
The following example shows how to specify timestamp generation for the configuration file:
router(config)# cable config-file upgrade.cm router(config-file)# timestamp
Related Commands
access-denied Disables access to network. channel-id Specifies upstream channel ID. cpe max Specifies CPE information. download Specifies download information for the configuration file. frequency Specifies downstream frequency. option Provides config-file options. 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.
Command
Description
To configure access list for a cable modem device or host, use the cable device command in cable global configuration mode. To disable the specification, use the no form of this command.
cable device{ip-address | mac-address} [no] access-group {access-list | access-name} |
Syntax Description
ip-address IP address for the device. mac-address MAC address for the device. access-group Enables access-group options. The no form removes access-group specifications. access-list Specifies the IP access list (standard or extended). Valid values are 1 to 199. access-name Specifies the access-list name. vrf vrf-name Specifies routing and forwarding instance that is populated with virtual private network (VPN) routes. The vrf-name argument specifies the name for the virtual route forwarding instance.
Defaults
No default behaviors or values.
Command Modes
Global configuration
Command History
12.1 Ported from earlier releases. 12.1(1a)T1 The vrf keyword was added for Multiprotocol Label Switching (MPLS) virtual private network (VPN) support.
Release
Usage Guidelines
For the virtual route forwarding (VRF) syntax of this command, only IP address option is supported.
Examples
The following example shows how to assign an access list to the MAC address of a cable device:
router(config)# cable device 0010.7b6b.77ed acc 1
Related Commands
show cable device Display the cable modem or the host behind cable modem.
Command
Description
To modify the GIADDR field of DHCPDISCOVER and DHCPREQUEST packets with a Relay IP address before they are forwarded to the DHCP server, use the cable dhcp-giaddr command in cable interface or subinterface configuration mode. To set the GIADDR field to its default, use the no form of this command.
Syntax for the cable interface configuration mode:
cable dhcp-giaddr [policy | primary]Syntax for the cable subinterface configuration mode:
interface cable slot/port.n cable dhcp-giaddr [policy | primary]
Syntax Description
policy (Optional) Selects the control policy, so the primary address is used for cable modems and the secondary addresses are used for hosts. primary (Optional) Always selects the primary address to be used for giaddr. Primarily used for the MC16E card, for support of EuroDOCSIS. slot/port.n The slot and port specify the slot and port numbers. The n argument specifies the subinterface number. Valid values for n are 1 to 2990.
Defaults
No default behaviors or values.
Command Modes
Cable interface and subinterface configuration
Command History
12.0(4)T This command was introduced. 12.0 (6) SC This command was supported. 12.1(2) EC1 This command was supported. 12.1(3a)EC The subinterface support was added.
Release
Modification
Usage Guidelines
You can use the command to modify the GIADDR field of DHCPDISCOVER and DHCPREQUEST packets to provide a relay IP address before packets are forwarded to the DHCP servers. Use this command to set a policy option such that primary addresses are used for cable modems (CMs) and secondary addresses are used for hosts (such as PCs) behind the CMs.
Examples
The following example shows how to set the primary address to be used always for GIADDR.
router(config-if)# cable 6/0 router(config-if)# cable dhcp-giaddr primary
The following example shows how to set the primary address to be used always for giaddr in the cable subinterface mode.
router(config-subif)# cable 6/0.1 cable dhcp-giaddr primary
Related Commands
Specifies a destination IP address for User Datagram Protocol (UDP) broadcast (DHCP) packets. Enables the system to insert the cable modem MAC address into a DHCP packet received from a cable modem or host and forward the packet to a DHCP server. Turns on cable modem upstream verification. Enforces the telco-return cable modem to use a specific Dynamic Host Configuration Protocol (DHCP) server. Identifies the IP address of the Dynamic Host Configuration Protocol (DHCP) server that the telco-return cable modem must access. Enables the system to insert the cable modem MAC address into a DHCP packet received from a cable modem or host and forward the packet to a DHCP server. Monitors client retransmissions when address pool depletion occurs.
Command
Description
To set the Motion Picture Experts Group (MPEG) framing format for a downstream port on a cable modem card to either Annex A (Europe) or Annex B (North America), use the cable downstream annex command in cable interface configuration mode.
cable downstream annex {A | B}
Syntax Description
A Annex A. The downstream uses the EuroDOCSIS J.112 standard. B Annex B. The DOCSIS-compliant cable plants that support North American channel plans use ITU J.83 Annex B downstream radio frequency.
Defaults
Annex B, if using all Cisco uBR cable modem cards other than the uBR-MC16E. Annex A, if using the MC1E cable modem card.
Command Modes
Cable interface configuration
Command History
12.1(1a)T1 This command was introduced. 12.0(7)T, 12.1(1a)T1, 12.1 mainline, 12.0(8)SC, 12.1(2)EC1 Introduced support for Annex A.
Release
Modification
Usage Guidelines
The MPEG framing format must be compatible with the downstream symbol rate you set. Annex B is the North America (DOCSIS) standard and Annex A is the European (EuroDOCSIS) standard. You should review your local standards and specifications for downstream MPEG framing to determine which format you should use.
|
Note This command can be used to change the symbol rate, alpha, and other parameters for compliance with EuroDOCSIS (annex A), or DOCSIS (annex B). Annex A is not supported on the MC1xC, MC16B, and MC16S cards. Annex B is not supported on the MC6E card. |
|
Note The cable modem card downstream ports and the cable modems on the HFC network connected through these ports must be set to the same MPEG framing format. |
 |
Caution In Cisco IOS Release 12.1, only Annex B MPEG framing format is supported. |
Examples
The following example shows how to set the MPEG framing format to Annex A:
router(config-if)# cable downstream annex A
The following example shows how to set the MPEG framing format to Annex B:
router(config-if)# cable downstream annex B
Related Commands
show controllers cable Displays the downstream MPEG framing format (Annex A or Annex B) setting.
Command
Description
To configure the downstream channel ID, use the cable downstream channel-id command in cable interface configuration mode. To set the downstream channel ID to its default value, use the no form of this command.
cable downstream channel-id id
Syntax Description
id Specifies a downstream channel ID. Valid values are from 1 to 254.
Defaults
The unit number of the downstream device.
Command Modes
Cable interface configuration
Command History
12.0(5)T This command was introduced.
Release
Modification
Usage Guidelines
Use this command to make sure that each downstream channel has a unique ID when there are multiple Cisco uBR7200 series routers acting as CMTSes 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. By assigning default values in this manner, a single CMTS guarantees unique channel IDs. However, this scheme does not guarantee unique channel IDs when more than one CMTS exists on a network.
|
Caution Changing the downstream channel ID of an active channel will force all connected modems to disconnect. |
Examples
The following example shows how to configure the downstream channel on the cable modem card in slot 6 of a Cisco uBR7200 series router with a channel ID of 44:
router(config-if)# cable downstream channel-id 44
The following example shows how to restore the downstream channel ID configuration to the default configuration:
router(config-if)# cable downstream channel-id
To note the downstream center frequency for the cable modem card to reflect the digital carrier frequency of the downstream radio frequency carrier (the channel) for that downstream port, use the cable downstream frequency command in cable interface configuration mode.
cable downstream frequency down-freq-hz
Syntax Description
down-freq-hz The known center frequency of the downstream carrier in Hz. The Cisco IOS supports a superset of the DOCSIS standard, which is limited to 88 to 860 MHz (88,000,000 to 860,000,000 Hz). The range of center frequency that is acceptable to a cable modem is 91,000,000 to 857,000,000 Hz.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced to support NTSC/DOCSIS Annex B RF operation. 12.0(7)XR2, 12.0(8)SC Modified to support PAL/SECAM EuroDOCSIS RF operation. 12.1(2)EC1 Supports both Annex A and B.
Release
Modification
Usage Guidelines
The downstream frequency of your RF output must be set to match the expected input frequency of your upconverter. To do this, you enter the fixed center frequency of the downstream channel for the downstream port. (You can also select a default which does not set a specific fixed value.) The valid range for a fixed center frequency is 54,000,000 to 1,020,000,000 Hz. The center frequency is also used to configure an IF-to-RF upconverter that must be installed in your downstream path.
The digital carrier frequency is specified to be the center of a 6.0 MHz channel. For example, EIA channel 95 spans 90.000 to 96.000 MHz. The center frequency is 93.000 MHz, which is the digital carrier frequency that should be configured as the downstream frequency. The typical range for current CATV headends is 88,000,000 to 860,000,000 Hz.
|
Note This command currently has no effect on external upconverters; it is informational only. |
Examples
The following example shows how to set the downstream center frequency display value:
router(config-if)# cable downstream frequency 96000000
To activate a downstream port on a cable modem card for digital data transmissions over the HFC network, use the cable downstream if-output command in cable interface configuration mode. To disable the intermediate frequency (IF) carrier, use the no form of this command.
cable downstream if-outputSyntax Description
This command has no arguments or keywords.
Defaults
Downstream carrier enabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced. 12.0(7)XR2, 12.(0)SC,12.1(2)EC1 This command was modified to support Annex A.
Release
Modification
Usage Guidelines
|
Note Disabling the IF output will mute the IF output signal of the Cisco uBR700 series, and typically the upconverter is set into alarm status. All modems become disconnected from the network. |
Examples
The following example show how to enable the downstream port 0 on the cable modem card installed in slot 6 of a Cisco uBR7200 series:
router(config-if)# cable 6/0 cable downstream if-output
To set the downstream interleave depth, use the cable downstream interleave-depth command in cable interface configuration mode. To restore the default setting, use the no form of this command.
cable downstream interleave-depth {8 | 16 | 32 | 64 | 128}
Syntax Description
8 | 16 | 32 | 64 | 128 Indicates the downstream interleave depth in microseconds.
Defaults
32
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced. 12.0(7)XR2, 12.(0)SC,12.1(2)EC1 This command was modified to support Annex A.
Release
Modification
Usage Guidelines
This command sets the minimum latency of the system. A higher interleave depth provides more protection from bursts of noise on the HFC network; however, higher depth also increases downstream latency which might slow TCP/IP throughput for some configurations. Low interleave depth values typically cause some packet loss on typical HFC networks because burst noise lasts beyond the error correction block (FEC) correctable length.Table 3 shows interleave characteristics and their relation to each other.
I (Number of Taps) | J (Increment) | Burst Protection 64 QAM/256 QAM | Latency 64 QAM/256 QAM |
|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Note Changing the interleave depth disconnects all connected cable modems. |
Examples
The following example shows how to configure the downstream interleave depth to 128 microseconds:
router(config-if)# cable downstream interleave-depth 128
To set the modulation format for a downstream port on a cable modem card, use the cable downstream modulation command in cable interface configuration mode.
cable downstream modulation {64qam | 256qam}
Syntax Description
64qam Modulation rate is 6 bits per downstream symbol. 256qam Modulation rate is 8 bits per downstream symbol.
Defaults
64qam
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
Downstream modulation defines the speed in bits per second at which data travels downstream to the subscriber's cable modem. A symbol is the basic unit of modulation. QPSK encodes 2 bits per symbol, 16-QAM encodes 4 bits per symbol, 64-QAM encodes 6 bits per symbol, and 256-QAM encodes 8 bits per symbol.
|
Note Setting a downstream modulation format of 256-QAM requires approximately a 6 dB higher signal-to-noise ratio (SNR) than 64-QAM at the subscriber's cable modem. If your network is marginal or unreliable at 256-QAM, use the 64-QAM format instead. |
|
Note Changing the modulation format disconnects all connected cable modems. |
Examples
The following example shows how to set the downstream modulation to 256-QAM:
router(config-if)# cable downstream modulation 256qam
To enable DOCSIS rate limiting on downstream traffic, use the cable downstream rate-limit command in cable interface configuration mode. To disable DOCSIS rate limiting on downstream traffic, use the no form of this command.
cable downstream rate-limit [token-bucket [[shaping [granularity msec | max-delay msec]] | weighted-discard] [exp-weight]
Syntax Description
token-bucket (Optional) Specifies the token bucket filter algorithm. shaping (Optional) Enables rate limiting on the downstream port using the token bucket policing algorithm with default traffic shaping parameters. granularity msec (Optional) Specifies traffic shaping granularity in milliseconds. Valid values are 1, 2, 4, 8, or 16 milliseconds. max-delay msec (Optional) Specifies the maximum traffic shaping buffering delay in milliseconds. Valid values are 128, 256, 512, or 1028 milliseconds. weighted-discard (Optional) Specifies the weighted discard algorithm. exp-weight (Optional) Specifies the weight for the exponential moving average of loss rate. Valid values are from 1 to 4.
Defaults
token-bucket
Command Modes
Cable interface configuration
Command History
11.3(6) NA This command was introduced. 12.0(4)XI The shaping keyword was added. 12.0(5)T1, 12.1(1)EC1 Support for shaping was added.
Release
Modification
Usage Guidelines
When you enter this command without an option, the token-bucket algorithm is used.
Examples
The following example shows how to apply the token bucket filter algorithm:
router(config-if)# cable 6/0 cable downstream rate-limit token-bucket
Related Commands
cable upstream rate-limit Sets DOCSIS rate limiting for an upstream port on a cable modem card.
Command
Description
To specify the number of days to keep a cable modem in the flap-list table before aging it out of the table, use the cable flap-list aging command in global configuration mode. To disable this feature, use the no form of this command.
cable flap-list aging number-of-days
Syntax Description
number-of-days Specifies how many days of cable modem performance is retained in the flap list. Valid values are from 1 to 60 days.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
12.1 T This command was introduced.
Release
Modification
Usage Guidelines
Flapping refers to the rapid disconnecting and reconnecting of a cable modem that is having problems holding its connection to the CMTS. A flap list is a table maintained by the Cisco uBR7200 series 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. You can configure the size and entry thresholds for the flap list.
Examples
The following example shows how to specify that the flap-list table retain two days of performance for this cable modem:
router(config)# cable flap-list aging 2
Related Commands
cable flap-list miss-threshold Specifies miss threshold for recording a flap-list event. cable flap-list insertion-time Sets the insertion time interval that determines whether a cable modem is placed in the flap list. cable flap-list power-adjust threshold Specifies the power-adjust threshold for recording a cable modem flap-list event. cable flap-list size Specifies the maximum number of cable modems reported in the flap-list table. clear cable flap-list Resets the Cisco uBR7200 series flap-list table.
Command
Description
To set the cable flap-list insertion time interval, use the cable flap-list insertion-time command in global configuration mode. To disable insertion time, use the no form of this command.
cable flap-list insertion-time seconds
Syntax Description
seconds Insertion time interval in seconds. Valid values are from 60 to 86,400 seconds.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
12.1 T This command was introduced.
Release
Modification
Usage Guidelines
This command controls the operation of a flapping modem detector. When a cable modem makes insertion requests more frequently than the period of time defined by this command, the cable modem is placed in the flap list. A modem will not "flap" more than once in each insertion time interval.
Examples
The following example shows how to set the insertion time interval to 62 seconds:
router(config)# cable flap-list insertion-time 62
Related Commands
cable flap-list aging Specifies the number of days a cable modem remains in the flap-list table before being aged out of the table. cable flap-list miss-threshold Specifies the miss threshold for recording a flap-list event. Specifies the power-adjust threshold for recording a cable modem flap-list event. Specifies the maximum number of cable modems reported in the flap-list table. clear cable flap-list Resets the Cisco uBR7200 series flap-list table.
Command
Description
To set the miss threshold for recording a flap-list event, use the cable flap-list miss-threshold command in global configuration mode. To disable this function, use the no form of this command.
cable flap-list miss-threshold misses
Syntax Description
misses Specifies the number of MAC-layer keepalive misses that results in the cable modems being placed in the flap list. Valid values are 1 to 12.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
12.1 T This command was introduced.
Release
Modification
Usage Guidelines
A miss is the number of times a cable modem does not acknowledge a MAC-layer keepalive message from a cable modem card.
|
Note A high miss rate can indicate 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
Related Commands
cable flap-list aging Specifies the number of days a cable modem remains in the flap-list table before being aged out of the table. Sets the insertion time interval that determines whether a cable modem is placed in the flap list. Specifies the power-adjust threshold for recording a cable modem flap-list event. Specifies the maximum number of cable modems reported in the flap-list table. clear cable flap-list Resets the Cisco uBR7200 series flap-list table.
Command
Description
To specify the power-adjust threshold for recording a flap-list event, use the cable flap-list power-adjust threshold command in global configuration mode. To disable power-adjust thresholds, use the no form of this command.
cable flap-list power-adjust threshold dB
Syntax Description
dB Specifies the minimum power adjustment, in decibels, that results in a flap-list event. Valid values are from 1 to 10 dB.
Defaults
2 dB
Command Modes
Global configuration
Command History
12.1 T This command was introduced.
Release
Modification
Usage Guidelines
This command controls the operation of a flapping modem detector. When the power adjustment of a cable modem exceeds the configured threshold value, the modem is placed in the flap list.
|
Note A power adjustment threshold of less than 2 dB might cause excessive flap list event recording. Cisco recommends setting this threshold value to 3 dB or higher. |
|
Note For underground HFC networks with 4 amplifier cascade length, a typical threshold value should be 3 dB. For overhead HFC networks with 4 amplifier cascade length, a typical threshold value should be 4 dB. Longer coax cascades without return path thermal gain control and sites with extreme daily temperatures will have larger threshold ranges. |
Examples
The following example shows the power-adjust threshold being set to 5 dB:
router(config)# cable flap-list power-adjust threshold 5
Related Commands
cable flap-list aging Specifies the number of days a cable modem remains in the flap-list table before being aged out of the table. Sets the insertion time interval that determines whether a cable modem is placed in the flap list. cable flap-list miss-threshold Specifies the miss threshold for recording a flap-list event. Specifies the maximum number of cable modems reported in the flap-list table. clear cable flap-list Resets the Cisco uBR7200 series flap-list table.
Command
Description
To specify the maximum number of cable modems that can be listed in the flap-list table, use the cable flap-list size command in global configuration mode. To specify the default flap-list table size, use the no form of this command.
cable flap-list size number
Syntax Description
number Specifies the maximum number of cable modems that will report flap performance to the flap-list table. Valid values are from 1 to 8192.
Defaults
8192
Command Modes
Global configuration
Command History
12.1 T This command was introduced.
Release
Modification
Examples
The following example shows how to limit the flap-list table size to no more than 200 modems:
router(config)# cable flap-list size 200
Related Commands
cable flap-list aging Specifies the number of days a cable modem remains in the flap-list table before being aged out of the table. Sets the insertion time interval that determines whether a cable modem is placed in the flap list. cable flap-list miss-threshold Specifies the miss threshold for recording a flap-list event. Specifies the power-adjust threshold for recording a cable modem flap-list event. clear cable flap-list Resets the Cisco uBR7200 series flap-list table.
Command
Description
To specify a destination IP address for User Datagram Protocol (UDP) broadcast Dynamic Host Configuration Protocol (DHCP) packets, use the cable helper-address command in cable interface or subinterface configuration mode. To disable this feature, use the no form of this command.
Syntax for the interface configuration mode:
cable helper-address IP-address {cable-modem | host}Syntax for the subinterface configuration mode:
interface cable slot/port.n cable helper-address IP-address {cable-modem | host}
Syntax Description
IP-address The IP address of a DHCP server to which UDP broadcast packets will be sent. cable-modem Specifies that only cable modem UDP broadcasts are forwarded. host Specifies that only host UDP broadcasts are forwarded. slot/port.n The slot and port specify the slot and port numbers. The n argument specifies the subinterface number. Valid values for n are 1 to 2990.
Defaults
No default behavior or values.
Command Modes
Cable interface and subinterface configuration modes
Command History
12.1 T This command was introduced. 12.1(3a)EC The subinterface support was added.
Release
Modification
Usage Guidelines
This commands allows the use of separate DHCP servers for hosts and modems. The cable-modem keyword specifies that only cable modem UDP broadcasts are forwarded to the destination IP address. The host keyword specifies that only host UDP broadcasts are forwarded to the destination IP address.
Examples
The following example shows how to forward UDP broadcasts from cable modems to the DHCP server at 172.23.66.44:
router(config-if)# cable helper-address 172.23.66.44 cable-modem
The following example shows how to forward UDP broadcasts from hosts to the DHCP server at 172.23.66.143:
router(config-if)# cable helper-address 172.23.66.143 host
The following example shows how to forward UDP broadcasts from hosts to the DHCP server at 172.23.66.144:
router(config-subif)# int cable 6/0.1 cable helper-address 172.23.66.144 host
Related Commands
Modifies the GIADDR field of DHCPDISCOVER and DHCPREQUEST packets with a Relay IP address before they are forwarded to the DHCP server. Enables the system to insert the cable modem MAC address into a DHCP packet received from a cable modem or host and forward the packet to a DHCP server. Turns on cable modem upstream verification. Enforces the telco-return cable modem to use a specific Dynamic Host Configuration Protocol (DHCP) server. Identifies the IP address of the Dynamic Host Configuration Protocol (DHCP) server that the telco-return cable modem must access. Enables the system to insert the cable modem MAC address into a DHCP packet received from a cable modem or host and forward the packet to a DHCP server. Monitors client retransmissions when address pool depletion occurs.
Command
Description
To configure the access list for a host, use the cable host command in cable global configuration mode. To disable the specification, use the no form of this command.
cable host {ip-address | mac-address} [no] access-group {access-list | access-name} |
Syntax Description
ip-address IP address of the host. mac-address MAC address of the host. access-group Enables access-group options. The no form removes access-group specifications. access-list Specifies the IP access list (standard or extended). Valid values are 1 to 199. access-name Specifies the access-list name. vrf vrf-name Specifies route forwarding instance that is populated with virtual private network (VPN) routes. The vrf-name argument specifies the name for the route forwarding instance.
Defaults
No default behaviors or values.
Command Modes
Global configuration
Command History
11.3 NA This command was introduced. 12.1(1a)T1 The vrf keyword was added for Multiprotocol Label Switching (MPLS) virtual private network (VPN) support.
Release
Modification
Usage Guidelines
For the virtual route forwarding (VRF) syntax of this command, only IP address option is supported.
Examples
The following example shows how to assign access list number 2 to the cable host with an IP address 1.1.1.1:
router(config)# cable host 1.1.1.1 acc 2
Related Commands
show cable host Displays the host for the cable modem. clear cable host Clears the host from the table.
Command
Description
To configure the interval between consecutive initial ranging slots on an upstream, use the cable insertion-interval interface configuration command. To configure the automatic setting and ignore any minimum or maximum time settings, use the no form of this command.
cable insertion-interval [fixed-inrvl | automatic [min-intrvl | max-intrvl]]
Syntax Description
fixed-intrvl (Optional) Fixed interval between initial ranging slots in milliseconds (ms). automatic (Optional) Causes the Cisco uBR7200 series MAC scheduler for each upstream cable modem to vary the initial ranging times available to new cable modems joining the network. min-intrvl (Optional) Minimum value in msecs between the initial ranging slots on the upstream. Valid range is 25 to 200 ms. Default is 50 ms. max-intrvl (Optional) Maximum value in msecs between the initial ranging slots on the upstream. Valid range is 500 to 2000 ms. Default is 500 ms.
Defaults
Automatic (dynamically varying the frequency of initial ranging upstream slots between 50 milliseconds to 2 seconds).
Command Modes
Cable interface configuration
Command History
11.NA This command was introduced. 12.1 T This command was modified.
Release
Modification
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 uBR7200 series. MAP messages define the precise time intervals during which modems can send.
The default insertion interval setting (automatic) configures the Cisco uBR7200 series to automatically vary (between 50 milliseconds and 2 seconds) the initial ranging times available to new cable modems that attempt to join the network.
Use the automatic keyword with this command when you have to bring a large number of modems online quickly (for example, after a major power failure). Override the automatic keyword by specifying an insertion interval.
Examples
The following example shows how to specify automatic insertion intervals:
router(config-if)# cable insertion-interval automatic
The following example shows how to specify minimum insertion interval to 100 ms:
Router(config-if)# cable insertion-interval min 100
Related Commands
Specifies automatic or fixed start and stop values for data backoff. Specifies automatic or configured initial ranging backoff calculation.
Command
Description
To allow the CMTS to forward all traffic to and from a particular cable modem to a data collector located at particular User Datagram Protocol (UDP) port, use the cable intercept command cable interface configuration command. To deactivate this function, use the no form of this command.
cable intercept[mac-address] ip-address udp-port
Syntax Description
mac-address Specifies the MAC address. ip-address Specifies the IP address. udp-port Specifies the destination UDP port number for the intercept stream. Valid range is 0 to 65535.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
12.0(5)T1 This command was introduced on the T train. 12.0(6)SC This command was introduced on the SC train. 12.1(2)EC This command was introduced on EC train.
Release
Modification
Usage Guidelines
When this command is activated, the Cisco uBR7200 series universal broadband router examines each packet for the desired MAC address; when a matching MAC address is found (for either the origination or destination endpoint), a copy of the packet is encapsulated into a UDP packet, which is then sent to the specified server at the given IP address and port.
|
Note This command can only be placed in the Cisco uBR700 series universal broadband router configuration. It requires maximum privilege to set. The system at ip-address on the udp-port must be configured to listen for and capture the necessary data stream. 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. |
This command can be used to comply with the United States Federal Communications Assistance for Law Enforcement Act (CALEA) and other law enforcement wiretap requirements for voice communications.
Examples
The following commands shows how to specify the destination IP address and UDP port number for the Cisco uBR7200 series universal broadband router:
(config-if)# cable intercept 0080.fcaa.aabb 3.12.13.8 512
To activate upstream IP broadcast echo so that the Cisco uBR7200 series can echo broadcast packets, use the cable ip-broadcast-echo command in cable interface or subinterface configuration mode. To disable the upstream IP broadcast echo, use the no form of this command.
Syntax for the interface configuration mode:
cable ip-broadcast-echoSyntax for the subinterface configuration mode:
interface cable slot/port.n cable ip-broadcast-echo
Syntax Description
slot/port.n The slot and port specify the slot and port numbers. The n argument specifies the subinterface number. Valid values for n are 1 to 2990.
Defaults
Disabled
Command Modes
Cable interface configuration and cable subinterface configuration modes
Command History
11.3 XA This command was introduced. 12.1(3a) EC The subinterface support was added.
Release
Modification
Usage Guidelines
|
Note The cable ip-broadcast-echo command is provided to permit the cable network to behave more like a standard ethernet network, and support direct peer to peer communications using IP broadcasts. This is not typically used in a service provider network. |
Examples
The following example shows how to activate IP broadcast echo:
router(config-if)# cable ip-broadcast-echo
To enable IP multicast echo so that the Cisco uBR7200 series universal broadband 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.
Syntax for the interface configuration mode:
cable ip-multicast-echoSyntax for the subinterface configuration mode:
interface cable slot/port.n cable ip-multicast-echo
Syntax Description
slot/port.n The slot and port specify the slot and port numbers. The n argument specifies the subinterface number. Valid values for n are 1 to 2990.
Defaults
Enabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced. 12.1(3a) EC The subinterface support was added.
Release
Modification
Usage Guidelines
To verify if IP multicast echo has been activated or deactivated, enter the command more system:running-config in EXEC mode and look for the cable interface configuration information. If IP multicast echo has been activated, it does not appear in this output. If IP multicast echo has been deactivated, it appears in output as no cable ip-multicast-echo. If you are having trouble, make sure that you have entered the correct slot and port numbers when you entered cable interface configuration mode.
Examples
The following example shows how to disable IP multicast echo:
router(config-if)# no cable ip-multicast-echo
To configure the dynamic map advance algorithm, use the cable map-advance command in cable interface configuration mode. Use the no form of this command to disable this function.
cable map-advance [dynamic [n]] | [static]
Syntax Description
dynamic n Enables the dynamic MAP advance algorithm that automatically tunes lookhead time in MAPs based on the current farthest cable modem on a particular upstream port. The n argument specifies safety factor for the dynamic map advance algorithm in usecs. This value controls the amount of extra lookahead time in MAPs to account for inaccuracies of the measurement system and internal software latencies. The default value is 1000 usecs. Valid range is 500 to 1500 usecs. Using larger safety factors increases the run time lookahead in MAPs, but reduces the upstream performance. static Enables the static map advance algorithm that uses a fixed lookahead time value in MAPs based on the worst-case propagation delay of 100 mile hybrid fiber coaxial (HFC) cable network.
Defaults
Dynamic map advance with a safety factor of 1000 usecs is the default setting.
Command Modes
Cable interface configuration
Command History
12.1T This command was introduced. 12.0 (9)SC, 12.1(2)EC1 dynamic MAP option added.
Release
Modification
Usage Guidelines
|
Note If you are adjusting the dynamic map advance algorithm, Cisco recommends that you do not reduce the safety factor below the default value of 1000 usecs in a production network until you are confident that the reduced safety factor is sufficient for your deployment. The default value is chosen to be a safe operating point for the algorithm. |
|
Note Dynamic map advance might need to be temporarily turned off if the first modem to be connected outside of the CMTS is close to the 100 mile limit of the DOCSIS specification. |
Examples
The following example shows how to configure the dynamic map advance to 4000 usecs:
router(config-if)# cable map-advance dynamic 4000
To specify the maximum number of hosts that can be attached to a subscriber's cable modem, use the cable max-hosts command in cable interface configuration mode. Use the no form of this command to reset the allowable number of hosts attached to a cable modem to the default value of 0 hosts.
cable max-hosts n
Syntax Description
n Specify the maximum number of hosts that can be attached to a cable modem on this interface. Valid range is from 0 to 255 hosts. Default value is 0.
Defaults
0
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced. 12.0(6)SC, 12.1(2)EC1 Supported on the Cisco SC and EC trains.
Release
Modification
Examples
The following example shows how to set the maximum hots for the cable modem to 15:
Router(config-if)#cable max-hosts 15
Related Commands
cable modem max-hosts Specifies the maximum number of hosts supported per modem.
Command
Description
To specify that IP multicast streams be encrypted, use the cable match address command in cable interface configuration mode. Use the no form of this command if you do not want to use encryption.
cable match address access-list
Syntax Description
access-list Specifies that the IP multicast streams defined by the access list be encrypted. Access lists can be IP access list numbers or an IP access list name. Valid access list numbers are from 100 to 199.
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
12.1 T This command was introduced.
Release
Modification
Usage Guidelines
Configure the access list using the ip access-list command. For information on this command, refer to the Cisco IOS IP and IP Routing Command Reference publication.
|
Note This command is applicable only on baseline privacy images. |
Examples
The following example shows how to specify that the multicast stream defined by the access list named reno be encrypted:
router(config-if)# cable match address reno
The following example shows how to specify that the multicast stream defined by the access list number 102 be encrypted:
router(config-if)# cable match address 102
Related Commands
ip access-list Defines an IP access list by name.
Command
Description
To specify the access-group for a cable modem, use the cable modem access-group command privileged EXEC mode. To disable the specification, use the no form of this command.
cable modem [mac-addr | ip-addr] access-group [access-list | access-name]
Syntax Description
mac-addr | ip-addr (Optional) Specifies either the MAC address or the IP address of the cable modem. mac-address Specifies the MAC address. access-list Specifies the IP access list (standard or extended). Valid values are 1 to 199. access-name Specifies the access-list name.
Defaults
No default behaviors or values.
Command Modes
EXEC mode
Command History
11.3(8) NA This command was introduced.
Release
Modification
Examples
The following example shows how to assign access-list 1 to the MAC address of the cable modem:
router# cable modem 000.000.0001 access-group 1
Related Commands
Displays configuration settings on the Cisco uBR7200 series cable router, including access-group setting.
Command
Description
To override the frequency used by a cable modem, use the cable modem change-frequency command in EXEC mode.
cable modem [mac-addr | ip-addr] change-frequency [ds-frequency-hz] [us-channel-id]
Syntax Description
mac-addr | ip-addr (Optional) Specifies either the MAC address or the IP address of the cable modem whose frequency is to be changed. ds-frequency-hz (Optional) Specifies the downstream frequency for the cable modem (in Hertz). us-channel-id (Optional) Specifies the upstream channel ID.
Defaults
No default behavior or values.
Command Modes
EXEC mode
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command allows the CMTS administrator to change the downstream frequency for a cable modem, overriding the DOCSIS configuration file setting. This command is not applicable on the Cisco 12.1(3a)EC Release.
Examples
The following example shows how to change the downstream frequency of the cable modem having IP address 172.172.172.12 to 570 MHz:
router(config-if)# cable modem 172.172.172.12 change-freq 57000000
Related Commands
cable modem max-hosts Specifies the maximum number of hosts supported by a specific cable modem.
Command
Description
To specify a maximum number of permitted hosts per modem (overriding the max-cpe value in the cable modem configuration file), use the cable modem max-cpe command in cable interface configuration mode. To disable the specification, use the no form of this command.
cable modem max-cpe [n | unlimited]
Syntax Description
n Specifies the configuration file value. Valid range is 1 to 254. unlimited Specifies the maximum CPE value to be unlimited.
Defaults
no cable modem max-cpe (the max-cpe value provided in the configuration file will be used by the CMTS to limit the number of hosts connected to a single cable modem).
Command Modes
Cable interface configuration
Command History
12.1(2)EC, 12.0(10)SC This command was introduced.
Release
Modification
Examples
The following example shows how to override the max-cpe setting in a cable modem configuration file:
router(config-if)# cable modem max-cpe unlimited
Usage Guidelines
The CMTS enables up to n number of hosts for a modem.When set to unlimited or n is larger than the max-cpe value in the configuration file of a cable modem, this command overrides the configuration file value.
|
Note When setting to unlimited or n is greater than the max-cpe value in the configuration file of a cable modem, the cable modem has to control the maximum number of hosts, and the DHCP server has to control the number of IP addresses assigned to hosts behind a single cable modem. |
|
Caution Use of this command might open a security hole in the system by enabling denial of service attacks. Specifically, it might enable a user to obtain a large number of IP addresses, thereby taking down the entire network, after all the available IP addresses have been reserved by this single user. Cisco recommends that, if this command is enabled, the number of IP addresses assigned to hosts behind a single modem be strictly controlled by the DHCP server. |
Related Commands
show cable modem Displays the max-cpe value setting.
Command
Description
To specify the maximum number of customer premises equipment (CPE) devices (hosts) that can be supported by a specific cable modem, use the cable modem max-hosts command in cable interface configuration mode. To set the number of hosts to 0, use the no form of this command.
cable modem {mac-addr | ip-addr} max-hosts {n | default}
Syntax Description
mac-addr | ip-addr Specifies either the MAC address or the IP address of the cable modem. max-hosts {n | default} Specifies either the maximum number of hosts supported by the cable modem (from 0 to 255), or specifies the default value of 0.
Defaults
0
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following example shows how to limits the cable modem having IP address 172.172.172.12 to a maximum of 40 attached CPE devices:
router(config-if)# cable modem 172.172.172.12 max-hosts 40
Related Commands
Overrides the frequency used by a cable modem.
Command
Description
To apply a specific quality-of-service profile to a cable modem, use the cable modem qos profile command in cable interface configuration mode. To set the number of hosts to 0, use the no form of this command.
cable modem qos profile qos-profile-index
Syntax Description
qos-profile-index Specifies QoS profile index values. Valid range is 1 to 255.
Defaults
No default behaviors or values.
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command is not applicable on the Cisco 12.1(3a)EC Release.
Examples
The following example shows how to specify a QoS profile index to a cable modem:
router(config-if)# cable modem qos profile 255
Related Commands
Overrides the frequency used by a cable modem.
Command
Description
To gather cable modem performance statistics on a CMTS, use the cable modem remote-query configuration command. To disable the gathering of cable modem statistics, use the no form of this command.
cable modem remote-query [polling interval] [Community string]
Syntax Description
polling interval Specifies how often the CMTS polls for cable modem statistics. Valid range is from 1 to 86,400 seconds. Community string Defines the Simple Network Management Protocol (SNMP) community string.
Defaults
No default behavior or values.
Command Modes
Interface Configuration
Command History
12.0(7)XR This command was introduced.
Release
Modification
Usage Guidelines
You can change the polling interval at any time. However, to change the SNMP community string, you must unconfigure and reconfigure this command. This command is not applicable on the Cisco 12.1(3a)EC Release.
Examples
The following example illustrates how to set the polling interval to 5 seconds and the SNMP community string to private:
Router(config)# cable modem remote-query 5 private
Related Commands
debug cable remote-query Turns on debugging to gather information from remote modems.
Command
Description
To define the modulation profile, use the cable modulation-profile global configuration command. Use the no form of this command to remove the specified modulation profile.
cable modulation-profile profile iuc fec-tbytes fec-len burst-len guard-t mod scrambler seed diff pre-len last-cw uw-len
Syntax Description
profile Modulation profile number. iuc Interval usage code. Valid entries are: initial, long, request, short, or station. fec-tbytes The number of bytes that can be corrected per FEC code word. Valid values are from 0 to 10, where 0 means no FEC. fec-len FEC code word length. Valid values are from 16 to 253. burst-len Maximum burst length in minislots. Valid values are from 0 to 255, where 0 means no limit. guard-t Guard time in symbols. The time between successive bursts. mod Modulation. Valid entries are 16qam and qpsk. scrambler Enable or disable scrambler. Valid entries are scrambler and no-scrambler. seed Scrambler seed in hexidecimal format. Valid values are from 0x0000 to 0x7FFF. diff Enable or disable differential encoding. Valid entries are diff and no-diff. pre-len Preamble length in bits. Valid values are from 2 to 128. last-cw Handling of FEC for last code word. Valid entries are fixed for fixed code-word length and shortened for shortened last code word. uw-len Upstream unique word length. Enter uw8 for 8-bit unique words or uw16 for 16-bit unique code words.
Defaults
Modulation profile #1 with qpsk option.
Command Modes
Global configuration
Command History
11.3 NA This command was introduced. 12.0(7)XR2 This command was supported. 12.1(3a)EC This command was supported.
Release
Modification
Usage Guidelines
A modulation profile is a collection of six burst profiles that are sent out in an Upstream Channel Descriptor (UCD) message to configure a modem's transmit parameters for the following upstream message types: request, initial maintenance, station maintenance, short grant, and long grant.
You can use the no cable modulation-profile command to remove all modulation profiles except modulation profile 1. In the case of modulation profile 1, the no cable modulation-profile command sets all of the parameters in a burst to default values.
|
Caution Changes to modulation profiles causes changes to the physical layer. Because changing physical layer characteristics affects router performance and function, this task should be reserved for expert users. |
To use this command correctly, enter a line with all parameters for each upstream burst type. An incomplete burst profile causes unreliable operation, or loss of modem connectivity.
Turning the scrambler off can cause packet loss and is used only in lab testing environments.
Errors or incompatible configurations in the burst profiles cause modems to either drop connectivity, drop short or long data packets, or even to fail to connect to the network. It is possible to build a burst profile set for which no implementation of a DOCSIS receiver is capable of receiving the modem's transmission.
160 Ksymbol/sec and 2560 Ksymbol/sec data rates are highly sensitive to unique word length, preamble length, and FEC sizing. Incorrect choices for these values can cause poor, or no, connectivity at these symbol rates.
Examples
The following example shows how to define the burst parameters for profile 2 as follows:
The request burst is defined to have 0 fec-tbytes, 16 kbytes fec-len, a burst-len of 1, a guard time of 8, a mod value of qpsk, scrambler enabled with a seed value of 152, differential encoding disabled, a preamble length of 64 bits, a fixed code word length, and 8-bit unique words for upstream unique word length. The remaining initial, station, short, and long bursts are defined in similar fashion for profile 2.
Router(config)# cable modulation-profile 2 request 0 16 1 8 qpsk scrambler 152 no-diff 64 fixed uw8 Router(config)# cable modulation-profile 2 initial 5 34 0 48 qpsk scrambler 152 no-diff 128 fixed uw16 Router(config)# cable modulation-profile 2 station 5 34 0 48 qpsk scrambler 152 no-diff 128 fixed uw16 Router(config)# cable modulation-profile 2 short 6 75 6 8 16qam scrambler 152 no-diff 144 fixed uw8 Router(config)# cable modulation-profile 2 long 8 220 0 8 16qam scrambler 152 no-diff 160 fixed uw8
|
Note You must create all of the bursts (request, initial, station, short and long) for this modulation profile, using the modulation profile command. |
See the show cable modulation-profile command for a description of the output display fields.
Related Commands
Assigns a modulation profile to an interface. Displays a modulation profile group's information.
Command
Description
b
To configure sniffer settings on a cable interface, use the cable monitor cable interface configuration command. To disable this function, use the no form of this command.
cable monitor [incoming | outbound[timestamp] interface {ethernet slot/port | fastethernet slot/port {access-list name| number | mac-address address | upstream upsnum [packet-type data {docsis | ethernet} | mac]}]
Syntax Description
incoming Specifies to monitor incoming packets on the upstream port. outbound Specifies to monitor outbound packets. timestamp Enables packet time-stamping. interface ethernet | fastethernet Specifies the interface to forward packets that are being monitored on the upstream port. Specifies Ethernet IEEE 802.3 or FastEthernet 802.3 options. ethernet slot/port Specifies the slot and port number for the Ethernet 802.3 interface option. fastethernet slot/port Specifies the slot and port number for the FastEthernet 802.3 interface option. access-list name| number Specifies the access list name or number. mac-address address Specifies the MAC address of the device being monitored upstream upsnum Specifies the upstream port that is being monitored. packet-type Specifies the data or MAC packets that is being monitored. data docsis | ethernet Specifies the DOCSIS or Ethernet encapsulation packet types. mac Specifies the MAC packet type that is being monitored.
Defaults
The incoming and outbound options are set by default.
Command Modes
Cable interface configuration
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Usage Guidelines
The interface used for forwarding packets can be used only for setting sniffer; it cannot be used for other purposes.
Examples
The following example shows how to configure sniffer setting on the the Ethernet slot 1, port 2, to monitor incoming packets on the upstream port 0:
router(config-if)# cable monitor incom int e1/2 ups 0 packet mac
Related Commands
show interface cable monitor Displays monitor flow information on the upstream port.
Command
Description
To enable privacy in the system, use the cable privacy command in cable interface configuration mode. To disable privacy, use the no form of this command.
cable privacy [mandatory | authenticate-modem | authorize-multicast]
Syntax Description
mandatory (Optional) Enforce baseline privacy for all modems. authenticate-modem (Optional) Use AAA protocols in conjunction with BPI to authenticate all modems. authorize-multicast (Optional) Use AAA protocols with BPI to authorize all multicast stream (IGMP) join requests.
Defaults
No default behaviors or values, BPI is optional.
Command Modes
Cable interface configuration
Command History
12.1 T This command was introduced.
Release
Modification
Usage Guidelines
This command is applicable only on BPI images.
Examples
The following examples all begin in cable interface configuration mode. The first example shows how to display the options available with the cable privacy command:
router(config-if) cable privacy ? authenticate-modem turn on BPI modem authentication authorize-multicast turn on BPI multicast authorization kek KEK Key Parms mandatory force privacy be mandatory tek TEK Key Parms
The following example shows how to force baseline privacy to be used for all cable modems:
router(config-if) cable privacy mandatory
The following example shows how to turn on the baseline privacy interface (BPI) modem authentication:
router(config-if) cable privacy authenticate-modem
The following example shows how to turn on BPI multicast authorization:
router(config-if) cable privacy authorize-multicast
Related Commands
ping cable-modem Determines whether a specific cable modem is online.
Command
Description
To set key encryption keys (KEKs) grace-time and life-time values for baseline privacy on an HFC network, use the cable privacy kek command in global configuration mode. To restore the default values, use the no form of this command.
cable privacy kek {grace-time [seconds] | life-time [seconds]}
Syntax Description
grace-time seconds (Optional) Length of key encryption grace-time in seconds. Valid range is 300 to 1800 seconds. life-time seconds (Optional) Length of the key encryption life-time in seconds.Valid range is 86,400 to 604,8000.
Defaults
grace-time: 600 seconds
life-time: 604800 seconds
Command Modes
Global configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
Baseline privacy on an HFC network is configured with key encryption keys (KEKs) and traffic encryption keys (TEKs). The encryption is based on 40-bit or 56-bit data encryption standard (DES) encryption algorithms.
A KEK is assigned to a cable modem based on the cable modem service identifier (SID) and permits the cable modem to connect to the Cisco uBR7200 series when baseline privacy is activated. KEKs can be set to expire based on a grace-time or a life-time value.
The grace-time keyword is used to assign a temporary key to a cable modem to access the network. The life-time keyword is used to assign a more permanent key to a cable modem.
A cable modem that has a grace-time or life-time key assigned by the Cisco uBR7200 series will request a new key before the current one expires.
|
Note This command is applicable only on BPI images. |
Examples
The following example shows how to set the KEK privacy grace-time to 800 seconds:
router(config)# cable privacy kek grace-time 800
The following example shows how to set the KEK privacy life-time to 750000 seconds:
router(config)# cable privacy kek life-time 750000
To set traffic encryption keys (TEKs) grace-time and life-time values for baseline privacy on an HFC network, use the cable privacy tek command in global configuration mode. To restore the default value, use the no form of this command.
cable privacy tek {grace-time [seconds] | life-time [seconds]}
Syntax Description
grace-time seconds (Optional) Length of traffic encryption grace-time in seconds. Valid range is 300 to 1800 seconds. Default is 600 seconds. life-time seconds (Optional) Length of the traffic encryption life-time in seconds. Valid range is 1800 to 604,8000. Default is 43,200 seconds.
Defaults
grace-time: 600 seconds
life-time: 43200 seconds
Command Modes
Global configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
Baseline privacy on an HFC network is configured with key encryption keys (KEKs) and traffic encryption keys (TEKs). The encryption is based on 40-bit or 56-bit data encryption standard (DES) encryption algorithms.
The TEK is assigned to a cable modem when its KEK has been established. The TEK is used to encrypt data traffic between the cable modem and the Cisco uBR7200 series. TEKs can be set to expire based on a grace-time or a life-time value.
The grace-time keyword is used to assign a temporary key to a cable modem to access the network. The life-time keyword is used to assign a more permanent key to a cable modem.
A cable modem that has a grace-time or life-time key assigned by the Cisco uBR7200 series requests a new key before the current one expires.
|
Note This command is applicable only on BPI images. |
Examples
The following example shows how to set the traffic encryption key grace-time to 800 seconds:
router(config)# cable privacy tek grace-time 800
The following example shows how to set the traffic encryption key life-time to 800000 seconds:
router(config)# cable privacy tek life-time 800000
To activate cable proxy Address Resolution Protocol (ARP) on the cable interface or subinterface, use the cable proxy-arp command in cable interface or subinterface configuration mode. To disable this feature, use the no form of this command.
Syntax for the interface configuration mode:
cable proxy-arpSyntax for the subinterface configuration mode:
interface cable slot/port.n cable proxy-arp
Syntax Description
slot/port.n The slot and port specify the slot and port numbers. The n argument specifies the subinterface number. Valid values for n are 1 to 2990.
Defaults
Disabled
Command Modes
Cable interface and subinterface configuration modes
Command History
11.3 XA This command was introduced. 12.1(3a)EC The subinterface support was added.
Release
Modification
Usage Guidelines
Because the downstream and upstream are separate interfaces, cable modems cannot directly perform address resolution with other cable modems on the cable plant. This command allows cable modems to perform address resolution through a proxy.
Examples
The following example shows how to activate proxy ARP for host-to-host communications:
router(config-subif)# cable proxy-arp
The following example shows how to activate proxy ARP for host-to-host communications, on the cable subinterface:
router(config-subif)# interface cable 6/0.1 cable proxy-arp
Related Commands
Activates cable Address Resolution Protocol (ARP).
Command
Description
To specify permission for updating the quality of service (QoS) table, use the cable qos permission command in global configuration mode. To remove a previously enabled permission, use the no form of this command.
cable qos permission {create | enforce index | modems | update}
Syntax Description
create Permits creation of QoS table entries by Simple Network Management Protocol (SNMP). enforce index The enforce keyword overrides the provisioned QoS profile of the cable modem and enforces a specific CMTS-local QoS profile. The index argument specifies the number of the QoS profile to be enforced on all cable modems connecting to the CMTS. Valid values are from 1 to 255. modems Permits creation of QoS table entries by modem registration requests. update Permits dynamic update of QoS table entries by SNMP.
Defaults
Enable by modem and SNMP.
Command Modes
Global configuration
Command History
11.3 NA This command was introduced. 11.3(9)NA The enforce keyword was added.
Release
Modification
Usage Guidelines
If the QoS profile to be enforced does not exist at the CMTS during registration, the CMTS uses the QoS profile configured for the registering cable modem.
Examples
The following example shows how to enable cable modems to request arbitrary QoS parameters:
Router(config)# cable qos permission modems
The following example shows how a cable modem with a QoS profile 4 created by the cable modem (cm) is reset to use QoS profile 225 enforced by the cable router (management):
CMTS01# show cable modem
Interface SID Online Timing Receive QoS IP address MAC
address
State Offset Power
Cable6/0/U0 1 online 2848 0.00 4 19.2.20.139 0010.7b6b.7215
CMTS01# show cable qos profile 4
Service Prio Max Guarantee Max Max tx TOS TOS Create B
class upstream upstream downstream burst mask value by priv
bandwidth bandwidth bandwidth enab
4 7 128000 64000 2048000 255 0x0 0x0 cm no
CMTS01(config)# cable qos profile 225 max-upstream 256
CMTS01(config)# cable qos permission enforce 225
CMTS01# clear cable modem all reset
CMTS01# show cable modem
Interface SID Online Timing Receive QoS IP address MACaddress
State Offset Power
Cable6/0/U0 1 offline 2848 0.25 2 19.2.20.139 0010.7b6b.7215
CMTS01# debug cable reg
....
00:15:59: Finished parsing REG Request
00:15:59: Overriding Provisioned QoS Parameters In REG-REQ
....
CMTS01# show cable modem
Interface SID Online Timing Receive QoS IP address MACaddress
State Offset Power
Cable6/0/U0 1 online 2852 0.00 225 19.2.20.139 0010.7b6b.7215
CMTS01# show cable qos profile 225
Service Prio Max Guarantee Max Max tx TOS TOS Create B
class upstream upstream downstream burst mask value by priv
bandwidth bandwidth bandwidth enab
225 0 256000 0 0 0 0x0 0x0 management no
Related Commands
Configures a QoS profile. show cable qos permission Displays the status of permissions for changing QoS tables for a cable router. show cable qos profile Displays cable router QoS profiles.
Command
Description
To configure a QoS profile, use the cable qos profile command in global configuration mode. To either set default values for profile group numbers 1 or 2, or to remove the QoS profile if no specific parameters remain, use the no form of this command.
cable qos profile {groupnum | grant-interval {interval} | grant-size {size} | guaranteed-upstream {rate} | ip-precedence {value} | max-burst {rate} | max-downstream {rate} | max-upstream {rate} | name {string} | priority {value} | privacy | tos-overwrite {value}}
Syntax Description
groupnum QoS profile group number. Qos profiles 1 and 2 are required by the system; they are preconfigured and can be modified but cannot be removed. QoS profile 1 is used during registration; QoS profile 2 is the default QoS profile. grant-interval The periodic interval in microseconds at which the cable modem (CM) wants to send the fixed-sized upstream MAC frames. It is used to compute the period in between constant bit rate (CBR) slots for the CM. Valid range is from 0 to 65535. grant-size The size of the DOCSIS MAC frame the CM wants periodically to send on the upstream transmission. This value in bytes does not include any PHY layer overhead. It includes the complete fixed MAC frame size starting from the frame control byte to the CRC of the protocol data unit (PDU). This parameter is used by the CMTS to set the size of the periodic CBR slot for the CM after adding the PHY overhead. guaranteed-upstream Guaranteed minimum upstream rate in kilobytes per second. Valid values are from 0 to 100000. Default value is 0 (no reserved rate). ip-precedence Bits in the type-of-service (ToS) byte that enable you to configure individual data rate limits on a per modem basis. Valid values are from 0 to 7. max-burst Maximum upstream transmit burst size in bytes that the modem can send for any single transmit burst. Valid values are from 0 to 65535 bytes. Default value is 0 (no limit). max-downstream Maximum downstream data rate in kilobytes per second that a modem using this QoS profile receives. Valid values are from 0 to 100000. Default value is 0 (no downstream rate limit). maximum-upstream Maximum upstream data rate in kilobytes per second that a modem using this QoS profile receives. Valid values are from 0 to 255. Default value is 0 (no upstream rate limit). name QoS name string. priority Relative priority number assigned to upstream traffic by this QoS profile. Valid values are from 0 to 7, with 7 being the highest priority. Default value is 0. privacy Enables cable baseline privacy. tos-overwrite Overwrite the ToS field in the IP datagrams received on the upstream before forwarding them downstream (or IP backbone). This parameter sets the hexadecimal mask bits to a hexadecimal value, thereby helping the CMTS identify datagrams for QoS on the backbone. Valid range is from 0x0 to 0xFF. value The value substituted for the ToS value.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.3 NA This command was introduced. 12.0(3)T Command was included in the mainline release. 12.0(5)T The ip-precedence argument was added, and the range for the max-downstream argument was increased. 12.0(7)XR2 Output was reorganized and name, grant-size, and grant-interval parameters were added.
Release
Modification
Examples
The following example shows how to configure QoS profile 4 with a guaranteed upstream rate of 8 kbps, maximum transmission burst of 16 minislots, maximum downstream rate of 128 kbps, a priority of 4, cable baseline privacy set, and a tos-overwrite mask and value byte (in hex) of 0x2:
router(config)# cable qos profile 4 guaranteed-upstream 8 router(config)# cable qos profile 4 max-burst 16 router(config)# cable qos profile 4 max-downstream 128 router(config)# cable qos profile 4 privacy router(config)# cable qos profile 4 priority 4 router(config)# cable qos profile 4 tos-overwrite 0xA0 0xE0
Related Commands
cable qos permission Specifies permission for updating the cable router QoS table. show cable qos profile Displays cable router QoS profiles.
Command
Description
To configure the registration timeout, use the cable registration-timeout interface configuration command. To set the timeout value to the default, use the no form of this command.
cable registration-timeout minutes
Syntax Description
minutes Sets the registration timeout. Valid range is from 2 to 60 minutes.
Defaults
3 minutes
Command Modes
Interface configuration
Command History
12.0(7)XR2 This command was introduced.
Release
Modification
Examples
The following example shows how you can increase the registration timeout value from 3 minutes to 10 minutes:
router(config-if)# cable registration-timeout 10
To enable the system to insert the cable modem MAC address into a Dynamic Host Configuration Protocol (DHCP) packet received from a cable modem or host and forward the packet to a DHCP server, use the cable relay-agent-option command in cable interface configuration mode. To disable MAC address insertion, use the no form of this command.
cable relay-agent-optionSyntax Description
This command has no keywords or arguments.
Defaults
no cable relay-agent-option
Command Modes
Cable interface configuration
Command History
11.3 NA This command was introduced. 12.0 mainline, 12.1(2)EC1, 12.0(10) SC This command is obsolete. Use the ip dhcp relay information option command instead.
Release
Modification
Usage Guidelines
This functionality enables a DHCP server to identify the cable modem sending the request and initiate to appropriate action based on this information. On Cisco IOS Release 12.0 and later releases, use the ip dhcp relay information option command.
Examples
The following example shows how to enable the insertion of DHCP relay agent information into DHCP packets:
router(config-if)# cable relay-agent-option
Related Commands
Specifies a destination IP address for User Datagram Protocol (UDP) broadcast (DHCP) packets. cable dhcp-giaddr Modifies the GIADDR field of DHCPDISCOVER and DHCPREQUEST packets with a Relay IP address before they are forwarded to the DHCP server. Turns on cable modem upstream verification. Enforces the telco-return cable modem to use a specific Dynamic Host Configuration Protocol (DHCP) server. Identifies the IP address of the Dynamic Host Configuration Protocol (DHCP) server that the telco-return cable modem must access. Enables the system to insert the cable modem MAC address into a DHCP packet received from a cable modem or host and forward the packet to a DHCP server. Monitors client retransmissions when address pool depletion occurs.
Command
Description
To set the amount of time a dynamic service-flow can be present in the system without any activity, use the cable service-flow inactivity-timeout global configuration mode. To remove the specification, use the no form of this command.
cable service-flow inactivity-timeout minutes
Syntax Description
minutes Specifies service-flow inactivity-timeout in minutes. Valid range is 1 to 120 minutes. Default value is 30 minutes.
Defaults
30 minutes
Command Modes
Cable global configuration
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Usage Guidelines
Resources such as service identifiers (SIDs) and bandwidth are dynamically allocated by a cable modem using Dynamic Service Addition (DSA) transaction. If the cable modem fails to release these resources by issuing a Dynamic Service Deletion (DSD), then the resources might be locked indefinitely. Use this command to release unused resources.
Examples
The following example shows how to set the inactivity timeout for dynamic service flows to 2 minutes. Once this setting is specified, any dynamic SID that does not show any activity in 2 minutes will be deleted.
Router(config-if)# cable service-flow inactivity-timeout 2 The following example shows how to set the inactivity timeout back to the default value of 30 minutes: Router(config-if)# cable service-flow inactivity-timeout
Related Commands
Sets the amount of time a dynamic service-flow can be present in the system without any activity. cable qos permission Specifies permission for updating the cable router QoS table. cable qos profile Configures a QoS profiles. Displays cable router QoS profiles.
Command
Description
To configure authentication and data privacy parameters, use the cable shared-secret command in cable interface configuration mode. To disable authentication during the cable modem registration phase, use the no form of this command.
cable shared-secret [0 | 7] authentication-key
Syntax Description
0 (Optional) Specifies that an unencrypted message will follow. 7 (Optional) Specifies that an encrypted message will follow. authentication-key Text string is a shared secret string. When you enable the service password-encryption option, the password is stored in encrypted form. The text string is a 64-character authentication key.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
Use this command to activate authentication so that all cable modems must return a known text string to register with the Cisco uBR7200 series for access to the HFC network.
Examples
The following example shows how to activate cable modem authentication using 3344912349988...sf as the shared secret key and indicating that an encrypted message follows:
router(config-if)# cable shared-secret 7 3344912349988cisco@xapowenaspasdpuy230jhm...sf
To turn on cable modem upstream verification, use the cable source-verify command in cable interface or subinterface configuration mode. To disable verification, use the no form of this command.
Syntax for the interface configuration mode:
cable source-verify [dhcp]Syntax for the subinterface configuration mode:
interface cable slot/port.n cable source-verify [dhcp]
Syntax Description
dhcp (Optional) Specifies that queries will be sent to verify unknown source IP addresses in upstream data packets. slot/port.n The slot and port specify the slot and port numbers. The n argument specifies the subinterface number. Valid values for n are 1 to 2990.
Defaults
Disabled
Command Modes
Cable interface and subinterface configuration modes
Command History
11.3 XA This command was introduced. 12.0(7)T The dhcp keyword was added. 12.0(10)SC, 12.1(2)EC Support was added. 12.1(3a)EC The subinterface support was added.
Release
Modification
Usage Guidelines
This command is used to protect IP addresses in the cable subnets. Without the Dynamic Host Configuration Protocol (DHCP) option, only assigned IP addresses are protected. If the DHCP option is specified, all IP addresses are protected. In order to specify the DHCP option, a version of CNR that supports DHCP LEASEQUERY must be used. The uBR7200 series keeps track of all the assigned IP address by gleaning into the DHCP packets.
Examples
The following example shows how to turn on cable modem upstream verification and configures the Cisco uBR7200 series to send DHCP LEASEQUERIES to verify unknown source IP addresses in upstream data packets:
router(config-subif)# cable source-verify dhcp
Related Commands
Specifies a destination IP address for User Datagram Protocol (UDP) broadcast (DHCP) packets. cable dhcp-giaddr Modifies the GIADDR field of DHCPDISCOVER and DHCPREQUEST packets with a Relay IP address before they are forwarded to the DHCP server. Enables the system to insert the cable modem MAC address into a DHCP packet received from a cable modem or host and forward the packet to a DHCP server. Enforces the telco-return cable modem to use a specific Dynamic Host Configuration Protocol (DHCP) server. Identifies the IP address of the Dynamic Host Configuration Protocol (DHCP) server that the telco-return cable modem must access. Enables the system to insert the cable modem MAC address into a DHCP packet received from a cable modem or host and forward the packet to a DHCP server. Monitors client retransmissions when address pool depletion occurs.
Command
Description
To create a spectrum group, use the cable spectrum-group command in global configuration mode. To disable this spectrum group, use the no form of this command.
cable spectrum-group group number parameter value
Syntax Description
group number Specifies the spectrum group for which you are specifying a parameter value or specifies the number of the spectrum group you wish to remove from your router configuration. Valid range is from 1 to 32. parameter The spectrum group values that can be changed or added are: value The corresponding parameter value for the parameter you are defining for a given spectrum group.
Note The spectrum management daughter card on the MC16S can use the frequency range you specify in this command to scan a range of frequencies for possible automatic hop, instead of having to specify a number of individual frequencies using the cable spectrum-group group number frequency command.
Defaults
No default behaviors or values.
Command Modes
Global configuration
Command History
12.0(5)T1 This command was introduced. 12.0(7)XR2 The band parameter for this command was added to enable frequency range scanning capabilities in the MC16S cable modem card.
Release
Modification
Frequency agility is configured and activated using spectrum groups that are controlled by the spectrum manager. You can create from 1 to 32 spectrum groups for each cable modem card upstream port.
To create spectrum groups, specify a list of upstream frequencies and nominal power levels that each spectrum group can use when an upstream frequency change is necessary. Each spectrum group should have its own list of upstream frequencies. At 1.6 MHz, the valid range is -10 dBmV to 25 dBmV. The power level value should only be changed if you want to change only the power level as part of spectrum management. The standard power level is 0 dBmV.
You must repeat this command for each frequency or power level that you want to add to a spectrum group's list of valid values.
After you have created one or more spectrum groups for your cable network, you can add characteristics to them, providing you with more definitive control over frequency usage and frequency hopping.
The cable interface will not operate until you either create and configure a spectrum group or set a fixed upstream frequency. See the cable upstream channel-width.
|
Note The CSCds21565 provides support for spectrum groups on the MC16E card. The use of spectrum groups with the MC16E card is currently not supported. Following resolution of CSCds21565, frequency hopping through the use of spectrum groups will be available on the MC16E card. |
Examples
The following example shows how to configure spectrum group 1 with an upstream frequency of 6,500,000 Hz and a default power level of 0 dBmV:
Router(config)# cable spectrum-group 1 frequency 6500000
The following example shows how to add the upstream frequency 7,000,000 Hz to the list of valid frequencies with a default power level of 0 dBmV for spectrum group 1:
Router(config)# cable spectrum-group 1 frequency 7000000
The following example shows how to configure spectrum group 2 with an upstream frequency 7,500,000 Hz and change the power level to 5 dBmV:
Router(config)# cable spectrum-group 2 frequency 7500000 5
The following example shows how to configure spectrum group 3 with an upstream band of 12,000,000 to 18,000,000 Hz and default power level of 0 dBmV:
Router(config)# cable spectrum-group 3 band 12000000 18000000
The following example shows how to add the upstream band 20,000,000 to 24,000,000 Hz to the list of valid bands with a change in the power level of 13 dBmV for spectrum group 3:
Router(config)# cable spectrum-group 3 band 20000000 24000000 13
The following example shows how to configure a continuous band between 5,000,004 and 40,000,000 Hz for scheduled spectrum group 4 with a default power level of 0 dBmV. The spectrum group will be available to the spectrum group starting at 12:00 p.m. local time each Monday:
Router(config)# cable spectrum-group 4 time Monday 12:00:00 band 5000004 40000000
The following example shows how to add the upstream frequency 9,500,000 Hz to the list of valid frequencies and change the nominal power level to 5 dBmV. The spectrum manager adjusts frequencies and power levels on this group at 2:00 a.m. local time each day:
Router(config)# cable spectrum-group 3 time 02:00:00 frequency 9500000 5
The following example shows how to configure the minimum period before which a frequency hop can occur in seconds:
Router(config)# cable spectrum-group 3 hop period 800
The following example shows how to configure the threshold value (expressed as a percentage) of the number of "offline" modems identified before the Cisco uBR7200 series initiates an automatic frequency hop:
Router(config)# cable spectrum-group 3 hop threshold 40
The following example shows how to configure a particular spectrum group as a shared RF spectrum group. Specifying a given spectrum group as "shared" tells the Cisco uBR7200 series that you want to be sure that upstream frequencies assigned to upstream interfaces are not assigned to additional upstream interfaces:
Router(config)# cable spectrum-group 3 shared
The following example shows how to remove a specified spectrum group from your configuration:
Router(config)# no cable spectrum-group 3
Related Commands
Specifies the center frequency for a given upstream cable interface. Configures preset modulation profiles that you can apply to one or more upstream cable interfaces when you identify and configure spectrum groups. Specifies the upstream cable interface receive power level in dBmV. Activates or shuts down a specified upstream cable interface. Disengages the advanced spectrum management features of the MC16S cable modem card by enabling blind frequency hopping behavior.
Command
Description
To set the minimum frequency-hop interval, use the cable spectrum-group hop period command in global configuration mode. To delete the frequency hop interval for this spectrum group, use the no form of this command.
cable spectrum-group groupnum hop period seconds
Syntax Description
groupnum Spectrum group number. Valid values are from 1 to 32. seconds Specifies the frequency-hop time period in seconds. Valid values are from 1 to 3600 seconds. Default value is 300 seconds.
Defaults
300 seconds
Command Modes
Global configuration
Command History
12.1 T This command was introduced.
Release
Modification
Usage Guidelines
The Cisco uBR7200 series router polls each cable modem at a default rate of once every 10 seconds. When ingress noise causes the loss of keepalive messages for a specified period of time, a new frequency is selected from the allocation table and a Upstream Channel Descriptor (UCD) update is performed.
If you expect the destination channel to be impaired, reduce the minimum period between frequency hops to a lower value such as 10 seconds. This allows the frequency hop to continue more rapidly until a clear channel is found. If excessive frequency hop is a concern, you can increase the minimum period between hops.
On the MC1xC cards, the maximum recommended hop period is 20 seconds. On the MC16S card, the maximum recommended hop period is 35 seconds.
Examples
The following example shows how to reduce the minimum frequency-hop interval to 60 seconds:
router(config)# cable spectrum-group hop period 60
Related Commands
Specifies a hop threshold for a cable spectrum group.
Command
Description
To specify a frequency hop threshold for a spectrum group, use the cable spectrum-group hop threshold command in global configuration mode. To delete the hop threshold for this spectrum group, use the no form of this command.
cable spectrum-group groupnum hop threshold [percent]
Syntax Description
groupnum Spectrum group number. Valid values are from 1 to 32. percent (Optional) Specifies the frequency hop threshold as a percentage of cable modems going offline. Valid range is from 1 to 100 percent.
Defaults
100 percent
Command Modes
Global configuration
Command History
12.1 T This command was introduced.
Release
Modification
Usage Guidelines
The Cisco uBR7200 series router polls each cable modem at a default rate of once every 10 seconds. When ingress noise causes loss of keepalive messages from a configurable percentage of all cable modems, resulting in those cable modems going offline, a new frequency is selected from the allocation table and a Upstream Channel Descriptor (UCD) update is performed.
Use this command to prevent a single failing cable modem from affecting service to other good cable modems.
Examples
The following example shows how set the threshold that triggers frequency hop to 20 percent of all cable modems for spectrum-group 4:
router(config)# cable spectrum-group 4 hop threshold 20
Related Commands
cable spectrum-group hop period Sets the minimum frequency-hop interval for a cable spectrum group.
Command
Description
To specify that the upstream ports in a spectrum group share the same upstream frequency, use the cable spectrum-group shared command in global configuration mode. To delete this specification, use the no form of this command.
cable spectrum-group groupnum shared
Syntax Description
groupnum Spectrum group number. Valid values are from 1 to 32.
Defaults
Upstream port frequency the same for all ports in the spectrum group.
Command Modes
Global configuration
Command History
12.1 T This command was introduced.
Release
Modification
Usage Guidelines
Because this command forces upstream ports to use the same spectrum, do not use this command for overlapping carriers.
Examples
The following example shows how to specify that all the upstream ports for spectrum group 4 share the same upstream frequency:
router(config)# cable spectrum-group 4 shared
To specify the interval between successive sync message transmissions from the Cisco uBR7200 series, use the cable sync-interval command in the cable interface configuration mode. To return the sync message interval to its default value, use the no form of this command.
cable sync-interval msec
Syntax Description
msec Specify the interval in milliseconds (ms) between successive sync message transmissions from the Cisco uBR7200 series. Valid values are from 1 to 200 ms. Default value is 10 ms.
Defaults
10 ms
Command Modes
Cable interface configuration
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
To verify whether or not a sync message interval has been configured, enter the show running-config command and look for the cable interface configuration information. If a sync message interval has been configured, it appears in this output. If the sync message interval has been deactivated or reset to its default value, no sync interval command line appears in the output.
Examples
The following example shows how to specify the interval for the sync message transmissions to 100 ms:
Router (config-if)# cable sync-interval 100
To enable telco return support, use the cable telco-return enable interface configuration command. To disable this feature, use the no form of this command.
cable telco-return enableSyntax Description
This command has no arguments or keywords.
Defaults
Telco return support is disabled.
Command Modes
Interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following example shows how to enable telco return:
router(config-if)# cable telco-return enable
Related Commands
Defines the interval for sending Telephony Channel Descriptor (TCD) and Termination System Information (TSI) messages.
Command
Description
To set the interval for sending Telephony Channel Descriptor (TCD) and Termination System Information (TSI) messages, use the cable telco-return interval interface configuration command. To restore the default value, use the no form of this command.
cable telco-return interval seconds
Syntax Description
seconds Number of seconds between intervals for sending TCD and TSI messages. Valid range is 2 through 60 seconds.
Defaults
2 seconds
Command Modes
Interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following example shows how to set the TCD and TSI message interval to 40 seconds:
router(config-if)# cable telco-return interval 40
Related Commands
Enables telco return functionality.
Command
Description
To select a different IP address for the telco-return cable modem to send its registration requests, use the cable telco-return registration-ip interface configuration command. To restore the default value, use the no form of this command.
cable telco-return registration-ip ip-address
Syntax Description
ip-address Registration IP address that is sent in Termination System Information (TSI) messages. Value is any of the cable interface's IP addresses.
Defaults
The downstream channel IP address of the Cisco uBR7200 series is used.
Command Modes
Interface configuration
Command History
12.1(2)EC This command was introduced.
Release
Modification
Usage Guidelines
This command sets the Registration IP Address parameter in TSI messages. By default, the downstream channel IP address of the Cisco uBR7200 series is also used for the registration IP address. When this cable telco-return registration-ip command is configured, telco-return cable modems send their registration requests to this IP address instead of to the downstream channel IP address.
Examples
The following example shows how to send the cable modem's registration requests to IP address 172.16.1.1:
router(config-if)# cable telco-return registration-ip 172.16.1.1
Related Commands
Enables telco return functionality. Sets the interval for sending Telephony Channel Descriptor (TCD) and Termination System Information (TSI) messages.
Command
Description
To require the telco-return cable modem to use a specific Dynamic Host Configuration Protocol (DHCP) server, use the cable telco-return spd dhcp-authenticate interface configuration command. To restore the default value, use the no form of this command.
cable telco-return spd spd-number dhcp-authenticate
Syntax Description
spd-number Service provider descriptor number for which this parameter is set. Valid range is 1 through 5.
Defaults
The cable modem can use any available DHCP server.
Command Modes
Interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command sets the DHCP Authenticate parameter to True (1) for the specified SPD in the TCD messages. It indicates that the cable modem must use the DHCP server that is specified with the cable telco-return spd dhcp-server command.
Examples
The following example indicates that for SPD 2, cable modems must use the DHCP server identified by IP address 192.168.255.255:
router(config-if)# cable telco-return spd 2 dhcp-authenticate router(config-if)# cable telco-return spd 2 dhcp-server 192.168.255.255
Related Commands
Enables telco return functionality. Identifies the IP address of the DHCP server that the telco return cable modems must use.
Command
Description
To identify the IP address of the Dynamic Host Configuration Protocol (DHCP) server that the telco-return cable modem must access, use the cable telco-return spd dhcp-server interface configuration command. To restore the default value, use the no form of this command.
cable telco-return spd spd-number dhcp-server ip-address
Syntax Description
spd-number Service provider descriptor number for which this parameter is set. Valid range is 1 through 5. ip-address IP address of the DHCP server that cable modems must use.
Defaults
The IP address is set to 0.
Command Modes
Interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command sets the DHCP Server parameter in the specified SPD in TCD messages. Telco return cable modems use the DHCP server that is identified by this IP address if the cable telco-return spd dhcp-authenticate command is configured. If the cable telco-return spd dhcp-authenticate command is not configured, the cable modems uses any available DHCP server.
Examples
The following example indicates that for SPD 2, cable modems must use the DHCP server identified by IP address 192.168.255.255:
router(config-if)# cable telco-return spd 2 dhcp-authenticate router(config-if)# cable telco-return spd 2 dhcp-server 192.168.255.255
Related Commands
Enables telco return functionality. Indicates that telco return cable modems must use a specific Dynamic Host Configuration Protocol (DHCP) server.
Command
Description
To set the number of seconds that a telephone connection is idle before the telco-return cable modem disconnects the call, use the cable telco-return spd dial-timer EXEC command. To restore the default value, use the no form of this command.
cable telco-return spd spd-number dial-timer seconds
Syntax Description
spd-number Service provider descriptor number for which this parameter is set. Valid range is 1 through 5. seconds Number of seconds that a connection is idle before the cable modem disconnects the call. Valid range is 0 through 4,294,967,295. The default of 0 means that the dial-timer is not used.
Defaults
The dial-timer is set to 0, which means that inactive telephone connections are not disconnected.
Command Modes
Interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command sets the Demand Dial Timer parameter for the specified SPD in TCD messages. This enables the cable modem to emulate true dial-on-demand functionality by monitoring inactive networking time and allowing it to disconnect any telephone connection that exceeds the timer.
Examples
The following example shows how to set the timer to 2 hours:
router(config-if)# cable telco-return spd 2 dial-timer 7200
Related Commands
Enables telco return functionality. Sets the telephone numbers that the telco-return cable modem dials when connecting to the headend's network access server. Selects the authentication procedure to use when the telco-return cable modem is establishing a PPP connection.
Command
Description
To indicate the service provider descriptor (SPD) that the telco-return cable modem uses during the initialization process, use the cable telco-return spd factory-default interface configuration command. To restore the default value, use the no form of this command.
cable telco-return spd spd-number factory-default
Syntax Description
spd-number Service provider descriptor that contains the set of telephony attributes used by the cable modem during initialization. Valid range is 1 through 5.
Defaults
The Factory Default Flag in the SPD is set to 0, which means that this SPD is not used for the initialization process.
Command Modes
Interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command sets the Factory Default parameter in the specified SPD in TCD messages. This determines the set of telephony attributes, as defined by the SPD, that are used for the initialization process when the cable modem is powered on or is reset to its factory default.
Examples
The following example shows how to set the telco-return cable modem to use SPD 2 during the initialization procedure:
router(config-if)# cable telco-return spd 2 factory-default
Related Commands
Enables telco return functionality. Includes the service provider name in the SPD.
Command
Description
To enable the telco-return cable modem to operate in manual-dial mode, use the cable telco-return spd manual-dial interface configuration command. To restore the default value, use the no form of this command.
cable telco-return spd spd-number manual-dial
Syntax Description
spd-number Service provider descriptor number for which this parameter is set. Valid range is 1 through 5.
Defaults
Manual-dial mode is disabled.
Command Modes
Interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command sets the Manual Dial vendor-specific parameter in the specified SPD in TCD messages.
Examples
The following example shows how to set manual-dial mode for SPD 1:
router(config-if)# cable telco-return spd 1 manual-dial
Related Commands
Enables telco-return functionality. Sets the number of seconds that a telephone connection is idle before the telco-return cable modem disconnects the call.
Command
Description
To set the password that the telco-return cable modem uses for authentication when establishing a PPP connection with the access server, use the cable telco-return spd password interface configuration command. To restore the default value, use the no form of this command.
cable telco-return spd spd-number password password-string
Syntax Description
spd-number Service provider descriptor number for which this parameter is set. Valid range is 1 through 5. password-string Login password that the cable modem uses for authentication during the initialization procedure.
Defaults
No password is used.
Command Modes
Interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command sets the Login Password parameter for the specified SPD in TCD messages.
Examples
The following example shows how to set the password to 9JwoKd7 in service provider descriptor 2:
router(config-if)# cable telco-return spd 2 password 9JwoKd7
Related Commands
Enables telco-return functionality. Sets the telephone numbers that the telco-return cable modem dials when connecting to the headend's network access server. Sets the username that the telco-return cable modem uses for authentication when establishing a PPP connection.
Command
Description
To set the telephone numbers that the telco-return cable modem uses when connecting to the headend's network access server, use the cable telco-return spd phonenum interface configuration command. To delete previously entered telephone numbers, use the no form of this command.
cable telco-return spd spd-number phonenum dial-string
Syntax Description
spd-number Service provider descriptor number for which this parameter is set. Valid range is 1 through 5. dial-string Telephone number that the cable modem uses to connect to the headend's network access server.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command sets the Phone Number parameters in the specified SPD in TCD messages. You can repeat this command, entering as many as three telephone numbers for the cable modem to use when attempting to establish a PPP connection with the network access server. The phone numbers are mapped to the parameters Phone Number1, Phone Number2, Phone Number3 in the order in which you enter them. The cable modem attempts to connect using Phone Number1 first. If it fails to connect, and its number of retries exceeds the limit set with the cable telco-return spd threshold command, the cable modem dials the next number in the list.
Examples
The following example shows how to set the primary phone number to 9255551212. If the cable modem fails to connect using that number, it will try 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
Related Commands
Enables telco-return functionality. Sets the password that the telco-return cable modem uses for authentication when establishing a PPP connection. Sets the username that the telco-return cable modem uses for authentication when establishing a PPP connection.
Command
Description
To select the authentication method used when the telco-return cable modem is establishing a PPP connection, use the cable telco-return spd ppp-authenticate interface configuration command. To restore the default value, use the no form of this command.
cable telco-return spd spd-number ppp-authenticate [both | chap | pap]
Syntax Description
spd-number Service provider descriptor number for which this parameter is set. Valid range is 1 through 5. both Challenge Handshake Authentication Protocol (CHAP) is used if the network access server supports CHAP. Password Authentication Protocol (PAP) is used only if the network access server does not support CHAP. chap CHAP authentication is used. pap PAP authentication is used.
Defaults
The default is both; either CHAP or PAP is used depending on the methods supported by the network access server.
Command Modes
Interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command sets the PPP Authentication parameter for the specified SPD in TCD messages.
Examples
The following example requires the cable modem to perform CHAP authentication:
router(config-if)# cable telco-return spd 2 ppp-authenticate chap
Related Commands
Enables telco-return functionality. Sets the password that the telco-return cable modem uses for authentication when establishing a PPP connection. Specifies the Telephone Numbers parameter in TCD messages. Sets the username that the telco-return cable modem uses for authentication when establishing a PPP connection.
Command
Description
To select a RADIUS server domain to use for the login response string, use the cable telco-return spd radius-realm interface configuration command. To restore the default value, use the no form of this command.
cable telco-return spd spd-number radius-realm string
Syntax Description
spd-number Service provider descriptor number for which this parameter is set. Valid range is 1 through 5. string Alphanumeric string identifying a RADIUS server domain.
Defaults
The default value is the null string.
Command Modes
Interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command sets the RADIUS Realm parameter for the specified SPD in TCD messages. When this command is configured, telco return cable modems use this realm string to construct a domain name for the login username when responding to a PPP login query.
Examples
The following example indicates a login response string of sandy@sunol:
router(config-if)# cable telco-return spd 3 radius-realm sunol router(config-if)# cable telco-return spd 3 username sandy
Related Commands
Enables telco-return functionality. Sets the username that the telco-return cable modem uses for authentication when establishing a PPP connection. Sets the password that the telco-return cable modem uses for authentication when establishing a PPP connection.
Command
Description
To include the service provider name in the SPD, use the cable telco-return service-provider interface configuration command. To remove the parameter from the SPD, use the no form of this command.
cable telco-return spd spd-number service-provider spd-string
Syntax Description
spd-number Service provider descriptor number for which this parameter is set. Valid range is 1 through 5. spd-string Alphanumeric string that identifies the service provider.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command sets the Service Provider Name parameter for the specified SPD in the TCD messages.
Examples
The following example sets the service provider name to "san_jose" for SPD 2:
router(config-if)# cable telco-return spd 2 service-provider san_jose
Related Commands
Enables telco-return functionality. Indicates the service provider descriptor (SPD) that the telco-return cable modem uses during the initialization process.
Command
Description
To set the number of failed dial-up connections that can occur before the cable modem indicates a connection failure, use the cable telco-return spd threshold interface configuration command. To restore the default value, use the no form of this command.
cable telco-return spd spd-number threshold threshold-number
Syntax Description
spd-number Service provider descriptor number for which this parameter is set. Valid range is 1 through 5. threshold-number Number of dial-up attempts that fail before the cable modem declares a connection failure. Valid range is 1 through 255.
Defaults
The default value is 1.
Command Modes
Interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command sets the Connection Threshold parameter for the specified SPD in the TCD messages. A dial-up attempt is considered a connection failure if an answer connection is not made after ten rings. The cable modem continues to try to connect until the connection threshold is reached. If multiple phone numbers are configured using the cable telco-return spd phonenum command, the cable modem dials each phone number until it makes a connection or exceeds the configured threshold.
Examples
The following example sets the connection threshold to 20:
router(config-if)# cable telco-return spd 2 threshold 20
Related Commands
Enables telco-return functionality. Sets the number of seconds that the telco-return cable modem waits before disconnecting any inactive upstream telephone connection. Sets the telephone numbers that the telco-return cable modem dials when connecting to the headend's network access server.
Command
Description
To set the username that the telco-return cable modem uses for authentication when establishing a PPP connection with the access server, use the cable telco-return spd username interface configuration command. To restore the default value, use the no form of this command.
cable telco-return spd spd-number username login-string
Syntax Description
spd-number Service provider descriptor number for which this parameter is set. Valid range is 1 through 5. login-string Username that the cable modem uses for authentication during the initialization procedure.
Defaults
The default value is "guest."
Command Modes
Interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command sets the Login Username parameter for the specified SPD in the TCD messages.
Examples
The following example sets the username to "sandy" for SPD 3:
router(config-if)# cable telco-return spd 3 username sandy
Related Commands
Enables telco-return functionality. Specifies the Login Password parameter in TCD messages. Selects the authentication procedure to use when the telco-return cable modem is establishing a PPP connection.
Command
Description
To enable the integrated time-of-day (ToD) server on the Cisco uBR7200 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, or enter the command with the disable keyword.
cable time-server [enable | disable]
Syntax Description
enable (Optional) Starts the time-of-day server as a background task. disable (Optional) Stops the time-of-day server.
Defaults
Disabled
Command Modes
Global configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following example shows how to enable the time-of-day server:
router(config)# cable time-server enable
To specify the percentage of overbooking that will be allowed on the upstream channel, use the cable upstream admission-control command in cable interface configuration mode. To disable upstream admission control, use the no form of this command.
cable upstream usport admission-control percentage
Syntax Description
usport Specifies the upstream port. percentage Sets the admission control as a percentage of the upstream channel capacity. Valid values are from 100 to 10000 percent.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
11.3(6) NA This command was introduced.
Release
Modification
Usage Guidelines
To verify whether or not upstream admission control is configured and activated, enter the show running-config command in privileged EXEC mode and look for the cable interface configuration information. If upstream admission control is configured and enabled, an admission control entry is displayed in the show running-config output, indicating the user-defined percentage of upstream channel capacity allowable. If upstream admission control is disabled, no admission control entry is displayed in the output.
|
Note If you are having trouble, make sure the cable connections are not loose or disconnected; the cable modem card is firmly seated in its chassis slot; the captive installation screws are tight; you have entered the correct slot and port numbers; and you have selected a valid frequency for your router. |
Examples
The following example shows how to limit overbooking on upstream port 4 to 500 percent:
router(config-if)# cable upstream 4 admission-control 500
To specify an upstream channel width for an upstream port, use the cable upstream channel-width command in cable interface configuration mode. To set the channel width back to the default setting of 1600,000 Hz, use the no form of this command.
cable upstream usport channel-width first-choice-width [last-choice-width]
Syntax Description
usport Specifies the port number. first-choice-width Specifies upstream channel width in hertz (Hz). Valid values are: 200,000 (160000 symbols/sec), 400,000 (320,000 symbols/sec), 800,000 (640,000 symbols/sec), 1600,000 (1,280,000 symbols/sec), and 3,200,000 (2,560,000 symbols/sec). last-choice-width (Optional) The upstream channel width in hertz. The valid values are the same as those for the first-choice-width parameter. Use this parameter with the Cisco MC16S cable modem card to enable symbol rate management algorithms. The symbol rate automatically steps up from the first-choice-width value to the highest value until a stable channel is established.
Note The last-choice-width arguement is applicable only to the MC16S card.
Defaults
1,600,000 Hz
Command Modes
Cable interface configuration
Command History
11.3(5)NA This command was introduced. 12.0(4)XI The last-choice-width argument was added.
Release
Modification
Usage Guidelines
The last-choice-width parameter is supported only by the Cisco MC16S cable modem line card. When the Cisco MC16S card is installed, the system attempts to increase the channel width from the first-choice-width value to the last-choice-width value one step at a time.
Examples
The following example configures upstream port 2 with a channel width of 200,000 Hz (which is equivalent to a symbol rate of 160 kilosymbols/second):
router(config-if)# cable upstream 2 channel-width 200000
The following example configures upstream port 3 to step from a channel width of 1,600,000 Hz to a channel width of 3,200,000 Hz in increments of 200,000 Hz:
router(config-if)# cable upstream 3 channel-width 1600000 3200000
Related Commands
cable upstream fec-strength Overrides the FEC setting specified in the modulation profile for an upstream channel. cable upstream hop algorithm Configures the frequency hop algorithm for the upstream port of a cable router. cable upstream modulation Overrides modulation types specified in the modulation profile for the specified upstream channel.
Command
Description
To turn concatenation on or off from the CMTS, use the cable upstream concatenating cable interface configuration command. To turn off concatenation, use the no form of this command.
cable upstream n concatenation
Syntax Description
n Specifies the upstream channel.
Defaults
On
Command Modes
Cable interface configuration
Command History
12.0(7)XR2 This command was introduced.
Release
Modification
Usage Guidelines
Concantenation is part of DOCSIS 1.0 extension support. Concatenation must be supported at both the CMTS and the CM.
DOCSIS concatenation combines multiple upstream packets into one packet to reduce packet overhead and overall latency and increase transmission efficiency. Using concatenation, a DOCSIS cable modem needs to make only one bandwidth request for a concatenated packet, compared to making bandwidth requests for each individual packet. This technique is especially effective for bursty real-time traffic such as voice calls. For improved bandwidth efficiency, both the headend Common Management Information Services (CMTS) and the cable modems must both support DOCSIS concatenation.
Concatenation support improves upstream per cable modem (CM) data throughput. The current Cisco uBR7200 radio frequency (RF) line card driver can only receive one MAC frame in a data burst. Thus the CM must make explicit bandwidth requests for every packet it wishes to send upstream. This limits the maximum upstream data throughput received by the 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 uBR7200 driver has been enhanced to receive a concatenated burst of multiple MAC frames from the same CM.
|
Note Concatenation is no supported on non-ASIC cards. |
To specify automatic or fixed start and stop values for data backoff, use the cable upstream data-backoff command in cable interface configuration mode. To use the default data backoff values, use the no form of this command.
cable upstream usport data-backoff {automatic | start end}
Syntax Description
usport Specifies the upstream port number. automatic Specifies automatic data backoff start and stop values. It enables dynamic variation in the start and end values. start Binary exponential algorithm. Sets the start value for data backoff. Valid values are from 0 to 15. end Binary exponential algorithm. Sets the end value for data backoff. Valid values are from 0 to 15.
Defaults
automatic
Command Modes
Cable interface configuration
Command History
12.1 T This command was introduced.
Release
Modification
Usage Guidelines
The DOCSIS-specified method of contention resolution for cable modems used to send data or requests on the upstream channel is a truncated binary exponential back-off with the initial backoff window and the maximum backoff window controlled by the CMTS. The Cisco uBR7200 series router specifies back-off window values for both data and initial ranging, and sends these values downstream as part of the Bandwidth Allocation Map (MAP) MAC message. The values are power-of-two values. For example, a value of 4 indicates a window between 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.
Examples
The following example shows how to set the automatic data backoff values for port 2:
router(config-if)# cable upstream 2 data-backoff automatic
Related Commands
Specifies automatic or configured initial ranging backoff calculation. cable insertion-interval Configures the interval between consecutive initial ranging slots on an upstream. Displays the backoff window setting for the configured upstream port
Command
Description
To enable differential encoding on upstream traffic to a specified cable interface, use the cable upstream differential-encoding command in cable interface configuration mode. To disable this function, use the no form of this command.
cable upstream usport differential-encoding
Syntax Description
usport Specifies the upstream port number.
Defaults
Enabled
Command Modes
Cable interface configuration
Command History
Cisco IOS Release 12.1 This command was introduced.
Release
Modification
Usage Guidelines
To verify whether or not upstream differential encoding is activated, enter the show running-config command and look for the cable interface configuration information. If upstream differential encoding is enabled, a differential encoding entry is displayed in the show running-config output. If upstream differential encoding is disabled, no differential encoding entry is displayed in the output.
If you are having trouble, make sure that the cable connections are not loose or disconnected; the cable modem card is firmly seated in its chassis slot; the captive installation screws are tight; you have entered the correct slot and port numbers; and you selected a valid frequency for your router.
Examples
The following example shows how to enable differential encodingfor upstream port 2:
Router(config-if)# cable upstream 2 differential-encoding
To enable upstream forward error correction (FEC), use the cable upstream fec command in cable interface configuration mode. To disable FEC, use the no form of this command.
cable upstream usport fec
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card.
Defaults
Enabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
The Cisco uBR7200 series uses forward error correction (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 uBR7200 series commands all cable modems on the network to activate FEC.
Examples
The following example shows how to activate upstream forward error correction:
router (config-if)# cable upstream 0 fec
Related Commands
cable upstream frequency Enters a fixed frequency of the upstream RF carrier for an upstream port. cable upstream power-level Sets the input power level for the upstream RF carrier in decibels per millivolt (dBmV). cable upstream scrambler Enables the cable upstream scrambler. cable upstream shutdown Disables the upstream port.
Command
Description
To override the forward error correction (FEC) setting specified in the modulation profile for this upstream channel, use the cable upstream fec-strength command in cable interface configuration mode. To restore the default value, use the no form of this command.
cable upstream usport fec-strength t-bytes
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. t-bytes Overrides the FEC strength specified in the modulation profile for this upstream channel. Valid values are from 0 to 10, where:
Defaults
No default behavior or values.
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following example shows how to configure the cable upstream fec-strength command:
router(config-if)# cable upstream 2 fec-strength 3
Related Commands
cable upstream fec Enables the upstream FEC. cable upstream channel-width Specifies an upstream channel width for a headend cable router. cable upstream hop algorithm Configures the frequency hop algorithm for the upstream port of a cable router. cable upstream modulation Overrides modulation types specified in the modulation profile for the specified upstream channel.
Command
Description
To control power adjustments on a Cisco uBR7200 series cable router by setting the frequency threshold, use the cable upstream freq-adj averaging interface configuration command. To disable power adjustments, use the no form of this command.
cable upstream n freq-adj averaging % of frequency adjustmentSyntax Description
n | Specifies the upstream port number. |
averaging | Specifies that a percentage of frequency adjustment packets is required to change the adjustment method from the regular power adjustment method to the noise power adjustment method. |
% of frequency adjustment | Specifies the percentage of frequency adjustment packets required to switch from the regular power adjustment method to the noise power adjustment method. Valid range is from 10 to 100%. |
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
12.0(7)T This command was introduced.
Release
Modification
Examples
The following example shows how to change the power adjustment method when the frequency adjustment packet count reaches 50 percent:
Router(config-if)# cable upstream 0 freq-adj averaging 50
Related Commands
cable upstream power-adjust Controls power adjustment methods on the Cisco uBR7200 series cable routers. show cable flap-list Displays a list of cable modems that have exceeded the threshold number of power adjustments. show cable modem Displays cable modem configuration settings.
Command
Description
To enter a fixed frequency of the upstream radio frequency (RF) carrier for an upstream port, use the cable upstream frequency command in cable interface configuration mode. To restore the default value for this command, use the no form of this command.
cable upstream usport frequency up-freq-hz
Syntax Description
usport Specifies the upstream port number on the cable modem card for which you want to assign an upstream frequency. Valid range is 0 to 5 if you are using a Cisco MC16 cable modem card. up-freq-hz The upstream center frequency is configured to a fixed value. The valid upstream frequency range is 5 MHz to 42 MHz (5,000,000 to 42,000,000 Hz). If you wish to have the Cisco uBR7200 series dynamically specify the a center frequency for the given upstream interface, you do not enter any frequency value.
Defaults
Dynamic (not fixed frequency)
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
The upstream channel frequency of your RF output must be set to comply with the expected input frequency of your Cisco cable modem line card. To configure an upstream channel frequency, you may:
To configure the default upstream frequency (which is no fixed frequency), enter the cable upstream usport frequency command without specifying a center frequency.
|
Note The CSCds21565 provides support for spectrum groups on the MC16E card. The use of spectrum groups with the MC16E card is currently not supported. Following resolution of CSCds21565, frequency hopping through the use of spectrum groups will be available on the MC16E card. |
Examples
The following example shows how to configure the upstream center frequency for port 0, located in slot 6, to 5,700,000 Hz:
Router(config-if)# cable upstream 0 frequency 5700000
The following example shows how to allow the Cisco uBR7200 series to dynamically specify a center frequency for the upstream port 0:
Router(config-if)# cable upstream 0 frequency
To configure the frequency hop algorithm for the upstream port, use the cable upstream hop algorithm command in cable interface configuration mode. To configure the optimum algorithm, use the no form of this command.
cable upstream usport hop algorithm {blind | optimum}
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. blind Selects the blind frequency hop algorithm. optimum Selects the optimum hop algorithm.
Defaults
Optimum
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command is supported only on the Cisco MC16S cable modem card.
Examples
The following example shows how to configure the optimum hop algorithm:
router(config-if)# cable upstream 3 hop algorithm optimum
Related Commands
cable upstream channel-width Specifies an upstream channel width for a headend cable router. cable upstream fec-strength Overrides the FEC setting specified in the modulation profile for an upstream channel. cable upstream modulation Overrides modulation types specified in the modulation profile for the specified upstream channel.
Command
Description
To override hop decisions, enter the cable upstream hopping blind interface configuration command. To stop blind hopping, enter the no form of this command.
cable upstream interface number hopping blind
Syntax Description
interface number Specifies the number of the upstream cable interface for which blind frequency hopping will be activated.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
12.0(7)XR2 This command was introduced.
Release
Modification
Usage Guidelines
Enter this command to override the hardware spectrum manager's decision to optimize hopping.
|
Note Do not use this command unless you have a specific reason to disable optimum hopping configurations. For example, if you are experimenting with a Cisco MC16S card, you can use this command to enforce blind hopping on individual upstream channels. |
Examples
The following example shows how to to specify hopping blind on the upstream port 0:
router(config-if)# cable upstream 0 hopping blid
Related Commands
Specifies the center frequency for a given upstream cable interface. Specifies the channel width of the given upstream cable interface. Configures preset modulation profiles that you can apply to one or more upstream cable interfaces when you identify and configure spectrum groups. Specifies the upstream cable interface receive power level in dBmV. Activates or shuts down a specified upstream cable interface. Configures spectrum management characteristics for the given spectrum group.
Command
Description
To specify the minislot size (in ticks) for a specific upstream interface, use the cable upstream minislot-size command in cable interface configuration mode. To set the default minislot size of 8 if this is valid for the current channel width setting, use the no form of this command.
cable upstream usport minislot-size size
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. size Specifies the minislot size in time ticks. Valid minislot sizes are: 2 (32 symbols), 4 (64 symbols), 8 (128 symbols), 16 (256 symbols), 32 (512 symbols), 64 (1024 symbols), and 128 (2048 symbols).
Defaults
The default settings vary, depending on the specified minislot sizes. The minislot size has a range of values between 2 and 128 and default values for these minislot sizes range between 4 and 64.
Command Modes
Cable interface configuration
Command History
11.3(6) NA This command was introduced.
Release
Modification
Usage Guidelines
|
Caution Using values of 64 or 128 for higher symbol rates such as 1280 kilosymbols/second or 2560 kilosymbols/second can cause performance problems. Depending on your current setting's symbol rate, you should select the minislot size (in ticks) that yields a minislot size of 32 or 64 symbols. |
Examples
The following example shows how to set the minislot size on upstream port 4 to 16 (or 256 symbols):
router(config-if)# cable upstream 4 minislot-size 16
To override modulation types specified in the modulation profile for the specified upstream channel, use the cable upstream modulation command in cable interface configuration mode. To disable overriding modulation profiles, use the no form of this command.
cable upstream usport modulation first-choice-mod [last-choice-mod]
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. first-choice-mod Overrides the modulation type specified in the modulation profile for this channel. Valid values are qpsk or qam16. last-choice-mod (Optional) Valid values are qpsk or qam16. Make sure that this parameter is different from the first-choice-mod setting or it will be ignored. When used, this parameter enables modulation management algorithms.
Defaults
first-choice-mod, QPSK
Command Modes
Cable interface configuration
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This feature is only supported on the Cisco MC16S cable modem card.
The Cisco uBR7200 series cable router first attempts to apply the modulation type specified in the first choice parameter. Then the cable router attempts to apply the modulation type specified in the second choice parameter. Whenever possible, the cable router tries to raise the modulation type to qam16.
Examples
The following example shows how to configure the cable upstream modulation command:
router(config-if)# cable upstream 3 modulation qpsk qam16
Related Commands
cable upstream modulation-profile Assigns a modulation profile to an interface on a cable router. cable upstream channel-width Specifies an upstream channel width for a headend cable router. cable upstream fec-strength Overrides the FEC setting specified in the modulation profile for an upstream channel. cable upstream hop algorithm Configures the frequency hop algorithm for the upstream port of a cable router.
Command
Description
To assign a modulation profile to an interface, use the cable upstream modulation-profile interface configuration command. Use the no form of this command to assign the default primary modulation profile (profile #1) to the interface.
cable upstream n modulation-profile primary-profile-number secondary-profile-number
Syntax Description
n Port number on the cable modem slot (port numbers begin with a 0). primary-profile number Default modulation profile added to the interface. secondary-profile number Additional modulation profile added to the interface.
Defaults
Primary modulation profile (profile #1).
Command Modes
Interface configuration
Command History
11.3 NA This command was first introduced. 12.0(7)XR2 This command was used. 12.1(3a)EC This command was modified to add the primary-profile-number and secondary-profile-number.
Release
Modification
Usage Guidelines
You can configure modulation profiles with fixed upstream frequencies or on interfaces with assigned spectrum groups. The dynamic upstream modulation feature uses modulation profiles to track upstream signal quality. It checks that the upstream signal can support the configured modulation scheme, and adjusts to a more robust modulation scheme, if necessary. When return path conditions improve, it returns the upstream channel to the higher modulation scheme.
In Cisco MC16S, when dynamic upstream modulation and spectrum groups are configured on the same interface, the first corrective action is modulation switch-over, then frequency hopping, and finally reduction in channel width.
Examples
The following example shows how to assign the primary modulation profile 2 and the secondary modulation profile 1 to port (interface) 0:
Router(config-if)# cable upstream 0 modulation-profile 2 1
To control power adjustment methods on the Cisco uBR7200 series cable routers, use the cable upstream power-adjust command in interface configuration mode. To disable power adjustments, use the no form of this command.
cable upstream n power-adjust [continue] [noise % of power adjustment] [threshold #]Syntax Description
n | Specifies the upstream port number. |
continue | Specifies the regular power adjustment method (minimum power adjustments). |
noise | Specifies that a percentage of power adjustment packets is required to change the adjustment method from the regular power adjustment method to the noise power adjustment method. |
% of power adjustment | Specifies the percentage of power adjustment packets required to switch from the regular power adjustment method to the noise power adjustment method. Valid range is from 10 to 100%. |
threshold # | Specifies the power adjustment threshold. The threshold range is from 0 to 10dB. |
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
12.0(7)T This command was introduced.
Release
Modification
Examples
The following example shows how to change the power adjustment method when the percentage of power adjustment packets reaches 50 percent:
router(config-if)# cable upstream 0 power-adjust noise 50
Related Commands
cable upstream frequency Configures a fixed frequency of the upstream RF carrier for an upstream port. show cable flap-list Displays a list of cable modems that have exceeded the threshold number of power adjustments. show cable modem Displays cable modem configuration settings.
Command
Description
To set the input power level for the upstream radio frequency (RF) carrier in decibels per millivolt (dBmV), use the cable upstream power-level command in cable interface configuration mode. To restore the default value for this command, use the no form of this command.
cable upstream usport power-level dbmv
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. dbmv Decibels per millivolt designating the upstream signal input power level. Valid range is -10 dBmV to 25 dBmV.
Defaults
0 dBmV
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
The Cisco uBR7200 series controls the output power levels of the cable modems 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). The default setting of 0 dBmV is the optimal setting for the upstream power level.
The valid range for the input power level depends on the data rate. At 1.6 MHz, the valid range is -10 dBmV to 25 dBmV. Higher values cause the modems to increase their transmit power, achieving a greater carrier-to-noise ratio (CNR). If your power levels operate at greater than the maximum valid level, you must use an inline attenuator to bring the power level to within the valid range.
|
Caution If you increase the input power level, the cable modems on your HFC network increase their transmit power level. This might cause an increase in the carrier-to-noise ratio (CNR) on the network. Be careful if you adjust this parameter. You might violate the upstream return laser design parameters. |
You should not adjust your input power level by more than 5 dB in a 30-second interval. If you increase the power level by more than 5 dB within 30 seconds, cable modem service on your network will be disrupted. If you decrease the power level by more than 5 dB within 30 seconds, cable modems on your network will be forced offline.
When you run cable upstream 0 power-level, Cisco recommends that the adjacent channel not have a large variation. The recommended maximum input power variance is 5 to 6 dBmV.
Examples
The following example shows how to set the input power level for upstream port 0 to -5 dBmV:
router(config-if)# cable upstream 0 power-level -5
Related Commands
cable upstream fec Enables the upstream FEC. cable upstream frequency Enters a fixed frequency of the upstream RF carrier for an upstream port. cable upstream scrambler Enables the cable upstream scrambler. cable upstream shutdown Disables the upstream port.
Command
Description
To specify automatic or configured initial ranging backoff calculation, use the cable upstream range-backoff command in cable interface configuration mode. To set default values, use the no form of this command.
cable upstream usport range-backoff {automatic | start end}
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. automatic Specifies the fixed data backoff start and end values. start Binary exponential algorithm. Sets the start value for initial ranging backoff. Valid values are from 0 to 15. end Binary exponential algorithm. Sets the end value for initial ranging backoff. Valid values are from 0 to 15.
Defaults
automatic
Command Modes
Cable interface configuration
Command History
12.1 T This command was introduced.
Release
Modification
Usage Guidelines
The DOCSIS-specified method of contention resolution for cable modems used to send data or requests on the upstream channel is a truncated binary exponential back-off with the initial backoff window and the maximum backoff window controlled by the CMTS. The Cisco uBR7200 series 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. The values are power-of-two values. For example, a value of 4 indicates a window between 0 and 15; a value of 10 indicates a window between 0 and 1023.
The automatic setting is optimized for a maximum of 250 cable modems per upstream port. Set manual values for data backoff windows only when operating with more than 250 cable modems per upstream port.
Examples
The following example shows how to set the range backoff to automatic for upstream port 2:
router(config-if)# cable upstream 2 range-backoff automatic
Related Commands
Specifies automatic or fixed start and stop values for data backoff. cable insertion-interval Configures the interval between consecutive initial ranging slots on an upstream.
Command
Description
To set DOCSIS rate limiting for an upstream port on a cable modem card, use the cable upstream rate-limit command in cable interface configuration mode. To disable DOCSIS rate limiting for the upstream port, use the no form of this command.
cable upstream usport rate-limit [token-bucket [shaping]]
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card. token-bucket shaping (Optional) Enables rate limiting for the specified upstream cable interface using the token bucket policing algorithm. The shaping option enables token bucket shaping.
Defaults
Token bucket algorithm with traffic shaping.
Command Modes
Cable interface configuration
Command History
11.3(6)NA This command was introduced. 11.3(9)NA The shaping keyword was added.
Release
Modification
Usage Guidelines
Upstream rate limiting allows upstream bandwidth requests from rate-exceeding cable modems to be buffered without incurring TCP-related timeouts and retransmits. This enables the Cisco uBR7200 series to enforce the peak upstream rate for each cable modem without degrading overall TCP performance for the subscriber CPEs. Upstream grant shaping is per cable modem (SID).
When the token-bucket algorithm is configured, the Cisco uBR7200 series automatically drops packets in violation of allowable upstream bandwidth.
Use of the default value (the upstream port's rate limit) enforces strict DOCSIS-compliant rate limiting. Cisco highly recommends to using the default setting of token-bucket with the shaping option.
Examples
The following example shows how to configure the token bucket filter algorithm with traffic shaping on upstream port 4:
router(config-if)# cable upstream 4 rate-limit token-bucket
Related Commands
cable downstream rate-limit Enables DOCSIS rate limiting on downstream traffic.
Command
Description
To enable the cable upstream scrambler, use the cable upstream scrambler command in cable interface configuration mode. To restore the default configuration value for this command, use the no form of this command.
cable upstream usport scrambler
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card.
Defaults
Disabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
This command causes cable modems to enable their pseudo-random scrambler circuitry to improve the robustness of the upstream receiver on the line card.
The scrambler on the upstream radio frequency (RF) carrier enables cable modems on the HFC network to use built-in scrambler circuitry for upstream data transmissions. The scrambler circuitry improves reliability of the upstream receiver on the cable modem card. The upstream scrambler is activated by default and should not be disabled under normal circumstances.
|
Caution Scrambler must be activated for normal operation. Deactivate only for prototype modems that do not support scrambler. |
Examples
The following example shows how to activate the upstream scrambler:
router(config-if)# cable upstream 0 scrambler#
Related Commands
cable upstream fec Enables the upstream FEC. cable upstream frequency Enters a fixed frequency of the upstream RF carrier for an upstream port. 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.
Command
Description
To disable the upstream port, use the cable upstream shutdown command in cable interface configuration mode. To enable the upstream port, use the no form of this command.
cable upstream usport shutdown
Syntax Description
usport Specifies the upstream port number. Valid range is from 0 to 5 if you are using a Cisco MC16 cable modem card.
Defaults
Upstream port enabled
Command Modes
Cable interface configuration
Command History
11.3 XA This command was introduced.
Release
Modification
Examples
The following example shows how to disable the upstream port:
router(config-if)# cable upstream 0 shutdown
To enable upstream timing adjustment for a specified cable interface, use the cable upstream timing-adjust cable interface configuration command. To return to the default values, use the no form of this command.
cable upstream usport timing-adjust {continue sec | threshold sec}
Syntax Description
usport Specifies the upstream port number. continue sec Sets the minimum timing adjustment that sets continue ranging status in section. The range for sec is 2 to 64 seconds. Default value is 2 seconds. threshold sec Sets the timing adjustment threshold in seconds. Valid threshold value is 1 to 32 seconds. Default is 1 second.
Defaults
2 seconds for continue and 1 second for threshold.
Command Modes
Cable interface configuration mode
Command History
11.3 NA This command was introduced.
Release
Modification
Usage Guidelines
To verify whether or not upstream timing adjustment is configured and activated, enter the show running-config command and look for the cable interface configuration information. If upstream timing adjustment is enabled, either or both of the continue and threshold timing adjustment entries are displayed in the show running-config output. If both the continue and threshold upstream timing adjustments are disabled, no timing adjustment entry is displayed in the show running-config output.
If you are having trouble, make sure that the cable connections are not loose or disconnected; the cable modem card is firmly seated in its chassis slot; the captive installation screws are tight; and you have entered the correct slot and port numbers.
|
Note The cable timing-adjust command is applicable only on the Cisco 12.1(12)SC and 12.1(3)T Releases. It is deprecated on the 12.1(3a)EC Release. |
Examples
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 upstream time adjustment threshold value to the default of 12 seconds:
CMTS01(config-if)# cable upstream 0 time-adjust threshold 12
To reset the flap-list table for a specific cable modem or for all cable modems connected to the Cisco uBR7200 series, use the clear cable flap-list command in privileged EXEC mode.
clear cable flap-list [mac-addr | all]
Syntax Description
mac-addr (Optional) MAC address. Specify the 48-bit hardware address of an individual cable modem. all (Optional) Remove all cable modems from the flap-list table.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1 T This command was introduced.
Release
Modification
Usage Guidelines
Cable modems are removed from the flap-list table after the number of days (between 1 and 60) specified by the cable flap-list aging global configuration command. Use the clear cable flap-list command to remove individual cable modems from the flap-list while retaining flapping activity for other cable modems, or to clear the entire flap-list table.
Examples
The following example shows how to remove all the cable modems from the flap-list table:
router# clear cable flap-list all
Related Commands
cable flap-list aging Specifies how many days to record and retain flapping activity on a cable modem before aging the cable modem out of the flap-list table. cable flap-list insertion-time Sets the insertion time interval that determines whether a cable modem is placed in the flap-list. cable flap-list miss-threshold Specifies miss threshold for recording a flap-list event. cable flap-list power-adjust threshold Specifies the power-adjust threshold for recording a cable modem flap-list event. cable flap-list size Specifies the maximum number of cable modems reported in the flap-list table.
Command
Description
To clear the host from the table, use the clear cable host command in privileged EXEC mode.
cable host {ip-address | mac-address} [no] access-group {access-list | access-name} |
Syntax Description
ip-address IP address of the host. mac-address MAC address of the host. access-group Enables access-group options. The no form removes access-group specifications. access-list Specifies the IP access list (standard or extended). Valid values are 1 to 199. access-name Specifies the access-list name. vrf vrf-name Specifies route forwarding instance that is populated with virtual private network (VPN) routes. The vrf-name argument specifies the name for the route forwarding instance.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1 T This command was introduced. 12.1(1a)T1 The vrf keyword was added for MPLS VPN support.
Release
Modification
Examples
The following example shows how to remove the PC's MAC address from the router's internal address tables on the Cisco uBR7200 series router:
router# clear cable host 0050.7366.17ab
Related Commands
cable host Configures the access list for the specified host. show cable host Displays the hosts for the cable modem.
Command
Description
To reset the cable modem flapping counters to zero, use the clear cable modem counters command in privileged EXEC mode.
clear cable modem {mac-addr | ip-addr | all} counters
Syntax Description
mac-addr MAC address. Specify the 48-bit hardware address of an individual cable modem. ip-addr IP address. Specify the IP address of an individual cable modem. all Resets the flapping data for all modems.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1 T This command was introduced.
Release
Modification
Examples
The following example show how to clear the counters for the cable modem at IP address 172.00.00.00:
router# clear cable modem 172.00.00.00 counters
Related Commands
Removes a cable modem from the Station Maintenance List and resets the cable modem.
Command
Description
To remove a cable modem from the Station Maintenance List and reset it, use the clear cable modem reset command in privileged EXEC mode.
clear cable modem {mac-addr | ip-addr | all} reset
Syntax Description
mac-addr MAC address. Specify the 48-bit hardware address of an individual cable modem. ip-addr IP address. Specify the IP address of an individual cable modem. all Removes all the cable modems from the Station Maintenance List.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1(2) EC This command was introduced.
Release
Modification
Usage Guidelines
This command causes the link to the cable modem to drop. The cable modem responds by resetting itself. It can take up to 30 seconds for the reset sequence to begin.
Examples
The following example shows how to remove the cable modem at 172.00.00.00 from the Station Maintenance List and causes it to reset:
router# clear cable modem 172.00.00.00 reset
Related Commands
Resets the flapping counters of a cable modem to zero.
Command
Description
To specify the authentication algorithm on a Working CMTS, Protect CMTS, or both use the hccp authenticate interface configuration command. To disable authentication on a Working CMTS or Protect CMTS, use the no form of this command.
hccp group authenticate md5 | text
Syntax Description
group The group number for the specified interface. Valid values are any number from 1 to 255, inclusive. md5 Authentication algorithm. In Cisco IOS Release 12.1(3a)EC, MD5 is the only authentication algorithm supported. text Unencrypted text specification. Rather than automatically encrypting the authentication key-chain when using the MD5 authentication algorithm, Cisco IOS simply passes the authentication key-chain as standard, unencrypted text.
Defaults
The default authentication algorithm is MD5.
Command Modes
Interface configuration
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Usage Guidelines
Use this command in conjunction with the hccp authenticate key-chain command to enable and specify the type of 1+1 redundancy authentication you will use in your protection scheme.
Examples
The following example shows how to specify MD5 as the authentication algorithm for group 1:
router(config-if)# hccp 1 authenticate md5
Related Commands
hccp authenticate key-chain Enables authentication on a given interface and specifies one or more keys that can be used to perform authentication for a specified group.
Command
Description
To enable authentication and define one or more authentication keys to use in a specified group, use the hccp authenticate key-chain interface configuration command. To disable authentication, use the no form of this command. The key chains you define must match one or more key chains configured in the Working CMTS or Protect CMTS's configuration file.
|
Note You cannot perform authentication on a specified group until you have first defined at least one authentication key chain in global configuration mode. |
Syntax Description
group The group number for the specified interface. Valid values are any number from 1 to 255, inclusive. key-chain A text string matching a key chain in the Working CMTS or Protect CMTS's configuration file. A key chain must have at least one key and can have up to 2,147,483,647 keys.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Usage Guidelines
Use this command in conjunction with the hccp authenticate command to enable and specify the type of 1+1 redundancy authentication you will use in your protection scheme.
Examples
The following example enables authentication using the MD5 algorithm and defines the authentication key "cisco1" for group 1:
! key chain cisco1 key 1 key-string abcdefg key 2 key-string 123456789 ! . . . ! interface cable 3/0 hccp 1 authenticate md5 hccp 1 authenticate key-chain cisco1 !
Related Commands
hccp authenticate Specifies the authentication algorithm for the Working CMTS or Protect CMTS. key chain A global configuration command that allows you to define one or more key chains for authentication between Working CMTS or Protect CMTSs. For more specific information, refer to the Cisco IOS Release 12.0 Command Reference Master Index on CCO.
Command
Description
To specify the downstream upconverter module for a Working CMTS or Protect CMTS, use the hccp ds-switch interface configuration command. To negate a downstream upconverter assignment, use the no form of this command.
hccp group ds-switch member make host-ipaddr host-module peer-ipaddr peer-module
Syntax Description
group The group number for the specified interface. Valid values are any number from 1 to 255, inclusive. member The member number within the specified group. make The maker of the specified upconverter. Currently, only the Wavecom upconverter is supported. host-ipaddr The IP address of the upconverter module1 to which the host CMTS is connected. host-module The upconverter module number to which the host CMTS is connected. This location is expressed as a simple numeric designation. peer-ipaddr The IP address of the upconverter module to which the peer (or remote) CMTS is connected. peer-module The upconverter module number1 to which the peer (or remote) CMTS is connected. This location is expressed as a simple numeric designation.
Defaults
Upconverter specification and activation is disabled by default and must be specified before switching can take place.
Command Modes
Interface configuration
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Usage Guidelines
It is necessary to configure the downstream upconverter module for all Protect CMTSs and Working CMTSs. If you do not specify the downstream upconverter module for all Protect CMTSs and Working CMTSs, you cannot switch between a Protect CMTS and Working CMTS.
Examples
The following configuration file example specifies module 2 on a Wavecom upconverter at IP address 1.1.11.3 as the host switch module connected to Working CMTS 1 and module 1 on the same Wavecom upconverter (with the same IP address location) as the peer or remote switch module connected to the Protect CMTS:
hccp 1 working 1 hccp ds-switch 1 wavecom 1.1.11.3 2 1.1.11.3 1
Related Commands
hccp protect Allows you to configure a CMTS to be a Protect CMTS for a specified Working CMTS in a 1+1 redundancy environment. hccp working Allows you to designate a CMTS to be a Working CMTS in a 1+1 redundancy environment.
Command
Description
To prevent a Working CMTS from automatically switching to a Protect CMTS in the same group, use the hccp lockout EXEC command.
|
Note This command is applicable only to Working CMTSs in a given group. Issuing this command on a Protect CMTS has no effect. |
Syntax Description
group The group number for the specified interface. Valid values are any number from 1 to 255, inclusive.
Defaults
By default, the hccp lockout command is inactive.
Command Modes
EXEC
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Usage Guidelines
You might want to prevent a Working CMTS from automatically switching back to a Protect CMTS for testing or additional configuration purposes. For example, you might want to fully test protecting cable interfaces on your Cisco uBR7200 series before returning it to protect status.
Examples
The following example shows how to activate the lockout feature of a Working CMTS in group 1:
router# hccp 1 lockout
Related Commands
hccp unlockout Negates the effects of the hccp lockout EXEC command, making the CMTS available for automatic switchover from a Working CMTS to a Protect CMTS.
Command
Description
To configure a particular cable interface to protect another cable interface in the same group, use the hccp protect interface configuration command. To undo a particular host cable interface protection assignment, use the no form of this command.
hccp group protect member ipaddr
Syntax Description
group The group number of both the Working and Protect cable interfaces. Valid values are any number from 1 to 255, inclusive. member The member number of the specified Working cable interface. Valid values are any number from 1 to 255, inclusive. ipaddr An IP address for any working interface (other than protected cable interfaces) installed in the Working CMTS that can transmit and receive redundancy status messages.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Examples
The following example configures host cable interface 4/0 to protect member 2 of group 2 at IP address 1.1.11.2:
interface cable 4/0 hccp 2 protect 2 1.1.11.2
Related Commands
hccp working Configures a specified cable interface to be a working member of a given group.
Command
Description
To configure a cable interface on a Protect CMTS that has assumed working capacity to automatically revert back to a Protect CMTS for a specified group, use the hccp revert interface configuration command. To disable the ability for the specified cable interface to automatically revert back to protect status, use the no form of this command.
hccp group revert
Syntax Description
group The group number for the specified interface. Valid values are any number from 1 to 255, inclusive.
Defaults
This command is disabled by default.
|
Note This command is disabled by default because some customers may want to perform testing or other such activity on the Protect CMTS's working peer before restoring it to working status. |
Command Modes
Interface configuration
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Usage Guidelines
Using this command in conjunction with the hccp reverttime command gives you the ability to set up your protecting cable interfaces to automatically switch between working and protecting capacity without your intervention. Otherwise, whenever a switchover has occurred, you must manually reactivate the failed Working CMTS and manually return the Protect CMTS to protect status using the hccp switch command.
Examples
The following example configures cable interface 4/0 on a Protect CMTS in group 2 to automatically revert to protect status after the Working CMTS peer has returned to active duty:
interface cable 4/0 hccp 2 revert
Related Commands
hccp reverttime Specifies the time the Working CMTS waits before automatically switching back to a Working CMTS following system failover.
Command
Description
To specify the amount of time a Working CMTS waits before automatically reverting back to a Working CMTS for a specified group following system failover, use the hccp reverttime interface configuration command. To negate a revert-time assignment, use the no form of this command.
hccp group reverttime revert-time
Syntax Description
group The group number for the specified interface. Valid values are any number from 1 to 255, inclusive. revert-time The amount of time (in minutes) that a Working CMTS waits before automatically switching back to a Working CMTS following system failover. The allowable range is 1 to 65,535 minutes, inclusive.
Defaults
The default time a Working CMTS that has experienced a failover waits before automatically switching back to a Working CMTS is 30 minutes.
Command Modes
Interface configuration
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Usage Guidelines
Use this command in conjunction with the hccp revert command on Working CMTSs to specify your own delay intervals for automatic switchover.
Examples
The following example configures cable interface 3/0 on a Working CMTS in group 2 to wait 15 minutes before automatically reverting back to working status after a system failover:
interface cable 3/0 hccp 2 reverttime 15
Related Commands
hccp revert Configures a cable interface on a Protect CMTS in a specified group that has assumed working capacity to automatically revert back to a Protect CMTS.
Command
Description
To manually switch a Protect CMTS with its Working CMTS peer (or vice versa), use the hccp switch EXEC command.
hccp group switch member
Syntax Description
group The group number for the specified interface. Valid values are any number from 1 to 255, inclusive. member The member number for the specified interface. Valid values are any number from 1 to 255, inclusive.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Usage Guidelines
This command overrides any configuration you may have made on your Protect CMTS and Working CMTSs using the hccp revert and hccp reverttime commands. In addition, you can issue the hccp switch command on either a Protect CMTS or a Working CMTS to force it to change places with its peer.
Examples
The following example configures the host Protect CMTS to assume traffic responsibility for member 2 Working CMTS in group 2:
hccp 2 switch 2
Related Commands
hccp lockout Prevents a Working CMTS from automatically switching to a Protect CMTS in the same group. hccp unlockout Negates the effects of the hccp lockout EXEC command, making the CMTS available for automatic switchover from a Working CMTS to a Protect CMTS.
Command
Description
To configure HELLO packet interval and hold time for a specified group on a Protect CMTS, use the hccp timers interface configuration command. To erase your HELLO and hold time configuration and to assume the default values for each parameter, use the no form of this command.
hccp group timers hello-time hold-time |
Note Issuing the no form of this command erases any manual HELLO interval and hold time values and automatically resets them to their default values. |
Syntax Description
group The group number for the specified interface. Valid values are any number from 1 to 255, inclusive. hello-time The HELLO packet interval (in milliseconds) between subsequent HELLO packet transmissions. The acceptable range is 333 to 5,000 milliseconds, inclusive. hold-time The time (in milliseconds) that a Protect CMTS will wait before assuming control of voice traffic for a Working CMTS that has failed to acknowledge a series of HELLO packets. The acceptable range is 1,000 to 25,000 milliseconds, inclusive.
Defaults
The default HELLO interval is 2,000 milliseconds, and the default hold time is 6,000 milliseconds.
Command Modes
Interface configuration
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Examples
The following example configures the HELLO interval and hold time on a Protect CMTS in group 2 to 750 and 3,000 milliseconds, respectively:
hccp 2 timers 750 3000
Related Commands
hccp protect Configures a particular cable interface to protect another peer cable interface in the same group. hccp working Configures a specified cable interface to be a working member of a given group.
Command
Description
To configure a cable interface on a Working CMTS or Protect CMTS to enable automatic failover based on the interface state, use the hccp track interface configuration command. To allow a Working CMTS or Protect CMTS to perform automatic failover based on interface state, use the no form of this command.
hccp group track
Syntax Description
group The group number for the specified interface. Valid values are any number from 1 to 255, inclusive.
Defaults
This command is enabled by default.
Command Modes
Interface configuration
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Usage Guidelines
This command must be used in conjunction with the keepalive IOS command. If no keepalive interval has been configured in the configuration file for the Cisco uBR7200 series, the hccp track command has no affect. Automatic failover occurs if the given interface state moves from "up" to "down."
Examples
The following example enables failover behavior on a CMTS in group 2:
hccp 2 track
Related Commands
keepalive A global configuration command that allows you to specify the keepalive message transmission interval on Working CMTSs or Protect CMTSs. For more specific information, refer to the Cisco IOS Release 12.0 Command Reference Master Index on CCO.
Command
Description
To reverse the effects of the hccp lockout command—that is, to make a Working CMTS available for automatic switchover to Protect CMTS, use the hccp unlockout EXEC command.
|
Note This command is applicable only to Working CMTSs in a given group. Issuing this command on a Protect CMTS has no effect. |
Syntax Description
group The group number for the specified interface. Valid values are any number from 1 to 255, inclusive.
Defaults
By default, the hccp unlockout command is active.
Command Modes
EXEC
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Usage Guidelines
This command reverses the effect of the hccp lockout command. Once you have reconfigured or tested your Protect CMTS, issuing this command manually reintroduce the CMTS back into your 1+1 redundancy protection scheme.
Examples
The following example deactivates the lockout feature of a Working CMTS in group 1:
hccp 1 unlockout
Related Commands
hccp lockout Prevents a Working CMTS from automatically switching to a Protect CMTS in the same group.
Command
Description
To designate a cable interface on a CMTS in the specified group to be a Working CMTS, use the hccp working interface configuration command. To undo a Working CMTS assignment, use the no form of this command.
hccp group working member
Syntax Description
group The group number for the specified interface. Valid values are any number from 1 to 255, inclusive. member The member number for the specified interface. Valid values are any number from 1 to 255, inclusive.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Examples
The following example designates cable interface 4/0 as member number 2 of group 2 as a Working CMTS interface:
interface cable 4/0 hccp 2 working 2
Related Commands
hccp protect Configures a particular cable interface to protect another cable interface in the same group.
Command
Description
To enable the system to insert the cable modem MAC address into a DHCP packet received from a cable modem or host and forward the packet to a DHCP server, use the ip dhcp relay information option in global configuration mode. To disable MAC address insertion, use the no form of this command.
ip dhcp relay information optionSyntax Description
This command has no keywords or arguments.
Defaults
no ip dhcp relay info option
Command Modes
Global configuration
Command History
11.3NA This command was introduced. 12.0 In previous releases, routers running Cisco IOS Release 11.3NA used the cable relay-agent-option command in the cable interface configuration mode. Cisco uBR7200 series routers running Cisco IOS Release 12.0 use the ip dhcp relay information option command in the global configuration mode. 12.0SC This command was modified to configure the cable relay agent option using ip dhcp relay information option.
Release
Modification
Usage Guidelines
This functionality enables a DHCP server to identify the user (cable modem) sending the request and initiate appropriate action based on this information. To insert DHCP relay-agent option fields, use the cable ip dhcp relay information option in global configuration mode.
In Cisco uBR7200 series running Cisco IOS Release 12.0 use the global configuration command ip dhcp relay information option to insert DHCP relay-agent option fields. Previously, routers running Cisco IOS Release 11.3NA used the cable relay-agent-option command.
Cisco IOS Release 12.0SC was built off Cisco IOS Release 11.3NA with additional features such as interface bundling. If you use Cisco Release IOS Release 12.0.7XR2 for concatenation, you should be able to configure the cable relay agent option using the ip dhcp relay information option command.
Examples
The following example shows how to enable the insertion of DHCP relay agent information into DHCP packets:
router(config)# cable ip dhcp relay information option
Related Commands
Specifies a destination IP address for User Datagram Protocol (UDP) broadcast (DHCP) packets. cable dhcp-giaddr Modifies the GIADDR field of DHCPDISCOVER and DHCPREQUEST packets with a Relay IP address before they are forwarded to the DHCP server. Enables the system to insert the cable modem MAC address into a DHCP packet received from a cable modem or host and forward the packet to a DHCP server. Turns on cable modem upstream verification. Enforces the telco-return cable modem to use a specific Dynamic Host Configuration Protocol (DHCP) server. Identifies the IP address of the Dynamic Host Configuration Protocol (DHCP) server that the telco-return cable modem must access. Monitors client retransmissions when address pool depletion occurs.
Command
Description
To monitor client retransmissions when address pool depletion occurs, use the ip dhcp smart-relay in global configuration mode. To disable this function, use the no form of this command.
ip dhcp smart-relaySyntax Description
This command has no keywords or arguments.
Defaults
no ip dhcp smart-relay
Command Modes
Global configuration
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Usage Guidelines
When relay detects excessive retransmissions, it changes the GIADDR, which in turn causes the server to index a different address pool.
Examples
The following example shows how to enable the insertion of DHCP smart relay agent information into DHCP packets:
router(config-if)# cable 6/0 cable ip dhcp smart-relay
Related Commands
Specifies a destination IP address for User Datagram Protocol (UDP) broadcast (DHCP) packets. cable dhcp-giaddr Modifies the GIADDR field of DHCPDISCOVER and DHCPREQUEST packets with a Relay IP address before they are forwarded to the DHCP server. Enables the system to insert the cable modem MAC address into a DHCP packet received from a cable modem or host and forward the packet to a DHCP server. Turns on cable modem upstream verification. Enforces the telco-return cable modem to use a specific Dynamic Host Configuration Protocol (DHCP) server. Identifies the IP address of the Dynamic Host Configuration Protocol (DHCP) server that the telco-return cable modem must access. Enables the system to insert the cable modem MAC address into a DHCP packet received from a cable modem or host and forward the packet to a DHCP server.
Command
Description
To determine whether a specific cable modem is online, use the ping docsis command in privileged EXEC mode.
ping docsis{mac-addr | ip-addr}
Syntax Description
mac-addr MAC address. Specify the 48-bit hardware address of the cable modem. ip-addr IP address. Specify the IP address of the cable modem.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1(1a)T1 This command was introduced.
Release
Modification
Examples
The following example confirms that the cable modem at 172.00.00.00 is connected to the network and is operational:
router# ping docsis 172.00.00.00 Queueing 5 MAC-layer station maintenance intervals, timeout is 25 msec: !!!!! Success rate is 100 percent (5/5)
Table 4 describes the key used for the ping response messages:
.
| Character | Description |
|---|---|
f | The ping message failed. |
. | The ping message timed out without getting a response. |
! | The ping message was successfully sent and a reply is received. |
To display the forwarding table for the specified interface, use the show cable bundle privileged EXEC command.
show cable bundle n forwarding-table
Syntax Description
n Specifies the bundle identifier. Valid range is from 1 to 255. forwarding-table Displays the forwarding table for the specified interface.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release Modification 12.0(7)XR2 This command was introduced.
Examples
Router# show cable bundle 25 forwarding-table MAC address Interface 0050.7366.17ab Cable3/0 0050.7366.1803 Cable3/0 0050.7366.1801 Cable3/0
Table 5 describes the fields shown in the show cable bundle display.
| Field | Description |
|---|---|
MAC address | Media Access Control ID for each interface in the bundle. |
Interface | The cable interface slot and port number. |
Related Commands
cable bundle Creates an interface bundle.
Command
Description
To display clock reference status information for the clock card, use the show cable clock privileged EXEC command.
show cable clockSyntax Description
This command has no keywords or arguments.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1(1a)T1 This command was introduced. 12.1(2)EC1 This command was supported on the EC train.
Release
Modification
Usage Guidelines
|
Note This command is not applicable on the SC train. |
|
Note To support the clock feature set in Voice over IP (VoIP) configurations, a Cisco uBR7246VXR chassis, equipped with a clock card; and a Cisco uBR-MC16S, a Cisco uBR-MC16E, or a Cisco uBR-MC28C cable modem card must be used running 12.1(1a)T1 or higher releases. Only these cable modem cards support the external clock card reference from a clock card to distribute that signal to cable modems (CMs) or set-top boxes (STBs) attached to the specific network segments. Each CM or STB must also support VoIP applications and the clock feature set. The Cisco uBR924, running 12.0(7)T or higher releases, supports clock card feature automatically. |
Examples
The following sample output from the show cable clock command shows both external sources are available and the clock card is providing the clock reference:
Router# show cable clock Clockcard primary input is present Clockcard secondary input is present Cable clock reference is clockcard primary input Cable3/0 Timestamp clock reference is from Clockcard Cable4/0 Timestamp clock reference is from Clockcard
Related Commands
Displays hardware information, register values, and current counters for the cable clock card.
Command
Description
To display the cable modem or the host behind cable modem, use the show cable device privileged EXEC command.
show cable device {ip-address | mac-address} access-group |
Syntax Description
mac-addr MAC address. Specify the 48-bit hardware address of the cable modem. ip-addr IP address. Specify the IP address of the cable modem. access-group Access-group modifiers. vrf vrf-name Specifies routing and forwarding instance that is populated with virtual private network (VPN) routes. The vrf-name argument specifies the name for the route forwarding instance.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
11.NA This command was introduced. 12.1(1a)T1 The vrf keyword was added for MPLS VPN support.
Release
Modification
Examples
The following command displays the access lists assigned to the cable device:
router# show cable device 0010.7b6b.77ed
Related Commands
cable device Configures access list for a cable modem device or host.
Command
Description
To display the cable flap-list on a Cisco uBR7200 series cable router, use the show cable flap-list command in privileged EXEC mode.
show cable flap-list [sort-flap | sort-time]
Syntax Description
sort-flap (Optional) Sort by the number of times the cable modem has flapped. sort-time (Optional) Sort by the most recent time the cable modem is detected to have flapped.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
11.3 NA This command was introduced. 12.0(3)T Ported to the Cisco mainline release.
Release
Modification
Examples
The following example shows the output of the show cable flap-list command:
router# show cable flap-list MAC Address Upstream Ins Hit Miss CRC P-Adj Flap Time 0010.7bb3.fd19 Cable5/0/U1 0 2792 281 0 *45 58 Jul 27 16:54:50 0010.7bb3.fcfc Cable5/0/U1 0 19 4 0 !43 43 Jul 27 16:55:01 0010.7bb3.fcdd Cable5/0/U1 0 19 4 0 *3 3 Jul 27 16:55:01
The following example shows the return for flap-list tables sorted by MAC address and by time:
router# show cable flap-list sort-flap Mac Addr CableIF Ins Hit Miss CRC P-Adj Flap Time .1eab.2c0b C6/0 U0 108 318 27 0 0 108 Sep 10 15:26:56 .1eb2.bb07 C6/0 U0 0 293 31 1 1 1 Sep 10 15:15:49 .7b6b.71cd C6/0 U0 1 288 32 0 0 1 Sep 10 15:12:13 .1eb2.bb8f C6/0 U0 1 295 30 0 0 1 Sep 10 15:11:44 Router# show cable flap-list sort-time Mac Addr CableIF Ins Hit Miss CRC P-Adj Flap Time 00e0.2222.2202 C4/0 U0 464 2069 242 0 421 885 Oct 16 22:47:23 0010.7b6b.57e1 C4/0 U0 0 2475 43 0 1041 1041 Oct 16 22:47:04
Table 6 describes the fields displayed by the show flap-list command.
| Field | Description |
|---|---|
Mac Addr | The customer account or street address. |
CableIF | The physical port, including the upstream port. |
Ins | The number of times the modem comes up and inserts itself into the network. It can indicate intermittent downstream sync loss or DHCP or modem registration problems. |
Hit | The number of times the modem responds to MAC layer keepalive messages. (The minimum hit rate is once per 30 seconds. It can indicate intermittent upstream, laser clipping, or common-path distortion. |
Miss | The number of times the modem misses the MAC layer keep-alive message. An 8 percent miss rate is normal for the Cisco cable modem cards. It can indicate intermittent upstream, laser clipping, or common-path distortion. |
CRC | The number of Cyclic Redundancy Check errors from this modem. It can indicate intermittent upstream, laser clipping, or common-path distortion. |
P-Adj | The number of times the headend instructed the modem to adjust transmit (TX) power more than 3 dB. It can indicate amplifier degradation, poor connections, or thermal sensitivity. |
Flap | The sum of P-Adj and Ins values. Modems with high flap counts will have high SIDs and might not register. |
Time | The most recent time that the modem dropped the connection. |
Related Commands
cable flap-list aging Sets the number of days to keep entries in the flap-list table. cable flap-list insertion-time Sets the insertion time interval. cable flap-list power-adjust threshold Specifies the power-adjustment threshold for recording a flap-list event. cable flap-list size Specifies the maximum number of modems that can be reported to the flap-list table. clear cable flap-list Resets the flap-list table.
Command
Description
To display cable-hop statistics on a Cisco uBR7200 series cable router, use the show cable hop command in EXEC mode.
show cable hop [cable-if] [upstream portnum]
Syntax Description
cable-if (Optional) Specifies the cable interface. upstream portnum (Optional) Specifies the upstream port for which you wish to display the frequency hop status.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following examples show output from the show cable hop and show cable hop upstream commands.
ubr7200# show cable hop
Upstream Port Poll Missed Min Missed Hop Hop Corr Uncorr
Port Status Rate Poll Poll Poll Thres Period FEC FEC
(ms) Count Sample Pcnt Pcnt (sec) Errors Errors
Cable4/0/U0 down 1000 * * * frequency not set * * * 0 0
Cable4/0/U1 down 1000 * * * frequency not set * * * 0 0
Cable4/0/U2 down 1000 * * * frequency not set * * * 0 0
Cable4/0/U3 down 1000 * * * frequency not set * * * 0 0
Cable4/0/U4 down 1000 * * * frequency not set * * * 0 0
Cable4/0/U5 down 1000 * * * frequency not set * * * 0 0
Cable5/0/U0 down 1000 * * * interface is down * * * 0 0
Cable5/0/U1 down 1000 * * * frequency not set * * * 0 0
Cable5/0/U2 down 1000 * * * interface is down * * * 0 0
Cable5/0/U3 down 1000 * * * interface is down * * * 0 0
Cable5/0/U4 down 1000 * * * interface is down * * * 0 0
Cable5/0/U5 down 1000 * * * interface is down * * * 0 0
Cable6/0/U0 down 1000 * * * interface is down * * * 0 0
CMTS-ubr7223# show cable hop c2/0 upstream 2
Upstream Port Poll Missed Min Missed Hop Hop Corr Uncorr
Port Status Rate Poll Poll Poll Thres Period FEC FEC
(ms) Count Sample Pcnt Pcnt (sec) Errors Errors
Cable2/0/U2 admindown 1000 * * * frequency not set * * * 0 0
Table 7 describes the fields shown in the
show cable hop and show cap hop upstream examples.
| Field | Description |
|---|---|
Upstream Port | The upstream port for this information line. |
Port Status | Lists the status of the port. Valid states are down if frequency is unassigned or admindown if the port is shut down. If the port is up, this column shows the center frequency of the channel. |
Poll Rate | The rate that station maintenance polls are generated (in milliseconds). |
Missed Poll Count | The number of missing polls. |
Min Poll Sample | The number of polls in the sample. |
Missed PollPcnt | The ratio of missing polls to the number of polls, expressed as a percentage. |
Hop Thres Pcnt | The level that the missed poll percentage must exceed to trigger a frequency hop, expressed as a percentage. |
Hop Period | The maximum rate that frequency hopping will occur (in seconds). |
Corr FEC Errors | The number of correctable forward error corrections (FEC) errors on this upstream port. FECs measure noise. |
Uncorr FEC Errors | The number of uncorrectable FEC errors on this upstream port. |
Related Commands
show cable modem Displays cable modem configuration settings. show cable host Displays the statistics for the host behind the cable modem.
Command
Description
To display the host for the cable modem, use the show cable host privileged EXEC command.
show cable host{ip-address | mac-address} access-group |
Syntax Description
mac-addr MAC address. Specify the 48-bit hardware address of the cable modem. ip-addr IP address. Specify the IP address of the cable modem. access-group Access-group modifiers. vrf vrf-name Specifies routing and forwarding instance that is populated with virtual private network (VPN) routes. The vrf-name argument specifies the name for the route forwarding instance.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
11.NA This command was introduced. 12.1(1a)T1 The vrf keyword was added for MPLS VPN support.
Release
Modification
Examples
The following command displays the access lists assigned to the cable host:
router# show cable device 0010.7b6b.77ed
Related Commands
cable host Configures the access list for the specified hosts. clear cable host Clears the host from the table.
Command
Description
To view configuration settings on the Cisco uBR7200 series cable router, use the show cable command in privileged EXEC mode.
show cable modem [ip-address | interface | mac-address] [detail | maintenance | offline | registered | remote-query | summary | unregistered | access-group | errors | connectivity | phy | mac]
Syntax Description
ip-address The IP address of the specified modem. interface Specifies the head-end cable interface to display modem information. mac-address The MAC address of the specified modem. detail Displays detailed information on modems. maintenance Displays the Station Maintenance Error Statistics report. offline Displays information about connected modems that are offline. registered Displays information about registered modems. remote-query Displays modem information gathered by the Simple Network Management Protocol (SNMP) agent. summary Displays information about all the modems connected to this interface. unregistered Displays information about unregistered modems. access-group Displays access-group information.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
11.3XA This command was introduced. 11.3(5)NA Output was reorganized and the Receive Power field was added. 12.0(3)T Ported to the Cisco mainline release. 12.0(4)XI Output was expanded to show primary service identifier (SID) and customer premises equipment (CPE) count. 12.0(5)T Was ported to the mainline release. 12.0(7)XR Offline status was added. 12.0(7)T Detail option was added.
Release
Modification
Usage Guidelines
This command displays information on all cable modems on the network or on the particular cable modem you specify.
Examples
The following is sample output from the show cable modem command:
ubr7200# show cable modem
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
Cable2/0/U0 1 online 2288 0.50 4 0 172.16.30.66 0010.7bb3.fb45
Cable2/0/U0 2 online 2288 0.50 4 0 172.16.30.68 0010.7bb3.fb7b
Cable2/0/U0 3 init(i) 2280 0.00 2 0 172.16.30.69 0010.9500.05e
See the following sample of detailed output from the show cable modem command:
router# show cable modem detail Interface SID MAC address Max CPE Concatenation Rx SNR Cable3/0/U0 1 0090.8330.0215 3 yes ----- Cable3/0/U0 2 0090.8330.0213 3 yes ----- Cable3/0/U0 3 0090.8330.0214 3 yes ----- Cable3/0/U0 4 0090.8330.0217 3 yes ----- Cable3/0/U0 5 0090.8330.020f 3 yes ----- Cable3/0/U0 6 0050.7366.17e3 3 no ----- Cable3/0/U0 7 0090.8330.0211 3 yes ----- Cable3/0/U0 8 0050.7366.17af 3 no ----- Cable3/0/U0 9 0090.8330.0216 3 yes ----- Cable3/0/U0 10 0050.7366.1801 3 no ----- Cable3/0/U0 11 0050.7366.124d 3 no ----- Cable3/0/U0 12 0050.7366.1241 3 no ----- Cable3/0/U0 13 0050.7366.17db 3 no ----- Cable3/0/U0 14 0050.7366.1239 3 no ----- Cable3/0/U0 15 0050.7366.17ab 3 no ----- Cable4/0/U0 1 0050.7366.1db1 3 no 26.50 Cable4/0/U1 2 0050.7318.e97f 3 no 23.87 Cable4/0/U1 3 0050.7318.e965 3 no 23.85 Cable4/0/U0 4 0050.7318.e931 3 no 26.72 Cable4/0/U1 5 0050.7318.e92d 3 no 23.31 Cable4/0/U1 6 0050.7318.e97b 3 no 23.85 Cable4/0/U0 7 0050.7366.1d8d 3 no 26.88 Cable4/0/U0 8 0050.7318.e953 3 no 26.54 Cable4/0/U1 9 0050.7366.1d9d 3 no 23.72 Cable4/0/U1 10 0050.7318.e96b 3 no 23.79 Cable4/0/U1 11 0050.7366.1d95 3 no 23.82 Cable4/0/U0 12 0050.7318.e93f 3 no 26.26 Cable4/0/U1 13 0050.7318.e96d 3 no 23.51 Cable4/0/U0 14 0050.7318.e941 3 no 26.69 Cable4/0/U0 15 0050.7366.1dcd 3 no 26.94 Cable4/0/U1 16 0050.7318.e939 3 no 23.98 Cable4/0/U0 17 0050.7366.1d8f 3 no 27.13 Cable4/0/U0 18 0050.7302.3da3 3 no 26.58 Cable4/0/U0 19 0050.7318.e93b 3 no 26.49 Cable4/0/U0 20 0050.7318.e901 3 no 26.68 Cable4/0/U1 21 0050.7366.1dbb 3 no 23.45 Cable4/0/U0 22 0050.7318.e957 3 no 26.35 Cable4/0/U0 23 0050.7318.e985 3 no 26.40 Cable4/0/U0 24 0050.7366.1dbd 3 no 26.69
See the following sample output of modems connected on upstream channel 0 for cable interface slot 3, port 0:
router# show cable modem cable 3/0 upstream 0
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
Cable3/0/U0 1 offline 2264 -0.50 2 0 209.165.200.2 0090.8330.0214
Cable3/0/U0 2 offline 4137 !-3.50 2 0 209.165.200.9 0050.7366.17d3
Cable3/0/U0 3 init(d) 4136 !-2.50 2 0 209.165.200.0 0050.7366.17ab
Cable3/0/U0 4 init(d) 4138 !-4.75 2 0 209.165.200.0 0050.7366.1803
Cable3/0/U0 5 init(d) 4137 !-2.25 2 0 209.165.200.0 0050.7366.1801
Cable3/0/U0 6 init(o) 2251 -0.25 2 0 209.165.200.3 0090.8330.0213
Cable3/0/U0 7 offline 2264 0.75 2 0 209.165.200.4 0090.8330.020f
Cable3/0/U0 8 offline 2266 -0.50 2 0 209.165.200.5 0090.8330.0211
Cable3/0/U0 9 init(rc) 4662 1.00 2 0 209.165.200.0 00d0.bad3.c459
See the following sample output of registered modems connected on upstream channel 0 for cable interface 3, port 0:
router# show cable modem cable 3/0 upstream 0 registered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
See the following sample output of unregistered modems connected on upstream channel 0 for cable interface 3, port 0:
router# show cable modem cable 3/0 upstream 0 unregistered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
Cable3/0/U0 1 offline 2264 -0.50 2 0 209.165.200.2 0090.8330.0214
Cable3/0/U0 2 offline 4137 !-3.50 2 0 209.165.200.9 0050.7366.17d3
Cable3/0/U0 3 init(d) 4136 !-2.75 2 0 209.165.200.0 0050.7366.17ab
Cable3/0/U0 4 init(d) 4137 !-3.25 2 0 209.165.200.0 0050.7366.1803
Cable3/0/U0 5 init(d) 4141 !-2.75 2 0 209.165.200.0 0050.7366.1801
Cable3/0/U0 6 offline 2251 -0.25 2 0 209.165.200.3 0090.8330.0213
Cable3/0/U0 7 offline 2254 -1.00 2 0 209.165.200.4 0090.8330.020f
Cable3/0/U0 8 offline 2248 0.00 2 0 209.165.200.5 0090.8330.0211
Cable3/0/U0 9 init(rc) 4665 -0.50 2 0 209.165.200.0 00d0.bad3.c459
See the following sample output of offline modems connected on upstream channel 0 for cable interface 3, port 0:
router# show cable modem cable 3/0 upstream 0 offline
Interface MAC address Prim Previous Offline Rx Rx SM
Sid State Time Power SNR Exhaust
Count
Cable3/0/U0 0050.7366.17d3 2 init(o) Jan 16 20:30:26 !-3.50 ----- 1
Cable3/0/U0 0090.8330.0213 6 init(o) Jan 16 20:30:55 -0.25 ----- 181
Cable3/0/U0 0090.8330.020f 7 init(o) Jan 16 20:31:07 -1.00 ----- 181
Cable3/0/U0 0090.8330.0211 8 init(o) Jan 16 20:31:23 0.00 ----- 181
See the following sample output of status display information gathered by the SNMP agent:
router# show cable modem remote-query
IP address MAC address S/N US DS Tx Timing Micro (dB) Modem
Ratio Power Power Offset Reflection State
209.165.200.31 0010.7bed.9c2d 35.2 35.0 0.0 12458 0 online
209.165.200.9 0010.7bed.9c3d 34.5 35.0 0.0 12458 0 online
209.165.200.4 0010.7bed.9cf3 36.6 36.0 0.0 12458 0 online
209.165.200.40 0010.7bed.9cb5 35.9 36.0 0.0 12458 0 online
209.165.200.33 0010.7bed.9cb3 36.6 36.0 0.0 12462 0 online
209.165.200.52 0010.7bed.9cf9 36.6 36.0 0.0 12457 0 online
209.165.200.51 0010.7bed.9d13 37.4 35.0 0.0 12457 0 online
209.165.200.53 0010.7bed.9c93 35.9 36.0 0.0 12462 0 online
209.165.200.19 0010.7bed.9ca7 35.9 36.0 0.0 12459 0 online
209.165.200.24 0010.7bed.9ce1 36.6 36.0 0.0 12461 0 online
209.165.200.34 0010.7bed.9d83 36.6 36.0 0.0 12460 0 online
209.165.200.45 0010.7bed.9c99 36.6 36.0 0.0 12458 0 online
Table 8 describes the fields shown in the show cable modem example.
| Field | Description |
|---|---|
Interface | The interface on which the cable modem has an active connection. |
Prim Sid | The primary service identifier assigned to the modem. |
SID | The service identifier assigned to a modem. |
Online State | The status of the modem. |
Timing Offset | The cable modem's current timing adjustment. |
Rec Power | The nominal receive power in decibels for this SID. * means the noise power adjustment method is active for this modem. ! means the modem has reached its maximum transmit power. |
QoS | The service cass assigned to the modem. |
CPE | The number of customer premises equipment devices (PCs, Macintoshes, Unix workstations, etc.) behind this cable modem. |
Max CPE | The maximum number of customer premises equipment configured for this modem. |
IP address | The IP address of the modem. |
MAC address | The media access layer address of the modem. |
Concatenation | The status of concatenation. You can enable it (yes) or disable it (no). For more information, see Configuring Concatenation on the Cisco uBR7200 Series Cable Router. |
Rx SNR | The receive signal-to-noise ratio level in dBmV as perceived by the cable modem. This parameter is meaningful only for cable modems. A CMTS returns return a zero. For offline modems, the signal-to-noise ratio before going offline. |
S/N Ratio | For remote-queried modems. Same as Rx SNR. |
US Power | The transmit power-level for the upstream channel in dBmVs. |
DS Power | The received power level at the downstream modem, in dBmVs. If power level measurement is not supported, set this parameter to zero. Also, if the interface is down, this value will be the CMTS-configured value, the most current cable modem value, or zero. |
Tx Timing Offset | The current round-trip time at the cable modem. Used to synchronize upstream transmissions to the CMTS. Measured in units of 6.25 microseconds/64. |
Micro (dB) Reflection | Total microreflections including in-channel response as perceived on this interface, measured in dBc below the signal level. This object is not assumed to return an absolutely accurate value, but gives a rough indication of microreflections received on this interface. |
Modem State | The status of the modem when it was last polled. Possible states are: init(o)—option file transfer was started init(t)—time-of-day (TOD) exchange was started init(r1)—modem sent initial ranging init(r2)—modem is ranging init(rc)—ranging is complete init(d)—Dynamic Host Configuration Protocol (DHCP) request was received init(i)—DHCP reply was received; IP address assigned online—modem registered; enabled for data online(d)—modem registered but network access for the CM is disabled online(pk)—modem registered; baseline privacy interface (BPI) enabled, and key encryption key (KEK) is assigned online(pt)—modem registered; BPI enabled, and traffic encryption key (TEK) is assigned reject(m)—modem did attempt to register; registration was refused due to bad mic reject(c)—modem did attempt to register; registration was refused due to bad COS reject(pk)—KEK modem key assignment is rejected reject(pt)—TEK modem key assignment is rejected offline—modem is considered to be offline. Offline Time—Time the modem went offline. The format is same as other |
Offline Time | For offline modems, the time the modem went offline. |
Previous State | For offline modems, the status prior to going offline. See Modem State for definitions. |
Rx Power | For offline modems, the last receive power measurement before going offline. |
SM Exhaust Count | The number of times the CMTS declared that modem to be offline. The modem could be marked offline due to various reasons (modem went dead, modem has not been active for a while, and so on.) |
Related Commands
show cable burst-profile Displays the upstream data burst profiles used to configure the upstream PHY. Displays modulation profile group information. Displays cable interface information.
Command
Description
To display modulation profile group information for a Cisco uBR7200 series cable router, use the show cable modulation-profile command in privileged EXEC mode.
show cable modulation-profile [profile] [iuc-code]
Syntax Description
profile (Optional) Profile number. Valid values are from 1 to 8. iuc-code (Optional) Internal usage code. Valid options are: initial—Initial Ranging Burst
long—Long Grant Burst
request—Request Burst
short—Short Grant Burst
station—Station Ranging Burst
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
This command displays modulation profile group information. A modulation profile is a collection of six burst profiles that are sent out in an upstream channel descriptors (UCDs) message to configure cable modem transmit parameters for the following upstream message types: request, initial maintenance, station maintenance, short grant, and long grant.
Examples
The following is sample output from the show cable modulation-profile command:
CMTS01# show cable modulation-profile 1Mo IUC Type Preamb Diff FEC FEC Scrambl Max Guard Last Scrambl Preamb
length enco T CW seed B time CW offset
bytes size size size short1 request qpsk 64 no 0x0 0x10 0x152 1 8 no yes 56
1 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0
1 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0
1 short qpsk 72 no 0x5 0x4B 0x152 0 8 no yes 48
Table 9 describes the fields shown in the show cable modulation-profile display.
.
| Field | Description |
|---|---|
Mo | Modulation profile group number. A modulation profile group is the set of burst profiles that define upstream transmit characteristics for the various types of upstream transmission classes. |
IUC | Interval usage code. Each upstream transmit burst belongs to a class that is given a number called the interval usage code (IUC). Bandwidth maps messages (MAP) by IUC codes used to allocate upstream time slots. The following types are currently defined:
|
Type | Modulation type. |
Preamb length | Preamble length. |
Diff enco | Differential encoding enabled (yes) or not enabled (no). |
FEC T bytes | Number of bytes that can be corrected for each forward error code (FEC) code word. |
FEC CW size | Size, in bytes, of the FEC code word. |
Scrambl seed | Scrambler seed value in hex format. |
Max B size | Maximum burst size. |
Guard time size | Time between successive bursts measured in symbols. |
Last CW short | Handling of FEC for shortened last code word. |
Scrambl | Scrambler enabled (yes) or not enabled (no). |
Preamb offset | The bits to be used for the preamble value. |
Related Commands
show cable burst-profile Displays the upstream data burst profiles used to configure the upstream PHY. Displays cable modem configuration settings. Displays cable interface information.
Command
Description
To display cable-noise statistics on a Cisco uBR7200 series cable router, use the show cable noise command in EXEC mode.
show cable slot/port noise
Syntax Description
slot/port Specifies the slot and port number for which information is to be displayed.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.0(4)XI This command was introduced.
Release
Modification
Usage Guidelines
This command is not applicable on the Cisco 12.1(3a)EC Release.
Examples
The following example shows how to display cable modem noise statistics:
ubr7223# show cable 6/0 noise
Related Commands
show cable modem Displays cable modem configuration settings.
Command
Description
To display baseline privacy information, use the show cable privacy Privileged EXEC command.
show cable privacy {tek | kek}
Syntax Description
tek Traffic encryption key. kek Key encryption key.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
This command is used in baseline privacy interface (BPI) images only.
Examples
The following are sample outputs for the show cable privacy command:
router#show cable privacy tek Configured TEK life-time value = 56000 Configured TEK grace-time value = 900router#show cable privacy kek Configured KEK life-time value = 750000 Configured KEK grace-time value = 800
Table 10 describes the fields shown in the show cable privacy displays.
| Field | Description |
|---|---|
Configured TEK life-time value = | Number of seconds defining the length of the traffic encryption life-time. Valid range is 1,800 to 6,048,000 seconds. Default is 43,200 seconds. |
Configured TEK grace-time value = | Number of seconds defining the length of traffic encryption grace-time. Valid range is 300 to 1,800 seconds. Default is 600 seconds. |
Configured KEK life-time value = | Number of seconds defining the length of the key encryption life-time. Valid range is 86,400 to 6,048,000. Default is 604,800 seconds. |
Configured KEK grace-time value = | Number of seconds defining the length of key encryption grace-time. Valid range is 300 to 1,800 seconds. Default is 600 seconds. |
Related Commands
show cable modem Displays the cable modem configuration settings. show modulation-profile Displays the modulation profile configuration settings. show cable qos Displays the quality-of-service settings. show cable spectrum-group Displays the spectrum group settings.
Command
Description
To display the status of permissions for changing quality-of-service (QoS) tables on a Cisco uBR7200 series cable router, use the show cable qos permission command in privileged EXEC mode.
cable qos permissionSyntax Description
This command has no keywords or arguments.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1 T This command was introduced.
Release
Modification
Examples
The following example displays the output of the show cable qos permission command:
CMTS01# show cable qos permission Create by SNMP Update by SNMP Create by modems yes yes yes
Table 11 describes the fields shown in the show cable qos permission displays.
| Field | Description |
|---|---|
Create by SNMP | Indicates permission setting for creation of QoS table entries by the Simple Network Management Protocol (SNMP). |
Update by SNMP | Indicates permission setting for creation of QoS table entries by modem registration requests. |
Create by modems | Indicates permission setting for dynamic updating of QoS table entries by the SNMP. |
Related Commands
Sets the amount of time a dynamic service-flow can be present in the system without any activity. cable qos permission Specifies permission for updating the cable router QoS table. cable qos profile Configures a QoS profiles. Displays cable router QoS profiles.
Command
Description
To display quality-of-service (QoS) profiles for a Cisco uBR7200 series cable router, use the show cable qos profile command in privileged EXEC mode.
show cable qos profile profile-index [verbose]
Syntax Description
profile-index Displays cable QoS table. Valid range is 1 to 255. verbose Displays detail information about the quality-of-service profiles.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
11.3NA This command was introduced. 12.0(3)T The command was included in the mainline release. 12.0(7)XR The verbose option was added.
Release
Modification
Examples
The following example displays the QoS tables for profiles 1, 2, 3, and 4:
Router# show cable qos profile
Service Prio Max Guarantee Max Max tx TOS TOS Create B
class upstream upstream downstream burst mask value by priv
bandwidth bandwidth bandwidth enab
1 0 0 0 0 0 0x0 0x0 cmts no
2 0 64000 0 1000000 0 0x0 0x0 cmts no
3 0 1000 0 1000 0 0x0 0x0 cmts no
4 7 2000000 100000 4000000 0 0x0 0x0 cm yes
The following example displays detail output for profile 1:
Router# show cable qos profile vebose ylu-hccp-server#show cable qos profile verbose Profile Index 1 Name Default Upstream Traffic Priority 0 Upstream Maximum Rate (bps) 0 Upstream Guaranteed Rate (bps) 0 Unsolicited Grant Size (bytes) 0 Unsolicited Grant Interval (usecs) 0 Upstream Maximum Transmit Burst (bytes) 0 IP Type of Service Overwrite Mask 0x0 IP Type of Service Overwrite Value 0x0 Downstream Maximum Rate (bps) 0 Created By cmts(r) Baseline Privacy Enabled no
Table 12 describes the fields shown in the show cable qos profile displays.
| Field | Description |
|---|---|
Service Class | Profile number. |
Prio | Priority level. |
Max upstream bandwidth | Maximum upstream bandwidth. |
Guarantee upstream bandwidth | Guaranteed minimum upstream bandwidth. |
Max downstream bandwidth | Maximum downstream bandwidth. |
Max tx burst | Maximum transmit burst size in minislots. |
Tos mask | Hex value of the mask bits. |
Tos value | Value of the mask byte. |
Create by | Identity of the profile creator. |
B priv enab | Reports yes if baseline privacy is enabled for this QoS profile. Reports no if baseline privacy is not enabled for this QoS profile. |
Related Commands
Sets the amount of time a dynamic service-flow can be present in the system without any activity. cable qos permission Configures permissions for updating the QoS table. cable qos profile Displays QoS profiles. Displays the status of permissions for changing QoS tables.
Command
Description
To display information about spectrum groups on a Cisco uBR7200 series cable router, use the show cable spectrum-group command in privileged EXEC mode.
show cable spectrum-group [groupnum]
Syntax Description
groupnum (Optional) Displays information about the specified group number. If no group number is specified, information for all spectrum groups is displayed.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1 T This command was introduced.
Release
Modification
Examples
The following is sample output from the show cable spectrum-group command for the upstream spectrum group named sales:
CMTS01# show cable spectrum-group sales Spectrum Frequency Band Upstream Time Time Input Shared Group (MHz) Port Available Delete PowerLevel Topology 4 5.000-40.000 5 N 4 5.000 5 N 4 5.000-40.000 Mon 12:00:00 Mon 12:00:00 5 N 4 5.000 Mon 12:00:00 5 N
Table 13 describes the fields shown in the show cable spectrum-group displays.
| Field | Description |
|---|---|
Spectrum-Group | Identifies the spectrum group. |
Frequency Band (MHz) | Identifies the upper and lower ranges of the frequency for this spectrum group. |
Upstream Port | Identifies the upstream port number. |
Time Available | Identifies the day and time of day when this group is available. |
Time Delete | Identifies the day and time of day when this group will be deleted. |
Input PowerLevel | Identifies the assigned decibels per millivolt (dBmV) input level. |
Shared Topology | Indicates if upstreams are physically combined (share the same combiner group). Y or yes values indicate that upstreams that are members of the spectrum group are combined and cannot be assigned overlapping frequency bands. N or no values indicate that upstreams that are members of the spectrum group are not combined and can be assigned overlapping frequency bands. |
Related Commands
show cable burst-profile Displays the upstream data burst profiles used to configure the upstream PHY. Displays cable modem configuration settings. Displays modulation profile group information.
Command
Description
To display information about the interface controllers for a specific cable modem card slot in a Cisco uBR7200 series cable router, use the show controllers cable command in privileged EXEC mode.
show controllers cable slot/port [downstream | upstream [port]]
Syntax Description
slot/port Slot number/port number indicating the location of the Cisco cable modem card. downstream (Optional) Displays downstream interface status. upstream (Optional) Displays upstream interface status. port (Optional) Selects specific upstream port.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
11.3 XA This command was introduced. 12.0(2)XC This command was modified.
Release
Modification
Examples
The following is sample output from the show controllers cable upstream command for the cable modem located in slot 4, port 0:
CMTS01# show controllers cable 4/0 upstream 2 Cable4/0 Upstream 2 is administratively down Frequency 5.008 MHz, Channel Width 0.200 MHz, QPSK Symbol Rate 0.160 Msps Spectrum Group 4 Nominal Input Power Level 5 dBmV, Tx Timing Offset 0 Ranging Backoff Start 16, Ranging Backoff End 16, Tx Backoff Start 16 Tx Backoff End 16, Modulation Profile Group 1 part_id=0x3137, rev_id=0x01, rev2_id=0xFF nb_agc_thr=0x0000, nb_agc_nom=0x0000 Range Load Reg Size=0x58 Request Load Reg Size=0x0E Minislot Size in number of Timebase Ticks is = 8 Minislot Size in Symbols =8 Bandwidth Requests = 0x0 Piggyback Requests = 0x0 Invalid BW Requests= 0x0 Minislots Requested= 0x0 Minislots Granted = 0x0 Minislot Size in Bytes = 2 UCD Count = 0 DES Ctrl Reg#0 = C00C0C43, Reg#1 = 0
Table 14 describes the fields shown in the show controllers cable upstream display.
| Field | Description |
|---|---|
Cable | Slot number/port number indicating the location of the Cisco cable modem card. |
Upstream is administratively down | Indicates the RF upstream interface is disabled. |
Frequency | Transmission frequency of the RF upstream channel. |
Channel Width | Indicates the width of the RF upstream channel. |
QPSK Symbol Rate | Indicates the modulation technique for upstream transmission. |
Spectrum Group 4 | Indicates the spectrum group associated with this slot and port. |
Nominal Input Power level | Indicates the desired power level coming into the receiver. |
Tx Timing Offset | Indicates the current ranging offset on the channel. |
Ranging Backoff Start | Indicates how many ranging slots to back off before resending the ranging bursts after an upstream collision. Expressed as exponents of 2. See Ranging Backoff End. |
Ranging Backoff End | Indicates how many ranging slots to back off before resending the ranging bursts after an upstream collision. Expressed as exponents of 2. See Ranging Backoff Start. |
Tx Backoff Start | Indicates the starting exponential backoff value for data collisions. |
Tx Backoff End | Indicates the ending exponential backoff value for data collisions. |
Modulation Profile Group | A set of burst profiles defining an upstream range. |
part_id= | The part number of the Phy chip. FFFF means the PHY chip is turned off. |
rev_id= | The PHY chip revision number. |
rev2_id= | The PHY chip subrevision number. |
nb_agc_thr= | Threshold used to control gain. |
nb_agc_nom= | Used to accelerate convergence of input power level. |
Range Load Reg Size= | Size, indicated by number of symbols, for range request bursts. |
Request Load Reg Size= | Size, indicated by number of symbols, for request bursts. |
Minislot Size in number of Timebase Ticks is | Size in tick units of upstream minislot. A tick is 6.25 microseconds. |
Minislot Size in Symbols | Size in symbols of the upstream minislot. |
Bandwidth Requests | Number of successful bandwidth requests received in the contention minislots. |
Piggyback Requests | Number of successful bandwidth requests piggybacked with regular data transmissions. |
Invalid BW Requests | Number of invalid bandwidth (BW) requests. (An example of an invalid bandwidth request is a modem using a nonexistent service identifier (SID) to request bandwidth. |
Minislots Requested | Total number of minislots requested. |
Minislots Granted | Total number of minislots granted. |
Minislot Size in Bytes | Size of the minislot in bytes. |
UCD Count | Number of Upstream Channel Descriptors (UCDs) sent for this upstream. |
DES Ctrl Reg # = | Interval data encryption standard (DES) controller register dump. |
The following is sample output for the downstream connection for slot 3 on port 0 from the show controllers cable downstream command:
CMTS01# show controllers cable 3/0 downstream Cable 3/0 Downstream is up Frequency not set, Channel Width 6 MHz, 64-QAM, Symbol Rate 5.056941 Msps FEC ITU-T J.83 Annex A, R/S Interleave I=12, J=17
Table 15 describes the fields shown in the show controllers cable downstream display.
| Field | Description |
|---|---|
Cable | Slot number/port number indicating the location of the Cisco cable modem card. |
Downstream is up | Indicates the radio frequency (RF) downstream interface is enabled. |
Frequency | Transmission frequency of the RF downstream. (This information may not match the current transmission frequency, which is external to uBR.) |
Channel Width | Indicates the width of the RF downstream channel. |
QAM | Indicates the modulation scheme. |
Symbol Rate | Indicates the transmission rate (in number of symbols per second). |
FEC ITU-T | Indicates the Motion Picture Experts Group (MPEG) framing standard. |
R/S Interleave I/J | Indicates Reed Solomon framing based on ITU S.83-B. |
Related Commands
Displays information about interface controllers for a specific cable access router card slot.
Command
Description
To display hardware information, register values, and current counters for the cable clock card, use the show controllers clock-reference privileged EXEC command.
show controllers clock-referenceSyntax Description
This command has no keywords or arguments.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1(1a)T1 This command was introduced.
Release
Modification
Usage Guidelines
To reset the counters that are displayed with the show controllers clock-reference command, use the cable clock clear-counters command.
|
Note This command is not applicable on the SC train. |
|
Note To support the clock feature set in Voice over IP (VoIP) configurations, a Cisco uBR7246VXR chassis, equipped with a clock card; and a uBR-MC16S, a uBR-MC16E, or a uBR-MC28C cable modem card must be used running 12.1(1a)T1 or later releases. Only these cable modem cards support the external clock card reference from a clock card to distribute that signal to cable modems (CMs) or set-top boxes (STBs) attached to the specific network segments. Each CM or STB must also support VoIP applications and the clock feature set. The Cisco uBR924, running 12.0(7)T or higher releases, supports clock card feature automatically. |
Examples
The following is a sample output from the show controllers clock-reference command:
Router# show controllers clock-reference National clock card with T1 controller Control register :0x4 Status register :0x54 LIU Config Register 0:0x0 LIU Config Register 1:0x0 1 events reported in 266636 seconds Primary active :1, LOS :0 Secondary active :0, LOS :1 Holdovers :0, HW faults :0
Related Commands
Clears the counters displayed with the show controllers clock-reference command.
Command
Description
To display general information about the router when reporting a problem, use the show cable tech-support privileged EXEC command.
show cable tech-supportSyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
11.2 This command was introduced. 12.1(1a)T1 This command was modified to include information about the cable clock card.
Release
Modification
Usage Guidelines
Use this command to help collect general information about the router when you are reporting a problem. This command displays the equivalent of the following show commands:
Examples
The following is sample output from the show cable tech-support:
Router# show cable tech-support
Related Commands
show controllers Displays information about a specific line card's interface controllers. show controllers tech-support Displays general information about a card when reporting a problem. show interfaces Displays interface information. show running-config Displays the running configuration. Displays the configuration of the system hardware, the software version, the names and sources of configuration files, and the boot images.
Command
Description
To display modulation profile group information, use the show cable modulation-profile privileged EXEC command.
show cable modulation-profile [profile] [iuc-code]
Syntax Description
profile (Optional) Profile number. Valid values are from 1 to 8. iuc-code (Optional) Internal usage code. Valid options are: initial—Initial Ranging Burst
long—Long Grant Burst
request—Request Burst
short—Short Grant Burst
station—Station Ranging Burst
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
11.3 XA This command was first introduced. 12.(0)7XR2 This command was supported. 12.1(3a)EC This command was supported.
Release
Modification
Usage Guidelines
The show cable modulation-profile command displays modulation profile group information. A modulation profile is a collection of six burst profiles that are sent out in a Upstream Channel Descriptor (UCD) message to configure a modem's transmit parameters for the following upstream message types: request, initial maintenance, station maintenance, short grant, and long grant.
The following is sample output from the show cable modulation-profile command:
router# show cable modulation-profile 1Mo IUC Type Preamb Diff FEC FEC Scrambl Max Guard Last Scrambl Preamb
length enco T CW seed B time CW offset
bytes size size size short1 request qpsk 64 no 0x0 0x10 0x152 1 8 no yes 56
1 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0
1 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0
1 short qpsk 72 no 0x5 0x4B 0x152 0 8 no yes 48
The following table describes the fields shown in the show cable modulation-profile display.
| Field | Description |
|---|---|
Mo | Modulation profile group number. A modulation profile group is the set of burst profiles that define upstream transmit characteristics for the various types of upstream transmission classes. |
IUC | Internal usage code. Each upstream transmit burst belongs to a class which is given a number called the IUC. Bandwidth maps messages (MAP) by IUC codes used to allocate upstream time slots. The following types are currently defined: Request—bandwidth request slot Initial Maintenance—initial link registration contention slot Station Maintenance—link keep-alive slot Short Data Grant—short data burst slot Long Data Grant—long data burst slot |
Type | Modulation type. |
Preamb length | Preamble length. |
Diff enco | Differential encoding enabled (yes) or not enabled (no). |
FEC T bytes | Number of bytes that can be corrected for each FEC code word. |
FEC CW size | Size, in bytes, of the FEC codeword. |
Scrambl seed | Scrambler seed value in hex format. |
Max B size | Maximum burst size. |
Guard time size | Time between successive bursts measured in symbols. |
Last CW short | Handling of FEC for shortened last code word. |
Scrambl | Scrambler enabled (yes) or not enabled (no). |
Preamb offset | The bits to be used for the preamble value. |
Related Commands
Configures a spectrum group to use a specified frequency.
Command
Description
To display the revision level information for a Cisco uBR7200 series cable modem card, use the show diag command in privileged EXEC mode.
show diagSyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
11.1 CA This command was introduced. 11.2 P This command was modified to update the sample display for the port adapters PA-12E/2FE, PA-E3, and PA-T3. 11.3 XA This command was made available for Cisco IOS Release 11.3 XA. 12.0(5)XQ This command was enhanced and made available for the Cisco 1750 router. 12.1(1a)T1 This command was modified to include information about the cable clock card.
Release
Modification
Usage Guidelines
This command displays information for the electrically erasable programmable read-only memory (EEPROM), the motherboard, and the WAN interface cards (WICs) and voice interface cards (VICs).This command also displays information about the cable clock card, if installed.
Examples
The following is sample output from the show diag command displaying diagnostic information for the cable clock card:
router# show diag Clockcard:National clock card with T1 controller EEPROM contents at hardware discovery: Hardware Revision :1.1 Part Number :800-05867-02 Board Revision :11 Deviation Number :0-0 Fab Version :02 PCB Serial Number :CAB04046NXV RMA Test History :00 RMA Number :0-0-0-0 RMA History :00 EEPROM format version 4 EEPROM contents (hex): 0x00:04 FF 40 01 AC 41 01 01 C0 46 03 20 00 16 EB 02 0x10:42 31 31 80 00 00 00 00 02 02 C1 8B 43 41 42 30 0x20:34 30 34 36 4E 58 56 03 00 81 00 00 00 00 04 00
Table 16 describes the fields shown in the show diag display.
| Field | Description |
|---|---|
National clock card with T1 controller | The system has identified the cable clock card. |
EEPROM contents at hardware discovery | EEPROM programmed data present when the system identified the clock card. |
Hardware Revision | Version number of the card. |
Part Number | The part number of the card. |
Board Revision | Revision number (signifying a minor revision) of the card. |
Deviation Number | Revision number (signifying a minor deviation) of the card. |
Fab Version | Manufacturing fabrication version number. |
PCB Serial Number | Serial number of the printed circuit board. |
RMA Test History | Counter indicating how many times diagnostics have been performed on this card. |
RMA Number | Return material authorization number, which is an administrative number assigned if the card needs to be returned for repair. |
RMA History | Counter indicating how many times the card has been returned and repaired. |
EEPROM format version | Version number of the EEPROM format. |
EEPROM contents (hex) | Dumps of EEPROM programmed data. |
The following is sample output from the show diag command displaying revision level information for the cable line card (slot 6):
CMTS01# show diag
Slot 6:
MC11 port adapter, 1 port
Port adapter is analyzed
Port adapter insertion time 02:37:10 ago
Hardware Revision : 1.2
Part Number : 800-02455-02
Board Revision : 03
Deviation Number : 0-3
Fab Version : 03
PCB Serial Number : 00004500239
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Calibration Data : Minimum: -8 dBmV, Maximum: 8 dBmV
Calibration values : 0x5D43 0x3F05 0x1794
Unknown Field (type 0083): 83 FF FF FF
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 00 F1 41 01 02 C0 46 03 20 00 09 97 02
0x10: 42 30 33 80 00 00 00 03 02 03 C1 8B 30 30 30 30
0x20: 34 35 30 30 32 33 39 03 00 81 00 00 00 00 04 00
0x30: C8 09 F8 08 03 5D 43 3F 05 17 94 83 83 FF FF FF
0x40: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
Table 17 describes the fields shown in the show diag display.
| Field | Description |
|---|---|
MC11 port adapter | Line card type. |
Port adapter is analyzed | The system has identified the Cisco uBR7200 series port adapter. |
Port adapter insertion time | Elapsed time since insertion. |
Hardware Revision | Version number of the Cisco uBR7200 series port adapter. |
Part Number | In the Cisco uBR7200 series, the part number of the port adapter. |
Board Revision | Revision number (signifying a minor revision) of the Cisco uBR7200 series port adapter. |
Deviation Number | Revision number (signifying a minor deviation) of the Cisco uBR7200 series port adapter. |
Fab Version | Manufacturing fabrication version number. |
PCB Serial Number | Serial number of the printed circuit board. |
RMA Test History | Counter indicating how many times diagnostics have been performed on this port adapter. |
RMA Number | Return material authorization number, which is an administrative number assigned if port adapter needs to be returned for repair. |
RMA History | Counter indicating how many times the port adapter has been returned and repaired. |
Calibration Data | Input power calibration range. |
Calibration values | Upstream port gain calibration constant. |
Unknown Field (type) | Unrecognized EEPROM fields. |
EEPROM format version | Version number of the EEPROM format. |
EEPROM contents (hex) | Dumps of EEPROM programmed data. |
Related Commands
show dial-peer voice Displays configuration information and call statistics for dial peers. show voice dsp Displays the current status of all DSP voice channels on the Cisco MC3810 multiservice concentrator. show voice port Displays configuration information about a specific voice port.
Command
Description
To display information about the midplane time-division multiplexing (TDM) clock reference, use the show frame-clocks privileged EXEC command.
show frame-clocksSyntax Description
This command has no keywords or arguments.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.0(T) This command was introduced. 12.1(1a)T1 This command was modified to include the cable clock card as the current clock source.
Release
Modification
Examples
The following sample output from the show frame-clocks command shows that there are no clock sources configured and the clock card is the default clock source:
Router# show frame-clocks Priority 1 clock source:not configured input:none Priority 2 clock source:not configured input:none Priority 3 clock source:not configured input:none Priority 4 clock source:not configured input:none Current clock source:Clockcard, input:Primary, priority:5
Table 18 describes the fields shown in the show frame-clocks display:
| Field | Description |
|---|---|
Priority 1-4 clock source | The configuration of the four network clock sources. |
Current clock source | The current clock source, its input, and priority. In this example, the clock card is providing the clock source. |
Related Commands
Displays status information for the clock card. Displays the clock card's hardware information.
Command
Description
To display information on groups associated with cable interfaces, use the show hccp privileged EXEC command.
show hccp {group} {brief}
Syntax Description
group A specific group number. Valid values are any number from 1 to 255, inclusive. You can use the optional group variable in the show hccp command to display information for only the specified group. brief Gives you the option to display a brief summary of the groups, configuration types, member numbers, and status for cable interfaces.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Examples
The following examples are from the show hccp and show hccp brief commands:
ROUTER# show hccp Cable4/0 - Group 1 Protect, enabled, blocking authentication md5, key-chain "cisco1" hello time 2000 msec, hold time 6000 msec Member 1 standby ip addr: working 10.20.111.11, protect 10.20.111.10 downstream wavecom (1.1.11.3/1, 1.1.11.3/2), upstream none ROUTER# show hccp brief Interface Config Grp Mbr Status Ca4/0 Protect 1 1 standby
Related Commands
show hccp interface A more directed form of the show hccp command that displays group information for a specific cable interface on which one or more groups and authentication modes have been configured.
Command
Description
To display information on all HCCP groups associated with a specific cable interface, use the show hccp interface privileged EXEC command.
show hccp interface interface {brief}
Syntax Description
interface The cable interface for which you want to display HCCP group information. The information presented includes HCCP groups, configuration types, member numbers, status, authentication algorithms, authentication key chains, HCCP timers, Ip address assignments, and downstream switch designations for the specified cable interface. brief Gives you the option to display a brief summary of the HCCP groups, configuration types, member numbers, and status for a specified cable interface.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Examples
The following examples are from the show hccp interface cable 4/0 and show hccp interface cable 4/0 brief commands:
ROUTER# show hccp interface cable 4/0 Cable4/0 - Group 1 Protect, enabled, blocking authentication md5, key-chain "cisco1" hello time 2000 msec, hold time 6000 msec Member 1 standby ip addr: working 10.20.111.11, protect 10.20.111.10 downstream wavecom (1.1.11.3/1, 1.1.11.3/2), upstream none ROUTER# show hccp interface cable 4/0 brief Interface Config Grp Mbr Status Ca4/0 Protect 1 1 standby
Related Commands
show hccp A more generalized form of this command that displays HCCP group information for all cable interfaces on which one or more HCCP groups and authentication modes have been configured.
Command
Description
To display cable interface information, use the show interface cable command in privileged EXEC mode.
show interface cable slot/port [downstream | upstream]
Syntax Description
slot/port Identifies the Cisco uBR7200 chassis slot number and downstream port number. Valid values are from 3 to 6. downstream (Optional) Displays cable downstream port information for a cable modem. upstream (Optional) Displays cable upstream port information for a cable modem.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
11.3 XA This command was introduced. 12.0(3)T Command ported to the mainline release. 12.0(7)XR Output expanded for show interface cable upstream command. 12.0(7)T Command ported to the mainline release.
Release
Modification
Examples
The following is sample output from the show interface cable command for the cable modem card located in slot 6/port 0:
CMTS01# show interface cable 6/0
Cable6/0 is up, line protocol is up
Hardware is BCM3210 FPGA, address is 00e0.1e5f.7a60 (bia 00e0.1e5f.7a60)
Internet address is 1.1.1.3/24
MTU 1500 bytes, BW 27000 Kbit, DLY 1000 usec, rely 255/255, load 1/255
Encapsulation, loopback not set, keepalive not set
ARP type: ARPA, ARP Timeout 04:00:00
Last input 4d07h, output 00:00:00, output hang never
Last clearing of "show interface" counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
10908 packets input, 855000 bytes, 0 no buffer
Received 3699 broadcasts, 0 runts, 0 giants, 0 throttles
3 input errors, 3 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
5412 packets output, 646488 bytes, 0 underruns
0 output errors, 0 collisions, 13082 interface resets
0 output buffer failures, 0 output buffers swapped out
Table 19 describes the fields shown in the show interface cable display.
| Field | Description |
|---|---|
Cable slot/port is up/...administratively down | Indicates whether the interface hardware is currently active or taken down by the administrator. |
line protocol is up/...administratively down | Indicates whether the software processes that handle the line protocol believe the interface is usable or if it has been taken down by the administrator. |
hardware | Hardware type and address. |
Internet address | Internet address followed by subnet mask. |
MTU | Maximum Transmission Unit (MTU) of the interface. |
BW | Bandwidth of the interface in kilobits per second. |
DLY | Delay of the interface in microseconds. |
rely | Reliability of the interface as a fraction of 255, calculated as an exponential average over 5 minutes. (For example, 255/255 is 100 percent reliability.) |
load | Load on the interface as a fraction of 255, calculated as an exponential average over 5 minutes. (For example, 255/255 is complete saturation.) |
Encapsulation | Encapsulation method assigned to this interface. |
ARP type | Type of Address Resolution Protocol (ARP) and timeout value assigned. |
Last input | Number of hours, minutes, and seconds since the last packet was successfully received by an interface. |
output | Number of hours, minutes, and seconds since the last packet was successfully sent by an interface. |
Last clearing of "show interface" counters | Time at which the counters that measure cumulative statistics (such as number of bytes sent and received) were last reset to zero. |
Queueing strategy | Displays the type of queueing configured for this interface. In the following example output, the type of queueing configured is First In First Out (FIFO). |
Output queue | Number of packets in the output queue. The format of this number is A/B, where A indicates the number of packets in the queue, and B indicates the maximum number of packets allowed in the queue. |
drops | Indicates the number of packets dropped due to a full queue. |
input queue/drops | Number of packets in the input queue. The format of this number is A/B, where A indicates the number of packets in the queue, and B indicates the maximum number of packets allowed in the queue. |
drops | Indicates the number of packets dropped due to a full queue. |
Five minute input rate | Average number of bits and packets sent per second in the last five minutes. |
packets input | Total number of error-free packets received by the system. |
bytes input | Total number of bytes, including data and MAC encapsulation, in the error-free packets received by the system. |
no buffer | Number of received packets discarded because there was no buffer space in the main system. |
Received broadcast | Total number of broadcast or multicast packets received by the interface. |
runts | Number of packets that are discarded because they are smaller than the medium's minimum packet size. |
giants | Number of packets that are discarded because they exceed the medium's maximum packet size. |
input errors | Includes runts, giants, no buffers, CRC, frame, overrun, and ignored counts. |
CRC | Indicates the number of times the cyclic redundancy checksum generated by the originating LAN station or far-end device does not match the checksum calculated from the data received. |
frame | Number of packets received incorrectly having a CRC error and a non-integer number of octets. |
overrun | Number of times the receiver hardware was unable to forward received data to a hardware buffer because the input rate exceeded the receiver's ability to handle the data. |
ignored | Number of received packets ignored by the interface because the interface hardware ran low on internal buffers. |
packets output | Total number of messages sent by the system. |
bytes | Total number of bytes, including data and MAC encapsulation, sent by the system. |
underruns | Number of times the sender has been running faster than the receiving device can handle. |
output errors | Sum of all errors that prevented the final transmission of packets out of the interface being examined. |
collisions | Not applicable to the Cisco uBR7246. |
interface resets | Number of times an interface has been completely reset. |
output buffer failures | Number of times the output buffer has failed. |
output buffer swapped out | Number of times the output buffer has been swapped out. |
The following is sample output from the show interface cable downstream command for the downstream cable interface of slot 6 on port 0:
CMTS01# show interface cable 6/0 downstream
Cable6/0: Downstream is up
111947771 packets output, 1579682655 bytes, 0 discarded
0 output errors
Table 20 describes the fields shown in the show interface cable downstream display.
| Field | Description |
|---|---|
Cable | Indicates the location of the downstream interface. |
Downstream is up/...administratively down | Indicates the administrative state of the interface. |
packets output | Total number of packets sent out of this interface. |
bytes | Total number of bytes sent out of this interface. |
discarded | Total number of packets discarded. |
output errors | Sum of all errors that prevented downstream transmission of packets out of this interface. |
The following is sample output for the upstream cable interface located in slot 6/port 0 from the show interface cable upstream command:
CMTS01# show interface cable 6/0 upstream Cable6/0: Upstream 0 is up Received 3699 broadcasts, 0 multicasts, 28586 unicasts 0 discards, 0 errors, 0 unknown protocol 21817 packets input, 0 corrected, 0 uncorrectable 0 noise, 0 microreflections Guaranteed-rate service queue depth:0 Best-effort service queue depth:0 Total Modems On This Upstream Channel:3 (3 active) Current Total Bandwidth Reserved:192000 bps Current Admission Control Status: ENFORCED Percentage of Oversubscription: 200% Reservation Limit (with Oversubscription):5120000 bps Last Minislot Stamp (current_time_base):190026 FLAG:1 Last Minislot Stamp (scheduler_time_base):200706 FLAG:1
Table 21 describes the fields shown in the show interface cable upstream display.
| Field | Description |
|---|---|
Cable | Indicates the location of the upstream interface. |
Upstream is up/...administratively down | Indicates the administrative state of the upstream interface. |
Received broadcasts | Number of broadcast packets received through this upstream interface. |
multicasts | Number of multicast packets received through this upstream interface. |
unicasts | Number of unicast packets received through this interface. |
discards | Number of packets discarded by this interface. |
errors | Sum of all errors that prevented upstream transmission of packets through this interface. |
unknown protocol | Number of packets received that were generated using a protocol unknown to the Cisco uBR7246. |
packets input | Number of packets received through this upstream interface that were free from errors. |
corrected | Number of error packets received through this upstream interface that were corrected. |
uncorrectable | Number of error packets received through this upstream interface that could not be corrected. |
noise | Number of upstream packets corrupted by line noise. |
microreflections | Number of upstream packets corrupted by microreflections. |
Guaranteed-rate service queue depth | Number of bandwidth requests queued up in the Guarantee-rate queue. This queue is available only to modems that have a reserved minimum upstream rate in their class of service (CoS). |
Best-effort service queue depth | Number of bandwidth requests queued up in the Best-effort queue. This queue is available to all modems that do not have any reserved rate on the upstream. |
Total Modems On This Upstream Channel | Number of cable modems currently sharing this upstream channel. This field also shows how many of these modems are active. |
Current Total Bandwidth Reserved | Total amount of bandwidth reserved by all modems sharing this upstream channel that require bandwidth reservation. The CoS for these modems specifies some nonzero value for the guaranteed-upstream rate. When one of these modems is admitted on the upstream, this field value is incremented by this guaranteed-upstream rate value. |
Current Admission Control Status | Indicates the status of admission control on the upstream channel. ENFORCED status allows users to enable admission control on a per-port basis. This controls how limited bandwidth is allocated. NOT ENFORCED status indicates that there is no admission control. Every modem that registers with a class of service specifying a minimum upstream rate is admitted by the CMTS, regardless of how much aggregate bandwidth is actually available. Users enable admission control via the admission control command-line interface (CLI). |
Percentage of Oversubscription | Amount of oversubscription to allow on this upstream channel. Oversubscription is expressed as a percentage of the raw capacity of the channel. In the example shown, an oversubscription rate of 200 percent on a 2.56 Mbps channel allows the cumulative bandwidth reservation on this channel to reach 5.12 Mbps before modems configured with nonzero reserved upstream rates are denied service. |
Reservation Limit (with Oversubscription) | Maximum cumulative bandwidth reservation allowable before rejecting new modems. In the example shown, this reservation limit with oversubscription is 5.12 Mbps. |
Last Minislot Stamp (current_time_base) | Indicates the current minislot count at the CMTS. FLAG indicates the timebase reference. This field is used only by developers. |
Last Minislot Stamp (scheduler_time_base) | Indicates the furthest minislot count allocated at the indicated time. FLAG indicates the timebase reference. This field is used by developers. |
Related Commands
show interface cable sid Displays information by service identifier (SID) of each cable modem on the network. show interface cable signal-quality Displays information about the cable signal quality.
Command
Description
To display information, use the show interface cable monitor command in privileged EXEC mode.
show interface cable slot/port monitor
Syntax Description
slot/port Identifies the Cisco uBR7200 chassis slot number and downstream port number.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Examples
The following is sample output from the show interface cable monitor command:
CMTS01# show interface cable 5/0 monitor US/ Time Outbound Flow Flow Type Flow Packet MAC MAC Encap DS Stmp Interface Type Identifier Extn. Type Extn. Type Type us no Et1/2 us-port 0 yes data no - docsis all no Et1/2 acc-list 103 yes data no - docsis all yes Et1/2 mac-addr 0050.0000.0000 yes mac no - -
| Field | Description |
|---|---|
DS | Downstream. Indicates that only downstream flows are monitored. |
UP | Upstream. Indicates that only upstream flows are monitored. |
ALL | Indicates that all flows are monitored. |
Time Stmp | "Yes" indicates that forwarded packets have been timestamped, with appended 4 bytes. "No" indicates that forwarded packets have not been timestamped. |
Outbound Interface | Identifies the interfaces where the packets have been forwarded to (Ethernet or Fasterethernet). |
Flow Type | Identifies the selected flow type, MAC-address, access-list number, or upstream port number. |
Flow Type Identifier | MAC address, access-list number, or service ID. |
Flow Extn. | "Yes" indicates that extended filters are configured and "no" indicates that no extended filters have been configured. |
MAC Type | Not applicable. |
Encap | DOCSIS encapsulation. |
Type | Forwarded packets with Ethernet encapsulation. |
Related Commands
cable monitor Displays cable interface information.
Command
Description
To display information by service identifier (SID) of each cable modem on the hybrid fiber coaxial cable
(HFC) network, use the show interface cable sid command in privileged EXEC mode.
show interface cable slot/port sid [sid-number] connectivity counters
Syntax Description
slot/port Identifies the Cisco uBR7200 chassis slot number and downstream port number. Valid values are from 3 to 6. sid-number (Optional) Identifies the service identification number. counters Displays the values of the per-SID usage counters. Same as the keyword stats in pre 11.3(6)NA releases. connectivity Displays the values of the per-SID connectivity statistics.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
11.3 XA This command was introduced. 11.3(6)NA Keyword stats changed to counters. 12.0(4)XI Added primary SID information. 12.0(5)T The command output was modified to identify secondary SIDs. 12.0(7)XR Added verbose keyword. 12.0(7)T Was ported to mainline train.
Release
Modification
Usage Guidelines
Data transport over the radio frequency (RF) link uses the registered SID address rather than the Ethernet address. This allows multiple hosts to access the network via a single cable modem.
Examples
See the following display output for the verbose keyword extension for SID 1 on interface cable slot 3, port 0:
router# show interface c3/0 sid 1 counters verbose Sid : 1 Input packets : 39 Input octets : 15964 Output packets : 30 Output octets : 8796 BW requests received : 40 Grants issued : 40 Rate exceeded BW request drops : 0 Rate exceeded DS packet drops : 0
See the following display output for the verbose keyword extension for all SIDs on the specified interface:
router# show interface c3/0 sid counters verbose Sid : 1 Input packets : 39 Input octets : 15964 Output packets : 30 Output octets : 8796 BW requests received : 40 Grants issued : 40 Rate exceeded BW request drops : 0 Rate exceeded DS packet drops : 0 Sid : 2 Input packets : 0 Input octets : 0 Output packets : 0 Output octets : 0 BW requests received : 0 Grants issued : 0 Rate exceeded BW request drops : 0 Rate exceeded DS packet drops : 0 Sid : 3 Input packets : 0 Input octets : 0 Output packets : 0 Output octets : 0 BW requests received : 0 Grants issued : 0 Rate exceeded BW request drops : 0 Rate exceeded DS packet drops : 0
See the following display for the SIDs connected to the specified interface:
Router# show inter cab 3/0 sid
Sid Prim Type Online Admin QoS Create IP Address MAC Address
Sid State Status Time
23 stat init(d) enable 2 04:00:54 209.165.200.0 0050.7366.17ab
24 stat init(d) enable 2 04:00:58 209.165.200.0 0050.7366.1803
25 stat init(rc) enable 2 04:01:05 209.165.200.0 00d0.bad3.c459
26 stat init(d) enable 2 04:01:10 209.165.200.0 0050.7366.1801
27 stat offline enable 2 04:01:31 209.165.200.225 0090.8330.0213
28 stat offline enable 2 04:01:59 209.165.200.226 0090.8330.0211
29 stat offline enable 2 04:02:07 209.165.200.227 0090.8330.0214
30 dyn init(o) enable 2 04:03:09 209.165.200.228 0090.833
See the following connection information for all SIDs on the specified interface:
router# show interface c3/0 sid connectivity
Sid 1st time Times %online Online time Offline time
online Online min avg max min avg max
1 15:37:24 1 99.73 00:00 1h45m 1h45m 00:17 00:17 00:17
2 15:37:24 1 99.73 00:00 1h45m 1h45m 00:17 00:17 00:17
3 15:37:24 1 99.73 00:00 1h45m 1h45m 00:17 00:17 00:17
See the following connection information for SID 1 on the specified interface:
router# show interface c3/0 sid 1 connectivity
Sid 1st time Times %online Online time Offline time
online Online min avg max min avg max
1 15:37:24 1 99.72 00:00 1h41m 1h41m 00:17 00:17 00:17
See the following display for the counters of the SIDs connected to the specified interface:
router# show interface c3/0 sid counters
Sid Inpackets Inoctets Outpackets Outoctets Ratelimit Ratelimit
BWReqDrop DSPktDrop
1 40 16586 31 9160 0 0
2 0 0 0 0 0 0
3 0 0 0 0 0 0
See the following display for the counters of SID 1 on the specified interface:
router# show interface c3/0 sid 1 counters
Sid Inpackets Inoctets Outpackets Outoctets Ratelimit Ratelimit
BWReqDrop DSPktDrop
1 39 15964 30 8796 0 0
The following example confirms that cable modem 0010.7b6b.7219 had two SIDs. The primary SID was 3, and the secondary SID was 8.
router# show interface cable 3/0 sid
Sid Prim Online Admin QoS Create IP Address MAC Address
Sid State Status Time
1 online enable 4 17:00:38 19.2.20.141 0010.7b6b.71cd
2 online enable 4 17:00:38 19.2.20.139 0010.7b6b.7215
3 online enable 5 17:00:40 19.2.20.145 0010.7b6b.7219
8 3 enable 6 17:31:10
Table 23 describes the fields shown in the show interface cable display.
| Field | Description |
|---|---|
Sid | Service identification number. |
Prim Sid | The primary service identifier (SID) assigned to the modem. |
Type | Indicates this SID was created statically at the time of registration or dynamically by the exchange of dynamic service messages between the cable modem and CMTS. |
Online State | "Online" means that the modem owning this SID is processing traffic. "Offline" means that the modem owning this SID is not processing traffic. |
Admin Status | "Disable" means that the SID has been turned off. "Enable" is the normal state. |
QoS | Quality of service. |
Create time | When the SID was created, number of seconds since the system booted. |
Input octets (Inoctets) | Number of octets received by using this SID. |
Input packets (Inpackets) | Number of packets received by using this SID. |
Output octets (Outoctets) | Number of octets sent from this SID. |
Output packets (Outpackets) | Number of packets sent from this SID. |
IP address | IP address of the modem owning this SID. |
MAC address | MAC address of the modem owning this SID. |
BW requests received | Number of bandwidth requests received by this SID. |
Grants issued | Number of bandwidth requests granted by this SID. |
Rate exceeded BW request drops | Number of bandwidth requests not granted by this SID. |
Rate exceeded DS packet drops | Number of downstream packets lost by this SID. |
Ratelimit BWReqDrop | Number of bandwidth requests not granted by this SID. |
Ratelimit DSPktDrop | Number of downstream packets lost by this SID. |
1st time online | Time at which the modem with this SID connected. |
Times online | Number of times the modem with this SID has connected. |
% online | Percentage of time the modem with this SID has been connected. |
Online time | The minimum, average, and maximum number of hours and minutes the modem with this SID has been connected. |
Offline time | The minimum, average, and maximum number of hours and minutes the modem with this SID has been disconnected. |
Related Commands
show interface cable signal-quality Displays information about the cable signal quality.
Command
Description
To display information about the signal quality of a downstream port on a cable modem card in a Cisco uBR7200 series cable router, use the show interface cable signal-quality command in privileged EXEC mode.
show interface cable slot/port signal-quality
Syntax Description
slot/port Identifies the Cisco uBR7200 chassis slot number and downstream port number.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
11.3 XA This command was introduced.
Release
Modification
Examples
The following is sample output from the show interface cable signal-quality command:
CMTS01# show interface cable 6/0 signal-quality Cable6/0: Upstream 0 is up includes contention intervals: TRUE
Table 24 describes the fields shown in the show interface cable signal-quality display.
| Field | Description |
|---|---|
Cable | Interface name. |
Upstream is up includes contention intervals | States whether this statement is true. |
Related Commands
show interface cable Displays cable interface information. Displays information by SID of each cable access router on the network.
Command
Description
To display the configuration of the system hardware, the software version, the names and sources of configuration files, and the boot images, use the show version EXEC command.
show versionSyntax Description
This command has no keywords or arguments.
Defaults
Display output without page breaks and remove passwords and other security information.
Command Modes
EXEC
Command History
10.0 This command was introduced. 12.1(1a)T1 This command was modified to include information about the cable clock card.
Release
Modification
Examples
The following is sample output from the show version command for a Cisco uBR7246 VXR with the cable clock card installed:
Router# show version Cisco Internetwork Operating System Software IOS (tm) 7200 Software (UBR7200-P-M), Version 12.1(0.8)T, Copyright (c) 1986-2000 by cisco Systems, Inc. Compiled Wed 02-Feb-00 16:49 by ccai Image text-base:0x60008900, data-base:0x61192000 ROM:System Bootstrap, Version 12.0(19990210:195103) [12.0XE 105], VXR1 uptime is 2 days, 1 hour, 24 minutes System returned to ROM by power-on at 10:54:38 PST Sat Feb 5 2000 System restarted at 11:01:08 PST Sat Feb 5 2000 System image file is "slot1:ubr7200-p-mz.121-0.8.T" cisco uBR7246VXR (NPE300) processor (revision B) with 122880K/40960K bytes of memory. Processor board ID SAB0329005N R7000 CPU at 262Mhz, Implementation 39, Rev 1.0, 256KB L2, 2048KB L3 Cache 6 slot VXR midplane, Version 2.0 Last reset from power-on X.25 software, Version 3.0.0. National clock card with T1 controller 1 FastEthernet/IEEE 802.3 interface(s) 2 Cable Modem network interface(s) 125K bytes of non-volatile configuration memory. 16384K bytes of Flash PCMCIA card at slot 0 (Sector size 128K). 20480K bytes of Flash PCMCIA card at slot 1 (Sector size 128K). 4096K bytes of Flash internal SIMM (Sector size 256K). Configuration register is 0x0
Table 25 describes significant fields shown in these displays.
| Field | Description |
|---|---|
IOS (tm) 7200 Software (UBR7200-P-M), Version xx.x | Always specify the complete version number when reporting a possible software problem. In the example, the version number is 12.1(0.8)T. |
ROM: System Bootstrap, Version 12.0(19990210) [12.0XE 105], | Bootstrap version string. |
Router uptime is | The amount of time the system has been up and running. |
System restarted at | Also displayed is a log of how the system was last booted, as a result of normal system startup or system error. |
System image file is | If the software was booted over the network, the Internet address of the boot host is shown. If the software was loaded from onboard ROM, this line reads "running default software." |
cisco uBR7246VXR (NPE300) processor | The remaining output in each display shows the hardware configuration and any nonstandard software options. |
Configuration register is | The configuration register contents, displayed in hexadecimal notation. |
The output of the show version EXEC command can also provide certain messages, such as bus error messages. If such error messages appear, report the complete text of this message to your technical support specialist.
Related Commands
Displays diagnostic information for the cable modem cards.
Command
Description
To enable the cable modem remote query using the Simple Network Management Protocol (SNMP) manager for configuring and querying cable modem poller and status, use the snmp-server enable cable cm-remote-query EXEC command. To stop displaying debug messages, use the no form of this command.
snmp-server enable cable cm-remote querySyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command History
12.0(7)XR2 This command was introduced.
Release
Modification
Examples
See the following example for a sample debug message of a successful poll of the modems:
router# debug cable remote-query remote-query debugging is on . For IP address 209.165.200.223 Nov 10 15:56:50.241: docsIfSignalQualityEntry.5.4 = 380 Nov 10 15:56:50.241: docsIfMibObjects.2.2.1.3.2 = 360 Nov 10 15:56:50.245: docsIfDownstreamChannelEntry.6.4 = -30 Nov 10 15:56:50.245: docsIfUpstreamChannelEntry.6.3 = 12422 Nov 10 15:56:50.249: docsIfSignalQualityEntry.6.4 = 0 Nov 10 15:56:50.477:
See the following example for a sample debug message when the waiting queue at the CMTS is empty:
router# SNMP proxy exec got event, but queue is empty
See the following for an example debug message when you try to modify the polling interval or community string while the polling in is progress:
Community string if modified will not be reflected
|
Note The polling interval will be changed, but to change the community string, you must unconfigure the snmp-server community command and reconfigure it with the new community string. |
Related Commands
cable modem remote-query Specifies that information will be gathered from specified remote modems.
Command
Description
This section documents most commonly used CMTS debug commands:
To display information about the Cisco uBR7246 physical environment, including internal temperature, midplane voltages, fan performance, and power supply voltages, use the debug cable env EXEC command. To disable debugging output, use the no form of this command.
debug cable envSyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values
Command Modes
Privileged EXEC
Command History
11.3NA This command was introduced.
Release
Modification
Usage Guidelines
This command is used to debug the sensor circuitry used to measure internal temperature, midplane voltages, fan performance, and power supply voltages on the Cisco uBR7246 console.
Examples
The following example shows a sample output for the debug cable env command
ENVM: ps id=0xFF0, v=0x2050, r=0xC0AB, pstype=1 ENVM: ps id=0x2FD0, v=0x2050, r=0x24201, pstype=27 NVM: Sensor 0: a2dref=131, a2dact=31, vref=12219, vact=1552 Alpha=8990, temp=27
Table 26 provides description for the output.
| Field | Description |
|---|---|
ps id | Power supply raw voltage reading |
pstype | Power supply type determined from ps ID, v, and r. The Cisco uBR7246 contains dual power supplies so ID information for two types is usually printed. |
Sensor | Sensor number. |
a2dref | Analog to digital converter reference reading. |
a2dact | Analog to digital converter actual (measured reading). |
vref | Reference voltage. |
vact | Actual voltage. |
Alpha | Raw temperature reading. |
temp | Temperature corresponding to Alpha. |
Related Commands
show environment Displays the temperature and voltage information
Command
Description
To display errors that occur in the cable MAC protocols, use the debug cable err EXEC command. To disable debugging output, use the no form of the command.
debug cable errSyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
11.3NA This command was introduced.
Release
Modification
Usage Guidelines
This command is used to display unexpected DOCSIS MAC protocol messages. When the Cisco uBR7246 does not to expect to receive a specific MAC message, an error message and hex dump are printed. Other miscellaneous error conditions may result in output.
Examples
Following is sample debug cable err output.
This is a UCD Message > This is a MAP Message > This is a RNG_RSP Message > This is a REG_RSP Message > This is a UCC_REQ Message > This is a BPKM_RSP Message > This is a TRI_TCD Message > This is a TRI_TSI Message > This is a unrecognized MCNS message > > ERROR:######TICKS PER MSLOT NOT POWER OF 2####
To display debug messages for frequency hopping, use the debug cable freqhop EXEC command. Use the no form of this command to disable debugging output.
debug cable freqhopSyntax Description
This command has no arguments or keywords.
Defaults
Debugging for frequency hopping is not enabled.
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following example shows how to display debug messages for frequency hopping:
router# debug cable freqhop CMTS freqhop debugging is on
To activate debugging of TEK and KEK baseline privacy key activity, use the debug cable keyman EXEC command. To disable debugging output, use the no form of the command.
debug cable keymanSyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
11.3NA This command was introduced.
Release
Modification
Usage Guidelines
This command activates debugging of the TEK and KEK baseline privacy key activity. When this command is activated, all activity related to KEK and TEK keys is displayed on the Cisco uBR7246 console. This command is used to display encryption key management debugging output.
Examples
Following is sample debug cable keyman output.
Read Verify DES failed with SID %2x
> Verify key failed with SID %2x : setvalue = %llx, readback = %llx
> Verify iv failed with SID %2x : setvalue = %llx, readback = %llx
> Next TEK lifetime check is set to %u seconds.
> Next Multicast TEK lifetime check is set to 1 seconds
>
> [UCAST_TEK] :", idbp->hw_namestring);
> show_sid_key_chain(ds, &ds->mcast_sid_key_list_hdr);
>
> [MCAST_TEK] :", idbp->hw_namestring);
> buginf("\nSID : %4x\t", sidkey->sid);
> buginf("seq : %2x\t current : %2x\n", sidkey->key_seq_num,
> sidkey->current_key_num);
> buginf(" Status[0] : %x\tDES IV[0] : %llx\tKey Life[0]: %u sec\n",
> sidkey->key_status[0], sidkey->des_key[0].iv,
> compute_remain_lifetime(&sidkey->des_key[0]));
>
> buginf(" Status[1] : %x\tDES IV[1] : %llx\tKey Life[1]: %u sec\n",
> sidkey->key_status[1], sidkey->des_key[1].iv,
> compute_remain_lifetime(&sidkey->des_key[1]));
>
Use the debug cable mac EXEC command to display MAC-layer information for the specified cable modem. The no form of this command disables debugging output.
debug cable mac {mac-address address | mac-protocol}
Syntax Description
mac-address address Specifies the MAC address range to debug. mac-protocol Specifies debug of MAC protocol.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1 T This command was introduced.
Release
Modification
Usage Guidelines
Do not use this command if you have a large number of modems on your network. The Cisco uBR7246 will become flooded with console printouts.
Examples
The following example shows the return for the MAC layer:
router# debug cable mac19:46:27: Ranging Modem with Sid 1 on i/f : Cable6/0/U019:46:27: Got a ranging request19:46:27: SID value is 1 on Interface Cable6/0/U019:46:27: CM mac address 00:E0:1E:B2:BB:0719:46:27: Timing offset is 019:46:27: Power value is FE0, or 0 dB19:46:27: Freq Error = 0, Freq offset is 019:46:27: Ranging has been successful for SID 1 on Interface Cable6/0/U019:46:29: Ranging Modem with Sid 2 on i/f : Cable6/0/U019:46:29: Got a ranging request19:46:29: SID value is 2 on Interface Cable6/0/U019:46:29: CM mac address 00:E0:1E:B2:BB:8F19:46:29: Timing offset is 119:46:29: Power value is 1350, or 0 dB19:46:29: Freq Error = 0, Freq offset is 019:46:29: Ranging has been successful for SID 2 on Interface Cable6/0/U019:46:32: Ranging Modem with Sid 3 on i/f : Cable6/0/U019:46:32: Got a ranging request19:46:32: SID value is 3 on Interface Cable6/0/U019:46:32: CM mac address 00:E0:1E:B2:BB:B119:46:32: Timing offset is FFFFFFFF19:46:32: Power value is 1890, or -1 dB19:46:32: Freq Error = 0, Freq offset is 019:46:32: Ranging has been successful for SID 3 on Interface Cable6/0/U019:46:34: Ranging Modem with Sid 5 on i/f : Cable6/0/U0
| Field | Description |
|---|---|
SID value is.... | Reports the service ID of the modem. The range is from 1 through 891. The information on this line should agree with the first line of the return (that is, Ranging Modem with Sid...). |
CM mac address.... | The MAC address of the specified cable modem. |
Timing offset is.... | The time by which to offset the frame transmission upstream so that the frame arrives at the expected minislot time at the CMTS. |
Power value is FE0, or 0 dB | The raw value derived from the 3137 Broadcom chip. Alternately, the dB value specifies the relative change in the transmission power level that the cable modem needs to make so that transmissions arrive at the CMTS at the desired power level. This desired power level is usually 0, but you can use the command-line interface (CLI) to change it via the cable power-level command. |
Freq Error = .... | The raw value derived from the 3137 Broadcom chip. |
Freq offset is .... | Specifies the relative change in the transmission frequency that the cable modem will make to match the CMTS. |
Related Commands
Displays interface controller information for the specified slot.
Command
Description
Use the debug cable map EXEC command to display map debugging messages. The no form of this command disables debugging output.
debug cable map sid [sid-num]
Syntax Description
sid sid-num Specifies the specific service ID to be debugged in MAPs. The valid range for the optional sid-num value is 1 to 8191.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1 T This command was introduced.
Release
Modification
Examples
The following example shows how to display all the MAP messages with and without data grants:
router# debug cable map 19:41:53: On interface Cable6/0, sent 5000 MAPs, 1321 MAPs had grant(s)Long Grants 13256993, Total Short Grants 223 A sample Map without any data grant ------------------ MAP MSG -------------------- us_ch_id: 1 ucd_count: 5 num_elems: 9 reserved: 0 Alloc Start Time: 33792 Ack Time: 33618 Rng_bkoff_start: 0 Rng_bkoff_end: 2 Data_bkoff_start: 1 Data_bkoff_end: 3: sid:16383 iuc:1 mslot_offset:0 sid:0 iuc:7 mslot_offset:40 A sample Map with data grant(s) ------------------ MAP MSG --------------------- us_ch_id: 1 ucd_count: 5 num_elems: 7 reserved: 0 Alloc Start Time: 33712 Ack Time: 33578 Rng_bkoff_start: 0 Rng_bkoff_end: 2 Data_bkoff_start: 1 Data_bkoff_end: 3 sid:2 iuc:6 mslot_offset:0 sid:16383 iuc:1 mslot_offset:16 sid:0 iuc:7 mslot_offset:40
| Field | Description |
|---|---|
sent 5000 MAPs | Total number of maps transmitted. |
MAPs had grant(s) Long Grants | Total number of grants considered long-sized by CMTS. |
Total Short Grants | Total number of grants considered short-sized by CMTS. |
us_ch_id | Identifies the upstream channel ID for this message. |
ucd_count | Number of upstream channel descriptors (UCDs). |
num_elems | Number of information elements in the map. |
reserved | Reserved for alignment. |
Alloc Start Time | Start time from CMTS initialization (in minislots) for assignments in this map. |
Ack Time | Latest time from CMTS initialization (in minislots) processed in upstream. The cable modems use this time for collision detection. |
Rng_bkoff_start | Initial backoff window for initial ranging contention, expressed as a power of 2. Valid values are from 0 to 15. |
Rng_bkoff_end | Final backoff window for initial ranging contention, expressed as a power of 2. Valid values are from 0 to 15. |
Data_bkoff_start | Initial backoff window for contention data and requests, expressed as a power of 2. Valid values are from 0 to 15. |
Data_bkoff_end | Final backoff window for contention data and requests, expressed as a power of 2. Valid values are from 0 to 15. |
sid | Service ID. |
iuc | Interval usage code (IUC) value. |
mslot_offset | Minislot offset. |
Related Commands
Displays interface controller information for the specified slot.
Command
Description
To activate debugging of messages generated in the cable physical layer, use the debug cable phy EXEC command. To disable debugging output, use the no form of the command.
debug cable phySyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
11.3NA This command was introduced.
Release
Modification
Usage Guidelines
This command activates debugging of messages generated in the cable phy, which is the physical layer where upstream and downstream activity between the Cisco uBR7246 and the hybrid fiber coaxial cable (HFC) network is controlled. When this command is activated, any messages generated in the cable phy are displayed on the Cisco uBR7246 console.
Examples
Following is sample debug cable phy output.
cmts_phy_init: mac_version == BCM3210_FPGA >bcm3033_set_tx_sym_rate(5056941) >stintctl = 0x54484800 >bcm3033_set_tx_if_freq(44000000) >stfreqctl = 0x5BAAAAAA >cmts_phy_init_us: U0 part_id = 0x3136, revid = 0x05, rev_id2 = 0x64 >cmts_phy_init: mac_version == BCM3210_FPGA Media access controller chip version. >bcm3033_set_tx_sym_rate(5056941) > stintctl = 0x54484800 Physical layer symbol rate register value. >00:51:49: bcm3033_set_tx_if_freq(44000000) >00:51:49: stfreqctl = 0x5BAAAAAA Physical layer intermediate frequency (IF) register value. >00:51:49: cmts_phy_init_us: U0 part_id = 0x3136, revid = 0x05, rev_id2 = 0x64 Physical layer receiver chip part version.
To activate debugging of baseline privacy, use the debug cable privacy EXEC command. To disable debugging output, use the no form of the command.
debug cable privacySyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
11.3 XA This command was introduced.
Release
Modification
Usage Guidelines
This command activates debugging of baseline privacy. When this command is activated, any messages generated by the spectrum manager are displayed on the Cisco uBR7246 console.
Examples
Following is a sample debug cable privacy output:
Removing both odd and even keys for sid %x. > > Invalid Len for TLV_SERIAL_NUM_TYPE : %d. > > Invalid Len for TLV_MANUF_ID_TYPE : %d. > > Invalid Len for TLV_MANUF_ID_TYPE : %d. >
To activate quality-of-service (QoS) debugging, use the debug cable qos EXEC command. To disable debugging output, use the no form of the command.
debug cable qosSyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
11.3NA This command was introduced.
Release
Modification
Usage Guidelines
This command activates debugging of QoS. When this command is activated, any messages related to QoS parameters will be displayed on the Cisco uBR7246 console.
Examples
Following is a sample debug cable qos output:
>CMTS_QOS_LOG_NO_MORE_QOS_INDEX Modems cannot add more entries to the class of service table. >CMTS_QOS_LOG_NOMORE_QOSPRF_MEM Memory allocation error when creating class of service table entry. >CMTS_QOS_LOG_NO_CREATION_ALLOWED Class of service entry cannot be created by modem. Use CLI or SNMP interface instead of the modem's TFTP configuration file. >CMTS_QOS_LOG_CANNOT_REGISTER_COS_SID A service identifier (SID) could not be assigned to the registering modem. >CMTS_QOS_LOG_CANNOT_DEREGISTER_COS_SID The modem's service identifier (SID) was already removed. >CMTS_QOS_LOG_MSLOT_TIMEBASE_WRAPPED The 160 KHz timebase clock drives a 26-bit counter which wraps around approximately every 7 minutes. This message is generated every time it wraps around.
To display ranging messages from cable modems on the hybrid fiber coaxial cable (HFC) network, use the debug cable range EXEC command. To disable debugging output, the no form of the command.
debug cable rangeSyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
11.3NA This command was introduced.
Release
Modification
Usage Guidelines
This command activates debugging of ranging messages from cable modems on the HFC network. When this command is activated, any ranging messages generated when cable modems request or change their upstream frequencies are displayed on the Cisco uBR7246 console. Use this command to display the details of the initial and station maintenance procedures. The initial maintenance procedure is used for link establishment. The station maintenance procedure is used for link keepalive monitoring.
Examples
Following are samples of debug cable range output.
>Got a ranging request >SID value is 0 on Interface Cable3/0/U0 >CM mac address 00:10:7B:43:AA:21 Timing offset is 3312 >3E 1E 3F FF 00 00 59 BF 01 15 F8 01 A7 00 0C F0
Output when a modem first seeks to establish a link to the Cisco uBR7246. The service identifier (SID) value of 0 indicates that the modem has no assigned SID. The CM mac address is the MAC address of the modem's radio frequency (RF) interface, not its Ethernet interface. The Timing offset is a measure of the distance between the modem and the Cisco uBR7246 expressed in 10.24 MHz clocks. This value is adjusted down to zero by the maintenance procedures. The first 16 bytes of the prepended header of the message are dumped in hexadecimal.
CM mac address 0010.7b43.aa21 >found..Assigned SID #2 on Interface Cable3/0/U0 >Timing offset is CF0 >Power value is 15F8, or -1 dB >Freq Error = 423, Freq offset is 1692 >Ranging Modem with Sid 2 on i/f : Cable3/0/U0
Output when the modem is first assigned a SID during initial maintenance.
>Initial Range Message Received on Interface Cable3/0/U0 >CMTS reusing old sid : 2 for modem : 0010.7b43.aa21 >Timing offset is CF0 >Power value is 15F8, or -1 dB >Freq Error = 423, Freq offset is 1692 >Ranging Modem with Sid 2 on i/f : Cable3/0/U0
Output when the modem is reassigned the same SID during initial maintenance.
>Ranging Modem with Sid 2 on i/f : Cable3/0/U0 > >Got a ranging request >SID value is 2 on Interface Cable3/0/U0 >CM mac address 00:10:7B:43:AA:21 >Timing offset is 0 >Power value is 1823, or -1 dB >Freq Error = 13, Freq offset is 0 >Ranging has been successful for SID 2 on Interface Cable3/0/U0
Output when the modem is polled by theCisco uBR7246 during station maintenance. Polling happens at a minimum rate of once every 10 seconds.
To display reset messages from cable interfaces, use the debug cable reset EXEC command. To disable debugging output, use the no form of this command.
debug cable resetSyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values
Command Modes
Privileged EXEC
Command History
11.3NA This command was introduced.
Release
Modification
Usage Guidelines
This command activates display of reset messages from cable interfaces.
Examples
Following is a sample debug cable reset output:.
>Resetting CMTS interface.
Output when the interface is reset due to complete loss of receive packets.
To debug spectrum management (frequency agility) on the HFC network, use the debug cable specmgmt EXEC command. To disable debugging output, use the no form of this command.
debug cable specmgmtSyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
11.3NA This command was introduced.
Release
Modification
Usage Guidelines
This command activates debugging of spectrum management (frequency agility) on the HFC network. When this command is activated, any messages generated due to spectrum group activity will be displayed on the Cisco uBR7246 console. Spectrum group activity can be additions or changes to spectrum groups, or frequency and power lever changes controlled by spectrum groups.
Examples
Following is a sample debug cable specmgmt output:
>cmts_next_frequency(0x60A979AC, 1, 1)
Frequency hop was commanded.
>add_interface_to_freq(0x60BD3734, 0x60C44F68)
Interface was added to a frequency's interface list.
>set_upstream(0x60A979AC,1,21000000,-5)
Spectrum management has set an upstream port's frequency and power level.
>cmts_frequency_hop_decision(0x60B57FEC)
An interface was checked for a frequency hop decision.
To debug channel allocations on the hybrid fiber coaxial cable (HFC) network, use the debug cable startalloc EXEC command. To disable debugging output, use the no form of this command.
debug cable startallocSyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values
Command Modes
Privileged EXEC
Command History
11.3NA This command was introduced.
Release
Modification
Usage Guidelines
This command activates debugging of any channel allocations on the HFC network. When this command is activated, any messages generated when channels are allocated to cable modems on the HFC network will be displayed on the Cisco uBR7246 console.
|
Caution This command should be used for development testing only, not in production setting. |
Examples
Following is a sample debug cable startalloc output:
>MAP startalloc adjusted by <n> mslots
Indicates time-slot MAP processing is active.
To display debug messages for remote modem queries, use the debug cable remote query EXEC command. To stop displaying debug messages, use the no form of this command.
debug cable remote querySyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.0(7)XR This command was introduced.
Release
Modification
Examples
See the following example for a sample debug message of a successful poll of the modems:
router# debug cable remote-query remote-query debugging is on . For IP address 209.165.200.223 Nov 10 15:56:50.241: docsIfSignalQualityEntry.5.4 = 380 Nov 10 15:56:50.241: docsIfMibObjects.2.2.1.3.2 = 360 Nov 10 15:56:50.245: docsIfDownstreamChannelEntry.6.4 = -30 Nov 10 15:56:50.245: docsIfUpstreamChannelEntry.6.3 = 12422 Nov 10 15:56:50.249: docsIfSignalQualityEntry.6.4 = 0 Nov 10 15:56:50.477:
See the following example for a sample debug message when the waiting queue at the CMTS is empty:
SNMP proxy exec got event, but queue is empty
See the following example for a sample debug message when you try to modify the polling interval or community string while the polling in is progress:
Community string if modified will not be reflected
|
Note The polling interval will be changed but to change the community string, you must unconfigure the snmp-server community command and reconfigure it with the new community string. |
Related Commands
cable modem remote-query Specifies that information will be gathered from specified remote modems.
Command
Description
To display debug messages for telco-return events, use the debug cable telco-return EXEC command. To disable debugging output, use the no form of this command.
debug cable telco-returnSyntax Description
This command has no arguments or keywords.
Defaults
Debugging for telco-return events is not enabled.
Command Modes
Privileged EXEC
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following is sample output from the debug cable telco-return and debug cable telco-return msg commands:
01:17:31:Sending TCD message: TLV type = 1 TLV len = 56 Factory default flag: 1 Phone number 1: 5551212 Service provider name:uBR7246 Connection threshold: 10 Username: guest Password: password DHCP authenticate: 1 DHCP server: 10.10.255.255 PPP authentication: 2 Manual dial: 1 Sending TSI message: DS channel IP address: 10.10.10.10 Registration IP address:10.10.10.10 CMTS boot time: 3080626752 DS channel ID: 0 Epoch: 1
Related Commands
Displays the Telephony Channel Descriptor (TCD) and Termination System Information (TSI) messages.
Command
Description
To display the Telephony Channel Descriptor (TCD) and Termination System Information (TSI) messages that are sent downstream to the telco-return cable modems, use the debug cable telco-return msg EXEC command. To disable debugging output, use the no form of this command.
debug cable telco-return msgSyntax Description
This command has no arguments or keywords.
Defaults
TCD and TSI messages are not displayed.
Command Modes
Privileged EXEC
Command History
12.0(4)XI This command was introduced.
Release
Modification
Examples
The following is sample output from the debug cable telco-return msg command:
01:17:31:Sending TCD message: TLV type = 1 TLV len = 56 Factory default flag: 1 Phone number 1: 5551212 Service provider name:uBR7246 Connection threshold: 10 Username: guest Password: password DHCP authenticate: 1 DHCP server: 10.10.255.255 PPP authentication: 2 Manual dial: 1 Sending TSI message: DS channel IP address: 10.10.10.10 Registration IP address:10.10.10.10 CMTS boot time: 3080626752 DS channel ID: 0 Epoch: 1
Related Commands
Displays debug messages for telco-return events.
Command
Description
To debug upstream channel change (UCC) messages generated when cable modems request or are assigned a new channel, use the debug cable ucc EXEC command. To disable debugging output, use the no form of this command.
debug cable uccSyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
11.3NA This command was introduced.
Release
Modification
Usage Guidelines
This command activates debugging of any upstream channel change (UCC) messages generated when cable modems request or are assigned a new channel. When this command is activated, any messages related to upstream channel changes are displayed on the Cisco uBR7246 console.
Examples
Following is a sample debug cable ucc output:
>SID 2 has been registered > >Mac Address of CM for UCC > 00:0E:1D:D8:52:16 > >UCC Message Sent to CM > >Changing SID 2 from upstream channel 1 to upstream channel 2
Output when moving the modem from one upstream channel to another.
To debug upstream channel descriptor (UCD) messages, use the debug cable ucd EXEC command. To disable debugging output, use the no form of this command.
debug cable ucd
no debug cable ucd
Syntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values
Command Modes
Privileged EXEC
Command History
11.3NA This command was introduced.
Release
Modification
Usage Guidelines
This command activates debugging of any upstream channel descriptor (UCD) messages. UCD messages contain information about upstream channel characteristics and are sent to the cable modems on the hybrid fiber coaxial cable (HFC) network. Cable modems that are configured to use enhanced upstream channels use these UCD messages to identify and select an enhanced upstream channel to use. When this command is activated, any messages related to upstream channel descriptors are displayed on the Cisco uBR7246 console.
Examples
Following is a sample debug cable ucd output:
UCD MESSAGE
-----------
FRAME HEADER
FC - 0xC2 ==
MAC_PARM - 0x00
LEN - 0xD3
MAC MANAGEMENT MESSAGE HEADER
DA - 01E0.2F00.0001
SA - 0009.0CEF.3730
msg LEN - C1
DSAP - 0
SSAP t - 0
control - 03
version - 01
type - 02 ==
US Channel ID - 1
Configuration Change Count - 5
Mini-Slot Size - 4
DS Channel ID - 1
Symbol Rate - 8
Frequency - 10000000
Preamble Pattern - CC CC CC CC CC CC CC CC CC CC CC CC CC
CC 0D 0D
Burst Descriptor 0
Interval Usage Code - 1
Modulation Type - 1 == QPSK
Differential Encoding - 2 == OFF
Preamble Length - 64
Preamble Value Offset - 56
FEC Error Correction - 0
FEC Codeword Length - 16
Scrambler Seed - 0x0152
Maximum Burst Size - 2
Guard Time Size - 8
Last Codeword Length - 1 == FIXED
Scrambler on/off - 1 == ON
Burst Descriptor 1
Interval Usage Code - 3
Modulation Type - 1 == QPSK
Differential Encoding - 2 == OFF
Preamble Length - 128
Preamble Value Offset - 0
FEC Error Correction - 5
FEC Codeword Length - 34
Scrambler Seed - 0x0152
Maximum Burst Size - 0
Guard Time Size - 48
Last Codeword Length - 1 == FIXED
Scrambler on/off - 1 == ON
Burst Descriptor 2
Interval Usage Code - 4
Modulation Type - 1 == QPSK
Differential Encoding - 2 == OFF
Preamble Length - 128
Preamble Value Offset - 0
FEC Error Correction - 5
FEC Codeword Length - 34
Scrambler Seed - 0x0152
Maximum Burst Size - 0
Guard Time Size - 48
Last Codeword Length - 1 == FIXED
Scrambler on/off - 1 == ON
Burst Descriptor 3
Interval Usage Code - 5
Modulation Type - 1 == QPSK
Differential Encoding - 2 == OFF
Preamble Length - 72
Preamble Value Offset - 48
FEC Error Correction - 5
FEC Codeword Length - 75
Scrambler Seed - 0x0152
Maximum Burst Size - 0
Guard Time Size - 8
Last Codeword Length - 1 == FIXED
Scrambler on/off - 1 == ON
The UCD MESSAGE is :
0xC2 0x00 0x00 0xD3 0x00 0x00 0x01 0xE0
0x2F 0x00 0x00 0x01 0x00 0x09 0x0C 0xEF
0x37 0x30 0x00 0xC1 0x00 0x00 0x03 0x01
0x02 0x00 0x01 0x05 0x04 0x01 0x01 0x01
0x08 0x02 0x04 0x00 0x98 0x96 0x80 0x03
0x10 0xCC 0xCC 0xCC 0xCC 0xCC 0xCC 0xCC
0xCC 0xCC 0xCC 0xCC 0xCC 0xCC 0xCC 0x0D
0x0D 0x04 0x25 0x01 0x01 0x01 0x01 0x02
0x01 0x02 0x03 0x02 0x00 0x40 0x04 0x02
0x00 0x38 0x05 0x01 0x00 0x06 0x01 0x10
0x07 0x02 0x01 0x52 0x08 0x01 0x02 0x09
0x01 0x08 0x0A 0x01 0x01 0x0B 0x01 0x01
0x04 0x25 0x03 0x01 0x01 0x01 0x02 0x01
0x02 0x03 0x02 0x00 0x80 0x04 0x02 0x00
0x00 0x05 0x01 0x05 0x06 0x01 0x22 0x07
0x02 0x01 0x52 0x08 0x01 0x00 0x09 0x01
0x30 0x0A 0x01 0x01 0x0B 0x01 0x01 0x04
0x25 0x04 0x01 0x01 0x01 0x02 0x01 0x02
0x03 0x02 0x00 0x80 0x04 0x02 0x00 0x00
0x05 0x01 0x05 0x06 0x01 0x22 0x07 0x02
0x01 0x52 0x08 0x01 0x00 0x09 0x01 0x30
0x0A 0x01 0x01 0x0B 0x01 0x01 0x04 0x25
0x05 0x01 0x01 0x01 0x02 0x01 0x02 0x03
0x02 0x00 0x48 0x04 0x02 0x00 0x30 0x05
0x01 0x05 0x06 0x01 0x4B 0x07 0x02 0x01
0x52 0x08 0x01 0x00 0x09 0x01 0x08 0x0A
0x01 0x01 0x0B 0x01 0x01
To display authentication debug messages for HCCP groups, use the debug hccp authentication privileged EXEC command. Once you have activated HCCP debugging with the debug hccp events command, you can use the debug hccp authentication command to activate and deactivate additional HCCP authentication message output. To disable HCCP authentication debug message output, use the no form of this command.
|
Note The debug hccp authentication command is designed to be used in conjunction with, and as an augmentation to, the debug hccp events command. If the debug hccp events command has not been activated, activating the debug hccp authentication command has no effect on debug message output. |
Syntax Description
This command has no arguments or keywords.
Defaults
Debug message output for HCCP authentication is disabled by default.
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Examples
The following example shows the additional 1+1 redundancy authentication debug message output produced when the debug hccp authentication command has been activated:
Router# debug hccp authentication Sep 7 09:51:50.151:HCCP 1 0->1:HELLO Learn tran 31708 Sep 7 09:51:50.151:auth md5 keyid 1 digest B77F65ED 1B38ED5C 87A7037B C006DAFB
Related Commands
debug hccp events Allows you to display all HCCP group interaction debug messages. debug hccp sync Allows you to display HCCP SYNC debug messages.
Command
Description
To display debug messages for all HCCP group interaction, excluding authentication message output, use the debug hccp events privileged EXEC command. To disable HCCP group debug message output, use the no form of this command.
|
Note Once you have activated the debug hccp events command, you can also activate the debug hccp authentication command to provide authentication message output in addition to standard group message output. |
Syntax Description
This command has no arguments or keywords.
Defaults
Debug message output for all HCCP group interaction is disabled by default.
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Examples
The following example shows HCCP group interaction debug message output produced when the debug hccp events command has been activated:
Router# debug hccp authentication Sep 7 09:51:50.151:HCCP 1 0->1:HELLO Learn tran 31708
Related Commands
debug hccp authentication Allows you to display HCCP authentication debug message output once the debug hccp events command has been activated. debug hccp sync Allows you to display HCCP SYNC debug messages.
Command
Description
To display HCCP SYNC debug messages, use the debug hccp sync privileged EXEC command. To disable HCCP SYNC debug message output, use the no form of this command.
debug hccp syncSyntax Description
This command has no arguments or keywords.
Defaults
Debug message output for all HCCP group interaction is disabled by default.
Command History
12.1(3a)EC This command was introduced.
Release
Modification
Examples
The following example shows HCCP SYNC debug message output produced when the debug hccp sync command has been activated:
Router# debug hccp sync Sep 7 09:57:25.215:HCCP 1 0<-1:SYNC Teach tran 88 type DOCSIS10, tran_sync 82 Sep 7 09:57:25.215:HCCP 1 0->1:SYNC_ACK Learn tran 88 Sep 7 09:57:25.219:DOCSIS10_QOS:qos 1
Related Commands
debug hccp authentication Allows you to display HCCP authentication debug message output once the debug hccp events command has been activated. debug hccp events Allows you to display all HCCP group interaction debug messages.
Command
Description
Posted: Sun Oct 1 21:49:10 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.