Table Of Contents
Enhanced-Spectrum Management and Telephone Return for the Cisco uBR7200 Series Cable Router
Configuring Enhanced Spectrum Management
Verifying Telco Return Configuration
cable telco-return spd dhcp-authenticate
cable telco-return spd dhcp-server
cable telco-return spd dial-timer
cable telco-return spd factory-default
cable telco-return spd manual-dial
cable telco-return spd password
cable telco-return spd phonenum
cable telco-return spd ppp-authenticate
cable telco-return spd radius-realm
cable telco-return spd service-provider
cable telco-return spd threshold
cable telco-return spd username
Enhanced-Spectrum Management and Telephone Return for the Cisco uBR7200 Series Cable Router
This product and document are in development. Some portions of this document are not complete. This document will be revised as soon as the content is available.
Feature Overview
This feature module provides software support for telephone return in a cable-routed system. Telephone return in a cable environment is that part of the cable network which connects the subscriber's cable modem with the headend cable router over standard phone lines (as opposed to an all-cable network connecting the headend router with cable modems).
This document also supports spectrum management enhancements including already published feature modules describing per-modem filters and per-modem traffic-shaping capabilities. For more information on these previously published cable-related feature modules, see:
•
Per-modem and Per-Host Access List Support Feature
•
Benefits
Spectrum management enhancements improve system-wide throughput and increase efficiency of bandwidth utilization. Telephone (or telco) return allows Multi-Service Operators (MSOs) to support their cable subscribers without replacing existing hardware.
Related Documents
For more information on cable routers, see:
•
•
Supported Platforms
Cisco uBR7200 Series
Supported MIBs and RFCs
MIBs
None
RFCs
•
•
Configuration Tasks
Perform the following tasks to configure the features discussed in this document:
•
Configuring Enhanced Spectrum Management
To configure spectrum management, enter the following commands:
ubr7200#cable upstream <us> channel-width <channel-width1> <channel-width2>ubr7200#cable upstream <us> modulation-profile <mod profile1> <mod profile2>Configuring Telco Return
Step 1
Step 2
Step 3
Step 4
Verifying Telco Return Configuration
To verify that the subscriber modem can log into the CMTS in telco-return mode:
Step 1
Step 2
Step 3
ubr7246-1#show cable modemInterface Prim Online Timing Rec QoS CPE IP address MAC addressSid State Offset PowerCable4/0/U0 2 online 2848 -0.50 5 1 10.2.0.3 0010.7b6b.53d5Cable4/0/T 3 offline 0 0.00 2 1 10.2.0.101 0020.4001.4af6Cable4/0/U0 4 online 2852 -0.75 5 1 10.2.0.6 0010.7b6b.7255Cable4/0/U0 5 online 2850 0.25 5 1 10.2.0.7 0010.7b6b.5669Cable4/0/U0 6 online 2851 0.00 2 1 10.2.0.4 0010.7b6b.53c9Cable4/0/T 7 offline 0 0.00 2 0 10.2.0.102 0020.4001.4b32Step 4
Configuration Examples
The following example shows how to configure the cable router interface to support telco return:
#cable telco-return enableubr7223#conf tEnter configuration commands, one per line. End with CNTL/Z.ubr7223(config)#int c2/0ubr7223(config-if)#cable telco-return spd 1 factory-defaultubr7223(config-if)#cable telco-return spd 1 phonenum 8005551212ubr7223(config-if)#cable telco-return spd 1 phonenum 4085551212ubr7223(config-if)#cable telco-return spd 1 phonenum 6505551212ubr7223(config-if)#cable telco-return spd 1 service-provider norcalubr7223(config-if)#cable telco-return spd 1 dhcp-server 172.172.172.172ubr7223(config-if)#cable telco-return spd 1 username joeubr7223(config-if)#cable telco-return spd 1 password passwordubr7223(config-if)#cable telco-return spd 1 dhcp-authenticateubr7223(config-if)#cable telco-return spd 1 threshold 5ubr7223(config-if)#cable telco-return spd 1 ppp-authenticate bothubr7223(config-if)#cable telco-return spd 1 manual-dialubr7223(config-if)#cable telco-return spd 1 dial-timer 7200Command Reference
This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.0 command references:
•
•
•
•
•
•
•
•
•
•
•
In Cisco IOS Release 12.0(1)T or later releases, you can search and filter the output for show and more commands. This functionality is useful when you need to sort through large amounts of output, or if you want to exclude output that you do not need to see.
To use this functionality, enter a show or more command as follows:
command | {begin | include | exclude} regular-expression
See the following example of the show atm vc command where the command output begins with "PeakRate":
show atm vc | begin PeakRate
For more information on the search and filter functionality, see the Cisco IOS Release 12.0(1)T feature module CLI String Search.
cable downstream rate-limit
To enable downstream rate limiting, use the cable downstream rate-limit EXEC command. Use the no form of this command to disable downstream rate limiting:
cable downstream rate-limit [token-bucket shaping | weighted-discard [expwt n]]
no cable downstream rate-limitSyntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Examples
ubr7223(config-if)#cable downstream rate-limit token-bucket shapingRelated Commands
cable max-hosts
To set the maximum number of hosts supported for an interface, use the cable max-hosts interface configuration command. Use the no form of this command to set the number of hosts to 0:
cable max-hosts n
no cable max-hostsSyntax Description
Defaults
No default behavior or values.
Command Modes
Interface Configuration
Command History
Examples
ubr7223(config-if)#cable max-hosts 15Related Commands
cable modem max-hosts
Specifies the maximum number of hosts supported per modem.
cable modem change-frequency
To override the frequency used by a cable modem, use the cable modem change-frequency EXEC command:
cable modem [mac-addr | ip-addr] change-frequency [ds-frequency-hz] [us-channel-id]
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Examples
ubr7223#cable modem 172.172.172.12 change-freq 57000000Related Commands
cable modem max-hosts
To specify the maximum number of hosts per modem, use the cable modem max-hosts EXEC command. Use the no form of this command to set the number of hosts to 0:
cable modem [mac-addr | ip-addr] max-hosts [n | default]
no cable modem [mac-addr | ip-addr] max-hostsSyntax Description
mac-addr, ip-addr
Specify either the MAC address or the IP address for the cable modem.
max-hosts n or default
Specifies either the maximum number of hosts (from 0 to 255), or uses the default.
Defaults
0
Command Modes
EXEC
Command History
Examples
ubr7223#cable modem 172.172.172.12 max-hosts 39Related Commands
cable max-hosts
Sets the maximum number of hosts supported for an interface.
Overrides the frequency used by a cable modem.
cable telco-return enable
To enable telephone return support, use the cable telco-return enable interface configuration command. Use the no form of this command to disable this feature:
cable telco-return enable
no cable telco-return enableSyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Interface Configuration
Command History
Examples
ubr7233(config-if)#cable telco-return enableRelated Commands
Defines the interval for sending Telephony Channel Descriptor (TCD) and Termination System Information (TSI) messages.
cable telco-return interval
To specify the intervals for sending TCD enrollment messages and TSI messages, use the cable telco-return interval interface configuration command. Use the no form of this command to set the time interval to the default:
cable telco-return interval seconds
no cable telco-return intervalSyntax Description
seconds
Specifies the number of seconds for TCD or TSI messages. Valid range is from 2 to 60 seconds.
Defaults
2 seconds
Command Modes
Interface Configuration
Command History
Examples
ubr7223(config-if)#cable telco-return interval 40Related Commands
cable telco-return spd dhcp-authenticate
To set the DHCP Authenticate parameter in TCD messages as TRUE (1), which specifies the DHCP server that must be used, use the cable telco-return spd dhcp-authenticate interface configuration command. Use the no form of this command to set the DHCP Authenticate parameter to the default value and remove the parameter from subsequent TCD messages:
cable telco-return spd number dhcp-authenticate
no cable telco-return spd dhcp-authenticateSyntax Description
Defaults
FALSE (0)
Command Modes
Interface Configuration
Command History
Usage Guidelines
The DHCP Authenticate parameter, which is an optional parameter, is expressed as a boolean value.
Examples
ubr7223(config-if)#cable telco-return spd 2 dhcp-authenticateRelated Commands
cable telco-return spd dhcp-server
To specify the IP address of the DHCP server parameter in TCD messages, use the cable telco-return spd dhcp-server interface configuration command. Use the no form of this command to set the default value and remove the parameter from subsequent TCD messages:
cable telco-return spd number dhcp-server ip address
no cable telco-return spd dhcp-serverSyntax Description
Defaults
0
Command Modes
Interface Configuration
Command History
Examples
ubr7223(config-if)#cable telco-return spd 2 dhcp-server 206.44.207.255Related Commands
cable telco-return spd dial-timer
To specify the Demand Dial Timer TCD parameter for TCD messages, use the cable telco-return spd dial-timer EXEC command. Use the no form of this command to set the default value and remove the dial-timer parameter from subsequent TCD messages:
cable telco-return spd number dial-timer seconds
no cable telco-return spd dial-timerSyntax Description
spd number
Specifies the SPD number.
dial-timer seconds
Specifies the number of seconds of the Demand Dial Timer parameter for TCD messages. Valid range is from 0 to 4294967295.
Defaults
0
Command Modes
Interface Configuration
Command History
Examples
ubr7223(config-if)#cable telco-return spd 2 dial-timer 7200Related Commands
cable telco-return spd factory-default
To indicate the service provider descriptor (SPD) used by cable modems during the factory default procedure, use the cable telco-return spd factory-default interface configuration command. Use the no form of this command to disable this feature:
cable telco-return spd number factory-default
no cable telco-return spdSyntax Description
Defaults
No default behavior or values.
Command Modes
Interface Configuration
Command History
Usage Guidelines
The SPD specified is the factory default SPD.
Examples
ubr7223(config-if)#cable telco-return spd 2 factory-defaultRelated Commands
cable telco-return spd manual-dial
To specify the manual dial parameter in TCD messages, use the cable telco-return spd manual-dial interface configuration command. Use the no form of this command to remove the parameter from subsequent TCD messages:
cable telco-return spd number manual-dial
no cable telco-return spd number manual-dialSyntax Description
Defaults
No default behavior or values.
Command Modes
Interface Configuration
Command History
Examples
ubr7223(config-if)#cable telco-return spd 1 manual-dialRelated Commands
cable telco-return spd password
To specify the Login Password parameter in TCD messages, use the cable telco-return spd password interface configuration command. Use the no form of this command to remove the parameter from subsequent TCD messages:
cable telco-return spd number password string
no cable telco-return spd passwordSyntax Description
Defaults
No default behavior or values.
Command Modes
Interface Configuration
Command History
Examples
ubr7223(config-if)#cable telco-return spd 2 password 9JwoKd7Related Commands
cable telco-return spd phonenum
To specify the Telephone Numbers parameter in TCD messages, use the cable telco-return spd phonenum interface configuration command. Use the no form of this command to delete any or all previously entered telephone numbers.
cable telco-return spd number phonenum string
no cable telco-return spd number phonenumSyntax Description
spd number
Specifies the SPD number.
string
Specifies the telephone number to be used by the Telephone Numbers parameter in TCD messages.
Defaults
No default behavior or values.
Command Modes
Interface Configuration
Command History
Usage Guidelines
You can repeat this command to enter up to three telephone numbers that are mapped to the Telephone Numbers parameters (in TCD messages). The phone numbers appear as Phone Number 1, Phone Number 2, and Phone Number 3 in the order in which you enter them.
Examples
ubr7223(config-if)#cable telco-return spd 2 phonenum 9255551212Related Commands
cable telco-return spd ppp-authenticate
To specify the PPP Authentication parameter in TCD messages, use the cable telco-return spd ppp-authenticate EXEC command. Use the no form of this command to remove the parameter from subsequent TCD messages:
cable telco-return spd number ppp-authenticate [both | chap | pap]
no cable telco-return spd ppp-authenticateSyntax Description
spd number
Specifies the SPD number.
both
Specifies PAP and CHAP authentication.
chap
Specifies CHAP authentication.
pap
Specifies PAP authentication.
Defaults
No default behavior or values.
Command Modes
Interface Configuration
Command History
Examples
ubr7223(config-if)#cable telco-return spd 2 ppp-authenticate chapRelated Commands
cable telco-return spd radius-realm
To specify the RADIUS Realm service provider descriptor (SPD) parameter in TCD messages, use the cable telco-return spd radius-realm interface configuration command. Use the no form of this command to remove the parameter from subsequent TCD messages:
cable telco-return spd number radius-realm string
no cable telco-return spd number radius-realmSyntax Description
Defaults
No default behavior or values.
Command Modes
Interface Configuration
Command History
Examples
ubr7223(config-if)#cable telco-return spd radius-realm sunolRelated Commands
cable telco-return spd service-provider
To specify the Service Provider Name parameter in TCD messages, use the cable telco-return service-provider interface configuration command. Use the no form of this command to remove the parameter from subsequent TCD messages:
cable telco-return spd number service-provider string
no cable telco-return spd number service-providerSyntax Description
Defaults
No default behavior or values.
Command Modes
Interface Configuration
Command History
Examples
ubr7223(config-if)#cable telco-return spd 2 service-provider san_joseRelated Commands
cable telco-return spd threshold
To specify the Connection Attempt Threshold parameter for TCD messages, use the cable telco-return spd threshold interface configuration command. Use the no form of this command to set the default threshold:
cable telco-return spd number threshold number
no cable telco-return spd thresholdSyntax Description
spd number
Specifies the SPD number.
threshold number
Specifies the connection attempt threshold. Valid range is from 1 to 255.
Defaults
1
Command Modes
Interface Configuration
Command History
Examples
ubr7223(config-if)#cable telco-return spd 2 threshold 200Related Commands
cable telco-return spd username
To specify the Login Username parameter in TCD messages, use the cable telco-return spd username interface configuration command. Use the no form of this command to remove the parameter from subsequent TCD messages:
cable telco-return spd number username string
no cable telco-return spd number usernameSyntax Description
Defaults
No default behavior or values.
Command Modes
Interface Configuration
Command History
Examples
ubr7223(config-if)#cable telco-return spd 3 username sandyRelated Commands
cable upstream channel-width
To configure channel-width preferences, use the cable upstream channel-width interface configuration command. Use the no form of this command to use the default:
cable upstream usport channel-width first-choice-width [last-choice-width]
no cable upstream usport channel-widthSyntax Description
Defaults
1600000 hz
Command Modes
Interface Configuration
Command History
11.3(5)NA
This command was introduced.
12.0(4)XI
The last-choice-width option was added.
Usage Guidelines
Whenever possible, the system attempts to increase the channel width by one step. This command requires the MC16S card.
Examples
Router(config-if)#cable upstream 3 channel-width 160000 3200000Related Commands
cable upstream fec-strength
To override the forward error correction (FEC) setting specified in the modulation profile for this upstream channel, use the cable upstream fec-strength interface configuration command. Use the no form of this command to disable this feature:
cable upstream usport fec-strength t-bytes
no cable upstream usport fec-strengthSyntax Description
Defaults
No default behavior or values.
Command Modes
Interface Configuration
Command History
Examples
ubr7200(config-if)#cable upstream 2 fec-strength 3Related Commands
cable upstream hop algorithm
To configure the hop algorithm for the upstream port, use the cable upstream hop algorithm interface configuration command. Use the no form of this command to configure the optimum algorithm:
cable upstream usport hop algorithm {blind | optimum}
no cable upstream usport hop algorithmSyntax Description
usport
Specifies the upstream port number. Valid range is from 0 to 5.
blind
Selects the blind frequency hop algorithm.
optimum
Selects the optimum hop algorithm.
Defaults
Optimum.
Command Modes
Interface Configuration
Command History
Usage Guidelines
Install the MC16S card to use this feature.
Examples
ubr7200(config-if)#cable upstream 3 hop algorithm optimumRelated Commands
cable upstream modulation
To override modulation types specified in the modulation profile for the specified upstream channel, use the cable upstream modulation interface configuration command. Use the no form of this command to disable overriding modulation profiles:
cable upstream usport modulation first-choice-width [last-choice-width]
no cable upstream usport modulationSyntax Description
Defaults
No default behavior or values.
Command Modes
Interface Configuration
Command History
Usage Guidelines
The 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.
Install the MC16S card to use this feature.
Examples
ubr7200(config-if)#cable upstream 3 modulation qpsk qam16Related Commands
cable upstream rate-limit
To enable upstream rate limiting, use the cable upstream rate-limit interface configuration command:
cable upstream port# rate-limit [token bucket [shaping]]
Syntax Description
Defaults
No default behavior or values.
Command Modes
Interface Configuration
Command History
11.3(6)NA
This command was introduced.
11.3(9)NA
The shaping keyword was added.
Usage Guidelines
The host name entries will not be removed from nonvolatile random-access memory (NVRAM), but will be cleared in running memory.
Examples
ubr7200(config-if)#cable upstream 1 rate-limit token-bucket shapingRelated Commands
show cable hop
To display cable-hop statistics, use the show cable hop EXEC command:
show cable hop cable-if [upstream portnum]
Syntax Description
cable-if
Specifies the cable interface.
upstream portnum
(Optional) Specifies the upstream port for which to display the frequency hop status.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Examples
ubr7200>show cable hopUpstream Port Poll Missed Min Missed Hop Hop Corr UncorrPort Status Rate Poll Poll Poll Thres Period FEC FEC(ms) Count Sample Pcnt Pcnt (sec) Errors ErrorsCable4/0/U0 down 1000 * * * frequency not set * * * 0 0Cable4/0/U1 down 1000 * * * frequency not set * * * 0 0Cable4/0/U2 down 1000 * * * frequency not set * * * 0 0Cable4/0/U3 down 1000 * * * frequency not set * * * 0 0Cable4/0/U4 down 1000 * * * frequency not set * * * 0 0Cable4/0/U5 down 1000 * * * frequency not set * * * 0 0Cable5/0/U0 down 1000 * * * interface is down * * * 0 0Cable5/0/U1 down 1000 * * * frequency not set * * * 0 0Cable5/0/U2 down 1000 * * * interface is down * * * 0 0Cable5/0/U3 down 1000 * * * interface is down * * * 0 0Cable5/0/U4 down 1000 * * * interface is down * * * 0 0Cable5/0/U5 down 1000 * * * interface is down * * * 0 0Cable6/0/U0 down 1000 * * * interface is down * * * 0 0CMTS-ubr7223#show cable hop c2/0 upstream 2Upstream Port Poll Missed Min Missed Hop Hop Corr UncorrPort Status Rate Poll Poll Poll Thres Period FEC FEC(ms) Count Sample Pcnt Pcnt (sec) Errors ErrorsCable2/0/U2 admindown 1000 * * * frequency not set * * * 0 0Table 1
show cable hop Command Field Descriptions
Related Commands
show cable modem
Displays the cable modem statistics.
show cable host
Display the statistics for the host behind the cable modem.
show cable modem
To display cable-modem statistics, use the show cable modem EXEC command:
show cable modem ip-address
Syntax Description
ip-address
(Optional) Specifies the IP address of the cable modem for which you want to gather statistics.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
11.3 XA
This command was introduced.
12.0(4)XI
The output for this command was modified.
Examples
The following example clears all entries from the host name and address cache:
ubr7200#show cable modemInterface Prim Online Timing Rec QoS CPE IP address MAC addressSid State Offset PowerCable2/0/U0 1 online 2288 0.50 4 0 172.16.30.66 0010.7bb3.fb45Cable2/0/U0 2 online 2288 0.50 4 0 172.16.30.68 0010.7bb3.fb7bCable2/0/U0 3 init(i) 2280 0.00 2 0 172.16.30.69 0010.9500.05e
show cable noise
To display cable-noise statistics, use the show cable noise EXEC command:
show cable slot/port noise
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Examples
ubr7223#show cable 6/0 noiseRelated Commands
test cable awacs
To test the cable linecard using onboard spectrum management hardware, use the test cable awacs EXEC command:
test cable slot/port awacs
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
This command requires MC16S card.
Examples
ubr7200#test cable 6/3 awacsDebug Commands
This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.0 command references.
•
•
•
•
debug cable freqhop
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.
[no] debug cable freqhop
Syntax Description
This command has no arguments or keywords.
Defaults
Debugging for frequency hopping is not enabled.
Command History
Examples
ubr7223#debug cable freqhopCMTS freqhop debugging is ondebug cable hw-spectrum
To display debug messages for spectrum management (frequency agility), use the debug cable hw-spectrum EXEC command. Use the no form of this command to disable debugging output.
[no] debug cable hw-spectrum
Syntax Description
This command has no arguments or keywords.
Defaults
Debugging for spectrum management is not enabled.
Command History
12.0
This command was introduced as debug cable specmgmt.
12.0(4)XI
Command renamed to debug cable hw-spectrum.
Examples
ubr7223#debug cable hw-spectrumCMTS specmgmt debugging is ondebug cable telco-return
To display debug messages for telco-return events, use the debug cable telco-return EXEC command. Use the no form of this command to disable debugging output.
[no] debug cable telco return
Syntax Description
This command has no arguments or keywords.
Defaults
Debugging for telco-return events is not enabled.
Command History
Examples
CMTS-ubr7223#debug cable telco-returnCMTS telco-return debugging is onRelated Commands
debug telco-return msg
To display debug messages for telco-return events, use the debug cable telco-return msg EXEC command. Use the no form of this command to disable debugging output.
[no] debug cable telco-return msg
Syntax Description
This command has no arguments or keywords.
Defaults
Debugging for telco-return messages is not enabled.
Command History
Examples
ubr7223#debug cable telco-return msgCMTS telco-return msg debugging is onRelated Commands
Guest