|
|
This feature module provides software support for 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:
Spectrum management enhancements improve system-wide throughput and increase efficiency of bandwidth utilization.
For more information on cable routers, see:
Cisco uBR7200 Series
None
Perform the following tasks to configure the features discussed in this document:
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>
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.
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]]
shaping | Enables shaping with default parameters. To change the defaults, you can specify granularity (which is the traffic shaping granularity in msec), or you can specify max-delay (which is the maximum traffic shaping buffering delay in msec). |
No default behavior or values.
EXEC
| Release | Modification |
|---|---|
11.3(5)NA | This command was introduced |
12.0(4)XI | The shaping keyword was added. |
ubr7223(config-if)#cable downstream rate-limit token-bucket shaping
| Command | Description |
Controls upstream rate limiting. |
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
n | Specifies the maximum number of hosts supported per cable modem. Valid range is from 0 to 255. |
No default behavior or values.
Interface Configuration
| Release | Modification |
|---|---|
2.0(4)XI | This command was introduced. |
ubr7223(config-if)#cable max-hosts 15
| Command | Description |
cable modem max-hosts | Specifies the maximum number of hosts supported per modem. |
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]
mac-addr|ip-addr | 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. |
No default behavior or values.
EXEC
| Release | Modification |
|---|---|
12.0(4)XI | This command was introduced. |
ubr7223#cable modem 172.172.172.12 change-freq 57000000
| Command | Description |
Deletes entries from the host name and address cache. |
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]
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. |
0
EXEC
| Release | Modification |
|---|---|
12.0(4)XI | This command was introduced. |
ubr7223#cable modem 172.172.172.12 max-hosts 39
| Command | Description |
cable max-hosts | Sets the maximum number of hosts supported for an interface. |
Overrides the frequency used by a cable modem. |
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]
usport | Specifies the upstream port number. Valid range is from 0 to 5. |
first-choice-width | Specifies the upstream channel width in Hertz. Valid values are 200000, 400000, 800000, 1600000, and 3200000 Hz. The corresponding symbol rates are 200, 400, 800, 1600, and 3200, ksym/s. |
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 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. |
1600000 hz
Interface Configuration
| Release | Modification |
|---|---|
11.3(5)NA | This command was introduced. |
12.0(4)XI | The last-choice-width option was added. |
Whenever possible, the system attempts to increase the channel width by one step. This command requires the MC16S card.
Router(config-if)#cable upstream 3 channel-width 160000 3200000
| Command | Description |
cable upstream fec-strength | Overrides the forward error correction (FEC) setting specified in the modulation profile for an upstream channel. |
cable upstream hop algorithm | Configures the hop algorithm for the upstream port. |
cable upstream modulation | Overrides modulation types specified in the modulation profile for an upstream channel. |
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
usport | Specifies the upstream port number. Valid range is from 0 to 5. |
t-bytes | Overrides the FEC strength specified in the modulation profile for this upstream channel. Valid values are: |
No default behavior or values.
Interface Configuration
| Release | Modification |
|---|---|
12.0(4)XI | This command was introduced. |
ubr7200(config-if)#cable upstream 2 fec-strength 3
| Command | Description |
cable upstream fec | Enables forward error correction. |
cable upstream channel-width | Configures channel-width preferences. |
cable upstream hop algorithm | Configures the hop algorithm for the upstream port. |
cable upstream modulation | Overrides modulation types specified in the modulation profile for an upstream channel. |
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}
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. |
Optimum.
Interface Configuration
| Release | Modification |
|---|---|
12.0(4)XI | This command was introduced. |
Install the MC16S card to use this feature.
ubr7200(config-if)#cable upstream 3 hop algorithm optimum
| Command | Description |
cable upstream channel-width | Configures channel-width preferences. |
cable upstream fec-strength | Overrides the forward error correction (FEC) setting specified in the modulation profile for an upstream channel. |
cable upstream modulation | Overrides modulation types specified in the modulation profile for an upstream channel. |
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]
usport | Specifies the upstream port number. Valid range is from 0 to 5. |
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 this parameter is different from the first-choice-mod setting or it will be ignored. When used, this parameter enables modulation management algorithms. |
No default behavior or values.
Interface Configuration
| Release | Modification |
|---|---|
12.0(4)XI | This command was introduced. |
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.
ubr7200(config-if)#cable upstream 3 modulation qpsk qam16
| Command | Description |
cable upstream modulation-profile | Assigns a modulation profile to an interface. |
cable upstream channel-width | Configures channel-width preferences. |
cable upstream fec-strength | Overrides the forward error correction (FEC) setting specified in the modulation profile for an upstream channel. |
cable upstream hop algorithm | Configures the hop algorithm for the upstream port. |
To enable upstream rate limiting, use the cable upstream rate-limit interface configuration command:
cable upstream port# rate-limit [token bucket [shaping]]
shaping | (Optional) Uses the default mode of token bucket policing with grant shaping. |
No default behavior or values.
Interface Configuration
| Release | Modification |
|---|---|
11.3(6)NA | This command was introduced. |
11.3(9)NA | The shaping keyword was added. |
The host name entries will not be removed from nonvolatile random-access memory (NVRAM), but will be cleared in running memory.
ubr7200(config-if)#cable upstream 1 rate-limit token-bucket shaping
| Command | Description |
Controls downstream rate limiting. |
To display cable-hop statistics, use the show cable hop EXEC command:
show cable hop cable-if [upstream portnum]
cable-if | Specifies the cable interface. |
upstream portnum | (Optional) Specifies the upstream port for which to display the frequency hop status. |
No default behavior or values.
EXEC
| Release | Modification |
|---|---|
12.0(4)XI | This command was introduced. |
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
| 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 msec). |
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 FEC errors on this upstream port. Forward error corrections (FECs) measure noise. |
Uncorr FEC Errors | The number of uncorrectable FEC errors on this upstream port. |
| Command | Description |
show cable modem | Displays the cable modem statistics. |
show cable host | Display the statistics for the host behind the cable modem. |
To display cable-modem statistics, use the show cable modem EXEC command:
show cable modem ip-address
ip-address | (Optional) Specifies the IP address of the cable modem for which you want to gather statistics. |
No default behavior or values.
EXEC
| Release | Modification |
|---|---|
11.3 XA | This command was introduced. |
12.0(4)XI | The output for this command was modified. |
The following example clears all entries from the host name and address cache:
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
| Field | Description |
|---|---|
Interface | The interface on which the cable modem has an active connection. |
Prim Sid | The primary service identifier assigned to the 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. |
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. |
IP address | The IP address of the modem. |
MAC address | The media access layer address of the modem. |
To display cable-noise statistics, use the show cable noise EXEC command:
show cable slot/port noise
slot/port | Specifies the slot and port number for which information is to be collected. |
No default behavior or values.
EXEC
| Release | Modification |
|---|---|
12.0(4)XI | This command was introduced. |
ubr7223#show cable 6/0 noise
| Command | Description |
show cable modem | Displays the statistics for the specified cable modem. |
To test the cable linecard using onboard spectrum management hardware, use the test cable awacs EXEC command:
test cable slot/port awacs
slot/port | Specifies the slot and port number for which information is to be collected. |
No default behavior or values.
EXEC
| Release | Modification |
|---|---|
12.0(4)XI | This command was introduced. |
This command requires MC16S card.
ubr7200#test cable 6/3 awacs
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.
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 freqhopThis command has no arguments or keywords.
Debugging for frequency hopping is not enabled.
| Release | Modification |
|---|---|
12.0(4)XI | This command was introduced. |
ubr7223#debug cable freqhop CMTS freqhop debugging is on
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-spectrumThis command has no arguments or keywords.
Debugging for spectrum management is not enabled.
| Release | Modification |
|---|---|
12.0 | This command was introduced as debug cable specmgmt. |
12.0(4)XI | Command renamed to debug cable hw-spectrum. |
ubr7223#debug cable hw-spectrum CMTS specmgmt debugging is on
Posted: Mon Jul 26 19:52:43 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.