Cable Commands: q through sg

qos-profile enforced

To specify a quality-of-service (QoS) profile that should be enforced when users violate their registered QoS profiles, use the qos-profile enforced command in enforce-rule configuration mode. To delete the enforced QoS profile from the enforce-rule, use the no form of this command.

qos-profile enforced profile-id [no-persistence]

no qos-profile enforced profile-id [no-persistence]

Syntax Description

profile-id

Specifies the QoS profile to be enforced. The valid range is 0 to 16383, with a default of 0.

no-persistence

(Optional) Specifies that the enforced QoS profile should not remain in force when a cable modem reboots. Instead, when a cable modem that is in the penalty period reboots, it is automatically removed from the penalty period and assigned the QoS profile that is specified in its DOCSIS configuration file.

The default behavior is that enforced QoS profiles remain in force for cable modems across reboots.

Command Default

The value of profile-id defaults to 0, and enforced QoS profiles are persistent across cable modem reboots.

Command Modes


Enforce-rule configuration (enforce-rule)

Command History

Release

Modification

12.3(9a)BC

This command was introduced. This command replaces the enforced qos-profile command.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

IOS-XE 3.17.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Both the originally provisioned QoS profile and the enforced QoS profile must be created on the Cisco CMTS router. The profile-id does not support QoS profiles that are created by the cable modem.

An enforce-rule can specify an enforced QoS profile, which is automatically applied to subscribers who transmit more traffic than allowed by their registered QoS profile. The enforced QoS profile remains in effect during the penalty time period (see the penalty-period command). At the end of the penalty period, the subscriber returns to the registered QoS profile.

If a cable modem reboots while it is in its penalty time period, it continues using the enforced QoS profile, unless the service provider has manually changed the cable modem’s registered QoS profile using the cable modem qos profile command.

When you change the enforced QoS profile for a currently active enforce-rule, any cable modems using this rule that are currently in the penalty period continue using the previously configured enforced QoS profile. Any cable modems that enter the penalty period after this configuration change, however, use the new enforced QoS profile.

An enforced QoS profile must already have been created on the Cisco CMTS router before you can assign it to an enforce-rule. If the rule does not exist, the system displays an error message.

When the no-persistence option is specified, the enforced QoS profile is still automatically applied to subscribers who violate their bandwidth requirements. However, when the cable modem reboots, the Cisco CMTS router allows the cable modem to use the QoS profile that is specified in its DOCSIS configuration file.

The no-persistence option can be used when initially using the Subscriber Traffic Management feature to identify potential problem applications and users. When repeat offenders are identified, they can then be assigned enforce-rules that do not use the no-persistence option, so that they remain in the penalty period even if they reboot their cable modems.


Note


The system automatically applies the enforced QoS profile to violators only if the enforce keyword has been used with the activate-rule-at-byte-count command.

Examples

The following example shows profile 12 being assigned as the enforced QoS profile to an enforce-rule:


Router# configure terminal
 
Router(config)# cable qos enforce-rule residential
 
Router(enforce-rule)# qos-profile enforced 12  

The following example shows profile 12 being assigned as the enforced QoS profile to an enforce-rule, but with the no-persistence option specified, so that the enforced QoS profile does not remain in force if the cable modem reboots:


Router# configure terminal
 
Router(config)# cable qos enforce-rule residential
 
Router(enforce-rule)# qos-profile enforced 12 no-persistence 

The following example shows the error message that is displayed when the specified QoS profile does not exist on the CMTS:


Router# configure terminal
 
Router(config)# cable qos enforce-rule test
 
Router(enforce-rule)# qos-profile enforced 98
 
The qos profile 98 doesn't exist or it's a cm created QoS profile

qos-profile registered

To specify the registered quality of service (QoS) profile that should be used for this enforce-rule, use the qos-profile registered command in enforce-rule configuration mode. To remove the registered QoS profile from the enforce-rule, use the no form of this command.

qos-profile registered profile-id

no qos-profile registered profile-id

Syntax Description

profile-id

Specifies the QoS profile to be monitored. This profile must be created on the Cisco CMTS router. If you want to manage a cable modem that uses a modem-created QoS profile, you must first create that exact QoS profile on the CMTS router before using this command. The valid range is 0 to 16383, with a default of 0.

Command Default

The default profile ID is 0.

Command Modes


Enforce-rule configuration (enforce-rule)

Command History

Release

Modification

12.3(9a)BC

This command was introduced. This command replaces the registered qos-profile command.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

IOS-XE 3.17.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

You must specify a registered QoS profile for each enforce-rule. The Cisco CMTS router then uses the registered profile ID to match subscribers’ service flows to the proper enforce-rules.

When you change the registered QoS profile for an active rule, the cable modems that had been using the previous registered QoS profile are no longer managed by the Subscriber Traffic Management feature. Instead, the rule begins managing those cable modems that use the new registered QoS profile.


Note


The registered QoS profile must be created on the Cisco CMTS router before you can assign it to an enforce-rule. If the rule does not exist, the system displays an error message. If you want to manage a cable modem that is currently using a modem-created QoS profile, you must first manually create a new QoS profile on the CMTS router that has the same QoS parameters as the modem-created profile. Then allow the modem to come online using the manually created profile, before using the qos-profile registered command.

Examples

The following example shows profile 50 being assigned as the registered QoS profile to an enforce-rule:


Router# configure terminal
 
Router(config)# cable qos enforce-rule enforce-rule 
Router(enforce-rule)# qos-profile registered 50 

The following example shows the error message that is displayed when the specified QoS profile does not exist on the CMTS:


Router# configure terminal
 
Router(config)# cable qos enforce-rule test
 
Router(enforce-rule)# qos-profile registered 99
 
The qos profile 99 doesn't exist or it's a cm created QoS profile

qam-profile

To define the QAM profile number, use the qam-profile command in the RF channel sub configuration mode.

qam-profile value

Syntax Description

value

Value for the QAM profile. The QAM profiles are defined before they are associated with rf-channels. Valid range is 0 to 31.

  • QAM profile ID 0 to 5

  • System defined 6 to 31

Once defined, the rf-channel associated with that profile must match the correct qam-profile type. For instance, qam-profile 4 is defined for video, and may be used with rf-channels of type VIDEO.

Command Default

None.

Command Modes

RF channel sub configuration mode (config-rf-chan)

Usage Guidelines

This command is used to define the QAM profile number.

Examples

The following example shows how to define the QAM profile number:

router#configure terminal 
router(config)#controller integrated-cable 3/0/0
router(config-controller)#rf-chan 5 10
router(config-rf-chan)#type video
router(config-rf-chan)#frequency 723000000
router(config-rf-chan)#rf-output alt
router(config-rf-chan)#power-adjust 0
router(config-rf-chan)#qam-profile 4
router(config-rf-chan)#exit
router(config-controller)#exit
router(config)#exit
router#show controller integrated-Cable 3/0/0 rf-channel 5 10
Chan State Admin Frequency  Type   Annex Mod  srate Interleaver  dcid  power  output
 5   TEST   UP   723000000  VIDEO  B    256   5361  I32-J4       164  34     ALT
 10  TEST   UP   753000000  VIDEO  B    256   5361  I32-J4       169  34     ALT

r-dti

To specify the Remote DOCSIS Timing Interface (R-DTI) configuration ID to use in RPD, use the r-dti command in RPD configuration mode. To void the R-DTI configuration specification, use the no form of this command.

r-dti configuration_id

no r-dti

Syntax Description

configuration_id

Specifies the ID of the R-DTI configuration previously created.

Command Default

None

Command Modes

RPD configuration (config-rpd)

Command History

Release

Modification

Cisco IOS XE Everest 16.5.1

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Use this command to specify the R-DTI configuration ID.

Examples

The following example shows how to specify the R-DTI configuration ID:

Router# configure terminal
Router(config)# cable rpd 1
Router(config-rpd)# r-dti 1

rcp-id

To assign a receive channel profile (RCP) ID to a receive channel configuration (RCC) template, use the rcp-id command in RCC template configuration mode. To remove the RCP ID, use the no form of this command.

rcp-id rcp-id

no rcp-id rcp-id

Syntax Description

rcp-id

Specifies an RCP ID for the RCC template. The valid range is from 00 00 00 00 00 to FF FF FF FF FF.

Command Default

By default the RCP ID is set to 00 00 00 00 00. However, you must change the default value to a non-zero RCP ID.

Command Modes


RCC template configuration (config-rcc-template)

Command History

Release

Modification

12.2(33)SCB

This command was introduced.

Usage Guidelines

A valid RCC template consists of a configured RCP ID, a receive module (RM) entry, and a receive channel (RC) entry.

First, you define an RCC template for an RCP, and then assign the template to a cable interface to generate RCCs based on the actual DS channel configuration.

Examples

The following example shows how to assign an RCP ID to an RCC template:


Router# configure terminal
Router(config)# cable rcc-template
 1
Router(config-rcc-template)# rcp-id 00 10 00 00 03

receive-channel

To associate a receive channel to a receive module (RC), use the receive-channel command in RCC template configuration mode. To restore the default value, use the no form of this command.

receive-channel index center-frequency Hz connected-receive-module index [primary]

no receive-channel index center-frequency Hz connected-receive-module index

Syntax Description

index

Specifies the index value for the receive channel. The valid range is 1 to 10.

center-frequency

Specifies the center frequency for the receive channel.

Hz

Specifies the center frequency value in Hz. The valid range is 55000000-858000000.

connected-receive-module

Specifies a nested receive module in the RCC template.

Generally, only one receive module is configured for an RCC template.

index

Specifies the index value for the connected receive module. The valid range is 1 to 10.

primary

(Optional) Indicates that it is a CM primary channel and an RCC can be derived from this channel.

Command Default

None

Command Modes


RCC template configuration (config-rcc-template)

Command History

Release

Modification

12.2(33)SCB

This command was introduced.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

A valid RCC template consists of a configured RCP ID, a receive module (RM) entry, and a receive channel (RC) entry. First, you define an RCC template for an RCP, and then assign the template to a cable interface to generate RCCs based on the actual DS channel configuration.

An RCC template configures the physical layer components described by an RCP, including receive modules and receive channels to specific downstream frequencies, and specifies the interconnections among receive modules or between receive modules and receive channels.

A receive module can include multiple receive channels. So we need to specify which receive channel belongs to which receive module.

Examples

The following example shows how to associate a receive channel to a receive module:


Router# configure terminal
Router(config)# cable rcc-template
 1
Router(config-rcc-template)# rcp-id 00 10 00 00 03
Router(config-rcc-template)# receive-module 1 first-channel-center-frequency 555000000
Router(config-rcc-template)# receive-channel 1 center-frequency 555000000 connected-receive-module 1 primary
Router(config-rcc-template)# receive-channel 2 center-frequency 561000000 connected-receive-module 1

receive-module

To associate a receive module (RC) to a Receive Channel Configuration (RCC) template, use the receive-module command in RCC template configuration mode. To restore the default value, use the no form of this command.

receive-module index first-channel-center-frequency Hz [connected-receive-module index]

no receive-module index first-channel-center-frequency Hz [connected-receive-module index]

Syntax Description

index

Specifies the index value for the receive module. The valid index range is 1 to 10.

first-channel-center-frequency

Specifies the center frequency of the first channel of the receive module channel block.

Hz

Specifies the center frequency value in Hz. The valid range is 55000000 to 858000000.

connected-receive-module

(Optional) Specifies a nested receive module in the RCC template.

Generally, only one receive module is configured for an RCC template.

index

(Optional) Specifies the index value for the connected receive module. The valid range is 1 to 10.

Command Default

None

Command Modes


RCC template configuration (config-rcc-template)

Command History

Release

Modification

12.2(33)SCB

This command was introduced.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

A valid RCC template consists of a configured RCP ID, a receive module (RM) entry, and a receive channel (RC) entry. First, you define an RCC template for an RCP, and then assign the template to a cable interface to generate RCCs based on the actual DS channel configuration.

An RCC template configures the physical layer components described by an RCP, including receive modules and receive channels to specific downstream frequencies, and specifies the interconnections among receive modules or between receive modules and receive channels.

A receive module can include multiple receive channels. So we need to specify which receive channel belongs to which receive module.

Examples

The following example shows how to associate a receive module to an RCC template:


Router# configure terminal
Router(config)# cable rcc-template
 1
Router(config-rcc-template)# rcp-id 00 10 00 00 03
Router(config-rcc-template)# receive-module 1 first-channel-center-frequency 555000000
Router(config-rcc-template)# receive-channel 1 center-frequency 555000000 connected-receive-module 1 primary
Router(config-rcc-template)# receive-channel 2 center-frequency 561000000 connected-receive-module 1

redundancy

To configure line card redundancy, use the redundancy command in global configuration mode.

redundancy

Syntax Description

This command has no arguments or keywords.

Command Default

None.

Command Modes

Global configuration (config)

Command History

Release

Modification

IOS-XE Release 3.16.0S

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Use the redundancy command to enter the redundancy configuration mode.

Examples

The following example shows how to configure line card redundancy:

Router# configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
Router(config)# redundancy
Router(config-red)# linecard-group 0 internal-switch 
Router(config-red-lc)# description RedundancyGroup0
Router(config-red-lc)# class 1:N 
Router(config-red-lc)# revertive 60
Router(config-red-lc)# member slot 1 primary
Router(config-red-lc)# member slot 0 secondary

redundancy force-failover main-cpu

To force a switchover, so that the standby Performance Routing Engine (PRE1) module becomes the active PRE1 module, use theredundancy force-failover main-cpu command in privileged EXEC mode.

redundancy force-failover main-cpu

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

12.2(4)XF1

This command was introduced for the Cisco uBR10012 router.

12.2(11)BC3

The active PRE1 module checks to see if a switchover is currently in progress before implementing this command.

12.3(21)BC

This command is replaced by the redundancy switch-activity command.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The redundancy force-failover main-cpu command initiates a manual switchover, so that the standby PRE1 module becomes the active PRE1 module and assumes full responsibilities for router operations. This command requires that both PRE1 modules are running a Cisco IOS software image that supports the Route Processor Redundancy (RPR) feature.


Note


The terms failover and switchover are interchangeable, but switchover is the term used across all Cisco platforms capable of high-availability operation.

A manual switchover is typically done for one of the following reasons:

  • You want to upgrade or replace the active PRE1 module.
  • You have upgraded the Cisco IOS software on the standby PRE1 module and want the standby PRE1 module to begin using the new software image. This also allows you to upgrade the software on the former active PRE1 module without interrupting systems operations.
  • You want to test switchover operation on the system.

A switchover can also be manually initiated by removing the active PRE1 module from the chassis, but using the redundancy force-failover main-cpu command provides a more graceful switchover, without generating hardware alarms.


Tip


Do not perform a switchover immediately after you change the configuration and save it to the NVRAM. Instead, wait a few minutes to allow the two PRE1 modules to synchronize the new configuration, and then perform the switchover.



Tip


Wait two to three minutes after a switchover before switching the system back to the original PRE1 module, so as to allow the system to stabilize and so that both PRE1 modules are ready for the switch. In Cisco IOS Release 12.2(11)BC3 and later releases, the active PRE1 module will not initiate a new switchover until a current switchover is complete and the system has stabilized.


Examples

The following example shows a switchover being manually initiated:


Router# redundancy force-failover main-cpu
 
Proceed with switchover to standby PRE? [confirm] y

Note


Pressing enter or y confirms the action and begins the switchover. Pressing any other key cancels the switchover and returns control to the current active PRE1 module.

The following example shows a switchover being attempted but failing because the standby PRE1 module is either not ready, not available, or not installed:


Router# redundancy force-failover main-cpu
 
Proceed with switchover to standby PRE? [confirm]
Standby PRE not ready, switchover aborted.
Router# 

Note


In some versions of Cisco IOS software, a failed software switchover will show the following message:

Unable to communicate with standby PRE, switchover aborted.


redundancy force-switchover main-cpu

To force a standby Performance Routing Engine (PRE) to assume the role of an active PRE, use the redundancy force-switchovermain-cpu command in privileged EXEC mode.

redundancy force-switchovermain-cpu

Syntax Description

None

Command Default

None

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

12.2(33)SCB

This command was introduced.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Before using this command, install the Cisco IOS software image (to ensure high availability), and configure the Route Processor Redundancy (RPR) mode on both the PRE modules.


Note


The terms failover and switchover are interchangeable, but switchover is the term used across all Cisco platforms capable of high-availability operation.

Note


We recommend you use the redundancy force-switchover main-cpu command only on the active PRE module. The active PRE crashes used on the standby PRE.

Examples

The following example shows a manual switchover:



Router# redundancy force-switchover main-cpu

Proceed with switchover to standby PRE? [confirm] y 

Preparing to Switch Activity



Note


Pressing enter or y confirms the action and begins the switchover. Pressing any other key cancels the switchover and returns control to the currently active PRE module.

The following example shows a switchover being attempted but failing because the standby PRE module is either not ready, not available, or not installed:



Router# redundancy force-switchover main-cpu

Proceed with switchover to standby PRE? [confirm] n

Standby PRE not ready, switchover aborted.

Router#


redundancy linecard-group

To trigger a switchover from the working line card to the protect line card, or to revert from the protect line card to the working line card on the Cisco uBR10012 and Cisco cBR series routers, use the redundancy linecard-group command in privileged EXEC mode.

redundancy linecard-group {lockout | resync | revertback | switchover from | unlockout} slot/ subslot

Cisco cBR Series Converged Broadband Routersredundancy linecard-group switchover from slot

Syntax Description

lockout

Locks a line card switchover from the specified working slot and subslot.

resync

Specifies static synchronization from the working line card to the protect line card.

revertback

Reverts from the protect line card to the working line card.

switchover from

Triggers a switchover from the working line card to the protect line card.

slot

(Cisco cBR series routers) Slot number of the interface card. The range is from 0 to 3 and 6 to 9 on the Cisco cBR-8 router.

unlockout

Removes the switchover lockout from the specified working slot and subslot.

slot / subslot

(Cisco uBR10012 router) Specifies the cable interface line card.

  • slot —Chassis slot number of the cable interface line card. The valid range is from 5 to 8.
  • subslot —(Cisco uBR10012 router only) Secondary slot number of the cable interface line card. Valid subslots are 0 and 1.

Command Default

None

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

12.3(13a)BC

This command was introduced.

12.2(33)SCE

This command was modified. A new keyword, resync , was added to enable the Cisco uBR10012 router to perform a manual synchronization from the working line card to the protect line card.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers. The lockout, resync, revertback, and unlockout keywords were removed.

Usage Guidelines

The redundancy linecard-group command is supported only on the Cisco uBR10012 and Cisco cBR series routers.

When the normal (system initiated) static line card synchronization fails, use the redundancy linecard-group command with the resync keyword to enable the Cisco uBR10012 router to perform a manual synchronization from the working line card to the protect line card.

Examples

The following example shows how to lock a line card switchover from slot 5 and subslot 0 on the Cisco uBR10012 router using the redundancy linecard-group command with the lockout keyword:


Router# redundancy linecard-group lockout 5/0
HCCP LC: 5/0 Working will be locked out, this operation will prevent all kinds of switchover.

The following example shows how to remove the switchover lockout from slot 5 and subslot 0 on the Cisco uBR10012 router using the redundancy linecard-group command with the unlockout keyword:


Router# redundancy linecard-group unlockout 5/0

The following example shows how to enable the Cisco uBR10012 router to perform a manual synchronization from the working line card to the protect line card using the redundancy linecard-group command with the resync keyword:


Router# redundancy linecard-group resync 5/0
*Nov  9 23:09:09.049: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state to administratively down
*Nov  9 23:09:09.049: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U1, changed state to administratively down
*Nov  9 23:09:09.049: %SNMP-5-LINK_DOWN: LinkDown:Interface Cable5/1/1-upstream2 changed state to down
*Nov  9 23:09:09.049: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U0, changed state to administratively down
*Nov  9 23:09:09.057: %SNMP-5-LINK_DOWN: LinkDown:Interface Cable5/1/1-upstream1 changed state to down
*Nov  9 23:09:09.057: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U0, changed state to up
*Nov  9 23:09:09.057: %SNMP-5-LINK_DOWN: LinkDown:Interface Cable5/1/1-upstream0 changed state to down
*Nov  9 23:09:09.061: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U1, changed state to up
*Nov  9 23:09:09.061: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state to up
*Nov  9 23:09:09.173: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/1/1-upstream0 changed state to up
SLOT 5/1: Nov  9 23:09:09.057: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state to administratively down
SLOT 5/1: Nov  9 23:09:09.057: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U1, changed state to administratively down
SLOT 5/1: Nov  9 23:09:09.057: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U0, changed state to administratively down
SLOT 5/1: Nov  9 23:09:09.173: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U0, changed state to up
SLOT 5/1: Nov  9 23:09:09.177: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U1, changed state to up
SLOT 5/1: Nov  9 23:09:09.177: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state to up
*Nov  9 23:09:19.457: %HCCP-5-SWITCHOVERREADY: HCCP card 5/1 Mbr 50 Protect: ready to switchover.
*Nov  9 23:09:19.457: %HCCP-5-SWITCHOVERREADY: HCCP card 5/0 Mbr 50 Working: ready to switchover.

The following example shows how to enable the Cisco uBR10012 router to perform a switchover from the working line card to the protect line card using the redundancy linecard-group command with the switchover from keyword:

The following example shows how to enable the Cisco uBR10012 router to perform a switchover from the working line card to the protect line card using theredundancy linecard-group command with the switchover from keyword:


Router# redundancy linecard-group switchover from 5/0
*Nov  9 23:17:27.489: %HCCP-5-LC_ACTIVE: HCCP card 5/1 Mbr 50 Protect: change state to active due to: CLI Switch.
*Nov  9 23:17:27.525: %HCCP-5-LC_STANDBY: HCCP card 5/0 Mbr 50 Working: change state to standby due to: CLI Switch.
*Nov  9 23:17:27.525: %HCCP-5-CHANON: HCCP card 5/1 Mbr 50 Protect: turning on channel.
*Nov  9 23:17:27.525: %HCCP-6-HCCP_CHAN_RFSW_SNMP_INFO: HCCP_LC_CHAN: waits forsnmp response asynchronously.
*Nov  9 23:17:27.541: %SNMP-5-LINK_UP: LinkUp:Interface Wideband-Cable5/1/1:0 changed state to up
*Nov  9 23:17:27.541: %LINEPROTO-5-UPDOWN: Line protocol on Interface Wideband-Cable5/1/1:0, changed state to up
*Nov  9 23:17:27.541: %SNMP-5-LINK_UP: LinkUp:Interface Wideband-Cable5/1/1:2 changed state to up
*Nov  9 23:17:27.541: %LINEPROTO-5-UPDOWN: Line protocol on Interface Wideband-Cable5/1/1:2, changed state to up
*Nov  9 23:17:27.541: %SNMP-5-LINK_UP: LinkUp:Interface Wideband-Cable5/1/1:4 changed state to up
*Nov  9 23:17:27.541: %LINEPROTO-5-UPDOWN: Line protocol on Interface Wideband-Cable5/1/1:4, changed state to up
*Nov  9 23:17:27.905: %HCCP-6-HCCP_CHAN_RFSW_SNMP_INFO: HCCP_LC_CHAN: snmp set to rf switch is successful.
SLOT 5/1: Nov  9 23:17:27.597: %HCCP-6-LC_RPLC_CFGSYNC_CONFIG_RECOVER: HCCP 14 50 Protect: LC critical rplc_cfgsync configuration recover is succeed.
SLOT 5/1: Nov  9 23:17:27.601: %HCCP-6-LC_RPLC_CFGSYNC_CONFIG_RECOVER: HCCP 15 50 Protect: LC critical rplc_cfgsync configuration recover is succeed.
*Nov  9 23:17:28.121: %HCCP-3-DATA_PLANE_READY: HCCP data plane for card 5/1 member 50 is ready.
*Nov  9 23:17:28.493: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/1/0, changed state to up
*Nov  9 23:17:28.493: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/1/0 changed state to up
*Nov  9 23:17:28.497: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/1/1, changed state to up
*Nov  9 23:17:28.497: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/1/1 changed state to up
*Nov  9 23:17:28.497: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/1/2, changed state to up
*Nov  9 23:17:28.497: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/1/2 changed state to up
*Nov  9 23:17:37.801: %LINK-3-UPDOWN: Interface Modular-Cable5/1/1:0, changed state to up
*Nov  9 23:17:38.513: %HCCP-6-STATICSYNC_COMPLETED: HCCP static sync for card 5/1 member 50 is completed in 56 ms.
*Nov  9 23:17:38.801: %LINEPROTO-5-UPDOWN: Line protocol on Interface Modular-Cable5/1/1:0, changed state to up
*Nov  9 23:17:48.513: %HCCP-5-SWITCHOVERREADY: HCCP card 5/0 Mbr 50 Working: ready to switchover.
*Nov  9 23:17:48.513: %HCCP-5-SWITCHOVERREADY: HCCP card 5/1 Mbr 50 Protect: ready to switchover.

The following example shows how to revert from the protect line card to the working line card using the redundancy linecard-group command with the revertback keyword on the Cisco uBR10012 router:


Router# redundancy linecard-group revertback 5/0
*Nov  9 23:21:33.277: %HCCP-5-LC_ACTIVE: HCCP card 5/0 Mbr 50 Working: change state to active due to: CLI Switch.
*Nov  9 23:21:33.285: %HCCP-5-LC_STANDBY: HCCP card 5/1 Mbr 50 Protect: change state to standby due to: CLI Switch.
*Nov  9 23:21:33.297: %HCCP-5-CHANON: HCCP card 5/0 Mbr 50 Working: turning on channel.
*Nov  9 23:21:33.301: %HCCP-5-CHANOFF: HCCP card 5/1 Mbr 50 Protect: turning off channel.
*Nov  9 23:21:33.301: %HCCP-6-HCCP_CHAN_RFSW_SNMP_INFO: HCCP_LC_CHAN: waits for snmp response asynchronously.
*Nov  9 23:21:33.433: %UBR10000-5-UPDOWN: Interface Cable5/1/0 U2, changed state to administratively down
*Nov  9 23:21:33.437: %UBR10000-5-UPDOWN: Interface Cable5/1/0 U1, changed state to administratively down
*Nov  9 23:21:33.441: %UBR10000-5-UPDOWN: Interface Cable5/1/0 U0, changed state to administratively down
*Nov  9 23:21:33.481: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state to administratively down
*Nov  9 23:21:33.481: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state to administratively down
Nov  9 23:21:33.585: %interface Cable5/1/0 U0 Docsis mode set to DOCSIS 1.x-only Nov  9 23:21:33.585: %Modulation profile set to 21
*Nov  9 23:21:34.277: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/0/0, changed state to up
*Nov  9 23:21:34.277: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/0/0 changed state to up
*Nov  9 23:21:34.277: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/0/1, changed state to up
*Nov  9 23:21:34.277: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/0/1 changed state to up
*Nov  9 23:21:34.277: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/0/2, changed state to up
*Nov  9 23:21:34.277: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/0/2 changed state to up
*Nov  9 23:21:34.309: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/0/3, changed state to up
*Nov  9 23:21:34.309: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/0/3 changed state to up
*Nov  9 23:21:34.309: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/0/4, changed state to up
*Nov  9 23:21:34.309: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/0/4 changed state to up
*Nov  9 23:21:35.513: %LINK-3-UPDOWN: Interface Modular-Cable5/1/1:0, changed state to down
*Nov  9 23:21:36.513: %LINEPROTO-5-UPDOWN: Line protocol on Interface Modular-Cable5/1/1:0, changed state to down
*Nov  9 23:21:46.537: %UBR10000-5-USFREQCHG: Interface Cable5/1/0 U0, changed to Freq 10.000 MHz
*Nov  9 23:21:46.545: %UBR10000-5-USFREQCHG: Interface Cable5/1/0 U1, changed to Freq 30.000 MHz
*Nov  9 23:21:46.549: %UBR10000-5-USFREQCHG: Interface Cable5/1/0 U2, changed to Freq 20.000 MHz
*Nov  9 23:21:46.581: %UBR10000-5-USFREQCHG: Interface Cable5/1/1 U0, changed to Freq 25.000 MHz
*Nov  9 23:21:46.585: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U0, changed state to up
*Nov  9 23:21:46.585: %UBR10000-5-USFREQCHG: Interface Cable5/1/1 U1, changed to Freq 15.000 MHz
*Nov  9 23:21:46.585: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U1, changed state to up
*Nov  9 23:21:46.589: %UBR10000-5-USFREQCHG: Interface Cable5/1/1 U2, changed to Freq 35.000 MHz
*Nov  9 23:21:46.589: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state to up
*Nov  9 23:21:46.657: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/1/1-upstream0 changed state to up
Nov  9 23:21:46.669: %interface Cable5/1/0 U0 Docsis mode set to ATDMA-only (1.x CMs will go offline)
Nov  9 23:21:46.669: %Modulation profile set to 221
SLOT 5/1: Nov  9 23:21:46.689: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U0, changed state to up
SLOT 5/1: Nov  9 23:21:46.693: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U1, changed state to up
SLOT 5/1: Nov  9 23:21:46.693: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state to up
*Nov  9 23:21:57.033: %HCCP-5-SWITCHOVERREADY: HCCP card 5/1 Mbr 50 Protect: ready to switchover.
*Nov  9 23:21:57.033: %HCCP-5-SWITCHOVERREADY: HCCP card 5/0 Mbr 50 Working: ready to switchover.

The following example shows how to trigger a switchover from working card to protect card on a Cisco cBR-8 router:

Router# redundancy linecard-group switchover from slot 3

redundancy reload

To manually reload a standby Route Processor (RP) module, use the redundancy reload command in privileged EXEC mode.

redundancy reload {peer | shelf}

Syntax Description

peer

Reloads only the standby PRE1 module or Supervisor card.

shelf

Reloads both the active and standby PRE1 module or Supervisor card.

Command Default

None

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

12.2(4)XF1

This command was introduced for the Cisco uBR10012 router.

12.3BC

This command was integrated into Cisco IOS Release 12.3BC.

12.2(33)SCA

This command was removed from Cisco IOS Release 12.2(33)SCA. It is replaced by the hw-module standby-cpu reset command.

12.2(44)SQ

This command was integrated into Cisco IOS Release 12.2(44)SQ. Support for the Cisco RF Gateway 10 was added.

15.2(4)M

This command was introduced.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The redundancy reload peer command is used to reset the standby RP module when there are any failures, tracebacks, or functionality and behavior mismatches on either one or both active and standby RP modules.

This command does not have an impact on active device operations, assuming a switchover is not required while the standby module is resetting.

The redundancy reload shelf command reloads the Cisco IOS software on both the active and standby RP modules. This command interrupts services on the router until all the RP modules and the line cards initialize and come back online.

Examples

The following example shows how to manually reload the standby RP module:


Router# redundancy reload peer 
Reload peer? [confirm] y
 
Preparing to reload peer 

Note


Pressing enter or y begins the reload. Pressing any other key cancels the reload and returns control to the active RP module.

The following is sample output when a standby RP module is not installed on a router:


Router# redundancy reload peer 
System is running in SIMPLEX mode, reload anyway? [confirm] n
 
Peer reload not performed.

The following example shows how to reload all RP modules:


Router# redundancy reload shelf 
Reload the entire shelf [confirm] y
 
Preparing to reload entire shelf 

Note


Pressing enter or y begins the reload. Pressing any other key cancels the reload and returns control to the current active PRE1 module.

Cisco RF Gateway 10

The following example shows the system response when a standby Supervisor card is not installed in the Cisco RFGW-10:


Switch# redundancy reload peer 
System is running in SIMPLEX mode, reload anyway? [confirm] n
 

Peer reload not performed.

The following example shows how to reload both Supervisor cards on the Cisco RFGW-10:


Switch# redundancy reload shelf 
Reload the entire shelf [confirm] y
 
Preparing to reload entire shelf 

Note


Pressing Enter or y confirms the action and begins the reload of both cards. Pressing any other key cancels the reload and returns control to the current active Supervisor card.

redundancy switch-activity

To force a switchover to the standby PRE module, use the redundancy switch-activity command in privileged EXEC mode.


Note


The terms failover and switchover are interchangeable, but switchover is the term used across all Cisco platforms capable of high-availability operation.

redundancy switch-activity [force]

Syntax Description

force

(Optional) Forces a switchover immediately, overriding any checks in the code or configuration that might prevent or delay a switchover.

Command Default

None

Command Modes


Privileged EXEC

Command History

Release

Modification

12.2(4)XF1

This command was introduced for the Cisco uBR10012 router.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The redundancy switch-activity command is similar to the redundancy force-failover main-cpu command, except that it includes an option to force the switchover, overriding any configuration checks or other checks in the software that could prevent the switchover. In all cases, this command verifies that the standby PRE module is available and capable of performing the switchover before it transfers control to that PRE module. This command also synchronizes the current running-config and client data before initiating the switchover.

Examples

The following example shows a switchover being manually initiated, overriding any checks that might prevent or delay the switchover:


Router# redundancy switch-activity force 
Proceed with switchover to standby PRE? [confirm] y

Note


Pressing enter or y confirms the action and begins the switchover. Pressing any other key cancels the switchover and returns control to the current active PRE1 module.

registered qos-profile


Note


Effective with Cisco IOS Release 12.3(9a)BC, the registered qos-profile command is replaced by the qos-profile registered command.

To specify the registered quality of service (QoS) profile that should be used for this enforce-rule, use the registered qos-profile command in enforce-rule configuration mode. To remove the registered QoS profile from the enforce-rule, use the no form of this command.

registered qos-profile profile-id

no registered qos-profile profile-id

Syntax Description

profile-id

Specifies the QoS profile to be monitored. This profile must be created on the Cisco CMTS router. If you want to manage a cable modem that uses a modem-created QoS profile, you must first create that exact QoS profile on the CMTS router before using this command. The range is 0 to 16383. The default of 0.

Command Default

The default profile ID is 0.

Command Modes


Enforce-rule configuration (enforce-rule)

Command History

Release

Modification

12.2(15)BC1

This command was introduced.

12.3(9a)BC

This command was replaced by the qos-profile registered command.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

You must specify a registered QoS profile for each enforce-rule. The Cisco CMTS router then uses the registered profile ID to match subscribers’ service flows to the proper enforce-rules.

When you change the registered QoS profile for an active rule, the cable modems that had been using the previous registered QoS profile are no longer managed by the Subscriber Traffic Management feature. Instead, the rule begins managing those cable modems that use the new registered QoS profile.


Note


The registered QoS profile must be created on the Cisco CMTS router before you can assign it to an enforce-rule. If the rule does not exist, the system displays an error message. If you want to manage a CM that is using a CM-created QoS profile, you must first create a QoS profile on the Cisco CMTS router that matches the CM-created profile exactly. Then use the registered qos-profile command to assign that profile to this enforce-rule.

Examples

The following example shows profile 50 being assigned as the registered QoS profile to an enforce-rule:


Router# configure terminal
 
Router(config)# cable qos enforce-rule enforce-rule 
Router(enforce-rule)# registered qos-profile 50  

The following example shows the error message that is displayed when the specified QoS profile does not exist on the CMTS:


Router# configure terminal
 
Router(config)# cable qos enforce-rule test
 
Router(enforce-rule)# registered qos-profile 99
 
The qos profile 99 doesn't exist or it's a cm created QoS profile

remap pid vcg

To configure custom PID remapping, use the remap pid vcg command in video configuration mode. PID remapping enables you to specify remap rules for all four types of processing types—data, pass-through, remap, and remux sessions.

remap pid vcg vcg

Syntax Description

vcg

Specifies the virtual carrier group.

Command Default

None.

Command Modes


Video configuration (config)

Command History

Release

Modification

IOS-XE 16.7.1

This command was introduced on the Cisco cBR Series Converged Broadband Router.

Examples

The following example shows a PID remap rule for a table-based unicast session on input port number 1 with vei-ip 198.51.100.1

logical-edge-device led1 id 1 
        protocol table-based
              virtual-edge-input-ip 198.51.100.1 input-port-number 1 
              vcg vcg1
              active
table-based
       vcg vcg1 
             rf-channel 20
                   session unicast input-port 1 start-udp-port 49152 processing-type passthru

The corresponding remap rule is shown below:

remap pid vcg vcg1
	     rf-channel 20
		vei-ip 198.51.100.1 udp-port 49152
		  pid 100-200 101-201
		  pid 102-130 202-230		
		  pid 131 240

rep-period

To configure the time between two ECM packets at the output, use the rep-period command in the DVB scrambling ECMG overrule configuration mode. To void the ECM repetition period configuration, use the no form of this command.

rep-period time

no rep-period

rep-period time

Specifies the ECM repetition period in milliseconds.

Command Default

None

Command Modes

DVB scrambling ECMG overrule configuration mode (config-video-encrypt-dvb-ecmg-overrule)

Release

Modification

IOS-XE 16.4.1

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command specifies the time between two ECM packets at the output in milliseconds. The valid range is from 0 to 30000.

Examples

The following is an example of how to configure the ECM repetition period in milliseconds:


Router>enable
Router#configure terminal
Router(config)#cable video
Router(config-video)#encryption
Router(config-video-encrypt)#dvb
Router(config-video-encrypt-dvb)#ecmg ECMG-7 id 7
Router(config-video-encrypt-dvb-ecmg)#overrule
Router(config-video-encrypt-dvb-ecmg-overrule)#rep-period 10000

report-stream-error cc-error

To enable Continuity Counter (CC) error reporting on the chassis level, use the report-stream-error cc-error command in video configuration mode.

report-stream-error cc-error [[report-interval value ] threshold value

Syntax Description

report-interval value

Specifies the event report interval in minutes.

threshold value

specifies the threshold value to report the event.

Command Default

None

Command Modes

Video configuration (config-video)

Command History

Release

Modification

IOS-XE Fuji 16.8.1

This command is introduced on the Cisco cBR Series Converged Broadband Routers.

Examples

This example shows how to enable CC error reporting on the chassis level:


Router#configure terminal
Router(config)#cable video
Router(config-video)# report-stream-error cc-error report-interval 10 threshold value 5 

report-stream-error input-stream-failure report-interval syslog

To configure a timeout value and syslog message for input stream failure trap for multicast sources, use the report-stream-error input-stream-failure report-interval syslog command in video configuration mode.

report-stream-error input-stream-failure report-interval timeout value syslog {enable | disable}

Syntax Description

timeout value

The interval after which input stream failure trap is sent if the input source down exceeds the configured timeout value. The timeout value range is 5–1800 seconds.

syslog

Enable or disable logging for for input stream stream failure trap.

Command Default

None

Command Modes

Video configuration (config-video)

Command History

Release

Modification

IOS-XE Fuji 16.8.1d

This command is introduced on the Cisco cBR Series Converged Broadband Routers.

Examples

This example shows how to configure a timeout value and syslog message:


Router#configure terminal
Router(config)#cable video
Router(config-video)# report-stream-error input-stream-failure report-interval 10 syslog enable  

request platform hardware diagnostic load

To load the field diagnostic image and start field diagnostic test, use the request platform hardware diagnostic load slot slot-id image-path [autostart] command in Privileged EXEC mode.

request platform hardware diagnostic load slot slot-id image-path [autostart]

Syntax Description

slot slot-id

Specifies the slot to perform field diagnostic test.

image-path

Specifies the path of the field diagnostic image, the image can be copied to hard disk, bootflash, or USB disk.

autostart

Automatically performs the default diagnostic test after loading the field diagnostic image.

Command Default

None.

Command Modes

Privileged EXEC (#)


Command History

Release

Modification

IOS-XE 3.18.0S

This command was introduced on Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The request platform hardware diagnostic load slot slot-id image-path [autostart] command loads the field diagnostic image and starts field diagnostic test.

Examples

The following example shows how to load the field diagnostic image and start field diagnostic test:


Router# request platform hardware diagnostic load slot 0 harddisk:field_diag autostart
Mar 2 16:00:51.933 CST: %IOSXE_OIR-6-REMCARD: Card (cc) removed from slot 0
Mar 2 16:00:51.934 CST: %CABLE_CLC-5-LOGGER_LC_REMOVED: Carrier Card 0 removed

request platform hardware diagnostic unload

To unload the field diagnostic image from the line card and reload the run-time image, use the request platform hardware diagnostic unload slot slot-id command in Privileged EXEC mode.

request platform hardware diagnostic unload slot slot-id

Syntax Description

slot slot-id

Specifies the slot to unload the field diagnostic image.

Command Default

None.

Command Modes

Privileged EXEC (#)


Command History

Release

Modification

IOS-XE 3.18.0S

This command was introduced on Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The request platform hardware diagnostic unload slot slot-id command unloads the field diagnostic image from the line card and reloads the run-time image.

Examples

The following example shows how to unload the field diagnostic image:


Router# request platform hardware diagnostic unload slot 0
Mar 2 16:04:51.860 CST: %IOSXE_OIR-6-INSCARD: Card (cc) inserted in slot 0

request platform software package expand

To expand the package to bootflash, use the request platform software package expand command in Privileged EXEC mode.

request platform software package expand file bootflash: [force | to bootflash: [force | wipe | [force]] | wipe | [force]]

Syntax Description

bootflash:

Expand the package to bootflash. Cisco cBR-8 router only boot from bootflash.

force

Proceed despite warnings.

wipe

Wipe destination media content first.

to

Location for contained files.

Command Default

None.

Command Modes

Privileged EXEC (#)

Command History

Release

Modification

IOS-XE 3.16.0S

This command was introduced on Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Use the request platform software package expand command in Privileged EXEC mode to expand the package to bootflash.

Examples

The following example shows hwo to expand the package to bootflash:


 router# request platform software package expand file bootflash:subpkg_3_16/cbrsup-universalk9.03.16.00.S.155-3.S-std.SPA.bin

request platform software package install node

To install the package for upgrade process, use the request platform software package install node command in Privileged EXEC mode.

request platform software package install node {abort | attach | file bootflash: [linecard-delay delay | [switchback] | noreload | [linecard]] | linecard-only {all | slot slot-number} | rollback}

Syntax Description

abort

Cancel the ISSU process.

attach

Enables the users to view the last run log that contains the reports of all the stages of the one-shot upgrade.

file

Consolidated package file on active bootflash.

linecard-delay delay

By default, all the line cards will be reloaded with 240s interval during the upgrade procedure. Use linecard-delay delay option to specify the linecard reload interval.

switchback

By default, the active SUP will change to standby SUP after the upgrade procedure is complete. Use the switchback option to switchover the active and standby SUP at the end of upgrade procedure, so that the active SUP remains to be the active SUP after ISSU.

noreload

With noreload option, both the SUP and linecard will not be reloaded during the upgrade procedure. Upgrade will take effect by the next system reboot. With noreload linecard option, only the linecard will not be reloaded during the upgrade procedure.

linecard-only

Upgrade linecard only.

rollback

Roll back the chassis to the previous image.

Command Default

None.

Command Modes

Privileged EXEC (#)

Command History

Release

Modification

IOS-XE 3.16.0S

This command was introduced on Cisco cBR Series Converged Broadband Routers.

IOS-XE 3.17.0S

This command was implemented on Cisco cBR Series Converged Broadband Routers. The abort, linecard-only and rollback keywords were added.

Usage Guidelines

Use the request platform software package install node command in Privileged EXEC mode to install the package for upgrade process, cancel the upgrade process, or rollback the chassis.

Examples

The following example shows how to install the package file:


 router# request platform software package install node file bootflash:subpkg_3_16/cbrsup-universalk9.03.16.00.S.155-3.S-std.SPA.bin

request platform software package install rp

To rollback to old package or implement ISSU subpackages upgrade on single SUP, use the request platform software package instal rp rp-slot rollback command in Privileged EXEC mode.

request platform software package install rp rp-slot {file bootflash: [interface-module-delay delay-seconds] | rollback [as-booted]}

Syntax Description

interface-module-delay delay-second

Specify the interface module restart timeout delay.

rollback

Un-do a previous install.

as-booted

Return to software provisioned at boot.

Command Default

None.

Command Modes

Privileged EXEC (#)

Command History

Release

Modification

IOS-XE 3.16.0S

This command was introduced on Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Use the request platform software package instal rp rp-slot rollback command in Privileged EXEC mode to rollback to old package.

Examples

The following example shows how to rollback the upgrade:


 router# request platform software package install rp 0 rollback

request platform software process restart

To restart processes in software platform, use the request platform software process restart command in Privileged EXEC mode.

request platform software process restart [ interval secs | slot slot-number ]

Syntax Description

interval secs

The interval between line card reload in seconds. Valid range is from 0 to 500.

slot slot-number

The line card slot number. The valid range is from 0 to 9.

Command Default

This command takes effect if the new iosd and iosdb, and the us-scheduler sub-packages have been previously installed on the Supervisor. Only line cards which are both active and primary will be affected.

Command Modes


Privileged EXEC (#)  

Command History

Release

Modification

IOS-XE 3.16.OS

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Use the request platform software process restart command only after installing new iosd, iosdb, and us-scheduler sub-packages on the Supervisor. This command will install the new sub-packages on the line cards and restarts the affected processes.

Examples

This example shows how to restart an isod process with an interval of 10 seconds:

Router# request platform software process restart interval 10 
    Restarting the process ubrclc_k9lc_ms
    SUCCESS: Finished Restarting the process ubrclc_k9lc_ms
    Will automatically restart process iosdb


This example shows how to restart a us-scheduler process:


Router#request platform software process restart slot 6 
    Restarting the process us-scheduler on slot 6
    SUCCESS: Finished Restarting the process us-scheduler on slot 6

Router#
*Jan 23 16:51:36.160 PDT: %CMCC_CBR-4-PROC_DOWN: CLC6: cmcc:  Process us-sched (cdman) is down
*Jan 23 16:51:36.506 PDT: %CMCC_CBR-4-PROC_RESTART: CLC6: cmcc:  Process us-sched (cdman) restarted. Please redo any config changes 
made during process restart
*Jan 23 16:51:39.737 PDT: lcpr_enqueue_reco_event: lc_slot=6 peer=6
*Jan 23 16:51:39.881 PDT: %CBR-4-RECONCL_CM_FINISH: Reconciliation (clc->sup) for slot 6 finished: total 31, success 31, failed 0, 
clc-only 0, sup-only 0, mismatch 0, offline 0

reserve-pid-range

To configure reserved output PID range, use the reserve-pid-range command in video configuration mode. To delete the reserved output PID range, use the no form of this command.

reserve-pid-range start-pid- end-pid

no reserve-pid-range start-pid- end-pid

Syntax Description

reserve-pid-range start-pid- end-pid

Specifies a range of PIDs that will not be used as output for remapped sessions.

Command Default

None.

Command Modes


Video configuration (config-video)

Command History

Release

Modification

IOS-XE 3.18.0S

This command is introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command configures reserved output PID range.

Examples

The following example shows how to configure reserved output PID range:


Router# configure terminal
Router(config)# cable video
Router(config-video)# reserve-pid-range 1-10

reset-interval

To set the default ONID number, use the default-onid command in the video configuration mode.

default-onid number

Syntax Description

number

The ONID number. By default, the system ONID is 0, which is commonly used in North America. If the default value of the ONID is used, the TSID must be unique. If you change the ONID, the TSID-ONID pair must be unique. The ONID must be in the range of 0 to 65535.

Command Default

None.

Command Modes

Video configuration mode (config-video)

Command History

Release Modification
Cisco IOS-XE Release 3.18.0S

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command is used to change the deault system ONID.

Examples

The following example shows how to change the default ONID number:

configure terminal 
cable video 
default-onid 1580 

restart-retry

To set the retry times for cable line card process restart, use the restart-retry times command in the process restart configuration mode.

restart-retry times

Syntax Description

times

Cable line card process restart retry times.

Command Default

None

Command Modes


Process restart configuration (config-process-restart)

Command History

Release

Modification

IOS-XE 3.18.0S

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command sets the retry times for cable line card process restart.

The following example shows how to set the retry times for cable line card process restart.


Router# configure terminal 
Router(config)# process-restart
Router(config-process-restart)# restart-retry 3

restricted

To convert a general load balancing group (GLBG) to a restricted load balancing group (RLBG) for DOCSIS load balancing, use the restricted command in the config-lb-group configuration mode. To revert to the general group type for DOCSIS load balancing, use the no form of this command.

restricted

no restricted

Command Default

By default, the general group type is selected for load balancing.

Command Modes


DOCSIS load balancing group mode (config-lb-group)

Command History

Release

Modification

12.2(33)SCC

This command was introduced.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Examples

The following example shows how to convert a GLBG to a RLBG using the restricted command.


Router# configure terminal 
Enter configuration commands, one per line.  End with CNTL/Z.
Router(config)# cable load-balance docsis-group 1
Router(config-lb-group)# restricted
Router(config-lb-group)# 

revertive

To enable the revert operation on a protect card, use the revertive command in line card redundancy group mode. To disable the revert operation, use the no form of the command.

revertive time

no revertive time

Syntax Description

time

Specifies the revert operation time in seconds. The valid values are 1 to 35791.

The valid values on the Cisco cBR series routers are 10 to 86400 seconds.

Command Default

None

Command Modes


Line card redundancy group (config-red-lc)

Command History

Release

Modification

12.2(33)SCA

This command was introduced in Cisco IOS Release 12.2(33)SCA.

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Examples

The following example shows how to specify the revert operation time for a protect card on a uBR10012 router:


Router# configure terminal
Router(config)# redundancy
Router(config-red)# linecard-group 1 cable
Router(config-red-lc)# revertive 30

The following example shows how to specify the revert operation time on a Cisco cBR series router:


Router# configure terminal
Router(config)# redundancy
Router(config-red)# linecard-group 0 internal-switch
Router(config-red-lc)# revertive 30

rf-chan

To enter the RF channel sub configuration mode to configure an individual channel or a block of channels, use the rf-chan command in the controller sub configuration mode.

rf-chan starting QAM id ending QAM id

Syntax Description

starting QAM id

The starting QAM ID. The valid range is 0 to 127.

ending QAM id

The ending QAM ID. The valid range is 0 to 127.

Command Default

None.

Command Modes

Controller sub configuration mode (config-controller)

Command History

Release

Modification

IOS-XE 3.15.0S

This command is introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command is used to enter the RF channel configuration sub-mode. If an individual channel is specified, only that channel's configuration is changed. If a block of channels is specified, the configuration change is applied to all the channels in the block.

Examples

The following example shows how to enter into the RF channel configuration sub-mode:

router#configure terminal 
router(config)#controller integrated-cable 3/0/0
router(config-controller)#rf-chan 0 2
router(config-rf-chan)#frequency 93000000
router(config-rf-chan)#exit
router(config-controller)#exit
router#show controller integrated-Cable 3/0/0 rf-channel 0-2

Chan State Admin Frequency  Type   Annex Mod  srate Interleaver  dcid  power  output
0     UP   UP   93000000   DOCSIS  B    256   5361  I32-J4       1    34     NORMAL
1     UP   UP   99000000   DOCSIS  B    256   5361  I32-J4       2    34     NORMAL
2     UP   UP   105000000  DOCSIS  B    256   5361  I32-J4       3    34     NORMAL 

rf-channel

To enter the RF channel sub configuration mode to configure an individual channel, use the rf-channel command in the controller sub configuration mode.

rf-channel number

number

Identifies an RF channel and enters the RF channel sub configuration mode. The valid values are

Command Default

None

Command Modes

Controller sub configuration mode (config-controller)

Release

Modification

IOS-XE 3.18.0SP

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Examples

The following is an example of how to enter the RF channel sub configuration mode:


Router>enable
Router#configure terminal
Router(config)#cable video
Router(config-video)#table-based
Router(config-video-tb)#vcg vcg1
Router(config-video-tb-vcg)#rf-channel 20

rf-channel (Virtual Carrier Group)

To specify the virtual RF channels in a virtual carrier group, use the rf-channel command in virtual carrier group configuration mode. To delete the virtual RF channels, use the no form of this command.

rf-channel start-channel- end-channel tsid start-tsid- end-tsid output-port-number start-port- end-port

no rf-channel start-channel- end-channel tsid start-tsid- end-tsid output-port-number start-port- end-port

Syntax Description

rf-channel start-channel- end-channel

Specifies the RF channel range.

tsid start-tsid- end-tsid

Specifies the tsid range.

output-port-number start-port- end-port

Specifies the output port range.

Command Default

None.

Command Modes


Virtual carrier group configuration (config-video-vcg)

Command History

Release

Modification

IOS-XE 3.18.0S

This command is introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command specifies the virtual RF channels.

Examples

The following example shows how to specify the virtual RF channels:


Router# configure terminal
Router(config)# cable video
Router(config-video)# virtual-carrier-group vod id 1
Router(config-video-vcg)# rf-channel 1-11 tsid 1-11 output-port-number 1-11

rf-channel (table-based vcg)

To configure the rf channel in the table-based session, use the rf-channel command in the table-based VCG configuration mode. To delete the configuration, use the no form of this command.

rf-channel start_channel[- end_channel]

start_channel- end_channel

Specifies the range of rf channels for the table-based session.

Command Default

None

Command Modes

Table-based VCG configuration mode (config-video-tb-vcg)

Release

Modification

Cisco IOS-XE 16.5.1

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Examples

The following is an example of how to configure the rf channel in the table-based session:


Router>enable
Router#configure terminal
Router(config)#cable video
Router(config-video)#table-based
Router(config-video-tb)#vcg vcg1
Router(config-video-tb-vcg)#rf-channel 0-7

rf-channel cable downstream channel-id

To assign a downstream channel ID to an RF channel, use the rf-channel cable downstream channel-id command in controller configuration mode. To remove a downstream channel ID for an RF channel, use the no form of this command.

rf-channel rf-port cable downstream channel-id channel-id

no rf-channel rf-port cable downstream channel-id channel-id

Syntax Description

rf-port

Specifies the RF channel physical port on the Wideband SPA FPGA. Valid values for rf-port depend on the configuration set with the annex modulation command.

channel-id

A unique channel ID. Valid values for releases prior to Cisco IOS Release 12.2(33)SCB are from 0 to 255 and the valid values for Cisco IOS Release 12.2(33)SCB and later are from 1 to 255 as 0 is reserved for network management.

Command Default

If the rf-channel cable downstream channel-id command is not issued, Cisco IOS software assigns a unique downstream channel ID to the RF channel.

Command Modes


Controller configuration (config-controller)

Command History

Release

Modification

12.3(21)BC

This command was introduced for the Cisco uBR10012 router.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA.

12.2(33)SCB1

The downstream channel ID scheme was changed.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

For the wideband channel to work correctly, each RF channel on the fiber node that the wideband channel uses must have a unique downstream channel ID. By default, Cisco IOS software assigns a unique downstream channel ID to the RF channel. Use the rf-channel cable downstream channel-id command to change the default channel ID.

The downstream channel ID that is assigned to the RF channel must be unique on the fiber node.

  • The ID cannot be the same ID as is used for another RF channel on the fiber node.
  • The ID cannot be the same ID as is used for a primary downstream channel on the fiber node.

You can check downstream channel IDs that are being used by examining the CMTS router configuration file.

Refer to cable downstream channel-id id command for the updated downstream channel ID scheme table.


Note


If you assign a downstream channel ID that is not unique on the fiber node, the rf-channel cable downstream channel-id command displays an error message. The command does assign the channel ID, but the status of the fiber node becomes invalid.

The Cisco uBR10012 router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF channels depending on how the SPA is configured with the annex modulation command.

  • For annex A and 256 QAM, each Wideband SPA supports 18 RF channels. In this case, valid values for the rf-port argument are 0 to 17.
  • For all other cases, the SPA supports 24 RF channels. In these cases, valid values for the rf-port argument are 0 to 23.

Note


Effective with Cisco IOS Release 12.3(23)BC, the annex modulation command is obsolete and annex and modulation are included as keyword options in the rf-channel frequency command. Also, for annex A and 256 QAM, each Wideband SPA supports up to 18 RF channels at full rate or up to 24 RF channels at less than full rate.

Examples

The following example shows how to assign a downstream channel ID of 123 to RF channel 3 on the Wideband SPA located in slot/subslot/bay 1/0/1.


Router# configure terminal
 
Router(config)# controller modular-cable 1/0/1 
Router(config-controller)# rf-channel 3 cable downstream channel-id 123
 

rf-channel depi-tunnel

To bind the depi-tunnel, which inherits the configuration of the specified l2tp-class and depi-class, to an rf-channel on a shared port adapter (SPA), use the rf-channel depi-tunnel command in controller configuration mode. The tsid keyword is used to associate the logical rf-channel of the SPA to a physical quadrature amplitude modulation (QAM) on the radio frequency gateway (RFGW-10). To unbind the depi-tunnel, use the no form of this command.

rf-channel rf-channel depi-tunnel depi-tunnel-name tsid id

no rf-channel rf-channel depi-tunnel depi-tunnel-name tsid id

Syntax Description

rf-channel

RF channel physical port on the Wideband SPA. The allowed range is from 0 to 3.

depi-tunnel-name

Name of the DEPI tunnel.

tsid id

TS ID value.

Command Default

None

Command Modes


Global configuration (config)


Subinterface configuration (config-subif)

Command History

Release

Modification

12.2(33)SCC

This command was introduced.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

To configure DEPI on the M-CMTS, bind the depi-tunnel to an rf-channel on a SPA using the rf-channel depi-tunnel command in controller configuration mode. To associate the logical rf-channel on the SPA to a QAM on the RFGW, use the tsid keyword.

Examples

The following example shows how to bind the depi-tunnel SPA0 to rf-channel 0 on a SPA and associate tsid 100 to the QAM:


Router# configure terminal
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# rf-channel 0 depi-tunnel SPA0 tsid 100

rf-channel description

To configure the description of an RF channel on a Wideband SPA, use the rf-channel description command in controller configuration mode. To remove an RF channel configuration, use the no form of this command.

rf-channel rf-port description description

no rf-channel rf-port description description

Syntax Description

rf-port

Specifies the RF channel physical port on the Wideband SPA FPGA. Allowed range is 0 to 23. Valid values for rf-port depend on the configuration set with the annex modulation command (see the Usage Guidelines section).

description description

Specifies a description for the RF channel.

Command Default

No default RF channel configuration values are set for the description.

Command Modes


Controller configuration (config-controller)

Command History

Release

Modification

12.3(21)BC

This command was introduced for the Cisco uBR10012 router.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The Cisco uBR10012 router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF channels depending on how the SPA is configured with the annex modulation command. For annex A and 256 QAM, each Wideband SPA supports up to 18 RF channels at full rate and up to 24 RF channels at less than full rate. For all other cases, the SPA supports 24 RF channels.


Note


In Cisco IOS Release 12.3(21)BC, annex and modulation parameters were set globally for each SPA using the annex modulation command. Beginning in Cisco IOS Release 12.3(23)BC, annex and modulation values are set for each RF channel using the rf-channel frequency command. The annex modulation command is obsolete.

Examples

The following example shows how to configure the description of the RF channel characteristics for RF port 0:


Router# configure terminal
 
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# rf-channel 0 description Primary downstream channel

rf-channel frequency

To configure the frequency of an RF channel on a wideband interface, use the rf-channel frequency command in controller configuration mode. To remove the frequency of an RF channel configuration, use the no form of this command.

Cisco IOS Releases 12.3(21)BC and 12.2(33)SCA

rf-channel rf-port frequency freq

no rf-channel rf-port frequency

Cisco IOS Releases 12.3(23)BC and 12.2(33)SCB

rf-channel rf-port frequency freq [annex {A | B} modulation {64 | 256} [interleave-depth {8 | 12 | 16 | 32 | 64 | 128}]]

no rf-channel rf-port frequency

Syntax Description

rf-port

Specifies the RF channel physical port on the Wideband SPA FPGA. Allowed range is 0 to 23. Valid values for rf-port depend on the configuration set with the annex modulation command (see the Usage Guidelines section).

freq

Sets the center frequency for the RF channel. Allowed range is 55000000 to 1050000000 MHz.

annex {A | B }

Specifies the MPEG framing format for each RF channel:

  • A –Annex A. The downstream is compatible with the European MPEG framing format specified in ITU-TJ.83 Annex A.
  • B –Annex B. The downstream is compatible with the North American MPEG framing format specified in ITU-TJ.83 Annex B.

modulation {64 | 256 }

Specifies the modulation rate for each RF channel:

  • 64 –64-QAM
  • 256 –256-QAM

interleave-depth {8 | 12 | 16 | 32 | 64 | 128 }

Indicates the downstream interleave depth. The default value is 32.

Command Default

No default RF channel configuration values are set for frequency, annex, and modulation.

Command Modes


Controller configuration (config-controller)


Command History

Release

Modification

12.3(21)BC

This command was introduced for the Cisco uBR10012 router.

12.3(23)BC

The following keyword options were added:

  • annex
  • modulation
  • interleave-depth

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. The annex , modulation , and interleave-depth keyword options are not supported.

12.2(33)SCB

The annex , modulation , and interleave-depth keyword options are supported.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Cisco IOS Release 12.3(21)BC and Cisco IOS Release 12.2(33)SCA

This command configures the frequency for an RF channel on a Wideband SPA.

The Cisco uBR10012 router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF channels depending on how the SPA is configured with the annex modulation command. For annex A and 256 QAM, each Wideband SPA supports up to 18 RF channels. For all other cases, the SPA supports up to 24 RF channels.


Note


In Cisco IOS 12.3(21)BC and 12.3(21a)BC3 releases, annex and modulation parameters were set globally for each SPA using the annex modulation command. Beginning in Cisco IOS Release 12.3(23)BC, annex and modulation values are set for each RF channel using the rf-channel frequency command. The annex modulation command is obsolete.

Cisco IOS Releases 12.3(23)BC and 12.2(33)SCB

This command configures the frequency for an RF channel on a Wideband SPA. The Cisco uBR10012 router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF channels. For annex A and 256 QAM, each Wideband SPA supports up to 18 RF channels at full rate. For all other cases, the SPA supports up to 24 RF channels.

For each RF channel, use the rf-channel frequency command in controller configuration mode to configure RF-channel characteristics. For Cisco IOS Release 12.3(21)BC, for each RF channel (rf-port ), the frequency option must be configured with the rf-channel frequency command.

Uniqueness of frequency is required for all cable downstream channels on all cable interfaces and all Wideband SPAs on the CMTS.


Note


Be certain to verify that the RF channel values set with rf-channel frequency match the values configured for the QAM outputs on the edge QAM device.The frequency value must match. If the value does not match, the Wideband SPA will not successfully communicate with the edge QAM device.

Cisco IOS Release 12.2(33)SCE

In Cisco IOS Release 12.2(33)SCE and later, changing the frequency of a single RF channel in a controller will change the frequency of all RF channels in that controller. In the event of the frequency change, all DOCSIS 3.0 cable modems will start re-registering in downstream partial service mode (p-online).

Examples

The following example shows how to configure RF channel frequency for RF port 0:


Router# configure terminal
 
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# rf-channel 0 frequency 699000000 annex A modulation 256 interleave-depth 64

rf-channel group-address

To configure the DEPI multicast group address for the RF channel, use the rf-channel group-address command in controller configuration mode. To disable the configuration, use the no form of the command.

rf-channel rf-number group-address ip-address

no rf-channel rf-number group-address

Syntax Description

rf-number

RF channel number. The range is from 0 to 23.

ip-address

DEPI multicast group IP address.

Command Default

The DEPI multicast group address is not configured for the RF channel.

Command Modes

Controller configuration (config-controller)

Command History

Release

Modification

12.2(33)CX

This command was introduced.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The rf-channel group-address command provides upstream and downstream mapping information for a specific channel group.

Examples

The following example shows how to configure the DEPI multicast group address for RF channel 0:

Router# configure terminal
Router# controller Modular-Cable 8/1/0
Router(config-controller)# rf-channel 0 group-address 224.0.0.1 

rf-channel ip-address mac-address udp-port

To configure the IP address, MAC address, UDP port and DEPI remote ID of an RF channel on a Wideband SPA, use the rf-channel ip-address mac-address udp-port command in controller configuration mode. To remove the IP address, MAC address, UDP port and DEPI remote ID configuration of an RF channel, use the no form of this command.

Cisco IOS Releases 12.3(21)BC and 12.2(33)SCA

rf-channel rf-port ip-address ip-address mac-address mac-address udp-port portnum

no rf-channel rf-port ip-address ip-address mac-address mac-address udp-port portnum

Cisco IOS Releases 12.3(23)BC and 12.2(33)SCB

rf-channel rf-port ip-address ip-address mac-address mac-address {udp-port portnum | depi-remote-id session-id}

no rf-channel rf-port ip-address ip-address mac-address mac-address {udp-port portnum | depi-remote-id session-id}

Syntax Description

rf-port

Specifies the RF channel physical port on the Wideband SPA FPGA. Allowed range is 0 to 23. Valid values for rf-port depend on the configuration set with the annex modulation command (see the Usage Guidelines section).

ip-address

Specifies the IP address of the Gigabit Ethernet interface on the edge QAM device for this RF channel.

mac-address

Specifies the MAC address of the next-hop interface or of the edge QAM device for this RF channel.

portnum

Specifies the UDP port number for the edge QAM device that will be used for this RF channel. Allowed range is 0 to 65535.

session-id

Specifies the DEPI remote session ID to be used for encapsulation of frames in DOCSIS-MPT mode.

Command Default

None

Command Modes


Controller configuration (config-controller)

Command History

Release

Modification

12.3(21)BC

This command was introduced for the Cisco uBR10012 router.

12.3(23)BC

The depi-remote-id keyword option was added.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. The depi-remote-id keyword option is not supported.

12.2(33)SCB

The depi-remote-id keyword option is supported.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

For each RF channel, use the rf-channel ip-address mac-address udp-port command in controller configuration mode to configure RF-channel characteristics.

The Cisco uBR10012 router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF channels depending on how the SPA is configured with the annex modulation command. For annex A and 256 QAM, each Wideband SPA supports up to18 RF channels. For all other cases, the SPA supports up to 24 RF channels.


Note


In the Cisco IOS Release 12.3(21)BC and 12.3(21a)BC3 releases, annex and modulation options were set globally for each SPA using the annex modulation command. Beginning in Cisco IOS Release 12.3(23)BC, annex and modulation values are set for each RF channel using the rf-channel frequency command. The annex modulation command is obsolete.

For each RF channel (rf-port ), the following items must be configured with rf-channel ip-address mac-address udp-port command:

Cisco IOS Release 12.3(21)BC and Cisco IOS Release 12.2(33)SCA

  • IP address
  • MAC address
  • UDP port
  • Associated wideband channel (see the cable rf-channel command)

Cisco IOS Releases 12.3(23)BC and 12.2(33)SCB

  • IP address
  • MAC address
  • UDP port or DEPI remote ID
  • Associated wideband channel (see the cable rf-channel command)

The value used for mac-address in the mac-address argument is as follows:

  • If a Gigabit Ethernet router or Layer 3 switch is used between the Wideband SPA and the edge QAM device, the value specified for mac-address is the MAC address for the next-hop interface on the router or Layer 3 switch.
  • If a Gigabit Ethernet router or Layer 3 switch is not used, the value specified for mac-address is the MAC address for the Gigabit Ethernet interface on the edge QAM device.

The UDP port number set for the RF channel allows mapping an input UDP session to a specific QAM output port. Wideband traffic from different Wideband SPAs cannot be mixed on the same QAM output ports.


Note


Be certain to verify that the RF channel values set with rf-channel frequency match the values configured for the QAM outputs on the edge QAM device. IP address, MAC address, UDP port, and DEPI remote ID must match. If any of these values do not match, the Wideband SPA will not successfully communicate with the edge QAM device.

Examples

The following example shows how to configure the RF channel IP address, MAC address UDP port and DEPI remote ID characteristics for RF port 0:


Router# configure terminal
 
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# rf-channel 0 ip-address 192.168.200.30 mac-address
0011-920e-a9ff udp-port 49152 

rf-channel network-delay

To configure the network delay for an RF channel on a Wideband SPA, use the rf-channel network delay command in controller configuration mode. To remove the network delay configuration for an RF channel, use the no form of this command.

rf-channel rf-port network-delay delay [sampling-rate rate]

no rf-channel rf-port network-delay delay [sampling-rate rate]

Syntax Description

rf-port

RF channel physical port on the Wideband SPA FPGA. The allowed range is from 0 to 23. The valid values for rf-port depend on the configuration set with the annex modulation command (see the Usage Guidelines section).

delay

Converged Interconnect Network (CIN) delay. The default value is 550 us. The allowed range is from 0 to 3000 us. The delay value auto determines the delay through DEPI Latency Measurement (DLM) packets.

sampling-rate rate

(Optional) Specifies how often the DLM is sent. The range is from 1 to 500 sec. The default value is 10 sec. This option is available only when the delay value is set to auto.

Command Default

None

Command Modes


Controller configuration (config-controller)

Command History

Release

Modification

12.3(23)BC

This command was introduced for the Cisco uBR10012 universal broadband router.

12.2(33)SCB

This command was integrated into Cisco IOS Release 12.2(33)SCB.

12.2(33)SCC

This command was modified to include sampling-rate rate to specify how often the DLM is sent.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The Cisco uBR10012 universal broadband router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF channels depending on how the SPA is configured with the annex modulation command. For annex A and 256 QAM, each Wideband SPA supports up to18 RF channels. For all other cases, the SPA supports up to 24 RF channels.


Note


In Cisco IOS releases 12.3(21) BC and 12.3(21a)BC3, annex and modulation parameters were set globally for each SPA using the annex modulation command. From Cisco IOS Release 12.3(23)BC onwards, annex and modulation values are set for each RF channel using the rf-channel frequency command. The annex modulation command is obsolete.

Examples

The following example shows how to configure the RF channel network delay characteristics for RF port 0:


Router# configure terminal
 
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# rf-channel 0 network-delay 1000

The following example shows how to configure the RF channel network delay characteristics for RF port 0 with a sampling-rate of 1sec:


Router# configure terminal
 
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# rf-channel 0 network-delay auto sampling-rate 1

rf-channel rf-power

To set the RF power output level on Cisco UBR-MC20X20V and Cisco uBR-MC88V cable interface line cards, use the rf-channel rf-power command in controller configuration mode. To reset the RF output power level to its default value, use the no form of this command.

rf-channel rf-port rf-power power-level

no rf-channel rf-port rf-power power-level

Syntax Description

rf-port

RF channel physical port on the Wideband SPA FPGA. The range is from 0 to 3. The values for rf-port depend on the configuration set with the annex modulation command.

power-level

Desired RF output power level in dBmV. The range is dependent on the cable interface line card. The format is XY.Z. By default, .Z is added as .0.

Command Default

None

Command Modes


Controller configuration (config-controller)

Command History

Release

Modification

12.2(33)SCC

This command was introduced.

12.2(33)SCD

This command was modified. Added support for the controller interface configuration on Cisco uBR7246VXR and Cisco uBR7225VXR universal broadband routers.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

For the Cisco UBR-MC20X20V cable interface line card, all the channels within a controller must have the same RF power value. When the RF power value is changed on any one channel, the same value is applied to all the channels within the controller. The recommended RF power range depends on the mode of the upconverter. The mode of the upconverter is decided by the highest numbered channel that is enabled.


Note


RF power value outside the recommended RF power range is accepted but is automatically adjusted. If the input value exceeds the recommended RF power range, it is adjusted to a value lower than the upper limit of the range and if it is less than the recommended range, it is adjusted to a value higher than the lower limit of the range. The RF power level can be configured in decimals too.

Table below lists the recommended RF power range for different channel settings on the Cisco UBR-MC20X20V line card.

Table 1. RF Power Range on the Cisco UBR-MC20X20V Line Card

Upconverter Mode

Channel Setting

Recommended RF Power Range

Single

Only channel 0 is enabled

60.0 to 52.0 dBmV

Dual

Channel 0 is either enabled or disabled. Channel 1 is enabled.

Channel 2 and channel 3 are disabled.

56.0 to 48.0 dBmV

Triple

Channel 0, and channel 1 are either enabled or disabled.

Channel 2 is enabled and channel 3 is disabled.

54.0 to 46.0 dBmV

Quad

Channels 0, 1, and 2 are either enabled or disabled. Channel 3 is enabled.

52.0 to 44.0 dBmV

Table below lists the recommended RF power range for different channel settings on the Cisco uBR-MC88V line card.

Table 2. RF Power Range on the Cisco uBR-MC88V Line Card

Upconverter Mode

Channel Setting

Recommended RF Power Range

Single

The RF channel stacking number equals to 1 in this mode. Channel 0 is enabled while the other channels are disabled.

45 to 63 dBmV

Dual

The RF channel stacking number equals to 2 in this mode. Channels 0 and 1 are enabled; channels 2 and 3 are disabled.

48 to 56 dBmV

Triple

The RF channel stacking number equals to 3 in this mode. Channels 0, 1, and 2 are enabled; channel 3 is disabled.

46 to 54 dBmV

Quad

The RF channel stacking number equals to 4. Channels 0, 1, 2, and 3 are enabled.

44 to 52 dBmV

Examples

The following example shows how to configure RF power for RF port 0 in modular-cable controller mode:


Router# configure terminal
 
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# rf-channel 0 rf-power 50.6

The following example shows how to configure RF power for RF port 0 in integrated-cable controller mode:


Router# configure terminal
 
Router(config)# controller integrated-cable 1/0/0
Router(config-controller)# rf-channel 0 rf-power 50.6

rf-channel rf-shutdown

To disable the RF output on a wideband interface, use the rf-channel rf-shutdown command in controller configuration mode. To enable the RF output, use the no form of this command.

rf-channel rf-port rf-shutdown

no rf-channel rf-port rf-shutdown

Syntax Description

rf-port

Specifies the RF channel physical port. The range is from 0 to 3. The valid values for rf-port depend on the configuration set with the annex modulation command.

Command Default

RF output is disabled.

Command Modes


Controller configuration (config-controller)

Command History

Release

Modification

12.2(33)SCC

This command was introduced.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Starting with Cisco IOS Release 12.2(33)SCE, when you use the rf-channel rf-shutdown command, all DOCSIS 3.0 cable modems associated with the RF channel on a particular wideband interface will go offline and start re-registering in downstream partial service mode (p-online). In Cisco IOS Release 12.2(33)SCD and earlier, cable modems do not go offline while using the rf-channel rf-shutdown command.

For muting and unmuting the QAM on the Cisco RFGW-10, use the rf-channel rf-shutdown command in the M-CMTS.


Note


This command cannot be executed on a Cisco 1 Gbps Wideband Shared Port Adapter (SPA) configured with manual DEPI.


Examples

The following example enables RF output on the Cisco wideband SPA:


Router# enable
 
Router# configure terminal
Router(config)# controller integrated-cable 7/1/0
Router(config-controller)# no rf-channel 0 rf-shutdown

rf-channel stacking

To suppress a carrier or mute a radio frequency (RF) channel on the Cisco uBR-MC88V cable interface line card, use the rf-channel stacking command in controller configuration mode. To remove the configuration, use the no form of this command.

rf-channel stacking stacking-number

no rf-channel stacking stacking-number

Syntax Description

stacking-number

RF channel stacking number. The range is from 1 to 4. The default value is 4.

Command Default

The RF channel stacking number is set to 4.

Command Modes


Controller configuration (config-controller)

Command History

Release

Modification

12.2(33)SCD

This command was introduced.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

If you change the default stacking number configuration, traffic loss may occur on the active channels. For example, if you change the stacking number from 4 to 2, traffic is interrupted on the RF channels 0 and 1. However, traffic loss does not occur if you do not change the stacking number configuration when shutting down an RF channel using the rf-channel rf-shutdown rf-channel rf-shutdown command.


Note


We recommend that you do not change the default stacking number configuration. You can change the default configuration when you want RF diagnostics performed on a particular channel. For example, if you want to perform RF diagnostics on RF channel 2, you need to change the default stacking number configuration to 2 to completely mute this channel.

Examples

The following example shows how to configure the RF channel stacking number for the Cisco uBR-MC88V cable interface line card:


Router# configure terminal
 
Router(config)# controller integrated-cable 5/1
Router(config-controller)# rf-channel stacking 3

rf-output

To define the output mode for the RF channel, use the rf-output command in the RF channel sub configuration mode.

rf-output { normal | alt | cw | prbs}

Syntax Description

normal

Normal mode for production operation.

alt

Alternating symbol (two-tone). Diagnostic mode for hardware testing.

cw

Continuous Wave. Diagnostic mode for hardware testing.

prbs

Pseudo Random Binary Sequence. Diagnostic mode for hardware testing.

Command Default

None.

Command Modes

RF channel sub configuration mode (config-rf-chan)

Usage Guidelines

This command is used to define the output mode for the RF channel.

Examples

The following example shows how to change the output mode:

router#configure terminal 
router(config)#controller integrated-cable 3/0/0
router(config-controller)#rf-chan 5 10
router(config-rf-chan)#frequency 723000000
router(config-rf-chan)#rf-output alt
router(config-rf-chan)#exit
router(config-controller)#exit
router(config)#exit
router#show controller integrated-Cable 3/0/0 rf-channel 5 10
Chan State Admin Frequency  Type   Annex Mod  srate Interleaver  dcid  power  output
 5   TEST   UP   723000000  DOCSIS  B    256   5361  I32-J4       164  34     ALT
 10  TEST   UP   753000000  DOCSIS  B    256   5361  I32-J4       169  34     ALT

rf-port integrated-cable

To define the physical slot/bay/port to be used in a video service, to define the Service Distribution Group (SDG) use the rf-port integrated-cable command in the service distribution group configuration mode. To delete the physical slot/bay/port, use the no form of the command.

rf-port integrated-cable slot/ bay/ port

Syntax Description

slot

The line card slot number. Slot can be configured from 0-3 or 6-9. Slots 4 and 5 are the supervisor slots.

bay

The Cisco cBR-8 chassis number. This is always configured as 0.

port

The RF port number. This can be configured from 1-8.

Command Default

None.

Command Modes

Service distribution group configuration mode (config-video-sdg)

Command History

Release Modification
Cisco IOS-XE Release 3.18.0S

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command is used to define the physical slot/bay/port to be used in a video service, to define the SDG. To configure QAM replication for service group size alignment between the DOCSIS and video services to one or more ports, you can add more ports into the service distribution group configuration. Make sure that the controller type is video for the slot/bay/port that you would use for the SDG. For more information, see the Video QAM Carriers section here: http://www.cisco.com/c/en/us/td/docs/cable/cbr/configuration/guide/b_cbr_basic_config_prov_construct/video_qam_carriers.html.

Examples

The following example shows how to define the physical slot/bay/port :

router#configure terminal 
router(config)#cable video 
router(config-video)#service-distribution-group sdgid 1 
router(config-video-sdg)#rf-port integrated-cable 7/0/0 
router(config-video-sdg)#rf-port integrated-cable 7/0/1 

rf-switch auxport enable

To enable the AUX port of the RF switch, use the rf-switch auxport enable command in redundancy mode. To disable the AUX port, use the no form of this command.

rf-switch auxport enable

no rf-switch auxport

Syntax Description

enable

Enables the Cisco NGRFSW-ADV. In the default configuration, the Cisco NGRFSW-ADV is disabled. When the Cisco NGRFSW-ADV is enabled, the Cisco CMTS router starts polling the Cisco NGRFSW-ADV at a set interval to check its status.

Command Default

The AUX port of the Cisco NGRFSW-ADV is disabled by default.

Command Modes


Redundancy mode (config-red)

Command History

Release

Modification

12.2(33)SCG

This command was introduced.

IOS-XE 3.15.0S

This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Examples

The following example shows how to enable the AUX port of the Cisco NGRFSW-ADV:


Router> enable
Router# configure terminal
Router(config)# redundancy
Router(config-red)# linecard-group 1 cable
Router(config-red-lc)# rf-switch auxport enable

The rf-switch auxport enable command is used to configure the Cisco uBR Advanced RF Switch (NGRFSW-ADV). See Cisco uBR Advanced RF Switch Software Configuration Guide .

roll-off

To specify the channel roll-off value, use the roll-off command in OFDM channel profile configuration mode. To undo the channel roll-off value assignment, use no form of this command.

roll-off value

no profile-control

Syntax Description

value

The channel roll-off value. Valid values are 64, 128, 192, and 256.

Command Default

128

Command Modes


OFDM channel profile configuration (config-ofdm-chan-prof)

Command History

Release

Modification

IOS-XE 3.18.0SP

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Use this command to specify the channel roll-off value.

Examples

The following example shows how to specify the channel roll-off value:


Router# configure terminal
Router(config)# cable downstream ofdm-chan-profile 21
Router(config-ofdm-chan-prof)# roll-off 128

route-ecmg

To configure the route to the ECMG server for session based scrambling, use the route-ecmg command in the DVB scrambling configuration mode. To void the route configuration, use the no form of this command.

route-ecmg ip_address netmask interface forwarding_router_ip

no route-ecmg ip_address netmask interface forwarding_router_ip

ip_address

Specifies the IP address of the ECMG server.

netmask

Specifies the netmask of the connection.

interface

Specifies the interface of the connection.

forwarding_router_ip

Specifies the IP address of the forwarding router.

Command Default

None

Command Modes

DVB scrambling configuration mode (config-video-encrypt-dvb)

Release

Modification

IOS-XE 16.4.1

This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Examples

The following is an example of how to configure the route to the ECMG server:


Router>enable
Router#configure terminal
Router(config)#cable video
Router(config-video)#encryption
Router(config-video-encrypt)#dvb
Router(config-video-encrypt-dvb)#route-ecmg 1.200.1.0 255.255.255.0 TenGigabitEthernet 4/1/2 1.200.1.1

routing-interface-ip

To automatically configure IP addresses of line card video interfaces from a pool of IP addresses that you provide, use the routing-interface-ip command.

routing-interface-ip ip-address ip-mask { secondary | | ip-address | | ip-mask }

Syntax Description

ip-address

Specifies the starting IP address of the line card video interfaces.

ip-mask

Specifies the IP mask IP address.

secondary

Specifies the secondary interface of the line card video interfaces.

Command Modes

Video configuration mode (config-video)

Command History

Release Modification

IOS-XE 3.15.0S

This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Do not change the video interface IP configuration unless there are conflicts with customer subnets.

Video interface IP configuration is optional. By default, the Cisco cBR-8 uses 10.100.x.x subnets for primary IP addresses and 10.101.x.x subnets for secondary IP addresses of video interfaces. By default, all video interfaces are in the VRF Mgmt-MPEG-video-intf.

Configure the video interface IP before configuring any other video-specific configurations like logical edge device and virtual service group configurations. Use the routing-interface-ip only when the default configuration conflicts with the existing subnets in the network.

routing-interface-vrf

To configure user-specific VRF to line card video interfaces, use the routing-interface-vrf command in video configuration mode. To remove the user-specific VRF configuration, use the no form of this command.

routing-interface-vrf slot slot vrf-name vrf-name

Syntax Description

slot

Slot where the line card resides. The valid range is 0–3 and 6–9.

vrf-name

Name of the user-specific VRF

Command Modes

Video configuration mode (config-video)

Command History

Release Modification