cisco cbr converged broadband routers layer 2 and docsis 3.0 … · qam profile id 0:...

Cisco cBR Converged Broadband Routers Layer 2 and DOCSIS 3.0Configuration Guide for Cisco IOS XE Gibraltar 16.10.xFirst Published: 2018-12-07

Americas HeadquartersCisco Systems, Inc.170 West Tasman DriveSan Jose, CA 95134-1706USAhttp://www.cisco.comTel: 408 526-4000

800 553-NETS (6387)Fax: 408 527-0883

C H A P T E R 1Downstream Interface Configuration

This document describes how to configure the downstream interfaces on the Cisco cBR Series ConvergedBroadband Router.

• Finding Feature Information, on page 1• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 1• Information About Downstream Interface Configuration , on page 2• How to Configure Downstream Interfaces, on page 4• Configuration Examples, on page 9• Additional References, on page 12• Feature Information for Downstream Interface Configuration on the Cisco cBR Router, on page 13

Finding Feature InformationYour software release may not support all the features that are documented in this module. For the latestfeature information and caveats, see the release notes for your platform and software release. The FeatureInformation Table at the end of this document provides information about the documented features and liststhe releases in which each feature is supported.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support.To access Cisco Feature Navigator, go to http://tools.cisco.com/ITDIT/CFN/. An account onhttp://www.cisco.com/ is not required.

HardwareCompatibilityMatrixfor theCiscocBRSeriesRouters

The hardware components that are introduced in a given Cisco IOS-XERelease are supported in all subsequentreleases unless otherwise specified.

Note

Cisco cBR Converged Broadband Routers Layer 2 and DOCSIS 3.0 Configuration Guide for Cisco IOS XE Gibraltar 16.10.x1

http://tools.cisco.com/ITDIT/CFN/

http://www.cisco.com/

Table 1: Hardware Compatibility Matrix for the Cisco cBR Series Routers

Interface CardsProcessor EngineCisco CMTS Platform

Cisco IOS-XE Release 16.5.1 andLater Releases

Cisco cBR-8 CCAP Line Cards:

• PID—CBR-LC-8D30-16U30


• PID—CBR-RF-PIC

• PID—CBR-RF-PROT-PIC

• PID—CBR-CCAP-LC-40G

• PID—CBR-CCAP-LC-40G-R

• PID—CBR-CCAP-LC-G2-R

• PID—CBR-2X100G-PIC

Digital PICs:

• PID—CBR-DPIC-8X10G

•

Cisco cBR-8 Downstream PHYModules:

• PID—CBR-D30-DS-MOD


Cisco cBR-8 Upstream PHYModules:

• PID—CBR-D31-US-MOD


Cisco cBR-8 Supervisor:

• PID—CBR-SUP-250G

• PID—CBR-CCAP-SUP-160G

• PID—CBR-SUP-8X10G-PIC


Cisco cBR-8ConvergedBroadbandRouter

Information About Downstream Interface ConfigurationOverview

• Each downstream port requires port level configuration and channel level configuration. Port levelconfiguration is optimized with a frequency profile that defines ranges of frequencies available on theport. Channel level configuration is optimized with a QAM profile and channel range configuration blockthat auto-increments frequency and duplicates annex, modulation, and interleaver.

• Each channel requires a set of parameters: frequency, annex, modulation, interleaver, and DOCSISchannel id.

• Configuration is done in 4 major blocks of configuration:


Downstream Interface ConfigurationInformation About Downstream Interface Configuration

• QAM Profile—Example: “cable downstream qam-profile 1”

• Frequency Profile—Example: “cable downstream freq-profile 2”

• Port/Controller—Example: “controller Integrated-Cable 3/0/0”

• RF Channel block—Example: “rf-chan 0 31”

Downstream RF Port and Channel Management

The downstreamRF port and channel management feature is responsible for the configuration andmanagementof the downstreamRF ports and channels. Each downstreamRF channel can be provisioned either as a DOCSISor traditional MPEG video QAM channel.

QAM Profile

A QAM profile describes the common downstream channel modulator settings, referred to as physical layerparameters. This includes QAM constellation, symbol rate, interleaver-depth, spectrum-inversion, and annex.The QAM profile is described by CCAP DownPhyParams object. Default QAM profiles are supported andcustomized for DOCSIS or MPEG Video, which are described as DocsisPhyDefault and VideoPhyDefaultobjects, respectively.

A maximum of 32 QAM profiles can be defined. There are six system-defined QAM profiles (0 to 5), whichcannot be deleted or modified. You can define profiles 6 to 31.

The system defined profiles are:

• Profile 0 - default-annex-b-64-qam

• interleaver-depth: I32-J4

• symbol rate: 5057 kilo-symbol/second

• spectrum-inversion: off





• Profile 2 - default-annex-a-64-qam




• Profile 3 - default-annex-a-256-qam





Downstream Interface ConfigurationInformation About Downstream Interface Configuration









Spectrum Inversion

Spectrum inversion happens as a result of mixing processes in RF or IF electronics. Spectrum inversion allowsfor the adaptation of older equipment with the new plant. The mixing of I and Q are used to create a quadrantprofile. For some settops, the inversion of the quadrant profile is needed where the axis are flipped such thatI represents the X and Q represents the Y-axis. Most modern equipment can detect and resolve the inversionsplit.

You can change this spectrum inversion configuration on a user-defined qam-profile. It cannot be changedon a system generated qam-profile from 0 to 5.

Frequency Profile

A frequency profile defines the ranges of frequencies available on a port. A maximum of 16 frequency profilescan be defined. There are four system-defined frequency profiles (0 to 3), which cannot be deleted or modified.You can define profiles 4 to 15.

The system defined profiles are:

• Profile 0 - annex-b-low, Frequency range (Hz): 90000000 - 863999999

• Profile 1 - annex-b-high, Frequency range (Hz): 234000000 - 1002999999

• Profile 2 - annex-a-low, Frequency range (Hz): 94000000 - 867999999

• Profile 3 - annex-a-high, Frequency range (Hz): 267000000 - 1002999999

The frequency ranges are defined using lanes and blocks:

• Four lanes per port, each lane can support 216 MHz range.

• Four blocks per lane, each block can support 54 MHz range.

• Lanes and blocks may have overlapping frequency ranges.

How to Configure Downstream InterfacesThis section contains the following:


Downstream Interface ConfigurationHow to Configure Downstream Interfaces

Configuring the Cisco CMTS Manually Using Configuration ModeConnect a console terminal to the console port on the I/O controller. When asked if you want to enter theinitial dialog, answer no to go into the normal operating mode of the router. After a few seconds the userEXEC prompt (Router>) appears.

Configuring the QAM Profile on the Downstream Channels

Procedure

PurposeCommand or Action

Enables privileged EXEC mode.enableStep 1

Example: Enter your password if prompted.Router> enable

Enters global configuration mode.configure terminal

Example:

Step 2

Router# configure terminal

Defines or modifies a QAM profile.cable downstream qam-profile Qam_Profile_ID

Example:

Step 3

Router(config)# cable downstream qam-profile 3

Defines the profile MPEG framing format. The default isAnnex B.

annex {A | B | C}

Example:

Step 4

Router(config-qam-prof)# annex A

Name or description for this profile.description LINE

Example:

Step 5

Router(config-qam-prof)# description qam1

Defines the interleaver depth. The default is I32 J4 forDOCSIS.

interleaver-depth {I12-J17 | I128-J1 | I128-J2 | I128-J3| I128-J4 | I128-J5 | I128-J6 | I128-J7 | I128-J8 | I16-J8| I32-J4 | I64-J2 | I8-J16}

Step 6

Example:Router(config-qam-prof)# interleaver-depth I64-J2

Defines the modulation. The default is 256QAM.modulation {256 | 64}

Example:

Step 7

Router(config-qam-prof)# modulation 64

Enables or disables spectrum inversion. Default is off.spectrum-inversion {off | on}

Example:

Step 8

Router(config-qam-prof)# spectrum-inversion on


Downstream Interface ConfigurationConfiguring the Cisco CMTS Manually Using Configuration Mode


Defines the symbol rate. Value is in kilo-symbol/sec.symbol-rate value

Example:

Step 9

Router(config-qam-prof)# symbol-rate 5057

Exits from the QAM profile configuration mode.exit

Example:

Step 10

Router(config-qam-prof)# exit

Configuring the Frequency Profile on the Downstream Channels

Procedure





Example:

Step 2


Defines or modifies a frequency profile.cable downstream freq-profile DS_frequency_profile_ID

Example:

Step 3

Router(config)# cable downstream freq-profile 4

Defines the frequency lanes.lane lane_id start-freq start_freq_value

Example:

Step 4

Router(config-freq-prof)# lane 1 start-freq90000000

Configures the lane frequency blocks.block block_id start-freq bl_start_freq_value

Example:

Step 5

Router(config-freq-prof-lane)#block 1 start-freq90000000Router(config-freq-prof-lane)#

Exits from the frequency lane configuration mode.exit

Example:

Step 6

Router(config-freq-prof-lane)# exit


Downstream Interface ConfigurationConfiguring the Frequency Profile on the Downstream Channels

Configuring the Controller on the Downstream Channels

Procedure





Example:

Step 2


Enters the controller sub-mode.controller integrated-cable slot/subslot/port

Example:

Step 3

Router(config)#controller Integrated-Cable 3/0/0

Sets the base channel power level. If not specified, thedefault value is calculated based on the number of carriers.

base-channel-power value

Example:

Step 4

Maximum limit is 34 dBmVDRFI. If you configure a valueRouter(config-controller)#base-channel-power 26 greater than the maximum specified by DRFI, the following

message is displayed:

Caution: RF Power above DRFI specification. May resultin minor fidelity degradation.

Specifies the frequency profile for the port.freq-profile number

Example:

Step 5

Router(config-controller)#freq-profile 0

Specifies the maximum number of carriers.max-carrier value

Example:

Step 6

Router(config-controller)#max-carrier 1

Mutes the port. Use the no prefix to unmute the port. Defaultis "no mute".

mute

Example:

Step 7

Router(config-controller)#mute

Enters RF channel configuration sub-mode to configure anindividual channel or a block of channels.

rf-chan starting_Qam_ID ending_Qam_ID

Example:

Step 8

Router(config-controller)#rf-chan 0 1

Changes the port administration state to down. Use the noprefix to change the port administration state to up.

shutdown

Example:

Step 9

Router(config-controller)#shutdown


Downstream Interface ConfigurationConfiguring the Controller on the Downstream Channels

Troubleshooting Tips

Shutting and No Shutting Downstream Controller Immediately

Problem Shutting down a downstream controller on a cable line card and bringing the controller back upimmediately can cause a Queue ID Pending Drain event on the system. This results in traffic disruption tothe modems or modems going offline.

Solution It is recommended that you wait for a few seconds (>30 secs) before issuing the no shut commandon a shut downstream controller. The system also restricts the user from issuing the no shut commandimmediately by printing this message.

Config change could not be applied as a cleanup is pending following shut oncontroller x/x/x. Please wait for the cleanup to complete before attempting tono shut controller.

Configuring the RF Channel on a ControllerThe RF channel submode is entered from the channel controller configuration submode using the rf-chancommand as described in the previous section. If an individual channel was specified in the rf-chan command,only that channel configuration is changed. If a block of channels was specified in the rf-chan command, theconfiguration change is applied to all channels in the block.

If the user tries to add a video type RF channel to a cable interface, the following message appears to rejectthe configuration:X/X/X rf-channel XX is video type channel, it can't be configured as primary DS

If a RF channel is configured under cable interface, when the user tries to change the channel type to video,the following message appears to reject the configuration:X/X/X rf channel X can't be set to video type.It is configured under Cable1/0/1.Please remove the configuration before change the qam type

Note

Step 1 docsis-channel-id dcid

Example:Router(config-rf-chan)#docsis-channel-id 1

Changes the channel DOCSIS channel identifier. In blockmode, the value is assigned to the first channel and incrementedfor successive channels.

Step 2 frequency value

Example:Router(config-rf-chan)#frequency 93000000

Configures the channel's center frequency in Hz. The available frequency range is determined from the port's frequencyprofile, if configured. If not configured, the available range will be the full port spectrum. In block mode, the frequencywill be assigned to the first channel. Successive channels will get the next center frequency for the annex specified in theQAM profile (+6 Hz for Annex B, +8 Hz for Annex A).


Downstream Interface ConfigurationTroubleshooting Tips

Step 3 mute

Example:Router(config-rf-chan)#mute

Mutes the RF channel. Enter the no prefix to unmute the channel. Default is "no mute".

Step 4 power-adjust pwr_adj_range

Example:Router(config-rf-chan)#power-adjust 8.0 - 0.0 dBmV

Adjusts the RF channel's power.

Step 5 qam-profile qam_profile_number

Example:Router(config-rf-chan)#qam-profile 0

Specifies the QAM profile for this channel.

Step 6 rf-output value

Example:Router(config-rf-chan)#rf-output normal

Changes the RF output mode to test the channel.

Step 7 shutdown

Example:Router(config-rf-chan)#shutdown

Changes the channel administration state to down. Use the no prefix to change the channel administration state to up.The default is "no shut".

Step 8 type value

Example:Router(config-rf-chan)#type video

Configures the channel QAM type. The default is DOCSIS.

Configuration ExamplesDownstream Interface Configuration Example

The example below shows the configuration of:

• QAM Profile—The system defined QAM profile for Annex B and 256 QAM.

• Frequency Profile—The system defined frequency profile annex-b-low.

• Controller and RF channel—Port 0 on slot 3/0 with frequency profile 0; 96 channels with QAM profile1 and center frequencies starting at 93 MHz.


Downstream Interface ConfigurationConfiguration Examples

cable downstream qam-profile 1annex Bmodulation 256interleaver-depth I32-J4symbol-rate 5361spectrum-inversion offdescription default-annex-b-256-qam

cable downstream freq-profile 0lane 1 start-freq 90000000block 1 start-freq 90000000block 2 start-freq 138000000block 3 start-freq 186000000block 4 start-freq 234000000

lane 2 start-freq 282000000block 1 start-freq 282000000block 2 start-freq 330000000block 3 start-freq 378000000block 4 start-freq 426000000



controller Integrated-Cable 3/0/0max-carrier 128base-channel-power 34freq-profile 0rf-chan 0 95type DOCSISfrequency 93000000rf-output NORMALpower-adjust 0docsis-channel-id 1qam-profile 1

Show Command Examples for Displaying the State

Use the following commands to display the state of any QAMprofile, Frequency profile, downstream controlleror channel.

QAM Profile Configuration Example

Router#show cable qam-profile 0QAM Profile ID 0: default-annex-b-64-qam

annex: Bmodulation: 64interleaver-depth: I32-J4symbol rate: 5057 kilo-symbol/secondspectrum-inversion: off

Router#



Frequency Profile Configuration Example

Router#show cable freq-profile 0Frequency Profile ID 0 annex-b-low:

Lane 1 start-freq 90000000hzBlock 1 start-freq 90000000hzBlock 2 start-freq 138000000hzBlock 3 start-freq 186000000hzBlock 4 start-freq 234000000hz




Router#

Controller Configuration Example

Router#show controller Integrated-Cable 3/0/0 rf-portAdmin: UP MaxCarrier: 128 BasePower: 34 dBmV Mode: normalRf Module 0: UPFrequency profile: 0Free freq block list has 1 blocks:666000000 - 863999999

Rf Port Status: UPRouter#

RF Channel Configuration Example

Router#show controller integrated-Cable 3/0/0 rf-channel 0-3 95Chan State Admin Frequency Type Annex Mod srate Interleaver dcid power output0 UP UP 93000000 DOCSIS B 256 5361 I32-J4 1 34 NORMAL1 UP UP 99000000 DOCSIS B 256 5361 I32-J4 2 34 NORMAL2 UP UP 105000000 DOCSIS B 256 5361 I32-J4 3 34 NORMAL3 UP UP 111000000 DOCSIS B 256 5361 I32-J4 4 34 NORMAL95 UP UP 663000000 DOCSIS B 256 5361 I32-J4 96 34 NORMAL

Router# show controller integrated-Cable 3/0/0 rf-channel 0 verboseChan State Admin Frequency Type Annex Mod srate Interleaver dcid power output0 UP UP 93000000 DOCSIS B 256 5361 I32-J4 1 34 NORMALQam profile: 1Spectrum Inversion: OffFrequency Lane: 1 Block: 1 index: 1Resource status: OKLicense: granted <02:00:04 EDT Jan 2 2012>JIB channel number: 0Chan EnqQ Pipe RAF SyncTmr Vid Mac Video Primary DqQ TM Mpts Sniff

0 0 0 4 0 0 0000.0000.0000 0 0 0 0 0 NOGrp Prio P Prate Phy0-ctl Phy1-ctl Enable Tun-Id L2TPv3_Ses_id

0 0 0 1 1 0 TRUE 0 0Chan Qos-Hi Qos-Lo Med-Hi Med-Lo Low-Hi Low-Lo

0 32774 16384 32768 16384 65536 32768



Chan Med Low TB-neg Qos_Exc Med_Xof Low_Xof Qdrops Pos Qlen(Hi-Med-lo) Fl0 0 0 0 0 0 0 0 Y 0 0 0 0

DSPHY Info:DSPHY Register Local Copy: QPRHI = c0000163, QPRLO = e30d0DSPHY Register Local Copy Vaddr = 80000290, qam2max_mapping = 80000000DSPHY Register Local Copy: SPR ID = 0, SPR Mapping= c200000aLast read from HW: Mon Jan 2 02:02:04 2012QPRHI = c0000163, QPRLO = e30d0, SPR = c200000a SPRMAPING c0000000 Q2Max 80000000Last time read spr rate info from HW: Mon Jan 2 13:21:41 2012SPR ID 0, rate value in kbps 0, overflow count 0, underflow count 0

Router# sh controllers Integrated-Cable 7/0/0 counter rf-channelController RF MPEG MPEG MPEG Sync MAP/UCD User QAM

Chan Packets bps Mbps Packets Packets Mbps UtilTx Tx Tx Percentage

7/0/0 0 0 0 00.00 0 0 00.00 000.007/0/0 1 0 0 00.00 0 0 00.00 000.007/0/0 2 8239954 2475952 02.47 0 0 02.39 006.607/0/0 3 85927382 25769779 25.76 0 0 24.94 068.717/0/0 4 85927608 25769027 25.76 0 0 24.94 068.717/0/0 5 8239088 2474599 02.47 0 0 02.39 006.597/0/0 6 8210840 2463770 02.46 0 0 02.38 006.577/0/0 7 50103 15040 00.01 0 0 00.01 000.047/0/0 8 50103 15040 00.01 0 0 00.01 000.04

Router# show cable licenses ds--------------------------------------------Entitlement: Downstream LicenseConsumed count: 672Consumed count reported to SmartAgent: 672Forced-Shut count: 0Enforced state: No Enforcement

Router#

Additional ReferencesTechnical Assistance

LinkDescription

http://www.cisco.com/supportThe Cisco Support website provides extensive online resources, includingdocumentation and tools for troubleshooting and resolving technical issueswith Cisco products and technologies.

To receive security and technical information about your products, you cansubscribe to various services, such as the Product Alert Tool (accessed fromField Notices), the Cisco Technical Services Newsletter, and Really SimpleSyndication (RSS) Feeds.

Access to most tools on the Cisco Support website requires a Cisco.com userID and password.


Downstream Interface ConfigurationAdditional References

http://www.cisco.com/support

Feature Information for Downstream Interface Configuration onthe Cisco cBR Router

Use Cisco Feature Navigator to find information about the platform support and software image support.Cisco Feature Navigator enables you to determine which software images support a specific software release,feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An accounton the Cisco.com page is not required.

The following table lists the software release in which a given feature is introduced. Unless noted otherwise,subsequent releases of that software release train also support that feature.

Note

Table 2: Feature Information for Downstream Interface Configuration

Feature InformationReleasesFeature Name

This feature was integrated on theCisco cBR Series ConvergedBroadband Routers.

Cisco IOS XE Fuji 16.7.1Downstream InterfaceConfiguration


Cisco IOS XE Gibraltar 16.10.1fDisplay QAM UtillizationPercentage using the sh controllersIntegrated-Cable 7/0/0 counterrf-channel


Downstream Interface ConfigurationFeature Information for Downstream Interface Configuration on the Cisco cBR Router

https://cfnng.cisco.com/


Downstream Interface ConfigurationFeature Information for Downstream Interface Configuration on the Cisco cBR Router

C H A P T E R 2Upstream Interface Configuration

This document describes how to configure the upstream interfaces on the Cisco cBR Series ConvergedBroadband Router.

• Finding Feature Information, on page 15• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 15• Information About Upstream Interface Configuration, on page 16• How to Configure Upstream Interfaces, on page 17• Configuration Examples, on page 20• Additional References, on page 21• Feature Information for Upstream Interface Configuration on the Cisco cBR Router, on page 21





Note
















Digital PICs:


•













Information About Upstream Interface ConfigurationThe cable interface in the Cisco cBR router supports upstream signals and serves as the radio frequency (RF)interface. This chapter provides an overview of the upstream interfaces on the Cisco cBR Series ConvergedBroadband Router.

Cisco IOS XE Fuji 16.9.1 and later releases support 10 Gbps of upstream throughput on the following linecards on the Cisco cBR Series Converged Broadband Router:

• CBR-CCAP-LC-40G

• CBR-CCAP-LC-40G-R


Upstream Interface ConfigurationInformation About Upstream Interface Configuration

Upstream Channel Management

UpstreamChannelManagement (UCM) is responsible for the physical (PHY) layer configuration and resourcemanagement of upstream channels in the Cisco cBR Series Converged Broadband Router.

Upstream Controller

An upstream port represents a physical upstream RF connector on a cable line card, connected to one or morefiber nodes. An upstream RF port is a container of upstream RF channels, which imposes constraints on bothtopology and spectrum for the group of RF channels contained in the physical port. An upstream RF port alsorepresents the RF front-end hardware component on a cable line card including the connector, variable gainadjustment (VGA), and A/D converter. This is directly connected to a set of upstream physical channelreceivers. The number of upstream physical channels per port is thus constrained by the number of receiversaccessible to the port.

Upstream Channel

An upstream RF channel represents DOCSIS physical layer operation on a single upstream center frequencywith a particular channel width. It is contained by a single physical port on the CMTS line card hardware.

Upstream Resource Management

The upstream resource management (URM) feature is primarily responsible for the maintenance of therelationship between a physical upstream connector on the line card and the upstream RF channels receivedon that connector.

How to Configure Upstream InterfacesThis section contains the following:

Configuring the Cisco CMTS Manually Using Configuration ModeConnect a console terminal to the console port on the I/O controller. When asked if you want to enter theinitial dialog, answer no to go into the normal operating mode of the router. After a few seconds the userEXEC prompt (Router>) appears.

Configuring the Modulation Profile and Assigning to an Upstream Channel

Procedure





Example:

Step 2



Upstream Interface ConfigurationHow to Configure Upstream Interfaces


Creates a preconfigured modulation profile, where the burstparameters are set to their default values for each burst type.

cable modulation-profile profile mode_of_operqam_profile

Example:

Step 3

Router(config)# cable modulation-profile 23 tdmaqam-16

Enters the controller interface configuration mode.Controller Upstream-Cable slot/subslot/port

Example:

Step 4

Router(config)# Controller Upstream-Cable 7/0/0

Assigns up to three modulation profiles to an upstream port.us-channel n modulation-profile primary-profile-number[secondary-profile-number] [tertiary-profile-number]

Step 5

Example:Router(config-if)#cable upstreamus-channel 0modulation-profile 23

Exits controller configuration submode and returns toprivileged EXEC mode.

end

Example:

Step 6

Router(config-controller)# end

Configuring the Upstream Channel with PHY Layer

Procedure





Example:

Step 2


Specifies the controller interface line card and entersupstream controller config configuration submode.

controller upstream-cable slot/subslot/port

Example:

Step 3

Router(config)# controller upstream-cable 1/0/0

Assigns frequency to an RF channel on a controllerinterface.

us-channel rf-channel frequency freq-val

Example:

Step 4

Router(config-controller)# us-channel 1 frequency20000000


Upstream Interface ConfigurationConfiguring the Upstream Channel with PHY Layer


Assigns DOCSIS mode to an RF channel on a controllerinterface.

us-channel rf-channel docsis-mode mode

Example:

Step 5

Router(config-controller)# us-channel 1 docsis-modetdma

Assigns channel width in Hertz to an RF channel on acontroller interface.

us-channel rf-channel channel-width value

Example:

Step 6

Router(config-controller)# us-channel 1channel-width 3200000

Assigns modulation profile to an RF channel on a controllerinterface.

us-channel rf-channel modulation-profile profile

Example:

Step 7

Router(config-controller)# us-channel 1modulation-profile 21

Enables the upstream channel.no us-channel rf-channel shutdown

Example:

Step 8

Router(config-controller)# no us-channel 1 shutdown

Exits upstream controller configuration submode and returnsto privileged EXEC mode.

end

Example:

Step 9


AssociatingUpstreamChannelswithaMACDomainandConfiguringUpstreamBonding

Procedure





Example:

Step 2


Specifies the cable interface line card on a Cisco CMTSrouter.

interface cable slot/subslot/cable-interface-index

Example:

Step 3

Router(config)# interface cable 7/0/0


Upstream Interface ConfigurationAssociating Upstream Channels with a MAC Domain and Configuring Upstream Bonding


Associates a set of upstream channels to the integrateddownstream channels.

downstream integrated-cable slot/subslot/port rf-channelrf-chan [upstream grouplist]

Example:

Step 4

Router(config-if)# downstream integrated-cable7/0/0 rf-channel 3 upstream 3

Associates a set of physical upstream channels with theMac Domain.

upstream md-us-chan-id upstream-cable slot/subslot/portus-channel rf-channel

Example:

Step 5

Router(config-if)# upstream 0 upstream-cable 7/0/0us-channel 0

Creates the upstream bonding group on the specified cableinterface and enters upstream bonding configurationsubmode.

cable upstream bonding-group id

Example:Router(config-if)# cable upstream bonding-group200

Step 6

Adds an upstream channel to the upstream bonding group.upstream numberStep 7

Example: Amaximum of 16 upstream channels can be configured foreach MAC Domain, which are divided into two groups:Router(config-upstream-bonding)# upstream 1

• Group 1: upstream channel 0-7• Group 2: upstream channel 8-15

The upstream bonding-group should include all theupstream channels either from Group 1 or Group 2 only.

Modifies the attribute value for the specified upstreambonding group.

attributes value

Example:

Step 8

Router(config-upstream-bonding)# attributeseeeeeeee

Exits upstream bonding configuration submode and returnsto privileged EXEC mode.

end

Example:

Step 9

Router(config-upstream-bonding)# end

Configuration ExamplesUpstream Channel with PHY Layer Configuration Example

...us-channel 0 frequency 20000000us-channel 0 channel-width 3200000 3200000us-channel 0 power-level 0us-channel 0 docsis-mode tdmaus-channel 0 minislot-size 2us-channel 0 modulation-profile 21


Upstream Interface ConfigurationConfiguration Examples

no us-channel 0 shutdown...

Upstream Channels with a MAC Domain Configuration Example

...interface Cable8/0/0downstream Modular-Cable 8/0/0 rf-channel 0upstream 0 Upstream-Cable 8/0/0 us-channel 0upstream 1 Upstream-Cable 8/0/0 us-channel 1cable mtc-modecable upstream bonding-group 1upstream 0upstream 1attributes 80000000

...


LinkDescription




Feature Information for Upstream Interface Configuration onthe Cisco cBR Router



Note


Upstream Interface ConfigurationAdditional References



Table 4: Feature Information for Upstream Interface Configuration


This feature was integrated ontheCisco cBR Series ConvergedBroadband Routers.

Cisco IOS XE Fuji 16.7.1Upstream Interface Configuration


Upstream Interface ConfigurationFeature Information for Upstream Interface Configuration on the Cisco cBR Router

C H A P T E R 3DOCSIS Interface and Fiber Node Configuration

• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 23• Overview of DOCSIS Interfaces and Fiber Node Configurations, on page 24• Configuring DOCSIS Interfaces and Fiber Nodes, on page 26• Configuring MAC Domain Service Groups, on page 31• Downstream Bonding Group Configuration, on page 34• Upstream Bonding Group Configuration, on page 38• Additional References, on page 41• Feature Information for DOCSIS Interface and Fiber Node Configuration, on page 41



Note














Digital PICs:


•













Overview of DOCSIS Interfaces and Fiber Node ConfigurationsThe Interface line card used in the Cisco cBR chassis is an integrated line card that has two downstreammodules and one upstreammodule. The line cards support DOCSIS 3.0 features including downstream bondinggroups, and upstream bonding groups.

Downstream FeaturesPhysically, the DS (downstream) modules support eight physical connectors or ports. The DSmodules supportthe following features:


DOCSIS Interface and Fiber Node ConfigurationOverview of DOCSIS Interfaces and Fiber Node Configurations

• The DS modules support eight downstream integrated-cable controllers for these eight ports. Eachdownstream integrated-cable controller is associated with an RF port.

• Each downstream controller supports up to 128 downstream channels (0-127).• Each downstream controller can be configured with 128 integrated-cable interfaces. Therefore, each linecard has 1024 integrated-cable interfaces.

• Each integrated-cable interface has a static mapping to an integrated-cable controller RF channel. Forexample, Integrated-Cable interface 3/0/0:0 is mapped to RF Channel 0 on Integrated-Cable controller3/0/0.

• 768 downstream DOCSIS channels may be configured on each line card.• A total of 512 wideband-cable interfaces (downstream bonding groups) may be configured on each linecard.

• Each wideband-cable interface supports a maximum of 64 downstream channels.• 128 of the 512 wideband-cable interfaces (downstream bonding groups) may contain 33 or morechannels.

Upstream FeaturesThe Interface line card has one upstream module supporting 16 physical connectors or ports. The upstreamfeatures are as follows:

• The line card supports 16 upstream-cable controllers, each mapping to one upstream connector.• 12 upstream channels can be configured per upstream controller.• 12 upstream channels can be enabled per pair of upstream controllers.

For more details on the upstream features, see the Downstream Upstream Guide.

MAC Domains (Cable Interfaces)1. 16 MAC domains (cable interfaces) may be configured per line card.2. Maximum of 16 upstream channels can be configured in each MAC domain.

3. A maximum of 255 downstream channels may be added to a MAC domain.4. Maximum number of primary capable downstream channels per MAC Domain is 32. Non Primary

downstream channels are added automatically to the MAC domains when the fiber nodes are configured.

Fiber Nodes512 fiber nodes may be configured for each Cisco cBR-8 chassis.


DOCSIS Interface and Fiber Node ConfigurationUpstream Features

Configuring DOCSIS Interfaces and Fiber Nodes

Configuring Upstream Channels

Verifying the Controller ConfigurationUse the show controllers upstream-cable command to verify the configuration of the upstream channels inthe controllers. Use the modifier | include upstream to see the administrative and operational state of thecontrollers.

Router#show controllers upstream-Cable 1/0/0 | include upstreamController 1/0/0 upstream 0 AdminState:UP OpState: UPController 1/0/0 upstream 1 AdminState:UP OpState: UPController 1/0/0 upstream 2 AdminState:UP OpState: UPController 1/0/0 upstream 3 AdminState:UP OpState: UPController 1/0/0 upstream 4 AdminState:DOWN Opstate: DOWN (Reason: Default)Controller 1/0/0 upstream 5 AdminState:DOWN Opstate: DOWN (Reason: Default)Controller 1/0/0 upstream 6 AdminState:DOWN Opstate: DOWN (Reason: Default)Controller 1/0/0 upstream 7 AdminState:DOWN Opstate: DOWN (Reason: Default)Router#

Binding Upstream Channels to MAC DomainBy default, a MAC domain does not contain any upstream channels. This section describes the configurationsnecessary to bind one or more upstream channels to a MAC domain. Each upstream channel is bound to onlyone MAC domain. The MAC domain and the upstream channel must reside on the same line card (same slot).If required, the upstream channels within the same upstream controller can be bound to differentMAC domains.

Before you begin

Restrictions

• A maximum of 8 upstream channels may be bound to one MAC domain.

A maximum of 16 upstream channels may be configured in each MAC domain.Note

• The MAC domain and channels must share the same slot. That is, a MAC Domain may include channelsfrom any controller on the same slot.

Procedure





DOCSIS Interface and Fiber Node ConfigurationConfiguring DOCSIS Interfaces and Fiber Nodes



Example:

Step 2


Enters MAC Domain configuration mode. Values for slotare 0-3 and 6-9, for subslot is always 0, for MD Index is0-15.

interface cable

Example:

Router#interface cable 1/0/0

Step 3

Binds the specified upstream channel to theMACDomain.upstream upstream-Cable us-channel

Example:

Step 4

Router(config-if)#upstream 4 upstream-Cable 1/0/0us-channel 7

Returns to privileged EXEC mode.end

Example:

Step 5

Router# end

What to do next

To verify MAC Domain configurations for upstream, use the show cable mac-domain command withcgd-associations keyword.

The MD US Binding table shows the upstream channel binding.

Router#show cable mac-domain c1/0/0 cgd-associationsLoad for five secs: 1%/0%; one minute: 2%; five minutes: 2%Time source is NTP, *13:36:26.209 PST Fri Jan 20 2012CGD Host Resource DS Channels Upstreams (ALLUS) Active DSCa1/0/0 1/0/0 8 0-1 Yes 8

16 0-1 Yes 16

24 0-1 Yes 24

32-33 0-1 Yes 32-33

40 0-1 Yes 40

MD US binding:Host MD Controller US channel StateCa1/0/0 U0 1/0/0 0 UPCa1/0/0 U1 1/0/0 1 UPCa1/0/0 U2 1/0/0 2 UPCa1/0/0 U3 1/0/0 3 UPCa1/0/0 U4 1/0/1 0 UPCa1/0/0 U5 1/0/1 1 UPCa1/0/0 U6 1/0/1 2 UPCa1/0/0 U7 1/0/1 3 UP

Router#


DOCSIS Interface and Fiber Node ConfigurationBinding Upstream Channels to MAC Domain

Configuring Primary Capable Downstream Channels

Verifying Downstream Configuration in ControllerUse the show controller Integrated-Cable command to verify the status of the downstream channels configuredon an Integrated-cable controller.

Router# show controller Integrated-Cable 1/0/0 rf-channel 0-127Chan State Admin Frequency Type Annex Mod srate Interleaver dcid power output0 UP UP 381000000 DOCSIS B 256 5361 I32-J4 1 32 NORMAL1 UP UP 387000000 DOCSIS B 256 5361 I32-J4 2 34 NORMAL2 UP UP 393000000 DOCSIS B 256 5361 I32-J4 3 34 NORMAL3 UP UP 399000000 DOCSIS B 256 5361 I32-J4 4 34 NORMAL

Configuring Integrated-cable InterfaceConfigure an integrated-cable interface to prepare a downstream channel for inclusion within aMACDomainas a primary-capable downstream channel. The interface configuration provides the following advantages:

• It enables the allocation of bandwidth to the downstream channel.

• It enables the control of the administrative state (shut/no shut) of the channel interface.

The time interval required between the shut and no shut administrative states for the same controller isapproximately 30 seconds. You must not change the shut and no shut states rapidly without any delay in scriptor copy-paste. It can generate unexpected errors.

Each integrated-cable interface is mapped statically to an integrated-cable controller RF channel. For example,IC interface 1/0/0:0 is mapped to IC controller 1/0/0 RF channel 0. Similarly, IC interface 1/0/0:1 is mappedto IC controller 1/0/0 RF channel 1.

IC controllers are numbered 0-7 and RF Channels on each controller are numbered 0-127.

Before you begin

Determine the percentage of bandwidth to allocate to a channel. The bandwidth percentage configured isconverted to a committed information rate (CIR) value for the interface. The value is used to admit non-bondedservice flows on this channel. For more information, see theDynamic Bandwidth Sharing on the Cisco CMTSRouter.

Step 1 enable

Example:Router> enable

Enables privileged EXEC mode.

Enter your password if prompted.

Step 2 configure terminal

Example:Router# configure terminal

Enters global configuration mode.


DOCSIS Interface and Fiber Node ConfigurationConfiguring Primary Capable Downstream Channels

Step 3 interface integrated-cable

Example:

Router(config)# interface integrated-cable 1/0/0:0

Enter the integrated-cable interface configuration mode for specified integrated-cable interface.

Step 4 cable rf-bandwidth-percent percentage-number

Example:Router(config-if)# cable rf-bandwidth-percent 30

Configures the bandwidth allocation to the specified integrated-cable interface.

Step 5 end

Example:Router# end

Returns to privileged EXEC mode.

What to do next

The following conditions are used to determine if an IC (Integrated-Cable) interface is up in current software.

• The IC interface is associated to a MD (MAC Domain) interface.

• The MD interface, which the IC interface associated to, is in UP state.

• The IC interface is not configured shut down.

• The IC interface is configured with bandwidth.

• The associated downstream channel within the IC controller is operationally up.

Use the show interface Integrated-Cable controller command to verify the status of the specifiedintegrated-cable interface. The State info table provides information to diagnose issues affecting the operationalstate of the interface.

Router# show interface Integrated-Cable 1/0/0:0 controllerIntegrated-Cable1/0/0:0 is up, line protocol is up…----------------------------------------------State info (DSNB if and its underlying states)----------------------------------------------DSNB IF state : UPRF Chan state : UPRF Chan frequency : 381000000Bandwidth configured on DSNB IF : YESInject Header/HW flow creation status : DSNB_IF_SM_UPMD state (9/0/0) : UP*DSNB i/f Line State : UP----------------------------------------------


DOCSIS Interface and Fiber Node ConfigurationConfiguring Integrated-cable Interface

Binding Primary Capable Downstream Channels to a MAC DomainAfter a downstream channel has a properly configured Integrated-cable interface, it may be bound to a MACDomain as a primary capable channel. The Channel Grouping Domain (CGD) configuration allows specifieddownstream channels to be bound to a MAC Domain as primary capable channels. Optionally, it also allowsdownstream channels to be associated with a subset of upstream channels within the MAC domain.

Before you begin

Restrictions

• The downstream channel and MAC domain must reside on the same line card (same slot)

• A maximum of 32 primary capable downstream channels may be bound to a single MAC domain

Step 1 enable







Step 3 interface cable

Example:

Router#interface cable 1/0/0

Enters MAC domain configuration mode.

• slot—Specifies the chassis slot number of the interface line card. Valid values are 0-3 and 6-9

• subslot—Specifies the secondary slot number of the interface line card. Valid subslot is 0.

• MD index—Specifies the MAC Domain index number. Valid values are 0-15.

Step 4 downstream Integrated-Cable slot/subslot/port rf-channels grouplist

Example:

Router#downstream Integrated-Cable 1/0/0 rf-channels 1-6

Configures the downstream primary capable channels.

• grouplist—Specify the range of downstream rf-channels.

Step 5 end


DOCSIS Interface and Fiber Node ConfigurationBinding Primary Capable Downstream Channels to a MAC Domain

Example:Router# end


What to do next

To verify the downstream primary capable channels, use the show cable mac-domain command withcgd-associations keyword.

Router#show cable mac-domain c1/0/0 cgd-associationsLoad for five secs: 1%/0%; one minute: 2%; five minutes: 2%Time source is NTP, *13:36:26.209 PST Fri Jan 20 2012CGD Host Resource DS Channels Upstreams (ALLUS) Active DSCa1/0/0 1/0/0 8 0-1 Yes 8

16 0-1 Yes 16

24 0-1 Yes 24

32-33 0-1 Yes 32-33

40 0-1 Yes 40

MD US binding:Host MD Controller US channel StateCa1/0/0 U0 1/0/0 0 UPCa1/0/0 U1 1/0/0 1 UPCa1/0/0 U2 1/0/0 2 UPCa1/0/0 U3 1/0/0 3 UPCa1/0/0 U4 1/0/1 0 UPCa1/0/0 U5 1/0/1 1 UPCa1/0/0 U6 1/0/1 2 UPCa1/0/0 U7 1/0/1 3 UP

Router#

Configuring MAC Domain Service Groups

Configuring the Fiber NodesAmaximum of 512 fiber nodes may be configured per CMTS. A fiber node configured on the CMTS representsone or more matching physical fiber nodes in the HFC plant. The CMTS uses the fiber node configuration toidentify the DOCSIS downstream service group (DS-SG) and DOCSIS upstream Service Group (US-SG) ofthe physical fiber nodes in the plant. The Service Group information is compared with MAC Domain channelconfiguration to automatically calculate the MAC Domain downstream and upstream service groups(MD-DS-SGs and MD-US-SGs respectively) within the MAC Domains.

The following is required to create a valid fiber node configuration.

• Each fiber node configurationmust include at least one downstream controller and one upstream controller.


DOCSIS Interface and Fiber Node ConfigurationConfiguring MAC Domain Service Groups

• EveryMACDomain andWideband Interface including channels within the fiber node must use the samebundle interface.

• All downstream channels included within the fiber node must be assigned a unique frequency.• All downstream channels associated with a particular MACDomain must be assigned a unique DOCSISchannel ID.

If automatic DOCSIS channel ID allocation is preferred over manual DOCSIS channel ID configuration, thecable downstream-channel-id automatic command may be used to enable automatic DOCSIS channel IDallocation for the CMTS.

For details, see the Cisco CMTS Cable Command Reference.

Step 1 enable







Step 3 cable fiber-node id

Example:

Router(config)#cable fiber-node 1Router(config-fiber-node)#

Enters cable fiber-node configuration mode to configure a fiber node

• id— cable fiber node ID. The valid range is 1-512.

Step 4 downstream Integrated-Cable slot/subslot/port

Example:

Router(config-fiber-node)#downstream Integrated-Cable 1/0/0

Adds the DOCSIS downstream channels within the controller to the fiber node.

Step 5 upstream upstream-Cable slot/subslot/port

Example:

Router(config-fiber-node)#upstream upstream-Cable 1/0/0

Adds the upstream channels within the controller to the fiber node.

Step 6 end

Example:


DOCSIS Interface and Fiber Node ConfigurationConfiguring the Fiber Nodes

Router# end


What to do next

To verify the fiber-node configuration use the show cable fiber-node command.

Router# show cable fiber-node 1---------------------------------------------------------------------------------Fiber-Node 1Description: Feed Mac Domain: Cable1/0/0Channel(s) : downstream Integrated-Cable 1/0/0: 0-3, 32-35, 64-67,96-99Channel ID(s): 1 2 3 4 33 34 35 36 65 66 67 68 97 9899 100Upstream-Cable 1/0/0FN Config Status: Configured (status flags = 0x01)MDD Status: ValidRouter#

The output shows the downstream channel IDs configured on a fiber node. It also shows the status of theupstream-cable configured on the fiber node. Further, it shows the status of MAC Domain Descriptor (MDD)messaging.

Verify MD-DS-SG Channel MembershipOnce the fiber node is valid, the MD-DS-SGs within the associated MAC domains will be automaticallypopulated with downstream channels. TheMD-DS-SGs will include the active primary downstream channelswithin theMAC domain as well as non-primary downstream channels automatically associated with theMACdomain through the fiber node configuration. The non-primary channels must be properly configured withinthe controller (that are operationally up) to be included in MD-DS-SGs

Use the show cable mac-domain command with the downstream-service-group option to display theMD-DS-SG channel membership.

outer#show cable mac-domain c1/0/0 downstream-service-groupCable MD-DS-SG RFIF Id Resource Chan Primary ChanC1/0/0 5 1/0/0 0-3 0-3

32-35 32-3564-6796-99

To verify that the primary downstream channels are transmitting MACManagement Messages (MMMs) usethe show controller Integrated-Cable counter rf-channel command.Router#sh controllers Integrated-Cable 7/0/0 counter rf-channelController RF MPEG MPEG MPEG Sync MAP/UCD User QAM

Chan Packets bps Mbps Packets Packets Mbps UtilTx Tx Tx Percentage

7/0/0 0 0 0 00.00 0 0 00.00 000.007/0/0 1 0 0 00.00 0 0 00.00 000.007/0/0 2 8239954 2475952 02.47 0 0 02.39 006.60


DOCSIS Interface and Fiber Node ConfigurationVerify MD-DS-SG Channel Membership

7/0/0 3 85927382 25769779 25.76 0 0 24.94 068.717/0/0 4 85927608 25769027 25.76 0 0 24.94 068.717/0/0 5 8239088 2474599 02.47 0 0 02.39 006.597/0/0 6 8210840 2463770 02.46 0 0 02.38 006.577/0/0 7 50103 15040 00.01 0 0 00.01 000.047/0/0 8 50103 15040 00.01 0 0 00.01 000.04

Verify MD-US-SG Channel MembershipUse the show cable mac-domain commandwith the upstream-service-group option to display theMD-US-SGchannel membership.

Router#show cable mac-domain c1/0/0 upstream-service-groupCable MD 1/0/0US-SG-ID : 5 US-Chan : U0,1,2,3Primary-DS: 1/0/0:0 US-SG-ID: 5MDD US-List : U0,1,2,3MDD Ambiguity : U0,1,2,3Primary-DS: 1/0/0:1 US-SG-ID: 5MDD US-List : U0,1,2,3MDD Ambiguity : U0,1,2,3Primary-DS: 1/0/0:2 US-SG-ID: 5MDD US-List : U0,1,2,3MDD Ambiguity : U0,1,2,3Primary-DS: 1/0/0:3 US-SG-ID: 5MDD US-List : U0,1,2,3MDD Ambiguity : U0,1,2,3

Downstream Bonding Group Configuration

Configuring Wideband-cable Interface (Downstream Bonding Grouping)AWideband-Cable interface forwards bonded traffic in the downstream direction. A set of downstream RFchannels is configured under theWideband interface. Each line card will support up to 512Wideband interfaces.

Although there is no real relationship between these wideband interfaces and the 8 controllers (ports), thereis a convention of dividing the wideband interfaces into groups per controller.

The 512 wideband interfaces are divided among the 8 controllers - 64 interfaces per controller.

You can create a wideband-cable interface to define a downstream bonding group. A downstream bondinggroup bonds together a set of downstream RF channels. It can only contain the RF channels from the sameline card.

Associations between bonding groups andMACDomains are automatically created. Associations occur whena bonding group channel set is found to be a subset of aMACDomainDownstreamServiceGroup (MD-DS-SG)within a MAC Domain. The automatic associations will trigger the creation of an RCC that contains thebonding group's channel set within the MAC Domain.

Before you begin

Restrictions:

1. Included downstream channels must be a part of the same line card slot.


DOCSIS Interface and Fiber Node ConfigurationVerify MD-US-SG Channel Membership

2. All the downstream channels must be from the integrated-cable controllers 0-3 or 4-7.

Step 1 enable







Step 3 interface wideband-Cable

Example:

Router(config)#interface wideband-Cable 1/0/0:1Router(config-if)#

Enter the wideband-cable interface configuration mode for specified wideband-cable interface.

Step 4 cable bundle id

Example:

Router(config-if)#cable bundle 1

Configures the cable bundle id for this wideband-cable interface. The configured cable bundle id must match the cablebundle id configured in associated MAC domains.

• Bundle number— cable bundle number. The valid range is 1-255.

Step 5 cable rf-channels channel-list grouplist bandwidth-percent percentage-bandwidth

Example:

Router(config-if)#cable rf-channel channel-list 1-3 bandwidth-percent 10

Configures the bandwidth allocation for specified channel-list and includes the channels in the downstream bondinggroup. Range for channel numbers are 0-127 (<first channel num-last channel num>).


Step 6 cable rf-channels controller controller number channel-list grouplist bandwidth-percent percentage-bandwidth

Example:

Router(config-if)#cable rf-channel controller 1 channel-list 1-3 bandwidth-percent 10


DOCSIS Interface and Fiber Node ConfigurationConfiguring Wideband-cable Interface (Downstream Bonding Grouping)

Configures the bandwidth allocation for specified channel-list on downstream controllers and includes the channels inthe downstream bonding group. Range for channel numbers are 0-127.

• controller number—Downstream controller number. The valid numbers are 0-7.


Step 7 end

Example:Router# end


What to do next

Verify the Bonding Group Interfaces.

Verifying the Bonding Group InterfacesUsewideband-channel option of the show controllers integrated-Cable command to display bonding groupinterfaces:

Router# show controllers integrated-cable 1/0/0 wideband-channelLoad for five secs: 2%/0%; one minute: 2%; five minutes: 2%Time source is NTP, *17:45:51.964 PST Thu Jan 12 2012WB BG Primarychannel ID BGWideband-Cable1/0/0:0 12289 YesWideband-Cable1/0/0:1 12290 YesWideband-Cable1/0/0:2 12291 YesWideband-Cable1/0/0:3 12292 YesWideband-Cable1/0/0:4 12293 YesWideband-Cable1/0/0:5 12294 YesWideband-Cable1/0/0:6 12295 YesWideband-Cable1/0/0:7 12296 YesWideband-Cable1/0/0:8 12297 YesWideband-Cable1/0/0:9 12298 YesWideband-Cable1/0/0:10 12299 YesWideband-Cable1/0/0:11 12300 YesWideband-Cable1/0/0:12 12301 YesWideband-Cable1/0/0:13 12302 YesWideband-Cable1/0/0:14 12303 YesWideband-Cable1/0/0:15 12304 YesWideband-Cable1/0/0:16 12305 YesWideband-Cable1/0/0:17 12306 YesWideband-Cable1/0/0:18 12307 YesWideband-Cable1/0/0:19 12308 YesWideband-Cable1/0/0:20 12309 YesWideband-Cable1/0/0:21 12310 YesWideband-Cable1/0/0:22 12311 YesWideband-Cable1/0/0:23 12312 YesWideband-Cable1/0/0:24 12313 YesWideband-Cable1/0/0:25 12314 Yes

• To display the RF-channel mapping to wideband channels, use mapping wb-channel option.


DOCSIS Interface and Fiber Node ConfigurationVerifying the Bonding Group Interfaces

Router# show controllers Integrated-Cable 1/0/0 mapping wb-channel 0Ctrlr WB RF WB % WB Rem1/0/0 0 1/0/0:0 40 1

1/0/0:1 40 1

• To display the downstream MAC Domain service groups, use the dsbg-associations option of the showcable mac-domain command.

Router# show cable mac-domain c1/0/0 dsbg-associationsWi1/0/0:0 Wi1/0/0:1

Use the show interface Wideband-Cable controller command to verify the bonding group configurations.The State info table shows the downstream bonding group state information.

Router#show interface Wideband-Cable 1/0/0:0 controllerWideband-Cable1/0/0:0 is up, line protocol is upHardware is CMTS WB interface, address is c414.3c17.1dcb (bia c414.3c17.1dcb)MTU 1500 bytes, BW 150000 Kbit/sec, DLY 1000 usec,

reliability 255/255, txload 1/255, rxload 1/255Encapsulation MCNS, loopback not setKeepalive set (10 sec)ARP type: ARPA, ARP Timeout 04:00:00Last input never, output never, output hang neverLast clearing of "show interface" counters neverInput queue: 0/375/0/0 (size/max/drops/flushes); Total output drops: 0Queueing strategy: weighted fairOutput queue: 0/1000/64/0 (size/max total/threshold/drops)

Conversations 0/0/256 (active/max active/max total)Reserved Conversations 0/0 (allocated/max allocated)Available Bandwidth 112500 kilobits/sec

5 minute input rate 0 bits/sec, 0 packets/sec5 minute output rate 0 bits/sec, 0 packets/sec

0 packets input, 0 bytes, 0 no bufferReceived 0 broadcasts (0 multicasts)0 runts, 0 giants, 0 throttles0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort0 packets output, 0 bytes, 0 underruns0 output errors, 0 collisions, 3 interface resets0 unknown protocol drops0 output buffer failures, 0 output buffers swapped out

BG controller detailsWi1/0/0:0 BGID: 12289Member RFIDs:Config RFIDs: 12288-12291 Count: 4Active RFIDs: 12288-12291 Count: 4

Attribute mask: 0x80000000----------------------------------------------State info (DSBG if and its underlying states)----------------------------------------------DSBG IF state : UPDSBG Member RF chan states : UP (4 out of 4 chans are UP)DSBG HWID(FCID) : 0x3800*DSBG i/f Line State : UP---------------------------------------------------------------------------DMP ResourcesDMP handle : 0x10000800


DOCSIS Interface and Fiber Node ConfigurationVerifying the Bonding Group Interfaces

-----------------------------DMP BG pool entry detailsHW-id BGid BGSize Enabled-----------------------------0 : 12289 4 1-----------------------------Bgid BGecnt BGaddr Channels (1023 means invalid/Unused)

0 0 0: 0 1 2 3 1023 1023 1023 1023BG Rate Neg Pos LastTS CurrCr Pos

0 25000 65535 65535 0 0 N

-----------------------------RFID - JIB chan mapping for active RFIDs: [rfid:jib-chan-no][12288:0] [12289:1] [12290:2] [12291:3]

Router#

Upstream Bonding Group Configuration

Restrictions for Upstream Bonding Groups• Upstream bonding groups are configured within the MAC Domain interface

• Upstream bonding groups consist of a set of upstream channels that are bonded together.

• A maximum of 16 upstream channels can be configured for each MAC Domain, which are divided intotwo groups:

• Group 1: upstream channel 0-7

• Group 2: upstream channel 8-15

The upstream bonding-group should include all the upstream channels either from Group 1 or Group2 only.

Configuring Upstream Bonding Groups

Before you begin

Procedure





Example:

Step 2



DOCSIS Interface and Fiber Node ConfigurationUpstream Bonding Group Configuration


Enters MAC domain configuration mode.interface cable slot/subslot/MD indexStep 3

Example: • slot—Specifies the chassis slot number of the interfaceline card. Valid values are 0-3 and 6-9Router(config)# interface cable 1/0/0

• subslot—Specifies the secondary slot number of theinterface line card. Valid subslot is 0.

• MD index—Specifies theMACDomain index number.Valid values are 0-15.

Creates a static upstream bonding group on aMACDomain.cable upstream bonding-group

Example:

Step 4

Router(config-if)#cable upstream bonding-group 7Router(config-upstream-bonding)#

Add upstream channels to an upstream bonding group.upstreamStep 5

Example: Amaximum of 16 upstream channels can be configured foreach MAC Domain, which are divided into two groups:

Router(config-upstream-bonding)#upstream 7 • Group 1: upstream channel 0-7• Group 2: upstream channel 8-15



Example:

Step 6

Router# end

What to do next

Use the show interface cable upstream bonding-group command to display upstream bonding groupinformation.

Router#show interface cable 1/0/0 upstream bonding-groupLoad for five secs: 1%/0%; one minute: 2%; five minutes: 2%Time source is NTP, *10:47:17.142 PST Thu Jan 12 2012

Cable1/0/0: Upstream Bonding Group 10 packets input, 0 octets inputSegments: 0 valid, 0 discarded, 0 lostReserved Bandwidth Max : 0 bits/secReserved Bandwidth : 0 bits/secAvailable Bandwidth : 46080000 bits/secTotal Service Flows On This Bonding Group: 0

Cable1/0/0: Upstream Bonding Group 20 packets input, 0 octets inputSegments: 0 valid, 0 discarded, 0 lostReserved Bandwidth Max : 0 bits/secReserved Bandwidth : 0 bits/secAvailable Bandwidth : 46080000 bits/sec


DOCSIS Interface and Fiber Node ConfigurationConfiguring Upstream Bonding Groups

Total Service Flows On This Bonding Group: 0Cable1/0/0: Upstream Bonding Group 65536

0 packets input, 0 octets inputSegments: 0 valid, 0 discarded, 0 lostReserved Bandwidth Max : 0 bits/secReserved Bandwidth : 0 bits/secAvailable Bandwidth : 15360000 bits/secTotal Service Flows On This Bonding Group: 0


Router#

Verifying Upstream Bonding GroupsUse the show cable upstream bonding-group command.

Router#show interface cable 1/0/0 upstream bonding-groupLoad for five secs: 1%/0%; one minute: 2%; five minutes: 2%Time source is NTP, *10:47:17.142 PST Thu Jan 12 2012





Router#


DOCSIS Interface and Fiber Node ConfigurationVerifying Upstream Bonding Groups


LinkDescription




Feature Information for DOCSIS Interface and Fiber NodeConfiguration



Note

Table 6: Feature Information for DOCSIS Interface and Fiber Node Configuration


This feature was integrated intoCisco IOS XE Everest 16.6.1 onthe cisco cBR Series ConvergedBroadband Routers.

Cisco IOS XE Everest 16.6.1DOCSIS Interface and Fiber NodeConfiguration


Cisco IOS XE Gibraltar 16.10.1fDisplay QAM UtillizationPercentage using the sh controllersIntegrated-Cable 7/0/0 counterrf-channel


DOCSIS Interface and Fiber Node ConfigurationAdditional References




DOCSIS Interface and Fiber Node ConfigurationFeature Information for DOCSIS Interface and Fiber Node Configuration

C H A P T E R 4Service Group Based Configuration of the CiscocBR Router

• Service Group Profile Based Configuration, on page 43• Service Profile Configuration for 16x8 with One MAC Domain, on page 45• Service Profile Configuration for 16x8 with Two MAC Domains, on page 47• MAC-Domain Split Configuration, on page 49

Service Group Profile Based ConfigurationTheDOCSIS Interface and Fiber Node Configuration guide describes the interface and fiber node configurationsthat are required to operationalize the Cisco cBR router. The steps described to accomplish the tasks involvedin such configuration are complex.

To simplify and speed up the process of configuring the physical and logical interfaces required to deploy theCisco cBR router quickly, a service group (SG) profile based approach is adopted. This document describesthe simplified SG profile approach.

This approach provides the following advantages:

• Improves and simplifies the deployment of Cisco cBR router.

• Improves and simplifies the configuration of Cisco cBR Router by eliminating duplicate configurations.

• Improves and simplifies troubleshooting of Cisco cBR router.

• Supports faster Converged Cable Access Platform (CCAP) provisioning by using common and quickreplication across nodes and regions.

To configure the interfaces and quickly operationalize the Cisco cBR router, a set of common profiles arecreated and are created and configured into global service group profiles. These global service group profilesmay be applied to fiber node interfaces along with a mapping of the service group interfaces to the physicalinterfaces.

Common profiles are profiles which contain configurations for common service group (SG) interfaces likeMAC domain, wideband-cable, and primary downstream

The common profiles and the global SG profiles may be independent of the topology of the network in whichthey are applied. The SG interface to physical interface mapping defines the behavior of the profiles in thetopology that the SG profiles have been applied to.


http://www.cisco.com/c/en/us/td/docs/cable/cbr/configuration/guide/b_cbr_layer2_docsis/docsis_interface_fn_configuration.html

Limitations:

• A common profile cannot be deleted if it is associated with the fiber nodes. It can be modified by enteringthe profile configuration mode using the cable profile command.

• A service-group profile cannot be deleted or modified if it is associated with the fiber nodes.

• To associate a new global SG profile to a fiber node, dissociate the currently associated global SG profilefrom the fiber node.

• To configure for a unique topology, use the full configuration approach provided in DOCSIS Interfaceand Fiber Node Configuration guide.

• When the secondary line card is in active mode, the following limitations apply:

• AMAC domain,Wideband-Cable interface, downstream channel, and SG profile cannot bemodifiedwhen they are associated with the fiber nodes.

• SG profile cannot be dissociated from the fiber nodes.

• A MAC domain, Wideband-Cable interface, downstream channel, and SG profile can be createdbut cannot be associated to the fiber node.

• To enable the SG operation simplification feature, auto-reset feature must be enabled using thecable wideband auto-reset command.

• Do not support downgrade cBR-8 image from 16.7.x to previous image if the configuration includes macdomain split configuration.

Broadly, the following steps define and deploy the common profiles and the SG profiles:

1. Define and configure the Common profiles: The SG interface profiles or the common profiles containconfiguration parameters common to a group of similar interfaces. For example, a profile may containspecific configuration parameters shared bymultipleWideband-Cable interfaces, associated across multipleline cards. A common profile is configured at the global or chassis level. All interfaces associated with aprofile will inherit the configuration in the profile. Any common profile may be associated with any globalSG profile. Use the cable profile profile-type profile-name command to define the following commonprofiles:

• MAC Domain (MD) profile

• Primary Downstream channel (DS) profile

• Wideband-cable Interface (WB) profile

• Global Service Group (SG) profile

2. Complete the following configurations to the fiber node interface using the cable fiber-node command:

• Define the downstream and upstream ports.Map the appropriate interface-cable using the downstreaminterface-cable command. Map the appropriate upstream-cable interface using the upstreamupstream-cable command.

• Use the downstream sg-channel command to map the logical downstream SG channels to thephysical RF channels and the upstream sg-channel command to map the logical upstream SGchannels to the physical upstream channels.

• Use the service-group profile to associate the global service group profile to the fiber node.


Service Group Based Configuration of the Cisco cBR RouterService Group Profile Based Configuration



See the use case scenarios for configurations and examples.

Service Profile Configuration for 16x8 with One MAC DomainThis section describes the service group based configurations for a 16x8 service group with oneMAC domain.

Step 1 cable profile profile-type profile-name

For MAC Domain profile, specify profile-type as mac-domain.

Router(config)#cable profile mac-domain MD1Router(config-profile-md)#cable dynamic-secret markRouter(config-profile-md)#cable shared-secret 0 ciscoRouter(config-profile-md)#cable ip-init ipv4Router(config-profile-md)#cable mtc-modeRouter(config-profile-md)#cable mrc-modeRouter(config-profile-md)#cable privacy mandatoryRouter(config-profile-md)#cable privacy bpi-plus-policy

For Primary downstream profile, specify profile-type as downstream.

Router(config)#cable profile downstream DS1Router(config-profile-ds)#cable rf-bandwidth-percent 20Router(config-profile-ds)#cable attribute-mask 0x80000000

For wideband-cable interface profile, specify profile-type as wideband-interface.

Router(config)#cable profile wideband-interface BG1Router(config-profile-wb)#cable downstream attribute-mask 0x80000000

For global service group profile, specify profile-type as service-group. In the service group profile, configure the cablebundle associated, mac-domain profile, and the wideband interface profile

Router(config)#cable profile service-group SG-16x8-1_1Router(config-profile-sg)#cable bundle 71Router(config-profile-sg)#mac-domain 0 profile md1Router(config-profile-sg-md)#downstream sg-channel 0-7 profile ds1 upstream 0-3Router(config-profile-sg-md)#upstream 0 sg-channel 0Router(config-profile-sg-md)#upstream 1 sg-channel 1Router(config-profile-sg-md)#upstream 2 sg-channel 2Router(config-profile-sg-md)#upstream 3 sg-channel 3Router(config-profile-sg-md)#upstream 4 sg-channel 4Router(config-profile-sg-md)#upstream 5 sg-channel 5Router(config-profile-sg-md)#upstream 6 sg-channel 6Router(config-profile-sg-md)#upstream 7 sg-channel 7Router(config-profile-sg-md)#us-bonding-group 1Router(config-profile-sg-md-usbg)#upstream 0Router(config-profile-sg-md-usbg)#upstream 1Router(config-profile-sg-md-usbg)#upstream 2Router(config-profile-sg-md-usbg)#upstream 3Router(config-profile-sg-md-usbg)#upstream 4Router(config-profile-sg-md-usbg)#upstream 5Router(config-profile-sg-md-usbg)#upstream 6


Service Group Based Configuration of the Cisco cBR RouterService Profile Configuration for 16x8 with One MAC Domain

Router(config-profile-sg-md-usbg)#upstream 7Router(config-profile-sg-md-usbg)#attributes 8000000Router(config-profile-sg-md-usbg)#exitRouter(config-profile-sg-md)#exitRouter(config-profile-sg)#

Router(config-profile-sg)#wideband-interface 1 profile BG1Router(config-profile-sg-bg)#downstream sg-channel 0 15 rf-bandwidth-percent 10Router(config-profile-sg-bg)#endRouter#

Step 2 cable fiber-node

Enter fiber-node configuration mode. Configure the following in fiber-node configuration mode:

• downstream port

• upstream port

• downstream sg-channels to rf-channels mapping

• upstream sg-channels to us-channels mapping

• global service group mapping

• managed MAC domain

Router(config)#cable fiber-node 1Router(config-fiber-node)#downstream integrated-cable 3/0/0Router(config-fiber-node)#upstream upstream-cable 3/0/0Router(config-fiber-node)#downstream sg-channel 0 15 integrated-cable 3/0/0 rf-channel 0 15Router(config-fiber-node)#upstream sg-channel 0 7 upstream-cable 3/0/0 us-channel 0 7Router(config-fiber-node)#service-group profile SG-16X8-1_1

What to do next

Use the show cable fiber-node [id] mapping and the show cable fiber-node [id] derived commands tocheck the configuration of the interfaces.

Router#show cable fiber-node 1 mappingFiber-node 1:Upstream:Sg chan Us-chan Op state0 3/0/0 0 Up1 3/0/0 1 Up2 3/0/0 2 Up3 3/0/0 3 Up4 3/0/0 4 Up5 3/0/0 5 Up6 3/0/0 6 Up7 3/0/0 7 UpDownstream:Sg chan Ds-rf-chan Op state0 3/0/0:0 Up1 3/0/0:1 Up2 3/0/0:2 Up


Service Group Based Configuration of the Cisco cBR RouterService Profile Configuration for 16x8 with One MAC Domain

3 3/0/0:3 Up4 3/0/0:4 Up5 3/0/0:5 Up6 3/0/0:6 Up7 3/0/0:7 Up8 3/0/0:8 Up9 3/0/0:9 Up10 3/0/0:10 Up11 3/0/0:11 Up12 3/0/0:12 Up13 3/0/0:13 Up14 3/0/0:14 Up15 3/0/0:15 Up

Router#show cable fiber-node 1 derivedFiber-node 1:

interface Assoc successedmac-domain 0 Cable3/0/0 YWideband 1 Wideband-Cable3/0/0:0 YRouter#

Use the show cable mac-domain fiber-node command to verify the interface associations.

Router#show cable mac-domain fiber-node 1 md 0 downstream-service-groupCable MD-DS-SG RFIF Id Resource Chan Primary ChanC3/0/0Router#

Router#show cable mac-domain fiber-node 1 md 0 upstream-service-groupCable MD 3/0/0Router#

Service Profile Configuration for 16x8 with Two MAC DomainsThis section describes the service group based configurations for a 16x8 service group with twoMAC domains,split downstream and overlaid upstream channels.

Step 1 cable profile profile-type profile-name

For MAC Domain profile, specify profile-type as mac-domain.

Router(config)#cable profile mac-domain MD1Router(config-profile-md)#cable dynamic-secret markRouter(config-profile-md)#cable shared-secret 0 ciscoRouter(config-profile-md)#cable ip-init ipv4Router(config-profile-md)#cable mtc-modeRouter(config-profile-md)#cable mrc-modeRouter(config-profile-md)#cable privacy mandatoryRouter(config-profile-md)#cable privacy bpi-plus-policy

For Primary downstream profile, specify profile-type as downstream.


Service Group Based Configuration of the Cisco cBR RouterService Profile Configuration for 16x8 with Two MAC Domains

Router(config)#cable profile downstream DS1Router(config-profile-ds)#cable rf-bandwidth-percent 20Router(config-profile-ds)#cable attribute-mask 0x80000000

For wideband-cable interface profile, specify profile-type as wideband-interface.

Router(config)#cable profile wideband-interface BG1Router(config-profile-wb)#cable downstream attribute-mask 0x80000000

For global service group profile, specify profile-type as service-group. In the service group profile, configure the cablebundle associated, mac-domain profile, and the wideband interface profile

Router(config)#cable profile service-group SG-16x4-1_2Router(config-profile-sg)#cable bundle 71Router(config-profile-sg)#mac-domain 0 profile md1Router(config-profile-sg-md)#downstream sg-channel 0-15 profile ds1 upstream 0-3Router(config-profile-sg-md)#upstream 0 sg-channel 0Router(config-profile-sg-md)#upstream 1 sg-channel 1Router(config-profile-sg-md)#upstream 2 sg-channel 2Router(config-profile-sg-md)#upstream 3 sg-channel 3Router(config-profile-sg-md)#us-bonding-group 1Router(config-profile-sg-md-usbg)#upstream 0Router(config-profile-sg-md-usbg)#upstream 1Router(config-profile-sg-md-usbg)#upstream 2Router(config-profile-sg-md-usbg)#upstream 3Router(config-profile-sg-md-usbg)#exitRouter(config-profile-sg-md)#exitRouter(config-profile-sg)#

Router(config-profile-sg)#wideband-interface 1 profile BG1Router(config-profile-sg-bg)#downstream sg-channel 0 7 rf-bandwidth-percent 10Router(config-profile-sg-bg)#exitRouter(config-profile-sg)#wideband-interface 2 profile BG1Router(config-profile-sg-bg)#downstream sg-channel 8 15 rf-bandwidth-percent 10Router#



• downstream port

• upstream port





Router(config)#cable fiber-node 1Router(config-fiber-node)#downstream integrated-cable 3/0/0Router(config-fiber-node)#upstream upstream-cable 3/0/0Router(config-fiber-node)#downstream sg-channel 0 7 integrated-cable 3/0/0 rf-channel 0 15Router(config-fiber-node)#upstream sg-channel 0 3 upstream-cable 3/0/1 us-channel 0 3


Service Group Based Configuration of the Cisco cBR RouterService Profile Configuration for 16x8 with Two MAC Domains

Router(config-fiber-node)#service-group profile SG-16X4-1_2Router(config-fiber-node)#exitRouter(config)#

Router(config)#cable fiber-node 2Router(config-fiber-node)#downstream integrated-cable 3/0/0Router(config-fiber-node)#upstream upstream-cable 3/0/1Router(config-fiber-node)#downstream sg-channel 0 7 integrated-cable 3/0/0 rf-channel 8 15Router(config-fiber-node)#downstream sg-channel 8 15 integrated-cable 3/0/0 rf-channel 0 7Router(config-fiber-node)#upstream sg-channel 0 3 upstream-cable 3/0/1 us-channel 0 3Router(config-fiber-node)#service-group profile SG-16X4-1_2Router(config-fiber-node)#exitRouter(config)#

What to do next

Use the show cable fiber-node [id] mapping and the show cable fiber-node [id] derived commands tocheck the configuration of the interfaces.

MAC-Domain Split ConfigurationThis section describes the MAC-domain split configurations.

• In MAC domain split scenario, we must configure upstream peer-node-us and managed MAC domain.

• After a fiber node managedMAC domain, we will reserve cable interface by cable managed fiber-nodecommand.

• If a fiber-node has peer, we can not add managed MAC domain.

• If a fiber-node has peer, we can not modify the configuration of channel mapping and upstreampeer-node-us

• If a fiber-node has managed MAC domain, we can not remove upstream peer-node-us.

• Only both two fiber-nodes are associated with service group profile, mac-domains andwideband interfaceswill be generated.

• MAC domain and wideband interfaces will be removed as soon as one fiber-node is unassociated withservice group profile.

Note

Step 1 cable profile mac-domain

Define global common profiles for MAC-domain, bonding group, primary downstream.

Router(config)#cable profile mac-domain MD


Service Group Based Configuration of the Cisco cBR RouterMAC-Domain Split Configuration

Router(config-profile-md)#load-interval 30Router(config-profile-md)#cable dynamic-secret markRouter(config-profile-md)#cable shared-secret 0 ciscoRouter(config-profile-md)#cable ip-init ipv4Router(config-profile-md)#cable mtc-modeRouter(config-profile-md)#cable mrc-modeRouter(config-profile-md)#cable privacy mandatoryRouter(config-profile-md)#cable privacy bpi-plus-policyRouter(config-profile-md)#cable privacy accept-self-signed-certificateRouter(config-profile-md)#cable privacy dsx-supportRouter(config-profile-md)#cable privacy eae-policy capability-enforcementRouter(config-profile-md)#cable privacy kek life-time 300Router(config-profile-md)#cable privacy retain-failed-certificatesRouter(config-profile-md)#cable privacy skip-validity-periodRouter(config-profile-md)#cable privacy tek life-time 180Router(config-profile-md)#cable cm-status enable 3Router(config-profile-md)#cable map-advance dynamicRouter(config-profile-md)#cable upstream 0 attribute-mask FFFFFFFFRouter(config-profile-md)#cable upstream 0 power-adjust continue 5Router(config-profile-md)#cable upstream balance-schedulingRouter(config)#cable profile downstream DSRouter(config-profile-ds)#cable rf-bandwidth-percent 20Router(config-profile-ds)#cable attribute-mask 0x80000000Router(config)#cable profile wideband-interface BGRouter(config-profile-wb)#cable downstream attribute-mask 0x80000000Router(config-profile-wb)#description BGRouter(config-profile-wb)#load-interval 30

Step 2 cable profile service-group

In the service group profile, configure the cable bundle associated, mac-domain profile, and the wideband interface profile.

Router(config)#cable profile service-group MD_SPLITRouter(config-profile-sg)#cable bundle 1Router(config-profile-sg)#mac-domain 0 profile MDRouter(config-profile-sg-md)#downstream sg-channel 0-15 profile DSRouter(config-profile-sg-md)#upstream 0 sg-channel 0Router(config-profile-sg-md)#upstream 1 sg-channel 1Router(config-profile-sg-md)#upstream 2 sg-channel 2Router(config-profile-sg-md)#upstream 3 sg-channel 3Router(config-profile-sg-md)#upstream 4 sg-channel 4Router(config-profile-sg-md)#upstream 5 sg-channel 5Router(config-profile-sg-md)#upstream 6 sg-channel 6Router(config-profile-sg-md)#upstream 7 sg-channel 7Router(config-profile-sg-md)#us-bonding-group 1Router(config-profile-sg-md-usbg)#upstream 0Router(config-profile-sg-md-usbg)#upstream 1Router(config-profile-sg-md-usbg)#upstream 2Router(config-profile-sg-md-usbg)#upstream 3Router(config-profile-sg-md-usbg)#attributes 8000000Router(config-profile-sg-md-usbg)#exitRouter(config-profile-sg-md)#us-bonding-group 2Router(config-profile-sg-md-usbg)#upstream 4Router(config-profile-sg-md-usbg)#upstream 5Router(config-profile-sg-md-usbg)#upstream 6Router(config-profile-sg-md-usbg)#upstream 7Router(config-profile-sg-md-usbg)#attributes 8000000Router(config-profile-sg-md-usbg)#exitRouter(config-profile-sg-md)#exitRouter(config-profile-sg)#wideband-interface 0 profile WBRouter(config-profile-sg-bg)#downstream sg-channel 0 7 rf-bandwidth-percent 1Router(config-profile-sg-bg)#exitRouter(config-profile-sg)#wideband-interface 1 profile WB



Router(config-profile-sg-bg)#downstream sg-channel 8 15 rf-bandwidth-percent 1



• downstream port

• upstream port



• abstract upstream channel



Router(config)#cable fiber-node 67Router(config-fiber-node)#downstream integrated-cable 6/0/6Router(config-fiber-node)#upstream upstream-cable 6/0/6Router(config-fiber-node)#downstream sg-channel 0 15 integrated-cable 6/0/6 rf-channel 015Router(config-fiber-node)#upstream sg-channel 0 3 upstream-cable 6/0/6 us-channel 0 3Router(config-fiber-node)#upstream sg-channel 4 7 peer-node-usRouter(config-fiber-node)#service-group managed md 0 cable6/0/6Router(config-fiber-node)#service-group profile MD_SPLIT

Router(config)#cable fiber-node 69Router(config-fiber-node)#downstream integrated-cable 6/0/6Router(config-fiber-node)#upstream upstream-cable 6/0/1Router(config-fiber-node)#downstream sg-channel 0 15 integrated-cable 6/0/6 rf-channel 015Router(config-fiber-node)#upstream sg-channel 4 7 upstream-cable 6/0/1 us-channel 0 3Router(config-fiber-node)#upstream sg-channel 0 3 peer-node-usRouter(config-fiber-node)#service-group managed md 0 cable6/0/6Router(config-fiber-node)#service-group profile MD_SPLIT



C H A P T E R 5DOCSIS Load Balancing Groups

First Published: April 11, 2015

Support for the restricted load balancing group (RLBG)/general load balancing group (GLBG) is based onDOCSIS 3.0 specifications.

Your software release may not support all the features that are documented in this module. For the latestfeature information and caveats, see the release notes for your platform and software release. The FeatureInformation Table at the end of this document provides information about the documented features and liststhe releases in which each feature is supported.


Contents

• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 53• Prerequisites for DOCSIS Load Balancing Groups, on page 54• Restrictions for DOCSIS Load Balancing Groups, on page 55• Information About DOCSIS Load Balancing Groups, on page 56• How to Configure DOCSIS Load Balancing Groups, on page 62• Configuration Examples for DOCSIS Load Balancing Groups, on page 72• How to Configure Load Balancing with Operational Simplification, on page 73• Verifying DOCSIS Load Balancing Groups, on page 77• Additional References, on page 82• Feature Information for DOCSIS Load Balancing Groups, on page 82



Note
















Digital PICs:


•













Prerequisites for DOCSIS Load Balancing GroupsDOCSIS Load Balancing Groups including Restricted/General Load Balancing groups with DownstreamDynamic Load Balancing feature has the following prerequisites:

• A RLBG and a DOCSIS 2.0 GLBG should have a load balancing group (LBG) ID.• A LBG should have a default policy ID.• During registration, a cable modem (CM) that has been assigned to a LBGmust also be assigned a policyID and priority, through Simple NetworkManagement Protocol (SNMP), the cablemodem configurationfile, or Cisco Cable Modem Termination System (CMTS) configuration.

• The cable modem must send service type identifier (STID), service class name, and DOCSIS versionand capability type/length/value (TLV) settings to the Cisco CMTS for registration if the fields are usedby general tagging.


DOCSIS Load Balancing GroupsPrerequisites for DOCSIS Load Balancing Groups

Restrictions for DOCSIS Load Balancing GroupsThe DOCSIS Load Balancing Groups (LBG) including RLBG/GLBG Support with DLB Support feature hasthe following restrictions:

• A maximum of 256 DOCSIS policies and 256 rules per chassis are supported.• Cross-line card (LC) configuration or moving of cable modems is not supported.• When deployed with channel restriction features, if the target upstream channel attribute masks areagainst that of the cable modem, then the cable modem on the higher load upstream will not be loadbalanced, as the current load balancing moves cable modems only to the target upstream. However, cablemodems that do not have an attribute mask can still be load balanced. You should consider the followingwhile deploying the load balancing groups: the target upstream will always be the upstream that has thelowest load. If some other upstreams have the same load, the upstream with the lowest index will bechosen as the target upstream.

• We recommend all LBGs that share channels must use the same LB method.

The DOCSIS LBG with RLBG/GLBG Support and DLB Support feature have the following cross functionalrestrictions:

• Cable modems operating in the multiple transmit channel (MTC) mode do not register for a RLBGassignment, even if their configuration file contains relevant TLVs, such as STID and LBG ID. However,cable modems operating in the multiple receive channel (MRC) can register for a RLBG assignment.

• The Cisco CMTS can parse a specific TLV encoded in cable modem configuration file, and prohibit anyDCC operation on the cable modems.

• DOCSISMAC domain downstream service group (MD-DS-SG) channels inMDDmessages are incorrectwhen a combination of channels from multiple line card types are placed in the same fiber node.

In a complex fiber node setup, with channels from more than one line card, or downstream channels of oneMAC domain in more than one fiber node, some modems may not come w-online (wideband online). If aMAC domain has more than one MD-DS-SG, the MDD will contain more than one MD-DS-SG and causethe modem to perform downstream ambiguity resolution.When the modem analyzes the downstream channelsfrom the other line card, it will not see MDD packets and disqualify the channel and the MD-DS-SG. Themodem then sends a requested MD-DS-SG of 0 to the CMTS implying it will not participate in a bondinggroup.

Use the show cable mac-domain downstream-service-group command to see the channels in the sameMD-DS-SG.

TheDOCSIS LBGwith RLBG/GLBGSupport andDLBSupport feature have the following scaling limitations:

• The total number of RLBGs and DOCSIS 2.0 GLBGs cannot exceed 256.• The total number of tags in a Cisco CMTS cannot exceed 256.• The total number of DOCSIS 3.0 GLBGs is bounded by free memory.• A cable modem reset occurs if a CM moves from one cable interface to another because DCC init-tech0 resets a cable modem during a LB move. A cable modem also resets if the two cable interfaces havebeen configured with a mismatched cable ip-init command.


DOCSIS Load Balancing GroupsRestrictions for DOCSIS Load Balancing Groups

Information About DOCSIS Load Balancing GroupsThe DOCSIS 2.0 “Autonomous Load Balancing” specification is CM-centric, allowing a channel (US or DS)to be part of multiple RLBGs. Therefore, with the DOCSIS 2.0 specifications, you can decide on whichchannel the CM can be load balanced.

To configure the Restricted/General Load Balancing and Narrowband Dynamic Bandwidth Sharing withDownstream Dynamic Load Balancing feature, you should understand the following concepts:

Service-Based Load BalancingUsing the DOCSIS 3.0 modem-based load balancing specifications, you can manage the LB activity on aper-modem basis as follows:

1. Modem to RLBG association through STID2. Modem to RLBG association through LBG ID3. Per-modem LB policy assignment4. Per-modem LB priority assignment5. Per-modem channel restriction

Implementing the DOCSIS 3.0 modem-based LB specifications enables the Cisco CMTS to provide anadvanced service-based LB. The service-based LB can be used to alleviate the burden for the modem-basedprovisioning and provide the operator an ability to selectively control LB activity based on modem servicetype. For example, for LB purposes modems can be classified based on:

• Device type• DOCSIS version• Service class

The results of the classification can then be used to selectively control the modem LB activity by mappingthe modem to the following settings:

• LBG• Policy

With the service-based LB enabled, existing service-based cable modem segregation features and channelrestriction become special cases and can be handled within the same LB framework.

Functionality

The Cisco CMTS functions in the following ways for general tagging and service-based LB:

• The Cisco CMTS can classify somemodems with user-definedmodem classifiers using the STID, serviceclass name, DOCSIS version and capability TLVs and MAC Organization Unique Identifier (OUI).

• Each modem classifier has a unique tag. The Cisco CMTS allows each modem to carry one tag. Whenmultiple tags match one cable modem, the tag that has the least index gets applied on the cable modems.

• The Cisco CMTS classifies a CM and assigns a tag, and if a RLBG with that tag is configured, the CMgets assigned to that RLBG.

• The Cisco CMTS can match multiple tags to a RLBG and a DOCSIS policy.• On the Cisco CMTS, a user can configure whether the general tagging overrides the RLBG or DOCSISpolicy assignment using TLVs in the CM configuration file and SNMP when a conflict occurs.


DOCSIS Load Balancing GroupsInformation About DOCSIS Load Balancing Groups

• When doing autonomous LB, the Cisco CMTS ensures that the target channels are available to a specificCM with regard to admission control, the SF attribute masks, and CM attribute masks.

• The user can configure the number of times that a DCC fails a CM before the CM is removed fromdynamic LB on the Cisco CMTS.

• The user can configure DCC initialization techniques or whether to use UpstreamChannel Change (UCC)for a LBG or for a particular source and target pair on the Cisco CMTS. However, DCC is not issued tocable modems provisioned in DOCSIS 1.0 mode. By default, the UCC for a LBG is not configured andtherefore, all channel changes are done through DCC.

• The Cisco CMTS supports LB on at least one logical channel on a physical US channel that has multiplelogical US channels.

• As per the DOCSIS 3.0 specifications, a lower load balancing priority indicates a higher likelihood thata CM will be moved due to load balancing operations.

• You can create a policy to set the lower bandwidth for CMs. the LBG can only move cable modems withthroughput that is above the threshold.

Compatibility

Both downstream and upstream autonomous load balancing is supported for single channel cable modems.

RLBG/GLBG AssignmentThe user can configure one or more service type IDs for each RLBG. The user can also configure the CiscoCMTS, using CLI or SNMP, to restrict a particular cable modem to a certain STID and RLBG ID. However,if such a configuration is made, both the STID and RLBG ID in the configuration file are ignored by the CiscoCMTS.

When the STID is configured by CLI or SNMP or the STID is present in the cable modem configuration file,the Cisco CMTS selects an upstream and downstream channel, which offers the signaled service type, froma RLBG, if such channels exist. However, if an upstream and downstream channel do not exist that providethe signaled service type the Cisco CMTS assigns an upstream and downstream channel that does not offerthe signaled service type.

When the LBG ID is configured by CLI or SNMP or the LBG ID is present in the cable modem configurationfile, the Cisco CMTS examines the available choices for upstream and downstream channels and, if theyinclude a channel pair associated with the signaled LBG, the Cisco CMTS assigns the cable modem to thesignaled LBG. If these conditions are not met, the Cisco CMTS disregards the LBG ID.

If there are multiple upstream and downstream channels available that meet the requirements of the STID, ifpresent, and the LBG ID, if present, the Cisco CMTS selects an upstream and/or downstream channel thatmeet the cable modem required and forbidden attribute masks requested in the configuration file. If upstreamand downstream channels are not available that meet these criteria, the Cisco CMTS can disregard the cablemodem attribute masks and select an alternative upstream and/or downstream channel.

In determining a target channel pair for a cable modem during registration time, the Cisco CMTS tries to findthe target channel pair that can actually reach the cable modem by checking the current channel pair, theMD-DS-SG-ID (Media Access Control Domain Downstream Service Group Identifier) of cable modem(CM-DS-SG-ID) and theMD-US-SG-ID (Media Access Control Domain Upstream Service Group Identifier)of cable modem (CM-US-SG-ID), if present, and fiber node (FN) configurations. If the target channel pair isavailable to the cable modem and is different from the current channel pair, the Cisco CMTS is required tomove the CM by means of DCC technique 0 or downstream frequency override (DFO).

When the Cisco CMTS identifies multiple candidate RLBGs for a CM, but cannot determine which fiber nodeconfiguration the cable modem is actually wired to, or cannot determine if the wired RLBG is unusable (when


DOCSIS Load Balancing GroupsRLBG/GLBG Assignment

interfaces in the load balance group are disabled or in an administratively down state), the Cisco CMTS assignsthe cable modem to the RLBG with the lowest group index. This assignment causes the Cisco CMTS toattempt to move the cable modem to interfaces it is not physically connected to, resulting in service outagesfor the CM.

The Cisco CMTS enforces fiber node checking during RLBG assignment.

The Cisco CMTS follows the following RLBG assignment rules:

• If there is no fiber node configuration, there is no change in the candidate RLBG list. However, if thefiber node is configured, the fiber node must be configured correctly to reflect the real fiber nodeconnection.

• If the cable modem is inside a fiber node, only those RLBGs that are inside that fiber node are selected.• If the cable modem is not inside any fiber node, that is, the fiber node configuration does not cover allthe channels, only those RLBGs that are not inside any fiber node are selected.

• If an RLBG spans across multiple fiber nodes, it is not considered to be inside any fiber node.• If no candidate RLBG is found, cable modems are assigned to the GLBG, if the GLBG exists.

Channel AssignmentFor cable modems operating in MRC mode, the registration request message can have multiple TLVs toinfluence the selection of upstream and downstream channels that the Cisco CMTS assigns. To avoid conflictsbetween the multiple TLVs, the Cisco CMTS follows the precedence order defined below:

1. TLV 56—Channel Assignment2. TLV 43.11—Service Type Identifier3. TLV 43.3—Load Balancing Group ID4. TLVs 24/25.31-33—Service Flow Attribute Masks5. TLV 43.9—CM Attribute Masks

The Cisco CMTS must follow this TLV precedence order for cable modems not operating in MRC mode:

1. TLV 43.11—Service Type Identifier2. TLV 43.3—Load Balancing Group ID3. TLV 43.9—CM Attribute Masks4. TLVs 24/25.31-33—Service Flow Attribute Masks

When a target for the new receive channel configuration (RCC) and Transmit channel configuration (TCC)is selected, ensure that the service level for cable modems is not decreased. Target total RCCs and TCCs mustnot be less than the source total RCCs and TCCs so that cable modems can keep their service level unchanged.This may cause some unbalanced results when high capacity cable modems come online, later releases..

Note

The Cisco CMTS also considers the DOCSIS 3.0 cable modem capabilities defined in the registration requestmessage and assigns the maximum number of channels that the CM requests.

The tables below define the load balancing matrix for RLBG and GLBG assignment:

Table 8: RLBG Assignment for DOCSIS Cable Modems

MAC VersionOperational Mode

DOCSIS 1.0 CMDOCSIS 1.1 CMDOCSIS 2.0 CMDOCSIS 2.x CMDOCSIS 3.0 CM


DOCSIS Load Balancing GroupsChannel Assignment


AssignedAssignedAssignedAssignedAssignedNon-MRC mode(online)

NANAAssignedAssignedAssignedMRC mode only(w-online)

NANANANAAssignedMRC/MTC mode(UB-online)

NANANANADOCSIS 3.0 cablemodems areassigned to theDOCSIS 3.0 RLBG

Table 9: GLBG Assignment for DOCSIS Cable Modems


DOCSIS 1.0 CMDOCSIS 1.1 CMDOCSIS 2.0 CMDOCSIS 2.x CMDOCSIS 3.0 CM

Assigned to the DOCSIS 2.0 GLBG without MD-DS-SG-ID/MD-US-SG-IDNon-MRC mode(online)

NANANAAssigned to the DOCSIS 3.0 GLBG withMD-DS-SG-ID/MD-US-SG-ID

Assigned to the DOCSIS 2.0 GLBG without MD-DS-SG-ID/MD-US-SG-IDMRC mode only(w-online)

NANANAAssigned to the DOCSIS 3.0 GLBG withMD-DS-SG-ID/MD-US-SG-ID

NANANANAAssignedMRC/MTC mode(UB-online)

NANANANADOCSIS 3.0 cablemodems areassigned to theDOCSIS 3.0 GLBG

The tables below give a snapshot view of the load balancing methods and the operations used to "move"bonded and non-bonded CMs.

Table 10: Load Balancing Method to Move Bonded and Non-bonded cable modems

Dynamic Service Charge (Initialization Technique)Modem Mode

Across MAC DomainsWithin MAC Domain

DCC initialization technique 0NADOCSIS 3.0 cable modems in MTCmode



Dynamic Service Charge (Initialization Technique)Modem Mode

DCC initialization technique 0DCC initialization technique 0

CMwith primary DS outside RLBGmoves insideRLBG with DOCSIS 2.0 LB.

Note

DOCSIS 3.0/DOCSIS 2.x cablemodems in MRC-only mode

DCC initialization technique 0DCC

CM outside RLBG moves inside RLBG withDOCSIS 2.0 LB.

Note

DOCSIS 3.0 cable modems inMRC-only mode

DCC initialization technique 0DCC/UCC


Note

DOCSIS 2.x cable modems inMRC-only mode

DCC initialization technique 0DCC


Note

DOCSIS 2.0 /DOCSIS 1.1 cablemodems in NB mode

UCCUCC


Note

Force reinitialize CMForce reinitialize CM


Note

DOCSIS 1.0 in NB mode

UCCUCC


Note

Table 11: Using DCC/DBC to Load Balance Bonded and Non-bonded Cable Modems

DOCSIS 1.0 cable modemswith Single US/DS

DOCSIS 1.1/DOCSIS 2.0 cable modemswith Single US/DS

CM in MRC, non-MTC ModeChannel

UCCDCCDCCUpstream (US)

Force reinitialize CMDCC (within the same MAC domain).NA (within the same MAC domain)Downstream(DS)

Force reinitialize CMDCCwith initialization technique 0 whenmoving cable modems across MACdomains.

DCC with initialization technique 0when moving cable modems acrossMAC domains.

Error Handling of Channel Assignment

This restriction is modified. As long as the interface state of the channels is not "administratively down", allchannels are available for LBG assignment. For other load balancing operations, such as moving modems



using DCC, UCC, or DBC, the interface state of the channels should be in "initial", "up", "suspicious", or"testing" states.

The following conditions apply when an LBG is disabled:

• cable modems that match all load balancing criteria can be assigned to an LBG.• cable modem moves for load balancing are disabled, but cable modem moves from outside of the LBGto inside of the LBG are allowed.

Upstream Load Balancing for DOCSIS 3.0 Cable Modems in Single UpstreamMode

The upstream load balancing functionality enables the Cisco CMTS router to effectively handle upstreamtraffic for wideband and narrowband cable modems that are in single upstream mode. Single upstream mode(Mx1) means that the modems cannot send upstream traffic on multiple upstream channels. In the event oftraffic overload on a single upstream channel of a wideband or narrowband cable modem, the Cisco CMTSrouter automatically moves the cable modem to another upstream channel in the same load balancing group.

A cable modem operating in single upstreammode is assigned to a load balancing group based on the primarychannel of the modem. A cable modem in single upstreammode can support multiple receive channel (MRC)mode or narrowbandmode. However, a cable modem in single upstreammode cannot support multiple transmitchannel mode (MTC).

Note

Auto-generate DOCSIS 2.0 GLBGCisco CMTS does not automatically implement DOCSIS 2.0 GLBG. DOCSIS 2.0 GLBG is configuredmanually after a new fiber node - MAC domain (FN-MD) pair is added.

This enhancement to automatically generate DOCSIS 2.0 GLBG after adding a new FN-MD pair and resolvinga new combination of MAC domain, cable modem, and service group (MD-CM-SG). This enhancement isimplemented through a new command cable load-balance d20 GLBG auto-generate. The command hasoptions to renew and update DOCSIS 2.0 GLBGs for a fiber node configuration.

Independent Upstream/Downstream Throughput RulesCurrently, during upstream or downstream load balancing, to move modems in load balancing operations,Cisco CMTS applies the DOCSIS policy throughput rules to both upstream and downstream throughput toupstream or downstream load balancing operations. In other words, for downstream load balancing, bothupstream and downstream sets of rules are applied and similarly for upstream load balancing both set of rulesare applied. This prevents movement of modems with low upstream or high downstream throughput and highupstream or low downstream throughput.

Upstream or downstream throughput rules are checked independently to corresponding upstream or downstreamload balancing operations. During upstream load balancing, only upstream throughput rules are checked, andduring downstream load balancing, only downstream throughput rules are checked.

The following important points are implemented for independent upstream/downstream throughput rules:


DOCSIS Load Balancing GroupsUpstream Load Balancing for DOCSIS 3.0 Cable Modems in Single Upstream Mode

• If DOCSIS 2.0 load balancing policy configured is us-across-ds, it is recommended to configure amaximum of 16 downstream channels and 8 upstream channels.

• If a load balancing operation involves a change only in the downstream channel of a cable modemwithoutany change to the upstream channel, then only the downstream lower boundary rules are checked.

• If a load balancing operation involves a change only in the upstream channel of a cable modem withoutany change to the downstream channel, then only the upstream lower boundary rules are checked.

• If a load balancing operation involves a change in both the upstream and downstream channels of a cablemodem, then the modem rule check must pass all the rules for that (upstream or downstream) loadbalancing.

• If the load balancing policy configured is pure-ds-load, then only the downstream rules are checked.

• If the load balancing policy configured is us-across-ds or both us-across-ds and pure-ds-load, then twotypes of target interfaces occur as follows:

• Local interface—where the cable modem shares the upstream with the source. Only downstreamload balancing operation occurs.

• Remote interface—where the the cable modem does not share the upstream with the source. Theupstream/downstream load balancing is triggered by upstream load.

If the load balancing policy configured is neither us-across-ds nor pure-ds-load, then the load balancingis done based on Mac domain load.

How to Configure DOCSIS Load Balancing GroupsThe Restricted/General Load Balancing and Narrowband Dynamic Bandwidth Sharing with DownstreamDynamic Load Balancing feature can be configured as follows:

• A user can configure a DOCSIS 2.0 general load balancing group (GLBG) on the Cisco CMTS accordingto DOCSIS specification. The Cisco CMTS creates a DOCSIS 3.0 GLBG for eachMedia Access ControlDomain Cable Modem Service Group (MD-CM-SG) automatically and checks whether the GLBGcontains both upstream and downstream channels.

• A cable modem that is not provisioned to any RLBG and cannot resolve its MD-CM-SG gets assignedto a DOCSIS 2.0 GLBG. However, if the cable modem resolves its MD-CM-SG, it gets assigned to aDOCSIS 3.0 GLBG.

• A user can configure RLBGs and any upstream or downstream channel into multiple RLBGs on theCisco CMTS. The Cisco CMTS checks whether a RLBG contains both upstream and downstreamchannels. A RLBG can cross multiple MDs.

• A backward compatibility with existing Cisco LB schemes is maintained. The users can switch betweenthe old and new DOCSIS 3.0 compliant LB schemes.

When the Cisco IOS system is upgraded, if the docsis-policy configuration of the DOCSIS load balancinggroups, is missing in the output of the show running-config command, apply the docsis-policy to the DOCSISload balancing groups using the docsis-policy policy-id command again.

Note


DOCSIS Load Balancing GroupsHow to Configure DOCSIS Load Balancing Groups

The following sections describe how to create and configure DOCSIS load balancing groups to enable DOCSISload balancing on the Cisco CMTS:

Configuring DOCSIS 3.0 and 2.0 RLBG and DOCSIS 2.0 GLBGThis section describes how to create and configure a DOCSIS load balancing group. There is a separateconfigurationmode for a DOCSIS load balancing group that is different from the legacy load balancing group.

UGS/PCMM policy and threshold do not apply on DOCSIS 3.0 LB.Note

Procedure



Example: • Enter your password if prompted.

Router> enable


Example:

Step 2


Enables DOCSIS load balancing on the Cisco CMTS.cable load-balance docsis-enable

Example:

Step 3

Router(config)# cable load-balance docsis-enable

Creates a DOCSIS load balance group on the Cisco CMTS,with the following parameter:

cable load-balance docsis-group docsis-group-id

Example:

Step 4

The router enters DOCSIS load balancing groupconfiguration mode.Router(config)# cable load-balance docsis-group

1

Sets the DCC initialization techniques that the Cisco CMTScan use to load balance cable modems.

init-tech-list tech-list [ucc]

Example:

Step 5

Router(config-lb-group)# init-tech-list 1 ucc

Sets the downstream RF channels.downstream {Cable {slot/subslot/port | slot/port} |Integrated-Cable {slot/subslot/bay | slot/port}

Step 6

{rf-channel group list}|{| slot/port} {rf-channel grouplist}}


DOCSIS Load Balancing GroupsConfiguring DOCSIS 3.0 and 2.0 RLBG and DOCSIS 2.0 GLBG


Example:

Router(config-lb-group)# downstreamintegrated-Cable 5/0/0 rf-channel 2

Sets upstream channels with the following parameters:upstream Cable {slot/subslot/port | slot/port}upstream-list

Step 7

Example:

Router(config-lb-group)# upstream Cable 1/0 2

Assigns a policy to a group with the parameter thatbecomes the default policy assigned to the CM, if the CMdoes not choose a different policy.

docsis-policy policy-id

Example:

Router(config-lb-group)# docsis-policy 0

Step 8

Selects the restricted group type. By default, the generalgroup type is selected.

restricted

Example:

Step 9

Router(config-lb-group)# restricted

Sets DCC initialization techniques that overrides thephysical upstream channel pair. The init-tech-ovr

init-tech-ovr Cable {slot/subslot/port | slot/port} upstreamCable {slot/subslot/port } | slot/port upstream init-tech-list0-4 [ucc]

Step 10

command can also be used to determine whether the UCCcan be used for modems during dynamic upstream loadbalancing.Example:

Router(config-lb-group)# init-tech-ovr Cable 8/1/0 The following parameters override the physical upstreamchannel pair:0 Cable 8/1/1 1 init-tech-list 1 ucc

The init-tech-list keyword accepts an upstreamthat is not added into the load balancing group.The upstream channel pair is invalid until theupstream is added. When the load balancinggroup is removed, all upstream channel pairsare also removed.

Note

Adds a service type ID, with the following parameter, thatis compared against the cable modem provisioned service

service-type-id string

Example:

Step 11

type ID, to determine an appropriate restricted loadbalancing group (RLBG):

Router(config-lb-group)# service-type-idcommercial

Adds a tag to the RLBG.tag tag name

Example:

Step 12


DOCSIS Load Balancing GroupsConfiguring DOCSIS 3.0 and 2.0 RLBG and DOCSIS 2.0 GLBG


Router(config-lb-group)# tag t1

Sets the time interval, the Cisco CMTS waits beforechecking the load on an interface.

interval <1-1000>

Example:

Step 13

Router(config-lb-group)# interval 60

Selects the method the Cisco CMTS use to determine theload.

method {modems | service-flows | utilization}{us-method {modems | service-flows | utilization}}

Example:

Step 14

Router(config-lb-group)# method modems us-methodmodems

Selects the modems based on the type of service flow thatare balanced.

policy {pcmm | ugs | us-across-ds | pure-ds-load}

Example:

Step 15

Router(config-lb-group)# policy us-across-dsRouter(config-lb-group)# policy ugsRouter(config-lb-group)# policy pure-ds-load

Selects the percentage of use beyond which load balancingoccurs.

threshold {load {minimum <1-100> | <1-100>}| pcmm<1-100> | stability <0-100> | ugs <1-100>}

Example:

Step 16

Router(config-lb-group)# threshold load minimum10Router(config-lb-group)# threshold pcmm 70Router(config-lb-group)# threshold load 10Router(config-lb-group)# threshold stability 50Router(config-lb-group)# threshold ugs 70

Exits DOCSIS LBG configuration.exit

Example:

Step 17

Router# exit

Configuring DOCSIS 3.0 GLBGThe following sections describe how to configure a DOCSIS 3.0 GLBG and also how to configure defaultvalues of DOCSIS 3.0 certification for the DOCSIS 3.0 general group:

If a Cable interface on the line card is in "no shut down" state, the associated DOCSIS 3.0 GLBGs are restoredin the running-configuration.

Note


DOCSIS Load Balancing GroupsConfiguring DOCSIS 3.0 GLBG

Configuring a DOCSIS 3.0 General Load Balancing GroupThis section describes how to configure a DOCSIS 3.0 general load balancing group.

Procedure



Example: • Enter your password if prompted.Router> enable


Example:

Step 2



Example:

Step 3


Enters the DOCSIS load balancing group configurationmode.

cable load-balance docsis-group FN fn-id MD cable{slot/subslot/port | slot/port}

Example:

Step 4

Router(config)# cable load-balance docsis-groupFN 1 MD c5/0/0

Sets the DCC initialization technique list, with thefollowing parameters.


Example:

Step 5


Disables the load balance group.disable

Example:

Step 6

Router(config-lb-group)# disable

Sets the load balance group policy.docsis-policy policy-id

Example:

Step 7

Router(config-lb-group)# docsis-policy 0

Sets the interface polling interval.interval 1-1000

Example:

Step 8

Router(config-lb-group)# interval 10

Sets the load balancing type or method.method {modems | service-flows | utilization}{us-method {modems | service-flows | utilization}}

Step 9

Example:Router(config-lb-group)# method modems us-methodmodems


DOCSIS Load Balancing GroupsConfiguring a DOCSIS 3.0 General Load Balancing Group


Sets load balancing policy.policy {pcmm | ugs | us-across-ds | pure-ds-load}

Example:

Step 10

Router(config-lb-group)# policy us-across-ds

Sets the load balancing threshold in percentage.threshold {load {minimum 1-100 | 1-100} | pcmm 1-100| stability 0-100 | ugs 1-100}

Step 11

Example:Router(config-lb-group)# threshold pcmm 70

Exits the DOCSIS load balancing group configurationmode.

exit

Example:

Step 12

Router# exit

Configuring Default Values of DOCSIS 3.0 Load Balancing GroupThis section describes how to configure default values of DOCSIS 3.0 certification for a DOCSIS 3.0 generalgroup on the Cisco CMTS. ADOCSIS 3.0 general group is automatically created for eachMD-CM-SG derivedfrom the fiber node (FN) configuration, and the group parameters are set as default values.

The configured default values of DOCSIS 3.0 certification are applicable to the new automatically createdDOCSIS 3.0 GLBGs and do not affect the existing DOCSIS 3.0 GLBGs. When a DOCSIS 3.0 GLBG isremoved and recreated, its group parameters do not change.

Note

The default settings for interface polling interval, load balancing method, policy for modems selection, andthreshold usage in percent, can be configured for DOCSIS 3.0 general group. For more information, see theCisco CMTS Cable Command Reference.

Note

Procedure





Example:

Step 2


Disables the default values of the DOCSIS 3.0 general loadbalance group (GLBG).

cable load-balance d30-ggrp-default disable

Example:

Step 3


DOCSIS Load Balancing GroupsConfiguring Default Values of DOCSIS 3.0 Load Balancing Group

http://www.cisco.com/en/us/docs/ios/cable/command/reference/cbl_05_cable_l.html

PurposeCommand or ActionRouter(config)# cable load-balance d30-ggrp-defaultdisable

Sets the default DOCSIS 3.0 GLBGs DCC and dynamicbonding change (DBC) initialization techniques.

cable load-balance d30-ggrp-default init-tech-list tech-list

Example:

Step 4

Router(config)# cable load-balance d30-ggrp-defaultinit-tech-list 1

Sets the default DOCSIS 3.0 GLBGs policy ID.cable load-balance d30-ggrp-default docsis-policy0-0xffffffff

Step 5

Example:Router(config)# cable load-balance d30-ggrp-defaultdocsis-policy 2

Exits the global configuration mode.exit

Example:

Step 6

Router# exit

Configuring Cable Modems to RLBG or a Service Type IDThis section shows how to configure a list of cable modems that are statically provisioned at the Cisco CMTSto a RLBG or a service type ID.

Procedure





Example:

Step 2


Assigns a modem or a group of modems with a commonMAC mask to a load balancing group or a service type ID.

cable load-balance restrict modem index mac-addr[mac-mask] {docsis-group docsis-group-id |service-type-id string}

Step 3

Example:Router(config)# cable load-balance restrict modem1 001a.c30c.7eee FFFF.FFFF.0000 docsis-group 100


Example:

Step 4

Router# exit


DOCSIS Load Balancing GroupsConfiguring Cable Modems to RLBG or a Service Type ID

Configuring Rules and PoliciesThis section shows how to create and configure rules and DOCSIS policies to restrict the movement of modemsduring load balancing. Rules determine whether a modem can be moved and during which time periods. Thetime periods are measured in seconds with the start time being an offset from midnight measured in seconds.Rules are created individually and can be combined into policies. The user is able to create DOCSIS policiesthat consist of one or more rules. When more than one rule is part of a DOCSIS policy, all rules apply. Eachgroup has a default DOCSIS policy.

Procedure





Example:

Step 2


Creates a rule to prevent the modem from being moved.cable load-balance rule rule-id

Example:

Step 3

Router(config)# cable load-balance rule 1

Configures the rule.cable load-balance rule rule-id {enabled | disabled |{disable-period dis-start 0-86400 dis-period <0-86400>}

Step 4

Static multicast groups should be configured onthe appropriate bundle interface as well as onthe correct forwarding interfaces to enable thisrule. This feature will not be supported on loadbalancing groups which are derived from fibernode configuration and with multicastencryption.

Note| disable-throughput-lowerbound ds | us thrupt in kbps |vdoc-enabled}

Example:Router(config)# cable load-balance rule 1disable-period dis-start 40 dis-period 50

Associates a particular rule with the DOCSIS policy withthe following parameters:

cable load-balance docsis-policy policy-id rule rule-id

Example:

Step 5

Router(config)# cable load-balance docsis-policy2 rule 1


Example:

Step 6

Router# exit

Troubleshooting TipsProblem When you disable load balancing and enable it for the next day using the cable load-balance rulerule-id disable-period dis-start start-time dis-period disable-period command, the load balancing is enabledat 12.00 am instead of the configured disable-period.


DOCSIS Load Balancing GroupsConfiguring Rules and Policies

Possible Cause Load balancing rule cannot be disabled and enabled on the next day (that is, after 24 hours)using a single load balancing rule.

Solution Configure separate load balancing rules for disabling load balancing and enabling it on the next day.Configure the rule to disable load balancing using the cable load-balance rule rule-id disable-period dis-startstart-time dis-period 0 command. Configure the rule to enable load balancing using the cable load-balancerule rule-id disable-period dis-start 0 dis-period disable-period command to enable it for the next day.

Configuring Load Balancing Parameter for a Cable Modem Movement FailureThis section describes how to configure the number of times a CM can fail before the CM is removed fromthe dynamic load balancing group.

Procedure





Example:

Step 2


Configures the number of times a CM can fail before theCM is removed from the dynamic load balancing group.

cable load-balance modem max-failures 0-100

Example:

Step 3

Router(config)# cable load-balance modemmax-failures 10


Example:

Step 4

Router# exit

Creating and Configuring TLV type TagThe tags for TLV type matching rule are created and configured in this section.

Procedure





Example:

Step 2


DOCSIS Load Balancing GroupsConfiguring Load Balancing Parameter for a Cable Modem Movement Failure

PurposeCommand or ActionRouter# configure terminal

Creates a tag.cable tag 1-1000Step 3

Example: Enters the cmts-tag configuration mode.Router(config)# cable tag 1

Specifies the name of the tag.name tag name

Example:

Step 4

Router(cmts-tag)# name CSCO

Configures the specified service type ID for the tag.[exclude] service-type-id service-type-id

Example:

Step 5

Router(cmts-tag)# service-type-id HSD

Configures the specified service class name for the tag.[exclude]service-class service-class-name

Example:

Step 6

Router(cmts-tag)# service-class work

Configures the specified DOCSIS version of the cablemodem for the tag.

[exclude] docsis-version docsis version

Example:

Step 7

Router(cmts-tag)# docsis-version docsis20

Configures the specified OUI of the cable modem for thetag.

[exclude] oui oui of CM

Example:

Step 8

Router(cmts-tag)# oui 00.1a.c3

Configures the specified TLV type for the tag.[exclude] tlv type value

Example:

Step 9

Router(cmts-tag)# tlv mrcs 4

Overrides the TLV or SNMP during load balancing anRLBG.

override

Example:

Step 10

Router(cmts-tag)# override

Exits the cmts-tag configuration mode.exit

Example:

Step 11

Router(cmts-tag)# exit

Creates a DOCSIS load balancing group on the CiscoCMTS.


Example:

Step 12

If the DOCSIS load balancing group is already present,the router enters the specified DOCSIS load balancinggroup configuration mode.

Router(config)# cable load-balance docsis-group1


DOCSIS Load Balancing GroupsCreating and Configuring TLV type Tag


Adds a tag to the load balancing group.tag tag name

Example:

Step 13

Router(config-lb-group)# tag CSCO

Exits the DOCSIS load balancing group configurationmode.

exit

Example:

Step 14

Router(config-lb-group)# exit

Creates a DOCSIS policy and associates a new rule or anexisting rule with the policy.

cable load-balance docsis-policy policy-id tag tag name[override]

Example:

Step 15

Router(config)# cable load-balance docsis-policy2 tag CSCO


Example:

Step 16

Router# exit

Configuration Examples for DOCSIS Load Balancing GroupsThis section describes a sample configuration example for configuring DOCSIS Load Balancing Groupsincluding Restricted/General Load Balancing and downstream dynamic load balancing:

Example: Configuring a TagThe following example shows how you can configure the tag to exclude a DOCSIS version, a MAC address,a service class name or a service type ID:

Router# configure terminalEnter configuration commands, one per line. End with CNTL/Z.Router(config)# cable tag 1Router(cmts-tag)# exclude ?docsis-version set the match rule for docsis versionoui set the match rule for ouiservice-class set the match rule for service class nameservice-type-id set the match rule for service type id

Router(cmts-tag)# exclude docsis-version ?docsis10 Match docsis 1.0 modemsdocsis11 Match docsis 1.1 modemsdocsis20 Match docsis 2.0 modemsdocsis30 Match docsis 3.0 modems

Router(cmts-tag)# exclude docsis-version docsis10Router(cmts-tag)# exclude oui ?WORD OUI of the vendor in the format xx.xx.xx or xx:xx:xx

Router(cmts-tag)# exclude oui 00.1a.c3Router(cmts-tag)# exclude service-class ?WORD Service class name

Router(cmts-tag)# exclude service-class workRouter(cmts-tag)# exclude service-type-id ?


DOCSIS Load Balancing GroupsConfiguration Examples for DOCSIS Load Balancing Groups

WORD Service Type IDRouter(cmts-tag)# exclude service-type-id commercial

Example: Disabling Load BalancingUse the following commands to disable DOCSIS 3.0 GLBG:

Router(config)# cable load-balance docsis-group FN 1 MD cable 6/0/0Router(config-lb-group)# disableRouter(config-lb-group)#

Use the following commands to disable DOCSIS 3.0 RLBG:

Router(config)# cable load-balance docsis-group 1Router(config-lb-group)# disableRouter(config-lb-group)#

How to Configure Load Balancing with OperationalSimplification

To configure Load Balancing Groups with Operational Simplification, complete the following steps:

SUMMARY STEPS

1. Define the global common Load Balancing profile. Specify the Load BalancingGroup configure: method,interval, threshold, policy, and so on.

2. Define the Load Balancing Group under service-group profile. Associate the Load Balancing profile withLoad Balancing group. Configure the DS and US channels.

3. Define the physical mapping info for US or DS channels under fiber-mode.4. Define the service-group profile under Fiber-node.

DETAILED STEPS


Define the global common Load Balancing profile. Specifythe Load Balancing Group configure: method, interval,threshold, policy, and so on.

Step 1

Example:

cable profile load-balance lb_1disablemethod utilization primary-distributed us-methodutilizationthreshold load 2policy pcmminterval 1


DOCSIS Load Balancing GroupsExample: Disabling Load Balancing


Define the Load Balancing Group under service-groupprofile. Associate the Load Balancing profile with LoadBalancing group. Configure the DS and US channels.

Step 2

Example:

cable profile service-group sgload-balance docsis-group 0 profile lb_1downstream sg-channel 0-7upstream 0 sg-channel 0upstream 1 sg-channel 1

Define the physical mapping info for US or DS channelsunder fiber-mode.

Step 3

Example:

cable fiber-node 1downstream sg-channel 0 15 downstream-Cable 6/0/0rf-channel 0 15upstream sg-channel 0 3 Upstream-Cable 6/0/0us-channel 0 3

Define the service-group profile under Fiber-node.Step 4

Example:

cable fiber-node 1service-group profile sg

The Load Balancing Groups are auto-generated when the SG profile is applied.

Example

An example of the Load Balancing Groups Operational Simplification configuration, show run asis as follows:

cable profile load-balance lbmethod utilization primary-distributed us-method utilizationthreshold load 22threshold load lcmm 33policy lcmmpolicy pure-ds-loadinit-tech-list 1-3

cable profile service-group sgload-balance docs is-group 0 profile lbdownstream sg-channel 0 15upstream 0 sg-channel 0upstream 1 sg-channel 1upstream 2 sg-channel 2upstream 3 sg-channel 3

load-balance docsis-group 2 profile RLBG_STBdownstream sg-channel 0-3 8-11upstream 0 sg-channel 0


DOCSIS Load Balancing GroupsHow to Configure Load Balancing with Operational Simplification

cable fiber-node 1downstream Downstream-Cable 6/0/0upstream Upstream-Cable 6/0/0downstream sg-channel 0 15 downstream-Cable downstream-Cable 6/0/0 rf-channel 0 15

upstream sg-channel 0 3 Upstream-Cable 6/0/0 us-channel 0 3service-group profile sg

An example of the Load Balancing Groups Operational Simplification configuration, show derivedas is as follows:

cable profile load-balance lbmethod utilization primary-distributed us-method utilizationthreshold load 22threshold load lcmm 33policy lcmmpolicy pure-ds-loadinit-tech-list 1-3

Cable profile service-group sgLoad-balance docsis-group 0 profile lbdownstream sg-channel 0 15upstream 0 sg-channel 0upstream 1 sg-channel 1upstream 2 sg-channel 2upstream 3 sg-channel 3

load-balance docsis-group 2 profile RLBG_STBdownstream sg-channel 0-3 8-11upstream 0 sg-channel 0

Cable fiber-node 1downstream Downstream-Cable 6/0/0upstream Upstrea-CAble 6/0/0downstream sg-channel 0 15 downstream-Cable 6/0/0 rf-channel 0 15upstream sg-channel 0 3 Upstream-Cable 6/0/0 us-channel 0 3service-group profile sg

Cable load-balance docsis-group 2restricteddownstream Downstream-Cable 6/0/0/ rf-channel 0 15upstream Upstream-Cable 6/0/0 us-channel 0-3method utilization primary-distributedthreshold load 22threshold pcmm 33policy lcmmpolicy pure-ds-loadinit-tech-list 1-3cable managed fiber-node 1cable load-balance-profile lbcable load-balance docsis-group 3restricteddownstream Downstream-Cable 6/0/0 rf-channel 0-3 8-11Upstream Upstream-Cable 6/0/0 us-channel 0Threshold load 55Interval 5Cable managed fiber-node 1Cable load-balance-profile RLBG_STB


DOCSIS Load Balancing GroupsHow to Configure Load Balancing with Operational Simplification

Load Balancing Groups with Operational SimplificationThe Cisco IOS XE Gibraltar 16.10.1d supports simplified Load Balancing configuration in the OperationalSimplification service group profile. Currently, CMTS supports auto creation of D30 GLBGs based on theexisting configuration. Load Balancing would now support creation of RLBGs and D20 GLBGs.

Following are the salient features of the feature:

• For D20 GLBG created by Operational Simplification, the Group ID is in range [65024, 65535]. Thisfollows legacy design.

• For RLBG created by Operational Simplification, the Group ID is related to the information of fiber-nodeid/us channel controller/docsis-group index in service group file. This also follows legacy range [1,2147483647]. For example: RLBG ID: 12330208. Where '123' is the Fiber node ID, '302' is theUpstream-Cable 6/0/0, and '08' is the docsis-group index in service group profile.

cable profile service-group sgload-balance docsis-group 8 profile lb_1downstream sg-channel 0-7upstream 0 sg-channel 0upstream 1 sg-channel 1

• The default value of Load Balance profile are equal to the value of “cable load-balance d20-ggrp-defaultxxx”.

• For Load Balancing Groups that are created by Operational Simplification, the user cannot configurethem with CLI.

• For one service group profile, a user is only allowed to configure one GLBG load balance.

• A user can configure a maximum of 20 tags into one load balance profile.

• A user can configure a maximum of 15 service-type-ids into one load balance profile.

• Load Balancing Groups by Operational Simplification supports fly modification.

• For Load Balancing Groups created by Operational Simplification, if a user changes the option of LoadBalance profile, the OPS would update all the related LBGs automatically. However, the user cannotchange the type of LBGs.

For the Load Balaning Groups created by Operational Simplification, the configuration of the groups wouldnot be dispalyed for the show run or the show run all commands. The Load Balancing Groups would onlybe displayed using the derived command. This change can simplify the running configuration.

clab-cbr-S11K01#show derived-config | sec cable loadcable load-balance docsis-group 1restricteddownstream Downstream-Cable 6/0/0 rf-channel 0-7upstream Upstream-Cable 6/0/0 us-channel 0-1method utilization primary-distributedthreshold load 2cable managed fiber-node 1cable load-balance-profile lb_1


DOCSIS Load Balancing GroupsLoad Balancing Groups with Operational Simplification

Verifying DOCSIS Load Balancing GroupsThis section describes how to use certain show commands to verify the configuration of the Restricted/GeneralLoad Balancing and Narrowband Dynamic Bandwidth Sharing with Downstream Dynamic Load Balancingfeature.

Procedure




Displays real-time configurational, statistical, andoperational information of the load balancing operationson the router.

show cable load-balance docsis-group {docsis-group-id| FN fn-id MD cable {slot/subslot/port | slot/port}} [all |load | pending | statistics | target | modem-list |primary-load]

Step 2

Example:Router# show cable load-balance docsis-group 1Router# show cable load-balance docsis-group fn 1MD c8/1/4

Displays information about a fiber node.show cable fiber-node fiber-node-id [spectrum]

Example:

Step 3

Router# show cable fiber-node 3

Displays real-time statistical and operational informationfor load balancing operations. If given without any options,

show cable load-balance [group n] | [all | load | pending| statistics | target | fiber-node-validation]

Step 4

this command displays information for the load balancingExample: groups and each cable interface's current load and load

balancing status.Router# show cable load-balance group 1

Displays information for the registered and unregisteredCMs.

show cable modem [ip-address | mac-address | cableslot/port [upstream port ] | name fqdn] [verbose]

Example:

Step 5

Router# show cable modem 40.3.160.15 verbose

Examples

Use the show cable load-balance docsis-group command to see the DOCSIS group status and tosee the list of modems in the group, use the show cable fiber-node command to see the informationon fiber nodes, use the show cable load-balance command to see information on LBG and DOCSISchannels, and use the show cable modem command to see the information on all the CMs.

The following examples show the output of the show cable load-balance docsis-group command:

Router# show cable load-balance docsis-group 2


DOCSIS Load Balancing GroupsVerifying DOCSIS Load Balancing Groups

DOCSIS LB Enabled: YesDOCSIS Group Status Interval DCC mask Policy Method ThresholdGroup Index /UCC DS/US M/E/U/P/S2 82 RE 10 0xF8(0)/N 0 s/s 1/1/70/70/50Router# show cable load-balance docsis-group 1 modem-listUS Group Index Mac Address PriorityMo1/0/0:0/U0 81 (1)

0000.ca45.9898 0Mo1/0/0:0/U1 81 (0)Mo1/0/0:0/U2 81 (2)

0013.711c.0820 00016.924f.8300 0

The output of the show cable load-balance docsis-group command is modified to include anadditional fieldMUPFXLR to displaymore status information on the modems in the DOCSIS groups.For more information, see the Cisco IOS CMTS Cable Command Reference.

The following example shows the modified output of the show cable load-balance docsis-groupcommand:

Router#show cable load docsis-group fn 1 md c6/0/0 modem-listLoad for five secs: 1%/0%; one minute: 2%; five minutes: 1%Time source is NTP, 13:39:31.300 PDT Thu Mar 28 2013Codes: M - Multicast, U - UGS, P - PCMM, F - Max-Failures, X - eXcluded

L - L2vpn, R - RSVPPrimary DS Grp Idx MAC Address RCC-ID Bad Rfid Priority MUPFXLRIn6/0/0:0/UB 40448 (6)

e448.c70c.98af 1 2 -------e448.c70c.9b76 1 2 -------e448.c70c.9c15 1 2 -------e448.c70c.9a92 1 2 -------e448.c70c.99e4 1 2 -------e448.c70c.9a35 1 2 -------

In6/0/0:0/U0 40448 (0)In6/0/0:0/U1 40448 (1)

e448.c70c.9915 2 -------In6/0/0:0/U2 40448 (0)In6/0/0:0/U3 40448 (0)In6/0/0:1/UB 40448 (5)

e448.c70c.9abc 1 2 -------e448.c70c.993f 1 2 -------e448.c70c.9927 1 2 -------e448.c70c.9b82 1 2 -------4458.2945.2cb8 1 2 -------

In6/0/0:1/U0 40448 (0)In6/0/0:1/U1 40448 (0)In6/0/0:1/U2 40448 (0)In6/0/0:1/U3 40448 (0)In6/0/0:2/UB 40448 (5)

e448.c70c.9759 1 2 -------e448.c70c.9a0e 1 2 -------e448.c70c.992d 1 2 -------e448.c70c.9a38 1 2 -------0025.2ed9.9984 1 2 -----L-

In6/0/0:2/U0 40448 (0)In6/0/0:2/U1 40448 (0)In6/0/0:2/U2 40448 (0)In6/0/0:2/U3 40448 (0)In6/0/0:3/UB 40448 (5)

e448.c70c.9c00 1 2 -------



http://www.cisco.com/en/us/docs/ios/cable/command/reference/cbl_15_show_a_to_show_cable_l.html

e448.c70c.99a5 1 2 -------e448.c70c.9a5f 1 2 -------e448.c70c.9a3b 1 2 -------e448.c70c.96b1 1 2 -------

In6/0/0:3/U0 40448 (0)In6/0/0:3/U1 40448 (0)In6/0/0:3/U2 40448 (0)In6/0/0:3/U3 40448 (0)

The following example shows the output of the show cable fiber-node command:

Router# show cable fiber-nodeFiber-Node Config StatusFiber-Node 1

Modular-Cable 1/0/0: 0-1FN Config Status: Configured (status flags = 0x01)MDD Status: Valid

The following examples show the output of the show cable load-balance command:

Router#show cable load-balanceGroup Interval Method DCC Init Threshold

Technique Minimum Static Enforce Ugs PCMM1 10 service-flows 1 1 2% 2% --- ---2 10 modems 0 5 10% --- --- ---

DOCSIS LB Enabled: NoRouter# show cable load-balance loadInterface State Group Utilization Reserved Modems Flows Weight

IndexCable5/0/3 (459 MHz) up 1 0%(0%/0%) 0% 7 7 37Cable5/0/3/U0 up 1 0% 0% 2 2 1.2Cable5/0/3/U1 up 1 0% 0% 2 2 1.2Cable5/0/3/U2 up 1 0% 0% 2 2 1.2Cable5/0/3/U3 up 1 0% 0% 1 1 1.2Cable5/0/4 (465 MHz) up 1 0%(0%/0%) 0% 7 7 37Cable5/0/4/U0 up 1 0% 0% 1 1 1.2Cable5/0/4/U1 up 1 0% 0% 2 2 1.2Cable5/0/4/U2 up 1 0% 0% 2 2 1.2Cable5/0/4/U3 up 1 0% 0% 2 2 1.2Mo1/0/0:0 (555 MHz) down 1 0%(0%/0%) 0% 0 0 0Router# show cable load-balance fiber-node-validationDOCSIS LBG ID Match Channel Fiber-node list1 match Ca5/0/0/U0 {1}

Ca5/0/0/U1 {1}Ca5/0/0/U2 {1}Ca5/0/0/U3 {1}Mo1/0/0:0 {1}Mo1/0/0:1 {1}

2 mismatch Ca5/0/0/U0 {1}Ca5/0/0/U1 {1}Ca5/0/0/U2 {1}Ca5/0/0/U3 {1}Ca5/0/0 {}

The following example shows the output of the show cable modem command:



Router# show cable modem 40.3.160.19 verboseLB group ID assigned(index) : 1(81)LB group ID in config file(index) : N/A(N/A)LB policy ID : 0LB policy ID in config file : 0LB priority : 0Tag :

DOCSIS 3.0 GLBG is generated dynamically by the fiber node configuration, if a valid fiber nodeis configured.

For example, if the fiber node configuration is:

cable fiber-node 2downstream Modular-Cable 1/0/0 rf-channel 0-3downstream Cable7/0/0upstream Cable 7/0 connector 0-3!

The GLBG generated by this fiber node is similar to:

Router# show cable load-balance docsis-group fn 2 md cable 7/0/0DOCSIS 3.0 General LBMD FN Group S Intv DCC mask Policy Mtd MD-CM-SG Threshold

Index /UCC D/U M/E/U/P/SCa7/0/0 2 48129 E 30 0xF8(0)/N 0 m/m 0x3C0101 5/10/70/70/50

Router# show cable load-balance docsis-group fn 2 md cable 7/0/0 allDOCSIS 3.0 General LBMD FN Group S Intv DCC mask Policy Mtd MD-CM-SG Threshold

Index /UCC D/U M/E/U/P/SCa7/0/0 2 48129 E 30 0xF8(0)/N 0 m/m 0x3C0101 5/10/70/70/50Current load:DOCSIS load-balancing loadInterface State Group Utilization Rsvd NBCM WB/UB Flows Weight

Index Total TotalCable7/0/0 (333 MHz) up 48129 0%(0%/0%) 0% 2 8 7 37Cable7/0/0/U0 up 48129 0% 0% 22 7 29 7.6Cable7/0/0/U1 up 48129 0% 0% 21 8 28 7.6Cable7/0/0/U2 up 48129 0% 0% 21 8 28 7.6Cable7/0/0/U3 up 48129 0% 0% 20 10 30 7.6Mo1/0/0:0 (501 MHz) up 48129 0%(0%/0%) 0% 2 63 2 36Mo1/0/0:0/U0 up 48129 0% 0% 22 7 29 7.6Mo1/0/0:0/U1 up 48129 0% 0% 21 8 28 7.6Mo1/0/0:0/U2 up 48129 0% 0% 21 8 28 7.6Mo1/0/0:0/U3 up 48129 0% 0% 20 10 30 7.6Mo1/0/0:1 (507 MHz) up 48129 0%(0%/0%) 0% 1 58 1 36Mo1/0/0:1/U0 up 48129 0% 0% 22 7 29 7.6Mo1/0/0:1/U1 up 48129 0% 0% 21 8 28 7.6Mo1/0/0:1/U2 up 48129 0% 0% 21 8 28 7.6Mo1/0/0:1/U3 up 48129 0% 0% 20 10 30 7.6Mo1/0/0:2 (513 MHz) up 48129 0%(0%/0%) 0% 2 59 2 36Mo1/0/0:2/U0 up 48129 0% 0% 22 7 29 7.6Mo1/0/0:2/U1 up 48129 0% 0% 21 8 28 7.6Mo1/0/0:2/U2 up 48129 0% 0% 21 8 28 7.6



Mo1/0/0:2/U3 up 48129 0% 0% 20 10 30 7.6Mo1/0/0:3 (519 MHz) up 48129 0%(0%/0%) 0% 1 61 1 36Mo1/0/0:3/U0 up 48129 0% 0% 22 7 29 7.6Mo1/0/0:3/U1 up 48129 0% 0% 21 8 28 7.6Mo1/0/0:3/U2 up 48129 0% 0% 21 8 28 7.6Mo1/0/0:3/U3 up 48129 0% 0% 20 10 30 7.6Target assignments:Interface State Group Target

IndexCable7/0/0 (333 MHz) up 48129Cable7/0/0/U0 up 48129Cable7/0/0/U1 up 48129Cable7/0/0/U2 up 48129Cable7/0/0/U3 up 48129Mo1/0/0:0 (501 MHz) up 48129 Mo1/0/0:1 (507 MHz)Mo1/0/0:0/U0 up 48129Mo1/0/0:0/U1 up 48129Mo1/0/0:0/U2 up 48129Mo1/0/0:0/U3 up 48129Mo1/0/0:1 (507 MHz) up 48129Mo1/0/0:1/U0 up 48129Mo1/0/0:1/U1 up 48129Mo1/0/0:1/U2 up 48129Mo1/0/0:1/U3 up 48129Mo1/0/0:2 (513 MHz) up 48129Mo1/0/0:2/U0 up 48129Mo1/0/0:2/U1 up 48129Mo1/0/0:2/U2 up 48129Mo1/0/0:2/U3 up 48129Mo1/0/0:3 (519 MHz) up 48129Mo1/0/0:3/U0 up 48129Mo1/0/0:3/U1 up 48129Mo1/0/0:3/U2 up 48129Mo1/0/0:3/U3 up 48129Statistics:Target interface State Transfers

Complete Pending Retries FailuresCable7/0/0 (333 MHz) up 8 0 0 0Cable7/0/0/U0 up 30 0 0 0Cable7/0/0/U1 up 83 0 0 0Cable7/0/0/U2 up 48 0 0 0Cable7/0/0/U3 up 34 0 0 0Mo1/0/0:0 (501 MHz) up 19 0 0 0Mo1/0/0:0/U0 up 33 0 0 0Mo1/0/0:0/U1 up 46 0 0 0Mo1/0/0:0/U2 up 22 0 0 0Mo1/0/0:0/U3 up 22 0 0 0Mo1/0/0:1 (507 MHz) up 22 0 0 0Mo1/0/0:1/U0 up 9 0 0 0Mo1/0/0:1/U1 up 19 0 0 0Mo1/0/0:1/U2 up 15 0 0 0Mo1/0/0:1/U3 up 21 0 0 0Mo1/0/0:2 (513 MHz) up 21 0 0 0Mo1/0/0:2/U0 up 4 0 0 0Mo1/0/0:2/U1 up 3 0 0 0Mo1/0/0:2/U2 up 6 0 0 0Mo1/0/0:2/U3 up 7 0 0 0Mo1/0/0:3 (519 MHz) up 9 0 0 0Mo1/0/0:3/U0 up 1 0 0 0Mo1/0/0:3/U1 up 2 0 0 0Mo1/0/0:3/U2 up 4 0 0 0Mo1/0/0:3/U3 up 4 0 0 0Pending:Modem Grp Idx Primary RF/RCC MD/TCS Action Active Retries



Src Target Src Target Time


LinkDescription




Feature Information for DOCSIS Load Balancing GroupsUse Cisco Feature Navigator to find information about the platform support and software image support.Cisco Feature Navigator enables you to determine which software images support a specific software release,feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An accounton the Cisco.com page is not required.


Note

Table 12: Feature Information for DOCSIS Load Balancing Groups


This feature was integrated on thecisco cBR Series ConvergedBroadband Routers.

Cisco IOS XE Fuji 16.7.1DOCSIS Load Balancing Groups

This feature was integrated on thecisco cBR Series ConvergedBroadband Routers.

Cisco IOS XE Gibraltar 16.10.1d.Load Balancing with OperationalSimplification


DOCSIS Load Balancing GroupsAdditional References



C H A P T E R 6DOCSIS Load Balancing Movements

Cisco CMTS supports static load balancing forMTC/MRCmodems and dynamic load balancing for non-MTCand/or non-MRC modems. Support for configuration of load balancing groups (LBGs) that entail multipleinterfaces, multiple load balancing policies, and the option to configure multiple additional load balancingparameters are also included.

The load balancing policies can be configured on the Cisco CMTS, indexed by an ID, to limit the movementof cable modems within a Load Balancing Group (LBG). The cable modem will forward TLV43.1in itsregistration request (REG-REQ) message, which is then parsed and stored in the Cisco CMTS. A policydefines whether and when cable modems can be moved within their load balancing groups.

During dynamic load balancing, the specified policy of the cable modem is checked to determine whether thecable modem is allowed to move.

Load balancing supports Dynamic Channel Change (DCC). DCC in DOCSIS 1.1, dynamically changes cablemodem upstream or downstream channels without forcing a cable modem to go offline, and withoutre-registration after the change.

Load balancing distributes downstream load balancing with upstream channel loads in the same upstreamload balancing group. This improves upon the prior load balancing limitation, in which load balancing wasimplemented on the basis of the entire downstream channel load.

Load balancing uses rules and policies to decide on moving the cable modems within their LB groups. Thesepolicies are created on the Cisco CMTS and chosen on a per-CM basis using type-length-value (TLV) portion(43.1,Policy ID) of REG-REQ. These policies prohibit a modem from being moved or restricted.

A policy contains a set of rules. When the policy is defined by multiple rules, all rules apply in combinations.A rule can be defined as "enabled" , "disabled" , or "disabled during time period. " Each rule can be used bymore than one policy.

DOCSIS 3.0 static modem count-based load balancing uses the dynamic bonding change (DBC) to modifythe following parameters of DOCSIS 3.0 cable modemwith multiple transmit channel (MTC)mode or multiplereceive channel(MRC) mode without primary channel change:

• Transmit channel set (TCS)• Receive channel set (RCS)• Downstream IDs (DSID) or DSID-associated attributes• Security association for encrypting downstream traffic

These parameters and additional load balancing schemes are supported on the Cisco CMTS, and describedin this document. This document describes all implementations of load balancing on the Cisco CMTS,dependent upon the Cisco IOS release installed and the desired parameters.




• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 84• Prerequisites, on page 85• Restrictions, on page 86• Information on the Load Balancing on the Cisco CMTS, on page 90• How to Configure Load Balancing, on page 106• How to Configure Dynamic Channel Change for Load Balancing, on page 109• Configuration Examples for Load Balancing, on page 115• Additional References, on page 119• Feature Information for DOCSIS Load Balancing Movements, on page 119



Note


DOCSIS Load Balancing MovementsHardware Compatibility Matrix for the Cisco cBR Series Routers















Digital PICs:


•













Prerequisites

Prerequisites for Load BalancingThe Load Balancing feature has the following prerequisites:

• Load balancing can be done only on upstreams and downstreams that share physical connectivity withthe same group of cable modems.


DOCSIS Load Balancing MovementsPrerequisites

Prerequisites for Dynamic Channel Change for Load Balancing• DCC can be done only to a cable modem that is physically connected to both source and target upstreamor downstream channels, or both.

• Upstreams and downstream channels that share the same physical connectivity must have different centerfrequencies separated by channel width.

• The difference between the physical layer parameters on the source and target DCC channels must bewithin the threshold required by the desired DCC initialization technique.

• DOCSIS 1.1 must be enabled for a modem to behave properly for the DCC operation. Note that not allDOCSIS 1.1 certified modems are DCC-capable, as the CableLabs DCC ATP tests need enhancementfor complete coverage.

Prerequisites for Dynamic Bonding Change for DOCSIS 3.0 Static ModemCount-Based Load Balancing

• Initialization techniques 1 to 4, when used, require the Cisco CMTS to include the upstream channeldescriptor (UCD) TLV (TLV46.5) in the DBC-REQ message.

• Bandwidth must be sufficient on the target bonding group to support DBC. This is determined by theadmission control APIs.

• Fiber nodes must be configured before configuring DOCSIS 3.0 static modem count-based load balancing.

RestrictionsThe following sections describe the restrictions applicable for the Load Balancing, Dynamic Channel Change,and Dynamic Bonding Change feature:

Restrictions for Load BalancingThe Load Balancing feature has the following restrictions:

• Load balancing can be done only on a per-line card basis—all interfaces in a load balancing group mustbe provided by the same line card.

• All downstreams and upstreams in a load balancing group must share physical connectivity to the samegroup of cable modems. All downstreams or all upstreams that have the same RF physical connectivitymust be members of the same load balancing group.

• You can create a maximum of 256 load balancing groups on each line card.

• If an upstream port is operational, using the no shutdown command, and is not being used and notconnected, load balancing attempts to use the port even though there are no cable modems registered onthat port. When the upstream port is up, it is put into INIT state and load balancing includes this port asa potential target. However, if the load balancing sees multiple failures moving to this upstream, it is setto DISABLE state and the port is avoided later on in load balancing processes.


DOCSIS Load Balancing MovementsPrerequisites for Dynamic Channel Change for Load Balancing

• The load balancing algorithms assume a relatively even distribution of usage among modems. In thesituation where one cable modem creates the bulk of the load on an interface, the load balancing thresholdsshould be configured for a value above the load created by that single modem.

• You cannot select particular cable modems to be automatically moved for load balancing, although youcan exclude cable modems from load balancing operations altogether on the basis of their MAC addressor organization unique identifier (OUI). (You can use the test cable load-balance command to manuallymove a particular cable modem among upstreams, but this is done typically to test the configuration ofthe load balancing groups.)

• If you have configured upstream shared spectrum groups while doing downstream load balancing, thedownstream in each MAC domain must not use overlapping upstream groups. For example, thedownstream in one MAC domain could use an upstream spectrum band of 10 to 30 MHz, while thedownstream in a second MAC domain could use an upstream spectrum band of 30 to 42 MHz. EachMAC domain has its own upstream shared spectrum group, allowing the load balancing group to containthe downstreams for both MAC domains.

• All upstream ports coming from the same splitter must be using different center frequencies that areseparated by the channel width. For example, if the upstreams are using a channel width of 3.2 MHz,the center frequencies for all upstreams must be separated by at least 3.2 MHz.

• You can use four initialization techniques for Dynamic Channel Change (DCC).

• If you have configured load balancing, the provisioning systemmust not assign specific upstream channelsor downstream frequencies to individual cable modems in their DOCSIS configuration files. Any cablemodems requiring specific upstream channels or downstream frequencies must be excluded from loadbalancing operations (using the cable load-balance exclude command).

• Do not use the utilization method of load balancing on cable interfaces that have a small number of cablemodems and where a single modem is responsible for the majority of the interface load. In this condition,the Cisco CMTS could end up continually moving cable modems from one interface to another in anendless attempt to load balance the interfaces. To avoid this, configure the utilization threshold to a valuethat is higher than what can be caused by any single cable modem.

• When deployed with channel restriction features, if the target upstream channel attribute masks areagainst that of the cable modem, then the cable modem on the higher load upstream will not be loadbalanced, as the current load balancing moves cable modems only to the target upstream. However, cablemodems that do not have an attribute mask can still be load balanced. You should consider the followingwhile deploying the load balancing groups: the target upstream will always be the upstream that has thelowest load. If some other upstreams have the same load, the upstream with the lowest index will bechosen as the target upstream.

• A TLV in a cable modem configuration file restricts dynamic load balancing on per modem basis.

• If you remove the last rule of a DOCSIS policy, the policy itself will be removed.

• The Cisco CMTS load balancing feature moves a cable modem based on the load of the channels in aload balancing group, without checking if the cable modem supports the extended frequency range(5Mhz-85Mhz). This may result in moving a cable modem that supports standard frequency range(5Mhz-65Mhz) to a channel that has extended frequency configured. To overcome such scenarios,operators should not mix upstreams that have standard and extended frequencies configured into thesame load balancing group, unless all modems in the group support extended frequency range.


DOCSIS Load Balancing MovementsRestrictions for Load Balancing

Restrictions for Dynamic Channel Change for Load Balancing• The source and target upstreams and downstreams must share physical connectivity with the modemdesired for a DCC transaction.

• Independent downstream change is not supported, and cross-MAC domain upstream changes must occurwith the associated downstream changes.

• The source and target downstream interfaces must belong to the same virtual bundle and the same loadbalancing group if DCC is used for load balancing.

• For DCC initialization techniques 1 to 4, all the configuration variables of the cable modemmust remainconstant with the exception of the configuration variables that are explicitly changed by the DynamicChannel Change request (DCC-REQ) messages encoding.

• DCC initialization techniques 2 to 4 must not be used if the propagation delay differences between theold and new channels exceeds the ranging accuracy requirement defined in DOCSIS, for example, ±0.25usec plus ± symbol time.

For example, for a symbol rate of 1.28 Msps, the timing offset difference between the source and targetupstream channel is ± floor[(0.250 us + 0.5*0.781us)/(1/10.24)] = ± 6.

• The attenuation or frequency response differences between the old and new upstream channels causesthe received power at the Cisco CMTS to change by more than 6 dB.

• DCC initialization technique 3 must not be used if the conditions for using technique 2 are not met.

• DCC initialization technique 4 must not be used if the conditions for using technique 2 cannot be met.

• Micro-reflections on the new upstream channel result in an unacceptable BER (greater than 1e-8) withpre-equalization coefficients set to the initial setting.

• DCC is used only for dynamic downstream load balancing on DOCSIS 1.1 and later CMs. UpstreamChannel Change (UCC) is always used for dynamic upstream load balancing on DOCSIS 1.x CMs. ForDOCSIS 2.x CMs, UCC is used when the ucc option is configured. For DOCSIS 3.x CMs, DCC is usedirrespective of whether the ucc option is configured or not.

• Prolonged interruption of the multicast traffic is expected if the cable modem moved by DCC is the firstone in a dynamic multicast group on the target interface. The downstream multicast service flow cannotbe reestablished until the Cisco CMTS receives an Internet Group Management Protocol (IGMP) joinmessage from the customer premises equipment (CPE) as the result of the Cisco CMTS IGMP query,where the IGMP query interval is set to one minute. This is an IGMPv2 limitation.

• Multiple statically-assigned IP addresses to a CPE can be pinged. However, this works only if all thesecurity features, such as verification of IP addresses for cable modems and CPE devices on the upstream,and other security mechanism are disabled.

• The TCS and RCS assigned to the DOCSIS 3.0 cable modems are restricted by the upstream anddownstream bonding groups configured by the Cisco CMTS.

• Load balancing and DCC are not supported for CMs that are enabled for Layer 2 VPN (L2VPN) support.

• When a DCC occurs, the cable modem US and DS counters are reset. The US and DS counters includecounters such as data and throughput seen in the show cable modem (mac-address) verbose commandoutput and packets and bytes seen in the show cable modem (mac-address) counters command output.


DOCSIS Load Balancing MovementsRestrictions for Dynamic Channel Change for Load Balancing

DCC Restrictions with N+1 Redundancy and Inter-Card Load Balancing• Inter-card load balancing is not supported with cable interface line cards using N+1 redundancy. Referto general DCC restrictions for additional information.

• Dynamic load balancing should not be used together with N+1 redundancy. Cable modems withoutstanding DCC transactions go offline after a switchover event.

When cable modems go offline during a switchover event, the load balancingfeature activates. Cable modems move in relation to the switchover event. Whenthe cable modems return online, load balancing may need to initiate again.

To facilitate load balancing during a switchover, you can increase the dynamicload balance threshold, if a certain percentage of cable modems that reset duringswitchover is configured in the system. An alternate method is to use static loadbalancing with N+1 redundancy. For more information, see the Types of LoadBalancing Operations.

Note

Restrictions for DOCSIS 3.0 Static Modem Count-Based Load Balancing• Static modem count-based load balancing is supported on MTC and MRC-only cable modems.Single-channel, narrowband cable modems will continue to be supported with dynamic load balancing.MRC-only modems are supported by dynamic load balancing on upstream channels.

DOCSIS 3.0 static modem count-based load balancing is not supported on:

• Multiple line cards.

• Load balancing groups and downstream channels shared across multipleline cards.

Note

• DOCSIS 3.0 static modem count-based load balancing does not support service flow method of loadbalancing.

Restrictions for Dynamic Bonding Change for DOCSIS 3.0 Static Modem Count-Based LoadBalancing

• The Cisco CMTS can use only DBC messaging to move modems within a MAC domain and appliesonly to cablemodems operating inMTCmode orMRC-onlymodewithout a primary downstream change.

• The Cisco CMTS moves the MRC-only cable modems with a primary channel change using DCC withinitialization technique 0.

• The Cisco CMTSmoves cablemodems acrossMACdomains using onlyDCCwith initialization technique0.

• The Cisco CMTS must ensure minimum interruption to existing QoS services while considering aninitialization technique that is suitable for the cable plant conditions.


DOCSIS Load Balancing MovementsDCC Restrictions with N+1 Redundancy and Inter-Card Load Balancing

http://www.cisco.com/c/en/us/td/docs/cable/cbr/configuration/guide/b_cbr_full_book_docsis_30/b_cbr_full_book_docsis_30_chapter_01010.html#concept_0585A95C9A644CC5B79191DC88BF772B

http://www.cisco.com/c/en/us/td/docs/cable/cbr/configuration/guide/b_cbr_full_book_docsis_30/b_cbr_full_book_docsis_30_chapter_01010.html#concept_0585A95C9A644CC5B79191DC88BF772B

DOCSIS 3.0 Static Load Balancing uses Initialization Technique 1 to move cablemodems for DBC movement.

Note

• Initialization Technique 1—(Broadcast initial ranging) may result in a lengthy interruption of service,which is mitigated by the reservation of QoS resources on the new channel(s). The service interruptioncan be further reduced if the Cisco CMTS supplies the UCD TLV in the DBC request in additionto providing more frequent initial ranging opportunities on the new channel.

• Initialization Technique 2—(Unicast ranging) offers the possibility of only a slight interruption ofservice. To use this technique, the Cisco CMTS must include the UCD TLV in the DBC messageif the upstream channel is changing.

• Initialization Technique 3—(Broadcast or unicast ranging) offers the possibility of only a slightinterruption of service. Use this technique when there is uncertainty when the CM may execute theDBC command and thus a chance that it might miss station maintenance slots. However, the CiscoCMTS should not use this technique if the conditions for using techniques 1 and 2 are not completelysatisfied.

• Initialization Technique 4—(Use the new channel directly) results in the least interruption of service.

• For a DOCSIS 3.0 cable modem that in a DOCSIS 3.0 static load balancing group, the multicast joinwill be dropped before REG-HOLD time elapses.

Restrictions for MRC-Only Cable Modems• MRC-only cablemodems use single channel non-bonded upstreams (similar to narrowband (NB)modems)and multi-channel bonding groups on the downstream.

The following restrictions apply only to DOCSIS 2.0 and DOCSIS 3.0 cablemodems in MRC-only mode.

Note

• cable modems are moved across upstream channels using DCC.

• cable modems are moved to different downstream channels through DBC, if there is a change in theupstream channel and downstream channel bonding group, but not in the primary downstream channeland the upstream channel change is ignored.

However, if there is a change in the primary downstream channel also, DCC with init tech 0 is used tobalance the cable modems.

• MRC-only modems are treated similar to cable modems operating in MTC mode, to move modemsacross downstream channels. For change in upstream channel, MRC-only cable modems are treatedsimilar to single-channel NB cable modems.

Information on the Load Balancing on the Cisco CMTSThis section describes the operation, concepts, and benefits of the Load Balancing on the Cisco CMTS feature:


DOCSIS Load Balancing MovementsRestrictions for MRC-Only Cable Modems

Feature OverviewThe Load Balancing on the Cisco CMTS feature allows service providers to optimally use both downstreamand upstream bandwidth, enabling the deployment of new, high-speed services such as voice and videoservices. This feature also can help reduce network congestion due to the uneven distribution of cable modemsacross the cable network and due to different usage patterns of individual customers.

By default, the Cisco CMTS platforms use a form of load balancing that attempts to equally distribute thecable modems to different upstreams when the cable modems register

This feature has been enhanced to make use of DOCSIS policies and rules to limit the movement of cablemodems within a Load Balancing Group. A policy defines whether and when cable modems can be movedwithin their load balancing groups.

A policy consists of a set of rules. Each rule can be defined as “enabled”, “disabled”, or “disabled during timeperiod.” Multiple policies can share a single rule. However, if you remove the last rule of a policy, that willalso remove the policy.

Each rule can be used in any number of policies. When it is defined by multiple rules, all rules apply incombinations. Each rule helps to prohibit load balancing using a particular cable modem and to prohibit loadbalancing using a particular cable modem during certain times of the day.

Following are the general guidelines for the rules and policies:

• The policy or rule is recognized by a 32-bit ID.

• Each cable modem can have one policy only.

• Each rule can be associated to one or more policies.

• Each policy is described by at least one rule, otherwise it cannot be created.

• The zero Policy ID is reserved by Cisco CMTS indicating “Do nothing to LB prohibition.”

• If the policy ID specified by the cable modem configuration file is not configured on Cisco CMTS, noLB prohibition is applied to that CM. However, after the policy with the matched ID is configured, LBprohibition takes effect immediately.

Methods to Determine When Interfaces Are BalancedIn addition to selecting how interfaces should be balanced (using the static, passive, or dynamic types of loadbalancing), you can also select one of the following methods that the Cisco CMTS should use to determinewhen interfaces are balanced:

• Modems Method—Uses the number of active cable modems on an interface.

• Utilization Method—Uses the current percentage of utilization of an interface.

See the following sections for more information about each method.

Modems MethodThe modem method of load balancing uses the number of active cable modems on an interface to determinethe current load. This is a form of distribution-based load balancing, in which the absolute numbers of modemsare used to determine whether interfaces are load balanced.


DOCSIS Load Balancing MovementsFeature Overview

This method does not take into account the amount of traffic flowing through the cable modems, but thesystem does take into account the relative bandwidth of the channels being used, so that channels with higherbandwidths are allocated higher numbers of cable modems. This means that when interfaces are using differentchannel widths or modulation profiles, the system can assign different numbers of cable modems to theinterfaces to achieve a balanced load. For example:

• Channel widths— If two upstreams are being load balanced, and one upstream is configured with achannel width of 1.6 MHz and the other upstream is configured for a channel width of 3.2 MHz, theCisco CMTS allocates twice as many cable modems to the second upstream because its channel widthis twice as large as the first upstream channel width.

• Modulation profiles— If one downstream is configured for 64-QAM and the other downstream isconfigured for 256-QAM, the Cisco CMTS allocates a proportionately larger number of cable modemsto the second downstream so as to achieve a balanced load.

When both the channel width and modulation profile are set differently on two interfaces, the system calculatesa “weight” value to use as a guide to determine the relative bandwidths of the interfaces.

In a system with balanced loads, the interfaces will contain the same number of cable modems only when theinterfaces are configured with the same channel width and modulation parameters.

Tip

Utilization Method

Narrowband cable modems, multiple downstream modems and upstreams of MRC-only cable modemsparticipate in the utilization method.

Note

The utilization method uses an interface’s current percentage of utilization to determine the current load. Thismethod uses the amount of traffic being sent over an interface, in the form of the percentage of total bandwidthbeing used. The system takes into account the relative throughput and bandwidth (as determined by themodulation profiles and channel widths) of each interface when evaluating the load on those interfaces.

For example, if two upstreams are being load balanced using the utilization method, and the first upstreamhas twice the bandwidth of the second upstream, the two upstreams are considered balanced when they reachthe same percentage of utilization. The first upstream is carrying more traffic than the second upstream becauseit has a larger capacity for traffic, but the percentage of utilization will be the same.

Wideband Interface Average Utilization and Throughput

The average utilization and average throughput betweenWideband interfaces of the same size can be calculatedby:

Average Utilization (WB) = ∑ni-1rfch - util(rfi)/n

• n represents the size of the Wideband interface• ∑n

i-1rfch - util(rfi) represents the sum of rfch - util of QAM channels in Wideband interface.

Average Throughput (WB) = AverageThroughput(WB)in last 30s/∑ni=1BW(rfi)

• Average Throughput (WB) represents the KB recorded in the last 30 seconds• ∑n

i=1BW(rfi) represents the total bandwidth of Wideband interface.


DOCSIS Load Balancing MovementsUtilization Method

Use the show cable load-balance load wideband command to view the average utilization and averagethroughput between Wideband interfaces.

Note

Load Balancing ParametersYou can determine which cable interfaces should participate in load balancing operations. You can also choosewhich of the following methods should be used to determine the current load on a cable interface, and thereforedetermine whether cable modems should be moved:

• Number of active cable modems

• Channel bandwidth utilization

You can also specify the threshold values that the Cisco CMTS should use to determine how to assign newcable modems to upstreams and downstreams for both types of load balancing. You can also configure whethercable modems with active Voice-over-IP (VoIP) calls should be moved, and if so, what thresholds should beused. You can also exclude certain cable modems from one or all of the different forms of load balancing.

Configurable Minimum Threshold under Utilization MethodThe utilization method does not move cable modems for load balancing until the utilization of at least one ofthe interfaces reaches minimum threshold. This is done to avoid the unnecessary moving of cable modemsdue to temporary spikes in an interface's utilization rate.

Minimum utilization threshold can be configured under UtilizationMethod. Theminimum utilization thresholdmay be configured in a range of 10 to 90 percent. As a result the cable modems will be moved only when theconfigured minimum utilization threshold is reached on an interface.

To configure the minimum threshold under the Utilization method, use the cable load-balancemethod-utilization min-threshold command in global configuration mode. For more information, refer tocable load-balance method-utilization min-threshold command reference.

Single Channel Load Balancing

Error Handling of Channel AssignmentAs long as the interface state of the channels is not "administratively down", all channels are available forLBG assignment. For other load balancing operations, such as moving modems using DCC, or UCC, theinterface state of the channels should be in "initial", "up", "suspicious", or "testing" states.

Downstream Load Balancing Distribution with Upstream Load BalancingDownstream load balancing provides equalized load balancingwith upstream groupmembers. This enhancementsynchronizes the “pending” statistic between different cable interface line cards in the load balancing group.The result is an alternative downstream load balancing scheme that makes use of per-upstream loads ratherthan total downstream loads.

This enhancement performs downstream load balancing that accounts for upstream channel loads in the sameupstream load balancing group, rather than on the basis of the entire downstream channel load. Prior Cisco


DOCSIS Load Balancing MovementsLoad Balancing Parameters

IOS releases may not have distributed cable modems evenly over individual upstream channels, nor in a waythat accounted for downstream and upstream together.

The load balancing enhancement applies when downstream load balancing occurs on a headend system withseparate upstream load balancing segments; the upstream segments are spread over multiple downstreamsegments.

The configuration and operation of making downstream load balancing decisions is enabled as follows:

• The target downstream segment is in the same downstream load balancing group as the source downstreamsegment.

• The upstream load balancing group can be set for the corresponding channel on which a cable modemis balanced.

• The Cisco CMTS automatically locates the upstream segment for a load balancing group and processesthe upstream group status on the source interface that has the lowest load.

• The target downstream segment must have an upstream channel set in the upstream load balancing group.

• The highest target upstream segment must carry less load than any other potential target—the highestupstream segment on other interfaces.

For example, several upstream segments can be configured across multiple downstream segments as follows:

U0 U1 U2 U3 Downstream3/0 LB10 LB11 LB12 LB13 LB14/0 LB10 LB11 LB12 LB13 LB15/0 LB10 LB11 LB12 LB13 LB16/0 LB10 LB11 LB12 LB13 LB1

In this example, a cable modem that comes online on the interface cable 5/0 Upstream 2 could potentiallycome online on the following interfaces:

• cable 3/0 upstream 2



The enhancement enables the following advantages and behaviors:

• This enhancement adds support for synchronizing the “pending” statistic between different cable interfaceline cards and the network processing engine (NPE) so that a better decision can be made about wherecable modems should be moved. This function can be used as a normal downstream load balancingimplementation, if desired.

• This enhancement adds the us-groups-across-ds keyword to cable load-balance group command forconfiguring downstream load balancing groups with upstream resources.

You can use the no cable load-balance docsis20-enable command to disable DOCSIS 2.0 dynamicdownstream and upstream load balance.

Note


DOCSIS Load Balancing MovementsDownstream Load Balancing Distribution with Upstream Load Balancing

Upstream Load Balancing for DOCSIS 3.0 Cable Modems in Single Upstream ModeThe upstream load balancing functionality enables the Cisco CMTS router to effectively handle upstreamtraffic for wideband and narrowband cable modems that are in single upstream mode. Single upstream mode(Mx1) means that the modems cannot send upstream traffic on multiple upstream channels. In the event oftraffic overload on a single upstream channel of a wideband or narrowband cable modem, the Cisco CMTSrouter automatically moves the cable modem to another upstream channel in the same load balancing group.

A cable modem operating in single upstreammode is assigned to a load balancing group based on the primarychannel of the modem. A cable modem in single upstreammode can support multiple receive channel (MRC)mode or narrowbandmode. However, a cable modem in single upstreammode cannot support multiple transmitchannel mode (MTC).

Note

Interaction with Spectrum ManagementCisco cable interface line cards support a number of features to maximize channel bandwidth and to minimizethe impact of ingress noise on cable modem traffic. These features have the following impacts upon loadbalancing operations:

• Frequency hopping—Frequency hopping does not affect the load balancing algorithm, because it doesnot change either the bandwidth of a channel nor the number of cable modems on an interface.

• Dynamic modulation changes—The dynamic modulation feature affects the load balancing algorithmbecause it typically switches an interface from a higher-bandwidthmodulation profile to a lower-bandwidthmodulation profile in response to noise conditions on the interface.

For example, if an upstream is configured for 16-QAM, sufficient noise levels could switch the upstreamto a QPSK modulation profile. Depending on the load balancing configuration, this could then result inthe movement of cable modems to other channels. Similarly, when the noise conditions improve, andthe modulation is returned to the original, higher-bandwidth profile, the cable modems could be movedagain to rebalance the upstream channels.

• Channel width changes—Cisco cable interface line cards support automatic changes to the channel widthin response to noise conditions. Because changing the channel width affects the throughput of a channel,this also affects the load balancing algorithm.

For example, if noise makes the current channel width unusable, the Cisco cable interface line cardreduces the channel width until it finds a usable channel width. Because this reduces the availablebandwidth on the channel, the load balancing algorithmmoves cable modems to rebalance the upstreams.

In addition, the Cisco cable interface line card does not automatically restore the original channel widthwhen noise conditions improve. Instead, the card changes the channel width only when it performs asubsequent frequency hop, either in response to additional noise conditions or when an operator performsa manual frequency hop. When the hop occurs, the card then searches for the largest possible channelwidth, and this could result in another movement of cable modems to rebalance the channels.

Using Dynamic Channel ChangeDCC in DOCSIS 1.1 dynamically changes cable modem upstream or downstream channels without forcinga cable modem to go offline, and without re-registration after the change. DCC supports five differentinitialization methods (0-4).


DOCSIS Load Balancing MovementsUpstream Load Balancing for DOCSIS 3.0 Cable Modems in Single Upstream Mode

• Load balancing techniques allow for moving cable modemswith DCC by using configurable initializationtechniques.

• DCC allows line card channel changes across separate downstream channels in the same cable interfaceline card, with the DCC initialization techniques ranging from 0 to 4.

• DCC transfers cable modem state information from the originating downstream channel to the targetdownstream channel, and maintains synchronization of the cable modem information between the cableinterface line card and the Network Processing Engine (NPE) or Route Processor (RP).

• Applications that are sensitive to delay , such as PacketCable (PC) and PacketCableMultiMedia (PCMM),may use DCC initialization technique4 to retain services while the cable modem is performing DCC.

• If the channel is in mixed or ATDMA-only mode, the primary Service Identifier (SID) must be switchedto ATDMA-only mode.

You can use the no cable load-balance docsis20-enable command to disable DOCSIS 2.0 dynamicdownstream and upstream load balance.

Note

Multiple Channel Load Balancing

Algorithm for Bonded Channel Cable Modem Load BalancingDuring registration of the cable modem, the modem count-based method uses the number of active cablemodems on the allowed RCS to determine the current load on each channel. After the modem is assigned anRCS, the Cisco CMTS does not move the cable modem even when traffic conditions change.

When a cable modem sends a registration request, modem count-based method of load balancing ranks theallowed receive channel sets (RCS) based on their modem count and assigns the set with the lowest numberof CMs, to the ranging cable modem.

DOCSIS 3.0 Static Modem Count-Based Load BalancingThe static modem count-based load balancing supports the following:

• DOCSIS General and Restricted load balancing group assignment to include DOCSIS 3.0 cable modemsin MTC and MRC-only modes.

DOCSIS 3.0 static modem count-based load balancing is not supported:

• Across multiple line cards.

• For load balancing groups and downstream channels shared across multipleline cards. However, autonomous load balancing-based CM steering andload balancing group assignment is supported across multiple line cards

Note

• Use of DCC and DBC in load balancing.

• Use of DBC for MRC-only modems during downstream move.

• Use of DCC with init tech 0 if the primary downstream channel is changed for MRC-only CMs.


DOCSIS Load Balancing MovementsMultiple Channel Load Balancing

• Use of DBC for cable modems in MTC mode for all upstream and downstream modem move.

• Separate counters for NB and wideband (WB)/upstream bonding (UB) CMs. For more information, seethe show cable load-balance docsis-group command in the Cisco IOSCMTSCable CommandReference.

• Aggregate logical channels to physical channels for load balancing. Physical channel load is calculatedby using average weights among all logical channels.

• Non-primary downstream channels load where utilization of SPA QAM is considered

When the CM counts across different WB interfaces are within predefined threshold levels, the load is alwaysconsidered as balanced; no more CM move is initiated by the LB system. No service flow count, whetherprimary or secondary, is taken into consideration during this LB process.

Note

The attributes considered for the forward interface for the service flow (SF) are attribute mask and availablebandwidth, and not the number of service flows on each channel. If a channel is within the new RCS, thenirrespective of the type of narrowband SF, (whether primary or secondary, or static or dynamic) the SFcontinues to use its current channel.

Note

The US Phy Mode counters (scdma, atdma, and tdma) remain 0 for the UB interfaces.Note

DOCSIS 3.0 static modem count-based load balancing is based on legacy load balancing and supports anytype of channel combination (upstream and downstream)—MxN, with 1x1 combination being the subset.

DOCSIS 3.0 static modem count-based load balancing controls dynamic changes to the set of downstreamand upstream channels used by a registered CM. It supports the following:

• Multiple channel load balancing operation.

• Load balancing operation based on policies and priorities.

• Load balancing with multicast. DOCSIS 3.0 static modem count-based load balancing does not moveany CM with active video sessions.

DOCSIS 3.0 static modem count-based load balancing supports the modem count-based load balancing in ahybrid deployment of DOCSIS 1.x, 2.0 and 3.0 cable modems.

Static modem count-based load balancing is supported only for DOCSIS 3.0 CMs. Single-channel, narrowbandcable modems will continue to be supported with dynamic load balancing. MRC-only cable modems aresupported by dynamic load balancing on upstream channels.

With DOCSIS 3.0 static modem count-based load balancing, when load balancing related configuration withinthe LBG is changed as follows, the cable modems are forced to re-register:

• Partial shut or no shut interfaces under the LBG domain

• MRC or MTC mode in cable modems is turned on or turned off

• Change in fiber node for GLBG


DOCSIS Load Balancing MovementsDOCSIS 3.0 Static Modem Count-Based Load Balancing

http://www.cisco.com/en/US/docs/ios/cable/command/reference/cbl_book.html

• Change in wideband configuration for downstream group

• Change in the upstream bonding group

Use the following commands to force cable modems to re-register:

• clear cable modem delete

• clear cable load state

• clear cable load counters

Primary Channel Load Display for Target RCS

This feature enables the bondedmodems to be moved at the time of registration such that the primary channelsare distributed evenly among the primary-capable channels apart from the load being balanced on the targetDS channels. Modem method ranks the RCS based on their primary loads and assigns the set with the lowestprimary load to the ranging cable modem.

An optional keyword primary-load has been added to the show cable load-balance docsis-group commandto display the primary load of an RCS. For more information, see the Cisco CMTS Command Reference.

Although the modem count-based method distributes the cable modems fairly as they register, the followingconditions may cause a system imbalance:

• A channel or groups of channels fail because of a planned (administrative shutdown) or unplanned event.

• While some cable modems may continue to operate in partial mode, some may re-register because ofthe failure and are reassigned to the channels that are active.

• When the failed channels become operational again, the cable modems do not re-register and the systemis unbalanced.

In this case, the modem count-based method sends an SNMP trap to alert the operator, and the operator canchoose to manually intervene to re-balance the cable modems by resetting the MAC domain to force all cablemodems to re-register.

For cable modems in MRC and MTC modes, the modem count based load balancing method considers thenumber of active modems and service flows on the primary channels in the RCS and TCS of the cable modem.

Note

Use no cable load-balance docsis30-enable static command to disable this feature.Note

Dynamic Load Balancing for DOCSIS 3.0 Cable ModemsThe existing Load Balancing (LB) feature is enhanced to cope with the increase in the number of downstreamand upstream channels by Multi-Service Operators (MSO) and wider deployment of 16-channel, 24-channeland multiple downstream channel Cable Modems (CMs). This enhancement allows the customer to betterutilize their available bandwidth. The enhancements made to the existing LB feature include:

• Utilization based Dynamic downstream LB for DOCSIS 3.0• Support for DOCSIS 3.0 LB statistics


DOCSIS Load Balancing MovementsPrimary Channel Load Display for Target RCS

http://www.cisco.com/c/en/us/td/docs/cable/cmts/cmd_ref/b_cmts_cable_cmd_ref.html

• Enable or Disable DOCSIS 3.0 LB feature• Distribute the CM on all the primary channels for the target interface when performing DOCSIS 3.0 LBdynamic movement. This feature is only used on DOCSIS 3.0 LB dynamic movement. It is disabled bydefault. Use method utilization primary-distributed command in the DOCSIS load balancing groupmode to enable this feature. To disable this feature, use no form of this command or method utilizationus-method command.

Use cable load-balance docsis-enable command to enable this feature. In addition, use cable load-balancedocsis30-enable and cable load-balance docsis30-enable dynamic downstream command to enable dynamicand utilization based dynamic downstream LB for DOCSIS 3.0 Cable Modems.

Note

Multiple Channel Load Balancing OperationCMs load balance in MRC and MTC modes. The following rules apply while load balancing CMs operatingin these modes:

• For CMs operating inMRC andMTCmodes, DBC is used tomove CMs across downstreams by changingthe RCS of the CM within same MAC domain.

CMs operating inMRC-onlymode can bemoved across upstreams only through a DCC request. However,the Cisco CMTS uses DCCwith initialization technique 0 (reinitializing theMAC domain) when changingthe downstream channel of a CM operating in MRC mode.

• During CM registration, the Cisco CMTS may send a multipart registration response (REG-RSP-MP)message to include a TCC TLV encoding to the CM. This CM is marked as TCC-capable.

For CMs operating in MRC, non-MTC, non-TCC-capable mode, load balancing uses:

• DBC to change RCS of the CM

• DCC to change upstream channel of the CM

• For CMs operating in narrowband mode, DCC is used to move CMs within and across MAC domains.

The tables below provide a snapshot view of the load balancing methods and the operations used to movebonded and non-bonded CMs:

Table 14: Load Balancing Method to Move Bonded and Non-bonded CMs

Dynamic Service Charge(Initialization Technique)

ChannelsLoadBalancingCounters

Load BalancingMethod

Modem Mode

AcrossMACDomains

Within MACDomain


DOCSIS Load Balancing MovementsMultiple Channel Load Balancing Operation




Modem Mode

DCC inittech 0

DBC

WhenDOCSIS3.0 LBisenabled,and theMTCCM isoutsideRLBG,CM ismovedinsideRLBG.

Note

DSWB/UBDOCSIS 3.0 staticmodemcount-based loadbalancing(MCBLB)

DOCSIS 3.0dynamic loadbalancing

DOCSIS 3.0 CMin MTC mode

DCC inittech 0

DBC

WhenDOCSIS3.0 LBisenabled,and theMTCCM isoutsideRLBG,CM ismovedinsideRLBG.

Note

USWB/UBDOCSIS 3.0 staticmodemcount-based loadbalancing(MCBLB)






Modem Mode

DCC inittech 0

DBC

WhenDOCSIS3.0 LBisenabledand CMwith allDSs isoutsideRLBG,CM ismovedinsideRLBG.

Note

No change to theprimary DS channel

WB/UBDOCSIS 3.0 staticMCBLB

DOCSIS 3.0dynamic loadbalancing

DOCSIS 3.0/D2.xCMs inMRC-only mode

DCC inittech 0

DCC init tech 0

CMwithprimaryDSoutsideRLBGmovesinsideRLBGwithDOCSIS2.0 LB.

Note

Change to the primaryDS channel

DCC inittech 0

DCC

CMoutsideRLBGmovesinsideRLBGwithDOCSIS2.0 LB.

Note

USNBDOCSIS 2.0 staticand dynamicMCBLB,dynamicutilization

DOCSIS 3.0CMsin MRC-onlymode






Modem Mode

DCC inittech 0

DCC/UCC


Note

USNBDOCSIS 2.0 staticand dynamicMCBLB,dynamicutilization

D2.x CMs inMRC-only mode

DCC inittech 0

DCC


Note

DSNBDOCSIS 2.0dynamicMCBLB,dynamicutilization

DOCSIS 2.0/DOCSIS 1.1CMs in NB mode

UCCUCC


Note

US






Modem Mode

ForcereinitializeCM

Force reinitializeCM


Note

DSNBDOCSIS 2.0dynamicMCBLB,dynamicutilization

DOCSIS 1.0 inNB mode

UCCUCC


Note

US

Table 15: Using DCC/DBC to Load Balance Bonded and Non-bonded Cable Modems

DOCSIS 1.0 CMs withSingle US/DS

DOCSIS 1.1/2.0 CMs withSingle US/DS

CM in MRC, non-MTC ModeCM in MRC, MTC ModeChannel

UCCDCCDCCDBCUpstream(US)

Force reinitialize CMDCC (within the same MACdomain)

DBC (within the same MACdomain)

DBC (within the same MACdomain)

Downstream(DS)

Force reinitialize CMDCC with initializationtechnique 0whenmoving CMsacross MAC domains

DCC with initializationtechnique 0 when movingCMs across MAC domains

DCC with initializationtechnique 0 when movingCMs across MAC domains

Using DBC for DOCSIS 3.0 Load Balancing MovementAs part of the DOCSIS 3.0 specifications, at any time after registration, the Cisco CMTS uses the DBCcommand to change any of the following parameters in a DOCSIS 3.0 CM:

• Receive channel set

• Transmit channel set


DOCSIS Load Balancing MovementsUsing DBC for DOCSIS 3.0 Load Balancing Movement

• DSID(s) or DSID associated attributes

• Security association(s) for encrypting downstream traffic

• Service Flow Cluster Assignments

Only RCS and TCS are used by the DOCSIS 3.0 load balancing.Note

Use the show cable load-balance docsis-group command to display the current, real-time statistics for loadbalancing operations. For more information, see the Cisco IOS CMTS Cable Command Reference.

Using DBC to Change the Receive Channel Set

The Cisco CMTS can add, delete, or change the channels in the RCS of a cable modem by including a RCCin the DBC-REQ.

If an RCS change affects the primary downstream channel of the cable modem, the cable modem is requiredto re-register on its upstream channels.

If channels are deleted from the RCS, the Cisco CMTS may stop sending traffic on the downstream channelto be removed, which may cause loss of traffic. The Cisco CMTSminimizes packet loss by duplicating trafficon the new and old RCS until it receives a DBC-RSP from the cable modem.

For cable modems inMRC-only mode, a downstream channel move is initiated by a DBCmessage. However,DCC initialization technique 0 is used if there is a change in the primary downstream channel.

Note

Using DBC to Change the Transmit Channel Set

The Cisco CMTS can add, delete, or replace one or multiple channels in the TCS in a single DBC message.Whenever the TCS of the cable modem changes, the CMTS appropriately modifies the service identifiers(SIDs) associated with the affected service flows.

A change in the TCS is accompanied by a valid initialization technique.

Using DBC to Change the Downstream ID

Using DBC, the Cisco CMTS can change the following attributes of a downstream ID (DSID):

• Re-sequencing encodings:

• Downstream re-sequencing channel list—The CMTS can add, delete, and replace channels in theDS re-sequencing channel list.

• DSID re-sequencing wait time—The CMTS can indicate a change in skew due to network orconfiguration changes through DSID re-sequencing wait time.

• re-sequencing Warning Threshold

• CM-STATUS Hold-Off Timer for Out-of-range Events

• Multicast Encoding—The CMTS can initiate a DBC transaction to either add, deleted, or change attributesof an existing multicast DSID:


DOCSIS Load Balancing MovementsUsing DBC to Change the Receive Channel Set


• Client MAC Address

• Multicast cable modem interface Mask

• Group MAC Address

Using DBC to Change the Security Association for Encrypting Downstream Traffic

• The CMTS can initiate a DBC transaction to add or delete Security Associations (SA) used to encryptdownstream traffic.

• The CMTS cannot send a DBC request to a cable modem that is not in the "Authorized" State.

• The CMTS can send a DBC request with an SA that uses a cryptographic suite unsupported by the cablemodem. However, if the cable modem receives a DBC request with an SA that it is not capable of using,the cable modem rejects the DBC request.

Using DBC to Change the Service Flow SID Cluster Assignments

The Cisco CMTS uses the Service Flow SID Cluster Assignments TLV in the DBC request to assign newchannels to a service flow, remove channels from a service flow, or replace one channel with another for aservice flow.

Multiple actions can occur within a single DBC message.Note

Benefits of Load BalancingThe Load Balancing feature on the Cisco CMTS provides the following benefits to cable service providersand their partners and customers:

• Provides a method that service providers can use for efficient bandwidth utilization, especially whenusing multiple upstream channels per fiber node.

• Allows service providers to expand their networks in an efficient manner, avoiding the cost of having toinstall additional fiber optic equipment and further segmenting the physical plant.

• Load balancing on downstream channels enables efficient bandwidth usage when using multipledownstream channels per fiber node to enable Video over IP and other services that require high-bandwidthreal-time streams.

• Load balancing of upstream and downstream channels does not require any change to the provisioningservers or to any DOCSIS configuration files.

• Load balancing of upstream and downstream channels does not require any administrator or userintervention (such as manually resetting cable interfaces or manually rebooting cable modems).

• Allows service providers to equally balance their downstreams as cable modems register, so that cablemodems do not all attempt to register on the same downstream, resulting in many cable modems failingto register and having to search for a new downstream.

• Cable modems can be moved among downstream and upstream channels without having to change anynetwork parameters in manual fashion, such as IP address.


DOCSIS Load Balancing MovementsUsing DBC to Change the Security Association for Encrypting Downstream Traffic

• Allows service providers to stay ahead of customers’ bandwidth demands by dynamically responding tocurrent load-usage conditions.

• Allows service providers to optimize the load balancing parameters for critical services, such as Voiceover IP (VoIP).

Exclude Cable Modems from Load Balancing GroupsLoad Balancing Process

The load balancing process has two phases.

• Assignment phase.

When a modem is coming online in the assignment phase, the modem is moved to the load balance groupby assigning it a load balancing group (LBG) ID. The assignment phase occurs only when a modem iscoming online.

• Balancing phase.

In the balancing phase, a modem is re-assigned to an LBG to balance the load.

Excluding Cable Modems from Load Balancing

There are four options that are used to exclude cable modems from an LBG:

• The assignment option:

The assignment option is used to exclude a modem during the assignment phase. The modem is notassigned an LBG and LBG ID is not displayed in the output of the show cable modem verbose command.The assignment option cannot be used when a modem is already online.

• The static option:

The static option is used to exclude a modem during the Balancing phase. The modem is assigned to anLBG with an LBG ID. The static option is used to exclude a modem during static load balancing.

• The enforce option:

The enforce option is similar to the static option, except that the enforce option is used to exclude amodem during dynamic load balancing.

When a cable modem is excluded from load balancing using the assignment option, the cable modem is notavailable for load balancing using the static or the enforce options.

• The strict option:

The strict option excludes a modem in both the phases of load balancing. When a modem is onlinealready, the strict option applies the static and the enforce options. It applies the assignment optiononly when the modem comes online again.

How to Configure Load BalancingTo configure load balancing groups, and to enable load balancing, refer to the configurations in the DOCSISLoad Balancing Groups document. Each task is marked as required or optional, as appropriate.


DOCSIS Load Balancing MovementsExclude Cable Modems from Load Balancing Groups

Enabling Single Channel Load BalancingTo configure Single Channel Load Balancing, see the DOCSIS Load Balancing Groups guide.

Configuring Dynamic Bonding Change for DOCSIS 3.0 Static Load BalancingUse the cable load-balance docsis30-enabled command in the global configuration mode, to enable DOCSIS3.0 Static Load Balancing.

DOCSIS 3.0 Static Load Balancing always uses Modem Count Method for load balancing.Note

Before you begin

Configure Load Balancing Groups. For more details, see the DOCSIS Load Balancing Groups guide.

Excluding Cable Modems from a Load Balancing GroupThis configuration is optional. This section describes how to exclude a particular cable modem, or all cablemodems from a particular vendor, from participating in static or dynamic load balancing operations, andoptionally marking the modems for passive load balancing. This task is optional, because, by default, cablemodems on an interface participate in whatever load balancing operations have been configured.

This step might be required for some cable modems that are not DOCSIS-compliant. Such cable modems cango offline for long periods of time when load balancing is attempted using DOCSIS MAC messages. If thisis the case, use the cable load-balance exclude command to exclude such cable modems from load balancingoperations until the modem can be upgraded to DOCSIS-compliant software.

Note

You must exclude cable modems that require specific upstream channels or downstream frequencies. Loadbalancing cannot be done when cable modems are assigned specific channels or frequencies in their DOCSISconfiguration files.

Tip

Support for Excluding Old Devices

Load balancing for old cable devices like Set Top Boxes (STBs) which do not support load balancing, willfail. In the output for show cable load-balance group command, these devices will show as 'suspicious' andthen as 'disabled'. This will disrupt normal operations of other modems in the load balancing group. To excludethese STBs, a cable load-balance exclude command is configured to exclude each STB.


DOCSIS Load Balancing MovementsEnabling Single Channel Load Balancing

You can configure the cable load-balance exclude command once to exclude all the STBs, that do not supportload balancing, instead of configuring the command several times with matched MAC addresses. You canalso move cable modems that were moved to a load balancing group in assignment phase.

The cable load-balance exclude modem command is modified to include the mask argument as an optionalargument. The MAC address of a cable modem that belongs to the range specified by the MAC address mask,will be excluded bymatching the “1” bit in mask.While configuring a new range rule using themask argument,an existent rule with the same range is overwritten.

The cable load-balance excludemodem command is modified to include the assignment option. This optionallows you to exclude a cable modem that was moved into a load balancing group in assignment phase.

Note

Procedure


Enables privileged EXEC mode. Enter your password ifprompted.

enable

Example:

Step 1

Router> enable


Example:

Step 2


Specifies that one or more cable modems should beexcluded from load balancing operations.

cable load-balance exclude {modem mac-address[mac-mask] | oui oui-value} [assignment | enforce | static| strict]

Step 3

By default, the cable modems are excluded from dynamicand static load balancing, but they continue to participateExample:in passive load balancing. Use the following options toRouter(config)# cable load-balance exclude oui

00:00:0c exclude the cable modems from others combinations ofload balancing:

Exits global configuration mode.exit

Example:

Step 4

Router(config)# exit

Distributing Downstream Load Balancing with Upstream Load BalancingTwo commands are used to configure or display the configuration and status of distributed load balancing onthe Cisco CMTS:

• cable load-balance group ds-lb-group-id policy {pcmm | ugs | us-groups-across-ds}

• show cable load all

The optional configuration of making downstream load balancing decisions is enabled as follows:


DOCSIS Load Balancing MovementsDistributing Downstream Load Balancing with Upstream Load Balancing

• The target downstream segment is in the same downstream load balancing group as the source downstreamsegment. This feature finds the target frequency and interface based on the upstream loads within thesame upstream group as the source.

• The upstream load balancing group can be set for the corresponding channel on which a cable modemis balanced on the downstream channels.

• The Cisco CMTS automatically locates the upstream segment for a load balancing group and processesthe upstream group status on the source interface that has the lowest load.

• The target downstream segment must have an upstream channel set in the upstream load balancing group.

• The highest target upstream segment must carry less load than any other potential target—the highestupstream segment on other interfaces.

Procedure



enable

Example:

Step 1

Router> enable


Example:

Step 2


Sets the type of service flow policy for use with LoadBalancing. This command synchronizes the pending statistic

cable load-balance group ds-lb-group-id policy {pcmm| ugs | us-groups-across-ds}

Step 3

between different cable interface line cards in the loadExample: balancing group. The result is an alternative downstreamRouter(config)# cable load-balance group 1 policyus-groups-across-ds

load balancing scheme that makes use of per-upstream loadsrather than total downstream loads when making loadbalancing decisions.


Example:

Step 4


Displays load balancing statistics and status of loadbalancing configurations on the Cisco CMTS, to include

show cable load all

Example:

Step 5

distributed upstream-to-downstream load balancing whenconfigured.Router# show cable load all

How to Configure Dynamic Channel Change for Load BalancingDCC in DOCSIS 1.1 dynamically changes cable modem upstream or downstream channels without forcinga cable modem to go offline, and without reregistration after the change. DCC supports five differentinitialization methods (0-4), instead of one, as in earlier DOCSIS support.


DOCSIS Load Balancing MovementsHow to Configure Dynamic Channel Change for Load Balancing

Dynamic Channel Change (DCC) and DCC for Load Balancing on the Cisco CMTS supports the following:

• Load balancing techniques allow for moving cable modemswith DCC by using configurable initializationtechniques.

• DCC allows line card channel changes across separate downstream channels in the same cable interfaceline card, with the DCC initialization techniques ranging from 0 to 4.

• DCC transfers cable modem state information from the originating downstream channel to the targetdownstream channel, and maintains synchronization of the cable modem information between the cableinterface line card and the Network Processing Engine (NPE) or Route Processor (RP).

• Applications that are sensitive to delay, such as PacketCable (PC) and PacketCableMultiMedia (PCMM),may use DCC initialization technique 4 to retain services while the cable modem is performing DCC.

• If the channel is in mixed or ATDMA-only mode, the primary Service Identifier (SID) must be switchedto ATDMA-only mode.

Configuring Dynamic Channel Change for Load BalancingTo configure the DCC feature for load balancing, use the following steps. Values indicated are sample valuesthat may differ from your own.

SUMMARY STEPS

1. enable2. configure terminal3. cable load-balance docsis-enable4. cable load-balance docsis-group docsis-group-id

5. init-tech-list tech-list [ucc]6. policy {pcmm | ugs | us-across-ds | pure-ds-load}7. threshold {load {minimum <1-100> | <1-100>}| pcmm <1-100> | stability <0-100> | ugs <1-100>}8. end

DETAILED STEPS





Example:

Step 2



Example:

Step 3



DOCSIS Load Balancing MovementsConfiguring Dynamic Channel Change for Load Balancing


Creates a DOCSIS load balance group on the Cisco CMTS,with the following parameter:


Example:

Step 4

The router enters DOCSIS load balancing groupconfiguration mode.Router(config)# cable load-balance docsis-group 1

Sets the DCC initialization techniques that the Cisco CMTScan use to load balance cable modems.


Example:

Step 5


Selects the modems based on the type of service flow thatare balanced.

policy {pcmm | ugs | us-across-ds | pure-ds-load}

Example:

Step 6

Router(config-lb-group)# policy us-across-dsRouter(config-lb-group)# policy ugsRouter(config-lb-group)# policy pure-ds-load

Selects the percentage of use beyond which load balancingoccurs.

threshold {load {minimum <1-100> | <1-100>}| pcmm<1-100> | stability <0-100> | ugs <1-100>}

Example:

Step 7

Router(config-lb-group)# threshold load minimum 10Router(config-lb-group)# threshold pcmm 70Router(config-lb-group)# threshold load 10Router(config-lb-group)# threshold stability 50Router(config-lb-group)# threshold ugs 70


Example:

Step 8

Router# end

What to do next

To test and verify DCC for load balancing, use the following two commands:

• test cable dcc

• show controllers cable

These commands are described in the Cisco CMTS Cable Command Reference .

Verifying Load Balancing OperationsThis section describes how to use certain test and show commands to verify the configuration and operationof the Load Balancing feature or Dynamic Channel Change feature on the Cisco CMTS.


DOCSIS Load Balancing MovementsVerifying Load Balancing Operations

Procedure



enable

Example:

Step 1

Router> enable

Displays real-time statistical and operational informationfor load balancing operations. If given without any options,

show cable load-balance [group n] [all | load | pending |statistics | target]

Step 2

this command displays information for the load balancingExample: groups and each cable interface’s current load and load

balancing status. You can also specify the following options:Router# show cable load-balance group 1

Tests Dynamic Channel Change (DCC) by moving a targetcable modem, as specified by MAC address, IP address, or

test cable dcc [mac-addr | ip-addr | cable-if-src sid ]cable-if-target uschan {ranging-tech }

Step 3

the primary service ID (SID) value. Applies to a cableExample: modem on the source interface to an upstream channel onRouter# test cable dcc 0000.394e.4e59 a target downstream interface using the initialization

technique specified.

ExampleThis example shows the result of load balancing operations.

Router#show cable load allDOCSIS 2.0 LB Enabled: Yes DOCSIS 3.0 LB Enabled: NoDOCSIS Status Interval DCC mask Policy Method ThresholdGroup /UCC DS/US M/E/U/P/S1 RE 30 0xF8(0)/N 0 m/m 5/10/70/70/5012345 GE 30 0xF8(0)/N 0 m/m 5/10/70/70/5012346 RE 30 0xF8(0)/N 0 m/m 5/10/70/70/5012347 RE 30 0xF8(0)/N 0 m/m 5/10/70/70/5012348 RE 30 0xF8(0)/N 0 m/m 5/10/70/70/5012349 RE 30 0xF8(0)/N 0 m/m 5/10/70/70/50

DOCSIS 3.0 General LBMD FN Group ID S Intv DCC mask Policy Mtd MD-CM-SG Threshold

/UCC D/U M/E/U/P/SCa8/0/0 1 2147631104 E 30 0x30(2)/N 0 m/m 0x1200301 5/10/70/70/50Ca8/0/1 3 2147631618 E 30 0x30(2)/N 0 m/m 0x1210301 5/10/70/70/50Ca8/0/2 5 2147632132 E 30 0x30(2)/N 0 m/m 0x1220401 5/10/70/70/50Ca8/0/2 6 2147632133 E 30 0x30(2)/N 0 m/m 0x1220402 5/10/70/70/50Ca8/0/3 7 2147632646 E 30 0x30(2)/N 0 m/m 0x1230501 5/10/70/70/50Ca8/0/3 8 2147632647 E 30 0x30(2)/N 0 m/m 0x1230502 5/10/70/70/50Ca8/0/8 2 2147635201 E 30 0x30(2)/N 0 m/m 0x1280201 5/10/70/70/50Ca8/0/9 4 2147635715 E 30 0x30(2)/N 0 m/m 0x1290201 5/10/70/70/50

Current load:

DOCSIS load-balancing loadInterface State Group Utilization Rsvd NBCM WB/UB Weight

Total TotalIn8/0/0:0(411 MHz) initial 1 0%(0%/0%) 0% 0 11 37In8/0/0:0(411 MHz) initial 2147631104 0%(0%/0%) 0% 0 11 37Us8/0/0:0 initial 1 0% 0% 0 31 30.7Us8/0/0:0 initial 2147631104 0% 0% 0 31 30.7Us8/0/0:1 initial 1 0% 0% 0 31 30.7


DOCSIS Load Balancing MovementsExample

Us8/0/0:1 initial 2147631104 0% 0% 0 31 30.7Us8/0/0:2 initial 2147631104 0% 0% 0 31 30.7Us8/0/0:2 initial 1 0% 0% 0 31 30.7Us8/0/0:3 initial 2147631104 0% 0% 0 31 30.7Us8/0/0:3 initial 1 0% 0% 0 31 30.7In8/0/0:4(435 MHz) up 2147635201 0%(0%/0%) 0% 48 11 37Us8/0/1:0 up 2147635201 0% 0% 15 0 30.7Us8/0/1:1 up 2147635201 0% 0% 11 0 30.7Us8/0/1:2 up 2147635201 0% 0% 11 0 30.7Us8/0/1:3 up 2147635201 0% 0% 11 0 30.7In8/0/0:8(459 MHz) initial 1 0%(0%/0%) 0% 0 9 37In8/0/0:8(459 MHz) initial 2147631104 0%(0%/0%) 0% 0 9 37Us8/0/0:0 initial 1 0% 0% 0 31 30.7Us8/0/0:0 initial 2147631104 0% 0% 0 31 30.7Us8/0/0:1 initial 1 0% 0% 0 31 30.7Us8/0/0:1 initial 2147631104 0% 0% 0 31 30.7Us8/0/0:2 initial 2147631104 0% 0% 0 31 30.7Us8/0/0:2 initial 1 0% 0% 0 31 30.7Us8/0/0:3 initial 2147631104 0% 0% 0 31 30.7Us8/0/0:3 initial 1 0% 0% 0 31 30.7In8/0/0:12(483 MHz) down 2147635201 0%(0%/0%) 0% 0 0In8/0/0:16(507 MHz) initial 2147631104 0%(0%/0%) 0% 0 11 37In8/0/0:16(507 MHz) initial 1 0%(0%/0%) 0% 0 11 37Us8/0/0:0 initial 2147631104 0% 0% 0 31 30.7Us8/0/0:0 initial 1 0% 0% 0 31 30.7Us8/0/0:1 initial 2147631104 0% 0% 0 31 30.7Us8/0/0:1 initial 1 0% 0% 0 31 30.7Us8/0/0:2 initial 2147631104 0% 0% 0 31 30.7Us8/0/0:2 initial 1 0% 0% 0 31 30.7Us8/0/0:3 initial 2147631104 0% 0% 0 31 30.7Us8/0/0:3 initial 1 0% 0% 0 31 30.7In8/0/0:20(531 MHz) down 2147635201 0%(0%/0%) 0% 0 0In8/0/1:0(555 MHz) initial 2147631618 0%(0%/0%) 0% 0 12 37Us8/0/2:0 initial 2147631618 0% 0% 0 19 30.7Us8/0/2:1 initial 2147631618 0% 0% 0 19 30.7Us8/0/2:2 initial 2147631618 0% 0% 0 19 30.7

Troubleshooting TipsProblem Packets are dropped when a cable modem moves from one channel to another.

Possible Cause When the test cable dcc command is used to move a cable modem from one channel toanother with DCC initialization technique 3:

• If the pre-equalization coefficient is enabled, the cable modem moves and packet drop occurs for 5seconds.

• If the pre-equalization coefficient is disabled, the cable modem moves and packet drop occurs for lessthan 1 second.

Possible Cause When the test cable dcc command is used to move a cable modem from one channel toanother with DCC initialization technique 4:

• If the pre-equalization coefficient is enabled, the cable modem moves and packet drop occurs for lessthan 1 second.

• If the pre-equalization coefficient is disabled, the cable modem moves without any packet drop.

Solution No action is required.


DOCSIS Load Balancing MovementsTroubleshooting Tips

Examples

Use the show cable load-balance target command to display the interfaces being used for load balancing,use the test cable load-balance command to test whether a cable modem can move between interfaces, anduse the show cable load-balance statistics command to display the results of the test.

The following example shows how to test whether a specific cable modem responds to both a UCC requestand to an upstream channel override to move from one upstream to another in its load balancing group:Router# show cable load-balance target

Target assignments:Interface State Group TargetCable1/0/0 (669 MHz) up 1Cable1/0/0/U0 up 1 Cable1/0/0/U1 [enforce]Cable1/0/0/U1 up 1

Router# show cable load-balance statistics

Statistics:

Target interface State TransfersComplete Pending Retries Failures

Cable1/0/0 (669 MHz) up 15 0 1 0Cable1/0/0/U0 up 33 0 1 0Cable1/0/0/U1 up 22 0 2 0

Router# test cable load-balance 0000.394e.4e59

Sending UCC request: Cable1/0/0/U0 --> U1Waiting for test completion ........Test results:

UCC Response: 0.0sInitial Ranging: 8.5sRanging Complete: failed.Modem replied to DOCSIS ping.

Test summary:UCC Response: success rate 100% min 0.0s max 0.0s avg 0.0sInitial Ranging: success rate 100% min 8.5s max 8.5s avg 8.5s

Testing US Channel Override: Cable1/0/0/U1 --> U0Waiting for test completion ...........Test results:

Initial Ranging: 8.5sRanging Complete: failed.Modem replied to DOCSIS ping.

Test summary:UCC Response: success rate 100% min 0.0s max 0.0s avg 0.0sInitial Ranging: success rate 100% min 8.5s max 8.5s avg 8.5s


Statistics:



The following example shows how to test whether a specific modem responds to a UCC request to move fromone upstream to another in its load balancing group:


DOCSIS Load Balancing MovementsExamples


Statistics:



Router# test cable load-balance 0007.0e01.4129 ucc 1

Sending UCC request: Cable1/0/0/U0 --> U1Waiting for test completion ........Test results:

UCC Response: 0.0sInitial Ranging: 10.3sRanging Complete: 11.2sModem replied to DOCSIS ping.

Test summary:UCC Response: success rate 100% min 0.0s max 0.0s avg 0.0sInitial Ranging: success rate 100% min 10.3s max 10.3s avg 10.3sRanging Complete: success rate 100% min 11.2s max 11.2s avg 11.2s


Statistics:



The following example shows information whenmoving a cable modem to a different upstream channel usingDCC initialization technique 1. This example moves the cable modem 0012.17ea.f563 from interface c7/1/0upstream 1 to interface c7/1/1 upstream 0 using DCC initialization technique 1:Router# show cable modem

MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPIState Sid (dB) Offset CPE Enb

State Sid (dB) Offset CPE Enb0012.17ea.f563 12.0.0.2 C7/1/0/U1 online 4 0.00 2449 0 N

Router# test cable dcc 0012.17ea.f563 c7/1/1 0 1

Router# show cable modem

MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPIState Sid (dB) Offset CPE Enb

0012.17ea.f563 12.0.0.2 C7/1/1/U0 online 3 0.00 2451 0 N

Configuration Examples for Load BalancingThis section provides the following configuration examples:


DOCSIS Load Balancing MovementsConfiguration Examples for Load Balancing

Example: Configuring Dynamic Channel Change for Load BalancingThe following examples illustrate the working of dynamic load balancing working process in DOCSIS 3.0cable modems.

Verify configuration:Router# show cable load-balance docsis-group 1DOCSIS LB Enabled: YesDOCSIS 2.0 LB Enabled: NoDOCSIS 3.0 LB Enabled: YesDOCSIS 3.0 Static LB Enabled: NoDOCSIS 3.0 Dynamic Downstream LB Enabled: YesDOCSIS Status Interval DCC mask Policy Method ThresholdGroup /UCC DS/US M/E/U/P/S1 RE 60 0x38(2)/N 0 u/u 1/10/70/70/50

Verify channel current load:Router# show cable load-balance docsis-group 1 load widebandDOCSIS load-balancing wide band loadInterface Size Group Throughput(Kbps)/bw(Mbps) Avg-UtilWi9/0/0:1 8 1 93324/300 36%Wi9/0/0:2 8 1 37329/300 39%Wi9/0/0:3 8 1 74659/300 31%Wi9/0/0:4 8 1 0/300 13%Wi9/0/0:5 8 1 9332/300 2%

Verify channel overload and target:Router# show cable load-balance docsis-group 1 target widebandInterface Bg-Id State Group TargetWi9/0/0:1 28674 up 1 Wi9/0/0:5 ...Wi9/0/0:2 28675 up 1 Wi9/0/0:5 ...Wi9/0/0:3 28676 up 1 Wi9/0/0:5 ...Wi9/0/0:4 28677 up 1 Wi9/0/0:5Wi9/0/0:5 28678 up 1

Verify channel modem-list:Router# show cable load-balance docsis-group 1 modem-list widebandCodes: M - Multicast, U - UGS, P - PCMM, F - Max-Failures, X - eXcludedL - L2vpn, R - RSVPPrimary WB MAC Address Primary DS RCC-ID Priority MUPFXLR StateWi9/0/0:1 (10)c8fb.26a6.c02c In9/0/0:4 1 0 ------- LB_CM_READYc8fb.26a6.c62c In9/0/0:4 1 0 ------- LB_CM_READYc8fb.26a6.c706 In9/0/0:4 1 0 ------- LB_CM_READYc8fb.26a6.c0dc In9/0/0:4 1 0 ------- LB_CM_READYc8fb.26a6.c53a In9/0/0:4 1 0 ------- LB_CM_READY

Verify QAM channel utilization:Router# show cable load-balance docsis-group 1 rfch-utilInterface Pstate Pending-In Pending-Out Throughput(Kbps) UtilIn9/0/0:4 up No No 6517 17In9/0/0:5 NA No No 6574 17In9/0/0:6 NA No No 6520 17In9/0/0:7 NA No No 6738 17In9/0/0:8 up No No 8624 22In9/0/0:9 NA No No 8482 22In9/0/0:10 NA No No 8353 22

Verify channel statistic movement:


DOCSIS Load Balancing MovementsExample: Configuring Dynamic Channel Change for Load Balancing

Router# show cable load-balance docsis-group 1 statistics widebandTarget interface State TransfersComplete Pending Total Failures DisabledWi9/0/0:1 up 0 0 0 0 0Wi9/0/0:2 up 0 0 0 0 0Wi9/0/0:3 up 3 0 3 0 0Wi9/0/0:4 up 0 0 0 0 0Wi9/0/0:5 up 9 0 9 0 0

The following example of the running configuration illustrates DCC for load balancing.Router# show cable load all

*Nov 11 15:42:18.955: %SYS-5-CONFIG_I: Configured from console by conscable load allGroup Interval Method DCC Init Threshold

Technique Minimum Static Enforce Ugs PCMM1 10 modems 0 5 10% --- --- ---

Current load:

Interface State Group Utilization Reserved Modems Flows WeightCable3/0 (0 MHz) initial 1 0%(0%/0%) 0% 0 0 26

Target assignments:

Interface State Group TargetCable3/0 (0 MHz) initial 1

Statistics:


Cable3/0 (0 MHz) initial 0 0 0 0Pending:Modem Group Source interface Target interface Retries

The following example of the running configuration illustrates DCC for load balancing.Router# show running configuration

Building configuration...Current configuration : 11889 bytes!version 12.3no service padservice timestamps debug datetime msecservice timestamps log datetime msecno service password-encryption!hostname Router!boot-start-markerboot-end-marker!enable secret 5 $1$tEvV$8xICVVbFm10hx0hAB7DO90enable password lab!no cable qos permission createno cable qos permission updatecable qos permission modemscable load-balance group 1 threshold load 75 enforcecable load-balance group 1 threshold stability 75cable load-balance group 1 policy ugscable load-balance group 1 threshold ugs 75



cable load-balance group 1 policy pcmmcable load-balance group 1 threshold pcmm 75no aaa new-modelip subnet-zero!!ip cefno ip domain lookup!!interface GigabitEthernet0/1ip address 10.14.1.130 255.255.0.0duplex autospeed automedia-type rj45no negotiation auto!interface GigabitEthernet0/2

The following example of the show cable load all command illustrates DCC for load balancing.Router# show cable load all

*Nov 11 15:43:39.979: %SYS-5-CONFIG_I: Configured fromconf tGroup Interval Method DCC Init Threshold

Technique Minimum Static Enforce Ugs PCMM1 10 modems 0 5 75% 75% 75% 75%

Current load:

Interface State Group Utilization Reserved Modems Flows WeightCable3/0 (0 MHz) initial 1 0%(0%/0%) 0% 0 0 26

Target assignments:

Interface State Group TargetCable3/0 (0 MHz) initial 1

Statistics:


Cable3/0 (0 MHz) initial 0 0 0 0

Pending:

Modem Group Source interface Target interface Retries

The following example illustrates a DCC load balancing group with the default DCC initialization technique.This command configures load balancing group 1:Router(config)# cable load-balance group 1 threshold load 10 enforce

This configuration creates a dynamic load balancing group with the following default settings:cable load-balance group 1 method modemcable load-balance group 1 threshold load 10 enforcecable load-balance group 1 interval 10cable load-balance group 1 dcc-init-technique 0

The following example changes this DCC load balancing configuration to initialization technique 4:



Router# cable load-balance group 1 dcc-init-technique 4

By default, UGS and PCMM policies are not turned on, so that CMs with active voice calls or PCMM callsparticipate in load balancing.

Note


LinkDescription




Feature Information for DOCSIS Load Balancing MovementsUse Cisco Feature Navigator to find information about the platform support and software image support.Cisco Feature Navigator enables you to determine which software images support a specific software release,feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An accounton the Cisco.com page is not required.


Note

Table 16: Feature Information for DOCSIS Load Balancing Groups



Cisco IOS XE Fuji 16.7.1DOCSIS Load BalancingMovements


DOCSIS Load Balancing MovementsAdditional References




DOCSIS Load Balancing MovementsFeature Information for DOCSIS Load Balancing Movements

C H A P T E R 7DOCSIS 3.0 Downstream Bonding

The DOCSIS 3.0 Downstream Bonding feature helps cable operators offer new, more bandwidth-intensiveservices by adding one or more additional downstream quadrature amplitude modulation (QAM) channels tothe standard broadband DOCSIS system.



• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 121• Information About DOCSIS 3.0 Downstream Bonding, on page 122• How to Configure RCP and RCC Encoding, on page 124• How to Configure Attribute Masks, on page 133• How to Enable Service Flow Priority in Downstream Extender Header, on page 137• Enabling Verbose Reporting for Receive Channel Profiles, on page 139• Configuration Example for an RCC Template, on page 140• Additional References, on page 141• Feature Information for DOCSIS 3.0 Downstream Bonding, on page 141



Note
















Digital PICs:


•













Information About DOCSIS 3.0 Downstream BondingDOCSIS 3.0 DownstreamBonding enables high-speed broadband access and helps cable operators offer morebandwidth-intensive services by adding one or more additional downstream quadrature amplitude modulation(QAM) channels to the standard broadband DOCSIS system. This new set of downstream channels is groupedinto one larger channel, known as a bonded channel.

Channel bonding combines several RF channels into one virtual channel. Data rates in this virtual channelrange from hundreds of megabits to potentially gigabits per second, creating more available bandwidth in thenetwork.


DOCSIS 3.0 Downstream BondingInformation About DOCSIS 3.0 Downstream Bonding

Receive Channel ProfileAn RCP is an encoding that represents the receive channels and receive modules of a cable modem. A cablemodem communicates to the CMTS one or more RCP encodings within its registration request using eitherverbose description, which contains complete subtype encoding defined in DOCSIS 3.0, or simple description,which only contains RCP identifiers.

The cable modem reporting method is configurable within the MAC domain and communicated to cablemodems via the MDD.

Youmust define an RCP-ID to describe the cable modem's capabilities for that RCP-ID and to input informationabout cable modems which are not defined on the system. Once configured the RCP-ID is available to theentire system since it is not meant to be card specific or mac-domain specific. The path selection moduleensures that the RCP ID is accurately transmitted as part of the RCC profile.

The CableLabs MULPI specification defines standard RCPs which are automatically created by the CMTS.

Receive Channel ConfigurationA cable modem reports its ability to receive multiple channels with one or more RCP encodings in a REG-REQor REG-REQ-MP message. Each receive channel profile describes a logical representation of the cablemodem’s downstream physical layer in terms of receive channels (RCs) and receive modules (RMs). TheCMTS initially configures the cable modem’s receive channels and receive modules with an RCC encodingin the registration response.

This feature supports any arbitrary RCP ID configuration and receive channel configuration on a Cisco cBRSeries Converged Broadband Router.

RCC TemplateYou can configure one or more RCC templates for an RCP. An RCC template configures the physical layercomponents described by an RCP, including receive modules and receive channels to specific downstreamfrequencies. The template also specifies the interconnections among receive modules, or between a receivemodule and a receive channel. An RCC template can be associated only to the cable interface (MAC domain).

A cable modem's RCP ID is matched with an RCC, when RCC templates are configured. A cable modem'sRCP ID may be matched with an RCC generated by an RCC template when RCC templates are configured.The path selection module ensures that the RCP ID that is transmitted as part of the RCC profile is accurate.

At time of registration, if there are multiple valid RCCs that can be assigned to the CM after going throughthe sequence of checks outlined in the CableLabsMULPI specifications then the RCCwith the most channelswill be the one selected. If there are multiple valid RCCs of equal size then the RCC with the least amount ofcable modems will be selected.

Channel AssignmentThe CMTS assigns a receive channel configuration encoding to a DOCSIS 3.0-certified cable modem operatingin a Multiple Receive Channel (MRC) mode during cable modem registration.

With the implementation of this feature, the DOCSIS 3.0-certified cablemodem reports its receiving capabilitiesand characteristics using the receive channel profile type, length, value (TLV) list in the registration requestmessage. Based on this report, the CMTS assigns an RCC encoding that is compatible with the reported RCP.


DOCSIS 3.0 Downstream BondingReceive Channel Profile

Cablemodems operating inMRCmode are assigned an RCC encoding associatedwith an RCP. RCC encodingsmay be derived from RCC templates or from a wideband-cable interface configuration.

Downstream Traffic ForwardingDOCSIS 3.0 introduces the concept of assigning downstream service flows of cable modems, which areoperating in anMRCmode, to downstream (DS) channels or bonding groups. Forwarding interfaces assignedto service flows (SFs) can be either DS channel interfaces (integrated cable interfaces) or downstream bondinggroups (wideband interfaces).

Valid interfaces that are available for SF assignment must be a subset of the cable modem’s assigned RCCencoding.

Note

Service Flow Priority in Downstream Extended HeaderThe purpose of the feature is to be able to reflect the traffic priority of downstream packets into the DOCSISextended header. The priority is derived from the service flow that the packet is mapped to. Priority refers tothe service flow priority specified in the CM configuration file, or the Cisco CMTS service class configuration.

The service flow priority can be set using cable modem configuration file, or dynamic configuration.

By default, this feature is disabled on Cisco cBR-8 router, user can use cable service flow priority commandto enable this feature.

How to Configure RCP and RCC EncodingThe following tasks describe how to configure a receive channel profile and configuration encoding for areceive channel profile:

Configuring the RCP IDYou must configure the RCP IDs with the cable modem capabilities that are not defined in the CMTS. Thisis done to supplement the standard MULPI RCP IDs already created by the CMTS.

Before you begin

Restrictions

The configurations are subject to RCC Templates and RCP Interactions as follows:

• RCC templates can only be created for an RCP that is already defined on the system. By default thesystem will contain the RCPs that are specified in the MULPI spec.

• When defining RCC templates for a particular RCP, error checking will be done to ensure that theinformation being configured in the RCC template does not violate the corresponding RCP information.For example, if the RCP information indicates that there are 2 receive modules then the RCC templateconfiguration will not allow the user to configure more than 2 modules.

• Once an RCP is included in an RCC template users will not be allowed to modify the RCP. Only an RCPwhich is not being used by any RCC template can be modified


DOCSIS 3.0 Downstream BondingDownstream Traffic Forwarding

• A valid RCP that can be applied to an rcc-template must contain the following;

• center-frequency-spacing• At least one module which defines the minimum and maximum center frequency range.• Rules of inheritance.• rcc-template inherit definition from the associated user-defined RCP, such ascenter-frequency-spacing.

• rcc-template channel frequencies must fall within the range of the minimum and maximum centerfrequency per the corresponding RCP module.

• common-module definition is applicable to the rcc-template module referenced with the same index.• rcc-template module channel frequencies overrides the same channel from the correspondingcommon-module.

Procedure





Example:

Step 2


Defines the RCC template.cable rcp-id rcp-idStep 3

Example: • rcp-id - Specifies an RCP ID in Hex.

Router(config)#cable rcp-id 00 10 00 01 08Router(config-rcp)#

This command changes the input mode to the RCCconfiguration mode.

name —Assigns a name ro the RCP IDname wordStep 4

Example: • word—Use a string to name the RCP ID.

Router(config-rcp)# name rcp-id_1Do not include space between words in thename

Note

Assigns a center frequency space to the RCP ID. The validvalues are 6 and 8.

center-frequency-spacing frequency

Example:

Step 5

Router(config-rcp)#center-frequency-spacing 6

Configures a receive module configuration for the selectedRCP.

module module index minimum-center-frequency Hzmaximum-center-frequency Hz

Example:

Step 6

• module index - Specifies the module number for thereceivemodule. The valid range is 1 to 12.

Router(config-rcp)# module 1 • minimum-center-frequency - Specifies theminimumcenter frequency for the channels of thereceivemodule channel.

minimum-center-frequency 120000000maximum-center-frequency 800000000


DOCSIS 3.0 Downstream BondingConfiguring the RCP ID


• Hz- Specifies the center frequency value in Hz. Thevalid range is from 111000000 to 999000000.

• maximum-center-frequency - Specifies themaximum center frequency for the channels of thereceive module channel.

Specifies the frequency band for the receive module. Thevalid values are 1-255.

module module index number-of-adjacent-channelsIntegrer

Example:

Step 7

Router(config-rcp)#module 2number-of-adjacent-channels 10Router(config-rcp)#

Specifies a receive channel configuration for the selectedRCP.

module module index connected-module module index

Example:

Step 8

• connected-receive-module— (Optional) Specifiesa nested receive module in the RCC template.Router(config-rcp)# module 1 connected-module 0

Generally, only one receive module is configured foran RCC template.

• module index—Specifies the module number for thereceive module. The valid range is 1 to 12.

Specifies the number of receive channels in the RCP ID.number-of-channels Number of channel

Example:

Step 9

Router (config-rcp)#number-of-channels 8

Specifies the number of receive channels that are definedas primary capable channels.

primary-capable-channels Number of channel

Example:

Step 10

Router(config-rcp)# primary-capable-channels 1

What to do next

Verify RCP ID configurations using the show cable rcps command.

Router# show cable rcpsRCP ID : 00 10 00 01 08Name : rcp-id 1Center Frequency Spacing : 6Max number of Channels : 8Primary Capable Channel : 1Number of Modules : 2Module[1]:Number of Adjacent Channels: 10Minimum Center Frequency-Hz: 111000000Maximum Center Frequency-Hz: 999000000

Module[2]:Number of Adjacent Channels: 10


DOCSIS 3.0 Downstream BondingConfiguring the RCP ID

Minimum Center Frequency-Hz: 120000000Maximum Center Frequency-Hz: 800000000

RCP ID : 00 10 00 00 02Name : rcp-id 2Center Frequency Spacing : 6Max number of Channels : 2Primary Capable Channel : 1Number of Modules : 1Module[1]:Number of Adjacent Channels: 10

Minimum Center Frequency-Hz: 111000000Maximum Center Frequency-Hz: 867000000Connected Module : 64

Configuring the RCC TemplatesYou must configure an RCC template with a unique RCP ID for a particular CMTS. A valid RCC templateconsists of a configured RCP ID, RMs, and RCs. There is dependency between the RCC templates and theRCP since information present in the RCP configuration is also present in RCC templates.

Each RCC encoding contains all operational DS channels with their channel parameters, including the frequencymatch RC attribute specified in the RCC template. An RCC template specifies the intended receive channelassignment in the available DS spectrum.

If an RCC template is removed from a MAC domain through configuration, the CMTS removes all RCCencodings derived from the RCC template, and all cable modems assigned to the RCC encoding are markedoffline.

Note

Before you begin

At least one RC must be configured as a primary Receive Channel (RC).

Procedure





Example:

Step 2


id—Specifies an RCC template. The valid range is 1-64.cable rcc-templates frequency-based id

Example:

Step 3

Router(config)#cable rcc-templates frequency-based1Router(config-rcc-freq-based)#


DOCSIS 3.0 Downstream BondingConfiguring the RCC Templates


id—Specifies an RCP ID for the RCC template. The validrange is 00 00 00 00 00 to FF FF FF FF. By default, theRCP ID is set to 00 00 00 00 00.

rcp-id id

Example:Router(config-rcc-freq-based)#rcp-id 00 10 00 0108

Step 4

Specifies module configurations that are common for aselected set of channels assigned to the selected RCP ID.

common-module module-index channel groupliststart-frequency Hz

Step 5

Example: • Module-index—Specifies the index value for thereceive module. The valid range is 1 to 12.Router(config-rcc-freq-based)# common-module 1

channels 0-6 start-frequency 555000000• channels—Specifies the list of channels to which thecommon configurations apply.

• grouplist—Specifies the list of channels to which aspecific list of configurations apply. The range ofvalues are 1-64.

• start-frequency—Specifies the start frequency valuein Hz.

• Hz—Specifies the frequency value for the startfrequency for the common module.Thevalidrangeisfrom 111000000 to 999000000.

Specifies an RCC template ID to configure the selectedRCC template.

rcc-template Id

Example:

Step 6

• Id—Specifies the ID of the RCC template. The validrange is from 1-8.

Router(config-rcc-freq-based)# rcc-template 1

(Optional) Configured to be used to match against the cmattribute mask define in CM 's configuration file.

cm-attribute-mask value

Example:

Step 7

• value—The valid range is 00 00 00 00 00 to FF FF FFFF.

Router (config-rcc-freq-based-tmplt)#cm-attribute-mask 1

Specifies module configurations that are common for aselected set of channels assigned to the selected RCP ID.

modulemodule-index channel grouplist start-frequencyHz.

Step 8

Example: • Module-index—Specifies the index value for thereceive module. The valid range is 1 to 12.Router(config-rcc-freq-based)# common-module 1

channels 0-6 start-frequency 555000000• channels—Specifies the list of channels to which thecommon configurations apply.

• grouplist—Specifies the list of channels to which aspecific list of configurations apply. The range ofvalues are 1-64.

• start-frequency—Specifies the start frequency valuein Hz.


DOCSIS 3.0 Downstream BondingConfiguring the RCC Templates


• Hz—Specifies the frequency value for the startfrequency for the common module. The valid range isfrom 111000000 to 999000000.

Repeat Step 3 and Step 7 to configure other frequency basedRCC templates.

What to do next

The following configuration examples show the cable rcc-template configuration:cable rcc-templates frequency-based 2rcp-id 00 10 00 01 08common-module 1 channels 1-4 start-frequency 381000000rcc-template 1module 1 channels 5-8 start-frequency 501000000rcc-template 2module 1 channels 5-8 start-frequency 669000000rcc-template 3

cable rcc-templates frequency-based 1rcp-id 00 10 00 01 08rcc-template 1cm-attribute-mask 2module 1 channels 1-4 start-frequency 381000000module 2 channels 5-8 start-frequency 501000000rcc-template 2module 1 channels 1-4 start-frequency 381000000module 2 channels 5-8 start-frequency 669000000rcc-template 3module 1 channels 1-4 start-frequency 381000000

After defining an RCC template, you must assign the template to a cable interface.

Assigning an RCC Template to a MAC Domain (Cable Interface)The CMTS derives an RCC or RCCs from the RCC template for each MAC Domain Downstream ServiceGroup (MD-DS-SG).

The following information is required for RCC assignment to cable modems:

• RCC templates assigned to the MAC domain.

• DS channel physical parameters including frequency and connected-receive-module index .

• DS channel primary capable indicator.

• DS channel membership to the MD-DS-SG.

• Cable modem membership to the MD-DS-SG.

This section describes how to assign an RCC template to a MAC Domain.


DOCSIS 3.0 Downstream BondingAssigning an RCC Template to a MAC Domain (Cable Interface)

Procedure





Example:

Step 2


Enters MAC domain configuration mode.interface cable slot/subslot/portStep 3

Example: • slot—Specifies the chassis slot number of the interfaceline card.Router(config)# interface cable 1/0/0

• subslot—Specifies the secondary slot number of theinterface line card. Valid subslot is 0.

• MD index—Specifies theMACDomain index number.Valid values are 0-15.

Assigns the RCC template to the specified cable interface.cable rcc-template frequency-based IdStep 4

Example: • Id—Specifies the template you want to assign to thecable interface. The valid range is from 1 to 64.

Router(config-if)# cable rcc-templatefrequency-based 1

What to do next

Verify RCC template binding to MD.

The following example shows the RCC template binding using the show cable mac-domain rcc

Router#show cable mac-domain c1/0/0 rcc

RCC-ID RCP RCs MD-DS-SG CMs WB/RCC-TMPL1 00 00 00 00 00 4 0 2 WB (Wi1/0/0:0)2 00 00 00 00 00 4 0 2 WB (Wi1/0/0:1)3 00 00 00 00 00 4 0 0 WB (Wi1/0/1:2)4 00 00 00 00 00 4 0 0 WB (Wi1/0/2:3)8 00 10 00 01 08 8 5 0 RCC-TMPL (1:1)9 00 10 00 01 08 8 5 0 RCC-TMPL (1:2)10 00 10 00 01 08 4 5 0 RCC-TMPL (1:3)14 00 10 00 01 08 8 5 0 RCC-TMPL (2:1)15 00 10 00 01 08 8 5 0 RCC-TMPL (2:2)16 00 10 00 01 08 4 5 0 RCC-TMPL (2:3)

The following example shows the RCC template binding using the show cable mac-domain rcc id command.

Router#show cable mac-domain c1/0/0 rcc 8



RCC ID : 8RCP : 00 10 00 01 08Created Via : rcc-template - 1:1CM attribute mask : 0x2Receive Channels : 8Receive Channel : 1Center Frequency : 381000000Primary Capability : YESReceive Module Conn : 1

Receive Channel : 2Center Frequency : 387000000Primary Capability : NOReceive Module Conn : 1







Receive Modules : 2Receive Module : 1First Frequency : 381000000

Receive Module : 2First Frequency : 501000000





Receive Channel : 4



Center Frequency : 399000000Primary Capability : NOReceive Module Conn : 1






Receive Module : 2First Frequency : 669000000







Verifying the RCC ConfigurationTo verify the runtime RCCs on a cable interface, use the show cable mac-domain rcc command.

Router#show cable mac-domain c1/0/0 rcc

RCC-ID RCP RCs MD-DS-SG CMs WB/RCC-TMPL1 00 00 00 00 00 4 0 2 WB (Wi1/0/0:0)


DOCSIS 3.0 Downstream BondingVerifying the RCC Configuration

2 00 00 00 00 00 4 0 2 WB (Wi1/0/0:1)3 00 00 00 00 00 4 0 0 WB (Wi1/0/1:2)4 00 00 00 00 00 4 0 0 WB (Wi1/0/2:3)8 00 10 00 01 08 8 5 0 RCC-TMPL (1:1)9 00 10 00 01 08 8 5 0 RCC-TMPL (1:2)10 00 10 00 01 08 4 5 0 RCC-TMPL (1:3)14 00 10 00 01 08 8 5 0 RCC-TMPL (2:1)15 00 10 00 01 08 8 5 0 RCC-TMPL (2:2)16 00 10 00 01 08 4 5 0 RCC-TMPL (2:3)

A zero (0) value in the RCP or MD-DS-SG field indicates that the RCC encoding is configureddirectly through a wideband interface configuration and not through any RCC template.

Note

How to Configure Attribute MasksDOCSIS 3.0 introduces the concept of assigning service flows to channels or bonding groups based on binaryattributes. The attribute masks configured on a cable, modular, integrated or wideband interface are calledprovisioned attribute masks.

The two types of attributes are as follows:

• Specification-defined attributes—Contain default values based on the characteristics of the channel orbonding group.

• Operator-defined attributes—Default to zero.

The operator can configure a provisioned attribute mask for each channel and provisioned bonding group toassign values to the operator-defined binary attributes. The operator can also assign new values to overridethe default values of the specification-defined attributes.

The operator can configure a required attribute mask and a forbidden attribute mask for a service flow in thecable modem configuration file. These required and forbidden attribute masks are optionally provided on theDOCSIS 3.0 service flows and are matched with the provisioned attribute masks of the interfaces.

Each service flow is optionally configured with the following TLV parameters:

• Service flow required attribute mask—To configure this, assign a service flow to a channel that has a1-bit in all positions of its provisioned attribute mask corresponding to the 1-bit in the service flowrequired attribute mask.

• Service flow forbidden attribute mask—To configure this, assign a service flow to a channel that has a0-bit in all positions of its provisioned attribute mask corresponding to the 1-bit in the service flowforbidden attribute mask.

Additionally, in a cable modem-initiated dynamic service request, the cable modem can include a requiredattribute mask and a forbidden attribute mask for a service flow. The CMTS assigns service flows to channelsor bonding groups so that all required attributes are present and no forbidden attributes are present in the cablemodem configuration file.

The table below lists the supported binary attributes for channels and bonding groups.


DOCSIS 3.0 Downstream BondingHow to Configure Attribute Masks

Table 18: Binary Attributes

DefinitionBit Position

Bonded—This bit is zero for all individual channel interfaces and one for all bonding groups.Bit 0

Low latency—This bit is set when the interface can provide relatively low latency service. Thisbit is set to zero for all channels, and left up to the operator to define.

Bit 1

High availability—This bit is set to zero for all channels, and left up to the operator to define.Bit 2

Reserved—Set to zero.Bit 3:15

Operator defined—Set to zero by default.Bit 16:31

You can configure provisioned attribute masks for cable, integrated cable, wideband cable, and modular cableinterfaces.

Prerequisites

• To assign an interface to a wideband cable modem’s service flow, the interface must be a subset of thecable modem’s RCC.

• To assign a service flow to an integrated cable (IC) channel, the corresponding integrated cable interfacemust be configured and operational.

Restrictions

• The service flow from a narrowband cable modem is always assigned to the primary interface of thecable modem. No attribute checking is performed in this case.

This section describes the following:

Configuring Provisioned Attributes for an Integrated Cable InterfaceThe default provisioned attribute is zero for an integrated cable interface.

Procedure





Example:

Step 2


Specifies the cable interface line card on a Cisco CMTSrouter:

interface integrated-cable {slot/port |slot/subslot/port}:rf-channel

Step 3

Example: • slot—Chassis slot number of the cable interface linecard.


DOCSIS 3.0 Downstream BondingConfiguring Provisioned Attributes for an Integrated Cable Interface

PurposeCommand or ActionRouter(config)# interface integrated-cable 1/0/0:0 • subslot—subslot number of the cable interface line

card. Valid subslot is always 0.

• port—Downstream port number.

• rf-channel—RF channel number with a range of 0 to3.

Specifies the mask for the interface.cable attribute-mask mask

Example:

Step 4

Router(config-if)# cable attribute-mask 800000ff

Configuring Provisioned Attributes for a Wideband Cable InterfaceThe default provisioned attribute is 0x80000000 for a wideband cable interface, and the zero bit is automaticallyadded to the wideband cable interface whenever an attribute is configured for that interface.

Procedure





Example:

Step 2


Specifies the wideband cable interface and enters interfaceconfiguration mode:

interface wideband-cable {slot/port |slot/subslot/port}:wideband-channel

Example:

Step 3

Router(config)# interface wideband-cable 1/0/1:4

Specifies the mask for the interface.cable downstream attribute-mask mask

Example:

Step 4

Router(config-if)# cable downstream attribute-mask800000ff

Verifying the Attribute-Based Service Flow AssignmentsTo verify the attribute-based assignment of service flows on a cable interface, use the show interface cableservice-flow or show interface wideband-cable service-flow command as shown in the following example:

Router# show interface cable 3/0 service-flow


DOCSIS 3.0 Downstream BondingConfiguring Provisioned Attributes for a Wideband Cable Interface

Sfid Sid Mac Address QoS Param Index Type Dir Curr Active DS-ForwIf/Prov Adm Act State Time US-BG/CH

17 4 001c.ea37.9aac 3 3 3 P US act 13h21m CH 318 N/A 001c.ea37.9aac 4 4 4 P DS act 13h21m Wi3/0:021 6 001c.ea37.9b5a 3 3 3 P US act 13h21m CH 422 N/A 001c.ea37.9b5a 4 4 4 P DS act 13h21m Wi3/0:023 7 0016.925e.654c 3 3 3 P US act 13h21m CH 324 N/A 0016.925e.654c 4 4 4 P DS act 13h21m In3/0:0

Router# show interface wideband-cable 5/1:0 service-flowSfid Sid Mac Address QoS Param Index Type Dir Curr Active DS-ForwIf/

Prov Adm Act State Time US-BG/CH3 8193 ffff.ffff.ffff 3 3 3 S(s) DS act 2h06m Wi5/1:0

The table below shows descriptions for the fields displayed by this command:

Table 19: show interface cable service-flow Field Descriptions

DescriptionField

Identifies the service flow identification number.

Primary service flow IDs are displayed even for offline cablemodemsbecause they are needed for modem re-registration.

Note

Sfid

Identifies the service identification number (upstream service flows only).Sid

Identifies the MAC address for the cable modem.Mac Address

Identifies the QoS parameter index for the provisioned state of this flow.QoS Parameter Index Prov

Identifies the QoS parameter index for the Admitted state of this flow.QoS Parameter Index Adm

Identifies the QoS parameter index for the Active state of this flow.QoS Parameter Index Act

Indicates if the service flow is the primary flow or a secondary service flow.Secondary service flows are identified by an “S” (created statically at the timeof registration, using the DOCSIS configuration file) or “D” (created dynamicallyby the exchange of dynamic service messages between the cable modem andCMTS).

Type

Indicates if this service flow is DS or US.Dir

Indicates the current run-time state of the service flow.Curr State

Indicates the length of time this service flow has been active.Active Time

Indicates the bonding group ID or the downstream RFID of the forwardinginterface assigned to the downstream service flow.

DS-ForwIf/US-BG/CH

BG/DS


DOCSIS 3.0 Downstream BondingVerifying the Attribute-Based Service Flow Assignments

How to Enable Service Flow Priority in Downstream ExtenderHeader

The following tasks describe how to enable service flow priority in downstream extender header:

Enabling Service Flow Priority in Downstream Extender HeaderThis section describes how to enable service flow priority in downstream extender header on the Cisco cBR-8routers:

Procedure





Example:

Step 2


Enables the service flow priority in downstream extenderheader.

cable service flow priority

Example:

Step 3

Router(config)# cable service flow priority

Verifying the Enablement of the Service Flow Priority in Downstream ExtendedHeader

To verify the enablement of the service flow priority in downstream extended header, use the showrunning-config | in service flow or show cable modem [ip-address | mac-address] verbose command asshown in the following example:

Router# show running-config | in service flowcable service flow priority

Router# show cable modem 100.1.2.110 verbose

MAC Address : 0025.2e2d.74f8IP Address : 100.1.2.110IPv6 Address : 2001:420:3800:909:7964:98F3:7760:ED2Dual IP : YPrim Sid : 1Host Interface : C3/0/0/U0MD-DS-SG / MD-US-SG : N/A / N/AMD-CM-SG : 0x900000Primary Downstream : In3/0/0:32 (RfId : 12320, SC-QAM)Wideband Capable : Y


DOCSIS 3.0 Downstream BondingHow to Enable Service Flow Priority in Downstream Extender Header

DS Tuner Capability : 8RCP Index : 6RCP ID : 00 00 00 00 00Downstream Channel DCID RF Channel : 191 3/0/0:32 (SC-QAM)UDC Enabled : NUS Frequency Range Capability : Standard (5-42 MHz)Extended Upstream Transmit Power : 0dBMulti-Transmit Channel Mode : NUpstream Channel : US0Ranging Status : staUpstream SNR (dB) : 39.8Upstream Data SNR (dB) : 36.12Received Power (dBmV) : -1.00Timing Offset (97.6 ns): 1799Initial Timing Offset : 1799Rng Timing Adj Moving Avg(0.381 ns): 0Rng Timing Adj Lt Moving Avg : 0Rng Timing Adj Minimum : 0Rng Timing Adj Maximum : 0Pre-EQ Good : 0Pre-EQ Scaled : 0Pre-EQ Impulse : 0Pre-EQ Direct Loads : 0Good Codewords rx : 8468Corrected Codewords rx : 0Uncorrectable Codewords rx : 0Phy Operating Mode : atdmasysDescr :Downstream Power : 0.00 dBmV (SNR = ----- dB)MAC Version : DOC3.0QoS Provisioned Mode : DOC1.1Enable DOCSIS2.0 Mode : YService Flow Priority : NModem Status : {Modem= online, Security=disabled}Capabilities : {Frag=Y, Concat=Y, PHS=Y}Security Capabilities : {Priv=, EAE=N, Key_len=}L2VPN Capabilities : {L2VPN=N, eSAFE=N}L2VPN type : {CLI=N, DOCSIS=N}Sid/Said Limit : {Max US Sids=16, Max DS Saids=15}Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}CM Capability Reject : {15,22,23,24,25,26,27,28,29,35,36,38}Flaps : 3(Oct 8 16:22:23)Errors : 0 CRCs, 0 HCSesStn Mtn Failures : 0 aborts, 2 exhaustedTotal US Flows : 1(1 active)Total DS Flows : 1(1 active)Total US Data : 294 packets, 25903 bytesTotal US Throughput : 143 bits/sec, 0 packets/secTotal DS Data : 91 packets, 10374 bytesTotal DS Throughput : 0 bits/sec, 0 packets/secLB group ID assigned : 1LB group ID in config file : N/ALB policy ID : 0LB policy ID in config file : 0LB priority : 0Tag : d30Required DS Attribute Mask : 0x0Forbidden DS Attribute Mask : 0x0Required US Attribute Mask : 0x0Forbidden US Attribute Mask : 0x0Service Type ID :Service Type ID in config file :Active Classifiers : 0 (Max = NO LIMIT)


DOCSIS 3.0 Downstream BondingVerifying the Enablement of the Service Flow Priority in Downstream Extended Header

CM Upstream Filter Group : 0CM Downstream Filter Group : 0CPE Upstream Filter Group : 0CPE Downstream Filter Group : 0DSA/DSX messages : permit allVoice Enabled : NODS Change Times : 0Boolean Services : 0CM Energy Management Capable : NCM Enable Energy Management : NCM Enter Energy Management : NOBattery Mode : NBattery Mode Status :Number of Multicast DSIDs Support : 16MDF Capability Mode : 2IGMP/MLD Version : MLDv2FCType10 Forwarding Support : YFeatures Bitmask : 0x0Total Time Online : 6h00m (6h00m since last counter reset)CM Initialization Reason : POWER_ON

Enabling Verbose Reporting for Receive Channel ProfilesA receive channel profile is an encoding that represents the receive channels and receive modules of a cablemodem. A cable modem communicates to the CMTS one or more RCP encodings within its registrationrequest using either verbose description, which contains complete subtype encodings defined in DOCSIS 3.0,or simple description, which only contains RCP identifiers.

Procedure





Example:

Step 2


Specifies the cable interface line card on a Cisco CMTSrouter:

interface cable {slot/port | slot/subslot/port}

Example:

Step 3

• slot—Chassis slot number of the cable interface linecard.

Router(config)# interface cable7/0/0

• subslot—subslot number of the cable interface linecard. Valid subslot is 0.

• port—Downstream port number.

Enables RCP reporting with verbose description.cable rcp-control verbose

Example:

Step 4

Router(config-if)# cable rcp-control verbose


DOCSIS 3.0 Downstream BondingEnabling Verbose Reporting for Receive Channel Profiles

Configuration Example for an RCC TemplateThe following sample shows an RCP ID configuration:

...!cable rcp-id 00 10 00 01 08center-frequency-spacing 6module 1 minimum-center-frequency 120000000 maximum-center-frequency 800000000 module 1

number-of-adjacent-channels 10module 2 minimum-center-frequency 120000000 maximum-center-frequency 800000000 module 2number-of-adjacent-channels 10number-of-channels 8primary-capable-channels 1

!

The following sample shows an RCC template configuration:

...!cable rcc-templates frequency-based 1rcp-id 00 10 00 01 08rcc-template 1cm-attribute-mask 2module 1 channels 1-4 start-frequency 381000000module 2 channels 5-8 start-frequency 501000000rcc-template 2module 1 channels 1-4 start-frequency 381000000module 2 channels 5-8 start-frequency 669000000rcc-template 3module 1 channels 1-4 start-frequency 381000000

!

The following sample shows an RCC template configuration using the common-module option:

...!cable rcc-templates frequency-based 2

rcp-id 00 10 00 01 08common-module 1 channels 1-4 start-frequency 381000000rcc-template 1module 1 channels 5-8 start-frequency 501000000rcc-template 2module 1 channels 5-8 start-frequency 669000000rcc-template 3

!

The following sample shows the assignment of an RCC template to MAC Domain:

...!configure terminalinterface c1/0/0cable rcc-templates frequency-based 1end

...


DOCSIS 3.0 Downstream BondingConfiguration Example for an RCC Template


LinkDescription




Feature Information for DOCSIS 3.0 Downstream BondingUse Cisco Feature Navigator to find information about the platform support and software image support.Cisco Feature Navigator enables you to determine which software images support a specific software release,feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An accounton the Cisco.com page is not required.


Note

Table 20: Feature Information for Downstream Interface Configuration


This feature was integrated on theCisco cBR Series ConvergedBroadband Router.

Cisco IOS XE Everest 16.6.1DOCSIS 3.0 DownstreamBonding

This feature was integrated on theCisco cBR Series ConvergedBroadband Router.

Cisco IOS XE Everest 16.6.1Service Flow Priority inDownstream Extended Header


DOCSIS 3.0 Downstream BondingAdditional References




DOCSIS 3.0 Downstream BondingFeature Information for DOCSIS 3.0 Downstream Bonding

C H A P T E R 8DOCSIS 2.0 A-TDMA Modulation Profiles

This document describes the DOCSIS 2.0 A-TDMA services feature, which provides support for DOCSIS2.1 Advanced Time Division Multiple Access (A-TDMA) upstream modulation profiles on the router. Thisfeature supplements the existing support for DOCSIS 1.0 and DOCSIS 1.1 Time Division Multiple Access(TDMA) modulation profiles.



Contents

• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 143• Prerequisites for DOCSIS 2.0 A-TDMA Modulation Profiles, on page 144• Restrictions for DOCSIS 2.0 A-TDMA Services, on page 145• Information About DOCSIS 2.0 A-TDMA Services, on page 145• How to Configure DOCSIS 2.0 A-TDMA Services, on page 148• Monitoring the DOCSIS 2.0 A-TDMA Services, on page 152• Configuration Examples for DOCSIS 2.0 A-TDMA services, on page 154• Additional References, on page 158• Feature Information for DOCSIS 2.0 A-TDMA Modulation Profile, on page 159



Note
















Digital PICs:


•













Prerequisites for DOCSIS 2.0 A-TDMA Modulation Profiles• The cable physical plant must be capable of supporting the higher-bandwidth DOCSIS 2.0 A-TDMAmodulation profiles.

• Cable modems must be DOCSIS-compliant. If cable modems go offline, or appear to be online but donot pass traffic when in the mixed TDMA/A-TDMA mode, upgrade the modem software to aDOCSIS-compliant version.

• The following are required to support the DOCSIS 2.0 A-TDMA features:

• Cable modems must be DOCSIS 2.0 capable.• The DOCSIS configuration file for a DOCSIS 2.0 cable modem must either omit the DOCSIS 2.0Enable field (TLV 39), or it must set TLV 39 to 1 (enable). If you set TLV 39 to 0 (disable), aDOCSIS 2.0 CM uses the TDMA mode.


DOCSIS 2.0 A-TDMA Modulation ProfilesPrerequisites for DOCSIS 2.0 A-TDMA Modulation Profiles

• The upstream must be configured for either A-TDMA-only or mixed TDMA/A-TDMA mode. Touse the 6.4 MHz channel width, the upstream must be configured for A-TDMA-only mode.

• Complete a basic configuration of the router; this includes, at a minimum, the following tasks:

• Configure a host name and password for the router.• Configure the router to support Internet Protocol (IP) operations.• Install and configure at least one WAN adapter to provide backbone connectivity.

• Determine a channel plan for the router and all of its cable interfaces.• Verify that your headend site includes all necessary servers to support DOCSIS and Internet connectivity,including DHCP, ToD, and TFTP servers.

• The system clock on the router should be set to a current date and time to ensure that system logs havethe proper timestamp and to ensure that the BPI+ subsystem uses the correct timestamp for verifyingcable modem digital certificates.

Restrictions for DOCSIS 2.0 A-TDMA Services• Does not support virtual channels, as described in DOCSIS 2.0 specification.• Does not support Synchronous Code Division Multiple Access (S-CDMA) channels.• Changing the DOCSIS mode of an upstream takes all cable modems on that upstream offline, whichforces the cable modems to reregister, so that the CMTS can determine the capabilities of the cablemodems on the new channels.

Information About DOCSIS 2.0 A-TDMA ServicesDOCSIS 2.0 A-TDMA services improve the maximum upstream bandwidth on existing DOCSIS 1.0 andDOCSIS 1.1 cable networks by providing a number of advanced PHY capabilities that have been specifiedby the new DOCSIS 2.0 specifications.

DOCSIS 2.0 A-TDMA services incorporate the following advantages and improvements of DOCSIS 2.0networks:

• Builds on existing DOCSIS cable networks by providing full compatibility with existing DOCSIS 1.0and DOCSIS 1.1 cable modems. (The registration response (REG-RSP) message contains the DOCSISversion number to identify each cable modem’s capabilities.)

• Upstreams can be configured for three different modes to support different mixes of cable modems:

• An upstream can be configured for TDMA mode to support only DOCSIS 1.0 and DOCSIS 1.1cable modems.

• An upstream can be configured for A-TDMA mode to support only DOCSIS 2.0 cable modems.• An upstream can be configured for a mixed, TDMA/A-TDMA mode, to support both DOCSIS1.0/DOCSIS 1.1 and DOCSIS 2.0 cable modems on the same upstream.


DOCSIS 2.0 A-TDMA Modulation ProfilesRestrictions for DOCSIS 2.0 A-TDMA Services

DOCSIS 2.0 A-TDMA cable modems will not register on a TDMA upstream ifan A-TDMA or mixed upstream exists in the same MAC domain, unless theCMTS explicitly switches the cablemodem to another upstream using anUpstreamChannel Change (UCC) message. DOCSIS 1.0 and DOCSIS 1.1 cable modemscannot register on an A-TDMA-only upstream.

Note

• A-TDMAmode defines new interval usage codes (IUC) of A-TDMA short data grants, long data grants,and Unsolicited Grant Service (UGS) grants (IUC 9, 10, and 11) to supplement the existing DOCSIS 1.1IUC types.

• Increases the maximum channel capacity for A-TDMA upstreams to 30 Mbps per 6 MHz channel.• A-TDMA and mixed modes of operation provide higher bandwidth on the upstream using new 32-QAMand 64-QAM modulation profiles, while retaining support for existing 16-QAM and QPSK modulationprofiles. In addition, an 8-QAM modulation profile is supported for special applications.

• Supports a minislot size of 1 tick for A-TDMA operations.• Increases channel widths to 6.4 MHz (5.12 Msymbol rate) for A-TDMA operations.• A-TDMA and mixed modes of operation provide a more robust operating environment with increasedprotection against ingress noise and other signal impairments, using a number of new features:

• Uses to a symbol (T)-spaced adaptive equalizer structure to increase the equalizer tap size to 24taps, compared to 8 taps in DOCSIS 1.x mode. This allows operation in the presence of more severemultipath and microreflections, and can accommodate operation near band edges where group delaycould be a problem.

• Supports new QPSK0 and QPSK1 preambles, which provide improved burst acquisition byperforming simultaneous acquisition of carrier and timing lock, power estimates, equalizer training,and constellation phase lock. This allows shorter preambles, reducing implementation loss.

• Increases the forward error correction (FEC) T-byte size to 16 bytes per Reed Solomon block (T=16)with programmable interleaving.

Modes of OperationDepending on the configuration, the DOCSIS 2.0 A-TDMA Service feature supports either DOCSIS orEuro-DOCSIS operation:

• DOCSIS cable networks are based on the ITU J.83 Annex B physical layer standard and Data-over-CableService Interface Specifications (DOCSIS, Annex B) specification, which use 6MHzNational TelevisionSystems Committee (NTSC) channel plans. In this mode, the downstream uses a 6 MHz channel widthin the 85 to 860 MHz frequency range, and the upstream supports multiple channel widths in the 5 to 42MHz frequency range.

• EuroDOCSIS cable networks are based on the ITU J.112 Annex A physical layer standard and EuropeanDOCSIS (EuroDOCSIS, Annex A) specification, which use 8 MHz Phase Alternating Line (PAL) andSysteme Electronique Couleur Avec Memoire (SECAM) channel plans. In this mode, the downstreamuses an 8 MHz channel width in the 85 to 860 MHz frequency range, and the upstream supports multiplechannel widths in the 5 to 65 MHz frequency range.


DOCSIS 2.0 A-TDMA Modulation ProfilesModes of Operation

The difference between DOCSIS and EuroDOCSIS is at the physical layer. To support a DOCSIS orEuroDOCSIS network requires the correct configuration of the DOCSIS 2.0 A-TDMA Service card, as wellas upconverters, diplex filters, and other equipment that supports the network type.

Note

The table below shows the maximum supported DOCSIS 1.1 data rates.

Table 22: Maximum DOCSIS 1.1 Data Rates

Maximum Raw Bit Rate Mbit/secBaud Rate Sym/secModulation SchemeUpstream Channel Width

10.24 5.122.56 M16-QAM QPSK3.2 MHz

5.12 2.561.28 M16-QAM QPSK1.6 MHz

The table below shows the maximum supported DOCSIS 2.0 (A-TDMA-mode) data rates.

Table 23: Maximum DOCSIS 2.0 (A-TDMA-mode) Data Rates

Maximum Raw Bit Rate Mbit/secBaud Rate Sym/secModulation SchemeUpstream Channel Width

30.72

25.60

20.48

15.36

10.24

5.12 M64-QAM

32-QAM

16-QAM

8-QAM

QPSK

6.4 MHz

15.36

12.80

10.24

7.68

5.12

2.56 M64-QAM

32-QAM

16-QAM

8-QAM

QPSK

3.2 MHz

7.68

6.40

5.12

3.84

2.56

1.28 M64-QAM

32-QAM

16-QAM

8-QAM

QPSK

1.6 MHz

Modulation ProfilesTo simplify the administration of A-TDMA and mixed TDMA/A-TDMA modulation profiles, the DOCSIS2.0 A-TDMA Service feature provides a number of preconfigured modulation profiles that are optimized fordifferent modulation schemes. We recommend using these preconfigured profiles.


DOCSIS 2.0 A-TDMA Modulation ProfilesModulation Profiles

Each mode of operation also defines a default modulation profile that is automatically used when a profile isnot specifically assigned to an upstream. The default modulation profiles cannot be deleted. The table belowlists the valid ranges according to cable interface and modulation type:

Table 24: Allowable Ranges for Modulation Profiles

DOCSIS 2.0 (A-TDMA)Mixed DOCSIS 1.X/2.0DOCSIS 1.X (TDMA)Cable Interface

1 to 400 (default 221)1 to 400 (default 121)1 to 400 (default is 21)Cisco cBR-8 CCAP Line Cards

BenefitsThe DOCSIS 2.0 A-TDMA Service feature provides the following benefits to cable service providers andtheir partners and customers:

• Full compatibility with DOCSIS 1.0 and DOCSIS 1.1 cable modems (CMs) and cable modem terminationsystems (CMTS).

• Additional channel capacity in the form of more digital bits of throughput capacity in the upstream path.• Increased protection against electronic impairments that occur in cable systems, allowing for a morerobust operating environment.

How to Configure DOCSIS 2.0 A-TDMA ServicesThis section contains the following:

Creating Modulation ProfilesCisco cable modem termination systems (CMTSs) can handle modulation profiles for the RF configurationof a voice and data cable modem plant. Cisco IOS® Software is designed with a default modulation profilethat is optimal in most conditions. Therefore, do not change the default configuration. However, if themodulation needs are different for the customer plant, Cisco IOS Software has the ability to customize andto configure the modulation profiles to suit the customer needs.

Only an expert, who understands modulation changes and Data-over-Cable Service Interface Specifications(DOCSIS), should modify these parameters. Otherwise, changes can cause disruption or the degradation ofservices because the commands affect the physical layer.

This section describes how to create modulation profiles for the different modes of DOCSIS operations, usingthe preconfigured modulation profile options.

Caution

Creating a TDMA Modulation ProfileThis section describes how to create a modulation profile for the DOCSIS 1.0/DOCSIS 1.1 TDMA mode ofoperation, using one of the preconfigured modulation profiles.


DOCSIS 2.0 A-TDMA Modulation ProfilesBenefits

Procedure



enable

Example:

Step 1

Router> enable


Example:

Step 2


Creates a preconfigured modulation profile, where the burstparameters are set to their default values for each burst type:

cable modulation-profile profile tdma {mix | qam-16 |qpsk | robust-mix}

Step 3

Example: You can also create custom modulation profileswith the cable modulation-profile commandby configuring the values for the individual burstparameters. These parameters, however, shouldnot be modified unless you are thoroughlyfamiliar with how changing each parameteraffects the DOCSISMAC layer.We recommendusing the preconfigured default modulationprofiles for most cable plants.

Note

Router(config)# cable modulation-profile 3 tdmamixRouter(config)# cable modulation-profile 4 tdmaqpsk


Example:

Step 4


Creating a Mixed Mode Modulation ProfileThis section describes how to create a modulation profile for the mixed TDMA/A-TDMAmode of operation,using one of the preconfigured modulation profiles.

Procedure





Example:

Step 2


Creates a preconfigured modulation profile, where the burstparameters are set to their default values for each burst type:

cable modulation-profile profile mixed {mix-high |mix-low | mix-mid | mix-qam | qam-16 | qpsk |robust-mix-high | robust-mix-mid | robust-mix-qam}

Step 3


DOCSIS 2.0 A-TDMA Modulation ProfilesCreating a Mixed Mode Modulation Profile


Example: The robust-mix profiles are similar to but morerobust than the mix profiles, so that they aremore able to deal with noise on the upstream.

Note

Router(config)# cable modulation-profile 143 mixedmix-mediumRouter(config)# cable modulation-profile 144 mixedmix-high You can also create custom modulation profiles

with the cable modulation-profile commandby configuring the values for the individual burstparameters. These parameters, however, shouldnot be modified unless you are thoroughlyfamiliar with how changing each parameteraffects the DOCSISMAC layer.We recommendusing the preconfigured default modulationprofiles for most cable plants.

Note


Example:

Step 4


Creating an A-TDMA Modulation ProfileThis section describes how to create a modulation profile for the DOCSIS 2.0 A-TDMA mode of operation,using one of the preconfigured modulation profiles.

Procedure



enable

Example:

Step 1

Router> enable


Example:

Step 2


cable modulation-profile profile atdma {mix-high |mix-low | mix-mid | mix-qam | qam-8 | qam-16 | qam-32

Step 3 For Cisco Remote PHY 220, preamble withQPSK modulation must have values—32x2^n(0, 1, 2, 3) bits.

Preamble with 16-QAM modulation must havevalues—64x2^n (0, 1, 2,) bits.

Note

| qam-64 | qpsk | robust-mix-high | robust-mix-low |robust-mix-mid}

Example:Router(config)# cable modulation-profile 242 atdmaqam-32 The robust-mix profiles are similar to but more

robust than the mix profiles, so that they aremore able to deal with noise on the upstream.

NoteRouter(config)# cable modulation-profile 243 atdmaqam-64

Example:


DOCSIS 2.0 A-TDMA Modulation ProfilesCreating an A-TDMA Modulation Profile

PurposeCommand or Actioncable modulation-profile 45 tdma request 0 16 0 22qpsk scrambler 152 no-diff 64 fixed

You can also create custom modulation profileswith the cable modulation-profile commandby configuring the values for the individual burstparameters. These parameters, however, shouldnot be modified unless you are thoroughlyfamiliar with how changing each parameteraffects the DOCSISMAC layer.We recommendusing the preconfigured default modulationprofiles for most cable plants.

Note

cable modulation-profile 45 tdma initial 5 34 0 4816qam scrambler 152 no-diff 256 fixedcable modulation-profile 45 tdma station 5 34 0 4816qam scrambler 152 no-diff 256 fixedcable modulation-profile 45 tdma short 3 76 12 2216qam scrambler 152 no-diff 128 shortenedcable modulation-profile 45 tdma long 9 232 0 2216qam scrambler 152 no-diff 128 shortened

cable modulation-profile 45 tdma initial 5 34 0 4816qam scrambler 152 no-diff 256 fixed

For Cisco Remote PHY 220, preamble withQPSK modulation must have values—32x2^n(0, 1, 2, 3) bits.

Preamble with 16-QAM modulation must havevalues—64x2^n (0, 1, 2,) bits.

Note


Example:

Step 4


Configuring the DOCSIS Mode and Profile on an UpstreamThis section describes how to configure an upstream for a DOCSIS mode of operation, and then to assign aparticular modulation profile to that upstream.

By default, all upstreams are configured for ATDMA-only mode, using the default modulation profile.Note

Procedure



enable

Example:

Step 1

Router> enable


Example:

Step 2


Enters controller configuration mode for the interface.controller upstream-Cable slot/subslot/port

Example:

Step 3

Router(config)# controller upstream-Cable 2/0/1


DOCSIS 2.0 A-TDMA Modulation ProfilesConfiguring the DOCSIS Mode and Profile on an Upstream


Configures the upstream for the desired DOCSIS mode ofoperation.

us-channel n docsis-mode {atdma | tdma | tdma-atdma}

Example:

Step 4

Router(config-controller)# us-channel 0 docsis-modeatdma

Assigns up to three modulation profiles to the upstreamport.

us-channel n modulation-profile primary-profile-number[secondary-profile-number] [tertiary-profile-number]

Step 5

Example: The type of modulation profiles must match theDOCSIS mode configured for the upstream,using the us-channel docsis-mode command.

Note

Router(config-controller)# us-channel 0modulation-profile 241

(Optional) Enables the use of a DOCSIS pre-equalizationcoefficient on the upstream port.

us-channel n equalization-coefficient

Example:

Step 6

Router(config-controller)# us-channel 0equalization-coefficient

(Optional) Configures the interval, in milliseconds, forwhich the interface card should sample the signal on an

us-channel n ingress-noise-cancellation interval

Example:

Step 7

upstream to correct any ingress noise that has appeared onthat upstream.Router(config-controller)# us-channel 0

ingress-noise-cancellation 400

(Optional) Requires DOCSIS 2.0 cable modems that areoperating on an ATDMA-only upstream to maintain a

us-channel n maintain-psd

Example:

Step 8

constant power spectral density (PSD) after a modulationrate change.Router(config-controller)# us-channel 0

maintain-psdRepeat Step 3, on page 151 through Step 8, onpage 152 for each upstream to be configured.

Note

Exits controller configurationmode and returns to privilegedEXEC mode.

end

Example:

Step 9


Monitoring the DOCSIS 2.0 A-TDMA ServicesThis section contains the following:

Displaying Modulation ProfilesTo display the modulation profiles that are currently defined on the CMTS, use the show cablemodulation-profile command without any options:Router# show cable modulation-profile

Mod Docsis IUC Type Pre Diff FEC FEC Scrmb Max Guard Last Scrmb Pre Pre RS-Mode len enco T k seed B time CW offst Type


DOCSIS 2.0 A-TDMA Modulation ProfilesMonitoring the DOCSIS 2.0 A-TDMA Services

BYTE BYTE siz size short1 atdma request 16qam 32 no 0x0 0x10 0x152 0 22 no yes 0 qpsk1 no1 atdma initial 16qam 64 no 0x5 0x22 0x152 0 48 no yes 0 qpsk1 no1 atdma station 16qam 64 no 0x5 0x22 0x152 0 48 no yes 0 qpsk1 no1 atdma a-short 16qam 64 no 0x4 0x4C 0x152 7 22 yes yes 0 qpsk1 no1 atdma a-long 16qam 64 no 0x9 0xE8 0x152 0 22 yes yes 0 qpsk1 no1 atdma a-ugs 16qam 64 no 0x9 0xE8 0x152 0 22 yes yes 0 qpsk1 no2 atdma request 16qam 32 no 0x0 0x10 0x152 0 22 no yes 0 qpsk1 no2 atdma initial 16qam 64 no 0x5 0x22 0x152 0 48 no yes 0 qpsk1 no2 atdma station 16qam 64 no 0x5 0x22 0x152 0 48 no yes 0 qpsk1 no2 atdma a-short 16qam 64 no 0x4 0x4C 0x152 7 22 yes yes 0 qpsk1 no2 atdma a-long 16qam 64 no 0x9 0xE8 0x152 0 22 yes yes 0 qpsk1 no2 atdma a-ugs 16qam 64 no 0x9 0xE8 0x152 0 22 yes yes 0 qpsk1 no21 tdma request qpsk 36 no 0x0 0x10 0x152 0 22 no yes 0 qpsk na21 tdma initial qpsk 98 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na21 tdma station qpsk 98 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na21 tdma short qpsk 64 no 0x3 0x4C 0x152 12 22 yes yes 0 qpsk na21 tdma long qpsk 64 no 0x9 0xE8 0x152 0 22 yes yes 0 qpsk na121 mixed request qpsk 36 no 0x0 0x10 0x152 0 22 no yes 0 qpsk na121 mixed initial qpsk 98 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na121 mixed station qpsk 98 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na121 mixed short qpsk 64 no 0x3 0x4C 0x152 12 22 yes yes 0 qpsk na121 mixed long qpsk 64 no 0x9 0xE8 0x152 0 22 yes yes 0 qpsk na121 mixed a-short 64qam 64 no 0x6 0x4C 0x152 6 22 yes yes 0 qpsk1 no121 mixed a-long 64qam 64 no 0x9 0xE8 0x152 0 22 yes yes 0 qpsk1 no121 mixed a-ugs 64qam 64 no 0x9 0xE8 0x152 0 22 yes yes 0 qpsk1 no221 atdma request qpsk 36 no 0x0 0x10 0x152 0 22 no yes 0 qpsk0 no221 atdma initial qpsk 98 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 no221 atdma station qpsk 98 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 no221 atdma a-short 64qam 64 no 0x6 0x4C 0x152 6 22 yes yes 0 qpsk1 no221 atdma a-long 64qam 64 no 0x9 0xE8 0x152 0 22 yes yes 0 qpsk1 no

To display a specific modulation profile in detail, specify the profile number with the show cablemodulation-profile command:Router# show cable modulation-profile 221

Mod Docsis IUC Type Pre Diff FEC FEC Scrmb Max Guard Last Scrmb Pre Pre RS-Mode len enco T k seed B time CW offst Type

BYTE BYTE siz size short221 atdma request qpsk 36 no 0x0 0x10 0x152 0 22 no yes 0 qpsk0 no221 atdma initial qpsk 98 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 no221 atdma station qpsk 98 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 no221 atdma a-short 64qam 64 no 0x6 0x4C 0x152 6 22 yes yes 0 qpsk1 no221 atdma a-long 64qam 64 no 0x9 0xE8 0x152 0 22 yes yes 0 qpsk1 no221 atdma a-ugs 64qam 64 no 0x9 0xE8 0x152 0 22 yes yes 0 qpsk1 no

Displaying Cable Modem Capabilities and ProvisioningTo display the capabilities of the online cable modems and how the modems were provisioned, use the showcable modem mac command:Router# show cable modem mac

MAC Address MAC Prim Ver QoS Frag Concat PHS Priv DS USState Sid Prov Saids Sids

1859.334d.7b4c init(i) 145 DOC1.0 DOC1.0 no no no 0 01859.334d.fa8c offline 146 DOC1.0 DOC1.0 no no no 0 01859.334d.fa02 offline 147 DOC1.0 DOC1.0 no no no 0 01859.334d.65b0 online(pt) 148 DOC3.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.6622 offline 149 DOC1.0 DOC1.0 no no no 0 0


DOCSIS 2.0 A-TDMA Modulation ProfilesDisplaying Cable Modem Capabilities and Provisioning

1859.334d.7a50 init(i) 150 DOC1.0 DOC1.0 no no no 0 01859.334d.7a2e offline 151 DOC1.0 DOC1.0 no no no 0 01859.334d.7d14 online(pt) 152 DOC2.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.6636 online(pt) 153 DOC2.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.7cf0 online(pt) 154 DOC2.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.6742 online(pt) 155 DOC2.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.7b2a online(pt) 156 DOC2.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.7e64 online(pt) 157 DOC2.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.ede0 online(pt) 158 DOC2.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.7b8a online(pt) 159 DOC2.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.6604 online(pt) 160 DOC2.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.f93a online(pt) 161 DOC2.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.7bf0 online(pt) 162 DOC2.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.596a online(pt) 163 DOC2.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.7d38 online(pt) 164 DOC2.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.fc64 online(pt) 165 DOC2.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.6434 online(pt) 166 DOC2.0 DOC1.1 yes yes yes BPI+ 15 161859.334d.f62a online(pt) 167 DOC2.0 DOC1.1 yes yes yes BPI+ 15 16!

To display how many cable modems of each DOCSIS type are online each upstream, use the show cablemodem mac summary command:Router# show cable modem mac summary

Cable Modem Summary-------------------

Mac Version QoS Provision ModeInterface Total DOC3.0 DOC2.0 DOC1.1 DOC1.0 Reg/Online DOC1.1 DOC1.0Cable3/0/1/U0 20 0 5 0 15 5 5 0Cable3/0/1/U1 23 0 9 0 14 9 9 0Cable3/0/1/U2 21 0 8 0 13 8 8 0Cable3/0/1/U4 42 0 9 0 33 9 9 0Cable3/0/1/U5 20 0 15 0 5 15 15 0Cable3/0/1/U6 18 1 14 0 3 15 15 0Cable3/0/2/U0 26 0 26 0 0 26 26 0Cable3/0/2/U1 28 0 28 0 0 28 28 0Cable3/0/2/U2 24 0 24 0 0 24 24 0Cable3/0/2/U4 72 0 72 0 0 72 72 0Cable3/0/3/U0 67 0 63 0 4 63 63 0Cable3/0/3/U1 85 1 84 0 0 85 85 0Cable3/0/3/U2 1 0 1 0 0 1 1 0Cable3/0/4/U0 12 0 1 0 11 1 1 0Cable3/0/4/U1 39 0 0 0 39 0 0 0Cable3/0/4/U2 12 0 1 0 11 1 1 0Cable3/0/4/U4 65 0 11 0 54 11 11 0Cable3/0/4/U5 10 0 10 0 0 10 10 0Cable3/0/4/U6 5 0 5 0 0 5 5 0Cable3/0/5/U0 27 0 27 0 0 27 27 0Cable3/0/5/U1 27 0 27 0 0 27 27 0Cable3/0/5/U2 26 0 26 0 0 26 26 0Cable3/0/5/U4 77 0 77 0 0 77 77 0Cable3/0/6/U4 14 14 0 0 0 14 14 0Cable3/0/6/U5 12 12 0 0 0 12 12 0Cable3/0/6/U6 5 5 0 0 0 5 5 0

Configuration Examples for DOCSIS 2.0 A-TDMA servicesThis section contains the following:


DOCSIS 2.0 A-TDMA Modulation ProfilesConfiguration Examples for DOCSIS 2.0 A-TDMA services

Creating Modulation Profiles ExamplesThis section contains the following:

Example: DOCSIS 1.0/DOCSIS 1.1 TDMA Modulation ProfilesThe following sample configurations show typical modulation profiles for the DOCSIS 1.0/DOCSIS 1.1TDMA mode of operation:

• Profile 21 is the default profile for TDMA operations.• Profiles 24 and 25 use the preconfigured 16-QAM and QPSK modulation profiles.• Profile 26 is a typical QPSK modulation profile using some customized burst parameters.

cable modulation-profile 24 tdma qam-16cable modulation-profile 25 tdma qpskcable modulation-profile 26 tdma request 0 16 0 8 qpsk scrambler 152 no-diff 68 fixedcable modulation-profile 26 tdma initial 5 34 0 48 qpsk scrambler 152 no-diff 128 fixedcable modulation-profile 26 tdma station 5 34 0 48 qpsk scrambler 152 no-diff 128 fixedcable modulation-profile 26 tdma short 4 76 12 8 qpsk scrambler 152 no-diff 80 shortenedcable modulation-profile 26 tdma long 8 236 0 8 qpsk scrambler 152 no-diff 80 shortened

Example: Mixed TDMA/A-TDMA Modulation ProfilesThe following sample configurations show typical modulation profiles for the DOCSIS 1.X/DOCSIS 2.0mixed TDMA/A-TDMA mode of operation:

• Profile 121 is the default profile for mixed mode operations.• Profiles 122 through 126 use the preconfigured mixed mode modulation profiles.• Profile 127 is a typical mixed mode modulation profile some customized burst parameters.

cable modulation-profile 121 mixed request 0 16 0 8 qpsk scrambler 152 no-diff 64 fixedcable modulation-profile 121 mixed initial 5 34 0 48 qpsk scrambler 152 no-diff 32 fixedcable modulation-profile 121 mixed station 5 34 0 48 qpsk scrambler 152 no-diff 32 fixedcable modulation-profile 121 mixed short 5 75 6 8 qpsk scrambler 152 no-diff 72 shortenedcable modulation-profile 121 mixed long 8 220 0 8 qpsk scrambler 152 no-diff 80 shortenedcable modulation-profile 121 mixed a-short 0 16 15 99 64qam scrambler 152 no-diff 128shortened qpsk0 0 18cable modulation-profile 121 mixed a-long 0 16 15 200 64qam scrambler 152 no-diff 128shortened qpsk0 0 18

cable modulation-profile 122 mixed mix-highcable modulation-profile 123 mixed mix-lowcable modulation-profile 124 mixed mix-mediumcable modulation-profile 125 mixed qam-16cable modulation-profile 126 mixed qpsk

cable modulation-profile 127 mixed request 0 16 0 8 qpsk scrambler 152 no-diff 68 fixedcable modulation-profile 127 mixed initial 5 34 0 48 qpsk scrambler 152 no-diff 128 fixedcable modulation-profile 127 mixed station 5 34 0 48 qpsk scrambler 152 no-diff 128 fixedcable modulation-profile 127 mixed short 6 76 7 8 16qam scrambler 152 no-diff 160 shortened

cable modulation-profile 127 mixed long 8 231 0 8 16qam scrambler 152 no-diff 160 shortened

cable modulation-profile 127 mixed a-short 9 76 6 8 32qam scrambler 152 no-diff 160 shortenedqpsk1 1 2048cable modulation-profile 127 mixed a-long 12 231 0 8 64qam scrambler 152 no-diff 132 shortenedqpsk1 1 2048


DOCSIS 2.0 A-TDMA Modulation ProfilesCreating Modulation Profiles Examples

Example: DOCSIS 2.0 A-TDMA Modulation ProfilesThe following sample configurations show typical modulation profiles for the DOCSIS 2.0 A-TDMA modeof operation:

• Profile 221 is the default profile for A-TDMA mode operations.• Profiles 222 through 226 use the preconfigured A-TDMA mode modulation profiles.• Profile 227 is a typical A-TDMA mode modulation profile customized burst parameters.

cable modulation-profile 221 atdma request 0 16 0 8 qpsk scrambler 152 no-diff 64 fixedqpsk0 0 18cable modulation-profile 221 atdma initial 5 34 0 48 qpsk scrambler 152 no-diff 32 fixedqpsk0 0 18cable modulation-profile 221 atdma station 5 34 0 48 qpsk scrambler 152 no-diff 32 fixedqpsk0 0 18cable modulation-profile 221 atdma short 5 75 6 8 qpsk scrambler 152 no-diff 72 shortenedqpsk0 0 18cable modulation-profile 221 atdma long 8 220 0 8 qpsk scrambler 152 no-diff 80 shortenedqpsk0 0 18cable modulation-profile 221 atdma a-short 5 99 10 8 64qam scrambler 152 no-diff 128 shortenedqpsk0 0 18cable modulation-profile 221 atdma a-long 15 200 0 8 64qam scrambler 152 no-diff 128 shortenedqpsk0 0 18

cable modulation-profile 222 atdma qam-8cable modulation-profile 223 atdma qam-16cable modulation-profile 224 atdma qam-32cable modulation-profile 225 atdma qam-64cable modulation-profile 226 atdma qpsk

cable modulation-profile 227 atdma request 0 16 0 8 qpsk scrambler 152 no-diff 68 fixedqpsk0 1 2048cable modulation-profile 227 atdma initial 0 16 0 0 qpsk no-scrambler no-diff 2 fixed qpsk10 18cable modulation-profile 227 atdma station 5 34 0 48 qpsk scrambler 152 no-diff 128 fixedqpsk0 1 2048cable modulation-profile 227 atdma a-short 9 76 6 8 32qam scrambler 152 no-diff 160 shortenedqpsk1 1 2048cable modulation-profile 227 atdma a-long 12 231 0 8 64qam scrambler 152 no-diff 132 shortenedqpsk1 1 2048cable modulation-profile 227 atdma a-ugs 3 231 0 8 16qam scrambler 152 no-diff 80 shortenedqpsk1 1 2048

Assigning Modulation Profiles to Upstreams ExamplesThis section contains the following:

Example: Assigning DOCSIS 1.0/DOCSIS 1.1 TDMA Modulation ProfilesThe following sample configuration shows DOCSIS 1.0/DOCSIS 1.1 TDMA modulation profiles beingassigned to the upstreams. The TDMA modulation profile (profile 21) is assigned to the upstream controller2/0/0.controller Upstream-Cable 2/0/0us-channel 0 channel-width 1600000 1600000us-channel 0 docsis-mode tdmaus-channel 0 minislot-size 4us-channel 0 modulation-profile 21no us-channel 0 shutdown


DOCSIS 2.0 A-TDMA Modulation ProfilesExample: DOCSIS 2.0 A-TDMA Modulation Profiles

us-channel 1 channel-width 1600000 1600000us-channel 1 docsis-mode tdmaus-channel 1 minislot-size 4us-channel 1 modulation-profile 21no us-channel 1 shutdownus-channel 2 channel-width 1600000 1600000us-channel 2 docsis-mode tdmaus-channel 2 minislot-size 4us-channel 2 modulation-profile 21no us-channel 2 shutdownus-channel 3 channel-width 1600000 1600000us-channel 3 docsis-mode tdmaus-channel 3 minislot-size 4us-channel 3 modulation-profile 21no us-channel 3 shutdown!

Example: Assigning Mixed TDMA/A-TDMA Modulation ProfilesThe following sample configuration showsmixedmode TDMA/A-TDMAmodulation profiles being assignedto the upstreams. The mixed modulation profile (profile 121) is assigned to the upstream controller 2/0/15.controller Upstream-Cable 2/0/15us-channel 0 channel-width 1600000 1600000us-channel 0 docsis-mode tdma-atdmaus-channel 0 minislot-size 4us-channel 0 modulation-profile 121no us-channel 0 shutdownus-channel 1 channel-width 1600000 1600000us-channel 1 docsis-mode tdma-atdmaus-channel 1 minislot-size 4us-channel 1 modulation-profile 121no us-channel 1 shutdownus-channel 2 channel-width 1600000 1600000us-channel 2 docsis-mode tdma-atdmaus-channel 2 minislot-size 4us-channel 2 modulation-profile 121no us-channel 2 shutdownus-channel 3 channel-width 1600000 1600000us-channel 3 docsis-mode tdma-atdmaus-channel 3 minislot-size 4us-channel 3 modulation-profile 121no us-channel 3 shutdown!

Example: Assigning DOCSIS 2.0 A-TDMA Modulation ProfilesThe following sample configuration shows DOCSIS 2.0 A-TDMA modulation profiles being assigned to theupstreams. The A-TDMA modulation profile (profile 221) is assigned to the upstream controller 2/0/10.controller Upstream-Cable 2/0/10us-channel 0 channel-width 1600000 1600000us-channel 0 docsis-mode atdmaus-channel 0 minislot-size 4us-channel 0 modulation-profile 221no us-channel 0 shutdownus-channel 1 channel-width 1600000 1600000us-channel 1 docsis-mode atdmaus-channel 1 minislot-size 4us-channel 1 modulation-profile 221no us-channel 1 shutdownus-channel 2 channel-width 1600000 1600000


DOCSIS 2.0 A-TDMA Modulation ProfilesExample: Assigning Mixed TDMA/A-TDMA Modulation Profiles

us-channel 2 docsis-mode atdmaus-channel 2 minislot-size 4us-channel 2 modulation-profile 221no us-channel 2 shutdownus-channel 3 channel-width 1600000 1600000us-channel 3 docsis-mode atdmaus-channel 3 minislot-size 4us-channel 3 modulation-profile 221no us-channel 3 shutdownus-channel 4 channel-width 1600000 1600000us-channel 4 docsis-mode atdmaus-channel 4 minislot-size 4us-channel 4 modulation-profile 221us-channel 4 shutdownus-channel 5 channel-width 1600000 1600000us-channel 5 docsis-mode atdmaus-channel 5 minislot-size 4us-channel 5 modulation-profile 221us-channel 5 shutdown!

Additional ReferencesRelated Documents

Document TitleRelated Topic

Cisco IOS CMTS Cable Command Reference


CiscoCMTSCommands

Standards

TitleStandards

Data-over-Cable Service Interface Specifications Radio Frequency InterfaceSpecification, version 1.1

SP-RFIv1.1-I09-020830


SP-RFIv2.0-I03-021218

Data-over-Cable Service Interface Specifications Operations Support SystemInterface Specification, version 2.0

SP-OSSIv2.0-I03-021218

Data-over-Cable Service Interface Specifications Baseline Privacy Plus InterfaceSpecification, version 2.0

SP-BPI+-I09-020830

DOCSIS OSSI Objects SupportRFC 2233

DOCSIS Ethernet MIB Objects SupportRFC 2665

Cable Device MIBRFC 2669


DOCSIS 2.0 A-TDMA Modulation ProfilesAdditional References


MIBs

MIBs LinkMIBs

To locate and download MIBs for selected platforms, CiscoIOS releases, and feature sets, use Cisco MIB Locator foundat the following URL:

http://www.cisco.com/go/mibs

• DOCS-BPI-PLUS-MIB• DOCS-CABLE-DEVICE-MIB (RFC2669)

• DOCS-CABLE-DEVICE-TRAP-MIB• DOCS-IF-EXT-MIB• DOCS-IF-MIB (RFC 2670)• DOCS-QOS-MIB• DOCS-SUBMGT-MIB• IGMP-STD-MIB (RFC 2933)

Technical Assistance

LinkDescription




Feature Information for DOCSIS 2.0 A-TDMA Modulation ProfileUse Cisco Feature Navigator to find information about the platform support and software image support.Cisco Feature Navigator enables you to determine which software images support a specific software release,feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An accounton the Cisco.com page is not required.


Note

Table 25: Feature Information for DOCSIS 2.0 A-TDMA Modulation Profile


This feature was integrated on the cisco cBRSeries Converged Broadband Routers.

Cisco IOS XE Fuji16.7.1

DOCSIS 2.0 A-TDMAModulation Profile


DOCSIS 2.0 A-TDMA Modulation ProfilesFeature Information for DOCSIS 2.0 A-TDMA Modulation Profile

http://www.cisco.com/go/mibs




DOCSIS 2.0 A-TDMA Modulation ProfilesFeature Information for DOCSIS 2.0 A-TDMA Modulation Profile

C H A P T E R 9Downstream Resiliency Bonding Group

With more wideband (WB) modems being deployed in cable plants, WB modem resiliency is an importantfeature. When a comparatively smaller number of cable modems (CMs) observe an impairment on an RFchannel, that RF channel stops working. It impacts all the CM using that RF channel, irrespective of whetherthey reported the impairment on that RF channel. Instead, the solution should be to communicate with theaffected cable modems using the good RF channel, without affecting the other cable modems.

The DownstreamResiliency Bonding Group feature allows cable modemswith multiple impaired RF channelsto be allocated to a dynamically-created wideband interface, which ensures that the performance of thewideband cable modems is not drastically affected.



Contents

• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 162• Prerequisites for Downstream Resiliency Bonding Group, on page 163• Restrictions for the Downstream Resiliency Bonding Group, on page 163• Information About Downstream Resiliency Bonding Group, on page 164• How to Configure Downstream Resiliency Bonding Group, on page 165• Verifying Downstream Resiliency Bonding Group Configuration, on page 167• Troubleshooting the Downstream Resiliency Bonding Group Configuration, on page 171• Configuration Examples for the Downstream Resiliency Bonding Group, on page 172• Additional References, on page 175• Feature Information for Downstream Resiliency Bonding Group, on page 176






Note













Digital PICs:


•














Downstream Resiliency Bonding GroupHardware Compatibility Matrix for the Cisco cBR Series Routers

Prerequisites for Downstream Resiliency Bonding Group• Set aside WB interfaces so that new WB interfaces can be dynamically created from the reserved list ofWB interfaces.

• Free up RF bandwidth so that those RF channels can be added to a resiliency bonding group (RBG).

• Remove all existing RBG configuration from the WB interface.

Restrictions for the Downstream Resiliency Bonding Group• If an existing wideband interface is reserved as a Resiliency Bonding Group (RBG) and later the RBGis removed (through the no cable ds-resiliency command), the modems using this RBG go offline andthe RBG configuration itself is deleted. Therefore, it is highly recommended that users should notconfigure an existing BG as an RBG.

• This feature is enabled only when the number of cable modems observing an RF channel impairment isbelow the resiliency threshold. If the number of cable modems on an impaired RF channel is above theresiliency threshold, the impaired RF channel is temporarily removed from the bonding group.

• A cable modem is assigned to an RBG on a first-come-first-served basis. To handle this feature optimally,it is recommended to set aside more WB interfaces and RF channel bandwidth.

• The Cisco CMTS controls the freeing of unused RBGs, when there is no modem using the RGB. Thefreeing of the unused RGB may take some time and the RGB, which is not completely free cannot beused by the modems. Irrespective of the number of configured RBGs, if all the old RBGs are notcompletely set free and if the Cisco CMTS tries to move the cable modem to a new RBG, the CiscoCMTS moves the cable modem to the primary DS channel instead of RBG.

• Only SFs on the WB interface associated with the primary SF are moved to an RBG. SFs on otherinterfaces will not be moved.

• Static SFs are assigned to an RBG on a best effort quality of service (QoS).

• If the resiliency rf-change-trigger setting does not have the secondary keyword set, only the primarySF is moved to the RBG or a NB interface.

• If the Downstream Resiliency Bonding Group feature is not enabled to use an RBG, only cable modemswith impairments on the primary WB interface are moved to the NB interface.

• SFs carrying multicast traffic are not moved.

There may not be enough reserved bonding groups to support all modems facing an impairment at any giventime thus the following restrictions must be considered:

• Each RBG has at least two RF channels.

• RBG RF assignments are always a subset of the RF channel assignment of the parent WB interface.

• If an RBG is unavailable for a cable modem, the SF of the CM is moved to a NB interface.

• If a high percentage of cable modems experience an RF impairment and there are no more availablebonding group IDs, the impaired RF itself may be removed from the bonding group. Removal of an


Downstream Resiliency Bonding GroupPrerequisites for Downstream Resiliency Bonding Group

impaired RF from a parent bonding group is also reflected in the RBG. If an RBG drops to a single RF,all SFs are moved to the NB interface.

The Downstream Resiliency Bonding Group feature has the following cross-functional restrictions:

• All Dynamic service flows, whether they require a committed information rate (CIR) or not, typicallyvoice flows, are created on the NB interface when an RF channel is impaired. Because all SFs assignedto an RBG are best effort only, voice calls may report a quality issue.

• Cable modems participating in the resiliency mode do not take part in load balancing.

• The DownstreamResiliency Bonding Group feature is only supported in the Dynamic Bandwidth Sharing(DBS) mode.

Information About Downstream Resiliency Bonding GroupYou can set aside unused bonding groups as RBGs. Ensure that each RF channel is assigned at least 1% ofthe available bandwidth. Use the cable rf-channel bandwidth-percent command to configure the RF channelbandwidth.

If the bandwidth-percent is set to 100, the Cisco CMTS does not add any RFs to the RBG. In other words,this feature will not be enabled.

Note

The Cisco CMTS controls the assignment and freeing of unused RBGs. If an RF channel is removed from aWB interface, it is also removed from any associated RBGs.

If the wideband interface is in standbymode, the Cisco CMTS does not assign or free up the unused downstreambonding group.

Note

A suspended RF channel is restored for all affected wideband interfaces when a specified number of cablemodems report (via CM-STATUS) that the channel connectivity is restored. TheWidebandModemResiliencyfeature defines the specified number of cable modems as half of the configured count or percentage ofrf-change-trigger, or both. For example, if the count is 20 and the percent is 10, then the number of cablemodems reporting recovery should reduce the count to 10 and the percent to 5 for the suspended RF channelto be restored.

Finding a Best-Fit RBG for the Cable ModemA bonding group is a list of channels that provide a means to identify the channels that are bonded together.The Cisco CMTS assigns a service flow (SF) to an RBG based on the attributes of the SF and the attributesof the individual channels of the bonding group.

In the Downstream Resiliency Bonding Group feature, when a line card receives a CM-STATUS messagefrom the cable modem informing the line card that there is an RF channel impairment, the line card checksfor the number of good RF channels and:

• Moves the cable modem to narrowband mode if there is only one available RF channel.


Downstream Resiliency Bonding GroupInformation About Downstream Resiliency Bonding Group

• Moves the cable modem to wideband mode if the cable modem reports all RF channels are in good state.

• Moves the cable modem to an RBG if there are two or more good RF channels, with at least one RFchannel impaired, and if the Downstream Resiliency Bonding Group feature is enabled.

When the Cisco CMTS receives a message from the line card to move a cable modem to an RBG, the CiscoCMTS attempts to find an existing RBG or creates an RBG that satisfies the impairment.

If two or more RBGs are reserved for the same wideband controller, the Cisco CMTS creates one RBG foreach cable modem.

Note

The Cisco CMTS creates more than one RBG from a parent WB interface if the user has set aside more thanone WB interface as the RBG and the RF bandwidth does not exceed 100%.

Note

If a matching RBG is not found or cannot be created, the Cisco CMTS looks for an RBG with a subset of therequired RF channels and if available, the cable modem is assigned to such an RBG.

However, if no such RBG exists, the Cisco CMTS instructs the line card to move the cable modem to NBmode.

How to Configure Downstream Resiliency Bonding GroupThis section contains the following:

Enabling Downstream Resiliency Bonding Group

Procedure





Example:

Step 2


Specifies the amount of time an event must persist beforeit triggers an action for the reporting CM.

cable rf-change-trigger {percent value | count number}[secondary]

Example:

Step 3

Router(config)# cable rf-change-trigger percent 50count 1 secondary


Downstream Resiliency Bonding GroupHow to Configure Downstream Resiliency Bonding Group


Enables the downstream resiliency bonding group.cable resiliency ds-bonding

Example:

Step 4

Router(config)# cable resiliency ds-bonding

Returns to the global configuration mode.exit

Example:

Step 5


What to do next

The result of using the cable rf-change-trigger command with the cable resiliency ds-bonding commandis different from using only the cable rf-change-trigger command. For more information, see DownstreamResiliency Narrowband Mode Versus Resiliency Bonding Group, on page 168.

Note

Reserving a Resiliency Bonding Group for a Line CardThis section describes reserving a bonding group or a wideband interface for a line card per controller.

When you reserve a resiliency bonding group using the cable ds-resiliency command, the existing bundle andRF channel configurations on the wideband interface will be removed automatically. Other configurationslike admission control, should be removed manually.

After downstream resiliency bonding group is configured, avoid other manual configurations.

Restriction

Procedure





Example:

Step 2


Configures a wideband cable interface.interface wideband-cableslot/subslot/port:wideband-channel

Step 3

Example:Router(config)# interface wideband-cable 1/0/0:7


Downstream Resiliency Bonding GroupReserving a Resiliency Bonding Group for a Line Card


Reserves an individual bonding group or WB interface forusage on a line card, on a per controller basis.

cable ds-resiliency

Example:

Step 4

Router(config-if)# cable ds-resiliency


Example:

Step 5

Router(config-if)# exit

Verifying Downstream Resiliency Bonding Group ConfigurationThis section contains the following:

Verifying the Downstream Resiliency Bonding GroupTo verify if the Downstream Resiliency Bonding Group feature is enabled, use the show cable modemresiliency command as shown in the following example:

Router# show cable modem resiliencyOrig BG Curr BG

I/F MAC Address ID I/F RFs ID I/F RFs------- -------------- ---------------------- ----------------------C7/0/0 0025.2eaf.843e 897 Wi7/0/0:0 4 898 Wi7/0/0:1 3C7/0/0 0025.2eaf.8356 897 Wi7/0/0:0 4 899 Wi7/0/0:2 3C7/0/0 0015.d176.5199 897 Wi7/0/0:0 4 720 In7/0/0:0

The Current BG I/F field indicates whether Downstream Resiliency Bonding Group feature is enabled andif the cable modems are assigned to a WB interface.

Verifying a Reserved Resiliency Bonding GroupTo verify if a BG is reserved for a line card, use the show cable resiliency command as shown in the followingexample:

Router# show cable resiliencyBG Resil BG RF

Resil BG I/F ID State Count Time Ctrl Num------------- ---- -------------- ----- --------------- ----------Wi1/0/0:10 10 FreeWi1/0/0:20 20 FreeWi7/0/0:1 1 Assigned 3 Nov 3 09:55:49 0 0

12

Wi7/0/0:2 2 Assigned 3 Nov 3 09:57:09 0 013


Downstream Resiliency Bonding GroupVerifying Downstream Resiliency Bonding Group Configuration

Downstream Resiliency Narrowband Mode Versus Resiliency Bonding GroupThis section provides the sample outputs when using the cable rf-change-trigger command with the cableresiliency ds-bonding command and using only the cable rf-change-trigger command.

Table 27: Downstream Resiliency Narrowband Mode Versus Resiliency Bonding Group - Scenario 1

Using cable rf-change-trigger command with cableresiliency ds-bonding

(Downstream Resiliency Bonding Group)

Using only cable rf-change-trigger command

(Downstream Resiliency NB Mode)

Effect on

Above ThresholdBelow ThresholdAbove ThresholdBelow Threshold

Remains on the original bondinggroup while the impaireddownstream channels are not usedand are reported as DOWN.

Moves to dynamicbonding group.

Remains on the original bondinggroup while the impaireddownstream channels are notused and are reported as DOWN.

Moves to the primarychannel.

PrimaryService Flow

Remains on the original bondinggroup while the impaireddownstream channels are not usedand are reported as DOWN.

Remains on the originalbonding group.

Remains on the original bondinggroup while the impaireddownstream channels are notused and are reported as DOWN.

Remain on theoriginal WBinterface.

SecondaryService Flows

The following is a sample output for a cable modem when the cable rf-change-trigger command is usedwith the cable resiliency ds-bonding command and the number of cable modems observing an RF channelimpairment is below the resiliency threshold:

Router# show cable modem

DMAC Address IP Address I/F MAC Prim RxPwr Timing Num I

State Sid (dBmv) Offset CPE P0023.be83.1c9e 10.1.11.46 C5/0/0/UB w-online 922 -0.50 1055 0 N0023.be83.1caa 10.1.11.28 C5/0/0/UB w-online 923 0.00 1043 0 N0025.2ecf.f19c 10.1.11.53 C5/0/0/UB w-online 925 0.00 1057 0 N0022.3a30.9fc0 10.1.11.47 C5/0/0/UB w-online 926 0.00 1055 0 N001a.c3ff.e3d4 10.1.11.39 C5/0/0/UB p-online 927 0.00 1307 0 N0023.be83.1c9a 10.1.11.61 C5/0/0/UB w-online 928 0.00 1057 0 N0022.3a30.9fbc 10.1.11.60 C5/0/0/UB p-online 929 -0.50 1055 0 N0023.be83.1c8c 10.1.11.38 C5/0/0/UB w-online 930 0.00 1061 0 N001e.6bfb.1964 10.1.11.63 C5/0/0/UB p-online 931 0.50 1305 0 N0025.2ecf.f196 10.1.11.29 C5/0/0/UB w-online 932 0.00 1057 0 N0025.2ecf.f04e 10.1.11.54 C5/0/0/UB w-online 933 0.00 1054 0 N0022.3a30.9fc8 10.1.11.43 C5/0/0/UB w-online 934 0.00 1056 0 N0025.2ecf.f190 10.1.11.55 C5/0/0/UB w-online 935 0.00 1059 0 N0022.3a30.9fd0 10.1.11.52 C5/0/0/UB p-online 936 0.00 1057 0 N0022.ce97.8268 10.1.11.31 C5/0/0/UB w-online 937 -0.50 1056 0 N0022.ce97.8281 10.1.11.25 C5/0/0/UB w-online 938 0.00 1058 0 N001a.c3ff.e4ce 10.1.11.44 C5/0/0/UB w-online 940 -0.50 1304 0 N0022.ce9c.839e 10.1.11.32 C5/0/0/UB w-online 941 -0.50 1305 0 N0022.cea3.e768 10.1.11.41 C5/0/0/UB w-online 942 -1.00 1305 0 N0022.ce9c.8398 10.1.11.33 C5/0/0/UB w-online 943 0.00 1306 0 N001a.c3ff.e50a 10.1.11.59 C5/0/0/UB w-online 944 0.00 1304 0 N001a.c3ff.e3f8 10.1.11.57 C5/0/0/UB w-online 945 -1.00 1306 0 N001e.6bfb.1a14 10.1.11.37 C5/0/0/UB w-online 946 0.00 1305 0 N


Downstream Resiliency Bonding GroupDownstream Resiliency Narrowband Mode Versus Resiliency Bonding Group

p-online indicates that cable modem has reported NP RF failure and it is in downstream partial service mode.Note

Router# show cable resiliency

BG Resil BG RFResil BG I/F ID State Count Time Ctrl Num------------- ---- -------------- ----- --------------- ----------Wi5/0/0:2 2 Assigned 1 Mar 30 14:46:43 0 0

12

Wi5/0/0:3 3 Assigned 1 Mar 30 14:46:43 0 012

1 0123

Wi5/0/0:4 4 Free 0Wi5/0/0:5 5 Free 0

Router# show cable modem resiliencyOrig BG Curr BG

I/F MAC Address ID I/F RFs ID I/F RFs------- -------------- ---------------------- ----------------------C5/0/0 001a.c3ff.e3d4 258 Wi5/0/0:1 4 259 Wi5/0/0:2 3 <- Dynamic Bonding GroupC5/0/0 0022.3a30.9fbc 257 Wi5/0/0:0 8 260 Wi5/0/0:3 7 <- Dynamic Bonding GroupC5/0/0 001e.6bfb.1964 258 Wi5/0/0:1 4 259 Wi5/0/0:2 3 <- Dynamic Bonding GroupC5/0/0 0022.3a30.9fd0 257 Wi5/0/0:0 8 260 Wi5/0/0:3 7 <- Dynamic Bonding Group

The following is a sample output for a cable modem under the following conditions:

• cable rf-change-trigger command is used with the cable resiliency ds-bonding command

• Number of cable modems observing an RF channel impairment is below the resiliency threshold

• There is no available WB interface for the resiliency bonding group:

Router# show cable modem0025.2ecf.f196 service-flow version

SUMMARY:MAC Address IP Address Host MAC Prim Num Primary DS

Interface State Sid CPE Downstream RfId0025.2ecf.f196 10.1.11.29 C5/0/0/UB p-online

932 0 In5/0/0:0 240Sfid Dir Curr Sid Sched Prio MaxSusRate MaxBrst MinRsvRate Throughput

State Type1867 US act 932 BE 0 0 10000 0 2941868 DS act N/A N/A 0 0 3044 0 154

Router# show cable resiliencyBG Resil BG RF

Resil BG I/F ID State Count Time Ctrl Num------------- ---- -------------- ----- --------------- ----------Wi5/0/0:2 2 Assigned 6 Mar 30 15:57:09 0 0

1



23

1 023

Wi5/0/0:3 3 Assigned 8 Mar 30 15:53:58 0 012

1 123

Wi5/0/0:4 4 Assigned 2 Mar 30 15:53:58 0 0123

1 123

Wi5/0/0:5 5 Assigned 2 Mar 30 15:58:35 0 0123

1 013

Router# show cable modem resiliency

Orig BG Curr BGI/F MAC Address ID I/F RFs ID I/F RFs------- -------------- ---------------------- ----------------------C5/0/0 0025.2ecf.f19c 257 Wi5/0/0:0 8 259 Wi5/0/0:2 7C5/0/0 0025.2ecf.f196 257 Wi5/0/0:0 8 240 In5/0/0:0 <-- move NB for no availableWB interfaceC5/0/0 0025.2ecf.f04e 257 Wi5/0/0:0 8 262 Wi5/0/0:5 7C5/0/0 0022.3a30.9fbc 257 Wi5/0/0:0 8 260 Wi5/0/0:3 6C5/0/0 0022.3a30.9fd0 257 Wi5/0/0:0 8 261 Wi5/0/0:4 7

Table 28: Downstream Resiliency Narrowband Mode Versus Resiliency Bonding Group - Scenario 2

Using cable rf-change-trigger secondary command withcable resiliency ds-bonding

(Downstream Resiliency Bonding Group)

Using only cable rf-change-trigger secondarycommand

(Downstream Resiliency NB Mode)

Effect on

Above ThresholdBelow ThresholdAbove ThresholdBelow Threshold

Remains on the originalbonding group while theimpaired downstreamchannels are not used and arereported as DOWN.

Moves all service flows toa dynamic bonding group.

Remains on the originalbonding group while theimpaired downstreamchannels are not used andare reported as DOWN.

Moves all service flowsto the primary channel.

Primary ServiceFlow

Secondary ServiceFlows

The following is a sample output for a cable modem when the cable rf-change-trigger secondary commandis used with the cable resiliency ds-bonding command and the number of cable modems observing an RFchannel impairment is below the resiliency threshold:

Router# show cable modem 0025.2ecf.f196 service-flow



SUMMARY:MAC Address IP Address Host MAC Prim Num Primary DS

Interface State Sid CPE Downstream RfId0025.2ecf.f196 10.1.11.29 C5/0/0/UB p-online 955 0 In5/0/0:0 240Sfid Dir Curr Sid Sched Prio MaxSusRate MaxBrst MinRsvRate Throughput

State Type1913 US act 955 BE 0 10000000 10000 0 4251915 US act 956 RTPS 7 0 3044 100000 01916 US act 957 BE 0 0 3044 50000 01917 US act 958 BE 4 0 3044 0 01914 DS act N/A N/A 0 100000000 20000 0 0 <-- PrimaryService-Flow1918 DS act N/A N/A 0 0 3044 0 0 <-- SecondaryService-Flow1919 DS act N/A N/A 0 0 3044 0 0 <-- SecondaryService-Flow1920 DS act N/A N/A 4 4500000 3044 0 0 <-- SecondaryService-FlowUPSTREAM SERVICE FLOW DETAIL:SFID SID Requests Polls Grants Delayed Dropped Packets

Grants Grants1913 955 83 0 83 0 0 921915 956 0 0 0 0 0 01916 957 0 0 0 0 0 01917 958 0 0 0 0 0 0DOWNSTREAM SERVICE FLOW DETAIL:SFID RP_SFID QID Flg Policer Scheduler FrwdIF

Xmits Drops Xmits Drops1914 33210 131555 90 0 6 0 Wi5/0/0:3 <-- DynamicBonding Group1918 33211 131556 0 0 0 0 Wi5/0/0:31919 33212 131557 0 0 0 0 Wi5/0/0:31920 33213 131558 0 0 0 0 Wi5/0/0:3

Troubleshooting the Downstream Resiliency Bonding GroupConfiguration

Use the following commands to get information on the WB interface, number of CMs in an impaired state,resiliency bonding groups, their associated bonding groups, available RF channels, and the number of CMSand service flows assigned to them:

• debug cable wbcmts resiliency

• debug cable wbcmts resiliency report

• show cable resiliency

• show cable modem resiliency

• show cable modem wideband rcs-status

• show cable modem service-flow verbose

• show cable resil-rf-status

• show cable modem summary wb-rfs


Downstream Resiliency Bonding GroupTroubleshooting the Downstream Resiliency Bonding Group Configuration

In case the CPU usage of the downstream resiliency process is high, use following commands to optimize thedownstream resiliency bonding group configuration:

• cable rf-change-up-multiplier value - The default value is 2. Use this command to set the rf-channelup dampen time as an integer multiplier of the rf-channel down dampen time, in order to lengthen therecovery time to keep certain modems from falling back into DOWN state shortly after recovery.

• cable resiliency free-interval seconds - The recommended value is 360. Use this command to set thewait time before a created resiliency bonding group is freed/recycled, in order to hold the resiliencybonding group up long enough for it to be reused by impaired cable modems.

ConfigurationExamplesfortheDownstreamResiliencyBondingGroup

The following is an example of the configuration of the Downstream Resiliency Bonding Group feature:cable rf-change-trigger count 10 secondarycable resiliency ds-bonding!controller Upstream-Cable 9/0/1us-channel 0 frequency 13200000us-channel 0 channel-width 6400000 6400000us-channel 0 power-level -1us-channel 0 docsis-mode atdmaus-channel 0 minislot-size 8us-channel 0 modulation-profile 221no us-channel 0 shutdownus-channel 1 frequency 19600000us-channel 1 channel-width 6400000 6400000us-channel 1 power-level -1us-channel 1 docsis-mode atdmaus-channel 1 minislot-size 8us-channel 1 modulation-profile 221no us-channel 1 shutdownus-channel 2 frequency 26000000us-channel 2 channel-width 6400000 6400000us-channel 2 power-level -1us-channel 2 docsis-mode atdmaus-channel 2 minislot-size 8us-channel 2 modulation-profile 221no us-channel 2 shutdownus-channel 3 frequency 32400000us-channel 3 channel-width 6400000 6400000us-channel 3 power-level -1us-channel 3 docsis-mode atdmaus-channel 3 minislot-size 8us-channel 3 modulation-profile 221no us-channel 3 shutdown!controller Integrated-Cable 9/0/1max-carrier 128base-channel-power 34rf-chan 0type DOCSISfrequency 381000000rf-output NORMALpower-adjust -2docsis-channel-id 1


Downstream Resiliency Bonding GroupConfiguration Examples for the Downstream Resiliency Bonding Group

qam-profile 1rf-chan 1 3type DOCSISfrequency 387000000rf-output NORMALpower-adjust 0docsis-channel-id 2qam-profile 1

rf-chan 32 35type DOCSISfrequency 477000000rf-output NORMALpower-adjust 0docsis-channel-id 33qam-profile 1



!interface Cable9/0/1downstream Integrated-Cable 9/0/1 rf-channel 0-3downstream Integrated-Cable 9/0/1 rf-channel 32-35upstream 0 Upstream-Cable 9/0/1 us-channel 0upstream 1 Upstream-Cable 9/0/1 us-channel 1upstream 2 Upstream-Cable 9/0/1 us-channel 2upstream 3 Upstream-Cable 9/0/1 us-channel 3cable upstream bonding-group 1upstream 0upstream 1upstream 2attributes 80000000

cable upstream bonding-group 2upstream 0upstream 1attributes 80000000



cable upstream bonding-group 5attributes 80000000

cable bundle 1no cable mtc-modecable privacy accept-self-signed-certificateend!interface Integrated-Cable9/0/1:0cable bundle 1cable rf-bandwidth-percent 65



!interface Wideband-Cable9/0/1:0cable bundle 1cable privacy accept-self-signed-certificatecable rf-channels channel-list 0-3 bandwidth-percent 20!interface Integrated-Cable9/0/1:1cable bundle 1cable rf-bandwidth-percent 65!interface Wideband-Cable9/0/1:1cable bundle 1cable privacy accept-self-signed-certificatecable rf-channels channel-list 32-35 bandwidth-percent 20!!interface Wideband-Cable9/0/1:60cable ds-resiliency!interface Wideband-Cable9/0/1:61cable ds-resiliency!interface Wideband-Cable9/0/1:62cable ds-resiliency!

The following is a sample output for the show cable modem command to display impaired cable modemsbelow the resiliency threshold value:Router# show cable modem

MAC Address IP Address I/F MAC Prim RxPwr Timing Num IState Sid (dBmv) Offset CPE P

e448.c70c.96d5 80.17.150.6 C9/0/1/U2 p-online 1 0.00 1784 0 Ne448.c70c.96f3 80.17.150.14 C9/0/1/U1 w-online 2 -1.00 1797 0 N68ee.9633.0699 80.17.150.31 C9/0/1/U0 w-online 3 -1.00 2088 1 Ne448.c70c.96e7 80.17.150.29 C9/0/1/U3 p-online 4 -0.50 1785 0 Ne448.c70c.982b 80.17.150.18 C9/0/1/U2 w-online 5 0.00 1780 0 Ne448.c70c.9804 80.17.150.13 C9/0/1/U3 w-online 6 -0.50 1788 0 Ne448.c70c.9819 80.17.150.30 C9/0/1/U0 w-online 7 -1.00 1782 0 Ne448.c70c.980d 80.17.150.17 C9/0/1/U0 w-online 8 -1.00 1787 0 N

p-online indicates that the cable modem has reported NP RF failure and it is in downstream partial servicemode.

Note

The following is a sample output when RBGs are created:Router# show cable resiliency

BG Resil BG RFResil BG I/F ID State Count Time Ctrl Num------------- ----- -------------- ----- --------------- ----------Wi9/0/1:60 28989 Assigned 1 Jan 9 07:35:08 1 0

12

Wi9/0/1:61 28990 Assigned 1 Jan 9 07:36:54 1 013



Wi9/0/1:62 28991 Free 0

The following is a sample output when cable modems service flows are assigned to RBGs:Router# show cable modem resiliency

Orig BG Curr BGI/F MAC Address ID I/F RFs ID I/F RFs------- -------------- ----------------------- -----------------------C9/0/1 e448.c70c.96d5 28929 Wi9/0/1:0 4 28989 Wi9/0/1:60 3C9/0/1 e448.c70c.96e7 28929 Wi9/0/1:0 4 28990 Wi9/0/1:61 3

The following is a sample output of the show cable modem command when the impaired cable modems haverecovered:Router# show cable modem

MAC Address IP Address I/F MAC Prim RxPwr Timing Num IState Sid (dBmv) Offset CPE P

e448.c70c.96d5 80.17.150.6 C9/0/1/U2 w-online 1 0.00 1784 0 Ne448.c70c.96f3 80.17.150.14 C9/0/1/U1 w-online 2 -1.00 1797 0 N68ee.9633.0699 80.17.150.31 C9/0/1/U0 w-online 3 -1.00 2088 1 Ne448.c70c.96e7 80.17.150.29 C9/0/1/U3 w-online 4 -0.50 1785 0 Ne448.c70c.982b 80.17.150.18 C9/0/1/U2 w-online 5 0.00 1780 0 Ne448.c70c.9804 80.17.150.13 C9/0/1/U3 w-online 6 -0.50 1788 0 Ne448.c70c.9819 80.17.150.30 C9/0/1/U0 w-online 7 -1.00 1782 0 Ne448.c70c.980d 80.17.150.17 C9/0/1/U0 w-online 8 -1.00 1787 0 N

The following is a sample output of the show cable resiliency command when the impaired cable modemshave recovered:Router# show cable resiliency

BG Resil BG RFResil BG I/F ID State Count Time Ctrl Num------------- ----- -------------- ----- --------------- ----------Wi9/0/1:60 28989 Free 1 Jan 9 07:35:08Wi9/0/1:61 28990 Free 1 Jan 9 07:36:54Wi9/0/1:62 28991 Free 0



http://www.cisco.com/c/en/us/td/docs/cable/cmts/cmd_ref/b_cmts_cable_cmd_ref.htmlCisco CMTS Command Reference


Downstream Resiliency Bonding GroupAdditional References



LinkDescription

http://www.cisco.com/cisco/web/support/index.htmlTheCisco Support andDocumentationwebsite providesonline resources to download documentation, software,and tools. Use these resources to install and configurethe software and to troubleshoot and resolve technicalissues with Cisco products and technologies. Access tomost tools on the Cisco Support and Documentationwebsite requires a Cisco.com user ID and password.

Feature Information for Downstream Resiliency Bonding GroupUse Cisco Feature Navigator to find information about the platform support and software image support.Cisco Feature Navigator enables you to determine which software images support a specific software release,feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An accounton the Cisco.com page is not required.


Note

Table 29: Feature Information for Downstream Resiliency Bonding Group


This feature was integrated on the Cisco cBRSeries Converged Broadband Routers.

Cisco IOS XE Fuji 16.7.1DownstreamResiliencyBondingGroup


Cisco IOS XE Gibraltar16.12.1y

Resiliency Bonding GroupEnhancement


Downstream Resiliency Bonding GroupFeature Information for Downstream Resiliency Bonding Group

http://www.cisco.com/cisco/web/support/index.html


C H A P T E R 10Downstream Channel ID Assignment

First Published: April 17, 2015

The DOCSIS downstream channel ID (DCID) is defined as an 8-bit identifier for recognizing a DownstreamChannel within a MAC Domain. All CMTS downstream channels are assigned a DCID by default that maybe subsequently changed by configuration. It is used in most DOCSIS downstream packet headers and itsvalid range is from 1 to 255 (0 is reserved for network management purposes).

All downstream channels in a MAC domain must have a unique DCID within the MAC domain.Note



Contents

• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 177• Information About Downstream Channel ID Assignment on the Cisco CMTS Routers, on page 178• How to Configure Downstream Channel ID Assignment on the Cisco CMTS Routers, on page 181• Additional References, on page 185• Feature Information for Downstream Channel ID Assignment, on page 185



Note
















Digital PICs:


•













Information About Downstream Channel ID Assignment on theCisco CMTS Routers

These are the downstream channel ID assignment features:

• Unique DCIDs are provided for all channels within a single controller by default.


Downstream Channel ID AssignmentInformation About Downstream Channel ID Assignment on the Cisco CMTS Routers

DCID values for downstream channels in the sameMACDomainmust be unique.If a MAC Domain only contains channels from a single controller, the defaultDCID values will be sufficient. If aMACDomain contains channels frommultiplecontrollers, DCID conflicts may be encountered within theMACDomain. DCIDconflicts may be resolved by changing the DCID value of the conflicting channelswithin the controller configuration or by enabling the automatic channel IDassignment feature.

Note

• The default DCID value for each downstream channel within a controller is equivalent to rf-chan numberplus one. For example, the default value for rf-chan 0 is 1, for rf-chan 1 is 2.

Manual Downstream Channel ID AssignmentWhen using the manual DCID provisioning feature, every downstream channel in the system is assigned adefault DCID value equivalent to (controller QAM id + 1). The table below shows the default DCID rangesper downstream controller.

Table 31: Default Downstream Channel IDs Per Slot/Subslot/Controller

9/08/07/06/03/02/01/00/0

1-1281-1281-1281-1281-1281-1281-1281-128DSController0

1-1281-1281-1281-1281-1281-1281-1281-128DSController1

1-1281-1281-1281-1281-1281-1281-1281-128DSController2

1-1281-1281-1281-1281-1281-1281-1281-128DSController3

1-1281-1281-1281-1281-1281-1281-1281-128DSController4

1-1281-1281-1281-1281-1281-1281-1281-128DSController5

1-1281-1281-1281-1281-1281-1281-1281-128DSController6


Downstream Channel ID AssignmentManual Downstream Channel ID Assignment

9/08/07/06/03/02/01/00/0

1-1281-1281-1281-1281-1281-1281-1281-128DSController7

The default DCID value can be replaced with a user configurable value. The configuration is available in thedownstream controller per channel. The current DCID values for the channels within a downstream controllercan be viewed in the dcid column of the show controller Integrated-Cable rf-chan command output. Theexample shows channels with default DCID values. When a DCID value is changed in the configuration, thenew value appears in the output below.

Router#show controllers integrated-Cable 3/0/0 rf-channel 1-127Chan State Admin Frequency Type Annex Mod srate Interleaver dcid power output1 NPRE UP 99000000 DOCSIS B 256 5361 I32-J4 2 37 NORMAL2 NPRE UP 105000000 DOCSIS B 256 5361 I32-J4 3 37 NORMAL3 NPRE UP 111000000 DOCSIS B 256 5361 I32-J4 4 37 NORMAL4 NPRE UP 117000000 DOCSIS B 256 5361 I32-J4 5 37 NORMAL5 NPRE UP 123000000 DOCSIS B 256 5361 I32-J4 6 37 NORMAL6 NPRE UP 129000000 DOCSIS B 256 5361 I32-J4 7 37 NORMAL7 NPRE UP 135000000 DOCSIS B 256 5361 I32-J4 8 37 NORMAL8 NPRE UP 141000000 DOCSIS B 256 5361 I32-J4 9 37 NORMAL9 NPRE UP 147000000 DOCSIS B 256 5361 I32-J4 10 37 NORMAL10 NPRE UP 153000000 DOCSIS B 256 5361 I32-J4 11 37 NORMAL11 NPRE UP 159000000 DOCSIS B 256 5361 I32-J4 12 37 NORMAL12 NPRE UP 165000000 DOCSIS B 256 5361 I32-J4 13 37 NORMAL13 NPRE UP 171000000 DOCSIS B 256 5361 I32-J4 14 37 NORMAL14 NPRE UP 177000000 DOCSIS B 256 5361 I32-J4 15 37 NORMAL15 NPRE UP 183000000 DOCSIS B 256 5361 I32-J4 16 37 NORMAL

Router#

Automatic Downstream Channel ID Assignment on the Cisco CMTS RoutersIt is possible to automatically assign a unique set of downstream channel IDs to meet all DOCSIS requirementsby enabling the Automatic DCID Assignment feature. When enabled, Downstream channel DCIDs will beautomatically assigned when the channels are added to a fiber node and associated with a MAC Domain.Therefore, the use of fiber node configuration is a prerequisite for this feature.

Service Impact

Changing the DOCSIS downstream channel ID causes cable modems to re-register. Cable modems receiveMAC Domain Descriptor (MDD) and Upstream Channel Descriptor (UCD) messages with a changed DCIDin their headers.

• Enabling the automatic DCID assignment displays the following message:

WARNING: Enabling automatic DCID assignment will cause modems to flap and will applyto all fiber nodes on this CMTS.

• Disabling the automatic DCID assignment displays the following message:

WARNING: Disabling automatic DCID assignment will no longer enforce channel-id uniquenessat fiber nodes. Channel ID changes may require manual verification to prevent conflicts.


Downstream Channel ID AssignmentAutomatic Downstream Channel ID Assignment on the Cisco CMTS Routers

• If there is a DCID conflict with another channel in the MAC Domain, the following error message isdisplayed:

ERROR: <slot>/<subslot>/<controller> rf-channel <channel>: The downstream channel idconflicts with interface In<slot>/<subslot>/<controller>:channel. Downstream channelid must be unique in a CGD.

• After automatic DCID assignment is configured, if there is a DCID conflict when a downstream channelthat belongs to a fiber node is added to a MAC Domain, the automatic DCID feature tries to resolve theconflict by assigning another automatic DCID and the following message is displayed:

WARNING: The downstream channel id conflict for <slot>/<subslot>/<controller> rf-channel<channel> was resolved by Automatic DCID Assignment.Please run "interface <md-slot>/<md-subslot>/<md-index>" followed by"<slot>/<subslot>/<controller> rf-channel <channel>" again in order to add the channel.

To add the channel, use this channel grouping domain (CGD) command again:

cable downstream x/y/z rf-channel channel

• If automatic DCID is configured and the channel does not belong to a fiber node, or if automatic DCIDcannot resolve the conflict, the following message is displayed:

WARNING: The downstream channel id conflict for <slot>/<subslot>/<controller> rf-channel<channel> could not be resolved by Automatic DCID Assignment.

To resolve this issue, add the channel to a fiber node.

How to Configure Downstream Channel ID Assignment on theCisco CMTS Routers

The following sections describe how to configure downstream channel ID assignment.

Configuring Manual Downstream Channel ID Assignment

Procedure





Example:

Step 2



Downstream Channel ID AssignmentHow to Configure Downstream Channel ID Assignment on the Cisco CMTS Routers


Enters controller configuration mode for the ChannelGrouping Domain host line card.

interface controller integrated-Cable slot/subslot/port

Example:

Step 3

Router(config)# interface controllerintegrated-Cable 1/0/1

Enters the rf-channel configuration mode.rf-chan downstream QAM IDStep 4

• Alternatively, use the rf-chan starting downstreamQAM ID ending downstream QAM ID command toset the range of downstream channel IDs.

Example:

Router(config-controller)# rf-chan 0

Configures the downstream channel's DCID to the specifiedvalue, for the RF channel.

docsis-channel-id DCID

Example:

Step 5

For the rf-channel range that was configured using therf-chan starting downstream QAM ID ending downstream

Router(config-rf-chan)#docsis-channel-id 1

QAM ID command, the docsis-channel-id DCID commandconfigures the DCIDs for the rf-channels in that range.

Configuring Automatic Downstream Channel ID AssignmentAutomatic DCID assignment should be permanently configured. However, if you need to remove the feature,use the no or default commands.

The no or default form of the command is not written to startup-config file.Note

In this case, the DCIDs are retained as computed for all channels, and are not set to the defaults of the channels.Save the configuration containing the newly-assigned DCIDs to the startup-config file by using the writememory command.

When you enable automatic DCID assignment, any DCID conflict arising due to adding a channel to a MACDomain is resolved automatically.


Downstream Channel ID AssignmentConfiguring Automatic Downstream Channel ID Assignment

• After running the cable downstream-channel-id automatic command in the configuration, manuallyediting the configuration file in an editor to add RF channels to the fiber nodes could cause DCID conflicts.The feature assumes all channels in fiber nodes have unique automatic DCIDs in global configurationmode. If the configuration is manually edited and the feature does not verify the unique DCIDs, theDCIDs of the newly-added channels may conflict with those of the existing channels. To fix any DCIDconflicts, undo and re-apply the global automatic DCID configuration.

Re-applying global automatic DCID configuration is a disruptive operation.Note

To avoid DCID conflicts, edit the configuration to configure the fiber nodes, then run the cabledownstream-channel-id automatic command so all channels have unique automatic DCIDs.

Make additions to the fiber nodes on the Cisco uBR10012 router command line interface with theautomatic DCID configured.

• The cable downstream-channel-id automatic command should not be manually edited in to thestartup-config file, since it does not guarantee unique DCIDs for channels in the fiber node.

Restriction

Procedure





Example:

Step 2


Specifies automatic assignment of the DCIDs by the CiscoCMTS.

cable downstream-channel-id automatic

Example:

Step 3

Router(config)# cable downstream-channel-idautomatic

Example

This example displays the restriction on manually editing configurations:

Router# show run | include automaticcable downstream-channel-id automatic

router# show cable fiber-node 3---------------------------------------------------------------------------------Fiber-Node 3Channel(s) : downstream Integrated-Cable 1/0/2: 0-3, 32-35, 64-67, 96-99Channel ID(s): 1 2 3 4 33 34 35 36 65 66 67 68 97 98 99 100



Upstream-Cable 1/0/2FN Config Status: Configured (status flags = 0x01)MDD Status: ValidRouter#

If you manually edit the startup-config file in an editor to add a downstream controller, for example,1/0/3, it causes a conflict.

Router> configure terminalRouter# cable fiber-node 3Router# downstream integrated-Cable 1/0/3

If this downstream controller is added, the automatic DCID assignment feature automatically resolvesit. However, since the startup-config file was manually edited to add the downstream controller, theautomatic DCID assignment feature is unable to resolve it. This causes a DCID conflict when theedited startup-config file is loaded and invalidates the fiber node.

down Modular-Cable 5/0/0 rf-channel 0DS frequency is not unique.DS channel id is not unique.Warning: D3.0 CMs cannot get w-online with an invalid fiber-node.router#

What to do next

Run the show cable fibernode command to view DCIDs assigned to all the channels in the fiber node.

Router# show cable fiber-node 3Fiber-Node 3Channel(s) : downstream Integrated-Cable 1/0/2: 0-3, 32-35, 64-67,96-99Channel ID(s): 1 2 3 4 33 34 35 36 65 66 67 68 97 9899 100Upstream-Cable 1/0/2FN Config Status: Configured (status flags = 0x01)MDD Status: Valid




LinkDescription

http://www.cisco.com/cisco/web/support/index.htmlThe Cisco Support website provides extensive onlineresources, including documentation and tools fortroubleshooting and resolving technical issues withCisco products and technologies.

To receive security and technical information aboutyour products, you can subscribe to various services,such as the Product Alert Tool (accessed from FieldNotices), the Cisco Technical Services Newsletter, andReally Simple Syndication (RSS) Feeds.

Access to most tools on the Cisco Support websiterequires a Cisco.com user ID and password.

Feature Information for Downstream Channel ID AssignmentUse Cisco Feature Navigator to find information about the platform support and software image support.Cisco Feature Navigator enables you to determine which software images support a specific software release,feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An accounton the Cisco.com page is not required.


Note

Table 32: Feature Information for Downstream Channel ID Assignment


This feature was integrated on the Cisco cBRSeries Converged Broadband Router.


Downstream Channel IDAssignment


Downstream Channel ID AssignmentAdditional References




Downstream Channel ID AssignmentFeature Information for Downstream Channel ID Assignment

C H A P T E R 11Upstream Channel Bonding

The Upstream Channel Bonding (USCB) feature helps cable operators offer higher upstream (US) bandwidthper cable modem (CM) user by combining multiple radio frequency (RF) channels to form a larger bondinggroup at the MAC layer.



Contents

• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 187• Prerequisites for Upstream Channel Bonding , on page 188• Restrictions for Upstream Channel Bonding , on page 188• Information About Upstream Channel Bonding, on page 189• How to Configure Upstream Channel Bonding , on page 198• Configuration Example for Upstream Channel Bonding , on page 213• Verifying the Upstream Channel Bonding Configuration, on page 215• Additional References, on page 216• Feature Information for Upstream Channel Bonding, on page 217



Note
















Digital PICs:


•













Prerequisites for Upstream Channel Bonding• Enable downstream channel bonding before configuring the Upstream Channel Bonding feature on aCisco cable modem termination system (CMTS) router.

• Ensure that the CM is registered in Multiple Receive Channel (MRC) mode before configuring upstreamchannel bonding on a Cisco CMTS router.

• Ensure that the CM is DOCSIS 3.0 certified.

Restrictions for Upstream Channel BondingThe following are the general restrictions for the Upstream Channel Bonding feature:


Upstream Channel BondingPrerequisites for Upstream Channel Bonding

• Only the static bonding groups are supported.

• Only the upstream channels belonging to the same MAC domain can be added to an upstream bondinggroup.

A maximum of 16 upstream channels can be configured for each MAC Domain,which are divided into two groups:


The upstream bonding-group should include all the upstream channels eitherfrom Group 1 or Group 2 only.

Note

• Committed information rate (CIR) oversubscription is not supported on USCB groups.

Cisco CMTS allows oversubscription of the available bandwidth for individual upstream channels.However, oversubscription of bandwidth is not supported for USCB groups.

An individual upstream may get oversubscribed due to static CIR service flows created for voice traffic.This may cause the DOCSIS 3.0 CMs with USCB to come online on single channel US bonding group(also known as default bonding group).

This problem is mainly encountered in the voice deployments using static service flows. It is, therefore,recommended to choose from the following voice deployments such that the CIR is allocated (or released)when a voice call is attempted (or dropped):

1. Dynamic Quality of Service (DQoS) Lite2. Packet Cable (PC) DQoS3. Packet Cable Multimedia (PCMM)

These deployments avoid the individual upstream oversubscription and CMs come online on expectedbonding groups.

Information About Upstream Channel BondingDOCSIS 3.0-based upstream channel bonding is a method for increasing upstream bandwidth up to amaximumof 120 Mbps raw throughput per CM user in a cable communications system that includes a Cisco CMTSrouter and multiple CMs. The upstream channel bonding method enables a CM to transmit data to a CiscoCMTS router on multiple upstream channels simultaneously.

Channel bonding is a method by which smaller bandwidth upstream channels are bonded together to createa larger upstream bonding group in the MAC domain. A MAC domain is a logical sub-component of a CiscoCMTS router and is responsible for implementing all DOCSIS functions on a set of downstream and upstreamchannels.

The Upstream Channel Bonding feature supports upstream traffic in Multiple Transmit Channel (MTC) modefor data and video services as these services require more bandwidth than voice-based services. Voice-basedservices either use the traditional single upstream channel or a single upstream channel bonding groupconfiguration. Any traffic contract that exceeds 30 Mbps requires upstream channel bonding as the physicalcapacity of a single RF channel in DOCSIS cannot exceed 30 Mbps.


Upstream Channel BondingInformation About Upstream Channel Bonding

The Upstream Channel Bonding feature is supported on the Cisco cBR-8 router. Upstream data from thesubscriber comes through the upstream ports (US0-US19) that are automatically configured on the cableinterface line card. The cable interface line card processes the data and sends it across the backplane to theWAN card and out to the Internet.

The table below lists the downstream and upstream frequency supported on the cable interface line card.

Table 34: Downstream and Upstream Frequency

Upstream FrequencyDownstream FrequencyLine Card

The upstream frequency range for the Cisco cBR-8 CCAPline card is from 5 to 85 MHz irrespective of the region andAnnexure configuration.

55-999 MHz1Cisco cBR-8CCAP

1 This frequency range is subjected to the frequency restriction of the attached EQAM device.

Multiple Transmit Channel ModeMultiple Transmit Channel mode is a CM capability that enables CMs to send upstream traffic on multipleupstream channels. You can enable the MTC mode on a cable interface line card:

• MTC mode for all CMs in a MAC domain—The MTC mode for all CMs in a MAC domain is enabledby default on an upstream bonding capable cable interface line card.

Multiple Receive Channel ModeMRC mode is a CM capability that enables CMs to receive downstream traffic on multiple downstreamchannels. The MRC mode is enabled by default on an upstream bonding capable cable interface line card.You can enable or disable the MRC mode in the MAC domain during or after the CM registration using thecable mrc-mode command.

Dynamic Range Window and Transmit Power Levels for Upstream ChannelBonding

The dynamic range window functionality is based on the CableLabs DOCSIS 3.0 MAC and Upper LayerProtocols Interface Specification and DOCSIS 3.0 Specification. This requires a DOCSIS 3.0 CM to haveupstream transmit channel power level within a 12 dB range for all channels in its transmit channel set (TCS).

DOCSIS 1.x or 2.0 CMs operating with a single upstream channel, in non-MTCmode, have a higher maximumtransmit power level than DOCSIS 3.0 CMs operating in theMTCmode with two or more upstream channels.That is, the maximum transmit power level per channel is reduced in the MTC mode.

When the upstream attenuation exceeds the maximum transmit power level, a DOCSIS 3.0 CM attemptingto register in the MTC mode may fail to come online, or register in partial mode. The CM fails to registerwhen the transmit power level of all upstream channels in its TCS exceeds the maximum transmit power level.If the CM has some upstream channels that are within the maximum transmit power level, the CMmay comeonline in partial mode. However, the upstream channels that exceed the maximum transmit power level aremarked as down and cannot be used for upstream traffic.

To verify the transmit power levels on a CM, use the show cable modem command with the verbose keyword.This command displays the following transmit power values for each assigned upstream channel:


Upstream Channel BondingMultiple Transmit Channel Mode

• Reported Transmit Power—This is the reported transmit power level by the CM for each upstreamchannel.

• Minimum Transmit Power—This is the minimum transmit power level that the CM in the MTC modecould transmit at for the upstream channel.

• Peak Transmit Power—This is the maximum transmit power level that the CM in the MTC mode couldtransmit at for the upstream channel.

To support upstream channel bonding, the minimum transmit power must be less than or equal to the reportedtransmit power, and the reported transmit power must be less than or equal to the peak transmit power. Thepeak transmit power and minimum transmit power levels are derived from the CM TCS assignment and eachindividual upstream channel configuration.

If the minimum transmit power is higher than the reported transmit power, or the reported transmit power ishigher than the peak transmit power, the CM may not come online or may register in partial mode.

You can troubleshoot this transmit power problem in the following two ways:

• Insert an additional amplifier to reduce the upstream attenuation so that the upstream transmit powerfalls within the allowed transmit power range (12 dB).

• Disable theMTCmode. To switch the CM from theMTCmode to non-MTCmode, disable the bonded-bit(bit-0) in type, length, value (TLV) 43.9.3 using the CM configuration file.

Extended Transmit PowerDuring the early deployment of DOCSIS 3.0 CMs, additional power is required from the CMs in order tocompensate for the attenuation in the upstream path. CMs should transmit at extended power level than thatdefined in DOCSIS. This scenario is generally observed when USCB is enabled at the Cisco CMTS and theDOCSIS 3.0 CMs are operating in MTC mode.

Additional upstream power provides the operator with a power margin that helps overcome the upstreamsignal loss, reduces the cable plant operational cost, and enables rapid deployment of DOCSIS 3.0 CMs.

The Cisco CMTS supports the following features with which the CMs can transmit data at an extended power:

• Cisco Extended Transmit Power Feature• DOCSIS Extended Transmit Power Feature

Cisco Extended Transmit Power Feature

The Cisco Extended Transmit Power feature supports DOCSIS 3.0 CMs operating in MTC mode to transmitat a higher power level than the power level specified in theDOCSIS 3.0 Specification. This feature is supportedonly with Cisco DPC3000 CMs.

The Cisco Extended Transmit Power feature enables cable operators to have better control on the cable modemsthat register in 4-channel or 2-channel MTC mode or in non-MTC mode to transmit at a higher power levelthan the DOCSIS-defined maximum power level. The cable operator can configure extended transmit powerusing the cable tx-power-headroom command in global configuration mode.

DOCSIS Extended Transmit Power Feature

The DOCSIS Extended Transmit Power feature supports extended upstream transmit power capability asdefined in the DOCSIS3.0 Specification. This feature allows the CMs to transmit at a high extended powerlevel to counter the attenuation in the US channel.

The table below lists the new TLVs supported by the DOCSIS Extended Transmit Power feature.


Upstream Channel BondingExtended Transmit Power

Table 35: TLVs for DOCSIS Extended Power Feature

ValueLengthTypeTLV Name

0—Extended Upstream Transmit Power SupportOff

1—Extended Upstream Transmit Power SupportOn

2-255—Reserved

116Extended Upstream Transmit PowerSupport

0, 205-244 (units of one-quarter dB)15.40Extended Upstream Transmit Power CMCapability

The Cisco CMTS sends TLV16 to inform the CM if the DOCSIS Extended Transmit Power feature is enabled.The CM in turn, sends TLV5.40 to the Cisco CMTS to communicate its extended power capability. After thenegotiations are complete, the CM can transmit at an extended power.

DOCSIS Extended Transmit Power feature is enabled by default. Use the cable upstream ext-power commandto enable or disable this feature. For more information on how to enable or disable DOCSIS Extended Powerfeature, see Configuring DOCSIS Extended Transmit Power Feature, on page 213.

DOCSIS Extended Transmit Power feature takes precedence, if both Cisco Extended Transmit Power featureand DOCSIS Extended Transmit Power feature are configured.

Note

Reduced Transmit Channel SetThe Reduced Transmit Channel Set feature enables the Cisco CMTS router to reduce upstream channel setassignment based on the total power budget of the CM. For example, a reduction from four to two upstreamchannels gains 3 dB headroom. Further reduction from two channels to a single channel gains another 3 dBheadroom, and the CM starts operating in non-MTC mode.

In order to take advantage of the reduced upstream channel set, the corresponding static bonding groups mustbe configured. For example, a MAC domain is configured with a bonding group having four channels. A CMwith the reduced channel set of two is unable to match to the 4-channel bonding group, and can only bematched to a bonding group with two channels or less.

The Reduced Transmit Channel Set feature is helpful when a DOCSIS 3.0 CM is required to increase its totaltransmit power by 3 dB. For example, a DOCSIS 1.0 or 2.0 CM supports a maximum transmit power of 58dBmV for Quadrature Phase Shift Keying (QPSK)modulation, while a DOCSIS 3.0 CM supports a maximumtransmit power of 61 dBmV. In this case, the DOCSIS 3.0 CM operating in 4-channel MTC mode has areduction in the maximum transmit power per upstream channel. This feature enables the Cisco CMTS routerto support reduced input power level by 6 dB to prevent upstream path attenuation.

T4 MultiplierT4multiplier is the T4 timeout multiplier value of the default T4 timeout values as defined in for cable modemsthat are in the MTC mode. The default value is derived from the number of channels in the modem transmitchannel set. You can change the default T4 multiplier value using the cable upstream ranging-poll commandin cable interface configuration mode.


Upstream Channel BondingReduced Transmit Channel Set

The T4 timeout multiplier values range is from 1 to 10. If the T4 multiplier value is equal to 1, the cablemodem will T4 time out in 30 seconds (that is, 1 x 30 = 30). If you change the T4 multiplier to 4, then thenew T4 timeout value will be 120 seconds (that is, 4 x 30 = 120).

If the T4 timeout multiplier is not configured from the range (1 - 10), then the CMTS uses the T4 timeoutvalue of modem as T4 timeout value. For example, if the T4 timeout of the modem is 90 seconds, then theCMTS applies 3 as the T4 multiplier.

Note

In the MTC mode, you can increase the T4 timeout value in order to reduce the router overhead associatedwith processing of ranging request (RNG-REQ) slots and ranging response messages. If an RNG-RSPmessagedoes not contain a T4 timeout multiplier value, then the CM uses the default T4 timeout value.

Fiber Node Configuration for Upstream Channel BondingThe fiber node configuration on a Cisco CMTS router is used to define MAC domain downstream servicegroups (MD-DS-SGs) and MAC domain upstream service groups (MD-US-SGs) as defined in DOCSIS 3.0.Only the DOCSIS 3.0 certified modems use this information.

In hybrid fiber coaxial (HFC) networks, all CMs connected to the same coaxial segment of a fiber node reachthe same set of downstream and upstream channels on one or more Cisco CMTS routers located at the headend.

A CM is physically connected to only one fiber node. The fiber node must include at least one primary-capablecontroller for the CM connected to the fiber node to be operational.

New TLVs for Upstream Channel BondingThe table below lists the new CableLabs defined type, length, values (TLVs) for the Upstream ChannelBonding feature.

Table 36: New TLVs for Upstream Channel Bonding

ValueLengthTypeTLV Name

Per vendor definition343.8CM vendor ID

Cable modem attribute mask subtype encodingsn43.9Cable modem attribute mask

A Cisco CMTS can have multiple upstream channel bonding groups (USBG) configured. Each of thesebonding groups can include upstream channels with different upstream frequencies. Some bonding groupscan include channels with frequencies within the extended frequency range (see Table 34: Downstream andUpstream Frequency, on page 190). An HFC network consists of several types of CMs, each supportingstandard or extended upstream frequencies.

When you register a CM, the Cisco CMTS does not assign bonding groups based on the upstream frequencyrange supported by that CM. The assignment of the bonding groups is done to balance the CM count on eachof the bonding groups. This may lead to assignment of a bonding group, in the extended frequency range, toa CM that lacks the extended frequency support. As a result, the CMwill not be able to register. This scenariois generally observed in the Cisco cBR-8 CCAP line card deployment (containing a mix of CMs), whichsupports frequency as high as 85MHz (see Table 34: Downstream and Upstream Frequency, on page 190).


Upstream Channel BondingFiber Node Configuration for Upstream Channel Bonding

If the Cisco CMTS assigns a USBG with a channel within the extended frequency range to a CM limited tothe standard frequency range, that CM may not be able to register on that upstream bonding group. Use theTLV 43.9.3 (CM US Required Attribute Mask) or TLV 43.9.4 (CM US Forbidden Attribute Mask) as aworkaround. These TLVs enable the Cisco CMTS to assign CM to a USBG, which is in the upstream frequencyrange supported by that CM.

The default attributes (in hexadecimal) on a CM Attribute Mask (TLV 43.9) are “80 00 00 00", which meansby default the mask is all zeroes with the bonding bit enabled. The first four bytes are pre-defined while thelast four bytes are user defined. In order to enable Cisco CMTS to assign bonding groups based on the frequencyrange supported by CMs, complete these steps:

1. Configure a mask, using TLV 43.9.3 or TLV 43.9.4, by modifying the last four bytes. The mask shouldbe configured such that a unique attribute is assigned to each of the bonding groups.

2. Apply this mask to the CM configuration file. CMs supporting extended frequency, can register with anyUSBGs, irrespective of the configured frequency range of the USBG. CMs supporting standard frequency,can only register with USBGs that are configured with standard frequency range.

Apply the mask you have configured above, to the CMs that support standard or extended frequency ranges.However, the ONLY CMs that need to employ the attribute mask are the ones with the standard frequencyrange, since they will not be able to register with the USBG configured with extended upstream frequencyrange. No attribute mask on the extended frequency supporting CMsmeans that these modems will be assignedany USBG.

The Cisco CMTS uses this mask, received in the CM configuration file during registration, to decide whichUSBG should be assigned to the CM.

Upstream Weighted Fair QueuingThe upstreamweighted fair queuing (WFQ) is a quality of service (QoS) feature that enables the Cisco CMTSrouter to allocate optimum bandwidth to upstream service flows based on theWFQ parameter configurations.To enable upstream WFQ, you must configure either the class-based or activity-based WFQ on a cableinterface.

The following WFQ parameter configurations are supported:

Class-Based Weighted Fair QueuingIn the class-based weighted fair queuing configuration, allocation of available bandwidth is dependent on theservice flows that are active in a service class. A service class is a group of queuing attributes configured onthe Cisco CMTS router. The class must have at least one active service flow. The class receives its portionof the available bandwidth based on the weight of the class. By default, each class (0 to 7) has a weight of“class + 1.” For example, the class 0 has a weight of 1, and class 1 has a weight of 2.

Activity-Based Weighted Fair QueuingIn the activity-based weighted fair queuing configuration, allocation of available bandwidth is based on theservice class and the total number of service flows that are active in a map for the service class. A serviceclass with higher number of service flows receives the larger percentage of bandwidth.

Custom Weight for Service Flow PrioritiesThe weighted fair queuing functionality helps the Cisco CMTS router share the available bandwidth basedon the weight of the service flow priorities specified for outstanding requests from an upstream service flow.Priority refers to the service flow priority specified in the CM configuration file, or the Cisco CMTS service


Upstream Channel BondingUpstream Weighted Fair Queuing

class configuration. By default, the weight of a priority is equal to “priority+1.” For example, priority 0 hasa weight of 1, and priority 1 has a weight of 2. A higher priority provides more weight to the outstandingrequest. The custom weight can be specified for a total of eight priorities (0 to 7) in a service class.

The priority parameter refers to the priority of traffic in a service flow ranging from 0 (the lowest) to 7 (thehighest). In the upstream traffic, all of the pending high priority service flows are scheduled for transmissionbefore low priority service flows. You can configure the weight for priorities based on how much weight isappropriate per priority.

The table below lists the default weight for each service flow priority.

Table 37: Default Weight of Service Flow Priorities

Default WeightService Flow Priority

10

21

32

43

54

65

76

87

Upstream Scheduler and Service FlowsA DOCSIS-qualified Cisco CMTS router can provide varied upstream scheduling modes for different packetstreams or applications using upstream service flows. A service flow represents either an upstream or adownstream flow of data. A unique service flow ID (SFID) identifies each service flow. Each service flowcan have its own quality of service (QoS) parameters, such as maximum throughput, minimum guaranteedthroughput, and priority. In the case of upstream service flows, you can also specify a scheduling mode.

Scheduling is a process that enables the Cisco CMTS router to receive bandwidth requests and grant timeslotsto CMs for the upstream traffic. The Cisco CMTS router periodically creates a grant map for each enabledupstream channel. The map grants individual timeslots to enable CMs to place packets on the upstreamchannels.

DOCSIS 3.0 describes a method by which a CM creates an upstream service flow. The following schedulingtypes enable the Cisco CMTS router to allocate bandwidth for upstream service flows:

• Unsolicited grant service (UGS)• Solicited grant service

The unsolicited grant service is primarily used for voice. In the case of UGS, the CM does not have to explicitlyrequest grants from the Cisco CMTS router whereas in the solicited grant service the CM has to explicitlyrequest grants from the Cisco CMTS router. The solicited grant service is primarily used for best effort (BE)services.


Upstream Channel BondingUpstream Scheduler and Service Flows

Unlike DOCSIS 2.0, DOCSIS 3.0 allows multiple outstanding requests per service flow. For more informationabout the upstream scheduler, see the Upstream Scheduler Mode for the Cisco CMTS Routers feature guideat the following URL:

http://www.cisco.com/en/US/docs/ios/cable/configuration/guide/cmts_upstm_sch_md_ps2209_TSD_Products_Configuration_Guide_Chapter.html

Upstream Service Flow FairnessThe service flows in the same class receive approximately the same amount of bandwidth. Fairness resolvesthe bandwidth distribution disparity among various service flows including:

• non-bonded service flow vs bonded service flows• Service flows on modems of different vendors, i.e Intel/TI vs Broadcom• Service flows associated with different sized bonding groups, i.e. 1,2 4 channels

The upstream scheduler supports flow based queuing. When Upstream Service Flow Fairness is configured,the upstream scheduler determines the order and amount of BW a service flow should receive based on it'scurrent consumption relative to other flows in the flows in the same class.

Use the cable upstream qos fairness command to configure the Upstream Service Flow Fairness feature.Use this command in interface configuration mode (or MAC Domain configuration mode).

Distribution of Traffic across all Channels in a USBGWhen upstream channel bonding (USCB) is enabled, the Distribution of Traffic across all Channels in a USBGfeature can be used to balance the bandwidth utilization across upstream channels on one upstream bondinggroup.

This feature balances the utilization only if there is one upstream channel bonding group configured per MACdomain.

Restrictions:

• This feature is supported only on one upstream bonding group under a MAC domain. When multipleupstream bonding groups are configured under a MAC domain, the utilization is unfair.

• All the channels must be configured in one upstream bonding group under the same MAC domain.• This feature is used only for UB-online cable modems.

The USCB Balancing Scheduler may be enabled or disabled using the cable upstream balance-schedulercommand in the interface (config-if) configuration mode.

DOCSIS3.0LoadBalancingwithUSBGSmaller thanCableModemCapabilitiesWhen using USCB in a service group with USBGs containing fewer upstream channels than the total upstreamchannel set with DOCSIS 3.0 load balancing enabled, the CMTS can assign a Transmit Channel Set (TCS)to DOCSIS 3.0 cable modems for potential use which falls outside of the configured USBG. The CMTS willtry to bind smaller UBGs and default single channel bonding groups into a bigger channel set in order toincrease the cable modem services. For example, a DOCSIS 3.0 cable modem receiving the larger TCS canuse these additional channels for dynamic service flow addition. The DOCSIS 3.0 Load Balancing featurecan also move cable modems to upstream channels that are not explicitly configured with USBGs as a resultof the larger TCS.


Upstream Channel BondingUpstream Service Flow Fairness

http://www.cisco.com/en/us/docs/ios/cable/configuration/guide/cmts_upstm_sch_md_ps2209_tsd_products_configuration_guide_chapter.html

If you activate DOCSIS 3.0 Load Balancing while using upstream bonding, ensure that the upstream bondinggroup configuration is embedded and aligned by performing the following:

• Configure USBGs, which is matched to cable modem capabilities within the service group, such as a 4channel USBG, 2 channel USBG, and 3 channel USBG as applicable.

• Ensure that configured USBGs are optimal for the upstream channel set based on modem capabilitieswithin the service group. For example, if four upstream channels are available, channels 0+1 and 2+3should each be an USBG to avoid dynamic TCS creating sub optimal bonding scenarios.

• Alternatively, you can choose to shut down any upstream channels that is not configured in USBGswhich is not be used for bonding.

Cisco cBR-8 CCAP Line Card Rate LimitingThe rate limiting functionality enables you control the aggregated rate and CPU consumption of upstreamtraffic for DOCSIS 3.0 bonded service flows on the Cisco cBR-8 CCAP line card. The rate limiting functionalityis configured by default on the Cisco cBR-8 CCAP line card. However, the default configuration can bemodified using the cable upstream rate-limit-ccf command.

The rate limiting functionality uses the following two rate limiting methods:

• Aggregated rate limiting—This is based on Peripheral Component Interconnect (PCI) bus aggregatedthroughput. The throughput is per line card for all bonded service flows. You can modify the defaultthroughput and burst rate configuration. The maximum allowed throughput is 115 Mbps.

• CPU-based rate limiting—This method controls the CPU consumed by Continuous Concatenation andFragmentation (CCF) and ensures that the line card functions properly when traffic is overloaded withbonded service flows. The default configuration allocates 50 per cent of CPU to CCF. You can modifythe default CPU threshold value and burst rate as required.

SID TrackingThe service ID (SID) tracking functionality enables you to track events related to upstream bandwidth requestsand processing of grants. The SID tracker module can track events for a maximum of two service flows perMAC domain. The SID tracker module tracks up to 40,000 events per service flow on a cable interface linecard.

You can enable SID tracking for the following types of events:

• DOCSIS 2.0 bandwidth request• DOCSIS 3.0 bandwidth request• Grant• Pending grant (due to traffic congestion)• Pending grant (due to shaping)

You can enable SID tracking using the track keyword along with the debug cable interface sid command.To verify SID tracking, use the show interface cable upstream debug command in privileged EXEC mode.

Service ID ClustersA Cisco CMTS router can assign one or more service ID clusters to the upstream bonded service flows(upstream service flows assigned to an upstream bonding group) at the time of service flow creation. A SID


Upstream Channel BondingCisco cBR-8 CCAP Line Card Rate Limiting

cluster contains one SID per upstream in a bonding group. A CM uses one of the SIDs defined in the SIDcluster for the upstream interface when the CM sends a bandwidth request. The CM chooses a SID or a SIDcluster based on the SID cluster switching criteria.

For example, assume that a CM has ranged on upstream channels from 1 to 4. The Cisco CMTS router createsa bonded service flow and assigns a single SID cluster to each upstream channel. That is SID1 for UP1, SID2for UP2, SID3 for UP3, and SID4 for UP4. Now, the CM can send a bandwidth request using any of the fourupstream channels. That is, the CM can request bandwidth on any of the upstream interfaces in the SID clusterusing the SID defined for the particular upstream. The Cisco CMTS router grants bandwidth to the CM usingany combination of upstream channels.

How to Configure Upstream Channel Bonding

Before configuring the Upstream Channel Bonding feature, ensure that the fiber node is configured. The fibernode must be configured in accordance with the physical plant topology.

Note

The following tasks describe how to configure Upstream Channel Bonding on the Cisco cBR-8 router:

Enabling MTC Mode on a Cisco CMTS RouterTo section explains how to enable the MTC mode on a Cisco CMTS router.

Default MTC Mode Configuration on a Cisco CMTS RouterBy default, the MTC mode is configured on a cable interface line card. With this default configuration, theCisco CMTS router enables the MTC mode on a per MAC domain basis depending on the configuration fileof each CM. When the CM configuration file has the bonded-bit (bit-0) enabled in TLV 43.9.3 (cable modemupstream required attribute mask), the Cisco CMTS router enables the CM to come online in the MTC mode.If the CM configuration file does not have the bonded-bit on, the CM comes online in non-MTC mode.

For more information on how to add the required attribute in the CM configuration file, see Example: EnablingMTC Mode for a Single CM Using the CM Configuration File, on page 215.

Enabling MTC Mode for All CMs

• For DOCSIS 3.1 cable modems, the CMTS router must be configured to use MTC mode.

• This MTC mode configuration supersedes the default MTC mode configuration (per CM basis) with therequired attribute. To disable the MTC mode for all CMs in a MAC domain, use the no form of thecable mtc-mode command. If theMTCmode is enabled and the forbidden mask of the upstream bondingin TLV 43.9.4 is disabled, the CM does not support the Upstream Channel Bonding feature.

Note


Upstream Channel BondingHow to Configure Upstream Channel Bonding

Procedure





Example:

Step 2



interface cable {slot/subslot/port |slot/subslot/cable-interface-index | slot/port |slot/cable-interface-index}

Step 3

Example:Router(config)# interface cable 7/0/0

Enables MTC mode at the MAC interface for all CMs.cable mtc-mode

Example:

Step 4

Router(config-if)# cable mtc-mode

Exits cable interface configuration mode and returns toprivileged EXEC mode.

end

Example:

Step 5

Router(config-if)# end

Configuring UCSB Required AttributeIf the CM configuration file has TLV 43.9.3 (CM upstream required attribute mask) configured and bondedbit is set to 1, then the modem comes UB-online on a MAC domain basis. If the CM configuration file hasno TLV 43.9.3 or the bonded bit is not set to 1, then the modem comes online with a single upstream channelon a MAC domain basis.

Without this configuration, the modem comes UB-online on the MAC domain regardless of whether the TLV43.9.3 is configured in the modem configuration file.

Note

Procedure


Enables privileged EXEC mode. Enter your password ifprompted

enable

Example:

Step 1

Router> enable


Example:

Step 2


Upstream Channel BondingConfiguring UCSB Required Attribute

PurposeCommand or ActionRouter# configure terminal


interface cable { slot/subslot/port |slot/subslot/cable-interface-index | slot/port |slot/cable-interface-index}

Step 3


Enable enforcement of required CM attribute on UCSB.cable mtc-mode required-attribute

Example:

Step 4

Router(config-if)# cable mtc-moderequired-attribute


end

Example:

Step 5


Creating a Bonding GroupAn upstream bonding group is created by combining multiple upstream channels together on a cable interfaceline card.

Procedure





Example:

Step 2




Step 3


Creates the bonding group on the specified cable interface.cable upstream bonding-group id

Example:

Step 4

Router(config-if)# cable upstream bonding-group200


Upstream Channel BondingCreating a Bonding Group



end

Example:

Step 5


What to do next

After creating an upstream bonding group, you must add upstream channels to the bonding group.

Adding Upstream Channels to a Bonding Group

DOCSIS 3.0-certified CMs support only four upstream channels on an upstream bonding group. These CMsdo not accept additional upstream channels that are added to a bonding group.

Restriction

Procedure





Example:

Step 2




Step 3


Creates the bonding group on the specified interface.cable upstream bonding-group id

Example:

Step 4


Enters upstream bonding configuration submode and addsan upstream channel to the upstream bonding group.

upstream number

Example:

Step 5


Upstream Channel BondingAdding Upstream Channels to a Bonding Group

PurposeCommand or ActionRouter(config-upstream-bonding)# upstream 1 Upstream channel needs to be bonded to

mac-domain first before adding it to thebounding group. For detailed configuration stepsof the upstream channel bonding, please refer toConfiguration Example for Upstream ChannelBonding

Note

Amaximum of 16 upstream channels can be configured foreach MAC Domain, which are divided into two groups:



Exits upstream bonding configuration submode and returnsto privileged EXEC mode.

end

Example:

Step 6

Router(config-upstream-bonding)# end

Adding Upstream Channel Ports to a Fiber NodeYou must add upstream channel controllers to a fiber node in order to complete the basic upstream channelbonding configuration on a cable interface line card. The fiber node must contain all upstream and downstreamcontrollers reached by the CMs.

• Configuration of a fiber node is valid only if all upstream channels inside the fiber node have differentupstream frequencies.

• For any two upstream channels mapped to the upstream cable controllers in the same fiber node wherea spectrum group is assigned to one upstream channel, and a frequency is assigned to the other upstreamchannel, any overlap between any bands associated with the spectrum group of the upstream channeland the frequency of the upstream channel will result in an invalid fiber node configuration. That is afixed frequency cannot overlap with another upstream channel’s available spectrum group bands.

Restriction

The fiber node configuration must be done in accordance with the physical plant topology.Note

Procedure





Upstream Channel BondingAdding Upstream Channel Ports to a Fiber Node



Example:

Step 2


Enters fiber node configuration mode.cable fiber-node fiber-node-id

Example:

Step 3

Router(config)# cable fiber-node 2

Specifies the upstream channel ports for a fiber node.upstream Upstream-Cable slot/subslot/port

Example:

Step 4

Router(config-fiber-node)# upstream Upstream-Cable7/0/1

Exits fiber node configuration mode and returns toprivileged EXEC mode.

end

Example:

Step 5

Router(config-fiber-node)# end

Configuring the Class-Based Weighted Fair QueuingIn the case of a class-based configuration, allocation of available bandwidth is dependent on the service flowsthat are active in a service class.

Procedure





Example:

Step 2




Step 3


Enables class-based weighted fair queuing.cable upstream qos wfq class

Example:

Step 4

Router(config-if)# cable upstream qos wfq class


Upstream Channel BondingConfiguring the Class-Based Weighted Fair Queuing



end

Example:

Step 5


Configuring the Activity-Based Weighted Fair QueuingIn the activity-based configuration, allocation of available bandwidth is based on the service class and thetotal number of service flows that are active in a map for the service class.

Procedure





Example:

Step 2




Step 3


Enables activity-based weighted fair queuing.cable upstream qos wfq activity

Example:

Step 4

Router(config-if)# cable upstream qos wfq activity


end

Example:

Step 5


Configuring Custom Weights for Service Flow PrioritiesThe WFQ functionality helps the Cisco CMTS router share the available bandwidth based on the weight ofthe service flow priorities specified for outstanding requests from an upstream service flow.

Procedure




Upstream Channel BondingConfiguring the Activity-Based Weighted Fair Queuing




Example:

Step 2




Step 3


Enables custom weight configuration for all the serviceflow priorities in a service class.

cable upstream qos wfq weights priority0-priority7

Example:

Step 4

You must specify custom weight values for allthe eight service flow priorities (0 to 7) whenyou modify the default weights of priorities. Thevalid range is from 1 to 255.

NoteRouter(config-if)# cable upstream qos wfq weights10 20 30 40 50 60 70 80.


end

Example:

Step 5


Configuring the SID ClusterThis section explains how to configure and assign SID cluster to an upstream bonded service flow.

To achieve desired upstream bonded speed, you can use the cable sid-cluster-group num-of-cluster toachieve desired upstream bonded speeds, and this takes precedence over cable sid-cluster-group dynamic.Alternatively you can use a large upstream Max Traffic burst value in the cable modem file (such as 30 kB).TheMaxConcat burst value in the cablemodem file does not need change because DOCSIS 3.0 uses continuousconcatenations and fragmentation (CCF), and can therefore use the default value of 3044 in the Max Concatfield.

If the cable sid-cluster-group command is not used, the router accepts the default SID cluster configuration.By default, dynamic sid-cluster assignment is configured. Similarly, if the cable sid-cluster-switchingcommand is not used, the router accepts the default SID cluster switchover criterion. That is, only one requestcan be made using the SID cluster.

Note

Procedure




Upstream Channel BondingConfiguring the SID Cluster




Example:

Step 2




Step 3


Creates a SID cluster group. Starting from Cisco IOS XEGibraltar 16.12.1z release, you can configure a maximum

cable sid-cluster-group [dynamic[max_rate_threshold]| req-multiplier value | num-of-cluster number]

Step 4

rate threshold for the service flow, because the originalExample: threshold is not appropriate in some cases. If the maximumRouter(config-if)# cable sid-cluster-group dynamic rate of the service flow is larger than the configured

threshold, two SIDs will be allocated to the service flowinstead of one SID.

Router(config-if)# cable sid-cluster-group dynamic3000000000

Router(config-if)# cable sid-cluster-groupreq-multiplier 12

Router(config-if)# cable sid-cluster-groupnum-of-cluster 2

Specifies SID cluster switchover criteria.cable sid-cluster-switching [max-outstanding-byte value| max-request value | max-time seconds | max-total-bytevalue]

Step 5

Example:Router(config-if)# cable sid-cluster-switchingmax-outstanding-byte 4444

Router(config-if)# cable sid-cluster-switchingmax-request 222

Router(config-if)# cable sid-cluster-switchingmax-time 444

Router(config-if)# cable sid-cluster-switchingmax-total-byte 67890


end

Example:

Step 6



Upstream Channel BondingConfiguring the SID Cluster

What to do next

Use the show running-config all command to verify the SID cluster configuration. Following is a sampleoutput of the command:Router# show running-config all..cable sid-cluster-group req-multiplier 4

Configuring the Channel Timeout for a Cable ModemThe channel timeout configuration allows you to specify the maximum time that a CM can spend performinginitial ranging on the upstream channels described in the Registration Response (REG-RSP) and REG-RSP-MPmessages. The default channel timeout value (60 seconds) is automatically configured.

Procedure





Example:

Step 2




Step 3


Specifies the maximum time that a CM can spendperforming initial ranging on the upstream channels.

cable init-channel-timeout value

Example:

Step 4

Router(config-if)# cable init-channel-timeout 160


end

Example:

Step 5


Configuring Cable Upstream ResiliencyThe cable upstream resiliency module ensures that a CM remains operational if one or more non-primaryupstream service flows of the CM enter temporary or persistent error states. This module enables a Cisco CMTSrouter to handle various events and maintain the transmit channel set of each CM.

In the event of the primary upstream service flow failure, the upstream resiliency module forces the CM togo offline.


Upstream Channel BondingConfiguring the Channel Timeout for a Cable Modem

For a Multiple Transmit Channel (MTC) modem, the (NRTPS), Real-time Polling Service (RTPS), (UGS),and (UGS-AD) upstream service flows on an impaired upstream channel is moved to another good upstreamchannel in the cable modem without resetting the cable modem.

Procedure





Example:

Step 2


Configures the polling interval for data-burst resiliency inseconds. The range is from 5 to 3600. The defaultconfiguration for polling-interval is 60.

cable upstream resiliency data-burst polling-intervalnumber

Example:

Step 3

Router(config)# cable upstream resiliencydata-burst polling-interval 60



Step 4


Configures upstream resiliency for bonded upstream serviceflows.

cable upstream resiliency {channel-down-detect number| data-burst snr number ufec number cfec numberhysteresis number | modem-offline-detect number |

Step 5

on-failure {disable-channel | extended-ranging |reset-modem} | sf-move {NRTPS | RTPS | UGS| UGS-AD} }

Example:Router(config-if)# cable upstream resiliencychannel-down-detect 68

Router(config-if)# cable upstream resiliencymodem-offline-detect 16

Router(config-if)# cable upstream resiliencyon-failure disable-channel

Router(config-if)# cable upstream resiliencysf-move NRTPS

Router(config-if)# cable upstream resiliencysf-move RTPS

Router(config-if)# cable upstream resiliencysf-move UGS


Upstream Channel BondingConfiguring Cable Upstream Resiliency


Router(config-if)# cable upstream resiliencysf-move UGS-AD

Router(config-if)# cable upstream resiliencydata-burst snr 24 ufec 1 cfec 0 hysteresis 3


end

Example:

Step 6


Configuring Rate Limiting on the Cisco cBR-8 CCAP Line CardThe rate limiting functionality is configured by default on the Cisco cBR-8 CCAP line card. However, thedefault configuration can be modified using the cable upstream rate-limit-ccf command.

Procedure





Example:

Step 2


Configures rate limiting parameters for upstream bondedservice flows on a cable interface line card.

cable upstream rate-limit-ccf [aggregated-burst value |aggregated-throughput value | cpu-burst value |cpu-threshold value]

Step 3

Example:Router(config)# cable upstream rate-limit-ccfaggregated-burst 25000

Router(config)# cable upstream rate-limit-ccfaggregated-throughput 540000

Router(config)# cable upstream rate-limit-ccfcpu-burst 30

Router(config)# cable upstream rate-limit-ccfcpu-threshold 60

Exits global configuration mode and returns to privilegedEXEC mode.

end

Example:

Step 4

Router(config)# end


Upstream Channel BondingConfiguring Rate Limiting on the Cisco cBR-8 CCAP Line Card

Enabling Upstream Related Events for CM Status ReportsYou can enable upstream related CM status events only on a cable interface line card. You can enable thefollowing upstream related CM status events per interface using the cable cm-status enable command:

• T4 time-out• T3 re-tries exceeded• Successful ranging after T3 re-tries exceeded

For details on how to enable upstream and downstream related CM status events, see the Wideband ModemResiliency feature guide at the following URL:

http://www.cisco.com/en/US/docs/ios/cable/configuration/guide/ubr_wm_resiliency.html

Modifying the Bonding Group AttributesBonding group attributes are automatically configured for each upstream bonding group. You can modifythem using the attributes command in upstream bonding configuration mode.

Procedure





Example:

Step 2




Step 3


Creates the bonding group on the specified cable interfaceand enters the upstream bonding configuration mode.

cable upstream bonding-group id

Example:

Step 4


Modifies the attribute value for the specified bonding group.attributes value

Example:

Step 5

Router(config-upstream-bonding)# attributeseeeeeeee

Exits upstream bonding configuration mode and returns toprivileged EXEC mode.

end

Example:

Step 6


Upstream Channel BondingEnabling Upstream Related Events for CM Status Reports

http://www.cisco.com/en/US/docs/ios/cable/configuration/guide/ubr_wm_resiliency.html

PurposeCommand or ActionRouter(config-upstream-bonding)# end

Modifying the Ranging Poll Interval on Upstream ChannelsYou can change the default ranging poll interval (20 seconds) on upstream channels using the cable upstreamranging-poll command in cable interface configuration mode. You can also specify the T4 timeout multipliervalue using this command.

For information on T4 Multiplier, see T4 Multiplier, on page 192 .

We recommend that you do not modify the default ranging poll interval unless required. With the defaultconfiguration, a DOCSIS 2.0 CM in non-MTC mode performs ranging on one upstream channel every 20seconds.

Note

Procedure





Example:

Step 2




Step 3


Specifies the ranging poll interval for upstream channels.cable upstream ranging-poll [interval value |t4-multiplier timeout_value]

Step 4

If t4-multiplier timeout_value is not configured,then the CMTS uses the the T4 timeout of themodem. For example, if the T4 timeout of themodem is 90 seconds, then the CMTSwill apply3 as T4 multiplier for the modem.

NoteExample:

Router(config-if)# cable upstream ranging-pollinterval 24000 t4-multiplier 4


end

Example:

Step 5



Upstream Channel BondingModifying the Ranging Poll Interval on Upstream Channels

Configuring the Reduced Channel Set AssignmentYou need to configure the transmit power offset budget to enable the Cisco CMTS router to reduce upstreamchannel set assignment based on the total power budget of the CM.

The threshold value specified for the power budget offset (max-channel-power-offset) must be less than thepower threshold value (power-adjust continue) that determines the value of the Ranging Status field in theRanging Response (RNG-RSP) messages that the Cisco CMTS router sends to the CM. You can specify thepower threshold value using the cable upstream power-adjust command.

Note

Before you begin

• Configure extended transmit power using the cable tx-power-headroom command in global configurationmode.

• Ensure that corresponding static bonding groups are configured.

Procedure





Example:

Step 2




Step 3


Specifies the power offset value for upstream channels.cable upstream max-channel-power-offset dB-value

Example:

Step 4

Router(config-if)# cable upstreammax-channel-power-offset 2


end

Example:

Step 5



Upstream Channel BondingConfiguring the Reduced Channel Set Assignment

Configuring DOCSIS Extended Transmit Power FeatureThe DOCSIS Extended Transmit Power feature is enabled by default on the Cisco CMTS. However, thedefault configuration can be modified using the cable upstream ext-power command.

Procedure





Example:

Step 2




Step 3


Enables the DOCSIS Extended Transmit Power feature onthe Cisco CMTS.

cable upstream ext-power

Example:

Step 4

Using the no form of this command disables the DOCSISExtended Transmit Power feature.Router(config-if)# cable upstream ext-power

Exits interface configuration mode and returns to privilegedEXEC mode.

end

Example:

Step 5


Troubleshooting TipsThe following debug commands help you troubleshoot an improper upstream channel bonding configurationand its related features:

• debug cable cm-status—Provide debugging information about CM status messages on the Cisco CMTSrouters.

• debug cable mdd—Provides debugging information about MAC domain descriptor (MDD).• debug cable md-sg—Provides information about service group debugging messages.• debug cable ubg—Provides debugging information about upstream bonding groups.

Configuration Example for Upstream Channel BondingThe following example shows how to configure the basic upstream channel bonding on the Cisco cBR-8CCAP line card interface 7/0/0 on the Cisco cBR-8 router:


Upstream Channel BondingConfiguring DOCSIS Extended Transmit Power Feature

controller Upstream-Cable 7/0/0us-channel 0 frequency 10000000us-channel 0 channel-width 3200000 3200000us-channel 0 ingress-noise-cancellation 50us-channel 0 docsis-mode atdmaus-channel 0 minislot-size 2us-channel 0 modulation-profile 221us-channel 0 equalization-coefficientno us-channel 0 shutdownus-channel 1 frequency 16400000us-channel 1 channel-width 6400000 6400000us-channel 1 ingress-noise-cancellation 50us-channel 1 docsis-mode atdmaus-channel 1 minislot-size 1us-channel 1 modulation-profile 221us-channel 1 equalization-coefficientno us-channel 1 shutdownus-channel 2 frequency 22800000us-channel 2 channel-width 6400000 6400000us-channel 2 docsis-mode atdmaus-channel 2 minislot-size 1us-channel 2 modulation-profile 221us-channel 2 equalization-coefficientno us-channel 2 shutdownus-channel 3 frequency 29200000us-channel 3 channel-width 6400000 6400000us-channel 3 docsis-mode atdmaus-channel 3 minislot-size 1us-channel 3 modulation-profile 221us-channel 3 equalization-coefficientno us-channel 3 shutdownus-channel 4 channel-width 1600000 1600000us-channel 4 docsis-mode tdmaus-channel 4 minislot-size 4us-channel 4 modulation-profile 21us-channel 4 shutdownus-channel 5 channel-width 1600000 1600000us-channel 5 docsis-mode atdmaus-channel 5 minislot-size 4us-channel 5 modulation-profile 221us-channel 5 shutdown!

interface Cable7/0/0load-interval 30downstream Integrated-Cable 7/0/0 rf-channel 0downstream Integrated-Cable 7/0/0 rf-channel 8downstream Integrated-Cable 7/0/0 rf-channel 16upstream 0 Upstream-Cable 7/0/0 us-channel 0upstream 1 Upstream-Cable 7/0/0 us-channel 1upstream 2 Upstream-Cable 7/0/0 us-channel 2upstream 3 Upstream-Cable 7/0/0 us-channel 3no cable upstream 0 equalization-error-recoveryno cable upstream 1 equalization-error-recoveryno cable upstream 2 equalization-error-recoveryno cable upstream 3 equalization-error-recoverycable upstream 7 attribute-mask 1FFcable upstream bonding-group 1upstream 0upstream 1upstream 2attributes 80000000cable bundle 1


Upstream Channel BondingConfiguration Example for Upstream Channel Bonding

cable map-advance static 2000cable sync-interval 121cable reduction-mode mta-battery enablecable privacy accept-self-signed-certificateend

cable fiber-node 1description Feed Mac Domain: Cable7/0/0downstream Integrated-Cable 7/0/0upstream Upstream-Cable 7/0/0

Bonded channels are typically from the same connector; however, channels from different connectors in thesameMAC domain can also be bonded together. A singleMAC domain can support multiple channel bondinggroups.

Note

Up to 8 frequencies can be stacked to one upstream-cable controller. Once the upstream-cable controller has8 frequencies stacked, no more frequency left for the adjacent upstream-cable controller.

Note

Example: Enabling MTC Mode for a Single CM Using the CM ConfigurationFile

The following example shows how to enable the MTC required attribute using the CM configuration file:

03 (Net Access Control) = 1Unknown Type 005 = 01 01 0118 (Maximum Number of CPE) = 424 (Upstream Service Flow Encodings)

S01 (Service Flow Reference) = 1S06 (QoS Parameter Set Type) = 7S10 (Min Reserved Traffic Rate)= 500000

25 (Downstream Service Flow Encodings)S01 (Service Flow Reference) = 2S06 (QoS Parameter Set Type) = 7S10 (Min Reserved Traffic Rate) = 1000000

29 (Privacy Enable) = 043 (Vendor Specific Options)

S08 (Vendor ID) = ff ff ffS009 (Unknown sub-type) = 03 04 80 00 00 00

Verifying the Upstream Channel Bonding ConfigurationUse the following show commands to verify the upstream channel bonding configuration:

• show cable mac-domain upstream-service-group• show cable fiber-node• show interface cable upstream• show interface cable service-flow• show cable modem


Upstream Channel BondingExample: Enabling MTC Mode for a Single CM Using the CM Configuration File

To verify the runtime statistics of the upstream service group on a cable interface line card, use the showcable mac-domain upstream-service-group command.

To verify the configuration of a fiber node, use the show cable fiber-node command.

To verify the bonding groups configured on a cable interface line card, use the show interface cable upstreamcommand.

To verify upstream bonding information on a cable interface line card, use the show interface cableservice-flow command.

To verify the transmit power levels on a CM, use the show cable modem command.

Verifying Weighted Fair Queuing for Upstream Service FlowsTo verify WFQ parameters configured for upstream service flows on a cable interface line card, use the showinterface cable mac-scheduler command.

Verifying Rate Limiting for Upstream Bonded Service FlowsTo verify the rate limiting criteria configured on the Cisco cBR8 CCAP line card for upstream bonded serviceflows, use the show cable rate-limit-ccf command.

The show cable rate-limit-ccf command is applicable only to the Cisco cBR8 CCAP cable interface linecard.

Note

Verifying Extended Power TransmissionTo verify that a CM is transmitting at a higher power level, use the show cable modem command.

To list all the CMs that are transmitting at higher power level, use the show cable modem extended-powercommand.

Additional ReferencesThe following sections provide references related to the Upstream Channel Bonding feature.


Upstream Channel BondingVerifying Weighted Fair Queuing for Upstream Service Flows


LinkDescription

http://www.cisco.com/techsupportThe Cisco Support website provides extensive online resources, includingdocumentation and tools for troubleshooting and resolving technical issueswith Cisco products and technologies.

To receive security and technical information about your products, youcan subscribe to various services, such as the Product Alert Tool (accessedfrom Field Notices), the Cisco Technical Services Newsletter, and ReallySimple Syndication (RSS) Feeds.

Access to most tools on the Cisco Support website requires a Cisco.comuser ID and password.

Feature Information for Upstream Channel BondingUse Cisco Feature Navigator to find information about the platform support and software image support.Cisco Feature Navigator enables you to determine which software images support a specific software release,feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An accounton the Cisco.com page is not required.


Note

Table 38: Feature Information for Upstream Channel Bonding



Cisco IOS XE Fuji 16.7.1Upstream Channel Bonding

This feature was introduced on the Cisco cBRSeries Converged Broadband Router.

Cisco IOS XE Gibraltar16.12.1z

User-ConfigurableDynamic SIDCluster Threshold


Upstream Channel BondingFeature Information for Upstream Channel Bonding




Upstream Channel BondingFeature Information for Upstream Channel Bonding

C H A P T E R 12Dynamic Bonding Group

This document describes how to configure Dynamic Bonding Group that helps manage resource of alldownstream bonding groups by automatically creating bonding groups.



• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 219• Information About Dynamic Bonding Group, on page 220• Overview of Dynamic Bonding Group, on page 220• How to configure Dynamic Bonding Group, on page 221• Feature Information for Dynamic Bonding Group, on page 231



Note
















Digital PICs:


•













Information About Dynamic Bonding GroupDynamic Bonding Group (DBG) helps manage the resource of all downstream bonding groups, includingautomatically creating and reclaiming the downstream bonding groups.

Overview of Dynamic Bonding GroupTo reduce the effort required in configuring and managing RCC, the DBG feature implements the automaticcreating and reclaiming of the downstream bonding groups. DBG creates the bonding group automaticallydepending on the channel’s load usage. With DBG, the modem is assigned the downstream bonding group


Dynamic Bonding GroupInformation About Dynamic Bonding Group

without any static RCC configuration. The load balancing feature leverages DBG to balance traffic amongall channels. DBG also accommodates primary channel and CM capacity distributions automatically.

DBG also accommodates primary channel and CM capacity distributions automatically.

Dynamic Bonding Group supports the following:

• Support 896 bonding groups per CLC for CYLONS card.

• Support creating DBGs and reclaiming DBG.

• Support DOCSIS 3.0 and DOCSIS 3.1 channel types.

• Support DOCSIS 3.0 and DOCSIS 3.1 load balance.

• Supports DBG interoperation — Modem registration and load balancing.

• Enhance dynamic load balance — Fixed primary channel movement.

• Enhance raider FPGA SQF — Fairness in channel utilization.

How to configure Dynamic Bonding Group

To know more about the commands referenced in this module, see the Cisco IOS Master Command List.Note

Enable Dynamic Bonding GroupTo enable DBG, run the following commands:

ROUTER# config tEnter configuration commands, one per line. End with CNTL/Z.ROUTER(config)# cable dynamic-bonding-groupROUTER(config)# endROUTER#ROUTER#ROUTER# show runROUTER# show running-config | in dynamic-bondingcable dynamic-bonding-group

Enable DS-Resiliency and Configure Resiliency Bonding GroupTomake sure that themodem remains w-online withmaximum downstream capability when several rf channelsare impaired, enable ds-resiliency feature by running the following commands:

Router# config tEnter configuration commands, one per line. End with CNTL/Z.Router(config)# cable resiliency ds-bondingRouter(config)# endRouter#Router# show running-config | in resiliencycable resiliency ds-bondingRouter#Router# config t


Dynamic Bonding GroupHow to configure Dynamic Bonding Group

Enter configuration commands, one per line. End with CNTL/Z.Router(config)# interface wideband-Cable 3/0/1:30Router(config-if)# cable ds-resiliencyWideband-Cable3/0/1:30 is set to WB resiliency bonding group.Remove any existing bundle and rf-channel configuration.Router(config-if)#endRouter#Router#show running-config interface wideband-Cable 3/0/1:30Building configuration...Current configuration : 61 bytes!interface Wideband-Cable3/0/1:30cable ds-resiliencyend

Enable ACFEEnable ACFE feature to make sure that modem registration is not blocked because of QoS failures:

Router# config tEnter configuration commands, one per line. End with CNTL/Z.Router(config)# cable acfe enableRouter(config)# endRouter# show running-config | in acfecable acfe enable

Configure Interface Mac-Domain and Fiber-Node

The recommended size of service group is 32 or 48. The recommended primary channel distribution is oneprimary channel for contiguous four channels, such as 0, 4, 8, 12, 16, 20, 24, 28 and so on.

Note

To set up interface mac-domain and fiber-node, run the following commands:

Router# show running-config interface c3/0/1Building configuration...Current configuration : 963 bytes!interface Cable3/0/1downstream Integrated-Cable 3/0/1 rf-channel 0downstream Integrated-Cable 3/0/1 rf-channel 4downstream Integrated-Cable 3/0/1 rf-channel 8downstream Integrated-Cable 3/0/1 rf-channel 12downstream Integrated-Cable 3/0/1 rf-channel 16downstream Integrated-Cable 3/0/1 rf-channel 20downstream Integrated-Cable 3/0/1 rf-channel 24downstream Integrated-Cable 3/0/1 rf-channel 28upstream 0 Upstream-Cable 3/0/1 us-channel 0upstream 1 Upstream-Cable 3/0/1 us-channel 1upstream 2 Upstream-Cable 3/0/1 us-channel 2upstream 3 Upstream-Cable 3/0/1 us-channel 3upstream 4 Upstream-Cable 3/0/1 us-channel 4upstream 5 Upstream-Cable 3/0/1 us-channel 5upstream 6 Upstream-Cable 3/0/1 us-channel 6upstream 7 Upstream-Cable 3/0/1 us-channel 7cable upstream bonding-group 1upstream 0upstream 1


Dynamic Bonding GroupEnable ACFE

attributes 80000002cable upstream bonding-group 2upstream 2upstream 3attributes 80000000cable bundle 255end

Router# show cabRouter# show cable fibRouter# show cable fiber-node 1Fiber-Node 1

Channel(s) : downstream Integrated-Cable 3/0/1: 0-31Channel ID(s): 1 2 3 4 5 6 7 8 9 10 11 12 13 14

15 16 17 18 19 20 21 22 23 24 25 26 27 2829 30 31 32

Upstream-Cable 3/0/1FN Config Status: Configured (status flags = 0x01)MDD Status: Valid

Router# show running-config | sec fiber-node 1cable fiber-node 1downstream Integrated-Cable 3/0/1upstream Upstream-Cable 3/0/1

Example of OFDM configured in the fiber node and added as part of the dynamic bonding group.

Router# show cable dynamic-bonding-group summaryDynamic bonding group: EnableBG ID BG Name BG Size CMs ServFlows Create Time Create Client BGState RFid list9219 Wi1/0/4:2 33 36 36 Nov 7 01:56:27.406 MODEM_ONLINEOPERATIONAL 9216-9247, 93759220 Wi1/0/4:3 33 10 10 Nov 7 02:04:31.142 MODEM_ONLINEOPERATIONAL 9248-9279, 93759221 Wi1/0/4:4 8 1 1 Nov 7 02:06:09.949 MODEM_ONLINEOPERATIONAL 9248-9255

Router# show controller integrated-Cable 1/0/0 rf-channel 158Load for five secs: 8%/1%; one minute: 8%; five minutes: 8%Time source is NTP, *14:07:30.643 EST Fri Nov 17 2017Chan State Admin Mod-Type Start Width PLC Profile-ID dcid poweroutput

Frequency158 UP UP OFDM 258000000 48000000 279000000 100 159 34.0 NORMAL

Router# show cable fiber-node 10Load for five secs: 9%/0%; one minute: 9%; five minutes: 8%Time source is NTP, *13:59:39.571 EST Fri Nov 17 2017

---------------------------------------------------------------------------------

Fiber-Node 10Channel(s) : downstream Integrated-Cable 1/0/0: 0-63, 158Channel ID(s): 1 2 3 4 5 6 7 8 9 10 11 12 13 14

15 16 17 18 19 20 21 22 23 24 25 26 27 2829 30 31 32 33 34 35 36 37 38 39 40 41 4243 44 45 46 47 48 49 50 51 52 53 54 55 5657 58 59 60 61 62 63 64 159

Upstream-Cable 1/0/0FN Config Status: Configured (status flags = 0x01)MDD Status: Valid


Dynamic Bonding GroupConfigure Interface Mac-Domain and Fiber-Node

Enable Load Balancing for DOCSIS 3.0 and DOCSIS 3.1To enable DOCSIS load balancing, run the cable load-balance docsis-enable command. When DOCSIS loadbalancing is enabled, run the cable load-balance docsis30-enable command to enable load balancing forDOCSIS 3.0 and DOCSIS 3.1.

The cable load-balance docsis30-enable command enables load balancing for DOCSIS 3.0 and DOCSIS3.1.

Note

Enable DOCSIS 3.0 and DOCSIS 3.1 Static Load BalanceTo balance the load of primary channels, enable static load balance by running the following commands:

ROUTER# config tEnter configuration commands, one per line. End with CNTL/Z.ROUTER(config)# cable load-balance docsis30-enable staticROUTER(config)# endROUTER# show cable load-balanceDOCSIS LB Enabled: YesDOCSIS 2.0 LB Enabled: YesDOCSIS 3.0 LB Enabled: YesDOCSIS 3.0 Static LB Enabled: YesDOCSIS 3.0 Dynamic Downstream LB Enabled: No

Enable DOCSIS 3.0 and DOCSIS 3.1 General Load Balance GroupTo enable general load balance group, run the following commands:

Router# config tEnter configuration commands, one per line. End with CNTL/Z.Router(config)# cable load-balance docsis-group fn 1 md c3/0/1Router(config-lb-group)# no disableRouter(config-lb-group)# endRouter# show cable load-balanceDOCSIS LB Enabled: YesDOCSIS 2.0 LB Enabled: No159DOCSIS 3.0 LB Enabled: YesDOCSIS 3.0 Static LB Enabled: YesDOCSIS 3.0 Dynamic Downstream LB Enabled: YesDOCSIS 3.0 Dynamic Upstream LB Enabled: YesDOCSIS Status Interval DCC mask Policy Method Threshold


/UCC D/UM/E/U/P/SCa3/0/1 1 2147557888 E 90 0xF8(0)/N 0 u/u 0x91010B 5/10/70/70/50


Dynamic Bonding GroupEnable Load Balancing for DOCSIS 3.0 and DOCSIS 3.1

Enable Dynamic Load Balance and Fixed-Primary Channel Movement

To reduce service outage while enabling dynamic load balancing, enable fixed primary channel movement.Note

To balance the load of all of downstream channels based on utilization, enable dynamic load balance byrunning the following commands:

Router# config tEnter configuration commands, one per line. End with CNTL/Z.Router(config)# cable load-balance docsis30-enable dynamic downstreamRouter(config)# endRouter#Router# show cable load-balanceDOCSIS LB Enabled: YesDOCSIS 2.0 LB Enabled: NoDOCSIS 3.0 LB Enabled: YesDOCSIS 3.0 Static LB Enabled: YesDOCSIS 3.0 Dynamic Downstream LB Enabled: YesDOCSIS 3.0 Dynamic Upstream LB Enabled: YesDOCSIS Status Interval DCC mask Policy Method ThresholdGroup /UCC DS/US M/E/U/P/S1 GE 30 0xF8(0)/N 0 m/m 5/10/70/70/50


/UCC D/U M/E/U/P/SCa3/0/1 1 2147557888 E 90 0xF8(0)/N 0 u/u 0x91050A 5/10/70/70/50Router#Router# config tEnter configuration commands, one per line. End with CNTL/Z.Router(config)# cable load-balance fixed-primary-channelRouter(config)# endRouter#Router# show runRouter# show running-config | in fixedcable load-balance fixed-primary-channel

Verifying Dynamic Bonding Group ConfigurationTo verify that the DBGs are created:

Check themodem’s primarywideband interface by using the show cable modem wideband channel command:

Router# show cable modem 4800.33ee.ebee wideband channelMAC Address IP Address I/F MAC DSxUS Primary

State WB4800.33ee.ebee 30.132.15.246 C3/0/1/UB w-online 32x2 Wi3/0/1:3Router# scm 4800.33ee.ebee ver

Check the modem’s downstream tuner capability by using the show cable modem verbose | in DS Tunercommand.

Router# show cable modem 4800.33ee.ebee verbose | in DS TunerDS Tuner Capability : 32

Check the related RCC by using the show cable mac-domain rcc command:


Dynamic Bonding GroupEnable Dynamic Load Balance and Fixed-Primary Channel Movement

Router# show cable mac-domain c3/0/1 rccRCC-ID RCP RCs MD-DS-SG CMs WB/RCC-TMPL D3.0 D3.132 00 00 00 00 00 8 0 11 WB (Wi3/0/1:1) Y Y33 00 00 00 00 00 32 0 6 WB (Wi3/0/1:3) Y Y34 00 00 00 00 00 8 0 7 WB (Wi3/0/1:2) Y Y35 00 00 00 00 00 8 0 7 WB (Wi3/0/1:4) Y Y36 00 00 00 00 00 8 0 7 WB (Wi3/0/1:5) Y Y

Check the dynamically created bonding groups, use the show cable dynamic-bonding-group summarycommand as shown in the example below:

Router# show cable dynamic-bonding-group summaryDynamic bonding group: EnableBG ID BG Name BG Size CMs ServFlows Create Time Create Client BG StateRFid list24834 Wi3/0/1:1 8 11 11 Sep 14 14:36:35.194 MODEM_ONLINE OPERATIONAL24832-2483924836 Wi3/0/1:3 32 6 6 Sep 14 14:43:24.144 MODEM_ONLINE OPERATIONAL24832-2486324835 Wi3/0/1:2 8 7 7 Sep 14 17:20:37.115 MODEM_ONLINE OPERATIONAL24840-2484724837 Wi3/0/1:4 8 7 7 Sep 14 17:21:37.723 STATIC_LOAD_BALANCE OPERATIONAL24856-2486324838 Wi3/0/1:5 8 7 7 Sep 14 17:21:39.761 STATIC_LOAD_BALANCE OPERATIONAL24848-24855

Table 40: Dynamic Bonding Group States

Line card sends request to create DBG and waits forSUP to create the bonding group.

CREATE_WAITING_SUP

DBG is created from SUP, or bonding group revertsfrom reclaim to ready for use.

HOLD

If modem is used on the bonding group after theHOLD state times out, the DBG state changes toOPERATIONAL.

OPERATIONAL

Ready for reclaim.

If no modem is used on the bonding group or matchthe reclaim in two minutes, the bonding group isreclaimed. The DBG state changes toRECLAIM_HOLD.

RECLAIM_HOLD

Ready for reclaim.

The modem is moved out of the bonding group.

RECLAIM_MODEM_MOVING

Line card sends DBG reclaim request and waits forSUP to reclaim the BG.

RECLAIM_WAITING_SUP

To show the detailed channel list information of dynamic bonding group, use the show derived-configinterface wideband command.

Router# show derived-config interface wideband-Cable 3/0/1:1Building configuration...Derived configuration: 113 bytes


Dynamic Bonding GroupVerifying Dynamic Bonding Group Configuration

!interface Wideband-Cable3/0/1:1cable bundle 255cable rf-channels channel-list 0-7 bandwidth-percent 1

end

Check the usage of bonding group resource by using the show cable dynamic-bonding-group quota summary| slot | controller command.Router# show cable dynamic-bonding-group quota controller 3/0/1slot/subslot/ctrlr: 3/0/1Total BG number: 128Used BG number (static/dynamic): 6(1/5) Available BG number: 122Available BG list port: 0, 6-29, 31-127

128 BGs can be configured on one controller, but only 896 BGs are supported per CLC. All controllers sharethe 896 BG resources.

Note

Check the reclaimed bonding group by using the show cable dynamic-bonding-group reclaim-historysummary command:

Router# show cable dynamic-bonding-group reclaim-history summaryBG ID BG Name BG Size Create Time Create Client Reclaim Time Reclaim Client RFidlist24835 Wi3/0/1:2 16 Sep 14 14:40:27 MODEM_ONLINE Sep 14 14:44:27 DBG_INTERNAL24832-2484

Verifying Static Load Balancing ConfigurationTo verify if static load balancing is configured:

Check the load of all primary channels by using the show cable load-balance docsis-group fn 1 md cableload | in In command.

Router# show cable load-balance docsis-group fn 1 md c3/0/1 load | in InInterface State Group Utilization Rsvd NBCM WB/UB WeightIn3/0/1:0(573 MHz) initial 2147557888 0%(0%/0%) 0% 0 17 37In3/0/1:4(597 MHz) initial 2147557888 0%(0%/0%) 0% 0 17 37In3/0/1:8(621 MHz) initial 2147557888 0%(0%/0%) 0% 0 13 37In3/0/1:12(645 MHz) initial 2147557888 0%(0%/0%) 0% 0 13 37In3/0/1:16(669 MHz) initial 2147557888 0%(0%/0%) 0% 0 13 37In3/0/1:20(693 MHz) initial 2147557888 0%(0%/0%) 0% 0 13 37In3/0/1:24(717 MHz) initial 2147557888 0%(0%/0%) 0% 0 13 37In3/0/1:28(741 MHz) initial 2147557888 0%(0%/0%) 0% 0 13 37

This command output lists all primary channels and shows the number of cable modems used with thesechannels. NBCM is the number of narrow band modems used with a channel while WBCM (WB/UB) is thenumber of wideband modems used with a channel. The total number of WBCMs should be balanced amongall the channels.

The difference between the total number of WBCMs used with any two channels is smaller or equal to thethreshold load minimum. The default value of the threshold load minimum is 5.

Check the load of all rf channels by using the show cable load-balance docsis-group fn 1 md rfch-utilcommand.


Dynamic Bonding GroupVerifying Static Load Balancing Configuration

Router# show cable load-balance docsis-group fn 1 md c3/0/1 rfch-utilInterface Pstate Pending-In Pending-Out Throughput(Kbps) Util NBCM WBCMIn3/0/1:0 up No No 0 0% 0 17In3/0/1:1 NA No No 0 0% 0 17In3/0/1:2 NA No No 0 0% 0 17In3/0/1:3 NA No No 0 0% 0 17In3/0/1:4 up No No 0 0% 0 17In3/0/1:5 NA No No 0 0% 0 17In3/0/1:6 NA No No 0 0% 0 17In3/0/1:7 NA No No 0 0% 0 17In3/0/1:8 up No No 0 0% 0 13In3/0/1:9 NA No No 0 0% 0 13In3/0/1:10 NA No No 0 0% 0 13In3/0/1:11 NA No No 0 0% 0 13In3/0/1:12 up No No 0 0% 0 13In3/0/1:13 NA No No 0 0% 0 13In3/0/1:14 NA No No 0 0% 0 13In3/0/1:15 NA No No 0 0% 0 13…….Average: 0.0Variance: 0.0

This command lists the load information about the primary and secondary channels. WBCM is the numberof wideband modems used with a channel.

Check the cable modem’s internal state in load balancing using the show cable load-balance docsis-groupfn 1 md modem-list wideband command.

Router# show cable load-balance docsis-group fn 1 md c3/0/1 modem-list widebandCodes: M - Multicast, U - UGS, P - PCMM, F - Max-Failures, X - eXcluded

L - L2vpn, R - RSVP, S - DS-ResiliencyPrimary WB MAC Address Primary DS RCC-ID Priority MUPFXLRS StateWi3/0/1:0 (3)

c8fb.2631.0e56 In3/0/1:20 41 0 ------ LB_CM_HOLD_EXPIRE_IN36

c8fb.26a6.c3dc In3/0/1:16 41 0 ------ LB_CM_HOLD_EXPIRE_IN37

c8fb.2631.0d7e In3/0/1:16 41 0 ------ LB_CM_HOLD_EXPIRE_IN43Wi3/0/1:1 (9)

c8fb.2631.0c80 In3/0/1:0 32 0 ------ LB_CM_STATIC_MOVING

c8fb.2631.0cae In3/0/1:0 32 0 ------ LB_CM_STATIC_READY

c8fb.2631.0db0 In3/0/1:24 42 0 ------ LB_CM_STATIC_MOVING

c8fb.2631.0c10 In3/0/1:28 42 0 ------ LB_CM_STATIC_MOVING

c8fb.2631.0d80 In3/0/1:16 41 0 ------ LB_CM_STATIC_MOVING

c8fb.2631.0d26 In3/0/1:24 41 0 ------ LB_CM_STATIC_MOVING

a4a2.4a2d.b4aa In3/0/1:20 41 0 ------ LB_CM_STATIC_MOVING

c8fb.2631.0e5c In3/0/1:0 32 0 ------ LB_CM_STATIC_MOVING

c8fb.2631.0cb0 In3/0/1:0 32 0 ------ LB_CM_STATIC_MOVINGWi3/0/1:2 (3)

c8fb.2631.0d2a In3/0/1:12 34 0 ------ LB_CM_HOLD_EXPIRE_IN27

c8fb.2631.0e5a In3/0/1:12 34 0 ------ LB_CM_STATIC_MOVING


Dynamic Bonding GroupVerifying Static Load Balancing Configuration

c8fb.2631.0bfe In3/0/1:8 34 0 ------ LB_CM_STATIC_MOVINGWi3/0/1:3 (2)

4800.33ea.54be In3/0/1:28 33 0 ------ LB_CM_DYNAMIC_READY

4800.33ee.ebe6 In3/0/1:20 33 0 ------ LB_CM_HOLD_EXPIRE_IN1Wi3/0/1:4 (2)

c8fb.2631.0e44 In3/0/1:24 42 0 ------ LB_CM_HOLD_EXPIRE_IN40

c8fb.2631.0a44 In3/0/1:28 42 0 ------ LB_CM_HOLD_EXPIRE_IN42

Table 41: Cable Modem States

DescriptionCM state

Modem is ready for static load balance movement.LB_CM_STATIC_READY

Modem is in movement triggered via static LB.LB_CM_STATIC_MOVING

Modem is in hold for the next movement. The defaulthold time is 600 seconds.

LB_CM_HOLD_EXPIRE_IN

Modem is ready for dynamic load balancemovement.LB_CM_DYANMIC_READY

Modem is in movement triggered via dynamic LB.LB_CM_DYANMIC_MOVING

Modem is not ready for movement. If the modemfailuremovement count reachesmax-failure threshold,then set the modem in LB_CM_DISABLED to avoidfurther movement.

LB_CM_DISABLED

Verifying Dynamic Load Balancing ConfigurationCheck the utilization of all rf channels by using show cable load-balance docsis-group fn 320 md rfch-utilcommand.

Router# show cable load-balance docsis-group fn 320 md c3/0/0 rfch-utilInterface Pstate Pending-In Pending-Out Throughput(Kbps) Util NBCM WBCMDo3/0/0:0 up No No 11754 31% 0 308Do3/0/0:1 up No No 11754 31% 0 296Do3/0/0:2 up No No 11754 31% 0 333Do3/0/0:3 up No No 11754 31% 0 296Do3/0/0:4 up No No 11754 31% 0 297Do3/0/0:5 up No No 11754 31% 0 331Do3/0/0:6 up No No 11754 31% 0 299Do3/0/0:7 up No No 11753 31% 0 268Do3/0/0:8 up No No 11754 31% 0 302Do3/0/0:9 up No No 11754 31% 0 331Do3/0/0:10 up No No 11753 31% 0 308Do3/0/0:11 up No No 11754 31% 0 305Do3/0/0:12 NA No No 12862 34% 0 258Do3/0/0:13 NA No No 12862 34% 0 258Do3/0/0:14 NA No No 12862 34% 0 258…….Average: 30.416Variance: 1.701


Dynamic Bonding GroupVerifying Dynamic Load Balancing Configuration

The traffic among all rf channels is considered balanced when the difference between any two rf channelutilization is under the threshold load. The default value of threshold load is 10%.

To check the potential target bonding group for each of the source bonding group, use the show cableload-balance docsis-group fn md cable target dbg and the show cable load-balance docsis-group fn mdtarget wide command.

Router# show cable load-balance docsis-group fn 320 md c3/0/0 target dbgInterface Bg-Id Size Group TargetWi3/0/0:0 24577 4 2147557695Wi3/0/0:3 24580 4 2147557695Wi3/0/0:4 24581 8 2147557695Wi3/0/0:5 24582 8 2147557695Wi3/0/0:6 24583 24 2147557695 33% [24576, 24584-24587, 24589-24607]Wi3/0/0:7 24584 16 2147557695 30% [24576, 24586-24587, 24595-24607]Wi3/0/0:8 24585 16 2147557695Wi3/0/0:9 24586 32 2147557695Wi3/0/0:10 24587 24 2147557695 33% [24576, 24584-24587, 24589-24607]Wi3/0/0:11 24588 8 2147557695Wi3/0/0:12 24589 8 2147557695 27% [24596-24603]Wi3/0/0:13 24590 8 2147557695Wi3/0/0:14 24591 4 2147557695

Router# show cable load-balance docsis-group fn 5 md c1/0/4 target wideInterface Bg-Id State Group TargetWi1/0/4:2 9219 up 2147510276 Wi1/0/4:4Wi1/0/4:3 9220 up 2147510276Wi1/0/4:4 9221 up 2147510276

If no target bonding groups are displayed, no bonding groups are created to balance traffic among rf channels.

A sample output with DOCSIS 3.1 modems with configured threshold of 14% is shown below. For utilizationbased load balancing to start on DOCSIS 3.1 modems, the OFDM channel must be 100% utilized and trafficmust flow on SC-QAM. The utilization based load balancing balances the traffic flowing on the SC-QAMchannels in a D31 modem.

Router# show cable load-balance docsis-group fn 5 md c1/0/4 rfch-utilInterface Pstate Pending-In Pending-Out Throughput(Kbps) Util NBCM WBCMIn1/0/4:0 up No No 10632 28% 0 45In1/0/4:1 NA No No 11226 29% 0 41In1/0/4:2 NA No No 11225 29% 0 41In1/0/4:3 NA No No 11225 29% 0 41In1/0/4:4 down No No 11225 29% 0 41In1/0/4:5 down No No 11225 29% 0 41In1/0/4:6 down No No 11225 29% 0 41In1/0/4:7 down No No 11225 29% 0 41In1/0/4:8 up No No 10620 28% 0 43........In1/0/4:35 NA No No 6646 17% 0 6In1/0/4:36 NA No No 6646 17% 0 6In1/0/4:37 NA No No 6647 17% 0 6In1/0/4:38 NA No No 6646 17% 0 6In1/0/4:39 NA No No 6647 17% 0 6In1/0/4:40 up No No 6088 16% 0 6In1/0/4:41 NA No No 6648 17% 0 6In1/0/4:42 NA No No 6647 17% 0 6In1/0/4:43 NA No No 6647 17% 0 6In1/0/4:44 NA No No 6646 17% 0 6In1/0/4:45 NA No No 6646 17% 0 6In1/0/4:46 NA No No 6647 17% 0 6


Dynamic Bonding GroupVerifying Dynamic Load Balancing Configuration

In1/0/4:47 NA No No 6648 17% 0 6In1/0/4:48 NA No No 6648 17% 0 6In1/0/4:49 NA No No 6648 17% 0 6In1/0/4:50 NA No No 6646 17% 0 6In1/0/4:51 NA No No 6648 17% 0 6In1/0/4:52 NA No No 6647 17% 0 6In1/0/4:53 NA No No 6648 17% 0 6In1/0/4:54 NA No No 6647 17% 0 6In1/0/4:55 NA No No 6648 17% 0 6In1/0/4:56 NA No No 6647 17% 0 6In1/0/4:57 NA No No 6647 17% 0 6In1/0/4:58 NA No No 6646 17% 0 6In1/0/4:59 NA No No 6645 17% 0 6In1/0/4:60 NA No No 6646 17% 0 6In1/0/4:61 NA No No 6646 17% 0 6In1/0/4:62 NA No No 6647 17% 0 6In1/0/4:63 NA No No 6647 17% 0 6In1/0/4:159 NA No No 1819685 100% 0 47

Feature Information for Dynamic Bonding GroupUse Cisco Feature Navigator to find information about the platform support and software image support.Cisco Feature Navigator enables you to determine which software images support a specific software release,feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An accounton the Cisco.com page is not required.


Note

Table 42: Feature Information for for Dynamic Bonding Group


This feature was introduced on the Cisco cBR SeriesConverged Broadband Routers.


Dynamic BondingGroup


Dynamic Bonding GroupFeature Information for Dynamic Bonding Group



Dynamic Bonding GroupFeature Information for Dynamic Bonding Group

C H A P T E R 13Spectrum Management and Advanced SpectrumManagement

This chapter describes the spectrummanagement features supported for the Cisco Cable Modem TerminationSystem (CMTS) routers. Spectrum management support is divided into two main groups:

• Guided and scheduled spectrum management features (supported in software)

• Intelligent and advanced spectrum management features (supported in hardware only on specific cableinterfaces)

• Finding Feature Information, on page 233• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 234• Prerequisites for Spectrum Management, on page 235• Restrictions for Spectrum Management, on page 235• Information About Spectrum Management, on page 237• How to Configure Spectrum Management, on page 252• Monitoring Spectrum Management, on page 269• Configuration Examples, on page 275• Additional References, on page 282• Feature Information for Spectrum Management and Advanced Spectrum Management, on page 283








Note













Digital PICs:


•














Spectrum Management and Advanced Spectrum ManagementHardware Compatibility Matrix for the Cisco cBR Series Routers

Prerequisites for Spectrum ManagementEnsure that your network is designed to support reliable broadband data transmission. At minimum, yournetwork must include:

• A Dynamic Host Configuration Protocol (DHCP) server to assign IP addresses to cable modems orset-top boxes on the hybrid fiber-coaxial (HFC) network. This can be a Cisco CMTS router that has beenconfigured to act as the DHCP server.

• If you are not using cable interface line cards with integrated upconverters, youmust install the appropriateIF-to-RF external upconverter between the Cisco CMTS router and the combiner.

The term “combiner” refers to all cables, amplifiers, and taps at the headend orcable distribution center that connect the Cisco CMTS router to the HFC network.

Note

• Diplex filters installed in the downstream RF path between the cable modems and the cable interfacecards in the router. RG-59 headend coaxial cable with the maximum braid available (60 percent + 40percent braid), double foil, and the correct connector for this cable.

• Avoid frequencies with known ingress problems such as amateur radio bands or short-wave bands.

• Avoid hostile spectrums below 20 MHz.

• When designing your channel plan, allow extra bands for frequency hopping.

• Use the receive power level setting to perform slight equalization adjustments.

• Due to the nature of CATV technology, upstream noise management is a significant issue.We recommendthat you follow the rigorous North American plant maintenance procedures documented in the NCTASupplement on Upstream Transport Issues (available from the National Cable and TelecommunicationsAssociation, https://www.ncta.com ) to adjust return amplifiers and lasers.

Restrictions for Spectrum ManagementThis section describes the restrictions for the following spectrum management features:

Shared Spectrum Groups• Advance spectrum management does not support inter-line-card shared spectrum groups.

• Guided spectrum management does support inter-line-card shared spectrum groups.

Dynamic Upstream Modulation• The Cisco CMTS router has one preconfigured (primary) modulation profile that defines a typical profilefor quadrature phase-shift keying (QPSK)modulation. To use the Dynamic UpstreamModulation feature,youmust create a secondarymodulation profile that has a highermodulation scheme than the preconfigured


Spectrum Management and Advanced Spectrum ManagementPrerequisites for Spectrum Management

http://www.ncta.com

profile. The Three Step Dynamic Modulation feature allows you to create and use a third modulationprofile. However, the third modulation profile is optional.

• Upstream modulation profiles are assigned to upstream ports and affect all cable modems on thoseupstream ports.

• Modulation profiles affect the physical layer of the cable network, so only trained technicians who arefamiliar with the Data-over-Cable Service Interface Specifications (DOCSIS) specifications should createmodulation profiles.

• When using the Dynamic Upstream Modulation feature with Voice over IP (VoIP) services, frequentchanges to the upstream modulation or channel width could briefly impact the quality of voice calls.

Fixed-Frequency Spectrum Groups with Advanced Spectrum ManagementDo the following to configure fixed-frequency spectrum groups:

Router(config)#controller upstream-cable 9/0/15Router(config-controller)#us-channel 0 spectrum-group nRouter(config-controller)#us-channel 0 channel-width 1600000

Limitations on Upstream Modulation Parameters for PacketCable VoIP CallsWe recommend the use of a channel width that is 1.6Mhz, 3.2Mhz, or 6.4Mhz while configuring upstreamsfor PacketCable operations and VoIP calls. (All DOCSIS channel widths and upstream parameter combinationsare supported, but not optimum when offering VoIP.)

N+1 Redundancy SupportN+1 redundancy requires the working and protect cable interface line cards to be identical. This ensures thatthe protect interface supports the same exact configuration as the working interface.

When protecting cards that support intelligent and advanced spectrum management, a switchover preservesthe spectrum management configuration, and the protect interface initially uses the same upstream frequencyas the working interface. The protect interface does not begin using the advanced spectrum managementfeatures until the system stabilizes to avoid any unnecessary frequency hops or channel width changes.

Intelligent and Advanced Spectrum Management Support• Cable interfaces use standard DOCSIS, EuroDOCSIS, and the extended Japanese frequency ranges (5to 85MHz for upstream interfaces) to support the intelligent and advanced spectrummanagement features.

• Intelligent and advanced spectrum management features are supported only in the DOCSIS 1.0 andDOCSIS 1.1 Time Division Multiple Access (TDMA) mode of operation. These features cannot be usedwhen a cable interface is operating in the DOCSIS 2.0 mixed, Advanced TDMA (A-TDMA), andSynchronous Code Division Multiple Access (S-CDMA) modes of operation. Similarly, these featuresare also not available when the cable interface is configured to use multiple logical channels. However,these restrictions do not apply for guided spectrum management.


Spectrum Management and Advanced Spectrum ManagementFixed-Frequency Spectrum Groups with Advanced Spectrum Management

• Upstream channels must meet the carrier-to-noise plus interference ratio (CNiR [CNR]), andcarrier-to-ingress power ratio values given in the DOCSIS specifications. The minimum value for bothparameters is 25 dB in the 5 to 65 MHz frequency range.

• The intelligent and advanced spectrummanagement features do not support inter-line card shared spectrumgroups. Spectrummanagement features require that upstream ports on different line cards have their ownRF domain (a unique set of non-overlapping frequencies).

• N+1 redundancy is not supported on any cable interface line card that has defined spectrum groups,which typically is the normal configuration for advanced spectrum management.

• The intelligent and advanced spectrum management feature is activated by assigning spectrum groupson cards with built-in spectrum analyzer.

Information About Spectrum ManagementSpectrum management allows a Cisco Cable Modem Termination System (CMTS) to sense upstream plantimpairments, report them to amanagement entity, and automatically correct themwhere possible. The spectrummanagement feature performs these functions without reducing throughput or latency and without creatingadditional packet overhead on the radio frequency (RF) plant.

In particular, because the cable interfaces on the router receive upstream packets, it can directly detect upstreamtransmission errors. The router can also indirectly monitor the condition of the plant by keeping a record ofmodem state changes, such as the number and frequency of cable modems that are “flapping” (modems thateither miss a station maintenance message or that go offline and then come back online).

For more information about the cable modem flapping and how to monitor the cable modem flap list, see theFlap List Troubleshooting for the Cisco CMTS Routers .

Note

Spectrum management can prevent long-term service interruptions caused by upstream noise events in thecable plant. It is also used for fault management and troubleshooting the cable network. When cable modemsare detected to go online and offline by flap detectors, the cable operators can look at the flap list and spectrumtables to determine the possible causes.

Because of the nature of cable television (CATV) technology, upstream noise management is a significantissue. Frequency bands must have a sufficient CNR (CNiR) and carrier-to-ingress power ratio to support thetransmission of QPSK and quadrature amplitude modulation (QAM) data. The DOCSIS sets the minimumvalue for both of these ratios to 25 dB in the 5 to 65 MHz frequency range. If the CNR (CNiR) drops below25 dB on a particular channel due to noise, the cable modem on that channel degrades and can drop off thehybrid fiber-coaxial (HFC) network.

This overview contains the following subsections:

• SpectrumManagementMeasurements, on page 238—Provides an overview of fundamental concepts andterms that are used in spectrum management.

• Upstream Signal Channel Overview, on page 241—Describes how signals are sent and how changesoccur in upstream channels.

• Upstream Segments and Combiner Groups, on page 242—Describes sparse and dense segments andcombiner groups.


Spectrum Management and Advanced Spectrum ManagementInformation About Spectrum Management

http://www.cisco.com/en/US/docs/ios/cable/configuration/guide/cmts_flaplst_trbsh.html

• Frequency Management Policy, on page 243—Describes the types of noise impairments and how tocounteract ingress noise with spectrum groups and frequency hopping.

• Guided and Scheduled SpectrumManagement, on page 245—Describes the following guided and scheduledspectrum management features: frequency hopping capabilities, dynamic upstream modulation(signal-to-noise ratio-based), and input power levels.

• Intelligent and Advanced Hardware-Based Spectrum Management, on page 250—Describes spectrummanagement features that are supported by a number of cable interface line cards that have onboardspectrum management hardware. These features include a real-time spectrum analyzer, CNR-based,proactive frequency hopping, and a more robust dynamic upstream modulation.

• Benefits, on page 250—Describes the spectrummanagement features provided on the Cisco CMTS routerplatforms.

Spectrum Management MeasurementsMeasuring the signal-to-noise ratio (SNR [MER]) and carrier-to-noise ratio (CNR [CNiR]) are the major waysof determining the quality of a downstream or upstream signal. The following sections provide an overviewof these two ratios, as well as explaining the differences between them, and some additional values that mightbe useful:

Signal and Carrier Noise RatiosMeasuring the Modulation Error Ratio (MER [SNR]) and CNR (CNiR) of a downstream or upstream is thefirst step in determining the quality of the signal, and whether spectrum management needs to be performedto correct any errors. The following are brief descriptions of these two values:

• Modulation Error Ratio (MER [SNR])—This is an estimate of the signal strength on the upstream afteringress noise cancellation is performed. This means that the MER (SNR) takes into account a variety ofmodulation impairments, including frequency response distortions (such as in-channel amplitude tilt andripple), group delay, microreflections, and phase noise. The MER (SNR) is a good gauge of the overallend-to-end quality of the cable network, because it includes the impact that the transmitter circuitry,receiver circuitry, and transmission media have on the upstream signal.

• Carrier-to-Noise Ratio (CNR)—This is an ratio of the measured modulated power, in dB, on the upstream(before ingress noise cancellation is done) that compares the channel power to the noise power.

The term CNiR is part of the CableLabs nomenclature for the CNR measurement. Therefore these twoterms, CNR and CNiR, can be used interchangeably.

The CNR (CNiR) measurement is usually provided only by an external spectrum analyzer, but the cableinterface line cards that support intelligent and advanced hardware spectrum management features alsoprovide CNR (CNiR) measurement.

The following two types of CNR (CNiR) measurements are supported on the Cisco CMTS:

• CNR (CNiR) measured for a particular upstream—This is the overall CNR (CNiR) for all of thecable modems on an upstream, which is determined by measuring the RF power of the upstreamreceiver at the cable interface. This value is always just a snapshot in time for a particular upstream.The cable interface measures the RF power at a time when no bursts are expected from the cablemodems, but it can be skewed by a small number of cable modems that are experiencing or creatingsignal problems.


Spectrum Management and Advanced Spectrum ManagementSpectrum Management Measurements

• Per-modem CNR (CNiR)—This is the CNR (CNiR) for a particular cable modem, which is signalstrength of the burst transmissions of the modem at the upstream receiver of the cable interface.The per-modemCNR (CNiR)measurement is a very accurate measure of a particular cable modem’ssignal, but you should not use a single modem’s CNR (CNiR) to make assumptions about othercable modems on that upstream or about the upstream itself. However, you can get a good pictureof the upstream’s signal quality by polling the CNR (CNiR) for a number of cable modems over arepresentative time period.

Changing the channel width has a direct impact on the CNR (CNiR). Doublingthe channel width (for example, from 400 KHz to 800 KHz) decreases the CNR(CNiR) for an upstream by approximately 3 dB. Cutting the channel width inhalf (for example, from 3.2 MHz to 1.6 MHz) increases the CNR (CNiR) for anupstream by approximately 3 dB.

Tip

Differences Between the MER (SNR) and CNR (CNiR) ValuesIn a perfect network, such as a test lab where the only impairment is additive white Gaussian noise (AWGN),you can expect the CNR (CNiR) and MER (SNR) values to be comparable throughout all of the allowablepower levels and frequency ranges. In a live network, however, it is expected that the MER (SNR) valueshould be a few dB lower than the CNR (CNiR) value, given that the MER (SNR) value takes into accountnoise impairments and distortions that are not accounted for by the CNR (CNiR) power measurements.

In general, when the CNR (CNiR) value is in the 15 to 25 dB range, you can expect the MER (SNR) valueto have a comparable value. The difference between the MER (SNR) and CNR (CNiR) values is expected tobe larger when the CNR (CNiR) value falls outside of the 15 to 25 dB range.

The table below provides a comparison between the MER (SNR) and CNR (CNiR) values, listing the majorreasons for why the MER (SNR) and CNR (CNiR) values might diverge on an active network that is passinglive traffic:

Table 44: Comparison of MER (SNR) and CNR (CNiR) in a DOCSIS Cable Network

Carrier-to-Noise (CNR)Signal-to-Noise (SNR)

Pre-detection measurement of the RFsignal.

Post-detection measurement of the RF signal.

Measurement of the RF frequency domain.Measurement of the baseband domain.


Spectrum Management and Advanced Spectrum ManagementDifferences Between the MER (SNR) and CNR (CNiR) Values

Carrier-to-Noise (CNR)Signal-to-Noise (SNR)

Measures only the RF modulated carrierpower versus noise power.

Includes the effect of signal distortions and impairments on thesignal. These include:

• Group delay in the channel such as occurs during operationnear the diplexer band edge.

• Channel amplitude variation and echoes.

• Data collisions.

• Microreflections.

• Narrow band ingress in the channel.

• Non-linearities in the cable plant.

• Phase noise.

• Poor selection of the preamble.

• Poor symbol fidelity in the transmission of a a cablemodem, despite a good MER (SNR) value.

• Unrecoverable carrier offsets.

• Unrecoverable symbol timing offsets.

Provides an indication of networkperformance (what the transmission mediaor network is doing to the signal).

Provides an indication of overall, end-to-end network quality(what the transmitter, receiver, and transmissionmedia are doingto the signal).

Real-time spectrum analysis.Average over time with current data traffic patterns, useful fortracking long-term trends in signal quality.

Does not reflect the MER (SNR) value aspart of its value.

Reflects the CNR (CNiR) value as part of its value.

Unaffected by the type of traffic beingtransmitted.

Averaged over 10,000 symbols, and an accurate reading requiresthat short and long grants are being transferred.

Unaffected by uncorrectable FEC packetbursts.

Does not use packets with uncorrectable FEC errors to determineits value. Bursts of uncorrectable errors, therefore, could resultin a deceptively high MER (SNR) value.

Minimum downstream CNR of 35 dB in a6-MHz band (44 dB in DOCSIS 2.0 for8-MHz band)

Minimum upstreamCNR (CNiR) of 25 dB.

DOCSIS specifications do not define any required MER (SNR)values for upstreams and downstreams.

Additional MeasurementsIn addition to MER (SNR) and CNR (CNiR) values, you should be aware of and monitor the followingindicators of signal quality:


Spectrum Management and Advanced Spectrum ManagementAdditional Measurements

• MER—This is the measure of RF signal quality, in dB, which is equivalent to SNR and similar to CNR(CNiR) under additive white Gaussian noise (AWGN) impairments. However, MER is preferred for datanetworks, because it also includes additional factors that affect the signal, such as analog-to-digital anddigital-to- analog conversions, rounding errors, distortions, and signal impairments such as phase noise,group delay, and jitter. For this reason, the DOCSIS 2.0 RF specification adds a requirement for theminimum MER value for a signal, supplementing the existing CNR (CNiR) minimum requirements.

A simple formula for calculating the MER value for an upstream is:

MER = 20 x log (RMS error magnitude / Average symbol magnitude)

You can also calculate the Error Vector Modulation (EVM) to find the equivalent value expressed as apercentage of noise on an upstream:

EVM = Average error magnitude / Max symbol magnitude * 100

See the DOCSIS 2.0 specification for more complete information on calculating and using the MERvalue.

• FEC Counters—These are counters that keep track of how many correctable and uncorrectable FECerrors occur on the upstream. The FEC error counters are useful for tracking fast transient errors such asimpulse noise that are not usually reflected in MER (SNR) or CNR (CNiR) values.

A correctable error count of more than 1 percent can be used as a warning sign of possible physical plantor cable modem problems that might be developed. An uncorrectable error count of more than 1 percentcan indicate an existing problem that is blocking traffic on the upstream. Cable interface line cards thatsupport the intelligent and advanced spectrum management features can use the FEC counters as one ofthe indicators to be monitored to determine whether an upstreammust change frequencies so as to correctnoise problems.

• Microreflections—Additional copies of a signal that arrive at the receiver, usually at different times andattenuated by different amounts, causing the receiver to misidentify the incoming signal’s true phase andamplitude. Microreflections typically are caused by impedance mismatches in the physical cable plant,and can indicate either equipment that has been degraded by weather or other causes, or equipment thathas not been installed correctly.

Upstream Signal Channel OverviewThe upstream channel is characterized bymany cable modems transmitting to the CMTS. These signals operatein a burst mode of transmission. Time in the upstream channel is slotted. The CMTS provides time slots andcontrols the usage for each upstream interval. The CMTS periodically broadcasts UpstreamChannel Descriptor(UCD) messages to all cable modems. The UCD message contains the upstream frequency and transmissionparameters associated with an upstream channel. These messages define upstream channel characteristicsincluding the upstream frequencies, symbol rates and modulation schemes, forward error correction (FEC)parameters, and other physical layer values.

Cisco supports all DOCSIS error-correction encoding and modulation types and formats. Upstream signalsare demodulated using QPSK or QAM. QPSK carries information in the phase of the signal carrier, whereasQAM uses both phase and amplitude to carry information.

Sending data reliably in the upstream direction is an issue. Because upstream spectrum varies greatly betweencable plants, select upstream parameters based on your cable plant’s return paths. Select or customize upstream


Spectrum Management and Advanced Spectrum ManagementUpstream Signal Channel Overview

profiles for the maximum trade-off between bandwidth efficiency and upstream channel robustness. Forexample, QAM-16 requires approximately 7 dB higher CNR (CNiR) to achieve the same bit error rate asQPSK, but it transfers information at twice the rate of QPSK.

The above specifications are based on predetermined sets of frequencies that may or may not have an adequateCNR (CNiR) at any given time.

Note

Upstream frequencies can be assigned as follows:

• Fixed—Configuring a spectrum group disables the fixed upstream frequency setting.

• Single subband—The CMTS administrator can define a center frequency and symbol rate such that theboundaries of the upstream carrier stay within the subband. The frequency and symbol rate can changewithin the boundary in response to noisy line conditions, based on the defined upstream parameters.

• Multiple subbands—The data carrier can remain in a particular subband for a duration of time and thenhop to another subband based on the defined upstream parameters.

Measurement of noise power levels with a spectrum analyzer should be part of the procedure in initiallyselecting and setting up frequency allocations. We recommend having fixed frequency settings during earlydeployment, at least until amplifier cascade adjustments or plant repair have become infrequent enough thatthey no longer significantly affect the nodes connected to the upstream port.

Tip

Upstream Frequency Changes

As stated in the DOCSIS radio frequency interface (RFI) specification, RF channel migration or upstreamfrequency change occurs when a change in the UCD message is broadcast to all cable interfaces.

The speed of channel migration via the UCD message is typically less than 20 milliseconds (ms). During thistime, upstream transmission is interrupted until the cable interface transmitter adjusts to its new frequency.Data is stored in the cable interface buffers during this time and is sent when the frequency hop is complete.

Station maintenance intervals are used to perform per modem keepalive polling. The CMTS polls each cablemodem at least once every 30 seconds, with the default being once every 20 seconds. When ingress noisecauses loss of keepalive messages from a configurable percentage of all cable interfaces, resulting in missedpolls, a new frequency is selected from the allocation table and a UCD update is performed. The migrationtime is 2 msec for any upstream UCD update. After the UCD is updated, the hop occurs. The system mustwait until a hop threshold time interval has elapsed before it can change the UCD a second time.

Upstream Segments and Combiner GroupsThe Cisco routers divide a cable plant into downstream channels. Downstream channels contain upstreamsegments. Each upstream segment typically serves more than one fiber node. Upstream segments can bedefined as one of the following:

• Sparse segment—Containing one upstream channel per upstream segment.

• Dense segment—Containing multiple upstream channels per upstream segment; frequencies must bedifferent.


Spectrum Management and Advanced Spectrum ManagementUpstream Segments and Combiner Groups

A cable interface line card can support sparse or dense segments, or both.Note

Defining sparse segments allows the cable operator to share upstream bandwidth among fiber nodes withfewer subscribers. Defining dense segments allows the cable operator to provide larger upstream bandwidthto fiber nodes with many subscribers.

The figure below illustrates sparse versus dense segments.

Figure 1: Sparse Versus Dense Segment Illustrations

As shown in the figure above, the downstream segment can contain multiple upstream segments. Two fibernodes can be in one downstream segment but in different upstream segments.

The return path of several fiber nodes can be combined at a single point to form a single RF frequency domaincalled a combiner group. The CMTS software allows a frequency hop table called a spectrum group to beassociated with a combiner group.

A combiner group refers to an RF topology point. A spectrum group refers to the frequency hop table associatedwith a combiner group.

Note

Frequency Management PolicySpectrum management applies a common frequency-management policy to a set of upstream ports to ensurethat data is delivered reliably over the cable plant. Cable plant operators must make noise measurements anddetermine the cable plant’s spectrummanagement policy. Different modulation schemes, upstream frequencytechniques, and symbol rates are used based on the cable plant characteristics and the cable interface line cardin the chassis.


Spectrum Management and Advanced Spectrum ManagementFrequency Management Policy

See the following sections for more information about these topics:

Noise ImpairmentsUpstream noise impairments such as signal degradation on cable networks can negatively affect service tosubscribers. Two-way digital data signals are more susceptible than one-way signals to stresses in the conditionof the HFC network. Degradation in video signal quality might not be noticeable in one-way cable TV service,but when two-way digital signals share the network with video signals, digital signals can be hampered by:

• Impulse and electrical signal ingress—Noise can enter the network from electrical sources within aresidence or from high-voltage lines that run near cable television cabling. Two types of ingress noiseinclude broadband and narrowband. Broadband noise is generally of lower frequency (below 10 MHz)and results in harmonic rolloff. Narrowband noise is a more significant interference source. Cableequipment and infrastructure often pick up noise from amateur radio transmissions, citizen band radios,or high-power shortwave broadcast signals. Implement a signal leakage maintenance program to locateand repair areas of signal ingress.

• Amplifier noise—Amplifiers add noise to the HFC network that typically goes unnoticed in video signals,but degrades digital data signals if amplifiers are improperly configured. The larger the network, thehigher the probability of amplifier noise affecting signals.

• Noise funneling—The upstream data path to the headend is susceptible to interference from the entirenetwork. All upstream noise ultimately ends up at the headend because the cumulative nature of noisebecomes concentrated at the headend. As a network serviced by a single RF receiver increases in size,the probability of noise funneling also increases.

• Variable transmit levels—Temperature affects signal loss over coaxial cable. This can cause variationsof 6 to 10 dB per year.

• Clipping—The lasers in fiber-optic transmitters can stop transmitting light when input levels are excessive.Excessive input levels introduce bit errors in both the upstream and downstream transmissions. If a laseris overdriven as briefly as a fraction of a second, clipping can occur.

To adjust your return amplifiers and lasers, follow rigorous plant maintenance procedures documented in theNTSC Supplement on Upstream Transport Issues or appropriate cable plant standard.

Spectrum Groups and Frequency HoppingWe recommend that CMTS administrators configure upstream frequency hopping to counteract long-term,narrowband noise. Cisco CMTS routers support a combination of guided frequency hopping and time-scheduledfrequency hopping.

The frequency hop to proactively avoid noise ingress is sometimes called frequency agility. Frequency agilityis configured and activated using spectrum groups. Spectrum management supports the creation of a numberof cable spectrum groups, allowing multiple upstream ports in a single spectrum group. Each spectrum groupdefines the table of frequencies to be used in a specific frequency plan. Upstream frequencies can be a fixedsingle frequency, a single continuous range of frequencies (band), or multiple ranges (or bands) of frequencies.

The cable interface does not operate until you assign a frequency to the upstream, which can be done eitherby configuring and assigning a spectrum group or assigning a fixed frequency. The spectrum group takesprecedence, so if you configure both a spectrum group and a fixed frequency on an upstream, the spectrumgroup overrides the fixed upstream frequency setting.

From the interface point of view, a spectrum group also represents the set of upstreams connected to the samegroup of fiber nodes. The spectrum manager software in Cisco routers examines all the RF parameters that


Spectrum Management and Advanced Spectrum ManagementNoise Impairments

have been configured on an upstream to determine whether the upstream frequencies need to be managedtogether. For example, if you configure a spectrum group with several fixed frequencies, but those frequenciesare all within the configured channel width, the spectrum manager software combines the frequencies into asingle band.

The upstream ports use the spectrum group to determine which frequencies are available if frequency hoppingis needed to deal with noise or other path impairments. The types of frequency hopping techniques are guided,time-scheduled, and combined guided and time-scheduled. See the Frequency Hopping Capabilities, on page245 for more information on the types of frequency hopping techniques.

When each upstream port has its own RF domain, the group is called a nonshared spectrum group. Whenmultiple upstream ports share the same RF domain, the group is called a shared spectrum group.

Note

Guidelines for Spectrum ManagementIn general, when defining your spectrum, use the following guidelines:

• Avoid frequencies with known ingress problems, such as amateur radio bands or short-wave bands.

• Avoid a hostile spectrum below 20 MHz.

• Allow extra bands for frequency hopping.

• Take the possible channel widths into account when creating frequency bands. The range of frequenciesbeing used must be able to hop between at least two different frequencies when using the channel widththat is configured on the upstream.

• Place upstream ports in the same combiner group in a shared spectrum group.


• If you combine multiple upstream ports to provide increased bandwidth, you must avoid overlappingfrequency bands. Each port should be using a discrete band of frequencies that does not overlap the bandsbeing used by other ports in the group. We recommend adding at least 20 KHz between the endingfrequency of one band and the starting frequency of the next band, to ensure that the bands do not overlap.

Guided and Scheduled Spectrum ManagementGuided and scheduled spectrum management constitutes a set of basic features for all currently supportedcable interface line cards. These features are considered basic because they are available for all cable interfaces,and constitute the elementary, cornerstone features upon which the intelligent and advanced spectrummanagement features are built.

See the following sections for more information about each feature:

Frequency Hopping CapabilitiesNoise in the upstream transmission line, that is from the consumer to the service provider, can degrade datatransmission from the subscriber’s home. If the noise impairment is of substantial duration, it may cause thecable modem to temporarily lose communication with the headend facility. As a contingency plan, the multipleservice operators (MSOs) can reserve multiple channels or upstream frequencies for their subscribers. If onechannel suffers too much interference, the CMTS requests that the cable modems “hop” to another channel.


Spectrum Management and Advanced Spectrum ManagementGuidelines for Spectrum Management

To provide frequency hopping capability, Cisco CMTS routers contain a spectrum manager that continuouslymonitors the noise in unused upstream channels. If the CNR (CNiR) reaches an unacceptable level on aparticular channel, the spectrum manager automatically assigns a new upstream channel to the cable modemusing that channel.

Cisco CMTS routers support the following techniques for upstream frequency hopping when the frequencyband in use is not clean:

• Guided frequency hopping—In guided frequency hopping (also known as blind hopping), the spectrummanager automatically assigns a new upstream channel frequency when a configurable threshold ofstation maintenance (keepalive) messages fails. Failed station maintenance messages represent animpairment of the upstream channel due to noise, plant, or equipment failure. Explicit frequency subbandsand associated input power levels are assigned in a spectrum group in guided frequency hopping.

• Time-scheduled frequency hopping—Frequency reassignment is scheduled by the time of day or by aspecific day of the week.

• Combined guided and time-scheduled frequency hopping.

Frequency hopping is not effective against broadband noise phenomena such as impulse noise.Note

Time-scheduled and guided hopping techniques are independent concepts:

• The spectrum is controlled by a script, not a frequency table.

• The available spectrum is time-scheduled as an option.

• A guided hopping frequency is selected from the available spectrum at the current time.

You can configure and activate frequency hopping by using spectrum groups. You can create up to 40 cablespectrum groups, each containing multiple upstream ports. The configured channel width is used for eachupstream frequency.

After you have created one or more spectrum groups for your cable network, you can add characteristics tothem, providing you with more definitive control over frequency usage and frequency hopping.

You can configure hopping thresholds. For example, the frequency hop threshold percentage method preventsa single failing cable modem from affecting service to other working cable modems. As long as a high enoughthreshold is configured, the system does not hop endlessly due to a single cable modem failing to respond to90 percent of its station maintenance (keepalive) messages.

You can also configure the minimum period between frequency hops, with a default setting of 30 seconds. Ifthe destination channel is expected to be impaired, you can reduce the minimum period between frequencyhops to a small value, such as 10 seconds. This allows the frequency hop to continue more rapidly until aclear channel is found. If excessive frequency hop is an issue, you can increase the minimum period betweenhops.

To configure different techniques of frequency hopping, see the Creating and Configuring Spectrum Groups,on page 253.

Spectrummanagement is not supported for one-way (telco return) cablemodems, because spectrummanagementcapabilities focus on the upstream path over an HFC network.

Note


Spectrum Management and Advanced Spectrum ManagementFrequency Hopping Capabilities

After the spectrum-band is changed, the spectrum management does not rearrange the frequency for each USchannel if the previous frequency belongs to the range of new spectrum-band, which means that the USfrequency will not be changed; if the previous frequceny is out of range of new spectrum-band, those USchannels will not get frequencies.

Note

Time-Scheduled Frequency Hopping

You can specify upstream channel frequency reassignment based on a configured time of every day or of aspecific day of the week. If your cable plant has an upstream noise characteristic on a weekly cycle, usetime-scheduled spectrum allocation. With a time-scheduled policy, a single frequency becomes valid at anygiven time.

Dynamic Upstream Modulation (MER [SNR]-Based)This section describes the operation of this feature, which is based on evaluating the MER (SNR) of anupstream.

A more advanced version of dynamic upstream modulation, which uses the carrier-to-noise ratio (CNR[CNiR]), is supported on the cards that support intelligent and advanced spectrum management.

Note

Feature Overview

Cisco cable interface line cards monitor theMER (SNR) values and the forward error correction (FEC) countersin the active return path of each upstream port. The Dynamic UpstreamModulation feature determines whetherupstream channel signal quality can support the modulation scheme configured, and adjusts to the most robustmodulation scheme when necessary. When return path conditions improve, this feature returns the upstreamchannel to the higher modulation scheme that includes the modulation profile.

A modulation profile is a collection of burst profiles that are sent out in a UCD message to configure modemtransmit parameters for the upstream. The Dynamic Upstream Modulation feature adjusts the modulationprofiles of an upstream channel based on upstream signal quality.

The Dynamic Upstream Modulation feature is configured on interfaces with fixed upstream frequencies oron interfaces with assigned spectrum groups.

The following examples show two different configurations of the Dynamic Upstream Modulation feature,using two and three modulation profiles.

Example Showing Dynamic Upstream Modulation Using Two Modulation Profiles

You can configure the Dynamic UpstreamModulation feature on the Cisco CMTS router using the followingprimary and secondary modulation profiles:

• The primary modulation profile uses 64-QAM or 16-QAM, which is a more bandwidth-efficientmodulation scheme and has a higher throughput than a QPSK profile.

• The secondary modulation profile uses QPSK, which uses a more robust modulation scheme, but is notbandwidth-efficient.


Spectrum Management and Advanced Spectrum ManagementDynamic Upstream Modulation (MER [SNR]-Based)

We recommend that the primary profile use 64-QAM or 16-QAM modulation and the secondary use QPSK.However, this is optional as both modulation profiles can either be QPSK or QAM. It is not mandatory forone profile to be QAM and the other QPSK, but modulation profile switchover is tied to the QAM and QPSKthresholds.

Example Showing Dynamic Upstream Modulation Using Three Modulation Profiles

You can configure the Dynamic UpstreamModulation feature on the Cisco CMTS router using the followingprimary, secondary, and tertiary modulation profiles:

• The primary modulation profile uses 64-QAM, which is a more bandwidth-efficient modulation schemeand has a higher throughput than a 16-QAM profile.

• The secondarymodulation profile uses 16-QAM,which is a more bandwidth-efficient modulation schemeand has a higher throughput than a QPSK profile.

• The tertiary modulation profile uses QPSK, which uses a more robust modulation scheme, but is notbandwidth-efficient.

We recommend that the primary profile use 64-QAM modulation, the secondary profile use 16-QAM, andthe tertiary profile uses QPSK. However, this is optional as the modulation profiles can either be QPSK orQAM. It is not mandatory that one is QPSK and the other two are QAM, but modulation profile switchoveris tied to the QAM and QPSK thresholds.

Criteria for Switching Modulation Profiles

The Dynamic Upstream Modulation feature uses the following criteria to determine whether it should switchfrom the primary modulation profile (the more bandwidth-efficient, but less robust profile) to the secondarymodulation profile (more robust, but less bandwidth-efficient profile) or to the (optional) tertiary modulationprofile (most robust, but less bandwidth-efficient profile):

The modulation switch from the primary profile (high performance) to the secondary profile (mid-levelperformance) uses the following criteria:

• The upstream MER (SNR) is less than or equal to MER (SNR) threshold one and the percentage ofcorrectable FEC (cFEC) errors is greater than or equal to the correctable FEC error threshold or thepercentage of uncorrectable FEC (uFEC) errors is greater than or equal to the uncorrectable FEC errorthreshold.

Before switching back to the primary profile from the secondary profile, the following criteria must be satisfied:

• The upstream MER (SNR) is greater than or equal to the sum of MER (SNR) threshold one and thehysteresis value and the percentage of correctable FEC errors is less than or equal to the correctable FECerror threshold and the percentage of uncorrectable FEC errors is less than or equal to the uncorrectableFEC error threshold and the hop period equals to the default value of 15 seconds.

The modulation switch from the secondary profile (mid-level performance) to the tertiary profile (most robust)uses the following criteria:

• The upstream MER (SNR) is less than or equal to MER (SNR) threshold two and the percentage ofcorrectable FEC (cFEC) errors is greater than or equal to the correctable FEC error threshold or thepercentage of uncorrectable FEC (uFEC) errors is greater than or equal to the uncorrectable FEC errorthreshold.

Before switching back to the secondary profile from the tertiary profile, the following criteria must be satisfied:


Spectrum Management and Advanced Spectrum ManagementCriteria for Switching Modulation Profiles

• The upstream MER (SNR) is greater than or equal to the sum of MER (SNR) threshold two and thehysteresis value and the percentage of correctable FEC errors is less than or equal to the correctable FECerror threshold and the percentage of uncorrectable FEC errors is less than or equal to the uncorrectableFEC error threshold.

The modulation switch from the primary profile to the tertiary profile uses the following criteria:

• The upstream MER (SNR) is less than or equal to MER (SNR) threshold two and the percentage ofcorrectable FEC (cFEC) errors is greater than or equal to the correctable FEC error threshold or thepercentage of uncorrectable FEC (uFEC) errors is greater than or equal to the uncorrectable FEC errorthreshold.

Before switching back to the primary profile from the tertiary profile, the following criteria must be satisfied:

• The modulation switch from the tertiary profile to the primary profile is a two-step process:

1. The modulation switch happens from tertiary profile to the primary profile, when the upstreamMER(SNR) is greater than or equal to the sum of MER (SNR) threshold one and the hysteresis value.

2. After a 15-second (non-configurable) delay, the modulation switch occurs from secondary profileto the primary profile, when the upstream MER (SNR) remains greater than or equal to the sum ofMER (SNR) threshold one and the hysteresis value.

If the only problem is that the upstream is experiencing a large number of uncorrectable errors, then a situationcould occur where the router continues to switch back and forth between profiles. The uncorrectable errorsoccur with the primary profile, so the router switches to the secondary profile. The secondary profile does notexperience any problems, so the router switches back to the primary profile. But the uncorrectable errorsreoccur and the router switches back to the secondary profile, and this cycle continues indefinitely.

To avoid this problem, make sure that the cable plant is capable of supporting the modulation scheme beingused in the primary profile (for example, 64-QAM). If you cannot guarantee successful operation on anupstream using this modulation scheme, then you should select a primary profile that uses a morebandwidth-efficient set of burst parameters (such as QPSK). The Cisco IOS software includes predefinedmodulation profiles that can be used for the primary, secondary, and tertiary profiles.

Input Power LevelsThe input power level, power-level-dBmV, is an option in the cable spectrum-group command. The optionallows you to specify the expected upstream input power levels on the upstream receivers on the CMTS whenthe cable modems are hopping from one fixed frequency to another or from one band to another. Each upstreamchannel width has an associated upstream input power level in dBmV. The power level is the modem transmitpower that each spectrum group can use when an upstream frequency change is necessary. The input powerlevel may be set at the time of the frequency hop.

Specifying an input power level is done so that the cable modems do not have to increase or decrease theirtransmit power with every hop. The cable operator can perform minor power equalizations as a function offrequency. The valid range is –10 to 10dBmV. The power level value should be changed only if you want tochange the power level as part of spectrum management. Some cable plants may want to change only theinput power level, and not the frequency, on a daily time schedule.


Spectrum Management and Advanced Spectrum ManagementInput Power Levels

Intelligent and Advanced Hardware-Based Spectrum ManagementSeveral cable interface line cards include hardware-based spectrum management features that provideenhancements to the basic features supported by the other Cisco cable interface line cards.

Intelligent Spectrum Management EnhancementsThe following features are part of the intelligent spectrum management feature set:

• Integrates a DOCSIS cable interface line card with an onboard spectrum analyzer that continuouslyanalyzes the upstream spectrum quality in the DOCSIS frequency range of 5 to 42 MHz.

• Includes hardware-assisted frequency hopping, providing for more intelligent and faster frequencyselection than software-only solutions.

• Reduces the response time to ingress noise that could cause modems to drop offline.

• Eliminates blind frequency hopping by initiating frequency hops to known clean channels.

• Improves frequency agility to help eliminate dropped packets and thereby maintain full upstream datarates.

• Supports frequency agility in dense-mode combining environments across a shared spectrum.

• Restricts frequency hopping to a set of discrete fixed frequencies or to a range of frequencies, as desired.

• Allows frequency hop conditions to be customized for specific plant environments and requirements.

• Optionally schedules frequency hops to take advantage of known usage patterns or plant conditions.

• Optionally dynamically reduces channel width to allow cable modems to remain online, even in noisyupstream conditions.

BenefitsThe spectrummanagement features provided on the Cisco CMTS router platforms provide several key systembenefits:

• Improves response time to ingress noise impairments that appear in the upstream return path.

• Boosts the percentage of modems online.

• Mitigates the impact of ingress to subscriber services.

• Saves time and effort by MSO staff when troubleshooting minor plant outages.

• Increases cable plant reliability.

• Maximizes spectrum utilization.

Guided and Scheduled Spectrum Management BenefitsThe following summarizes the specific benefits of the guided and scheduled spectrum management featuresthat are supported for all Cisco CMTS router platforms.


Spectrum Management and Advanced Spectrum ManagementIntelligent and Advanced Hardware-Based Spectrum Management

Input Power Levels

Allows the cable plant operator to perform minor power level equalization as a function of frequency.

Frequency Hopping Capabilities

Proactively countermeasures upstream noise impairments by assigning a new upstream channel to the cablemodem.MSOs can take advantage of this feature especially when they have less than an optimal carrier-to-noiseratio in the upstream frequencies or when their cable plants exhibit random bursts of ingress noise that affectreliability.

Dynamic Upstream Modulation

• Reduces the risk associated with transitioning to QAM-16 modulation in the return path and providesassurance that subscribers remain online and connected during return path impairments.

• Checks that the active upstream signal quality can support the configured modulation scheme andproactively adjusts to the more robust modulation scheme when necessary.

• Eliminates the necessity to hop channels for cable modems to stay online by automatically switchingfrom the primary modulation profile to the secondary modulation profile.

Intelligent and Advanced Spectrum Management BenefitsThe following summarizes the specific benefits of the advanced spectrum management features that aresupported on Cisco CMTS routers using supported cable interface line cards.

Dynamic Channel Width Change

• Improves the DOCSIS upstream channel availability by finding the maximum possible channel widthfor an upstream when noise conditions make the current channel width unusable.

• Provides the maximum RF spectrum utilization efficiency for current plant conditions.

• Customizable range of channel widths that can be used to respond to noise problems.

Intelligent Frequency Hopping

• Proactively changes upstream frequency for an interface before noise conditions become severe enoughto force cable modems offline.

• Dedicated hardware intelligent frequency hopping performs “look-ahead” to choose new upstreamfrequency to find a stable channel.

• Flexible priority configuration allows hopping decision criteria to be tailored to the individual cable plantenvironment.

• Improves responsiveness to ingress impairments, by matching the hopping decision criteria to thefluctuating plant conditions.

• Pinpoints CNR (CNiR) variations with per-modem accuracy to isolate problematic cable modems.

• Sustains or even improves subscriber online percentages through user-programmable proactive channelmanagement techniques.


Spectrum Management and Advanced Spectrum ManagementIntelligent and Advanced Spectrum Management Benefits

Dynamic Upstream Modulation

• Reduces the risk associated with switching between QPSK and QAM-16 modulation in the upstream torespond to ingress noise, so that subscribers remain online and connected.

• Checks the current upstream signal to ensure that it can support the configured modulation scheme, andproactively adjusts to the secondary more robust modulation scheme when necessary.

• Improves DOCSIS upstream channel availability and provides maximum RF spectrum utilizationefficiency.

• Eliminates unnecessary frequency hopping by switching modulation profiles to one that allows cablemodems to remain online while using the currently assigned upstream.

• Provides assurance that subscribers remain online and connected during periods of return path impairments.

SNMP Interface

• Provides a way to remotely obtain the current status of noise on an upstream. This information can thenbe inserted into third-party or custom reporting and graphing applications.

• Provides visibility to ingress and impulse noise under the carrier frequency on a per-port basis.

• Provides an easy-to-use, distributed method to remotely gather real-time display of the DOCSIS upstreamspectrum for individual cable modems and set-top boxes (STBs).

• Reduces the reliance on costly spectrum analyzers at every headend or hub.

• Quickly provides spectrum views through an intuitive interface, without the complicated setup time ofa spectrum analyzer.

• Allows the technician to troubleshoot the network remotely, as opposed to having to be physically presentto connect and use a spectrum analyzer.

Default Hop Priority

For Intelligent and Advanced Spectrum Management feature, the default hop priority is as given below:

• Frequency, modulation, and channel width (when using spectrum groups on spectrum cards).

• Modulation, guided frequency hop, and channel width (when using analyzer cards with spectrum groups).

• Modulation only (when not using spectrum groups [fixed frequency]).

How to Configure Spectrum ManagementThis section describes the configuration tasks that are most commonly performed when using the spectrummanagement features on the Cisco CMTS platforms. See the following sections for the configuration tasksthat are appropriate for your platform and cable interface line cards.


Spectrum Management and Advanced Spectrum ManagementHow to Configure Spectrum Management

Guided and Scheduled Spectrum Management Configuration TasksThe following tasks configure the guided and scheduled spectrum management features that are supportedon all Cisco CMTS platforms:

Creating and Configuring Spectrum GroupsA spectrum group defines the frequencies that an upstream is allowed to use when frequency hopping is done,as well as other parameters that control the frequency hops. When creating and configuring spectrum groups,you can specify the following parameters:

• Frequencies that are assigned to the group. The cable interface uses these frequencies to determine whatfrequencies are available to use when frequency hopping is needed. You can specify either a list of fixedfrequencies or a band of frequencies, or both. The Cisco CMTS uses the following rules when addingfrequencies to a spectrum group:

• When specifying a fixed frequency, the Cisco CMTS assumes it is a center frequency with a 6.4-MHzchannel width to allow that frequency to operate at all possible channel widths. For example,specifying a frequency of 17,700,000Hz is equivalent to specifying a frequency band from 14,500,000Hz to 20,900,000 Hz (a band that is 6.4 MHz wide).

• If you configure multiple fixed frequencies or bands of frequencies that overlap, the spectrum groupcombines them into one band. For example, if you specify a fixed frequency of 17,700,000 Hz anda band from 15,800,000 Hz to 25,200,000 Hz, the spectrum group is configured with one band from14,500,000 Hz to 25,200,00 Hz.

• If you want more control over a spectrum group’s frequencies, configure bands of frequencies withthe same width as the desired channel width. For example, if you want to use a center frequency of17,700,000 Hz with a 3.2-MHz channel width, specify a band that ranges from 16,100,000 Hz to19,300,000 Hz. To ensure you configure non-overlapping bands, separate the bands by a minimumof 20 KHz.

• Upstream input power level—(Optional) Power level, in dBmV, that the upstream should use whenhopping to a new frequency. (Some cable plants might want to change only the input power level, andnot the frequency, on a daily time schedule.)

• Hop threshold—(Optional) Percentage of cable modems that start missing station maintenancemessagesbefore a frequency hop can occur. Configure the hop threshold percentage as needed to prevent a singlefailing cable interface from affecting service to other good cable interfaces. This ensures that the systemdoes not hop endlessly because one cable modem is generating 90 percent of the errors and 90 percentof the traffic.

• Hop period—(Optional) Minimum time period that must elapse between frequency hops. This allowsyou to specify a time period long enough to allow an upstream to stabilize before another frequency hopcan be performed.

• Scheduled hop time—(Optional) Time of day at which a frequency hop should be scheduled.

Before adding a list of upstream frequencies (or frequency hop tables), start by determining which upstreamports are assigned to a combiner group. Refer to the Example: Determining the Upstream Ports Assigned toa Combiner Group, on page 276 for an example.

Tip


Spectrum Management and Advanced Spectrum ManagementGuided and Scheduled Spectrum Management Configuration Tasks

To create and configure a spectrum group, use the following procedure.

Procedure



enable

Example:

Step 1

Router> enable


Example:

Step 2


Creates the spectrum group (if it does not already exist),and adds the specified fixed frequency to the group.

cable spectrum-group group-number time[day hh:mm:ss]frequency up-freq-Hz [power-level-dBmV]

Example:

Step 3

Router(config)# cable spectrum-group 4 time Monday12:00:00 frequency 40000000

Creates the spectrum group (if it does not already exist),and adds the specified band of frequencies to the group.

cable spectrum-group group-number time [day hh:mm:ss] band up-freq-Hz up-freq2-Hz [power-level-dBmV]

Step 4

Example: Repeat Step 4 and Step 6 as needed for eachfixed frequency and frequency band that shouldbe a member of this spectrum group. You mustassign at least two fixed frequencies, or afrequency band that contains at least two centerfrequencies, to a spectrum group beforefrequency hopping can occur.

Note

Router(config)# cable spectrum-group 4 band20000000 24000000 13

Specifies theminimum time, in seconds, between frequencyhops.

cable spectrum-group group-number hop period seconds

Example:

Step 5

We recommend a configuration of 30 secondswhen using a Cisco uBR-MC5X20S/U/H BPE.

NoteRouter(config)# cable spectrum-group 4 hop period60

Specifies the frequency hop threshold for a spectrum group.cable spectrum-group group-number hop threshold[percent]

Step 6

• percent—(Optional) Frequency hop threshold as apercentage of station maintenance messages that areExample:lost. Valid range is from 1 to 100 percent, with adefault of 50 percent.

Router(config)# cable spectrum-group 4 hopthreshold 25

(Optional) Specifies that the upstream ports in a spectrumgroup should use a unique upstream frequency.

cable spectrum-group group-number

Example:

Step 7

Router(config)# cable spectrum-group 4


end

Example:

Step 8


Spectrum Management and Advanced Spectrum ManagementCreating and Configuring Spectrum Groups

PurposeCommand or ActionRouter(config)# end

Assigning a Spectrum Group to One or More Upstream PortsAfter a spectrum group has been created and configured, you must assign it to one or more upstream portsbefore the group’s frequency spectrum is used for frequency hopping.

To assign a spectrum group to one or all upstream ports on a controller interface, use the following procedure.

Procedure



enable

Example:

Step 1

Router> enable


Example:

Step 2


Enters controller configuration mode.controller upstream-cable slot/subslot/port

Example:

Step 3


Assigns the specified spectrum group as the default groupfor all upstream on this controller interface.

us-channel us -channel_num spectrum-groupspectrum-group-num

Example:

Step 4

Router(config-controller)# us-channel 0spectrum-group 1

Configures the channel-width for the specified upstreamchannel spectrum group.

us-channel us -channel_num channel-width value

Example:

Step 5

Router(config-controller)# us-channel 0channel-width 1600000

Exits controller interface configuration mode and returnsto privileged EXEC mode.

end

Example:

Step 6


What to do next

To verify the spectrum group configuration, use the show cable spectrum-group command in privilegedEXEC mode.

Tip


Spectrum Management and Advanced Spectrum ManagementAssigning a Spectrum Group to One or More Upstream Ports

Configuring Shared Spectrum Groups (Fiber Node Groups) for DOCSIS 3.0This feature supports shared spectrum groups that cross multiple cable interface line cards on the Cisco CMTSrouter, and shared spectrum groups within a single cable interface line card.

For additional information about configuring fiber node groups on the Cisco CMTS, see:

Configuring Dynamic Upstream Modulation (MER [SNR]-Based)To use the Dynamic Upstream Modulation feature on cable interface line cards that support only the MER(SNR) version of this feature, you must do the following:

1. Create a primary modulation profile. This typically is a more bandwidth-efficient but a less robust profile.

2. Optionally create a secondary modulation profile. This typically is a less bandwidth-efficient but amoderately robust profile.

3. Optionally create a tertiary modulation profile. This typically is a less bandwidth-efficient but a morerobust profile.

4. Assign the profiles to the desired cable interfaces and upstreams.

When creating the modulation profiles, we recommend that you use the predefined modulation profiles, asopposed to manually specifying each burst parameter for each modulation profile.

Tip

• TheDynamicUpstreamModulation feature is supported only for DOCSIS 1.0 or DOCSIS 1.1 TDMA-onlymodulation profiles for advanced spectrum management.

• The DOCSIS 2.0 mixed-mode or ATDMA-only mode modulation profiles are supported only for basicspectrum management (MER [SNR]-based) and not for advanced spectrum management.

• The Three Step DynamicModulation feature supports only basic spectrummanagement features. It doesnot support modulation profile changes based on CNR (CNiR) thresholds and CNR (CNiR)measurements.

• The Dynamic Upstream Modulation feature is not enabled for single modulation profile configurations.

• You can configure only two modulation profiles when an upstream is already assigned to a spectrumgroup for frequency hopping. The spectrum group here implies advanced spectrum management and/orthe use of CNR (CNiR).

• A single profile is automatically removed from the configuration if three modulation profiles are assignedto an upstream interface before assigning spectrum group, based on the following conditions:

• The robust profile is dropped if the upstream port is using a high performance profile.

• The high performance profile is dropped if the upstream port is using a mid-level or robust profile.

Restriction


Spectrum Management and Advanced Spectrum ManagementConfiguring Shared Spectrum Groups (Fiber Node Groups) for DOCSIS 3.0

Procedure



enable

Example:

Step 1

Router> enable


Example:

Step 2


Creates the primary modulation profile for use on aDOCSIS 1.0 or DOCSIS 1.1 TDMA or A-TDMAupstream.

cable modulation-profile profile {mixed | tdma | atdma

Example:Router(config)# cable modulation-profile 3 mixed

Step 3

Repeat this command to create the secondaryand tertiary profile for use on a DOCSIS 1.0 orDOCSIS 1.1 TDMA or A-TDMA upstream.

Note

You can also create custommodulation profileswith the cable modulation-profile commandby configuring the values for the individualburst parameters. These parameters, however,should not be modified unless you arethoroughly familiar with how changing eachparameter affects the DOCSIS MAC layer. Werecommend using the preconfigured defaultmodulation profiles for most cable plants.

Note


Example:

Step 4


Assigns a primary modulation profile, and the optionalsecondary and tertiary modulation profiles, to the specifiedupstream port.

us-channel n modulation-profile primary-profile-number[secondary-profile-number] [tertiary-profile-number]

Example:

Step 5

Router(config-controller)# us-channel 0modulation-profile 21 121 221

(Optional) Specifies the MER (SNR) threshold in dB.Use one of the following commands:Step 6

• us-channel n threshold snr-profiles threshold1-in-dbthreshold2-in-db

• us-channel n m threshold snr-profilesthreshold1-in-db threshold2-in-db

Example:Router(config-controller)# us-channel 0 thresholdsnr-profiles 25 15


Spectrum Management and Advanced Spectrum ManagementConfiguring Dynamic Upstream Modulation (MER [SNR]-Based)


(Optional) Specifies the allowable number of correctableFEC errors for the upstream.

Use one of the following commands:Step 7

• us-channel n threshold corr-fec corr-fec• us-channel n m threshold corr-fec corr-fec

Example:Router(config-controller)# us-channel 0 thresholdcorr-fec 20

(Optional) Specifies the allowable number of uncorrectableFEC errors for the upstream.


• us-channel n threshold uncorr-fec uncorr-fec• us-channel n m threshold uncorr-fec uncorr-fec

Example:Router(config-controller)# us-channel 0 thresholduncorr-fec 10

(Optional) Specifies the hysteresis value to be used inconjunction with the dynamic modulation upgradethresholds.

us-channel n threshold hysteresis hysteresis-in-db

Example:Router(config-controller)# us-channel 0 thresholdhysteresis 10

Step 9


end

Example:

Step 10


What to do next

See the Dynamic Upstream Modulation (MER [SNR]-Based), on page 247 for a complete description of theDynamic Upstream Modulation feature.

Tip

Verifying Frequency HoppingYou can verify frequency hopping on the CMTS by using the command-line interface (CLI).

Verifying Frequency Hopping Using CLI Commands

To verify frequency hopping using CLI commands, use the following procedure:

Step 1 Verify that the interface being tested is up, using the show interfaces cable command in privileged EXEC mode. Thefirst line of the output shows whether both the interface and line protocol are up.

Example:

Router# show interfaces cable 9/0/0

Hardware is CMTS MD interface, address is c414.3c16.cf8f (bia c414.3c16.cf8f)MTU 1500 bytes, BW 26000 Kbit/sec, DLY 1000 usec,


Spectrum Management and Advanced Spectrum ManagementVerifying Frequency Hopping

reliability 255/255, txload 1/255, rxload 1/255Encapsulation MCNS, loopback not set

Step 2 Verify that the upstream being tested is up, using the show interfaces cable upstream command. The first line showswhether the upstream is up.

Example:

Router# show interfaces cable 9/0/0 upstream 0

MAC domain upstream impairment report: 0x0Cable9/0/0: Upstream 0 is upDescription: UC9/0/0:U0Received 5 broadcasts, 0 multicasts, 26 unicasts0 discards, 0 errors, 0 unknown protocol31 packets inputCodewords: 348 good 0 corrected 0 uncorrectable

Step 3 Use the show cable hop upstream-cable command to display the frequency that the upstream is currently using:

Example:

Router# show cable hop upstream-cable 9/0/0

Upstream 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 ErrorsCable6/0/U5 16.816 Mhz 1000 0 10 0% 20% 25 0 0

Step 4 Use the show cable hop upstream-cable history command to display the frequency change, modulation change, andchannel width change action history of the upstreams:

Example:

Router# show cable hop upstream-cable 9/0/0 history

F = Frequency Hop, M = Modulation Change, C = Channel Width ChangeUpstream Action Chg Chg ActionPort Time Code From To ReasonCa7/0/0/U0 Sep 17 17:00:24 C 1.6 3.2 Configuration changed

Sep 14 19:38:55 F 41.117 26.358 Interface state changedSep 14 19:38:55 F 0.000 41.117 Interface state changedSep 14 19:38:24 M 21 221 Configuration changed

Step 5 Use the show cable hop upstream-cable threshold command to display the user-defined thresholds and current CNR,MER (SNR), correctable FEC percentage, uncorrectable FEC percentage, and missed station maintenance percentagevalues of the upstreams:

Example:

Router# show cable hop upstream-cable 6/0/0 threshold

Upstream SNR(dB) CNR(dB) CorrFEC% UncorrFEC% MissedSM%Port Val Thre1 Thre2 Val Thre1 Thre2 Pcnt Thre Pcnt Thre Pcnt Thre

Ca6/0/0/U0 27 25 15 39 35 25 0 3 0 1 75 75Ca6/0/0/U1 31 25 15 51 35 25 0 3 0 1 90 75



Ca6/0/0/U2 -- 35 25 -- 35 25 0 3 0 1 0 75Ca6/0/0/U3 -- 35 25 -- 35 25 0 3 0 1 0 75

Step 6 Use the test cable hop command to force the desired upstream to perform a frequency hop. A few seconds after givingthe command, a console message should appear informing you of the hop. Repeat the command as needed to verify thatthe upstream hops through all the frequencies that have been assigned to the upstream’s spectrum group.

Example:

Router# test cable hop cable 6/0 upstream 5

2w0d: %UBR7200-5-USFREQCHG: Interface Cable6/0 Port U5, frequency changed to 15.760 MHz

Router# test cable hop cable 6/0 upstream 5

2w0d: %UBR7200-5-USFREQCHG: Interface Cable6/0 Port U5, frequency changed to 26.832 MHz

Step 7 Use the test cable channel-width command to force the desired upstream to perform a channel-width change. A fewseconds after giving the test command, use the show cable hop command to verify the channel-width change.

Example:

Router# test cable channel-width cable 7/0/0 upstream 0

Channel width changed to 1600000 Hz for Cable7/0/0 U0

Router# *Sep 17 17:06:46.882: %UBR10000-5-USCWCHG: Interface Cable7/0/0 U0, channel width changed to1600 kHz SLOT 7/0: Sep 17 17:06:46.898: %UBR10000-5-USCWCHG: Interface Cable7/0/0 U0, channel widthchanged to 1600 kHz

Router# Sep 17 17:06:46.898: %Interface Cable7/0/0 U0 With channel width 1600 kHz, the minislot sizeis now changed to 4 ticks.

Router# show cable hop cable 7/0/0 upstream 0 history

F = Frequency Hop, M = Modulation Change, C = Channel Width ChangeUpstream Action Chg Chg ActionPort Time Code From To ReasonCa7/0/0/U0 Sep 17 17:06:46 C 3.2 1.6 Test command enforced

Sep 17 17:06:02 M 222 221 SNR 36>=28 CFEC 0<=3 UnCFEC 0<=1Sep 17 17:06:00 M 221 222 Test command enforcedSep 17 17:03:21 M 222 221 SNR 36>=28 CFEC 0<=3 UnCFEC 0<=1Sep 17 17:03:19 M 221 222 Test command enforcedSep 17 17:01:44 F 26.358 19.742 Test command enforcedSep 17 17:01:17 F 21.528 26.358 Test command enforcedSep 17 17:00:24 C 1.6 3.2 Configuration changedSep 14 19:38:55 F 41.117 21.528 Interface state changedSep 14 19:38:55 F 0.000 41.117 Interface state changedSep 14 19:38:24 M 21 221 Configuration changed

Router#

Step 8 Use the test cable freq-hop command to force the desired upstream to perform a dynamic frequency change. A fewseconds after giving the test command, use the show cable hop command to verify the frequency change.

Example:

Router# test cable freq-hop cable 7/0/0 upstream 0



SLOT 7/0: Sep 17 17:01:44.650: %UBR10000-5-USFREQCHG: Interface Cable7/0/0 U0, changed to Freq 19.742MHz


F = Frequency Hop, M = Modulation Change, C = Channel Width ChangeUpstream Action Chg Chg ActionPort Time Code From To ReasonCa7/0/0/U0 Sep 17 17:01:44 F 26.358 19.742 Test command enforced

Sep 17 17:00:24 C 1.6 3.2 Configuration changedSep 14 19:38:55 F 41.117 26.358 Interface state changedSep 14 19:38:55 F 0.000 41.117 Interface state changedSep 14 19:38:24 M 21 221 Configuration changed

Step 9 Use the test cable modulation-change command to force the desired upstream to perform a dynamic modulation change.A few seconds after giving the test command, use the show cable hop command to verify the modulation change.

Example:

Router# test cable modulation-change cable 7/0/0 upstream 0

SLOT 7/0: Sep 17 17:03:19.038: %UBR10000-5-USMODCHANGE: Interface Cable7/0/0 U0, dynamic modulationchanged to QPSKSLOT 7/0: Sep 17 17:03:19.038: %UBR10000-6-PREAMLENADJUST: request burst's preamble length in modprofile 222 is adjusted to 38 bits.SLOT 7/0: Sep 17 17:03:19.038: %UBR10000-6-PREAMLENADJUST: initial burst's preamble length in modprofile 222 is adjusted to 100 bits.SLOT 7/0: Sep 17 17:03:19.038: %UBR10000-6-PREAMLENADJUST: station burst's preamble length in modprofile 222 is adjusted to 100 bits.


F = Frequency Hop, M = Modulation Change, C = Channel Width ChangeUpstream Action Chg Chg ActionPort Time Code From To ReasonCa7/0/0/U0 Sep 17 17:03:19 M 221 222 Test command enforced

Sep 17 17:01:44 F 26.358 19.742 Test command enforcedSep 17 17:01:17 F 21.528 26.358 Test command enforcedSep 17 17:00:24 C 1.6 3.2 Configuration changedSep 14 19:38:55 F 41.117 21.528 Interface state changedSep 14 19:38:55 F 0.000 41.117 Interface state changedSep 14 19:38:24 M 21 221 Configuration changed

Troubleshooting Spectrum Group Characteristics

To troubleshoot the configuration, make sure that you entered a valid spectrum group number, time, frequency,and input power level. Also, when defining your spectrum, use the following guidelines:

• Avoid frequencies with known ingress problems, such as amateur radio bands or short-wave bands.

• Avoid a hostile spectrum below 20 MHz.

• Allow extra bands for frequency hopping.

• Place upstream ports in the same combiner group in a shared spectrum group.




Intelligent and Advanced Spectrum Management Configuration TasksThe following sections describe the configuration tasks that are needed to configure a Cisco uBR7200 seriesor Cisco uBR10012 universal broadband router for the intelligent and advanced spectrummanagement featuresthat are available with the Cisco cable interface line cards.

Configuring and Assigning Spectrum GroupsYou must create and configure a spectrum group before you can use the intelligent and advanced spectrummanagement features. These procedures are the same as those used for guided and scheduled spectrummanagement, which are given in the following sections:

After the spectrum groups have been configured and assigned to upstreams, the Cisco IOS softwareautomatically uses the advanced frequency hopping algorithms on the cable interface line cards that supportit.

For efficient use of the intelligent and advanced spectrum management features, we recommend configuringonly frequency bands, and not fixed frequencies, when creating spectrum groups. A spectrum group mustcontain a frequency band that is wide enough for the cable interface to find at least two center frequencies atthe configured channel width, before frequency hopping can occur.

Note

Configuring Dynamic Upstream Modulation (CNR-Based)Configuring the CNR-based version of the Dynamic Upstream Modulation feature is similar to configuringthe MER (SNR)-version of this feature:

1. Create a primary modulation profile. This typically is a more bandwidth-efficient but a less robust profile.

2. Create a secondary modulation profile. This typically is a less bandwidth-efficient but a more robustprofile.

When creating the modulation profiles, we recommend that you use the predefined modulation profiles, asopposed to manually specifying each burst parameter for each modulation profile.

Tip

3. Assign the profiles to the desired cable interfaces and upstreams.

After themodulation profiles have been created and assigned to upstreams, the Cisco IOS software automaticallyuses the advanced CNR-based version of the Dynamic Upstream Modulation feature on the cable interfaceline cards that support it.


Spectrum Management and Advanced Spectrum ManagementIntelligent and Advanced Spectrum Management Configuration Tasks

• TheDynamicUpstreamModulation feature is supported only for DOCSIS 1.0 or DOCSIS 1.1 TDMA-onlymodulation profiles. It is not supported for DOCSIS 2.0 mixed-mode or A-TDMA-only modemodulationprofiles.

• Three Step Dynamic Modulation is not supported on the CNR-based version of dynamic upstreammodulation.

• The CNR-based Dynamic UpstreamModulation feature does not support A-TDMAmodulation profiles.However, A-TDMA is supported in the MER (SNR)-based Dynamic Upstream Modulation feature.

To assign the primary and secondary profiles to an upstream, use the following procedure.

Restriction

Procedure



enable

Example:

Step 1

Router> enable


Example:

Step 2


Creates the primarymodulation profile for use on aDOCSIS1.0 or DOCSIS 1.1 TDMA upstream.

cable modulation-profile profile {mix | qam-16 | qpsk |robust-mix}

Step 3

Example: Typically, the primary profile is either qam-16 or mix.Router(config)# cable modulation-profile 3 mix Repeat this command to create the secondary

profile for use on a DOCSIS 1.0 or DOCSIS 1.1TDMA upstream. Typically, the secondaryprofile is either robust-mix or qpsk.

Note

You can also create custom modulation profileswith the cable modulation-profile commandby configuring the values for the individual burstparameters. These parameters, however, shouldnot be modified unless you are thoroughlyfamiliar with how changing each parameteraffects the DOCSISMAC layer.We recommendusing the preconfigured default modulationprofiles for most cable plants.

Note


Example:

Step 4



Spectrum Management and Advanced Spectrum ManagementConfiguring Dynamic Upstream Modulation (CNR-Based)


Assigns a primary modulation profile, and an optionalsecondary modulation profile, to the specified upstreamport.

cable upstream n modulation-profileprimary-profile-number secondary-profile-number

Example:

Step 5

Router(config-controller)# cable upstream 0modulation-profile 3 4


end

Example:

Step 6


Configuring Proactive Channel ManagementThe cable interface line cards that support the advanced spectrum management features can be configuredwith the following parameters to fine-tune the operation of proactive channel management on the upstreamsof the cards:

• Priority of the corrective actions to be taken when noise on an upstream exceeds the threshold for itsmodulation profile.

• CNR (CNiR) andMER (SNR) threshold and FEC values for the upstream and its twomodulation profiles.

• Allowable range of channel widths that can be used if frequency hopping or modulation switching cannotavoid the upstream problems.

These parameters all have default settings, so you do not need to perform this procedure unless you want tochange these parameters to better match the characteristics of your physical plant.

To configure the parameters, use the following procedure.

Configuring Proactive Channel Management

You can configure two logical channels on a single physical port of the Cisco CMTS router. When youconfigure logical channels, the upstream related commands are categorized into two groups: physical portlevel and logical channel level.

Physical Port Level

Physical port level commands use the format of cable upstream n, where n denotes the physical port number.

Logical Channel Level

Logical channel level commands use the format of cable upstream n m , where n denotes the physical portnumber, and m denotes the logical channel index number of 0 or 1.

Procedure



enable

Example:

Step 1

Router> enable


Spectrum Management and Advanced Spectrum ManagementConfiguring Proactive Channel Management



Example:

Step 2



Example:

Step 3


Specifies the priority of the three types of corrective actions(modulation, frequency, and channel-width) to be taken

us-channel n hop modulation frequency channel-width

Example:

Step 4

when the noise for the upstream exceeds the thresholdRouter(config-controller)# us-channel 0 hopmodulation frequency channel-width

specified for the current modulation profile. The defaultpriority is frequency, modulation, and channel-width.

The channel-width option must always appearafter the frequency option.

Note

(Optional) Specifies the CNR (CNiR) threshold and FECvalues for the upstream and its two modulation profiles.

cable upstream n threshold cnr-profiles threshold1-in-dbthreshold2-in-db

Step 5

Example: To bypass both the primary and secondary CNR(CNiR) thresholds, set the first parameter(threshold1-in-db) to 0. This disallows thesecond parameter (threshold2-in-db), enablingyou to bypass both the CNR (CNiR) thresholds.

Note

Router(config-controller)# cable upstream 2threshold cnr-profiles 23 14

(Optional) Specifies the MER (SNR) threshold and FECvalues for the upstream and its two modulation profiles.


• cable upstream n upstream threshold snr-profilesthreshold1-in-db threshold2-in-db You can bypass the primary MER (SNR)

threshold (threshold1-in-db) by setting it to 0.However, you must enter the second parameter(threshold2-in-db).

Note

•• cable upstream n m upstream threshold

snr-profiles threshold1-in-db threshold2-in-db•

Example:Router(config-controller)# cable upstream 2threshold snr-profiles 23 14

(Optional) Specifies the hysteresis value to be used inconjunction with the dynamic modulation upgradethresholds.

cable upstream n threshold hysteresis hysteresis-in-db

Example:Router(config-controller)# cable upstream 2threshold hysteresis 3

Step 7

You can bypass the hysteresis threshold bysetting the value to 0.

Note



• cable upstream n threshold corr-feccorrfec-threshold


Spectrum Management and Advanced Spectrum ManagementConfiguring Proactive Channel Management


You can bypass the corr-fec threshold bysetting the value to 0.

Note• cable upstream n m threshold corr-feccorrfec-threshold

Example:Router(config-controller)# cable upstream 5threshold corr-fec 5



• cable upstream n threshold uncorr-fecuncorrfec-threshold You can bypass the uncorr-fec threshold by

setting the value to 0.Note

• cable upstream n m threshold uncorr-fecuncorrfec-threshold

For normal plant use, we recommend that theuncorrectable FEC threshold remain at itsdefault of 1 percent to avoid an unacceptablenumber of errors on the channel.

NoteExample:Router(config-controller)# cable upstream 5threshold uncorr-fec 1

cable upstream n channel-width first-choice-width[last-choice-width ]

Step 10

Example:Router(config-controller)# cable upstream 0channel-width 800000 800000


end

Example:

Step 11


Verifying the Spectrum Management ConfigurationFollow the steps given below to verify the spectrum management configuration.

Step 1 To check the value of the settings you have entered, use the show running-config command in privileged EXEC mode:

Example:Router# show running-config

Step 2 To display the configuration for each modulation profile, use the show cable modulation-profile command in privilegedEXEC mode:

Example:Router# show cable modulation-profile

To display the configuration for a specific modulation profile, add the profile number to the show cable modulation-profilecommand in privileged EXEC mode:

Example:Router# show cable modulation-profile 6


Spectrum Management and Advanced Spectrum ManagementVerifying the Spectrum Management Configuration

Step 3 To display the status and configuration of each upstream, use the show controllers cable upstream command in privilegedEXEC mode. The following example displays information for upstreams 0 on a cable line card:

Example:Router# show controller cable 8/1/14 upstream 0

Cable8/1/14 Upstream 0 is upFrequency 19.504 MHz, Channel Width 3.200 MHz, Symbol Rate 2.560 MspsModulations (64-QAM) - A-short 64-QAM, A-long 64-QAM, A-ugs 64-QAMMapped to shared connector 18 and receiver 56Spectrum Group 8MC3Gx60 CNR measurement : 30 dBUS phy MER(SNR)_estimate for good packets - 32.5530 dBNominal Input Power Level 0 dBmV, Tx Timing Offset 1547Ranging Backoff Start 3, Ranging Backoff End 6US timing offset adjustment type 0, value 0Ranging Insertion Interval automatic (60 ms)US throttling offTx Backoff Start 3, Tx Backoff End 5Modulation Profile Group 221Concatenation is enabledFragmentation is enabledpart_id=0x3142, rev_id=0xC0, rev2_id=0x00nb_agc_thr=0x0000, nb_agc_nom=0x0000Range Load Reg Size=0x58Request Load Reg Size=0x0EMinislot Size in number of Timebase Ticks is = 2Minislot Size in Symbols = 32Bandwidth Requests = 0xEE3AFPiggyback Requests = 0x6A24FInvalid BW Requests= 0x76Minislots Requested= 0xC33362Minislots Granted = 0x158609Minislot Size in Bytes = 24Map Advance (Dynamic) : 2581 usecsMap Count Internal = 330309891No MAP buffer= 0x0 No Remote MAP buffer= 0x0Map Counts: Controller 8/1/0 = 1321230158UCD Counts:Controller 8/1/0:0 = 336057Controller 8/1/0:1 = 336057Controller 8/1/0:2 = 336057Controller 8/1/0:3 = 336057

UCD procedures on lch 0UCD ucd-succeeds(5) ucd-shut(0) init-state-err(0)UCD init-tss-err(0) init-timeout(0) init-start-err(0)UCD ucd-ccc-time(0) ucd-timeout(0) ucd-tss-err(0)UCD ucd-state-err(0) ucd-process(0) ucd-retries(0)UCD stale-tss(0)ATDMA mode enabledPHY: us errors 0 us recoveries 0 (enp 0)MAC PHY TSS: tss error start 0 tss error end 0MAC PHY Status: bcm3140 status 0 lookout status 0PHY: TSS late 0 discontinuous 0PHY: TSS mis-match 0 not-aligned 0PHY: TSS missed snapshots from phy 0MAP/UCD Replication Instructions:Controller 8/1/0 index = 477, bitmap = 0x000F

Dynamic Services Stats:DSA: 0 REQs 0 RSPs 0 ACKs0 Successful DSAs 0 DSA FailuresDSC: 0 REQs 0 RSPs 0 ACKs



0 Successful DSCs 0 DSC FailuresDSD: 0 REQs 0 RSPs0 Successful DSDs 0 DSD FailuresDropped MAC messages: (none)

Step 4 To display the hop period and hop threshold values for each upstream, use the show cable hop command in privilegedEXEC mode:

Example:Router# show cable hop

Upstream 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 ErrorsCable3/0/U0 20.800 Mhz 105 0 20 0% 25% 45 1 4Cable3/0/U1 20.800 Mhz 105 0 48 0% 25% 45 2 19Cable3/0/U2 23.120 Mhz 105 0 45 0% 25% 45 0 5Cable3/0/U3 22.832 Mhz 105 0 26 0% 25% 45 0 6Cable3/0/U4 22.896 Mhz 105 0 43 0% 25% 45 0 7Cable3/0/U5 23.040 Mhz 105 0 54 0% 25% 45 1 3Cable4/0/U0 22.896 Mhz 117 0 26 0% 25% 45 0 2Cable4/0/U1 23.168 Mhz 117 0 87 0% 25% 45 4 2Cable4/0/U2 22.896 Mhz 117 0 23 0% 25% 45 1 0Cable4/0/U3 20.800 Mhz 117 0 54 0% 25% 45 0 0Cable4/0/U4 22.928 Mhz 117 0 22 0% 25% 45 0 1Cable4/0/U5 22.960 Mhz 117 0 0 ----- 25% 45 0 0

Step 5 To display changes from one state to another, at any time and for any reason, for frequency, modulation, and channelwidth, use the history option of the show cable hop command.

Example:Router# show cable hop c8/1/1 u0 history

F = Frequency Hop, M = Modulation Change, C = Channel Width ChangeUpstream Action Chg Chg ActionPort Time Code From To ReasonC8/1/1 U0 Feb 20 12:21:29 M 142 141 SNR 28>=28 CFEC 0<=3 UnCFEC 0<=1

Feb 20 12:09:08 F 0.000 24.000 Configuration changed

Step 6 To display thresholds forMER (SNR), CNR (CNiR), and FEC, use the threshold option of the show cable hop command.

Example:Router# show cable hop c8/1/1 u0 threshold

Upstream SNR(dB) CNR(dB) CorrFEC% UncorrFEC% MissedSM%Port Val Thre1 Thre2 Val Thre1 Thre2 Pcnt Thre Pcnt Thre Pcnt ThreC8/1/1 u0 33 23 14 60 25 15 0 1 0 2 0 50

Step 7 To display the assignment of each spectrum group, use the show cable spectrum-group command in privileged EXECmode:

Example:Router# show cable spectrum-group

Group Frequency Upstream Weekly Scheduled Power SharedNo. Band Port Availability Level Spectrum

(MHz) From Time: To Time: (dBmV)



1 42.967 [3.20] UC2/0/4:U0 -1 No1 83.400 [3.20] UC2/0/4:U1 -1 No1 80.200 [3.20] UC2/0/4:U2 -1 No1 42.922 [3.20] UC2/0/4:U3 -1 No1 17.677 [3.20] UC2/0/5:U0 -1 541 10.603 [3.20] UC2/0/5:U1 -1 54

In the above example,

• No—Fiber node is not configured

• 54—ID of the fiber node

Step 8 To display the current CNR (CNiR) value for a particular cable modem, use the show cable modem cnr command inprivileged EXEC mode:

Example:Router# show cable modem 5.100.1.94 cnr

MAC Address IP Address I/F MAC Prim snr/cnrState Sid (dB)

0018.689c.17b8 5.100.1.94 C7/0/0/U1 online 428 36.12

Monitoring Spectrum ManagementYou can either use Cisco CLI commands or SNMP to monitor spectrum management activity on the CiscoCMTS.

See the following sections for more information:

Using CLI CommandsThe following commands provide information on the spectrum condition of an upstream:

PurposeCommand

Displays the hop period and hop threshold values, as well as theFEC error counters, for all upstreams in the router, all upstreamson one cable interface line card, or a single upstream.

Router# show cable hop[cablex/y][upstream usport]

Displays the configured and current value of MER (SNR) in dB,CNR (CNiR) in dB, CorrFEC in percentage, UncorrFEC inpercentage, and missed station maintenance in percentage for aspecified upstream.

Router# show cable hop [cablex/y[z]] [upstream n][thresholds]


Spectrum Management and Advanced Spectrum ManagementMonitoring Spectrum Management

PurposeCommand

1. With the show cable hop history command for entire CMTS,the most recent change of each action is displayed.

2. With the show cable hop history command for a MACdomain, the most recent three changes of each action aredisplayed.

3. With the show cable hop history command for a specificupstream, the last ten changes of each action are displayed.Changes are sorted by time with the most recent at the top.

Router# show cable hop history

Displays hourly, daily, weekly, 30 days running average, andaverage since the system was brought up for each specifiedupstream.

Router# show cable hop [cablex/y[z]] [upstream n][summary

Displays changes from one state to another, at any time and forany reason, for frequency, modulation, and channel width.Router# show cable hop [cable

x/y[z]] [upstream n] [history]

Displays information, including MER (SNR) values, for theregistered and unregistered cable modems.

Router# show cable modem[ip-address | interface |mac-address] [options]

Displays the configuration for all modulation profiles, for aparticular modulation profile, or for a specific burst type for aparticular modulation profile.

Router# show cablemodulation-profile [num] [initial| long | reqdata | request | short| station]

Displays information about the spectrum groups that have beenconfigured.

Router# show cablespectrum-group[groupnum] [detail]

Displays the upstream status, including the current frequency,channel width, modulation rate, and spectrum groups.

Router# show controllers cable x/yupstream n [ip-address |

mac-address] start-freq end-freqres-freq

Displays the noise levels for a particular cable modem or displaysthe background noise for an entire upstream.

Router# show controllers cable x/yupstream n spectrum [ip-address| mac-address] start-freq end-freqres-freq

The show cable flap-list command displays the flap list of the CMTS router, which provides additionalinformation about whether cable modems on an upstream are experiencing problems, and if so, what type ofproblems are occurring. For more information about the cable modem flapping and how to monitor the cablemodem flap list, see the Flap List Troubleshooting for the Cisco CMTS Routers .

Note

Using SNMPYou can use SNMP to monitor the spectrum management activity. The SNMP manager can be agraphically-based SNMP manager such as CiscoView or the Cable Broadband Troubleshooter (Release 3.0or later).


Spectrum Management and Advanced Spectrum ManagementUsing SNMP

http://www.cisco.com/en/US/docs/ios/cable/configuration/guide/cmts_flaplst_trbsh.html

The CISCO-CABLE-SPECTRUM-MIB has been enhanced to provide this SNMP support using the followingMIB attributes:

ccsSNRRequestTableThe table below lists the attributes in the ccsSNRRequestTable table, which contains the CNR (CNiR)measurements that are made for individual cable modems on an upstream.

Table 45: ccsSNRRequestTable Attributes

DescriptionTypeAttribute

Arbitrary index to uniquely identify each table entry.Integer32ccsSNRRequestIndex

MAC address of the remote online cable modembeing reported on.

MacAddressccsSNRRequestMacAddr

MER (SNR) value, in dB, that has been measured.This value is 0 when the Operation State is “running.”

Integer32ccsSNRRequestSNR

Sets the current operation: start, pending, running,or abort.

CCSRequestOperationccsSNRRequestOperation

Reports on the current operation state: idle, pending,running, noError, aborted, notOnLine, invalidMac,timeOut, fftBusy, fftFailed, others.

CCSRequestOperStateccsSNRRequestOperState

Contains the time when the MER (SNR)measurement operation starts.

TimeStampccsSNRRequestStartTime

Contains the time when the MER (SNR)measurement stops.

TimeStampccsSNRRequestStoppedTime

Controls the modification, creation, and deletion oftable entries.

RowStatusccsSNRRequestStatus

ccsSpectrumRequestTableThe table below lists the attributes for each entry in the ccsSpectrumRequestTable table, which is used toobtain the spectrum profile for a particular cable modem or to obtain the backgroundMER (SNR) for an entireupstream.

Table 46: ccsSpectrumRequestTable Attributes


Arbitrary index to uniquely identify each tableentry.

Integer32ccsSpectrumRequestIndex

Interface identifying the upstream.InterfaceIndexOrZeroccsSpectrumRequestIfIndex

MAC address to specify anMER (SNR) value fora particular cable modem, or 0000.0000.0000 toindicate background noise for the entire spectrum.

MacAddressccsSpectrumRequestMacAddr


Spectrum Management and Advanced Spectrum ManagementccsSNRRequestTable


Upper frequency for the frequency range to bemonitored (5000 to 42000 KHz, with a default of42000 KHz).

CCSFrequencyccsSpectrumRequestUpperFreq

Lower frequency (in KHz) for the frequency rangeto be monitored (5000 to 42000 KHz, with adefault of 5000 KHz).

CCSFrequencyccsSpectrumRequestLowFreq

Requested resolution to determine how thefrequency range should be sampled (12 to 37000KHz, with a default of 60 KHz).

Integer32ccsSpectrumRequestResolution

Time when the spectrum measurement began.TimeStampccsSpectrumRequestStartTime

Time when the spectrum measurement finished.TimeStampccsSpectrumRequestStoppedTime

Starts a new spectrum management request orcancels the current one.

CCSRequestOperationccsSpectrumRequestOperation

Provides the operational state of the currentspectrum management request.

CCSRequestOperStateccsSpectrumRequestOperState

Controls the modification, creation, and deletionof table entries.

RowStatusccsSpectrumRequestStatus

ccsSpectrumDataTableThe table below lists the attributes in each entry of the ccsSpectrumDataTable table, which contains the resultsfor a spectrum request.

Table 47: ccsSpectrumDataTable Attributes


Frequency in KHz for which this power measurementwas made.

CCSMeasuredFrequencyccsSpectrumDataFreq

Measured received power for the given frequency (–50to 50 dBmV).

INTEGERccsSpectrumDataPower

The ccsSpectrumRequestTable and ccsSpectrumDataTable tables provide the same information as that providedby the show controllers cable upstream spectrum command.

Note

ccsUpSpecMgmtTableThe table below lists the attributes in the ccsUpSpecMgmtTable table, which provides an entry describingeach frequency hop.


Spectrum Management and Advanced Spectrum ManagementccsSpectrumDataTable

Table 48: ccsUpSpecMgmtEntry Attributes


Specifies the priority of frequency,modulation profile, and channel width indetermining corrective action forexcessive noise on the upstream (defaultis frequency, modulation profile, andchannel width).

INTEGERccsUpSpecMgmtHopPriority

Specifies the upperMER (SNR) thresholdfor modulation profile 1 (5 to 35 dB,default of 25).

Integer32ccsUpSpecMgmtSnrThres1

Specifies the upperMER (SNR) thresholdfor modulation profile 2 (5 to 35 dB,default of 13, and must be lower than thatspecified for ccsUpSpecMgmtSnrThres1).

Integer32ccsUpSpecMgmtSnrThres2

Specifies the FEC correctable errorthreshold for modulation profile 1 (1 to20 percent)

Integer32ccsUpSpecMgmtFecCorrectThres1

Zero (0). Deprecated and no longer used.Integer32ccsUpSpecMgmtFecCorrectThres2

Specifies the FEC uncorrectable errorthreshold for modulation profile 1 (1 to20 percent).

Integer32ccsUpSpecMgmtFecUnCorrectThres1

Deprecated and no longer used.Integer32ccsUpSpecMgmtFecUnCorrectThres2

Deprecated and no longer used.Integer32ccsUpSpecMgmtSnrPollPeriod

Reports the condition that triggers afrequency hop (MER [SNR] value orpercentage of modems going offline).

INTEGERccsUpSpecMgmtHopCondition

Provides the center frequency (in KHz)before the latest frequency hop.

CCSFrequencyccsUpSpecMgmtFromCenterFreq

Provides the current center frequency (inKHz) after the latest frequency hop.

CCSFrequencyccsUpSpecMgmtToCenterFreq

Provides the channel width (in KHz)before the latest frequency hop.

CCSFrequencyccsUpSpecMgmtFromBandWidth

Provides the current channel width (inKHz) after the latest frequency hop.

CCSFrequencyccsUpSpecMgmtToBandWidth

Provides the modulation profile numberbefore the latest frequency hop.

Integer32ccsUpSpecMgmtFromModProfile


Spectrum Management and Advanced Spectrum ManagementccsUpSpecMgmtTable


Provides the current modulation profilenumber after the latest frequency hop.

Integer32ccsUpSpecMgmtToModProfile

Provides the current MER (SNR) value(in dB) for the upstream.

Integer32ccsUpSpecMgmtSNR

Specifies the upper CNR (CNiR)threshold for modulation profile 1 (5 to35 dB, default of 25).

Integer32ccsUpSpecMgmtCnrThres1

Specifies the upper CNR (CNiR)threshold for modulation profile 2 (5 to35 dB, default of 13, and must be lowerthan that specified forccsUpSpecMgmtCnrThres1).

Integer32ccsUpSpecMgmtCnrThres2

Provides the current CNR (CNiR) value(in dB) for the upstream.

Integer32ccsUpSpecMgmtCNR

Provides the frequency hop threshold, asa percentage of station maintenancemessages that are lost for a spectrumgroup.

Integer32ccsUpSpecMgmtMissedMaintMsgThres

Provide the minimum time, in seconds,between frequency hops.

Integer32ccsUpSpecMgmtHopPeriod

ccsHoppingNotificationThe table below describes the attributes contained in the notification that is sent after each frequency hop.

Table 49: ccsHoppingNotification Attributes


Reports the condition that triggers a frequency hop (MER[SNR] value or percentage of modems going offline).

INTEGERccsUpSpecMgmtHopCondition

Provides the center frequency (in KHz) before the latestfrequency hop.

CCSFrequencyccsUpSpecMgmtFromCenterFreq

Provides the current center frequency (in KHz) after thelatest frequency hop.

CCSFrequencyccsUpSpecMgmtToCenterFreq

Provides the channel width (in KHz) before the latestfrequency hop.

CCSFrequencyccsUpSpecMgmtFromBandWidth

Provides the current channel width (in KHz) after thelatest frequency hop.

CCSFrequencyccsUpSpecMgmtToBandWidth

Provides the modulation profile number before the latestfrequency hop.

Integer32ccsUpSpecMgmtFromModProfile


Spectrum Management and Advanced Spectrum ManagementccsHoppingNotification


Provides the current modulation profile number after thelatest frequency hop.

Integer32ccsUpSpecMgmtToModProfile

Configuration ExamplesThis section provides the following configuration examples:

Spectrum Group and Combiner Group ExamplesThe following examples help you to determine whether spectrum group and combiner groups are configuredand activated.

Example: Verifying Spectrum Group CreationTo verify that a spectrum group has been created, enter the show cable spectrum-group command:Router# show cable spectrum-groupspectrum-group 1spectrum-group 2spectrum-group 3

Example: Time-Scheduled Spectrum GroupIf your cable plant has an upstream noise characteristic on a weekly cycle, use time-scheduled spectrumallocation.Router(config)# cable spectrum-group 1 time Mon 08:00:00 frequency 21600000

Deletion is performed using the delete keyword:Router(config)# cable spectrum-group 1 time Mon 18:00:00 delete frequency 21600000

Example: Verifying Spectrum Group ConfigurationTo verify if spectrum groups have been configured and activated, enter the show cable spectrum-groupcommand. This command displays each spectrum group, the frequencies assigned to it, the upstream port towhich it has been assigned, whether a schedule exists for it, the currently measured power level, and whetherit is a shared spectrum group.Router# show cable spectrum-group

22:07:46: %SYS-5-CONFIG_I: Configured from console by consoleGroup Frequency Upstream Weekly Scheduled Power SharedNo. Band Port Availability Level Spectrum

(Mhz) From Time: To Time: (dBmV)1 5.000-15.000 0 Yes1 12.000 0 Yes1 22.000 Cable6/0 U5 7 Yes2 29.000 Cable6/0 U4 6 No2 26.000 0 No3 35.000-41.000 0 No3 16.000-19.000 Cable6/0 U3 5 No5* 5.000-10.000 Thu 21:50:00 Thu 21:45:00 0 Yes


Spectrum Management and Advanced Spectrum ManagementConfiguration Examples

Example: Determining the Upstream Ports Assigned to a Combiner GroupFollowing is a sample topology for a CMTS with combiner groups designated A through J. Combiner groupsC and E have multiple upstream ports that should be configured in a shared spectrum group. The otherupstreams should be configured in a nonshared spectrum group.

In this example, ten combiner groups are served with frequency hop tables from three spectrum groups:Cable3/0DS +-----+ Upconverter +----- laser group 1U0 +----- combiner group AU1 +----- combiner group BU2 +------combiner group CU3 +------combiner group CU4 +----- combiner group DU5 +------combiner group ECable4/0DS +-----+ Upconverter +----- laser group 2U0 +------combiner group EU1 +----- combiner group FU2 +----- combiner group GU3 +----- combiner group HU4 +----- combiner group IU5 +----- combiner group J

The laser group term refers to the set of fiber nodes that share the same downstream signal. An optical splitteris often used to create individual feeds per node.

In the downstream direction, two 6-MHz channel slots are assigned. All fiber nodes in combiner groups Athrough E should have a channel slot containing the downstream signal from Cable3/0. Combiner groups Athrough E are said to belong to laser group 1.

All fiber nodes in combiner groups E through J should have a channel slot containing the downstream signalfrom Cable4/0. Combiner groups E through J are said to belong to laser group 2.

Because combiner group E belongs to two laser groups, there should be two different downstream channelslots for Cable3/0 and Cable4/0.

Example: Combiner GroupThe following example enables spectrum management for all upstream ports, where all combiner groups usethe frequency band from 20 to 26 MHz:CMTS01(config)# cable spectrum-group 1 band 20000000 26000000CMTS01(config)# cable spectrum-group 2 sharedCMTS01(config)# cable spectrum-group 2 band 20000000 26000000CMTS01(config)# cable spectrum-group 3 sharedCMTS01(config)# cable spectrum-group 3 band 20000000 26000000CMTS01(config)# controller upstream-Cable 9/0/0CMTS01(config-controller)# cable spectrum-group 1CMTS01(config-controller)# cable upstream 2 spectrum-group 2CMTS01(config-controller)# cable upstream 3 spectrum-group 2CMTS01(config-controller)# cable upstream 5 spectrum-group 3CMTS01(config-controller)# exitCMTS01(config)# controller upstream-Cable 9/0/1CMTS01(config-controller)# cable spectrum-group 1CMTS01(config-controller)# cable upstream 0 spectrum-group 3

A description of the spectrum groups 1 through 3 follows:


Spectrum Management and Advanced Spectrum ManagementExample: Determining the Upstream Ports Assigned to a Combiner Group

• Spectrum group 1—This group is nonshared. Upstream RF domains exist for each member upstreamport.Upstream Port RF DomainCable3/0 U0 combiner group ACable3/0 U1 combiner group BCable3/0 U4 combiner group DCable4/0 U1 combiner group FCable4/0 U2 combiner group GCable4/0 U3 combiner group HCable4/0 U4 combiner group ICable4/0 U5 combiner group J

• Spectrum group 2—This group is shared. A single upstream RF domain exists.Upstream Port RF DomainCable3/0 U2 combiner group CCable3/0 U3 combiner group C

• Spectrum group 3—This group is shared. A single upstream RF domain exists.Upstream Port RF DomainCable3/0 U5 combiner group ECable4/0 U0 combiner group E

For the 20- to 26-MHz band of each RF domain, the spectrum is channelized according to the channel widthsettings of each member port. For example, if the ports U2 and U3 of Cable3/0 are set to 3.2 MHz and 1.6MHz channel widths, respectively, then spectrum group 2 uses the following channelization:> Channel Width Start Stop Center> (Mhz) (Mhz) (Mhz) (Mhz)> 1 3.2 20.0 23.2 21.6> 2* 1.6 20.0 21.6 20.8> 3* 1.6 21.6 23.2 22.4> 4 1.6 23.2 24.8 24.0

Channels 2 and 3 are not available when channel 1 is in use.Note

Because the group is shared, ports U2 and U3 will be assigned channels 1 and 4, respectively, to preventoverlap.

There are no alternate frequency assignments for either port, and bandwidth is wasted from 24.8 to 26.0 MHz.To create alternate channels, increase the upper boundary from 26.0 to 28.0 MHz.

Note

> Channel Width Start Stop Center> (Mhz) (Mhz) (Mhz) (Mhz)> 1 3.2 20.0 23.2 21.6> 2 3.2 23.2 26.4 24.8> 3 1.6 20.0 21.6 20.8> 4 1.6 21.6 23.2 22.4> 5 1.6 23.2 24.8 24.0> 6 1.6 24.8 26.4 25.6


Spectrum Management and Advanced Spectrum ManagementExample: Combiner Group

> 7 1.6 26.4 28.0 27.4

Try to reduce the spectrum allocation when it is used with small channel widths. Otherwise, there will be alarge number of upstream channel slots, and the frequency hopping may require several minutes to find aclean slot.

Example: Other Spectrum Management ConfigurationsTo configure differing spectrum groups, refer to the following examples:

• Use the following example to configure spectrum group 3 with an upstream band of 12,000,000 to18,000,000 Hz and default power level of 0 dBmV:Router(config)# cable spectrum-group 3 band 12000000 18000000

• Use the following example to add the upstream band 20,000,000 to 24,000,000 Hz to the list of validbands with a change in the power level of 13 dBmV for spectrum group 3:Router(config)# cable spectrum-group 3 band 20000000 24000000 13

• Use the following example to configure a continuous band between 5,000,004 and 40,000,000 Hz forscheduled spectrum group 4 with a default power level of 0 dBmV. The band is available to the spectrumgroup starting at 12:00 p.m. local time each Monday:Router(config)# cable spectrum-group 4 time Monday 12:00:00 band 5000004 40000000

• Use the following example to add the upstream frequency 9,500,000 Hz to the list of valid frequenciesand change the nominal power level to 5 dBmV. The spectrum manager adjusts frequencies and powerlevels 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

• Use the following example to configure the minimum period before which a frequency hop can occurin seconds:Router(config)# cable spectrum-group 3 hop period 800

• Use the following example to configure the threshold value (expressed as a percentage) of the numberof “offline” modems identified before the router initiates an automatic frequency hop:Router(config)# cable spectrum-group 3 hop threshold 40

• Use the following example to configure a particular spectrum group as a shared RF spectrum group.Specifying a given spectrum group as “shared” tells the router that you want to be sure that upstreamfrequencies assigned to upstream ports are not assigned to additional upstream ports:Router(config)# cable spectrum-group 3 shared

• Use the following example to remove a specified spectrum group from your configuration:Router(config)# no cable spectrum-group 3


Spectrum Management and Advanced Spectrum ManagementExample: Other Spectrum Management Configurations

Dynamic Upstream Modulation ExamplesThe following examples describe how to display modulation profile information with the show cablemodulation-profile command and to define amodulation profile with the cable modulation-profile command.

Verifying Your Settings

Step 1 To check the value of the settings you have entered, enter the show running-config command in privileged EXECmode:

Example:Router# show running-config

To review changes you make to the configuration, use the show startup-config command in privileged EXEC mode todisplay the information stored in NVRAM.

Step 2 To display modulation profile group information, use the show cable modulation-profile command in privileged EXECmode:

Example:Router# show cable modulation-profile[profile][iuc-code]

This command uses the following syntax:

• 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

Example: Modulation ProfilesThe Cisco CMTS has one preconfigured modulation profile resident in memory, which defines a typicalprofile for QPSK modulation. To use the Dynamic Upstream Modulation feature, a second profile must becreated that is unique from the first profile, and typically provides a higher, more robust modulation scheme.

The following example is a modulation profile for QAM-16, in which the initial, request, and stationmaintenance messages are sent as QPSK, and the short and long data packets are sent as QAM-16. TheQAM-16 modulation is more bandwidth-efficient than QPSK, but QPSK is more robust than QAM-16.


Spectrum Management and Advanced Spectrum ManagementDynamic Upstream Modulation Examples

The upstream request and station maintenance messages use less time on the cable network when configuredin QPSK for symbol rates of 640K, 1280K, and 2560K symbols/sec. Thus, these messages are actually moreefficient when used in QPSK mode and they ensure a more reliable modem connection. The upstream initialmaintenance message takes exactly the same amount of time on the cable network, no matter how it isconfigured. Modems connect more quickly and experience fewer cycles of power adjustment during initialmaintenance if the system is set for QPSK.

Note

Router# configure terminalRouter(config)# cable modulation-profile 2 request 0 16 1 8 qpsk scrambler 152 no-diff 64fixed uw16Router(config)# cable modulation-profile 2 initial 5 34 0 48 qpsk scrambler 152 no-diff 128fixed uw16Router(config)# cable modulation-profile 2 station 5 34 0 48 qpsk scrambler 152 no-diff 128fixed uw16Router(config)# cable modulation-profile 2 short 6 75 6 8 16qam scrambler 152 no-diff 72fixed uw16Router(config)# cable modulation-profile 2 long 8 220 0 8 16qam scrambler 152 no-diff 160fixed uw16

In the following example, all message types are carried with QAM-16 modulation. Although QAM-16modulation offers a consistent modulation scheme for all five types of messages, the added length of theQAM-16 preamble offsets the increased bandwidth efficiency of the MAC data message for the stationmaintenance messages and bandwidth request messages.Router# configure terminalRouter(config)# cable modulation-profile 2 request 0 16 1 8 16qam scrambler 152 no-diff 128fixed uw16Router(config)# cable modulation-profile 2 initial 5 34 0 48 16qam scrambler 152 no-diff256 fixed uw16Router(config)# cable modulation-profile 2 station 5 34 0 48 16qam scrambler 152 no-diff256 fixed uw16Router(config)# cable modulation-profile 2 short 5 75 6 8 16qam scrambler 152 no-diff 144fixed uw16Router(config)# cable modulation-profile 2 long 8 220 0 8 16qam scrambler 152 no-diff 160fixed uw16

When using DOCSIS concatenation with a 16-QAM or mixed symbol rate, configure the CMTS for UniqueWord 16 (“uw16”) in the preamble for both short and long data burst profiles.

Note

Add the cable upstream port-number modulation-profile primary profile-number secondary profile-numbercommand to the appropriate interfaces. In this example, modulation profile 2 is for QAM-16 modulation andprofile 1 is for QPSK modulation.Router# configure terminalRouter(config)# controller upstream-Cable 6/0/0Router(config-controller)# cable upstream 0 modulation-profile 2 1


Spectrum Management and Advanced Spectrum ManagementExample: Modulation Profiles

Example: Input Power LevelIn the following example, the modem transmit power at 24.8 MHz is adjusted upstream by 1 dBmV and themodem transmit power at 28.0 MHz is adjusted upstream by 2 dBmV.CMTS01(config)# cable spectrum-group 1 frequency 21600000CMTS01(config)# cable spectrum-group 1 frequency 24800000 1CMTS01(config)# cable spectrum-group 1 frequency 28000000 2

Advanced Spectrum Management Configuration ExamplesThis section provides the following typical configurations:

Example: Advanced Spectrum Management for the Cisco cBR Series RoutersThis section provides an excerpt from a typical configuration example for a Cisco cBR Series router using acable interface line card. This configuration does the following:

• Configures four spectrum groups with a hop period of 30 seconds.

• Creates a QPSK modulation profile and assigns it to four upstreams on the Cisco cable interface linecard in slot 6/1/0.

• Assigns a spectrum group to each of the four upstreams.

• Configures each upstream for the default CNR (CNiR) and FEC thresholds.

cable modulation-profile 21 qpskinterface Cable6/1/0cable bundle 1cable downstream annex Bcable downstream modulation 256qamcable downstream interleave-depth 32! upstream 0cable upstream 0 spectrum-group 1cable upstream 0 modulation-profile 21cable upstream 0 threshold cnr-profiles 16 0cable upstream 0 threshold Corr-Fec 3cable upstream 0 threshold Uncorr-Fec 1no cable upstream 0 shutdown ! upstream 1cable upstream 1 spectrum-group 2cable upstream 1 modulation-profile 21cable upstream 1 threshold cnr-profiles 16 0cable upstream 1 threshold Corr-Fec 3cable upstream 1 threshold Uncorr-Fec 1no cable upstream 1 shutdown ! upstream 2cable upstream 2 spectrum-group 3cable upstream 2 modulation-profile 21cable upstream 2 threshold cnr-profiles 16 0cable upstream 2 threshold Corr-Fec 3cable upstream 2 threshold Uncorr-Fec 1no cable upstream 2 shutdown ! upstream 3cable upstream 3 spectrum-group 4cable upstream 3 modulation-profile 21cable upstream 3 threshold cnr-profiles 16 0cable upstream 3 threshold Corr-Fec 3cable upstream 3 threshold Uncorr-Fec 1no cable upstream 3 shutdown


Spectrum Management and Advanced Spectrum ManagementExample: Input Power Level

Additional ReferencesThe following sections provide references related to Spectrum Management and Advanced SpectrumManagement for the Cisco CMTS routers.

Related Documents


Cisco Broadband Cable Command Reference Guide.CMTS Command Reference

Standards and RFCs

TitleStandards


SP-RFIv1.1-I09-020830


SP-RFIv2.0-I03-021218

Data-over-Cable Service Interface Specifications Operations Support SystemInterface Specification, version 2.0

SP-OSSIv2.0-I03-021218

Data-over-Cable Service Interface Specifications Baseline Privacy Plus InterfaceSpecification, version 2.0

SP-BPI+-I09-020830

MIBs

MIBs LinkMIBs

To locate and downloadMIBs for selected platforms, Cisco IOS releases,and feature sets, use Cisco MIB Locator found at the following URL:

https://www.cisco.com/go/mibs

CISCO-CABLE-SPECTRUM-MIB


LinkDescription

https://www.cisco.com/cisco/web/support/index.htmlThe Cisco Support and Documentation websiteprovides online resources to download documentation,software, and tools. Use these resources to install andconfigure the software and to troubleshoot and resolvetechnical issues with Cisco products and technologies.Access to most tools on the Cisco Support andDocumentation website requires a Cisco.com user IDand password.


Spectrum Management and Advanced Spectrum ManagementAdditional References

https://www.cisco.com/c/en/us/td/docs/cable/cmts/cmd_ref/b_cmts_cable_cmd_ref.html

https://www.cisco.com/go/mibs

https://www.cisco.com/cisco/web/support/index.html

Feature Information for Spectrum Management and AdvancedSpectrum Management



Note



Cisco IOS XE Fuji 16.7.1Spectrum Management andAdvanced Spectrum Management


Spectrum Management and Advanced Spectrum ManagementFeature Information for Spectrum Management and Advanced Spectrum Management



Spectrum Management and Advanced Spectrum ManagementFeature Information for Spectrum Management and Advanced Spectrum Management

C H A P T E R 14Upstream Scheduler Mode

This document describes how to configure optional upstream (US) scheduler modes.

With this feature, you can select Unsolicited Grant Services (UGS), Real Time Polling Service (rtPS) orNon-Real Time Polling Service (nrtPS) scheduling types, as well as packet-based or Time Division Multiplex(TDM) based scheduling. Low latency queuing (LLQ) emulates a packet-mode-like operation over the TDMinfrastructure of DOCSIS. As such, the feature provides the typical trade-off between packets and TDM.WithLLQ, you have more flexibility in defining service parameters for UGS, rtPS or nrtPS, but with no guarantee(other than statistical distribution) regarding parameters such as delay and jitter.

• Finding Feature Information, on page 285• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 285• Restrictions for Upstream Scheduler Mode, on page 286• Information About Upstream Scheduler Mode for the Cisco CMTS Routers, on page 287• How to Configure Upstream Scheduler Modes, on page 287• Additional References, on page 288• Feature Information for Upstream Scheduler Mode, on page 289





Note
















Digital PICs:


•













Restrictions for Upstream Scheduler Mode• To ensure proper operation, Interface-based Admission Control must be enabled. When the LLQ optionis enabled, it is possible for the upstream path to be filled with so many calls that it becomes unusable,making voice quality unacceptable. Interface-based admission control must be used to limit the numberof calls to ensure acceptable voice quality, as well as to ensure traffic other than voice traffic.

• Even if Interface-based admission control is not enabled, the default (DOCSIS)scheduling mode blockstraffic after a certain number of calls.

• UGS with Activity Detection (UGS-AD) is not supported by the LLQ scheduler mode but remainssupported by the default DOCSIS scheduler mode.


Upstream Scheduler ModeRestrictions for Upstream Scheduler Mode

Information About Upstream Scheduler Mode for the CiscoCMTS Routers

With UGS, a service flow is created that enables a cable modem to transmit fixed-size bursts of data at aguaranteed rate and with a guaranteed level of jitter by providing periodic transmission opportunities to thecable modem for fixed-sized frames. This kind of service flow is particularly suitable for VoIP applications.

With rtPS, a service flow is created that provides a periodic opportunity for a cable modem to request permissionto transmit data by polling a single cable modem for a bandwidth request, rather than all the cable modems.This satisfies applications that have a requirement for real-time data transmission, and enables the cablemodem to transmit data bursts of varying length. This kind of service flow is particularly suitable for MPEGVoIP.

The rtPS requests, by default, are internally treated as priority 7—the highest priority for all Best Effort traffic.This high priority reduces the latency of rtPS traffic under congestion.

With nrtPS, a service flow is created that provides a periodic opportunity for a cable modem to requestpermission to transmit data by polling a single cable modem for a bandwidth request, rather than all the cablemodems. The data bursts may be of varying length. This kind of service flow is particularly suitable fornon-interactive services such as file transfers.

How to Configure Upstream Scheduler ModesProcedure





Example:

Step 2


Enters interface configuration mode for the specified cableinterface.

Use one the following commands:Step 3

• interface cable slot/subslot/port

• interface cable slot/port


Enables LLQ-type (packet-based) scheduling for UGSservices.

cable upstream n scheduling type ugs mode [llq|docsis]

Step 4

Example:


Upstream Scheduler ModeInformation About Upstream Scheduler Mode for the Cisco CMTS Routers

PurposeCommand or ActionRouter(config-if)# cable upstream 4 scheduling typeugs mode llq

Any combination of ugs, rtps, nrtps, llq, anddocsis is allowed. The only default value isdocsis .

Note

Enables standard DOCSIS (TDM-based) scheduling forrtPS services.

cable upstream n scheduling type rtps mode [llq|docsis]

Step 5

Example: Any combination of ugs, rtps, nrtps, llq, anddocsis is allowed. The only default value isdocsis .

Note

Router(config-if)# cable upstream 4 scheduling typertps mode docsis


end

Example:

Step 6


What to do next

To confirmwhether the scheduler is operating in DOCSISmode, use the show interface cable mac-schedulercommand.Router# show interface cable 7/0/1 mac-scheduler 0

DOCSIS 1.1 MAC scheduler for Cable7/0/1/U0 : rate 30720000wfq:Noneus_balance:OFFfairness:OFFQueue[Rng Polls] flows 0Queue[CIR Grants] flows 0Queue[BE(07) Grants] flows 0Queue[BE(06) Grants] flows 0Queue[BE(05) Grants] flows 0Queue[BE(04) Grants] flows 0Queue[BE(03) Grants] flows 0Queue[BE(02) Grants] flows 0Queue[BE(01) Grants] flows 0Queue[BE(00) Grants] flows 0Req Slots 2601578997, Req/Data Slots 4484512Init Mtn Slots 38265829, Stn Mtn Slots 78753Short Grant Slots 0, Long Grant Slots 0Adv Phy Short Grant Slots 412, Adv Phy Long Grant Slots 5519087Adv Phy UGS Grant Slots 0Avg upstream channel utilization : 1%Avg percent contention slots : 98%Avg percent initial ranging slots : 1%Avg percent minislots lost on late MAPs : 0%

MAP TSS: lch_state 9, init_retries 0late_initial_maps 0, late_ucd_maps 0mac-phy tss errors 0, missed ccc 0

Additional ReferencesThe following sections provide references related to the Cisco CMTS routers.


Upstream Scheduler ModeAdditional References

Related Documents


Cisco CMTS Cable Command Reference


Cisco CMTS command reference

Standards

TitleStandard

Data-Over-Cable Service Interface Specifications, DOCSIS 2.0, Radio Frequency InterfaceSpecification, CM-SP-RFIv2.0-I08-050408

DOCSIS


LinkDescription

http://www.cisco.com/cisco/web/support/index.htmlTheCisco Support andDocumentationwebsite providesonline resources to download documentation, software,and tools. Use these resources to install and configurethe software and to troubleshoot and resolve technicalissues with Cisco products and technologies. Access tomost tools on the Cisco Support and Documentationwebsite requires a Cisco.com user ID and password.

Feature Information for Upstream Scheduler ModeUse Cisco Feature Navigator to find information about the platform support and software image support.Cisco Feature Navigator enables you to determine which software images support a specific software release,feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An accounton the Cisco.com page is not required.


Note

Table 51: Feature Information for Upstream Scheduler Mode



Cisco IOS XE Fuji 16.7.1Upstream Scheduler Mode


Upstream Scheduler ModeFeature Information for Upstream Scheduler Mode





Upstream Scheduler ModeFeature Information for Upstream Scheduler Mode

C H A P T E R 15Generic Routing Encapsulation

This document describes the Generic Routing Encapsulation (GRE) feature. This feature is a tunneling protocolthat enables the encapsulation of a wide variety of protocol packet types inside IP tunnels, creating a virtualpoint-to-point link to Cisco routers at remote points over an IP internetwork.

• Finding Feature Information, on page 291• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 292• Restrictions for Implementing Tunnels, on page 292• Restrictions for GRE IPv6 Tunnels, on page 293• Information About Implementing Tunnels, on page 294• Information About IPv6 over IPv4 GRE Tunnels, on page 295• Information About GRE IPv6 Tunnels, on page 298• How to Implement Tunnels, on page 298• Configuration Examples for Implementing Tunnels, on page 305• How to Configure IPv6 over IPv4 GRE Tunnels, on page 308• Configuration Examples for IPv6 over IPv4 GRE Tunnels, on page 309• How to Configure GRE IPv6 Tunnels, on page 310• Configuration Examples for GRE IPv6 Tunnels, on page 312• Additional References, on page 312• Feature Information for Generic Routing Encapsulation , on page 314








Note













Digital PICs:


•













Restrictions for Implementing Tunnels• It is important to allow the tunnel protocol to pass through a firewall and access control list (ACL) check.


Generic Routing EncapsulationHardware Compatibility Matrix for the Cisco cBR Series Routers

• Multiple point-to-point tunnels can saturate the physical link with routing information if the bandwidthis not configured correctly on a tunnel interface.

• A tunnel looks like a single hop link, and routing protocols may prefer a tunnel over a multihop physicalpath. The tunnel, despite looking like a single hop link, may traverse a slower path than a multihop link.A tunnel is as robust and fast, or as unreliable and slow, as the links that it actually traverses. Routingprotocols that make their decisions based only on hop counts will often prefer a tunnel over a set ofphysical links. A tunnel might appear to be a one-hop, point-to-point link and have the lowest-cost path,but the tunnel may actually cost more in terms of latency when compared to an alternative physicaltopology. For example, in the topology shown in the figure below, packets from Host 1 will appear totravel across networks w, t, and z to get to Host 2 instead of taking the path w, x, y, and z because thetunnel hop count appears shorter. In fact, the packets going through the tunnel will still be travelingacross Router A, B, and C, but they must also travel to Router D before coming back to Router C.

Figure 2: Tunnel Precautions: Hop Counts

• A tunnel may have a recursive routing problem if routing is not configured accurately. The best path toa tunnel destination is via the tunnel itself; therefore recursive routing causes the tunnel interface to flap.To avoid recursive routing problems, keep the control-plane routing separate from the tunnel routing byusing the following methods:

• Use a different autonomous system number or tag.• Use a different routing protocol.• Ensure that static routes are used to override the first hop (watch for routing loops).

The following error is displayed when there is recursive routing to a tunnel destination:%TUN-RECURDOWN Interface Tunnel 0temporarily disabled due to recursive routing

Restrictions for GRE IPv6 Tunnels• GRE tunnel keepalive packets are not supported.

• Multipoint GRE (mGRE) IPv6 tunneling is not supported.


Generic Routing EncapsulationRestrictions for GRE IPv6 Tunnels

Information About Implementing Tunnels

Tunneling Versus EncapsulationTo understand how tunnels work, you must be able to distinguish between concepts of encapsulation andtunneling. Encapsulation is the process of adding headers to data at each layer of a particular protocol stack.The Open Systems Interconnection (OSI) reference model describes the functions of a network. To send adata packet from one host (for example, a PC) to another on a network, encapsulation is used to add a headerin front of the data packet at each layer of the protocol stack in descending order. The header must contain adata field that indicates the type of data encapsulated at the layer immediately above the current layer. As thepacket ascends the protocol stack on the receiving side of the network, each encapsulation header is removedin reverse order.

Tunneling encapsulates data packets from one protocol within a different protocol and transports the packetson a foreign network. Unlike encapsulation, tunneling allows a lower-layer protocol and a same-layer protocolto be carried through the tunnel. A tunnel interface is a virtual (or logical) interface. Tunneling consists ofthree main components:

• Passenger protocol—The protocol that you are encapsulating. For example, IPv4 and IPv6 protocols.

• Carrier protocol—The protocol that encapsulates. For example, generic routing encapsulation (GRE)and Multiprotocol Label Switching (MPLS).

• Transport protocol--The protocol that carries the encapsulated protocol. The main transport protocol isIP.

Tunnel ToSTunnel type of service (ToS) allows you to tunnel network traffic and group all packets in the same ToS bytevalue. The ToS byte values and Time-to-Live (TTL) hop-count value can be set in the encapsulating IP headerof tunnel packets for an IP tunnel interface on a router. Tunnel ToS feature is supported for Cisco ExpressForwarding (formerly known as CEF), fast switching, and process switching.

The ToS and TTL byte values are defined in RFC 791. RFC 2474, and RFC 2780 obsolete the use of the ToSbyte as defined in RFC 791. RFC 791 specifies that bits 6 and 7 of the ToS byte (the first two least significantbits) are reserved for future use and should be set to 0.

Path MTU DiscoveryPath MTU Discovery (PMTUD) can be enabled on a GRE or IP-in-IP tunnel interface. When PMTUD (RFC1191) is enabled on a tunnel interface, the router performs PMTUD processing for the GRE (or IP-in-IP)tunnel IP packets. The router always performs PMTUD processing on the original data IP packets that enterthe tunnel. When PMTUD is enabled, packet fragmentation is not permitted for packets that traverse the tunnelbecause the Don’t Fragment (DF) bit is set on all the packets. If a packet that enters the tunnel encounters alink with a smaller MTU, the packet is dropped and an Internet Control Message Protocol (ICMP) messageis sent back to the sender of the packet. This message indicates that fragmentation was required (but notpermitted) and provides the MTU of the link that caused the packet to be dropped.


Generic Routing EncapsulationInformation About Implementing Tunnels

PMTUD on a tunnel interface requires that the tunnel endpoint be able to receive ICMP messages generatedby routers in the path of the tunnel. Ensure that ICMP messages can be received before using PMTUD overfirewall connections.

Note

Use the tunnel path-mtu-discovery command to enable PMTUD for the tunnel packets and use the showinterfaces tunnel command to verify the tunnel PMTUD parameters. PMTUD works only on GRE andIP-in-IP tunnel interfaces.

QoS Options for TunnelsA tunnel interface supports various quality of service (QoS) features as a physical interface. QoS provides away to ensure that mission-critical traffic has an acceptable level of performance. QoS options for tunnelsinclude support for applying generic traffic shaping (GTS) directly on the tunnel interface and support forclass-based shaping using the modular QoS CLI (MQC). Tunnel interfaces also support class-based policing,but they do not support committed access rate (CAR).

GRE tunnels allow the router to copy the IP precedence bit values of the ToS byte to the tunnel or the GREIP header that encapsulates the inner packet. Intermediate routers between the tunnel endpoints can use theIP precedence values to classify packets for QoS features such as policy routing, weighted fair queueing(WFQ), and weighted random early detection (WRED).

When packets are encapsulated by tunnel or encryption headers, QoS features are unable to examine theoriginal packet headers and correctly classify the packets. Packets that travel across the same tunnel have thesame tunnel headers, so the packets are treated identically if the physical interface is congested. Tunnel packetscan, however, be classified before tunneling and encryption can occur when a user applies the QoS preclassifyfeature on the tunnel interface or on the crypto map.

Class-based WFQ (CBWFQ) inside class-based shaping is not supported on a multipoint interface.Note

For examples of how to implement some QoS features on a tunnel interface, see the section “ConfiguringQoS Options on Tunnel Interfaces Examples, on page 306”.

Information About IPv6 over IPv4 GRE Tunnels

Overlay Tunnels for IPv6Overlay tunneling encapsulates IPv6 packets in IPv4 packets for delivery across an IPv4 infrastructure (a corenetwork or the figure below). By using overlay tunnels, you can communicate with isolated IPv6 networkswithout upgrading the IPv4 infrastructure between them. Overlay tunnels can be configured between borderdevices or between a border device and a host; however, both tunnel endpoints must support both the IPv4and IPv6 protocol stacks. IPv6 supports the following types of overlay tunneling mechanisms:

• Manual

• Generic routing encapsulation (GRE)


Generic Routing EncapsulationQoS Options for Tunnels

• IPv4-compatible

• 6to4

• Intrasite Automatic Tunnel Addressing Protocol (ISATAP)

Figure 3: Overlay Tunnels

Overlay tunnels reduce the maximum transmission unit (MTU) of an interface by 20 octets (assuming thatthe basic IPv4 packet header does not contain optional fields). A network that uses overlay tunnels is difficultto troubleshoot. Therefore, overlay tunnels that connect isolated IPv6 networks should not be considered afinal IPv6 network architecture. The use of overlay tunnels should be considered as a transition techniquetoward a network that supports both the IPv4 and IPv6 protocol stacks or just the IPv6 protocol stack.

Note

Use the table below to help you determine which type of tunnel that you want to configure to carry IPv6packets over an IPv4 network.

Table 53: Suggested Usage of Tunnel Types to Carry IPv6 Packets over an IPv4 Network

Usage NotesSuggested UsageTunneling Type

Can carry IPv6 packets only.Simple point-to-point tunnels that can be usedwithin a site or between sites.

Manual

Can carry IPv6, ConnectionlessNetwork Service (CLNS), and manyother types of packets.

Simple point-to-point tunnels that can be usedwithin a site or between sites.

GRE- and IPv4-compatible

Uses the ::/96 prefix. We do notrecommend using this tunnel type.

Point-to-multipoint tunnels.IPv4- compatible

Sites use addresses from the 2002::/16prefix.

Point-to-multipoint tunnels that can be usedto connect isolated IPv6 sites.

6to4

Prefixes can be from the SP’s ownaddress block.

IPv6 service is provided to customers over anIPv4 network by using encapsulation of IPv6in IPv4.

6RD


Generic Routing EncapsulationOverlay Tunnels for IPv6

Usage NotesSuggested UsageTunneling Type

Sites can use any IPv6 unicastaddresses.

Point-to-multipoint tunnels that can be usedto connect systems within a site.

ISATAP

Individual tunnel types are discussed in detail in this document.We recommend that you review and understandthe information about the specific tunnel type that you want to implement. When you are familiar with thetype of tunnel you need, see the table below for a summary of the tunnel configuration parameters that youmay find useful.

Table 54: Tunnel Configuration Parameters by Tunneling Type

Tunnel Configuration ParameterTunneling Type

Interface Prefix orAddress

TunnelDestination

Tunnel SourceTunnel Mode

An IPv6 address.An IPv4 address.An IPv4address, ora referenceto aninterface onwhich IPv4isconfigured.

ipv6ipManual

An IPv6 address.An IPv4 address.gre ipGRE/IPv4

Not required. The interface addressis generated as ::tunnel-source/96.

Not required. Theseare allpoint-to-multipointtunneling types. TheIPv4 destinationaddress iscalculated, on aper-packet basis,from the IPv6destination.

ipv6ip auto-tunnelIPv4- compatible

An IPv6 address. The prefix mustembed the tunnel source IPv4address.

ipv6ip 6to46to4

An IPv6 address.ipv6ip 6rd6RD

An IPv6 prefix in modified eui-64format. The IPv6 address isgenerated from the prefix and thetunnel source IPv4 address.

ipv6ip isatapISATAP

GRE IPv4 Tunnel Support for IPv6 TrafficIPv6 traffic can be carried over IPv4 GRE tunnels using the standard GRE tunneling technique that is designedto provide the services to implement any standard point-to-point encapsulation scheme. As in IPv6 manuallyconfigured tunnels, GRE tunnels are links between two points, with a separate tunnel for each link. The tunnelsare not tied to a specific passenger or transport protocol but, in this case, carry IPv6 as the passenger protocolwith the GRE as the carrier protocol and IPv4 or IPv6 as the transport protocol.

The primary use of GRE tunnels is for stable connections that require regular secure communication betweentwo edge devices or between an edge device and an end system. The edge devices and the end systems mustbe dual-stack implementations.


Generic Routing EncapsulationGRE IPv4 Tunnel Support for IPv6 Traffic

Information About GRE IPv6 Tunnels

Overview of GRE IPv6 TunnelsThe GRE IPv6 Tunnels feature enables the delivery of packets from other protocols through an IPv6 networkand allows the routing of IPv6 packets between private networks across public networks with globally routedIPv6 addresses.

For point-to-point GRE tunnels, each tunnel interface requires a tunnel source IPv6 address and a tunneldestination IPv6 address when being configured. All packets are encapsulated with an outer IPv6 header anda GRE header.

How to Implement Tunnels

Determining the Tunnel TypeBefore configuring a tunnel, you must determine the type of tunnel you want to create.

SUMMARY STEPS

1. Determine the passenger protocol. A passenger protocol is the protocol that you are encapsulating.2. Determine the tunnel mode command keyword, if appropriate.

DETAILED STEPS

Step 1 Determine the passenger protocol. A passenger protocol is the protocol that you are encapsulating.Step 2 Determine the tunnel mode command keyword, if appropriate.

The table below shows how to determine the appropriate keyword to be used with the tunnel mode command.

Table 55: Determining the tunnel mode Command Keyword

PurposeKeyword

Use the dvmrp keyword to specify that the Distance Vector Multicast Routing Protocolencapsulation will be used.

dvmrp

Use the gre and ip keywords to specify that GRE encapsulation over IP will be used.gre ip

Use the gre and ipv6 keywords to specify that GRE encapsulation over IPv6 will be used.gre ipv6

Use the ipip keyword to specify that IP-in-IP encapsulation will be used. The optionaldecapsulate-any keyword terminates any number of IP-in-IP tunnels at one tunnel interface.Note that this tunnel will not carry any outbound traffic; however, any number of remotetunnel endpoints can use a tunnel configured as their destination.

ipip [decapsulate-any]

Use the ipv6 keyword to specify that generic packet tunneling in IPv6 will be used.ipv6


Generic Routing EncapsulationInformation About GRE IPv6 Tunnels

PurposeKeyword

Use the ipv6ip keyword to specify that IPv6 will be used as the passenger protocol and IPv4as both the carrier (encapsulation) and transport protocol. When additional keywords are notused, manual IPv6 tunnels are configured. Additional keywords can be used to specifyIPv4-compatible, 6to4, or ISATAP tunnels.

ipv6ip

Use the mpls keyword to specify that MPLS will be used for configuring traffic engineering(TE) tunnels.

mpls

Configuring an IPv4 GRE TunnelPerform this task to configure a GRE tunnel. A tunnel interface is used to pass protocol traffic across a networkthat does not normally support the protocol. To build a tunnel, you must define a tunnel interface on each ofthe two routers, and the tunnel interfaces must reference each other. At each router, the tunnel interface mustbe configured with a Layer 3 address. The tunnel endpoints, tunnel source, and tunnel destination must bedefined, and the type of tunnel must be selected. Optional steps can be performed to customize the tunnel.

Remember to configure the router at each end of the tunnel. If only one side of a tunnel is configured, thetunnel interface may still come up and stay up (unless keepalive is configured), but packets going into thetunnel will be dropped.

GRE Tunnel KeepaliveKeepalive packets can be configured to be sent over IP-encapsulated GRE tunnels. You can specify the rateat which keepalives are sent and the number of times that a device will continue to send keepalive packetswithout a response before the interface becomes inactive. GRE keepalive packets may be sent from both sidesof a tunnel or from just one side.

Before you begin

Ensure that the physical interface to be used as the tunnel source in this task is up and configured with theappropriate IP address. For hardware technical descriptions and information about installing interfaces, seethe hardware installation and configuration publication for your product.

Procedure





Example:

Step 2



Generic Routing EncapsulationConfiguring an IPv4 GRE Tunnel


Specifies the interface type and number, and entersinterface configuration mode.

interface type number

Example:

Step 3

• To configure a tunnel, use tunnel for the typeargument.

Router(config)# interface tunnel 0

Sets the current bandwidth value for an interface andcommunicates it to higher-level protocols.

bandwidth kb/s

Example:

Step 4

• Specifies the tunnel bandwidth to be used to transmitpackets.

Router(config-if)# bandwidth 1000

• Use the kb/s argument to set the bandwidth, in kilobitsper second (kb/s).

This is only a routing parameter; it does notaffect the physical interface. The defaultbandwidth setting on a tunnel interface is 9.6kb/s. You should set the bandwidth on a tunnelto an appropriate value.

Note

(Optional) Specifies the number of times the device willcontinue to send keepalive packets without response beforebringing the tunnel interface protocol down.

keepalive [period [retries]]

Example:Router(config-if)# keepalive 3 7

Step 5

• GRE keepalive packets may be configured either ononly one side of the tunnel or on both.

• If GRE keepalive is configured on both sides of thetunnel, the period and retries arguments can bedifferent at each side of the link.

This command is supported only on GREpoint-to-point tunnels.

Note

The GRE tunnel keepalive feature should notbe configured on a VRF tunnel. Thiscombination of features is not supported.

Note

Configures the tunnel source.tunnel source {ip-address | interface-typeinterface-number}

Step 6

The tunnel source IP address and destinationIP addresses must be defined on two separatedevices.

NoteExample:Router(config-if)# tunnel sourceTenGigabitEthernet 4/1/0

Configures the tunnel destination.tunnel destination {hostname | ip-address}Step 7

Example: The tunnel source and destination IP addressesmust be defined on two separate devices.

Note

Router(config-if)# tunnel destination 10.0.2.1


Generic Routing EncapsulationGRE Tunnel Keepalive


(Optional) Enables an ID key for a tunnel interface.tunnel key key-numberStep 8

Example: This command is supported only onGRE tunnelinterfaces. We do not recommend relying onthis key for security purposes.

Note

Router(config-if)# tunnel key 1000

Specifies the encapsulation protocol to be used in thetunnel.

tunnel mode gre { ip | multipoint}

Example:

Step 9

Device(config-if)# tunnel mode gre ip

(Optional) Sets the MTU size of IP packets sent on aninterface.

ip mtu bytes

Example:

Step 10

• If an IP packet exceeds theMTU set for the interface,the Cisco software will fragment it unless the DF bitis set.

Device(config-if)# ip mtu 1400

• All devices on a physical mediummust have the sameprotocol MTU in order to operate.

• For IPv6 packets, use the ipv6 mtu command.

If the tunnel path-mtu-discovery command isenabled do not configure this command.

Note

(Optional) Specifies the maximum segment size (MSS)for TCP connections that originate or terminate on a router.

ip tcp mss mss-value

Example:

Step 11

Device(config-if)# ip tcp mss 250

(Optional) Enables PMTUD on a GRE or IP-in-IP tunnelinterface.

tunnel path-mtu-discovery [age-timer {aging-mins |infinite}]

Step 12

Example: • When PMTUD is enabled on a tunnel interface,PMTUD will operate for GRE IP tunnel packets toDevice(config-if)# tunnel path-mtu-discoveryminimize fragmentation in the path between the tunnelendpoints.

Exits interface configurationmode and returns to privilegedEXEC mode.

end

Example:

Step 13

Device(config-if)# end

What to Do NextProceed to the “Verifying Tunnel Configuration and Operation” section.


Generic Routing EncapsulationWhat to Do Next

Configuring 6to4 Tunnels

Before you begin

With 6to4 tunnels, the tunnel destination is determined by the border-router IPv4 address, which is concatenatedto the prefix 2002::/16 in the format 2002:border-router-IPv4-address ::/48. The border router at each end ofa 6to4 tunnel must support both the IPv4 and IPv6 protocol stacks.

The configuration of only one IPv4-compatible tunnel and one 6to4 IPv6 tunnel is supported on a router. Ifyou choose to configure both of these tunnel types on the same router, Cisco recommends that they not sharethe same tunnel source.

A 6to4 tunnel and an IPv4-compatible tunnel cannot share the same interface because both of them are NBMA“point-to-multipoint” access links, and only the tunnel source can be used to reorder the packets from amultiplexed packet stream into a single packet stream for an incoming interface. When a packet with an IPv4protocol type of 41 arrives on an interface, the packet is mapped to an IPv6 tunnel interface on the basis ofthe IPv4 address. However, if both the 6to4 tunnel and the IPv4-compatible tunnel share the same sourceinterface, the router cannot determine the IPv6 tunnel interface to which it should assign the incoming packet.

Manually configured IPv6 tunnels can share the same source interface because a manual tunnel is a“point-to-point” link, and both IPv4 source and the IPv4 destination of the tunnel are defined.

Note

Procedure





Example:

Step 2


Specifies a tunnel interface and number and enters interfaceconfiguration mode.

interface tunnel tunnel-number

Example:

Step 3

Router(config)# interface tunnel 0

Specifies the IPv6 address assigned to the interface andenables IPv6 processing on the interface.

ipv6 address ipv6-prefix/prefix-length [eui-64]

Example:

Step 4

• The 32 bits following the initial 2002::/16 prefixcorrespond to an IPv4 address assigned to the tunnelsource.

Router(config-if)# ipv6 address2002:c0a8:6301:1::1/64

See the "Configuring Basic Connectivity forIPv6" module for more information onconfiguring IPv6 addresses.

Note


Generic Routing EncapsulationConfiguring 6to4 Tunnels


Specifies the source IPv4 address or the source interfacetype and number for the tunnel interface.

tunnel source {ip-address | interface-typeinterface-number}

Step 5

Example: The interface type and number specified in thetunnel source command must be configuredwith an IPv4 address.

Note

Router(config-if)# tunnel source TenGigabitEthernet4/1/0

Specifies an IPv6 overlay tunnel using a 6to4 address.tunnel mode ipv6ip 6to4

Example:

Step 6

Router(config-if)# tunnel mode ipv6ip 6to4

Exits interface configuration mode and returns to globalconfiguration mode.

exit

Example:

Step 7


Configures a static route to the specified tunnel interface.ipv6 route ipv6-prefix / prefix-length tunneltunnel-number

Step 8

When configuring a 6to4 overlay tunnel, youmust configure a static route for the IPv6 6to4prefix 2002::/16 to the 6to4 tunnel interface.

NoteExample:Router(config)# ipv6 route 2002::/16 tunnel 0

• The tunnel number specified in the ipv6 routecommand must be the same tunnel number specifiedin the interface tunnel command.


end

Example:

Step 9

Router(config)# end

What to Do NextProceed to the “Verifying Tunnel Configuration and Operation” section.

Verifying Tunnel Configuration and OperationThe show and ping commands in the steps below can be used in any sequence. The following commands canbe used for GRE tunnels, IPv6 manually configured tunnels, and IPv6 over IPv4 GRE tunnels.

Step 1 enable

Enables privileged EXEC mode. Enter your password if prompted.

Example:Device> enable

Step 2 show interfaces tunnel number [accounting]


Generic Routing EncapsulationWhat to Do Next

Two routers are configured to be endpoints of a tunnel. Device A has TenGigabit Ethernet interface 4/1/0 configured asthe source for tunnel interface 0 with an IPv4 address of 10.0.0.1 and an IPv6 prefix of 2001:0DB8:1111:2222::1/64.Device B has TenGigabit Ethernet interface 4/1/0 configured as the source for tunnel interface 1 with an IPv4 address of10.0.0.2 and an IPv6 prefix of 2001:0DB8:1111:2222::2/64.

To verify that the tunnel source and destination addresses are configured, use the show interfaces tunnel command onDevice A.

Example:

Device A# show interfaces tunnel 0

Tunnel0 is up, line protocol is upHardware is TunnelMTU 1514 bytes, BW 9 Kbit, DLY 500000 usec,

reliability 255/255, txload 1/255, rxload 1/255Encapsulation TUNNEL, loopback not setKeepalive not setTunnel source 10.0.0.1 (TenGigabitEthernet4/1/0), destination 10.0.0.2, fastswitch TTL 255Tunnel protocol/transport GRE/IP, key disabled, sequencing disabledTunnel TTL 255Checksumming of packets disabled, fast tunneling enabledLast input 00:00:14, output 00:00:04, output hang neverLast clearing of "show interface" counters neverInput queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0Queueing strategy: fifoOutput queue :0/0 (size/max)5 minute input rate 0 bits/sec, 0 packets/sec5 minute output rate 0 bits/sec, 0 packets/sec

4 packets input, 352 bytes, 0 no bufferReceived 0 broadcasts, 0 runts, 0 giants, 0 throttles0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort8 packets output, 704 bytes, 0 underruns0 output errors, 0 collisions, 0 interface resets0 output buffer failures, 0 output buffers swapped out

Step 3 ping [protocol] destination

To check that the local endpoint is configured and working, use the ping command on Device A.

Example:

DeviceA# ping 2001:0DB8:1111:2222::2

Type escape sequence to abort.Sending 5, 100-byte ICMP Echos to 2001:0DB8:1111:2222::2, timeout is 2 seconds:!!!!!Success rate is 100 percent (5/5), round-trip min/avg/max = 20/20/20 ms

Step 4 show ip route [address [mask]]

To check that a route exists to the remote endpoint address, use the show ip route command.

Example:

DeviceA# show ip route 10.0.0.2

Routing entry for 10.0.0.0/24Known via "connected", distance 0, metric 0 (connected, via interface)Routing Descriptor Blocks:* directly connected, via TenGigabitEthernet4/1/0

Route metric is 0, traffic share count is 1


Generic Routing EncapsulationVerifying Tunnel Configuration and Operation

Step 5 ping [protocol] destination

To check that the remote endpoint address is reachable, use the ping command on Device A.

The remote endpoint address may not be reachable using the ping command because of filtering, but the tunneltraffic may still reach its destination.

Note

Example:

DeviceA# ping 10.0.0.2

Type escape sequence to abort.Sending 5, 100-byte ICMP Echos to 10.0.0.2, timeout is 2 seconds:!!!!!Success rate is 100 percent (5/5), round-trip min/avg/max = 20/21/28 ms

To check that the remote IPv6 tunnel endpoint is reachable, use the ping command again on Device A. The note regardingfiltering earlier in step also applies to this example.

Example:

DeviceA# ping 2001:0DB8:1111:2222::2

Type escape sequence to abort.Sending 5, 100-byte ICMP Echos to 1::2, timeout is 2 seconds:!!!!!Success rate is 100 percent (5/5), round-trip min/avg/max = 20/20/20 ms

These steps may be repeated at the other endpoint of the tunnel.

Configuration Examples for Implementing Tunnels

Example: Configuring a GRE IPv4 TunnelThe following example shows a simple configuration of GRE tunneling. Note that TenGigabit Ethernetinterface 4/1/0 is the tunnel source for Router A and the tunnel destination for Router B. TenGigabit Ethernetinterface 4/1/1 is the tunnel source for Router B and the tunnel destination for Router A.

Router A

interface Tunnel 0ip address 10.1.1.2 255.255.255.0tunnel source TenGigabitEthernet 4/1/0tunnel destination 192.168.3.2tunnel mode gre ip!interface TenGigabitEthernet 4/1/0ip address 192.168.4.2 255.255.255.0

Router B

interface Tunnel 0


Generic Routing EncapsulationConfiguration Examples for Implementing Tunnels

ip address 10.1.1.1 255.255.255.0tunnel source TenGigabitEthernet 4/1/1tunnel destination 192.168.4.2tunnel mode gre ip!interface TenGigabitEthernet 4/1/1ip address 192.168.3.2 255.255.255.0

The following example configures a GRE tunnel running both IS-IS and IPv6 traffic between Router A andRouter B:

Router A

ipv6 unicast-routingclns routing!interface Tunnel 0no ip addressipv6 address 2001:0DB8:1111:2222::1/64ipv6 router isistunnel source TenGigabitEthernet 4/1/0tunnel destination 10.0.0.2tunnel mode gre ip!interface TenGigabitEthernet 4/1/0ip address 10.0.0.1 255.255.255.0!router isisnetwork 49.0000.0000.000a.00

Router B

ipv6 unicast-routingclns routing!interface Tunnel 0no ip addressipv6 address 2001:0DB8:1111:2222::2/64ipv6 router isistunnel source TenGigabitEthernet 4/1/0tunnel destination 10.0.0.1tunnel mode gre ip!interface TenGigabitEthernet 4/1/0ip address 10.0.0.2 255.255.255.0!router isisnetwork 49.0000.0000.000b.00address-family ipv6redistribute staticexit-address-family

Configuring QoS Options on Tunnel Interfaces ExamplesThe following sample configuration applies GTS directly on the tunnel interface. In this example, theconfiguration shapes the tunnel interface to an overall output rate of 500 kb/s.

interface Tunnel 0ip address 10.1.2.1 255.255.255.0


Generic Routing EncapsulationConfiguring QoS Options on Tunnel Interfaces Examples

traffic-shape rate 500000 125000 125000 1000tunnel source 10.1.1.1tunnel destination 10.2.2.2

The following sample configuration shows how to apply the same shaping policy to the tunnel interface withthe MQC commands:

policy-map tunnelclass class-defaultshape average 500000 125000 125000!interface Tunnel 0ip address 10.1.2.1 255.255.255.0service-policy output tunneltunnel source 10.1.35.1tunnel destination 10.1.35.2

Policing ExampleWhen an interface becomes congested and packets start to queue, you can apply a queueing method to packetsthat are waiting to be transmitted. Logical interfaces--tunnel interfaces in this example--do not inherentlysupport a state of congestion and do not support the direct application of a service policy that applies a queueingmethod. Instead, you must apply a hierarchical policy. Create a "child" or lower-level policy that configuresa queueing mechanism, such as low-latency queueing, with the priority command and CBWFQ with thebandwidth command.

policy-map childclass voicepriority 512

Create a "parent" or top-level policy that applies class-based shaping. Apply the child policy as a commandunder the parent policy because admission control for the child class is done according to the shaping rate forthe parent class.

policy-map tunnelclass class-defaultshape average 2000000service-policy child

Apply the parent policy to the tunnel interface.

interface tunnel 0service-policy tunnel

In the following example, a tunnel interface is configured with a service policy that applies queueing withoutshaping. A log message is displayed noting that this configuration is not supported.

Router(config)# interface tunnel1Router(config-if)# service-policy output childClass Based Weighted Fair Queueing not supported on this interface


Generic Routing EncapsulationPolicing Example

How to Configure IPv6 over IPv4 GRE Tunnels

Configuring GRE on IPv6 TunnelsGRE tunnels can be configured to run over an IPv6 network layer and to transport IPv4 and IPv6 packets inIPv6 tunnels.

Before you begin

When GRE IPv6 tunnels are configured, IPv6 addresses are assigned to the tunnel source and the tunneldestination. The tunnel interface can have either IPv4 addresses or IPv6 addresses assigned (this is not shownin the task). The host or device at each end of a configured tunnel must support both the IPv4 and IPv6 protocolstacks.

Procedure



Example: • Enter your password if prompted.

Device> enable


Example:

Step 2

Device# configure terminal

Specifies a tunnel interface and number, and enters interfaceconfiguration mode.


Example:

Step 3

Device(config)# interface tunnel 0

Specifies the IPv6 network assigned to the interface andenables IPv6 processing on the interface.

Enter one of the following commands:Step 4

• ipv6 address {ipv6-address/prefix-length | prefix-namesub-bits/prefix-length} • If you specify the eui-64 keyword, the software

configures an IPv6 address for an interface and enables• ipv6 address ipv6-prefix/prefix-length [eui-64]IPv6 processing on the interface using an EUI-64interface ID in the low-order 64 bits of the address.Example:

Device(config-if)# ipv6 address3ffe:b00:c18:1::3/127

Specifies the source IPv4 address, IPv6 address, or thesource interface type and number for the tunnel interface.

tunnel source {ip-address | ipv6-address | interface-typeinterface-number}

Step 5

Example: • If an interface is specified, the interface must beconfigured with an IPv4 address.

Device(config-if)# tunnel source Tengigabitethernet4/1/0


Generic Routing EncapsulationHow to Configure IPv6 over IPv4 GRE Tunnels


Specifies the destination IPv4 address, IPv6 address, orhostname for the tunnel interface.

tunnel destination {hostname | ip-address | ipv6-address}

Example:

Step 6

Device(config-if)# tunnel destination2001:DB8:1111:2222::1/64

Specifies a GRE IPv6 tunnel.tunnel mode {aurp | cayman | dvmrp | eon | gre | gremultipoint | gre ipv6 | ipip [decapsulate-any] | iptalk |ipv6 | mpls | nos}

Step 7

The tunnel mode gre ipv6 command specifiesGRE as the encapsulation protocol for the tunnel.

Note

Example:

Device(config-if)# tunnel mode gre ipv6


Example:

Step 8


Configuration Examples for IPv6 over IPv4 GRE Tunnels

Example: GRE Tunnel Running IS-IS and IPv6 TrafficThe following example configures a GRE tunnel running both IS-IS and IPv6 traffic between Router A andRouter B:

Router A Configuration

ipv6 unicast-routingclns routing!interface tunnel 0no ip addressipv6 address 3ffe:b00:c18:1::3/127ipv6 router isistunnel source TenGigabitEthernet 4/1/0tunnel destination 2001:DB8:1111:2222::1/64tunnel mode gre ipv6!interface TenGigabitEthernet4/1/0ip address 10.0.0.1 255.255.255.0!router isisnet 49.0000.0000.000a.00

Router B Configuration

ipv6 unicast-routingclns routing


Generic Routing EncapsulationConfiguration Examples for IPv6 over IPv4 GRE Tunnels

!interface tunnel 0no ip addressipv6 address 3ffe:b00:c18:1::2/127ipv6 router isistunnel source TenGigabitEthernet 4/1/0tunnel destination 2001:DB8:1111:2222::2/64tunnel mode gre ipv6!interface TenGigabitEthernet4/1/0ip address 10.0.0.2 255.255.255.0!router isisnet 49.0000.0000.000b.00address-family ipv6redistribute staticexit-address-family

Example: Tunnel Destination Address for IPv6 Tunnel

Router(config)#interface Tunnel0Router(config-if)#ipv6 address 2001:1:1::1/48Router(config-if)#tunnel source TenGigabitEthernet 4/1/0Router(config-if)#tunnel destination 10.0.0.2Router(config-if)#tunnel mode gre ipv6Router(config-if)#exit!Router(config)#interface TenGigabitEthernet4/1/0Router(config-if)#ip address 10.0.0.1 255.255.255.0Router(config-if)#exit!Router(config)#ipv6 unicast-routingRouter(config)#router isisRouter(config)#net 49.0000.0000.000a.00

How to Configure GRE IPv6 Tunnels

Configure CDP Over GRE IPv6 TunnelsPerform this task to configure a GRE tunnel on an IPv6 network. GRE tunnels can be configured to run overan IPv6 network layer and transport IPv6 and IPv4 packets through IPv6 tunnels.

You must enable IPv6 or configure IPv6 MTU size more than 1500 on a tunnel's exit interface to avoidreceiving warning messages.

Note

Before you begin

When GRE IPv6 tunnels are configured, IPv6 addresses are assigned to the tunnel source and the tunneldestination. The tunnel interface can have either IPv4 or IPv6 addresses. The host or device at each end ofthe configured tunnel must support both IPv4 and IPv6 protocol stacks.


Generic Routing EncapsulationExample: Tunnel Destination Address for IPv6 Tunnel

Procedure



Example: • Enter your password if prompted.Device> enable


Example:

Step 2

Device# configure terminal

Specifies a tunnel interface and number and enters interfaceconfiguration mode.


Example:

Step 3

Device(config)# interface tunnel 0

Enables Cisco Discovery Protocol on the interface.CDP enable

Example:

Step 4

Device(config)# CDP enable

Specifies the source IPv6 address or the source interfacetype and number for the tunnel interface.

tunnel source {ipv6-address | interface-type|interface-number }

Step 5

Example: • If an interface type and number are specified, theinterface must be configured with an IPv6 address.Device(config-if)# tunnel source ethernet 0

For more information on the tunnel sourcecommand, refer to the IPv6 command referenceguide.

Note

Specifies the destination IPv6 address for the tunnelinterface.

tunnel destination ipv6-address

Example:

Step 6

For more information on the tunnel destinationcommand, refer to the IPv6 command referenceguide.

NoteDevice(config-if)# tunnel destination2001:0DB8:0C18:2::300

Specifies a GRE IPv6 tunnel.tunnel mode gre ipv6Step 7

Example: The tunnel mode gre ipv6 command specifiesGRE as the encapsulation protocol for the tunnelinterface. Only the syntax used in this context isdisplayed. For more details, see the IPv6Command Reference.

Note

Device(config-if)# tunnel mode gre ipv6


end

Example:

Step 8



Generic Routing EncapsulationConfigure CDP Over GRE IPv6 Tunnels

http://www.cisco.com/en/US/docs/ios-xml/ios/ipv6/command/ipv6-cr-book.html

http://www.cisco.com/en/US/docs/ios-xml/ios/ipv6/command/ipv6-cr-book.html

Configuration Examples for GRE IPv6 Tunnels

Example: Configuring CDP Over GRE IPv6 TunnelsThe following example shows how to configure a GRE tunnel over an IPv6 transport. In this example,Ethernet0/0 has an IPv6 address, and this is the source address used by the tunnel interface. The destinationIPv6 address of the tunnel is specified directly. In this example, the tunnel carries both IPv4 and IS-IS traffic.interface Tunnel0ip address 10.1.1.1 255.255.255.0ip router isistunnel source Ethernet0/0tunnel destination 2001:DB8:1111:2222::1tunnel mode gre ipv6!interface Ethernet0/0no ip addressipv6 address 2001:DB8:1111:1111::1/64!router isisnet 49.0001.0000.0000.000a.00

The following example shows how to configure CDP on GRE IPv6 P2P Tunnel Interface.interface Tunnel1cdp enableipv6 address 20::1/64tunnel source Ethernet0/0tunnel mode gre ipv6tunnel destination 10::2

end

The following example shows how to configure CDP on GRE IPv6 Multipoint Tunnel Interface.interface Tunnel1

ipv6 address 172::2/64ipv6 nhrp map 172::1/64 192::1ipv6 nhrp map multicast 192::1ipv6 nhrp network-id 1ipv6 nhrp nhs 172::1llp nhrp map multicast 192::1tunnel source 2000::1tunnel mode gre multipoint ipv6

end

The following show example displays the CDP neighbor tunnels that are configured in a device.Router#show cdp neighborsCapability Codes: R - Router, T - Trans Bridge, B - Source Route Bridge

S - Switch, H - Host, I - IGMP, r - Repeater, P - Phone,D - Remote, C - CVTA, M - Two-port Mac Relay

Device ID Local Intrfce Holdtme Capability Platform Port IDRouter Tunnel1 179 R Linux Uni Tunnel1

Additional ReferencesThe following sections provide references related to the GRE feature.


Generic Routing EncapsulationConfiguration Examples for GRE IPv6 Tunnels

Related Documents

Document TitleRelatedTopic

Cisco CMTS Cable Command Reference, at the following URL:http://www.cisco.com/c/en/us/td/docs/cable/cmts/cmd_ref/b_cmts_cable_cmd_ref.html

CMTSCommandReference

Configuring GRE Tunnel over Cable, at the following URL:http://www.cisco.com/en/US/tech/tk86/tk89/technologies_configuration_example09186a008011520d.shtml

ConfiguringGRETunnelover Cable

Standards

TitleStandard

Data-over-Cable Service Interface Specifications Radio Frequency InterfaceSpecification, version 1.1 ( http://www.cablemodem.com )

SP-RFIv1.1-I09-020830

MIBs

MIBs LinkMIB

To locate and download MIBs for selected platforms, Cisco IOSreleases, and feature sets, use Cisco MIB Locator found at thefollowing URL:

http://tools.cisco.com/ITDIT/MIBS/servlet/index

No new or modified MIBs aresupported by this feature.

RFCs

TitleRFC

Generic Routing Encapsulation (GRE)RFC 1701

Generic Routing Encapsulation over IPv4 networksRFC 1702

IP in IP TunnelingRFC 1853

IP Encapsulation within IPRFC 2003

Generic Routing Ecapsulation (GRE)RFC 2784

Key and Sequence Number Extensions to GRERFC2890


Generic Routing EncapsulationAdditional References


http://www.cisco.com/en/US/tech/tk86/tk89/technologies_configuration_example09186a008011520d.shtml

http://www.cablemodem.com

http://www.cablemodem.com/specifications/specifications11.html

http://tools.cisco.com/ITDIT/MIBS/servlet/index

http://www.ietf.org/rfc/rfc1701.txt







LinkDescription

http://www.cisco.com/cisco/web/support/index.htmlThe Cisco Technical Support &Documentationwebsitecontains thousands of pages of searchable technicalcontent, including links to products, technologies,solutions, technical tips, and tools. RegisteredCisco.com users can log in from this page to accesseven more content.

Feature Information for Generic Routing EncapsulationUse Cisco Feature Navigator to find information about the platform support and software image support.Cisco Feature Navigator enables you to determine which software images support a specific software release,feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An accounton the Cisco.com page is not required.


Note

Table 56: Feature Information for Generic Routing Encapsulation




Generic Routing Encapsulation


Generic Routing EncapsulationFeature Information for Generic Routing Encapsulation



C H A P T E R 16Transparent LAN Service over Cable

This document describes the Transparent LAN Service (TLS) over Cable feature, which enhances existingWide Area Network (WAN) support to provide more flexible Managed Access for multiple Internet serviceprovider (ISP) support over a hybrid fiber-coaxial (HFC) cable network. This feature allows service providersto create a Layer 2 tunnel by mapping an upstream service identifier (SID) to an IEEE 802.1Q Virtual LocalArea Network (VLAN).



Contents

• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 315• Prerequisites for Transparent LAN Service over Cable, on page 316• Restrictions for Transparent LAN Service over Cable, on page 317• Information About Transparent LAN Service over Cable, on page 317• How to Configure the Transparent LAN Service over Cable, on page 320• Configuration Examples for Transparent LAN Service over Cable, on page 322• Verifying the Transparent LAN Service over Cable Configuration, on page 323• Additional References, on page 324• Feature Information for Transparent LAN Service over Cable , on page 325



Note
















Digital PICs:


•













Prerequisites for Transparent LAN Service over Cable• You must know the hardware (MAC) addresses of the cable modems that are to be mapped to IEEE802.1Q VLANs.

• You must create a bridge group for each separate customer on the Layer 2 bridge aggregator, so thattraffic from all of the Customer Premises Equipment (CPE) devices for the customer is grouped togetherinto the same 802.1Q tunnel.


Transparent LAN Service over CablePrerequisites for Transparent LAN Service over Cable

Restrictions for Transparent LAN Service over Cable• Configuring 802.1Q for a particular cable modem removes any previous cable modem configuration onthe router.

• We strongly recommend that TLS over Cable only be used when Baseline Privacy Interface (BPI) isenabled in the environment. If BPI is not enabled when using the TLS feature, traffic can flow betweenmultiple virtual private networks (VPNs), and become vulnerable to denial-of-service attacks or snooping.We also recommend that remote networks be isolated with a gateway or firewall router when BPI is notenabled.

When the TLS feature is used with Layer 2 VPNs, the participating cable modems must have the BaselinePrivacy Interface security feature (BPI) enabled. Otherwise, the Cisco CMTS drops such Layer 2 traffic inthe upstream or downstream.

• Packets are mapped to their Layer 2 tunnel only on the basis of Layer 2 information (the cable modem’sMAC address and primary SID). Layer 3 services, such as access lists, IP address source-verify, and IPQoS, are not supported as packets are sent through the tunnel.

• All traffic from a cable modem is mapped to the same Layer 2 tunnel. It is not possible to differentiatetraffic from different customer premises equipment (CPE) devices behind the cable modem.

• CPE learning is not available when using the Transparent LAN Service over Cable feature. When a cablemodem is mapped to a Layer 2 tunnel, the show interface cable modem command shows that the IPaddresses for its CPE devices are “unavailable.”

• DOCSIS QoS is supported across the Layer 2 tunnel only on the primary SID. Traffic using secondaryservices uses the same Layer 2 tunnel as the primary SID.

• The Spanning Tree Protocol (STP) cannot be used with devices (cable modems, their CPE devices, andthe endpoint CPE devices) that are using this feature. In particular, Spanning Tree Protocol cannot beused between the VLAN bridge aggregator and the endpoint customer devices.

• The following restrictions apply to Layer 2 tunnels over an Ethernet IEEE 802.1Q VLAN interface:

• IEEE 802.1Q tunnels are supported only on Ten Gigabit Ethernet interfaces.• The Cisco CMTS router supports a maximum of 4095 VLAN IDs, but the switches acting as thebridge aggregator might support a lower number of VLAN IDs. If this is the case, the Cisco CMTSshould be configured only for the maximum number of VLANs that are supported by the bridgeaggregator switches.

Information About Transparent LAN Service over CableThis section contains the following:

Feature OverviewThe Transparent LAN Service over Cable feature enables service providers to provide Layer 2 tunnels fortraffic to and from cable modems. This allows customers to create their own virtual local area network (VLAN)using any number of cable modems in multiple sites.


Transparent LAN Service over CableRestrictions for Transparent LAN Service over Cable

On the Cisco CMTS, you map each cable modem (on the basis of its MAC address) to the appropriate VLAN.The CMTS then creates an internal database of this one-to-one mapping of cable modems to VLANs, anduses it to encapsulate packets for the appropriate VLAN.

The CMTS encapsulates the CPE traffic from mapped cable modems using the following method:

• IEEE 802.1Q Mapping—The cable modem’s MAC address is mapped to an IEEE 802.1Q VLAN on aspecific Ten Gigabit Ethernet interface, so that all traffic from the cable modem is tagged with thespecified VLAN ID.

Traffic to and from this group of cable modems is bridged into a single logical network (the VLAN) by thebridge aggregator, creating a secure Virtual Private Network (VPN) for that particular group of cable modems.Traffic in one VLAN cannot be sent into another VLAN, unless specifically done so by an external router.

The switch acting as the Layer 2 Bridge Aggregator uses the VLAN tagging to forward the traffic to theappropriate destination. This frees up service providers from needing to know the addressing, routing, andtopological details of the customer’s network.

Transparent LAN Service and Layer 2 Virtual Private NetworksIn addition, service providers can provide a Layer 2 VPN with only minimal configuration changes on theprovider’s routers. The service subscriber does not need to make any changes to their private network or cablemodems, nor does the service provider have to provide any special DOCSIS configuration files to enable thisfeature.

For the TLS feature with Layer 2 VPNs:

• When the TLS feature is used with Layer 2 VPNs, the participating cable modemsmust have the BaselinePrivacy Interface security feature (BPI) enabled. Otherwise, the Cisco CMTS drops such Layer 2 trafficin the upstream or downstream.

• Information about Customer Premises Equipment (CPE) does not display in the output of the show cablemodem command.

IEEE 802.1Q MappingThis section describes the mapping of cable modems to an IEEE 802.1Q VLAN, as it is available in theTransparent LAN Service over Cable feature:

OverviewThe Transparent LAN Service over Cable feature enables service providers to provide Layer 2 tunnels overan Ethernet network, using IEEE 802.1Q standard tags. This allows customers to create their own virtualnetwork using any number of cable modems in different sites.

On the Cisco CMTS, you map each cable modem (on the basis of its MAC address) to the appropriate VLAN.The CMTS then creates an internal database of this one-to-one mapping of cable modems to VLANs, anduses it to encapsulate packets for the appropriate VLAN.

The CMTS encapsulates the CPE traffic from mapped cable modems using VLAN tags, as defined in IEEE802.1Q-1993, IEEE Standards for Local and Metropolitan Area Networks: Virtual Bridged Local AreaNetworks . The switch acting as the Layer 2 Bridge Aggregator uses the VLAN tagging to forward the packetsto the appropriate destination.


Transparent LAN Service over CableTransparent LAN Service and Layer 2 Virtual Private Networks

http://standards.ieee.org/getieee802/download/802.1Q-1998.pdf



Traffic to and from this group of cable modems is bridged into a single logical network by the bridge aggregator,creating a secure Virtual Private Network (VPN) for that particular group of cable modems. Traffic in oneVLAN cannot be sent into another VLAN, unless specifically done so by an external router.

Details of IEEE 802.1Q MappingTo implement the Transparent LAN Service over Cable feature using IEEE 802.1QVLANs, a service providermust perform the following configuration steps:

1. Identify the cable modems and their MAC addresses that should be mapped to the IEEE 802.1Q VLANs.2. Create the required VLANs on the router that is acting as the bridge aggregator.3. Enable Layer 2 mapping on the Cisco CMTS, and then map each cable modem on that Cisco CMTS to

the appropriate VLAN.

After the Transparent LAN Service over Cable feature has been enabled and configured to use IEEE 802.1Qmappings, the Cisco CMTS immediately begins mapping traffic between the associated cable modems andVLANs. For efficient mapping, the Cisco CMTSmaintains an internal database that links each cable modem’sprimary service flow ID (SFID) and service ID (SID) to the appropriate VLAN and Ethernet interface. Thisensures that all service flows from the cable modem are routed properly.

When the Cisco CMTS receives a packet on an upstream, it looks up its SID to see if it is mapped to a VLAN.If so, and if the packet’s sourceMAC address is not the cable modem’sMAC address, the Cisco CMTS insertsthe appropriate IEEE 802.1Q VLAN tag into the packet’s header and forwards the packet to the appropriateEthernet interface. If the packet is not being mapped, or if the packet originated from the cable modem, theCisco CMTS routes the packet using the normal Layer 3 processes.

When the Cisco CMTS receives a packet from a WAN interface that is encapsulated with an IEEE 802.1QVLAN tag, it looks up the packet’s SID to see if it belongs to a cable modem being mapped. If so, the CiscoCMTS strips off the VLAN tag, adds the proper DOCSIS header, and transmits the packet on the appropriatedownstream interface. If the packet is not being mapped, the Cisco CMTS continues with the normal Layer3 processing.

BenefitsThe Transparent LAN Service over Cable feature provides the following benefits to cable service providersand their partners and customers:

• Provides Layer 2 level mapping, which is transparent to Layer 3 protocols and services. This means thatservice providers do not need to know the details of their customers’ network topologies, routing protocols,or IP addressing.

• Allows service providers to maximize the use of their existing Ethernet WAN networks. Multiplecustomers can be combined on the same outgoing interface, while still ensuring that each customer’snetwork is kept private while it is transmitted over the tunnel.

• Provides a highly flexible and scalable solution for multiple customers. The service provider needs tocreate only one bridge group for each VPN, and then only one VLAN mapping for each cable modemshould participate in that VPN tunnel.

• Customers retain full control over their private networks, while service providers retain full control overcable modems and the rest of the cable andWAN networks. Only the CPE traffic from the cable modemsis mapped into the L2VPN tunnel, while traffic originating at the cable modem continues to be processedas normal by the service provider's network.

• Allows service providers to mix tunneled and non-tunneled cable modems on the same DOCSIS cablenetwork.


Transparent LAN Service over CableDetails of IEEE 802.1Q Mapping

• Allows customers to create a single, secure virtual network with Ethernet Layer 2 connectivity for multiplesites.

• Allows multiple tunnels from different customers and endpoints to be aggregated into a single bridge,so as to maximize the use of bandwidth and other network resources.

• Supports the tunneling of multiple Layer 3, non-IP protocols, and not just IP Layer 3 services, as is thecase with Layer 3 solutions, such as Multiprotocol Label Switching (MPLS) VPNs.

• All DOCSIS services, including BPI+ encryption and authentication, continue to be supported for allcable modems.

How to Configure the Transparent LAN Service over CableThis section contains the following:

Configuring IEEE 802.1Q VLAN MappingThis section describes how to enable Layer 2 mapping on the Cisco CMTS, and then to map particular cablemodems to an IEEE 802.1Q VLAN.

Enabling and Configuring Layer 2 Tunneling for IEEE 802.1Q MappingThis section describes how to enable Layer 2 mapping on the Cisco CMTS, and then to map particular cablemodems to IEEE 802.1Q VLANs on a Ten Gigabit Ethernet interface.

Procedure



enable

Example:

Step 1

Router> enable


Example:

Step 2


Enables Layer 2 tunneling for IEEE 802.1Q VLANmapping.

cable l2-vpn-service xconnect nsi dot1q

Example:

Step 3

It is not required to configure VLAN trunkingon the Cisco CMTS. Though VLAN trunking issupported, be aware of additional impact ofVLAN trunking on the Cisco CMTS.

NoteRouter(config)# cable l2-vpn-service xconnect nsidot1q

Maps the specified MAC address of a cable modem to theindicated VLAN and Ten Gigabit Ethernet interface.

cable dot1q-vc-map mac-address ethernet-interface vlan-id[cust-name ]

Step 4

Example: Repeat this command for each cable modem thatis to be mapped to an IEEE 802.1Q VLAN.

Note


Transparent LAN Service over CableHow to Configure the Transparent LAN Service over Cable


Router(config)# cable dot1q-vc-map 0000.0C04.0506TenGigabitEthernet4/1/0 10


end

Example:

Step 5

Router(config)# end

Creating the IEEE 802.1Q VLAN Bridge GroupThis section describes the minimum configuration needed to configure a Cisco router, which is acting as anIEEE 802.1Q VLAN bridge aggregator, so that it can terminate the VLANs being used with the TransparentLAN Service over Cable feature.

Procedure



enable

Example:

Step 1

Router> enable


Example:

Step 2


Example:

Enters interface configuration mode for the Ten GigabitEthernet interface.

interface TenGigabitEthernet slot/subslot/port

Example:

Step 3

Router(config)# interface TenGigabitEthernet4/1/0

Configures the interface with the specified IP address andsubnet mask.

ip address ip-address mask

Example:

Step 4

Router(config-if)# ip address 10.10.10.85255.255.255.0

Exits interface configuration and returns to globalconfiguration mode.

exit

Example:

Step 5


Creates a subinterface on the Ten Gigabit Ethernet interface.interface TenGigabitEthernet slot/subslot/port.yStep 6

Example:


Transparent LAN Service over CableCreating the IEEE 802.1Q VLAN Bridge Group


Router(config)# interfaceTenGigabitEthernet4/1/0.10

To simplify network management, set thesubinterface number to the same value as theVLAN ID that will use this subinterface (whichin this case is 10).

Note

The steps to create a subinterface is not essentialfor dot1q tagging of frames, but it isrecommended.

Note

Configures this subinterface to belong to the specified bridgegroup.

bridge group number

Example:

Step 7

Repeat steps Step 5 through Step 7 for eachsubinterface to be created and bridged.

NoteRouter(config-if)# bridge group 20


end

Example:

Step 8


ConfigurationExamplesforTransparentLANServiceoverCableThis section lists sample configurations for the Transparent LAN Service over Cable feature on a CMTSrouter and on a Cisco router acting as a bridge aggregator:

Example: Configuring IEEE 802.1Q VLAN MappingThe following partial configuration shows a typical configuration that shows a number of cable modems beingmapped to two different IEEE 802.1Q VLANs.

cable l2-vpn-service xconnect nsi dot1q! Customer 1cable dot1q-vc-map 000C.0e03.69f9 TenGigabitEthernet 4/1/0 10 Customer1cable dot1q-vc-map 0010.7bea.9c95 TenGigabitEthernet 4/1/0 11 Customer1cable dot1q-vc-map 0010.7bed.81c2 TenGigabitEthernet 4/1/0 12 Customer1cable dot1q-vc-map 0010.7bed.9b1a TenGigabitEthernet 4/1/0 13 Customer1! Customer 2cable dot1q-vc-map 0002.fdfa.137d TenGigabitEthernet 4/1/0 20 Customer2cable dot1q-vc-map 0006.28f9.9d19 TenGigabitEthernet 4/1/0 21 Customer2cable dot1q-vc-map 000C.7b6b.58c1 TenGigabitEthernet 4/1/0 22 Customer2cable dot1q-vc-map 000C.7bed.9dbb TenGigabitEthernet 4/1/0 23 Customer2cable dot1q-vc-map 000C.7b43.aa7f TenGigabitEthernet 4/1/0 24 Customer2cable dot1q-vc-map 0050.7302.3d83 TenGigabitEthernet 4/1/0 25 Customer2...

Example: Configuring IEEE 802.1Q Bridge AggregatorThe following example shows a router being used as a bridge aggregator to transmit VLANs across the sameTen Gigabit Ethernet interface, using IEEE 802.1Q tagging.


Transparent LAN Service over CableConfiguration Examples for Transparent LAN Service over Cable

!interface TenGigabitEthernet4/1/0ip address 10.10.10.31 255.255.255.0duplex fullspeed auto!interface TenGigabitEthernet4/1/0.10description Customer1-site10encapsulation dot1Q 10bridge-group 200interface TenGigabitEthernet4/1/0.11description Customer1-site11encapsulation dot1Q 11bridge-group 200interface TenGigabitEthernet4/1/0.12description Customer1-site12encapsulation dot1Q 12bridge-group 200interface TenGigabitEthernet4/1/0.13description Customer1-site13encapsulation dot1Q 13bridge-group 200!------------------------------------interface TenGigabitEthernet4/1/0.20description Customer2-site20encapsulation dot1Q 20bridge-group 201interface TenGigabitEthernet4/1/0.21description Customer2-site21encapsulation dot1Q 21bridge-group 201interface TenGigabitEthernet4/1/0.22description Customer2-site22encapsulation dot1Q 22bridge-group 201interface TenGigabitEthernet4/1/0.23description Customer2-site23encapsulation dot1Q 23bridge-group 201interface TenGigabitEthernet4/1/0.24description Customer2-site24encapsulation dot1Q 24bridge-group 201interface TenGigabitEthernet4/1/0.25description Customer2-site25encapsulation dot1Q 25bridge-group 201!bridge 200 protocol ieeebridge 201 protocol ieee...

Verifying the Transparent LAN Service over Cable Configuration• show cable l2-vpn xconnect dot1q-vc-map —Displays the mapping information of the cable modemsto IEEE 802.1Q VLANs.

Following is a sample output of the command:


Transparent LAN Service over CableVerifying the Transparent LAN Service over Cable Configuration

Router# show cable l2-vpn xconnect dot1q-vc-map

MAC Address Ethernet Interface VLAN ID Cable Intf SID Customer Name/VPNID38c8.5cac.4a62 TenGigabitEthernet4/1/2 56 Cable3/0/0 4 Customer238c8.5cfe.f6fa TenGigabitEthernet4/1/2 34 Cable3/0/0 3 Customer1602a.d083.2e1c TenGigabitEthernet4/1/4 43 Cable3/0/0 5 Customer3

• show cable l2-vpn xconnect dot1q-vc-map customer name—Displays the mapping information of thecable modems to IEEE 802.1Q VLANs for the specified customer name.

Following is a sample output of the command.Router# show cable l2-vpn xconnect dot1q-vc-map customer Customer1

MAC Address Ethernet Interface VLAN ID Cable Intf SID Customer Name/VPNID38c8.5cfe.f6fa TenGigabitEthernet4/1/2 34 Cable3/0/0 3 Customer1

• show cable l2-vpn xconnect dot1q-vc-map mac-address—Displays the mapping information of thecable modems to IEEE 802.1Q VLANs for the specified MAC address.

Following is a sample output of the command:Router# show cable l2-vpn xconnect dot1q-vc-map 38c8.5cac.4a62

MAC Address Ethernet Interface VLAN ID Cable Intf SID Customer Name/VPNID38c8.5cac.4a62 TenGigabitEthernet4/1/2 56 Cable3/0/0 4 Customer2

• show cable l2-vpn xconnect dot1q-vc-map mac-address verbose—Displays additional informationabout the Layer 2 mapping, including the number of packets and bytes received on the upstream anddownstream.

Following is a sample output of the command:Router# show cable l2-vpn xconnect dot1q-vc-map 38c8.5cac.4a62 verbose

MAC Address : 38c8.5cac.4a62Customer Name : Customer2Prim Sid : 4Cable Interface : Cable3/0/0Ethernet Interface : TenGigabitEthernet4/1/2DOT1Q VLAN ID : 56Total US pkts : 1Total US bytes : 342Total DS pkts : 4Total DS bytes : 512

Additional ReferencesStandards

TitleStandards

Data-over-Cable Service Interface Specifications Radio Frequency InterfaceSpecification

SP-RFIv1.1-I08-020301


Transparent LAN Service over CableAdditional References

TitleStandards

IEEE Standards for Local and Metropolitan Area Networks: Virtual BridgedLocal Area Networks

IEEE 802.1Q, 1998 Edition

RFCs

TitleRFCs2

A Border Gateway ProtocolRFC 1163

Application of the Border Gateway Protocol in the InternetRFC 1164

DOCSIS OSSI Objects SupportRFC 2233

Multiprotocol Extensions for BGP-4RFC 2283

DOCSIS Ethernet MIB Objects SupportRFC 2665

Cable Device MIBRFC 2669

2 Not all supported RFCs are listed.


LinkDescription

http://www.cisco.com/cisco/web/support/index.htmlTechnical Assistance Center (TAC) home page,containing 30,000 pages of searchable technical content,including links to products, technologies, solutions,technical tips, and tools. Registered Cisco.com userscan log in from this page to access even more content.

Feature Information for Transparent LAN Service over CableUse Cisco Feature Navigator to find information about the platform support and software image support.Cisco Feature Navigator enables you to determine which software images support a specific software release,feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An accounton the Cisco.com page is not required.


Note


Transparent LAN Service over CableFeature Information for Transparent LAN Service over Cable















Table 58: Feature Information for Upstream Channel Bonding




Transparent LAN Service overCable


Transparent LAN Service over CableFeature Information for Transparent LAN Service over Cable

C H A P T E R 17Downgrading Channel Bonding in BatteryBackup Mode

Cisco CMTS supports downgrading the channel bonding for cable modems and media terminal adapters(MTAs) in battery backup mode.



Contents

• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 327• Prerequisites for Downgrading Channel Bonding in Battery Backup Mode, on page 328• Restrictions for Downgrading Channel Bonding in Battery Backup Mode, on page 329• Information About Downgrading Channel Bonding in Battery Backup Mode, on page 329• How to Configure Downgrading Channel Bonding in Battery Backup Mode, on page 330• Verifying the Configuration for Channel Bonding Downgrade in Battery Backup Mode, on page 332• Additional References, on page 335• Feature Information for Downgrading Channel Bonding in Battery Backup Mode, on page 336



Note
















Digital PICs:


•













Prerequisites for Downgrading Channel Bonding in BatteryBackup Mode

• The cable modem must be DOCSIS3.0-compliant with battery backup capability.

• At last one free Downstream Resilient Bonding Group (RBG) must be available.

For information about how to reserve RBG and verify reserved RBG, refer toDownstream Resiliency Bonding Group , on page 161

Note


Downgrading Channel Bonding in Battery Backup ModePrerequisites for Downgrading Channel Bonding in Battery Backup Mode

Restrictions for Downgrading Channel Bonding in BatteryBackup Mode

• If the cablemodem does not support the CM-STATUS events 9 and 10, channel bonding is not downgradedfor the cable modem in battery backup mode.

We recommend that you configure separate dynamic bonding groups for eachprimary channel in a MAC domain.

Note

• If the cable modem has an active voice call, channel bonding is not downgraded for the cable modem inbattery backup mode.

• If the cable modem is working on the protect line card, channel bonding is not downgraded if its primarychannel is not included in the dynamic bonding group.

• If the line card switches over when the cable modem is entering or exiting the battery backup mode, thecable modem may go offline.

Information About Downgrading Channel Bonding in BatteryBackup Mode

When this feature is enabled and the cable modem enters the battery backup mode, channel bonding isdowngraded to one downstream and one upstream channels (battery backup 1x1 mode). This feature reducesthe power usage when the cable modem is running on battery backup. When the cable modem returns to theAC power mode, the channel bonding is returned to its original configuration. You can configure this featureglobally and for each MAC domain.

We recommend that you enable this feature globally and for each MAC domain.Note

The cable modem uses the following CM-STATUS events to indicate its power status to the Cisco CMTS:

• 9—Indicates that the cable modem is operating in battery backup mode.

• 10—Indicates that the cable modem has returned to AC power mode.

When this feature is disabled, cable modem cannot downgrade the channel bonding even if it is running onbattery backup.


Downgrading Channel Bonding in Battery Backup ModeRestrictions for Downgrading Channel Bonding in Battery Backup Mode

How to Configure Downgrading Channel Bonding in BatteryBackup Mode

This section contains the following:

Configuring Channel Bonding Downgrade in Battery Backup Mode Globally

Procedure





Example:

Step 2


Enables the channel bonding downgrade for cable modemsin battery backup mode.

cable reduction-mode mta-battery enable

Example:

Step 3

Router(config)# cable reduction-mode mta-batteryenable

(Optional) Configures the dampen time, in seconds, to deferthe cable modems from entering or exiting the channelbonding downgrade 1x1 mode.

cable reduction-mode mta-battery dampen-time seconds

Example:Router(config)# cable reduction-mode mta-batterydampen-time 40

Step 4

(Optional) Configures the init-ranging technique.cable reduction-mode mta-batteryranging-init-technique us-ranging-init-technique

Step 5

Example:Router(config)# cable reduction-mode mta-batteryranging-init-technique 3

(Optional) Configures themaximum and first try percentageof dynamic channel bandwidth in battery backup mode.

cable reduction-mode mta-batterydynamic-channel-percent percent

Step 6

Example: Ensure to leave enough bandwidth for primarychannel so that it can allocate dynamic channelbandwidthwhen it joins a newly created dynamicbonding group.

Note

Router(config)# cable reduction-mode mta-batterydynamic-channel-percent 10

Returns to the privileged EXEC mode.exit

Example:

Step 7



Downgrading Channel Bonding in Battery Backup ModeHow to Configure Downgrading Channel Bonding in Battery Backup Mode

Configuring Channel Bonding Downgrade in Battery Backup Mode for MACDomain

Procedure





Example:

Step 2


Configures a wideband cable interface.interface wideband-cableslot/subslot/port:wideband-channel

Step 3

Example:Router(config)# interface wideband-cable 1/0/0:7

Reserves a resiliency bonding group or WB interface forusage on a line card, on a per controller basis.

cable ds-resiliency

Example:

Step 4

Router(config-if)# cable ds-resiliency


Example:

Step 5


Specifies the cable interface on the router and enters theinterface configuration mode.

interface cable slot/subslot/port

Example:

Step 6


Enables the channel bonding downgrade for cable modemsin battery backup mode for each MAC domain.

cable reduction-mode mta-battery enable

Example:

Step 7

Router(config-if)# cable reduction-modemta-battery enable

Enables the CM-STATUS event 9 for the MAC domain.The value 9 indicates that the cable modem is operatingin battery backup mode.

cable cm-status enable 9

Example:Router(config-if)# cable cm-status enable 9

Step 8

Enables the CM-STATUS event 10 for the MAC domain.The value 10 indicates that the cable modem has returnedto AC power mode.

cable cm-status enable 10

Example:Router(config-if)# cable cm-status enable 10

Step 9


Downgrading Channel Bonding in Battery Backup ModeConfiguring Channel Bonding Downgrade in Battery Backup Mode for MAC Domain


Returns to the privileged EXEC mode.end

Example:

Step 10


Verifying the Configuration for Channel Bonding Downgrade inBattery Backup Mode

• show cable modem—Displays information if the cable modem is running in battery backup mode.

Following is a sample output of the command:Router# show cable modem

DMAC Address IP Address I/F MAC Prim RxPwr Timing NumI

State Sid (dBmv) Offset CPEPf45f.d4a1.b75a --- C6/1/0/UB p-online(pt) 846 !-3.50 1475 0Nc427.9551.3489 30.154.1.12 C6/1/0/UB w-online(pt) 930 -0.50 1579 2Yf45f.d4a1.b762 30.55.223.253 C6/1/0/UB w-online 1770 0.00 1503 0Y0016.925e.661a 30.55.230.136 C6/1/0/U0 online(pt) 825 -0.50 1467 1N4458.2945.458a 30.0.7.72 C6/1/0/UB w-online 3916 0.00 1511 2Y4458.2945.401e --- C6/1/0/UB w-online(pt) 847 -0.50 1473 1N4458.2945.20c6 --- C6/1/0/UB w-online(pt)(bm) 895 0.00 1481 0N

• show cable modem reduction-mode mta-battery—Displays the channel bonding downgrade informationfor cable modems in battery backup mode.

Following is a sample output of the command:Router# show cable modem reduction-mode mta-battery

Orig BG Curr BGI/F MAC Address ID I/F RFs ID I/F Upstream------- -------------- ---------------------------------------------------------C7/0/0 0025.2eaf.843e 897 Wi7/0/0:0 4 252 Wi7/0/0:1 US0C7/0/0 0025.2eaf.8356 897 Wi7/0/0:0 4 252 Wi7/0/0:1 US0C7/0/0 0015.d176.5199 897 Wi7/0/0:0 4 252 Wi7/0/0:1 US0

Following is a sample output of the command for a cable modem when the MAC address is specified:Router# show cable modem 0025.2eaf.843e reduction-mode mta-battery

Orig BG Curr BGI/F MAC Address ID I/F RFs ID I/F Upstream------- -------------- ---------------------------------------------------------


Downgrading Channel Bonding in Battery Backup ModeVerifying the Configuration for Channel Bonding Downgrade in Battery Backup Mode

C7/0/0 0025.2eaf.843e 897 Wi7/0/0:0 4 252 Wi7/0/0:1 US0

Following is a sample output of the command for a cable modem when the IP address is specified:Router# show cable modem 90.18.0.9 reduction-mode mta-battery

Orig BG Curr BGI/F MAC Address ID I/F RFs ID I/F Upstream------- -------------- ---------------------------------------------------------C7/0/0 0025.2eaf.843e 897 Wi7/0/0:0 4 252 Wi7/0/0:1 US0

Following is a sample output of the command for a cable modem when the IPv6 address is specified:Router# show cable modem 2001:18::9 reduction-mode mta-battery

Orig BG Curr BGI/F MAC Address ID I/F RFs ID I/F Upstream------- -------------- ---------------------------------------------------------C7/0/0 0025.2eaf.843e 897 Wi7/0/0:0 4 252 Wi7/0/0:1 US0

• show cable modem verbose—Displays the detailed information for the cable modem.

Following is a sample output of the command:Router# show cable modem 54d4.6ffb.30fd verbose

MAC Address : 54d4.6ffb.30fdIP Address : 40.4.58.14IPv6 Address : 2001:40:4:58:741A:408D:7E4B:D7C8Dual IP : YPrim Sid : 9Host Interface : C7/0/0/UBMD-DS-SG / MD-US-SG : 1 / 1MD-CM-SG : 0x3C0101Primary Wideband Channel ID : 897 (Wi7/0/0:0)Primary Downstream : In7/0/0:2 (RfId : 722)Wideband Capable : YRCP Index : 3RCP ID : 00 10 00 00 08Downstream Channel DCID RF Channel : 99 7/0/0:2Downstream Channel DCID RF Channel : 97 7/0/0:0Downstream Channel DCID RF Channel : 98 7/0/0:1Downstream Channel DCID RF Channel : 100 7/0/0:3Multi-Transmit Channel Mode : YExtended Upstream Transmit Power : 0dBUpstream Channel : US0 US1Ranging Status : sta staUpstream SNR (dB) : 36.12 32.55Upstream Data SNR (dB) : -- --Received Power (dBmV) : 0.00 0.00Reported Transmit Power (dBmV) : 25.25 26.00Peak Transmit Power (dBmV) : 54.00 54.00Phy Max Power (dBmV) : 54.00 54.00Minimum Transmit Power (dBmV) : 24.00 24.00Timing Offset (97.6 ns): 1226 1226Initial Timing Offset : 1229 973Rng Timing Adj Moving Avg(0.381 ns): -1 0Rng Timing Adj Lt Moving Avg : -7 0Rng Timing Adj Minimum : -768 0Rng Timing Adj Maximum : 0 64768Pre-EQ Good : 0 0Pre-EQ Scaled : 0 0Pre-EQ Impulse : 0 0



Pre-EQ Direct Loads : 0 0Good Codewords rx : 515 472Corrected Codewords rx : 0 0Uncorrectable Codewords rx : 0 0Phy Operating Mode : atdma* atdma*sysDescr :Downstream Power : 0.00 dBmV (SNR = ----- dB)MAC Version : DOC3.0QoS Provisioned Mode : DOC1.1Enable DOCSIS2.0 Mode : YModem Status : {Modem= w-online, Security=disabled}Capabilities : {Frag=N, Concat=N, PHS=Y}Security Capabilities : {Priv=, EAE=Y, Key_len=}L2VPN Capabilities : {L2VPN=N, eSAFE=N}Sid/Said Limit : {Max US Sids=16, Max DS Saids=15}Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}Number of CPE IPs : 0(Max CPE IPs = 16)CFG Max-CPE : 200Flaps : 0()Errors : 0 CRCs, 0 HCSesStn Mtn Failures : 0 aborts, 0 exhaustedTotal US Flows : 1(1 active)Total DS Flows : 1(1 active)Total US Data : 7 packets, 2006 bytesTotal US Throughput : 0 bits/sec, 0 packets/secTotal DS Data : 5 packets, 1202 bytesTotal DS Throughput : 0 bits/sec, 0 packets/secLB group ID assigned (index) : 2151416065 (48131)LB group ID in config file (index) : N/A (N/A)LB policy ID : 0LB policy ID in config file : 0LB priority : 0Tag :Required DS Attribute Mask : 0x0Forbidden DS Attribute Mask : 0x0Required US Attribute Mask : 0x0Forbidden US Attribute Mask : 0x0Service Type ID :Service Type ID in config file :Active Classifiers : 2 (Max = NO LIMIT)CM Upstream Filter Group : 0CM Downstream Filter Group : 0CPE Upstream Filter Group : 0CPE Downstream Filter Group : 0DSA/DSX messages : permit allVoice Enabled : NOCM Energy Management Capable : YCM Enable Energy Management : YCM Enter Energy Management : NoBattery Mode : YesBattery Mode Status : BATTERY_MODE / AC_POWER_MODEDS Change Times : 0Boolean Services : 2Number of Multicast DSIDs Support : 16MDF Capability Mode : 2IGMP/MLD Version : MLDv2FCType10 Forwarding Support : YFeatures Bitmask : 0x0Total Time Online : 2h12m (2h12m since last counter reset)CM Initialization Reason : NO_PRIM_SF_USCHANCFG Max IPv6 CPE Prefix : 16 (-1 used)



Battery Mode indicates if the cable modem is in battery backup mode or ACpower mode.

Battery Mode Status indicates the status of the cable modem:

• When the cable modem is in AC_POWER_MODE/BATTERY_MODEstatus, it is in stable state.

• When the cable modem is inAC_POWER_PENDING/BATTERY_PENDING status, it is in transferstate.

• When the cable modem is in AC_POWER_HOLD/BATTERY_HOLDstatus, it is updating status of the last event received until the dampen timeexpires.

Note

• show cable modem cm-status—Displays the cable modem CM-STATUS event information.

Following is a sample output of the command:Router# show cable modem e448.c70c.9d80 cm-status

I/F MAC Address Event TID Count Error Dups TimeC6/0/3/UB e448.c70c.9d80 Battery backup 14 1 0 0 Apr 2 22:17:29

e448.c70c.9d80 A/C power 1 1 0 0 Apr 2 22:43:52



Cisco CMTSCable Command ReferenceCMTScommands

Standards and RFCs

TitleStandard/RFC

Data-Over-Cable Service Interface Specifications, DOCSIS 3.1, MACand Upper Layer Protocols Interface Specification

CM-SP-MULPIv3.1-I01-131029


Downgrading Channel Bonding in Battery Backup ModeAdditional References

http://rtp-aspw-ccms1.cisco.com/astoria/_id_00000013UK1E10YZ_CISCO!radhraja


LinkDescription




Feature Information for Downgrading Channel Bonding inBattery Backup Mode



Note

Table 60: Feature Information for Downgrading Channel Bonding in Battery Backup Mode


This feature was introduced in the Cisco IOS XEEverest 16.6.1 on the Cisco cBR Series ConvergedBroadband Routers.

Cisco IOS XE Everest16.6.1

Battery Backup 1x1Mode


Downgrading Channel Bonding in Battery Backup ModeFeature Information for Downgrading Channel Bonding in Battery Backup Mode



C H A P T E R 18Upstream Bonding Support for D-PON

The DOCSIS Passive Optical Network (D-PON) architecture, also known as RF over Glass (RFoG), helpsthe cable operators enter fiber-to-home market space and utilize the DOCSIS infrastructure effectively.

• Hardware Compatibility Matrix for the Cisco cBR Series Routers, on page 337• Prerequisites for Upstream Bonding Support for D-PON, on page 338• Restrictions for Upstream Bonding Support for D-PON, on page 339• Information About Upstream Bonding Support for D-PON, on page 339• How to Configure Upstream Bonding Support for D-PON , on page 341• Verifying the Upstream Bonding Support for D-PON, on page 342• Additional References, on page 342• Feature Information for Upstream Bonding Support for D-PON, on page 343



Note














Digital PICs:


•













Prerequisites for Upstream Bonding Support for D-PON• DOCSIS 3.0 cable modems (CMs)• DOCSIS 2.0 capable set-top boxes (STBs)• You should configure the cable upstream ranging-init-technique 2 command to prevent the use ofadditional broadcast initial ranging opportunities for the non D-PON reference upstream channels.


Upstream Bonding Support for D-PONPrerequisites for Upstream Bonding Support for D-PON

Restrictions for Upstream Bonding Support for D-PON• Multiple CMs cannot work at the same time. Each CM must get a separate time slot for upstream datatransmission. Configuring D-PON ensures that the upstream scheduler allows only a single CM to transmitat a particular time.

• Cisco cBR-8 does not support Upstream Bonding for D-PON on Remote-PHY.

• It is possible to enable or disable D-PON for individual Mac domain.

• When you enable D-PON on aMAC domain, youmust manually shut down and enable theMAC domainusing shutdown and no shutdown command.

• When enablingD-PON on aMACdomain, the D-PON is not supportedwith upstream balance-scheduling.Remove the upstream balance scheduling using the following command:no cable upstream balance-scheduling

• All frequencies in a MAC domain must have the same configuration for:

• minislot size

• channel-width

• modulation profile

• Supports only ATDMA DOCSIS mode.

• The following features are not supported in MAC domains configured for D-PON:

• Load balancing

• Spectrum management

• Upstream configuration (to change upstream configuration, you should shut down theMAC domain)

• S-CDMA logical channels

• Lower modulations profiles (D-PON uses only 16 QAM and 64 QAM modulation profiles)

• Channel-width other than 3.2 MHz and 6.4 MHz

• In-service Software Upgrade (ISSU)

• Mixing of D-PON and HFC on the same MAC domain

• Software licensing

Information About Upstream Bonding Support for D-POND-PON is a type of networking that allows the CMTS to transmit RF signals over the optical network. Thistechnology enables the cable operators to use the RF technologies in a Hybrid Fiber-Coaxial (HFC) network.

The downstream data from the CMTS is combined with other RF signals at the hub and is sent to the transmitter.The signal from the transmitter is intended for multiple PONs. Each PON serves 32 homes from a single fiber.


Upstream Bonding Support for D-PONRestrictions for Upstream Bonding Support for D-PON

The upstream data from the Optical Network Terminal (ONT) is combined at the splitter and sent to the hub,which is then routed to the optical receiver (RX). Upstream data frommultiple optical receivers are combinedand sent to the CMTS.

The upstream data to the CMTS contains signals from multiple PONs. Each upstream optical receiver isdedicated to a PON that can have multiple DOCSIS upstream sources (multiple modems and DSG terminals).

A PON can be configured in different ways, depending on the coaxial network. These configurations broadlyfall under the following categories:

• Internal Control Configuration—In this configuration, the internal CM of the ONT controls the laser.Upstream signals go to the Ethernet interface of the CM allowing the ONT to control upstream timing.The device that uses this type of configuration is the Digital Audio Visual Council (DAVIC) set topterminal (STT).

• External Control Configuration—In this configuration, the presence of the RF at the ONT upstream inputactivates the laser. The device that uses this type of configuration is the DOCSIS Set-top Gateway (DSG)device.

• Dual Control Configuration—In this configuration, the home that contains an ONT with and internalCM and other DOCSIS upstream sources, like DSG devices. The RF presence detector or the internalCM control line detects the upstream signal and activates the upstream laser.

D-PON on Upstream SchedulingIn D-PON implementation, the native upstream scheduling software of the CMTS controls the timing of theupstream data transmission. Only one PON Receiver Domain (PRD) is allowed to transmit upstream data atany given point of time, irrespective of the upstream frequency allocation. The reason for this is that two lasersfrom the ONT of a PRD cannot work simultaneously as it leads to anOptical Beat Interference (OBI).Moreover,the use of a frequency modulation (FM) for and upstream signal transmission results in PHY errors whenmultiple ONTs within a PON transmits simultaneously.

Initial maintenance regions are scheduled on all upstream channels to prevent the DOCSIS 3.0 CMs in aD-PON environment from failing initial ranging on any upstream channel. When a ranging request is receivedwithin a MAC domain configured for D-PON, the CM receives an upstream channel override to the D-PONreference channel (US0).

In this implementation of D-PON, a DOCSIS device within a PRD is given a timeslot to transmit the upstreamdata, irrespective of the upstream frequency. Therefore, there is no benefit in having more than one upstreamin a MAC domain without using the upstream channel bonding feature.

The D-PON feature supports the following service types:

• Best effort (BE) 3.0 using up to four frequencies concurrently• BE 2.0 using only a single frequency• Unsolicited grant service (UGS) using only a single frequency• Real-time polling service (RTPS) using only a single frequency• Non-real-time polling service (nRTPS) using only a single frequency


Upstream Bonding Support for D-POND-PON on Upstream Scheduling

How to Configure Upstream Bonding Support for D-PONThis section describes how to enable D-PON for a MAC domain on the Cisco cBR router. The bonding groupmust include a reference channel which is default to the upstream channel 0.

The USCB can support a maximum of 4 US channels in a RFOGMAC domain in the following combination:

• US0

• US0, US1

• US0, US1, US2

• US0, US1, US2, US3

All US channels must be configured to have the same number of minislots, channel width (only 3.2 and 6.4MHz supported), DOCSIS mode (only ATDMA supported) and modulation profile.

Note

When enabling DPON on a MAC Domain, remove the command "cable upstream balance-scheduling? asDPON is not supported with upstream balance-scheduling.

Procedure



enable

Example:

Step 1

Router> enable


Example:

Step 2


Enters interface configuration mode for the specified cableinterface.

interface cable slot/subslot/cable-interface-index

Example:

Step 3


Enables D-PON for a MAC domain.cable upstream dpon

Example:

Step 4

Router(config-if)# cable upstream dpon

Shuts down the interface.shutdown

Example:

Step 5

Router(config-if)# shutdown

Enables the interface.no shutdown

Example:

Step 6


Upstream Bonding Support for D-PONHow to Configure Upstream Bonding Support for D-PON

PurposeCommand or ActionRouter(config-if)# no shutdown

Exits interface configuration mode and returns to theprivileged EXEC mode.

end

Example:

Step 7


Verifying the Upstream Bonding Support for D-PONTo verify the upstream scheduler output for a MAC domain configured with D-PON, use the show interfacecable mac-scheduler command.

The D-PON reference channel US0 (US channel-id 1) MAP serves as a template for producing other MAPswithin the MAC domain. Therefore, some of the statistics related to upstream scheduling is not relevant forother channels, except for the D-PON reference channel.

Note

Router# show interface cable 8/0/0 mac-scheduler 1DOCSIS 1.1 MAC scheduler for Cable8/0/0/U1 : rate 30720000wfq:Noneus_balance:OFFdpon_mode:ONfairness:OFFQueue[Rng Polls] flows 0Queue[CIR Grants] flows 0Queue[BE(07) Grants] flows 0Queue[BE(06) Grants] flows 0Queue[BE(05) Grants] flows 0Queue[BE(04) Grants] flows 0Queue[BE(03) Grants] flows 0Queue[BE(02) Grants] flows 0Queue[BE(01) Grants] flows 0Queue[BE(00) Grants] flows 0Req Slots 1824595508, Req/Data Slots 10640906Init Mtn Slots 89924653, Stn Mtn Slots 989543Short Grant Slots 0, Long Grant Slots 0Adv Phy Short Grant Slots 538, Adv Phy Long Grant Slots 219831Adv Phy UGS Grant Slots 0Avg upstream channel utilization : 0%Avg percent contention slots : 98%Avg percent initial ranging slots : 1%Avg percent minislots lost on late MAPs : 0%MAP TSS: lch_state 9, init_retries 0late_initial_maps 0, late_ucd_maps 0mac-phy tss errors 0, missed ccc 0

Additional ReferencesThe following sections provide references related to the Upstream Bonding Support for D-PON feature.


Upstream Bonding Support for D-PONVerifying the Upstream Bonding Support for D-PON

Related Documents


Cisco IOS Master Command List, All ReleasesCisco IOS commands

Cisco Prisma D-PONPrisma D-PON


LinkDescription




Feature Information for Upstream Bonding Support for D-PONUse Cisco Feature Navigator to find information about the platform support and software image support.Cisco Feature Navigator enables you to determine which software images support a specific software release,feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An accounton the Cisco.com page is not required.


Note

Table 62: Feature Information for Upstream Bonding Support for D-PON




Upstream Bonding Support forD-PON


Upstream Bonding Support for D-PONFeature Information for Upstream Bonding Support for D-PON

https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/mcl/allreleasemcl/all-book.html

http://www.cisco.com/en/US/products/ps10444/index.html




Upstream Bonding Support for D-PONFeature Information for Upstream Bonding Support for D-PON

C H A P T E R 19Energy Management Mode

Data-over-Cable Service Interface Specifications (DOCSIS) cable modems (CM) and CMTS support a lowpower energy mode referred to as the Energy Management 1x1 (EM) mode. During idle times, when the datarate demand of a user is met by the available capacity on a single upstream and downstream channel pair towhich it is assigned, the CM switches to the Energy Management 1x1 mode. When the CM requires a higherdata rate than that can be reliably provided on the single channel pair, the CMTS instructs the CM to returnto the larger transmit and receive channel set.

Contents

• Information About Energy Management Mode, on page 345• Prerequisites for Energy Management Mode, on page 349• Restrictions for the Energy Management Mode, on page 349• How to Configure the Energy Management Mode, on page 352• Verifying the Energy Management Mode, on page 353• Feature Information for Energy Management Mode, on page 356

Information About Energy Management ModeThe following sections provide more information about the Energy Management mode.

Dynamic Downstream Bonding GroupTo support the Energy Management 1x1 (EM) mode feature, CMTS selects an upstream and a downstreamchannel pair for CM. The downstream and upstream channel assigned to the CMs should be available. IfCMTS selects a channel that is not available, the downstream bonding channel might fail.

To simplify the process, CMTS chooses the 1x1 bonding group for the CM according to the following rules:

• For upstream, it chooses the highest actual amiable bandwidth channel from the upstream channelscurrently used by the CM.

• For downstream, CMTS chooses the current primary downstream channel used by the CM.

• If the CM is online with channel bonding 1xN or Nx1, and requests to enter into the EM mode, CMTSdoes not change the upstream and the downstream channel if the original channel bonding is 1 and theQuality of Service (QoS) parameter is not updated.


• CMTS checks the existing dynamic bonding groups (DBG), for an exact match in the target channel.

• If found, CMTS uses this bonding group to instruct the CM to enter into EM mode.

• If there is no available DBG and there is an unused DBG, CMTS adds the primary channel into theunused DBG and instructs the CM to enter the EM mode.

• If there is no available DBG and no unused DBG, CMTS logs a warning to notify you that a newDGB should be configured.

Flow Chart of the CM Power StateThe following figure shows the flow chart of the CM power state:


Energy Management ModeFlow Chart of the CM Power State

Figure 4: Flow Chart for the Power State of the Cable Modem

Interaction with the Battery ModeEnergy management mode is similar to battery mode as they both enter the 1x1 mode to save power. But,both have a different purpose to enter the 1x1 mode, so there are some differences in their behavior. Thepurpose of EM mode is to save power when the traffic is low, and it has minimum impact on the normalservice. The purpose of the battery mode is try to guarantee the voice service, especially the 911 call service,for which it may drop other services, if necessary.

The table below describes the behavior difference between energy management mode and battery mode.


Energy Management ModeInteraction with the Battery Mode

Battery Mode (BM)Energy Management (EM) Mode

No minimum reserved rate.Minimum reserved rate service upto 200k.

QoS

• If the CM has joined IGMPgroups and CMTS receives aCM-STATUS event with code9, CMTS lets the CM leavethe IGMP group.

• If the CM is in the BM, CMTSrejects the IGMP join requestfrom the CM.

• IGMP request is guaranteed.

• If the CM has joined theInternet Group ManagementProtocol (IGMP) groups,CMTS rejects the EM requestto enter the EM mode andkeeps the CM in the IGMPgroups.

• If the CM is in the EM modeand IGMP join request isreceived, CMTS instructs theCM to leave the EM mode.

Multicast

BM has higher priority than the EMmode. If a CM is already in EMmode and a power off occurs, CM entersinto the BM. After the power is restored, the CM returns to the normal mode, and if the traffic is lower thanthe threshold, it re-enters the EM mode. The CM does not directly transfer from the BM to the EM mode.

The interaction between the battery mode and the energy management mode is illustrated in the figure below:

Figure 5: Interaction Between the BM and the EM Modes

1. When the CM is in normal mode and CMTS receives a request to enter the EM mode, CMTS instructsthe CM to enter the EM mode with downstream bonding channel (DBC).

2. When the CM is in EM mode and CMTS receives a request to leave the EM mode, CMTS instructs theCM to leave the EM mode to normal mode with DBC.

3. When the CM is in normal mode and CMTS receives a message: CM operating on battery backup, CMTSinstructs the CM to enter the BM mode with DBC.

4. When the CM is in BMmode and CMTS receives a message: CM operating on AC power, CMTS instructsthe CM to leave the BM mode to normal mode with DBC.


Energy Management ModeInteraction with the Battery Mode

5. When the CM is in EM mode and CMTS receives a message: CM operating on battery backup, CMTSinstructs the CM to enter the BM mode with service flow re-admin.

6. When the CM is in BM mode and CMTS receives a request to enter EM mode, CMTS waits until itreceives the message: CM operating on AC power. It then instructs the CM to return to normal mode.

Handling Energy Management Request LoadWhenmany CMs send EM requests at the same time, such as at the beginning or end of work hours, the trafficsoars or slumps in a very short period and causes heavy load for CMTS. A throttle mechanism is adopted toavoid such load surge for CMTS.

The line card EM process defines a variable that indicates the current transactions handled by the process.When an energy management request is received and the maximum number of transactions is not met, CMTShandles this request and updates the counter of current transactions.When themaximum number of transactionsis met, CMTS sends a temporary reject response. After a transaction is over or a CM goes offline, the counterof current transactions is updated.

Supervisor High Availability and Line Card SwitchoverEnergy Management feature supports supervisor high availability and line card switchover with limitations.

The active supervisor or line card syncs the EMmode data of a CM to the standby SUP or protected line cardwhen the CM enters a stable EM status. When a CM enters or leaves the EM mode with an ongoing DBCprocess, the supervisor high availability or line card switchover causes the CM to enter into an offline oronline status.

Prerequisites for Energy Management ModeTo enable the energy management mode, you must configure resiliency bonding group (RBG) and dynamicbonding group.

Restrictions for the Energy Management Mode

Restrictions for CMTS High Availability• If there is no DBG available, CMTS cannot create a newDBG on the protected line card and CMs cannotenter the EM mode.

• Line card switchover is not supported when the CM enters the EM mode from the normal mode or exitsthe EM mode to the normal mode.

• To reduce the operation of the EM mode, the information about the EM status is not synced with theprotected line card. Hence, the EM status is cleared after the line card high availability.


Energy Management ModeHandling Energy Management Request Load

Restrictions for Dynamic Bonding GroupTo support the EM feature, CMTS configures separate DBG for each primary channel in each MAC domain.For example, if a MAC domain has eight primary channels, it will create eight DBGs for the MAC domain.This ensures that the EM does not fail due to lack of DBGs.

Restrictions for Interaction of CMTS with Other FeaturesThe following sections describe the restrictions for CMTS interaction with other features.

VoiceIf a voice call is in progress, CMTS does not instruct the CM to enter into the EM mode.

When the CM is in the EM mode, and it receives a voice call, it adds a dynamic Unsolicited Grant Service(UGS) or Unsolicited Grant Service with activity detection (UGS-AD) service flow. During the voice call,the CM does not exit from the EM mode irrespective of the flow of traffic. Voice service is given the highestpriority

Dynamic Bonding Change and Dynamic Channel Change and Related ApplicationsIn D2.0 and D3.0 load-balance (static and dynamic), CM is not moved by load-balance when it is in EMmode.

For RF-adapt, CM is not relocated to an alternate logical channel by the RF-adapt when it is in EM mode.

Multicast• When the CM is in a multicast group, CMTS would reject the EM request for both bonded and nonbonded multicast cases.

• When the CM is in EM state and a multicast join request is received, CMTS discards this join requestand forces the CM to exit the EM mode.

• When the CM is in EM state and a voice call is in progress, and a new multicast join request is received,CMTS discards this join request and does not force the CM to exit the EM mode since the voice call isin progress.

• There is a threshold for currently handled transactions. When there is multicast join request and themaximum transaction threshold has been reached, CMTS cannot instruct the CM to exit the EM mode.The multicast join is also be denied until the CM can exit the EM mode.

• When the CM is in EMmode and needs to join PacketCable Multimedia (PCMM) multicast, you shouldsend a GateSet request twice, so that the gate can be setup successfully. The first GateSet request onlyforces the modem to exit the EM mode, but does not set up the gate

Committed Information RateIf the QoS is defined by the Minimum Reserved Rate service flow QoS parameter in excess of 200 kbps,when the CM enters into the EM mode, CMTS only provides 200 kbps as the minimum reserved rate. If theminimum reserved rates is less than 200 kbps, CMTS schedules the minimum reserved rate according to theservice flow configuration when the CM enters into the EM mode.

CMTS records the Minimum Reserved Rate service flow QoS parameter when the CM enters into the EMmode. When the CM exits the EM mode, CMTS uses the original parameter.


Energy Management ModeRestrictions for Dynamic Bonding Group

When the CM enters the EMmode, it selects one of the CM upstream channels. If the service flow is completelyon that upstream channel, the service flow parameter is not changed. This behavior is because the serviceflow is not moved into the DBC operation, and the change of the service flow parameter has no benefit

Admission ControlWhen a request is received to exit the EM mode and recovery to the original wideband interface is restricteddue to an admission control failure, CMTS forces the CM to go offline and re-register to prevent it fromgetting stuck in the EM mode. In such a case, CMTS logs a warning message.

Battery ModeWhen CMTS receives the status of the CM as operating on battery power, CMTS instructs the CM to enterinto the BM. If the CM rejects the instruction received, CMTS keeps the modem in normal status.

When the CM is in BM and CMTS receives the status of the CM as operating on A/C power, CMTS instructsthe CM to exit the BM. If the CM rejects the instruction received, CMTS forces the CM to go offline to preventit from getting stuck in the battery mode. In such a case, CMTS logs a warning message.

Attribute MaskWhen selecting an upstream or a downstream channel pair for energy management mode, CMTS selectschannels that meet the requirements of the attribute masks for the existing service flows for the correspondingCM.

In some cases, adherence to the service flow attribute-based assignment may not be possible when selectingan upstream and downstream channel pair for energy management mode of operation. To resolve this conflict,CMTS supports one or both of the following approaches:

1. CMTS may require strict adherence to the required and forbidden attribute masks and thus deny entryinto the EM mode if these masks cannot be met by the available individual channels in the MD-CM-SG.

2. CMTS may allow the CM to enter the EMmode while not meeting all the criteria for the attribute masks.In this case, CMTS logs a warning event notifying that the attribute masks are not maintained.

For the following case, CMTS supports approach two:

When the CM is instructed to enter into the EM mode and the selected target upstream and downstreamchannels do not adhere to the service flow attribute mask. For this conflict CMTS instructs the modem toenter into the EM mode. CMTS also logs a warning message to notify this conflict.

Dynamic Service AdditionWhen the CM is in EM mode, DSA request can still be set up even if the requested attributes can not be metwith a single channel. In order to not effect voice services, the CM is not forced to exit the EM mode.

Restrictions for Configuration Change and Interface Shutdown1. Shutdown of the upstream channel—Shutdown of the upstream channel recalculates theMD-US-SG-ID

and assigns a new MD-US-SG-ID. In this case, the CM is not offline and internal data structure of theCM instance is not updated. DBC operation checks the MD-US-SG-ID, so when the CM enters into theEMmode there is a mismatch between theMD-US-SD-ID on the CM and the newMD-US-SG-ID. Hence,DBC fails and the CM cannot get into the EM mode.


Energy Management ModeAdmission Control

2. Change in Upstream Service Group makes the CM in EM mode go offline—TheUS-SG configurationchange blocks the DBC behavior and the CM gets stuck in the EM mode. To avoid this scenario, whenthere is a change in the Upstream Service Group (US-SG), such as shutdown or no shutdown of theupstream channels, CMTS makes the CM go offline. The CM should re-register as a normal CM with thewideband channel bonding including multiple channels.

3. Modify the original wideband interface—When the CM is in EMmode, change in the original widebandinterface channels on the CM makes the CM go offline and re-register as a normal CM.

4. Disable or enable feature—When you disable this feature, CMTS does not force CMs to exit from theEMmode unless CMs sends a request. CMTS does not accept EM requests after the EM feature is disabledfrom the CLI.

How to Configure the Energy Management ModeThis section describes how to configure the energy management feature on the Cisco cBR-8.

Contents

Enabling Energy Management ModeTo enable the energy management mode, complete the following procedure:

configure terminalcable reduction-mode energy-management enable

Verifying the Energy Management Mode

• To verify if the CM is in EMmode, use the show cable modem command. If the cable modem is workingin energy management mode, the MAC state is displayed with an "em" flag.

show cable modem

DMAC Address IP Address I/F MAC Prim RxPwrTiming Num I

StateSid (dBmv) Offset CPE P

7cb2.1b0f.ea72 40.4.58.4 C7/0/0/UB w-online(em) 2 0.001231 1 Y

54d4.6ffb.2f6b 40.4.58.24 C7/0/0/UB w-online 3 -0.501241 0 Y

0025.2ed9.9a22 40.4.58.3 C7/0/0/UB w-online 4 0.501240 0 Y

• To verify which CM is in EM mode and to get the original wideband and upstream channel information,use the show cable modem reduction-mode energy-management-mode command.

show cable modem reduction-mode energy-management-mode

Orig BG Orig US Curr BGI/F MAC Address ID I/F bitmap RFs ID I/FUpstream------- -------------- ---------------- -------- -----------------------------------------C7/0/0 0025.2eaf.843e 897 Wi7/0/0:0 0x3B 4 252 Wi7/0/0:1 US0


Energy Management ModeHow to Configure the Energy Management Mode

C7/0/0 0025.2eaf.8356 897 Wi7/0/0:0 0x3B 4 252 Wi7/0/0:1 US0

C7/0/0 0015.d176.5199 897 Wi7/0/0:0 0x3B 4 252 Wi7/0/0:1 US0

Enabling Energy Management Mode per MAC DomainCMTS supports the EM feature when enabled both globally and perMAC domain. Use the following procedureto enable energy management feature per MAC domain.

To enable the EM mode per MAC domain, complete the following procedure:

configure terminalinterface cable slot/subslot/cable-interface-index

cable reduction-mode energy-management enable

Configuring Initialization Ranging Technique in Dynamic Bonding ChannelThe default value for the technique in init-ranging is set to 1 and the valid range is 1-4.

To configure the technique in init-ranging, complete the following procedure:

configure terminalcable reduction-mode energy-management ranging-init-techniquevalue

Configuring the Percentage for the Dynamic Channel BandwidthMake sure that you leave enough bandwith for the primary channel so that it can allocate dynamic channelbandwidth when it joins to a newly created DBG. The default percentage value is set to 5 and the valid rangeis 1-96.

To configure the percentage of dynamic channel bandwidth, complete the following procedure:

configure terminalcable reduction-mode energy-management dynamic-channel-percent value

Configuring the Queue Size for Energy ManagementThe default value for the queue size is set to 150 and the valid range is 50-10000.

To set the queue size of the energy management requests, complete the following procedure:

configure terminalcable reduction-mode energy-management process-queue-size value

-

Verifying the Energy Management ModeThis section describes how to verify the EM mode.


Energy Management ModeEnabling Energy Management Mode per MAC Domain

Contents

Viewing the Basic Statistics for Energy Management Receive RequestTo view the basic statistics for all energy management receive request events for a specific CM, use the showcable modem <cable if | mac_addr | ip_addr> reduction-mode energy-management-status command.

show cable modem c8/0/0 reduction-mode energy-management-status

I/F MAC Address Event TID Count Error Dups TimeC8/0/0 54d4.6ffb.2e21 Enter EM mode 1 1 0 1 Jul 16 21:38:18

Exit EM mode 1 1 0 0 Jul 16 21:38:39C8/0/0 602a.d07c.4ec6 Enter EM mode 1 1 0 0 Jul 16 21:40:57

Exit EM mode 1 1 0 0 Jul 16 21:41:17

To clear the basic receive statistics for all EM_REQ events for a specified CM, use the clear cable modem<cable if | mac_addr | ip_addr> em-status command.

Verifying the Configuration ParametersTo verify the configuration parameters used in the CM configuration file, use the show cable modem <macaddress> reduction-mode energy-management-param command.

show cable modem 54d4.6ffb.2e21 reduction-mode energy-management-param

Energy Management feature enable : YDS entry bitrate threshold(bps) : 100000DS entry time threshold(s) : 120DS exit bitrate threshold(bps) : 200000DS exit time threshold(s) : 2US entry bitrate threshold(bps) : 100000US entry time threshold(s) : 120US exit bitrate threshold(bps) : 200000US exit time threshold(s) : 2cycle period(s) : 300

Viewing Information Regarding a Cable ModemTo view all the information regarding a CM, use the show cable modem mac address verbose command.

show cable modem 54d4.6ffb.30fd verbose

MAC Address : 54d4.6ffb.30fdIP Address : 40.4.58.14IPv6 Address : 2001:40:4:58:741A:408D:7E4B:D7C8Dual IP : YPrim Sid : 9Host Interface : C7/0/0/UBMD-DS-SG / MD-US-SG : 1 / 1MD-CM-SG : 0x3C0101Primary Wideband Channel ID : 897 (Wi7/0/0:0)Primary Downstream : In7/0/0:2 (RfId : 722)Wideband Capable : YRCP Index : 3RCP ID : 00 10 00 00 08Downstream Channel DCID RF Channel : 99 7/0/0:2Downstream Channel DCID RF Channel : 97 7/0/0:0


Energy Management ModeViewing the Basic Statistics for Energy Management Receive Request

Downstream Channel DCID RF Channel : 98 7/0/0:1Downstream Channel DCID RF Channel : 100 7/0/0:3Multi-Transmit Channel Mode : YExtended Upstream Transmit Power : 0dBUpstream Channel : US0 US1Ranging Status : sta staUpstream SNR (dB) : 36.12 32.55Upstream Data SNR (dB) : -- --Received Power (dBmV) : 0.00 0.00Reported Transmit Power (dBmV) : 25.25 26.00Peak Transmit Power (dBmV) : 54.00 54.00Phy Max Power (dBmV) : 54.00 54.00Minimum Transmit Power (dBmV) : 24.00 24.00Timing Offset (97.6 ns): 1226 1226Initial Timing Offset : 1229 973Rng Timing Adj Moving Avg(0.381 ns): -1 0Rng Timing Adj Lt Moving Avg : -7 0Rng Timing Adj Minimum : -768 0Rng Timing Adj Maximum : 0 64768Pre-EQ Good : 0 0Pre-EQ Scaled : 0 0Pre-EQ Impulse : 0 0Pre-EQ Direct Loads : 0 0Good Codewords rx : 515 472Corrected Codewords rx : 0 0Uncorrectable Codewords rx : 0 0Phy Operating Mode : atdma* atdma*sysDescr :Downstream Power : 0.00 dBmV (SNR = ----- dB)MAC Version : DOC3.0QoS Provisioned Mode : DOC1.1Enable DOCSIS2.0 Mode : YModem Status : {Modem= w-online(em), Security=disabled}Capabilities : {Frag=N, Concat=N, PHS=Y}Security Capabilities : {Priv=, EAE=Y, Key_len=}L2VPN Capabilities : {L2VPN=N, eSAFE=N}Sid/Said Limit : {Max US Sids=16, Max DS Saids=15}Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}Number of CPE IPs : 0(Max CPE IPs = 16)CFG Max-CPE : 200Flaps : 0()Errors : 0 CRCs, 0 HCSesStn Mtn Failures : 0 aborts, 0 exhaustedTotal US Flows : 1(1 active)Total DS Flows : 1(1 active)Total US Data : 7 packets, 2006 bytesTotal US Throughput : 0 bits/sec, 0 packets/secTotal DS Data : 5 packets, 1202 bytesTotal DS Throughput : 0 bits/sec, 0 packets/secLB group ID assigned (index) : 2151416065 (48131)LB group ID in config file (index) : N/A (N/A)LB policy ID : 0LB policy ID in config file : 0LB priority : 0Tag :Required DS Attribute Mask : 0x0Forbidden DS Attribute Mask : 0x0Required US Attribute Mask : 0x0Forbidden US Attribute Mask : 0x0Service Type ID :Service Type ID in config file :Active Classifiers : 2 (Max = NO LIMIT)CM Upstream Filter Group : 0


Energy Management ModeViewing Information Regarding a Cable Modem

CM Downstream Filter Group : 0CPE Upstream Filter Group : 0CPE Downstream Filter Group : 0DSA/DSX messages : permit allVoice Enabled : NODS Change Times : 0Boolean Services : 2CM Energy Management Capable : YCM Enable Energy Management : YCM Enter Energy Management : YESNumber of Multicast DSIDs Support : 16MDF Capability Mode : 2IGMP/MLD Version : MLDv2FCType10 Forwarding Support : YFeatures Bitmask : 0x0Total Time Online : 2h12m (2h12m since last counter reset)CM Initialization Reason : NO_PRIM_SF_USCHANCFG Max IPv6 CPE Prefix : 16 (-1 used)

Feature Information for Energy Management ModeUse Cisco Feature Navigator to find information about the platform support and software image support.Cisco Feature Navigator enables you to determine which software images support a specific software release,feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An accounton the Cisco.com page is not required.


Note

Table 63: Feature Information for Downgrading Channel Bonding in Battery Backup Mode


This feature was integrated on the Cisco cBR SeriesConverged Broadband Routers.


EnergyManagementMode


Energy Management ModeFeature Information for Energy Management Mode


C H A P T E R 20Cable Modem Steering

The cable modem steering feature helps to redirect or steer cable modems to multiple CMTS routers. Aconfigurable string is used to bond the cable modem to the proper CMTS. Once the bonding is done, theCMTS can move the cable modem within itself for load balancing.

• Cable Modem Steering on the Cisco cBR Series Converged Broadband Routers, on page 357• Prerequisites for Cable Modem Steering, on page 358• Restrictions for Cable Modem Steering, on page 358• Information About Cable Modem Steering, on page 358• How to Configure Cable Modem Steering on the CMTS Router, on page 360• Verifying and Troubleshooting Cable Modem Steering, on page 362• Additional References, on page 364• Feature Information for Cable Modem Steering, on page 365

Cable Modem Steering on the Cisco cBR Series ConvergedBroadband Routers

First Published: July 13, 2016

The cable modem steering feature helps to redirect or steer cable modems to multiple CMTS routers. Aconfigurable string is used to bond the cable modem to the proper CMTS. Once the bonding is done, theCMTS can move the cable modem within itself for load balancing.






Contents

Prerequisites for Cable Modem SteeringDOCSIS 3.0-defined type, length, values (TLVs) are required to aid channel selection. All TLVs encoded asgeneral extension information in cable modem configuration files are backward compatible with DOCSIS1.1 and DOCSIS 2.0 cable modems.

The hardware components introduced in a given Cisco IOS Release are supported in all subsequent releasesunless otherwise specified.

Note

Restrictions for Cable Modem SteeringThe Cable Modem Steering feature has the following general restrictions:

• To restrict the cable modem on the exact downstream on the target CMTS, the redirection must beconfigured on the target CMTS.

• You must manually execute the clear cable modem service-type command to clear the cable modemservice type identifier stored at the CMTS during registration.

• Youmust manually execute the clear cable modem attribute-masks command to clear the cable modemattribute masks stored at the CMTS during registration. These attribute masks are used to restrict usageof upstream channels during ranging time.

• Cable modem steering supports only upstream masks.• Channel steering does not take place when the cable modem fails in initial ranging.• The cable modem will take more time to come online when channel steering is deployed. The time takenis proportional to the number of modems, and the downstreams and upstreams that the cable modem canreach.

• A modem cannot be load balanced to any upstream channel with attributes that conflict with attributemasks of the modem.

• Do not configure to use UCC in DOCSIS LBG.

Information About Cable Modem SteeringCable modem steering allows you to redirect or steer the cable modems to one or more CMTS routers usingdownstream frequency overrides. Once a cable modem registers on a downstream on the proper CMTS router,the CMTS router can move the cable modem to any location for load balancing.

The DOCSIS 3.0-compliant Service Type Identifier used as the configurable string in the cable modemconfiguration file is backward-compatible with DOCSIS 1.1 and DOCSIS 2.0 cable modems.

The CMTS router can also impose restrictions on the number of channels a cable modem can use. DOCSIS3.0 defines several TLVs to aid the channel selection.

The following TLVs are used in cable modem steering:


Cable Modem SteeringPrerequisites for Cable Modem Steering

• TLV 43.9 (Cable Modem Attribute Masks) limits the set of channels the CMTS router can assign to thecable modem by allowing or forbidding certain binary attributes. The cable modem attribute masks havefour sub-TLVs and cable modem steering makes use of two sub-TLVs, which are listed below:

• TLV 43.9.3—Cable Modem Upstream Required Attribute Mask (C.1.1.18.1.8.3 ofCM-SP-MULPIv3.0-I07-080215). It is a 32-bit mask representing the set of binary upstream channelattributes required for the cable modem.

• TLV 43.9.4—Cable Modem Upstream Forbidden Attribute Mask (C.1.1.18.1.8.4 ofCM-SP-MULPIv3.0-I07-080215). It is a 32-bit mask representing the set of binary upstream channelattributes forbidden for the cable modem.

• TLV 43.11 is used for a redirection action based on the service type identifier field. The cable modemsends the TLV 43.11 in the REG-REQ MAC message. The DOCSIS 1.1 and DOCSIS 2.0 modems willalso send this file ID when doing the registration.

• TLV43.1, defined as Policy ID in DOCSIS 2.0 and DOCSIS 3.0, is parsed and stored in the cable modemduring registration. Before moving the cable modem during load balancing (LB), the CMTS router checkswhether the cable modem has a preconfigured policy with the same Policy ID. If the policy does exist,the CMTS router disables LB for this cable modem and moves to the next cable modem. If the policydoes not exist on the CMTS router, or the Policy ID is missing from the cable modem configuration file,LB prohibition is not performed.

The following TLVs are supported in cable modem steering:

• TLV 43.11 (Service type identifier) from section C.1.1.18.1.10 in CM-SP-MULPIv3.0-I07-080215.• Cable modem attribute masks (TLV 43.9) from C.1.1.18.1.8.3 and C.1.1.18.1.8.4 ofCM-SP-MULPIv3.0-I07-080215.

• TLV portion (43.1, Policy ID) of REQ-REQ• TLV 18--- Ranging Hold-off Priority Field• TLV 19---Channel Class ID

Upstream Channel Descriptor TLV for Ranging Hold-offThe Upstream Channel Descriptor (UCD) TLV for Ranging Hold-off feature, enables the Cisco cBR SeriesConverged Broadband router to hold off a cable modem from initial ranging based on TLV 18 and 19 specifiedin the upstream channel descriptor (UCD) messages. The router can hold off a cable modem from initialranging only for 5 minutes. This default value cannot be changed. This feature is supported with DOCSIS 2.0and later releases cable modems using upstream logical channels.

Ranging Class IDThe CMTS enables UCDTLV for ranging hold-off after detecting the TLVs from the cable modem registrationrequest (REG-REQ) or multipart registration request (REG-REQ-MP), and saves these TLVs as a cablemodem ranging class ID.

By default, DOCSIS load balance is supported for all cable modems with all types of ranging class IDs. Inthe event of DOCSIS load balance, a cable modem moves to the target upstream channel only if the rangingclass ID matches with the upstream channel class ID.

Cable Modem Exclusion for DOCSIS Load BalanceYou can exclude a cable modem or a group of cable modems fromDOCSIS load balance based on their devicetype, MAC address, and Organizational Unique Identifier (OUI) using the cable load-balance excludecommand in global configuration mode.


Cable Modem SteeringUpstream Channel Descriptor TLV for Ranging Hold-off

How to Configure Cable Modem Steering on the CMTS RouterThis section describes the following required and optional procedures:

Configuring an Upstream Channel Class IDThis configuration is optional. A channel class ID must be configured for an upstream logical channel if youwant to configure UCD TLV ranging hold-off on the CMTS router.

Procedure





Example:

Step 2


Specifies the cable interface and enters cable interfaceconfigurationmode. Arguments for this commandmay vary

controller upstream-cableslot/subslot/controller-port-number

Step 3

depending on the CMTS router, line card, and Cisco IOSExample: software release. For details, see the Cisco IOSCMTSCable

Command Reference .Router(config)# controller Upstream-Cable 3/0/0

• Slot—Slot where the interface card resides. The validrange is from 0 to 3 and 6 to 9 on the Cisco cBR-8router.

• Subslot—Subslot where the interface card resides. Thevalid value is 0 on the Cisco cBR-8 router.

• controller-port-number—Controller port number. Thevalid values are from 0 to 7 on the Cisco cBR-8 router.

Configures the channel class ID for an upstream logicalchannel.

us-channel us-channel-id chan-class-id id

Example:

Step 4

• us-channel-id—Specifies the upstream channel id.Router(config-controller)# us-channel 3chan-class-id ff • id—Channel class ID for the logical upstream channel

in the hexadecimal format. The valid range is from 0to ffffffff. The default value is 0.


Example:

Step 5



Cable Modem SteeringHow to Configure Cable Modem Steering on the CMTS Router

http://www.cisco.com/c/en/us/td/docs/cable/cmts/cmd_ref/b_cmts_cable_cmd_ref/b_cmts_cable_cmd_ref_chapter_01100.html


Configuring an Upstream Ranging Hold-off Priority ValueThis configuration is optional

Maximum time that a cable modem can inhibit transmissions on an upstream channel in response to its rangingclass ID matching a bit value in the Ranging Hold-off Priority field in the cable modem configuration file is300 seconds (five minutes) per DOCSIS 3.0 MAC and Upper Layer Protocols Interface Specification . Thisdefault timer value cannot be changed.

Procedure





Example:

Step 2


Specifies the cable interface and enters cable interfaceconfigurationmode. Arguments for this commandmay vary

controller upstream-cableslot/subslot/controller-port-number

Step 3

depending on the CMTS router, line card, and Cisco IOSExample: software release. For details, see the Cisco IOSCMTSCable

Command Reference .Router(config)# controller upstream-cable 3/0/0

• Slot—Slot where the interface card resides. The validrange is from 0 to 3 and 6 to 9 on the Cisco cBR-8router.

• Subslot—Subslot where the interface card resides. Thevalid value is 0 on the Cisco cBR-8 router.

• controller-port-number—Controller port number. Thevalid values are from 0 to 7 on the Cisco cBR-8 router.

Configures the ranging hold-off priority value for anupstream logical channel.

us-channel us-channel-id rng-holdoff priority

Example:

Step 4

• us-channel-id—Specifies the upstream channel id.Router(config-controller)# us-channel 3 rng-holdoff1 • rng-holdoff priority—Specifies the ranging hold-off

priority value in the hexadecimal format. The validrange is from 0 to ffffffff. The default value is 0.


Example:

Step 5



Cable Modem SteeringConfiguring an Upstream Ranging Hold-off Priority Value



Verifying and Troubleshooting Cable Modem SteeringThis section provides the verification and troubleshooting information:

Verifying an Upstream Ranging Class ID ConfigurationTo verify an upstream ranging class ID of a cable modem, use the show cable modem command with theverbose keyword.

Following is a sample output of the show cable modem verbose command:Router# show cable modem 68b6.fcfe.22e5 verbose

MAC Address : 68b6.fcfe.22e5IP Address : 192.168.0.8IPv6 Address : 2001:DB8:10:1:9951:1972:33F9:9867Dual IP : YPrim Sid : 8Host Interface : C8/0/0/UBMD-DS-SG / MD-US-SG : 1 / 2MD-CM-SG : 0x5A0102Primary Wideband Channel ID : 3073 (Wi8/0/0:0)Primary Downstream : Mo8/0/0:0 (RfId : 2304)Wideband Capable : YRCP Index : 3RCP ID : 00 10 00 00 18Downstream Channel DCID RF Channel : 45 8/0/0:0Downstream Channel DCID RF Channel : 46 8/0/0:1Downstream Channel DCID RF Channel : 47 8/0/0:2Downstream Channel DCID RF Channel : 48 8/0/0:3Downstream Channel DCID RF Channel : 49 8/0/0:4Downstream Channel DCID RF Channel : 50 8/0/0:5Downstream Channel DCID RF Channel : 51 8/0/0:6Downstream Channel DCID RF Channel : 52 8/0/0:7Downstream Channel DCID RF Channel : 53 8/0/0:8Downstream Channel DCID RF Channel : 54 8/0/0:9Downstream Channel DCID RF Channel : 55 8/0/0:10Downstream Channel DCID RF Channel : 56 8/0/0:11Downstream Channel DCID RF Channel : 57 8/0/0:12Downstream Channel DCID RF Channel : 58 8/0/0:13Downstream Channel DCID RF Channel : 59 8/0/0:14Downstream Channel DCID RF Channel : 60 8/0/0:15Downstream Channel DCID RF Channel : 61 8/0/0:16Downstream Channel DCID RF Channel : 62 8/0/0:17Downstream Channel DCID RF Channel : 63 8/0/0:18Downstream Channel DCID RF Channel : 64 8/0/0:19Downstream Channel DCID RF Channel : 65 8/0/0:20Downstream Channel DCID RF Channel : 66 8/0/0:21Downstream Channel DCID RF Channel : 67 8/0/0:22Downstream Channel DCID RF Channel : 68 8/0/0:23UDC Enabled : NExtended Upstream Transmit Power : 61dBMulti-Transmit Channel Mode : YNumber of US in UBG : 8Upstream Channel : US0 US1 US2 US3Ranging Status : sta sta sta staUpstream SNR (dB) : 30.62 32.32 18.25 24.26Upstream Data SNR (dB) : -- -- -- --Received Power (dBmV) : 0.50 0.00 -0.50 -0.50Reported Transmit Power (dBmV) : 30.75 30.75 29.25 29.25


Cable Modem SteeringVerifying and Troubleshooting Cable Modem Steering

Peak Transmit Power (dBmV) : 61.00 61.00 61.00 61.00Phy Max Power (dBmV) : 48.00 48.00 48.00 48.00Minimum Transmit Power (dBmV) : 21.00 21.00 21.00 21.00Timing Offset (97.6 ns): 1800 1800 1800 1800Initial Timing Offset : 1544 1544 1544 1544Rng Timing Adj Moving Avg(0.381 ns): -1 0 -1 -1Rng Timing Adj Lt Moving Avg : -7 0 -7 -7Rng Timing Adj Minimum : -256 0 -256 -256Rng Timing Adj Maximum : 65536 65536 65536 65536Pre-EQ Good : 0 0 0 0Pre-EQ Scaled : 0 0 0 0Pre-EQ Impulse : 0 0 0 0Pre-EQ Direct Loads : 0 0 0 0Good Codewords rx : 1201 1262 833 656Corrected Codewords rx : 0 0 169 117Uncorrectable Codewords rx : 0 0 205 335Phy Operating Mode : atdma* atdma* atdma* atdma*Upstream Channel : US4 US5 US6 US7Ranging Status : sta sta sta staUpstream SNR (dB) : 15.53 31.62 31.1 31.87Upstream Data SNR (dB) : -- -- -- --Received Power (dBmV) : 0.00 0.00 -0.50 0.50Reported Transmit Power (dBmV) : 29.25 30.75 30.75 30.75Peak Transmit Power (dBmV) : 61.00 61.00 61.00 61.00Phy Max Power (dBmV) : 48.00 48.00 48.00 48.00Minimum Transmit Power (dBmV) : 21.00 21.00 21.00 21.00Timing Offset (97.6 ns): 1800 1800 1800 1800Initial Timing Offset : 1544 1800 1544 1544Rng Timing Adj Moving Avg(0.381 ns): -1 -1 46 0Rng Timing Adj Lt Moving Avg : -7 -7 104 0Rng Timing Adj Minimum : -256 -256 0 0Rng Timing Adj Maximum : 65536 256 65536 65536Pre-EQ Good : 0 0 0 0Pre-EQ Scaled : 0 0 0 0Pre-EQ Impulse : 0 0 0 0Pre-EQ Direct Loads : 0 0 0 0Good Codewords rx : 718 1328 1173 1252Corrected Codewords rx : 110 0 0 0Uncorrectable Codewords rx : 298 0 0 0Phy Operating Mode : atdma* atdma* atdma* atdma*sysDescr : DOCSIS 3.0 Cable Modem RouterDownstream Power : 7.40 dBmV (SNR = 43.30 dB)MAC Version : DOC3.0QoS Provisioned Mode : DOC1.1Enable DOCSIS2.0 Mode : YModem Status : {Modem= w-online, Security=disabled}Capabilities : {Frag=N, Concat=N, PHS=Y}Security Capabilities : {Priv=, EAE=Y, Key_len=}L2VPN Capabilities : {L2VPN=Y, eSAFE=Y}Sid/Said Limit : {Max US Sids=8, Max DS Saids=64}Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=Y}Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}Number of CPE : 0(Max CPE = 16)Number of CPE IPs : 0(Max CPE IPs = 16)Number of CPE IPv6 : 0(Max CPE IPv6 = 16)CFG Max-CPE : 16Flaps : 19(Oct 11 04:00:25)Errors : 0 CRCs, 0 HCSesStn Mtn Failures : 0 aborts, 12 exhaustedTotal US Flows : 1(1 active)Total DS Flows : 1(1 active)Total US Data : 3294 packets, 577031 bytesTotal US Throughput : 0 bits/sec, 0 packets/secTotal DS Data : 2263 packets, 200777 bytes


Cable Modem SteeringVerifying an Upstream Ranging Class ID Configuration

Total DS Throughput : 0 bits/sec, 0 packets/secLB group ID assigned (index) : 2153382146 (55810)LB group ID in config file (index) : N/A (N/A)LB policy ID : 0LB policy ID in config file : 0LB priority : 0Tag :Required DS Attribute Mask : 0x0Forbidden DS Attribute Mask : 0x0Required US Attribute Mask : 0x0Forbidden US Attribute Mask : 0x0Service Type ID :Service Type ID in config file :Ranging Class ID : 0x2Active Classifiers : 0 (Max = NO LIMIT)CM Upstream Filter Group : 0CM Downstream Filter Group : 0CPE Upstream Filter Group : 0CPE Downstream Filter Group : 0DSA/DSX messages : permit allVoice Enabled : NODS Change Times : 0Boolean Services : 2Number of Multicast DSIDs Support : 63MDF Capability Mode : 2IGMP/MLD Version : MLDv2FCType10 Forwarding Support : YFeatures Bitmask : 0x0Total Time Online : 9h27m (9h27m since last counter reset)CM Initialization Reason : BAD_DHCP_ACKCFG Max IPv6 CPE Prefix : 16 (-1 used)

Additional ReferencesThe following sections provide references related to the Cable Modem Steering feature.

Related Documents


Cisco IOS CMTS Cable Command ReferenceCMTS cable commands

Standards and RFCs

TitleStandard

DOCSIS 3.0 MAC and Upper Layer Protocols Interface SpecificationCM-SP-MULPIv3.0-I07-080215

DOCSIS 3.0 MAC and Upper Layer Protocols Interface SpecificationCM-SP-MULPIv3.0-I18-120329

DOCSIS 2.0 Radio Frequency Interface SpecificationCM-SP-RFI2.0-I13-080215


Cable Modem SteeringAdditional References



LinkDescription

http://www.cisco.com/cisco/web/support/index.htmlThe Cisco Support website provides extensive onlineresources, including documentation and tools fortroubleshooting and resolving technical issues withCisco products and technologies.

To receive security and technical information aboutyour products, you can subscribe to various services,such as the Product Alert Tool (accessed from FieldNotices), the Cisco Technical Services Newsletter, andReally Simple Syndication (RSS) Feeds.

Access to most tools on the Cisco Support websiterequires a Cisco.com user ID and password.

Feature Information for Cable Modem SteeringUse Cisco Feature Navigator to find information about the platform support and software image support.Cisco Feature Navigator enables you to determine which software images support a specific software release,feature set, or platform. To access Cisco Feature Navigator, go to the https://cfnng.cisco.com/ link. An accounton the Cisco.com page is not required.


Note

Table 64: Feature Information for Cable Modem Steering on the Cisco CMTS Routers


This feature was integrated into Cisco IOS XE Everest16.6.1 on the Cisco cBR Series Converged BroadbandRouters.

Cisco IOS XE Everest16.6.1

CableModemSteering


Cable Modem SteeringFeature Information for Cable Modem Steering




Cable Modem SteeringFeature Information for Cable Modem Steering