Cisco CMTS Cable Command Reference

identifier

To configure the MAC address of the RPD, use the identifier command in RPD configuration mode. To void the MAC address configuration, use the no form of this command.

identifier mac_address

no identifier

Syntax Description


`mac_address`	Specifies the MAC address of the RPD.

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 configure the MAC address of the RPD.

Examples

The following example shows how to configure the MAC address of the RPD:

Router# configure terminal
Router(config)# cable rpd 1
Router(config-rpd)# identifier 0004.9f03.0214

Related Commands


Command	Description
cable rpd	Enters the RPD configuration mode.

init-tech-list

To set the DCC initialization techniques that the CMTS can use to load balancing cable modems, use the init-tech-list command in the config-lb-group configuration mode. To reset the DCC initialization techniques, use the no form of this command.

init-tech-list grouplist [ucc]

no init-tech-list

Syntax Description


`grouplist`	DCC initialization technique list.
ucc	(Optional) Determines whether Upstream Channel Change (UCC) can be used for modems during dynamic upstream load balancing.

Command Default

No default behavior or values.

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.OS	This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Examples

The following example shows how to set the DCC initialization techniques on a DOCSIS load balancing group on the CMTS, using the init-tech-list 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)# init-tech-list 1 ucc
Router(config-lb-group)#

Related Commands


Command	Description
cable load-balance docsis-group	Configures a DOCSIS load balancing group on the CMTS.
show cable load-balance docsis-group	Displays real-time configuration, statistical, and operational information for load balancing operations on the router.

init-tech-ovr

To set DCC initialization techniques that override the physical upstream channel pair, use the init-tech-ovr command in the config-lb-group configuration mode.

Cisco uBR10012 Router

init-tech-ovr cable slot/subslot/port upstream cable slot/subslot/port upstream init-tech-list init-tech-list 0 -4 [ucc]

Cisco uBR7225VXR and Cisco uBR7246VXR Routers

init-tech-ovr cable slot/subslot/port upstream cable slot/subslot/port upstream init-tech-list init-tech-list 0 -4 [ucc]

Syntax Description


cable `slot/subslot/port` `upstream`	Specifies the CMTS interface slot, subslot, port number, and upstream parameters that are to be overridden. `slot` —Slot where the line card resides. The permitted range is from 5 to 8. `subslot` —Subslot where the line card resides. The available slots are 0 or 1. `port` —The downstream controller number on the line card. The permitted `port` range is from 0 to 4.
cable `slot/subslot/port` `upstream`	Specifies the CMTS interface slot, subslot, port number, and upstream channel ID parameters that will override the CMTS interface and upstream channel.
cable `slot/port` `upstream`	Specifies the CMTS interface slot, port number, and upstream parameters that are to be overridden. `slot` —Slot where the line card resides. Cisco uBR7225VXR router—The valid range is from 1 to 2. Cisco uBR7246VXR router—The valid range is from 3 to 6. `port` —Downstream controller number on the line card. The permitted `port` values are 0 or 1.
cable `slot/port` `upstream`	Specifies the CMTS interface slot, port number, and upstream parameters that will override the CMTS interface and upstream channel.
init-tech-list `0-4`	Specifies the DCC initialization technique list ranging from 0 to 4 for the upstream channel pair.
ucc	Determines whether Upstream Channel Change (UCC) can be used for modems during dynamic upstream load balancing.

Command Default

None

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.OS	This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The init-tech-list command accepts an upstream that is not added into the load balancing group. The upstream channel pair is invalid until the upstream is added. When the load balancing group is removed, all upstream channel pairs are also removed.

Examples

The following example shows how to set DCC initialization techniques that override the physical upstream channel pair to a DOCSIS load balancing group on the CMTS, using the init-tech-ovr 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)# init-tech-ovr cable 
1/0 1 cable 
1/1 2 1

Related Commands


Command	Description
cable load-balance docsis-group	Configures a DOCSIS load balancing group on the CMTS.
show cable load-balance docsis-group	Displays real-time configuration, statistical, and operational information for load balancing operations on the router.

interface cable

To configure a cable interface, use the interface cable command in global configuration mode.

interface cable {slot/port | slot/subslot/port}

Cisco IOS Release 12.2(33)SCE and later

interface cable {slot/cable-interface-index | slot/subslot/cable-interface-index}

Syntax Description


`slot`	Slot where the line card resides. Cisco uBR7225VXR router—The valid value is 1 or 2. Cisco uBR7246VXR router—The valid range is from 3 to 6. Cisco uBR10012 router—The valid range is from 5 to 8. Cisco cBR Series Converged Broadband Routers— The valid range is from 0 to 3 and from 6 to 9.
`subslot`	(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1. For Cisco cBR Series Converged Broadband Routers, the valid value is 0.
`port`	Downstream port number. Cisco uBR7225VXR router and Cisco uBR7246VXR router—The valid value is 0 or 1. Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
`cable-interface-index`	Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco uBR-MC20X20V and Cisco uBR-MC3GX60V line cards. Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1. Cisco uBR10012 router—The valid range for the Cisco uBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14. Cisco cBR Series Converged Broadband Routers— The valid range is from 0 to 15.

Command Default

None

Command Modes

Global configuration (config)

Command History


Release	Modification
12.3(21)BC	This command was introduced.
12.3(23)BC	This command was integrated into Cisco IOS Release 12.3(23)BC.
12.2(33)SCA	This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCB	This command was integrated into Cisco IOS Release 12.2(33)SCB.
12.2(33)SCD	This command was modified to support Cisco uBR7225VXR and Cisco uBR7246VXR routers.
12.2(33)SCE	This command was modified. The port parameter was changed to cable-interface-index to indicate the MAC domain index for the Cisco uBR-MC20X20V and Cisco uBR-MC3GX60V cable interface line cards.
IOS-XE 3.15.OS	This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Examples

The following example shows how to configure a cable interface in slot 5, and port 0 on a Cisco uBR7246VXR or Cisco uBR7225VXR router:


Router# configure terminal
Router(config)# interface cable 5/0

The following example shows how to configure a cable interface in slot 8, subslot 0, and port 0 on a Cisco uBR10012 router:


Router# configure terminal
Router(config)# interface cable 8/0/0

The following example shows how to configure a Cisco uBR-MC3GX60V cable interface line card in slot 5, subslot 0, and cable interface index 13 (MAC domain index) on a Cisco uBR10012 router:


Router# configure terminal
Router(config)# interface cable 5/0/13

The following example shows how to configure a Cisco uBR-MC3GX60V cable interface line card in slot 1, subslot 0, and cable interface index 13 (MAC domain index) on a Cisco cBR Series Converged Broadband Routers:


Router# configure terminal
Router(config)# interface cable 1/0/13

Related Commands


Command	Description
interface integrated-cable	Specifies a integrated cable interface.
interface modular-cable	Specifies a modular cable interface.
interface wideband-cable	Specifies a wideband cable interface.

interface cable-modem

To enter interface configuration mode for the cable interface on a router, use the interface cable-modem command in global configuration mode.

Cisco uBR904, uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter

interface cable-modem number

Syntax Description


`number`	Identifies the cable interface (always 0 ).

Command Default

Disabled

Command Modes

Global configuration

Command History


Release	Modification
11.3(4)NA	This command was introduced for the Cisco uBR904 cable access router.
12.0(4)XI1	Support was added for the Cisco uBR924 cable access router.
12.1(3)XL	Support was added for the Cisco uBR905 cable access router.
12.1(5)XU1	Support was added for the Cisco CVA122 Cable Voice Adapter.
12.2(2)XA	Support was added for the Cisco uBR925 cable access router.
IOS-XE 3.15.0S	This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

When this command is used, the router switches from global configuration mode to interface configuration mode.

Examples

The following example shows how to enter interface configuration mode for the router’s cable interface and then to enter the available interface configuration commands:


Router(
config)# 
interface cable-modem 
0
Router(config-if)# cable-modem ?
  compliant    Enter compliant modes for interface
  downstream   Downstream channel characteristics
  fast-search  Enable/disable the DS fast search
  upstream     upstream channel characteristics
  voip         Options for Voice over IP traffic over the cable interface
Router(config-if)#

Related Commands


Command	Description
cable-modem compliant bridge	Enables DOCSIS-compliant bridging on the cable interface.
cable-modem downstream saved channel	Modifies the saved downstream channel setting and upstream power value on the cable interface.
cable-modem upstream preamble qpsk	Enables the QPSK modulation scheme in the upstream direction from the cable interface to the CMTS.
cable-modem voip best-effort	Allows voice traffic to be transmitted on the upstream using a best-effort QoS.

interface integrated-cable

To configure integrated cable interface on a cable interface line card, use the interface integrated-cable command in global configuration mode.

Cisco uBR10012 Universal Broadband Router

interface integrated-cable slot/subslot/port:rf-channel

Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband Router

interface integrated-cable slot/subslot/port:rf-channel

Cisco cBR Series Converged Broadband Routers

interface integrated-cable slot/subslot/port:rf-channel

Syntax Description


`slot`	Identifies the chassis slot where the cable interface line card resides. Cisco uBR10012 router—The valid range is from 5 to 8. Cisco uBR7225VXR router—The valid value is 1 or 2. Cisco uBR7246VXR router—The valid range is from 3 to 6. Cisco cBR Series Converged Broadband Routers— The valid range is from 0 to 3 and 6 to 9.
`subslot`	(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1. For Cisco cBR Series Converged Broadband Routers, the valid subslot is 0.
`port`	Downstream port number. Cisco uBR7225VXR router and Cisco uBR7246VXR router—The valid value is 0 or 1. Cisco uBR10012 router—The valid range is from 0 to 4. Cisco cBR Series Converged Broadband Routers— The valid range is from 0 to 7.
`rf-channel`	RF channel number. The valid range is from 0 to 162.

Command Default

None

Command Modes

Global configuration (config)

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.
IOS-XE 3.18.0SP	This command was modified on the Cisco cBR Series Converged Broadband Routers. The `rf-channel` range is 0 to 162 now.

Usage Guidelines

The interface integrated-cable command is used to configure the following line cards:

The interface integrated-cable command is supported on Cisco cBR Converged Broadband Routers and also on Cisco uBR-MC88V and Cisco UBR-MC20X20V line cards.

Examples

The following example shows how to configure a integrated cable interface in slot 7, subslot 0, and port 0 on a Cisco UBR-MC20X20V cable interface line card:


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

Related Commands


Command	Description
show interface integrated-cable	Displays the current configuration and status for an integrated channel.

interface modular-cable

To configure a modular cable interface, use the interface modular-cable command in global configuration mode.

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

interface modular-cable slot/subslot/bay:nb-channel-number

Cisco IOS Release 12.2(33)SCB

interface modular-cable slot/subslot/bay:nb-channel-number

Cisco IOS Release 12.2(33)SCE

interface modular-cable slot/subslot/bay:nb-channel-number

Syntax Description

slot

Identifies the chassis slot where the Cisco Cable line card, or Cisco Wideband Shared Port Adaptor (SPA) is located.

For the Cisco Cable line cards, the valid range is from 5 to 8.
For the Cisco Wideband SPA, the valid values are:
- slot —1 or 3 (for SIP-600)
- slot —1 (for Wideband SIP)

Note

In Cisco IOS Release 12.2(33)SCE, support for configuring modular-cable interface on the Cisco uBR-MC3GX60V cable line card is introduced.

subslot

Identifies the subslot where the Cisco Cable line card is located.

For the Cisco Cable line cards, the valid value is 0 or 1.

Note

In Cisco IOS Release 12.2(33)SCE, support for configuring modular-cable interface on the Cisco uBR-MC3GX60V cable line card is introduced.

bay

Identifies the bay where the Cisco Wideband SPA is located.

The valid range is from 0 to 3.

port

Identifies the port on the Cisco Cable line card, or the Cisco Wideband SPA in the specified slot / subslot or slot / bay .

For the Cisco UBR-MC20X20V cable interface line card, the valid range for is from 0 to 5.
For the Cisco uBR-MC3GX60V cable interface line card, the valid range is from 0 to 2.
For the Cisco Wideband SPA, the valid value is 0.

nb-channel-number

Identifies the narrowband channel number.

interface-number

Identifies the modular-cable interface number. The valid range is from 0 to 23.

Command Default

None

Command Modes

Global configuration (config)

Command History


Release	Modification
12.3(21)BC	This command was introduced.
12.3(23)BC	This command was integrated into Cisco IOS Release 12.3(23)BC.
12.2(33)SCA	This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCB	This command was modified to change the addressing format for the modular cable interface from `slot/subslot/bay:nb-channel-number` to `slot/bay/port:nb-channel-number.`
12.2(33)SCE	Support for configuring modular-cable interface on the Cisco uBR-MC3GX60V cable line card 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 configure a modular cable interface in slot 1, bay 3, and channel 23 on a Cisco uBR10012 router:


Router# configure terminal
Router(config)# interface modular-cable 1/3/0:23

The following example shows how to configure a modular cable interface in slot 5, subslot 1, and port 2 on a Cisco uBR-MC3GX60V cable line card.


Router# configure terminal
Router(config)# interface modular-cable 5/1/2:0

Related Commands


Command	Description
cable attribute-mask	Specifies an attribute mask value for a modular cable interface.
interface wideband-cable	Specifies a wideband cable interface.
interface cable	Specifies a cable interface.

interface port-channel

To create an EtherChannel interface on the Cisco Cable Modem Termination System (CMTS), use the interface port-channel command in global configuration mode. To remove this EtherChannel port from the Cisco CMTS, use the no form of this command.

interface port-channel n

no interface port-channel n

Syntax Description


`number`	Identifying port channel number for this interface (EtherChannel port). The range is 1 to 64.

Command Default

By default, EtherChannel groups and ports are not defined, and they are disabled.

Command Modes

Global configuration (config)

Command History


Release	Modification
12.2(11)BC3	This command was introduced on the Cisco uBR7246VXR router.
12.2(9a)BC	This command was introduced on the Cisco uBR10012 router.
IOS-XE 3.15.0S	This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The first EtherChannel interface configured becomes the bundle primary for all EtherChannel interfaces in the group. That is, the MAC address of the first EtherChannel interface is the MAC address for all EtherChannel interfaces in the group. If the first EtherChannel interface is later removed, the second EtherChannel interface to be configured becomes the bundled primary by default.

Repeat this configuration on every EtherChannel port to be bundled into:

FastEtherChannel (FEC) or GigabitEtherChannel (GEC) group on the Cisco uBR10012 and Cisco uBR7200 series routers.
Ten Gigabit EtherChannel (Ten GEC) group on the Cisco cBR series routers.

This configuration must be present on all EtherChannel interfaces before the EtherChannel group can be configured.

Examples

The following example configures the port to have an EtherChannel port number of 1 within its EtherChannel group. The EtherChannel group is defined with the channel-group command.


Router(config-if)# interface port-channel 1

Related Commands


Command	Description
channel-group	Assigns an EtherChannel port to an EtherChannel group.
show interface port-channel	Displays the EtherChannel interfaces and channel identifiers, with their mode and operational status.

interface virtualportgroup

To configure a VirtualPortGroup interface, use the interface command in the global configuration mode. To delete the VirtualPortGroup created, use the no form of the command.

interface virtualportgroup number

no interface virtualportgroup number

Syntax Description


`number`	Specifies the Virtual Port Group number. Valid range is 0 to 31.

Command Default

None.

Command Modes

Global configuration mode (config)

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 configure a VirtualPortGroup interface. If a VirtualPortGroup interface is configured, you will need to assign a primary IP address to it. You can also configure a secondary IP address on the VirutalPortGroup interface, similar to a gigabit Ethernet interface IP address configuration. You can assign only one secondary IP address.

Examples

The following example shows how to configure a VirtualPortGroup interface:

Router#configure terminal 
Router(config)#interface VirtualPortGroup0 
Router(config-if)#ip address 1.23.2.1 255.255.255.0 
Router(config-if)#ip address 1.23.2.2 255.255.255.0 secondary 
Router(config-if)#end

Related Commands


Command	Description
mgmt-intf	Define a cable video management interface.
show run interface VirtualPortGroup	Displays the VirtualPortGroup interface configuration.
show run \| include mgmt-intf	Displays the cable video management interface configuration.
show interfaces VirtualPortGroup	Displays the VirtualPortGroup interface state.

interface wideband-cable

To configure a wideband cable interface, use the interface wideband-cable command in global configuration mode.

Cisco uBR10012 Universal Broadband Router

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

interface wideband-cable slot/ subslot/ bay: wideband-channel

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

interface wideband-cable slot/ bay/ port: wideband-channel

Cisco IOS Releases 12.3(21)BC, 12.3(23)BC, and 12.2(33)SCC

interface wideband-cable slot/ {subslot | bay}/ port: wideband-channel

Cisco IOS Releases 12.3(21)BC, 12.3(23)BC, and 12.2(33)SCE

interface wideband-cable slot/ subslot/ controller: wideband-channel

Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband Routers

Cisco IOS Releases 12.3(21)BC, 12.3(23)BC, and 12.2(33)SCD

interface wideband-cable slot/ / port: wideband-channel

Cisco cBR Series Converged Broadband Routers

interface wideband-cable slot/ subslot/ controller: wideband-channel

Syntax Description


`slot`	The slot where a SIP or cable line card resides. Cisco uBR7246VXR router—The valid range is from 3 to 6. Cisco uBR7225VXR router—The valid range is from 1 to 2. Cisco uBR10012 router—The valid range for: Cable line card is from 5 to 8 SIP is 1 and 3 Cisco cBR Series Converged Broadband Routers— The valid range is from 0 to 3 and 6 to 9.
`subslot`	The subslot where a SIP or cable line card resides. Cisco uBR10012 router—The valid value for: Cable line card in slot 5 to 8 is 0 or 1 SPAs in a SIP in slot 1 or 3, prior to Cisco IOS Release 12.2(33)SCB is 0 or 1. For Cisco IOS Release 12.2(33)SCB and later, subslot is not specified. For Cisco cBR Series Converged Broadband Routers, the valid subslot is 0.
`bay`	The bay in a SIP where a SPA is located. The valid range is from 0 to 3.
`controller`	Controller index for the modular cable. The valid range is from 0 to 2. For Cisco cBR Series Converged Broadband Routers, the valid range is from 0 to 7.
`port`	Specifies the port number. Cisco uBR7246VXR router and Cisco uBR7225VXR router—The valid range is from 0 to 1. Cisco uBR10012 router—The valid value for: Slot 1 and 3 is 0 Slot 5 to 8 is from 0 to 4
`wideband-channel`	Represents the wideband channel number. Cisco uBR10012 router—The valid range for: Cisco UBR-MC20X20V cable interface line card is from 0 to 5. Cisco uBR-MC3GX60V cable interface line card and SPAs is from 0 to 31. Cisco uBR7246VXR and Cisco uBR7225VXR routers—The valid range is from 0 to 5. Cisco cBR Series Convereged Broadband Routers—The valid range is from 0 to 162.

Command Default

None

Command Modes

Global configuration (config)

Command History


Release	Modification
12.3(21)BC	This command was introduced.
12.3(23)BC	This command was integrated into Cisco IOS Release 12.3(23)BC.
12.2(33)SCA	This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCB	This command was modified to change the addressing format for the wideband cable interface from `slot/subslot/bay:wideband-channel` to `slot/bay/port:wideband-channel.`
12.2(33)SCD	This command was modified. Support was added for Cisco uBR7225VXR and Cisco uBR7246VXR routers.
12.2(33)SCE	Support was added for Cisco uBR-MC3GX60V cable interface line card on the Cisco uBR10012 router.
IOS-XE 3.15.0S	This command was integrated into Cisco IOS-XE Release 3.15.0S. Support for the Cisco cBR Series Converged Broadband Routers was added.
IOS-XE 3.18.0SP	This command was modified on Cisco cBR Series Converged Broadband Routers. The `wideband-channel` range is 0 to 162 now.

Examples

The following example shows how to configure a wideband cable interface in slot 1, bay 3, and port 0 on a Cisco uBR10012 router:


Router# configure terminal
Router(config)# interface wideband-cable 1/3/0:0

The following example shows how to configure a wideband cable interface in slot 5, subslot 1, and port 2 on a Cisco uBR-MC3GX60V cable line card.


Router# configure terminal
Router(config)# interface wideband-cable 5/1/2:0

The following example shows how to configure a wideband cable interface in slot 1, and port 0 on a Cisco uBR7225VXR or Cisco uBR7246VXR router:


Router# configure terminal
Router(config)# interface wideband-cable 1/0:0

Related Commands


Command	Description
cable downstream attribute-mask	Specifies an attribute mask value for a wideband cable interface.
cable rf-channels	Associates RF channels on the router with a wideband interface and allocate bandwidth.
cable bundle	Specifies bundle number for bundling of cable interfaces.
interface modular-cable	Specifies a modular cable interface.
interface cable	Specifies a cable interface.

interleaver-depth (QAM profile)

To set the interleaver-depth for a specific QAM profile, use the interleaver-depth command in QAM profile configuration mode.

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

Syntax Description


I12-J17	INTERLEAVER-I-12-J-17 for Annex A or C
I128-J1	INTERLEAVER-I-128-J-1 for Annex B
I128-J2	INTERLEAVER-I-128-J-2 for Annex B
I128-J3	INTERLEAVER-I-128-J-3 for Annex B
I128-J4	INTERLEAVER-I-128-J-4 for Annex B
I128-J5	INTERLEAVER-I-128-J-5 for Annex B
I128-J6	INTERLEAVER-I-128-J-6 for Annex B
I128-J7	INTERLEAVER-I-128-J-7 for Annex B
I128-J8	INTERLEAVER-I-128-J-8 for Annex B
I16-J8	INTERLEAVER-I-16-J-8 for Annex B
I32-J4	INTERLEAVER-I-32-J-4 for Annex B
I64-J2	INTERLEAVER-I-64-J-2 for Annex B
I8-J16	INTERLEAVER-I-8-J-16 for Annex B

Command Default

None

Command Modes

QAM profile configuration (config-qam-prof)

Command History


Release	Modification
IOS-XE 3.15.0S	This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Use this command to set the interleaver-depth for a specific QAM profile.

Examples

The following example shows how to set the interleaver-depth for a specific QAM profile:


Router# configure terminal
Router(config)# cable downstream qam-profile 4
Router(config-qam-prof)# interleaver-depth I12-J17

Related Commands


Command	Description
cable downstream qam-profile	Set the QAM profile for the cable interface line card.
annex	Set the MPEG framing format.
modulation	Set the QAM modulation format.
spectrum-inversion	Set the spectrum-inversion on or off.
symbol-rate	Set the symbol rate.

interleaver-depth (OFDM channel profile)

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

interleaver-depth value

no interleaver-depth

Syntax Description


`value`	1 to 16 for 25 KHz spacing, 1 to 32 for 50 KHz spacing.

Command Default

16

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 interleaver-depth.

Examples

The following example shows how to specify the channel interleaver-depth:


Router# configure terminal
Router(config)# cable downstream ofdm-chan-profile 21
Router(config-ofdm-chan-prof)# interleaver-depth 3

Related Commands


Command	Description
cable downstream ofdm-chan-profile	Define the OFDM channel profile on the OFDM channel.
cyclic-prefix	Specify the channel cyclic-prefix.
description (OFDM channel profile)	Specify a user defined description for the profile.
pilot-scaling	Specify the value used to calculate the number of continuous pilots.
profile-control	Specify default modulation or profile as the channel control profile.
profile-data	Specify default modulation or profile as the channel data profile.
profile-ncp	Specify default modulation or profile as the channel ncp profile.
roll-off	Specify the channel roll-off value.
subcarrier-spacing	Specify the spacing for specific subcarriers configured in this profile.

interval

To set the duration of time the CMTS waits before checking the load on an interface, use the interval command in the load balancing group configuration mode. To reset the duration of time, use the no form of this command.

interval seconds

no interval

Syntax Description


`seconds`	The polling interval for the CMTS to determine the current load on each cable interface. The valid range is from 1 to 1000. The default value is 10 seconds in Cisco IOS Release 12.2(33)SCE and earlier. The default value is 30 seconds in Cisco IOS Release 12.2(33)SCE1 and later.

Command Default

None

Command Modes

Load balancing group configuration (config-lb-group)

Command History


Release	Modification
12.2(33)SCC	This command was introduced.
12.2(33)SCE1	This command was modified. The default value for this command was changed from 10 seconds to 30 seconds.
IOS-XE 3.15.OS	This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Examples

The following example shows how to set the duration of time that the CMTS waits before checking the load on the interface, using the interval 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)# interval 
50
Router(config-lb-group)#

Related Commands


Command	Description
cable load-balance docsis-group	Configures a DOCSIS load balancing group on the CMTS.
show cable load-balance docsis-group	Displays real time configuration, statistical, and operational information for load balancing operations on the router.

ip (virtual-arpd)

To configure the virtual advanced return path demodulator (ARPD) source IP address, use the ip command in OOB virtual ARPD configuration mode. To void the virtual ARPD source IP configuration, use the no form of this command.

ip ip subnet_mask [vrf]

no ip ip

Syntax Description


`ip`	Specifies the virtual ARPD source IP address.
`subnet_mask`	Specifies the virtual ARPD source subnet mask.

Command Default

None

Command Modes

OOB Virtual ARPD configuration (config-oob-varpd)

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 configure the virtual ARPD source IP address.

Examples

The following example shows how to configure the virtual ARPD source IP address:


Router# configure terminal
Router(config)# cable oob
Router(config-oob)# virtual-arpd 1
Router(config-oob-varpd)# ip 225.225.225.225 255.255.255.0

Related Commands


Command	Description
virtual-arpd	Defines a virtual ARPD configuration.
nc	Configures the network controller for virtual ARPD.
source-id	Configures the source ID for virtual ARPD.

ip (virtual-om)

To configure the virtual OOB modulator (OM) source IP address, use the ip command in OOB virtual OM configuration mode. To void the virtual OM source IP configuration, use the no form of this command.

ip ip subnet_mask [vrf]

no ip ip

Syntax Description


`ip`	Specifies the virtual OM source IP address.
`subnet_mask`	Specifies the virtual OM source subnet mask.

Command Default

None

Command Modes

OOB Virtual OM configuration (config-oob-vom)

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 configure the virtual OM source IP address.

Examples

The following example shows how to configure the virtual OM source IP address:


Router# configure terminal
Router(config)# cable oob
Router(config-oob)# virtual-om 1
Router(config-oob-vom)# ip 225.225.225.225 255.255.255.0

Related Commands


Command	Description
virtual-om	Defines a virtual OM configuration.
join-group	Joins multicast group address.

ip address

To specify the IP address range for multicast pool, use the ip address command in multicast pool configuration mode. To void the IP address configuration, use the no form of this command.

ip address ip mask

no ip address

Syntax Description


`ip` `mask`	Specifies the IP address and subnet musk for the DEPI multicast pool.

Command Default

None

Command Modes

Multicast pool configuration (config-multicast-pool)

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 IP address range for multicast pool.

Examples

The following example shows how to specify the IP address range for multicast pool:

Router# configure terminal
Router(config)# cable depi multicast pool 1
Router(config-multicast-pool)# ip address 225.225.225.0 255.255.255.0

Related Commands


Command	Description
cable depi multicast pool	Configures the DEPI multicast pool.

ip address docsis

To specify that the cable access router should use the DHCP protocol, as required by the DOCSIS specification, to assign an IP address for its cable interface, use the ip address docsis command in cable interface configuration mode. To disable the use of DHCP, use the no form of this command.

Cisco uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter

ip address docsis

no ip address docsis

Syntax Description

There are no key words or arguments for this command.

Command Default

The cable access router uses the DHCP protocol, as required by the DOCSIS specification, to assign an IP address to its cable interface during system power-on.

Command Modes

Interface configuration (cable interface only)

Command History


Release	Modification
12.1(3)XL	This command was introduced for the Cisco uBR905 cable access router.
12.1(4)T	Support was added for the Cisco uBR924 cable access router.
12.1(3)XL	Support was added for the Cisco uBR905 cable access router.
12.1(5)XU1	Support was added for the Cisco CVA122 Cable Voice Adapter.
12.2(2)XA	Support was added for the Cisco uBR925 cable access router.
IOS-XE 3.15.0S	This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

The ip address docsis command configures the cable access router so that it obtains its IP address from a DHCP server at system power-on, which is a requirement for DOCSIS operation. This is the default mode of operation. If the configuration for the cable interface does not include any form of ip address command, the cable access router defaults to configuring the cable interface with the ip address docsis command.

Configuring the cable interface with any other form of the ip address command or with the no ip address docsis command prevents the cable access router from operating in DOCSIS networks. This mode of operation should be used only in lab or test networks.

Note

Earlier Cisco IOS software releases for the cable access routers used either the ip address negotiated or the ip address dhcp command to specify that the cable interface should obtain its IP address from a DHCP server. These commands should no longer be used to configure the router’s cable interface.

Examples

The following example shows how to configure the cable access router so that it obtains the IP address for its cable interface from a DHCP server:


Router(config)# interface cable-modem 0
 
Router(config-if)# ip address docsis
 
Router(config-if)# exit
 
Router(config)#

Related Commands


Command	Description
cable-modem dhcp-proxy	Specifies that a DHCP server should provide the IP address for the router’s Ethernet interface or for a NAT address pool.
ip http dhcp	Specifies the use of the DHCP protocol to obtain an IP address for any interface except the cable interface at system power-on.
ip http negotiated	Specifies that a serial interface should use the PPP/IPCP to obtain an IP address at system power-on

ip-address (controller)

To set the IP address of the Wideband SPA FPGA, use the ip-address (controller) command in controller configuration mode. To remove the IP address of the Wideband SPA FPGA, use the no form of this command.

ip-address ip-address

no ip-address ip-address

Syntax Description


`ip-address`	IP address for the Wideband SPA FPGA.

Command Default

No IP address is set for the Wideband SPA FPGA.

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

Use this command to set the IP address for the Wideband SPA FPGA. This address is used as the source IP address for packets that the Wideband SPA transmits to the EQAM device.

Examples

The following example shows how to set the IP address of the Wideband SPA FPGA. The SPA is located in slot 1, subslot 0, bay 0.


Router(config)# controller modular-cable 1/0/0
 
Router(config-controller)# ip-address 192.168.200.6

Related Commands


Command	Description
annex modulation	Sets the annex and modulation for the Wideband SPA.
cable rf-channel	Associates an RF channel on a Wideband SPA with a wideband channel.
controller modular-cable	Enters controller configuration mode to configure the Wideband SPA controller.
modular-host subslot	Specifies the modular-host line card.
rf-channel frequency	Sets the frequency for each RF channel.
rf-channel ip-address mac-address udp-port	Sets the IP address, MAC address and UDP port for each RF channel.
rf-channel network delay	Specifies the CIN delay for each RF channel.
rf-channel description	Specifies the description for each RF channel.
rf-channel cable downstream channel-id	Assigns a downstream channel ID to an RF channel.

ip dhcp ping packet 0

To instruct the DHCP server to assign an IP address from its pool without first sending an ICMP ping to test whether a client is already currently using that IP address, use the ip dhcp ping packet 0 command in global configuration mode. Use the no form of this command to remove this configuration.

ip dhcp ping packet 0

no ip dhcp ping packet 0

Syntax Description

This command has no additional keywords or arguments.

Command Default

By default, the DHCP server pings a pool address twice before assigning a particular address to a requesting client. If the ping is unanswered, the DHCP server assumes that the address is not in use and assigns the address to the requesting client.

Command Modes

Global configuration

Command History


Release	Modification
12.1 EC	Command support introduced on the Cisco CMTS.

Usage Guidelines

Disabling the ping option can speed up address assignment when a large number of modems are trying to connect at the same time. However, disabling the ping option can also result in duplicate IP addresses being assigned if users assign unauthorized static IP addresses to their CPE devices.

For additional information about DHCP configuration on the Cisco CMTS, refer to the following documents on Cisco.com:

Filtering Cable DHCP Lease Queries on the Cisco CMTS
DHCP and Time-of-Day Services on the Cisco CMTS

Examples

The following example of the show version command illustrates configuration of this feature on the Cisco CMTS:


version 12.1
no service pad
! provides nice timestamps on all log messages
service timestamps debug datetime msec localtime
service timestamps log uptime
! turn service password-encryption on to encrypt passwords
no service password-encryption
! provides additional space for longer configuration file
service compress-config
! supports a large number of modems / hosts attaching quickly
service udp-small-servers max-servers no-limit 
!
hostname Router 
!
boot system disk0:
!
no cable qos permission create
no cable qos permission update
cable qos permission modems
! permits cable modems to obtain Time of Day (TOD) from uBR7100
cable time-server
!
! High performance DOCSIS config file, additional options may be added
!   10 Mbit/sec download, 128 Kbit/sec upload speed, 10 Kbit/sec guaranteed upstream
! NOTE: cable upstream 0 admission-control 150 will prevent modems from 
!   connecting after 150% of guaranteed-bandwidth has been allocated to 
!   registered modems. This can be used for peek load balancing.
! max-burst 1600 prevents a modem with concatenation turned on from consuming 
!   too much wire time, and interfering with VoIP traffic.
! cpe max 8 limits the modem to 8 hosts connected before the CMTS refuses 
!   additional host MAC addresses.
! Timestamp option makes the config file only valid for a short period of time.
!
cable config-file platinum.cm
  service-class 1 max-upstream 128
  service-class 1 guaranteed-upstream 10
  service-class 1 max-downstream 10000
  service-class 1 max-burst 1600
  cpe max 8
  timestamp
!
! Medium performance DOCSIS config file, additional options may be added
!   5 Mbit/sec download, 128 Kbit/sec upload speed
!
cable config-file gold.cm
  service-class 1 max-upstream 64
  service-class 1 max-downstream 5000
  service-class 1 max-burst 1600
  cpe max 3
  timestamp
!
! Low performance DOCSIS config file, additional options may be added
!   1 Mbit/sec download, 64 Kbit/sec upload speed
!
cable config-file silver.cm
  service-class 1 max-upstream 64
  service-class 1 max-downstream 1000
  service-class 1 max-burst 1600
  cpe max 1
  timestamp
!
! No Access DOCSIS config file, used to correctly shut down an unused cable modem
!   1 kbit/sec download, 1 Kbit/sec upload speed, with USB/ethernet port shut down.
!
cable config-file disable.cm
  access-denied
  service-class 1 max-upstream 1
  service-class 1 max-downstream 1
  service-class 1 max-burst 1600
  cpe max 1
  timestamp
!
ip subnet-zero
! Turn on cef switching / routing, anything but process switching (no ip route-cache)
ip cef
ip cef accounting per-prefix 
! Disables the finger server 
no ip finger
! Prevents CMTS from looking up domain names / attempting to connect to 
!   machines when mistyping commands
no ip domain-lookup
! Prevents issuance of IP address that is already in use.
ip dhcp ping packets 0

Related Commands


Command	Description
cable dhcp-giaddr policy	Sets the DHCP giaddr field of DHCP request packets to the primary address for cable modems and the secondary address for CPE devices, allowing the use of separate address pools for the different clients.
cable dhcp-parse option	Enables the parsing of certain DHCP options.
cable helper-address	Enables load-balancing of DHCP requests from cable modems and CPE devices by specifying different DHCP servers according to the cable interface or subinterface.
ip dhcp ping packet 0	Instructs the DHCP server to assign an IP address from its pool without first sending an ICMP ping to test whether a client is already currently using that IP address.
ip dhcp relay information option	Configures the DHCP server to validate the relay agent information option in forwarded BOOTREPLY messages.
ip dhcp smart-relay	Enables the DHCP relay agent on the CMTS to automatically switch a cable modem or CPE device to a secondary DHCP server or address pool if the primary DHCP server does not respond to three successive requests.

ip dhcp pool

To create a DHCP address pool and enter DHCP pool configuration file mode, use the ip dhcp pool command in global configuration mode. To remove a configured DHCP pool, use the no form of this command.

Syntax Description

Provide a name for the DHCP address pool


name	The name can be either an arbitrary string, such as service, or a number, such as 1 .

Command Default

DHCP pool names are not configured by default.

Command Modes

Global configuration

Command History


Release	Modification
12.1 EC	Command support introduced on the Cisco CMTS.

Usage Guidelines

Disabling the ping option can speed up address assignment when a large number of modems are trying to connect at the same time. However, disabling the ping option can also result in duplicate IP addresses being assigned if users assign unauthorized static IP addresses to their CPE devices.

For additional information about DHCP configuration on the Cisco CMTS, refer to the following documents on Cisco.com:

http://www.cisco.com/en/us/docs/cable/cmts/feature/cblsrcvy.html Filtering Cable DHCP Lease Queries on the Cisco CMTS
http://www.cisco.com/en/US/docs/ios/cable/configuration/guide/cmts_services.html DHCP and Time-of-Day Services on the Cisco CMTS

Examples

The following example configures a DHCP pool with the name indicated, and enables additional configuration in the DHCP pool configuration mode:


Router# configure terminal
Router(config)# ip dhcp pool local 
Router(dhcp-config)#

The following examples illustrate additional configurations that are typical for a DHCP pool configured when starting with the ip dhcp pool command, or with additional DHCP configuration commands.


ip dhcp pool cm-platinum
   network 10.128.4.0 255.255.255.0
   bootfile platinum.cm
   next-server 10.128.4.1 
   default-router 10.128.4.1 
   option 2 hex ffff.8f80
   option 4 ip 10.1.4.1 
   option 7 ip 10.1.4.1 
   lease 7 0 10
!
ip dhcp pool cm-gold
   network 10.129.4.0 255.255.255.0
   bootfile gold.cm
   next-server 10.129.4.1
   default-router 10.129.4.1
   option 2 hex ffff.8f80
   option 4 ip 10.1.4.1 
   option 7 ip 10.1.4.1 
   lease 7 0 10
!
ip dhcp pool cm-silver
   network 10.130.4.0 255.255.255.0
   bootfile silver.cm
   next-server 10.130.4.1
   default-router 10.130.4.1
   option 2 hex ffff.8f80
   option 4 ip 10.1.4.1 
   option 7 ip 10.1.4.1 
   lease 7 0 10 
!
ip dhcp pool DisabledModem(0010.aaaa.0001)
    host 10.128.1.9 255.255.255.0
    client-identifier  0100.10aa.aa00.01
    bootfile disable.cm
!
ip dhcp pool DisabledModem(0020.bbbb.0002)
    host 10.128.1.10 255.255.255.0
    client-identifier  0100.20bb.bb00.02
    bootfile disable.cm
!
ip dhcp pool DisabledModem(1010.9581.7f66)
   host 10.128.1.11 255.255.255.0
   client-identifier 0100.1095.817f.66
   bootfile disable.cm
!
ip dhcp pool hosts
    network 10.254.1.0 255.255.255.0
    default-router 10.254.1.1
    dns-server 10.254.1.1 10.128.1.1
    domain-name ExamplesDomainName.com
    lease 7 0 10
!

Related Commands


Command	Description
cable dhcp-giaddr policy	Sets the DHCP giaddr field of DHCP request packets to the primary address for cable modems and the secondary address for CPE devices, allowing the use of separate address pools for the different clients.
cable dhcp-parse option	Enables the parsing of certain DHCP options.
cable helper-address	Enables load-balancing of DHCP requests from cable modems and CPE devices by specifying different DHCP servers according to the cable interface or subinterface.
ip dhcp ping packet 0	Instructs the DHCP server to assign an IP address from its pool without first sending an ICMP ping to test whether a client is already currently using that IP address.
ip dhcp relay information option	Configures the DHCP server to validate the relay agent information option in forwarded BOOTREPLY messages.
ip dhcp smart-relay	Enables the DHCP relay agent on the CMTS to automatically switch a cable modem or CPE device to a secondary DHCP server or address pool if the primary DHCP server does not respond to three successive requests.

ipdr associate

To associate the Collector with a session, use the ipdr associate command in global configuration mode. To remove the association, use the no form of this command.

ipdr associate session_id collector_name priority

no ipdr associate session_id collector_name

Syntax Description


`session_id`	The unique IPDR session ID.
`collector_name`	The collector name. The name should not contain extra spaces.
`priority`	The priority value between the session and the collector. The value range is 1 to 10. A value of 1 indicates that the highest priority.

Command Default

An association with the session will not be created.

Command Modes

Global configuration mode

Command History


Release	Modification
12.2(33)SCB	This command was introduced.
IOS-XE 3.15.OS	This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command allows the user to associate the Collector with a session. Once the Collector is configured, the Exporter sends data to the Collector. IPDR supports redundant collector and consistent streaming continues when a collector is down or not functioning.

The no form of the command will only remove the association for the stopped session.

Note

The collector and the session should be configured before running this command.

Examples

The following example configures a Collector.


Router# configure terminal 
Router(config)#ipdr associate 1 federal 1

Related Commands


Command	Description
ipdr collector	Configures the IPDR Collector details.
show ipdr collector	Displays the collector information, message statistics and event for all the sessions that are associated with the collector.
ipdr session	Adds a session to the IPDR Exporter.

ipdr authorization

To enable the Internet Protocol Detail Record (IPDR) authorization, use ipdr authorization command in global configuration mode. To remove the configuration, use the no form of this command.

ipdr authorization

no ipdr authorization

Syntax Description

This command has no arguments or keywords.

Command Default

This IPDR authorization will be disabled by default.

Command Modes

Global configuration (config)

Command History


Release	Modification
12.2(33)SCI2	This command was introduced.

Usage Guidelines

The IPDR authorization is disabled by default. Use the ipdr authorization command to enable IPDR authorization. You can include it in the start-up configuration file as well. Whether IPDR authorization is enabled or not, any Collector coming from the bundle side will always be rejected.

Examples

The following example shows how to enable IPDR authorization:

Router#configure terminal
Router(config)#ipdr authorization
IPDR authorization is enabled.
Router(config)#

Related Commands


Command	Description
ipdr collector	Configures the Internet Protocol Detail Record (IPDR) Collector details.

ipdr collector

To configure the Internet Protocol Detail Record (IPDR) Collector details, use the ipdr collector command in global configuration mode. To remove the Collector, use the no form of this command.

ipdr collector collector_name ip_addr [port]

no ipdr collector collector_name

Cisco IOS Release 12.2(33)SCI2

ipdr collector collector_name ip_addr [port] [ nat-address ip_addr[ port] ]

no ipdr collector collector_name

Syntax Description


`collector_name`	The collector name. The name should not contain extra spaces.
`ip_addr`	The collector IP address.
`port`	(Optional) The collector port value. The default port number will be considered if the value is not entered.
nat-address `ip_addr`	(Optional) The collector's Network Address Translation (NAT) in IP header.

Command Default

A Collector will not be configured.

Command Modes

Global configuration mode

Command History


Release	Modification
12.2(33)SCB	This command was introduced.
12.2(33)SCI2	This command was integrated into Cisco IOS Release 12.2(33)SCI2. The nat-address keyword was added.
IOS-XE 3.15.OS	This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command allows the user to configure an IPDR Collector and authenticate the IPDR protocol. Once the Collector is configured, the Exporter sends data to the Collector. User must provide the collector name and the IP address. Port number is used when an exporter creates an active connection.

The no form of the command will remove a specific IPDR Collector. If the collector is associated with an active session, you should stop the session before using the no command.

Examples

The following example configures a Collector.


Router# configure terminal 
Router(config)#ipdr collector federal 192.0.2.0

Related Commands


Command	Description
show ipdr collector	Displays the collector information, message statistics and event for all the sessions that are associated with the collector.
ipdr session	Adds a session to the IPDR Exporter.

ipdr exporter ack-timeout

To set IPDR Exporter acknowledged records timeout value, use the ipdr exporter ack-timeout command in global configuration mode. To disable the acknowledged records timeout value, use the no form of this command.

ipdr exporter ack-timeout time_interval

no ipdr exporter ack-timeout

Syntax Description


`time_interval`	Acknowledged records timeout count. The valid range is from 5 to 60 seconds. The default value is 60.

Command Default

This command is enabled when the IPDR Exporter is running.

Command Modes

Global configuration (config)

Command History


Release	Modification
12.3(33)SCG	This command was introduced.
IOS-XE 3.15.OS	This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command allows you to set acknowledged records timeout value for a session.

Note

Restart the IPDR Exporter for the timer values to take effect.

Examples

The following example shows how to configure the acknowledged records timeout value on the Cisco CMTS router:


Router# configure terminal
Router(config
)# ipdr exporter ack-timeout 60
Router(config)# ipdr exporter start

Related Commands


Command	Description
show ipdr exporter	Displays information about the IPDR Exporter state on the Cisco CMTS router.

ipdr exporter connection active

To enable the IPDR exporter to start connection, use the ipdr exporter connection-active command in global configuration mode. To enable collectors to start connection, use the no form of this command. It does not support to change connection type when the exporter is started. Stop exporter then change to another type.

ipdr exporter connection-active [source-interface interface]

no ipdr exporter connection-active

Syntax Description


source-interface	Specifies the interface on which the connection is established.

Command Default

By default, the IPDR exporter process will not be started.

Command Modes

Global configuration mode

Command History


Release	Modification
IOS XE Gibraltar 16.12.1	This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command allows the IPDR exporter to start connection.

The no form of the command will change the IPDR Exporter connection mode to default.

Examples

The following example allows the IPDR Exporter to start connection on the TenGigabitEthernet port 4/1/0 of the CMTS.


Router# configure terminal
Router(config)#ipdr exporter connection-active source-interface TenGigabitEthernet4/1/0

Related Commands


Command	Description
show ipdr exporter	Displays information about the IPDR Exporter state.
show ipdr collector	Displays the collector information, message statistics and event for all the sessions that are associated with the collector.
ipdr collector	Configures the Internet Protocol Detail Record (IPDR) Collector details.

ipdr exporter keepalive

To set the keepalive timer value on the IPDR exporter, use the ipdr exporter keepalive command in global configuration mode. To disable the keepalive timer value, use the no form of this command.

ipdr exporter keeepalive time_interval

no ipdr exporter keepalive

Syntax Description


`time_interval`	Keepalive timer count. The valid range is from 5 to 300 seconds. The default value is 300.

Command Default

This command is enabled when the IPDR Exporter is running.

Command Modes

Global configuration (config)

Command History


Release	Modification
12.3(33)SCG	This command was introduced.
IOS-XE 3.15.OS	This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command allows you to set the keeplive timeout value for a session.

Note

Restart the IPDR Exporter for the keepalive timer values to take effect.

Examples

The following example shows how to configure the keepalive value on the Cisco CMTS router:


Router# configure terminal
Router(config
)# ipdr exporter keepalive 300
Router(config)# ipdr exporter start

Related Commands


Command	Description
show ipdr exporter	Displays information about the IPDR Exporter state on the Cisco CMTS.

ipdr exporter max-unacked

To set the maximum number of unacknowledged records on the IPDR exporter, on the Cisco CMTS, use the ipdr exporter max unacked command in global configuration mode. To reset the maximum number of unacknowledged records, use the no form of this command.

ipdr exporter max-unacked records

no ipdr exporter max-unacked

Syntax Description


`records`	Number of unacknowledged records. The valid range is from 5 to 200 records. The default value is 200.

Command Default

This command is enabled when IPDR Exporter is running.

Command Modes

Global configuration (config)

Command History


Release	Modification
12.3(33)SCG	This command was introduced.
IOS-XE 3.15.OS	This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command allows you to set the maximum number of unacknowledged records for a session.

Note

Restart the IPDR Exporter for the number of records to take effect.

Examples

The following example shows how to configure the number of unacknowledged records configured on the Cisco CMTS router:


Router# configure terminal
Router(config
)# ipdr exporter max-unacked 200
Router(config)# ipdr exporter start

Related Commands


Command	Description
show ipdr exporter	Displays information about the IPDR Exporter state on the Cisco CMTS router.

ipdr exporter start

To enable the CMTS application, to start the Internet Protocol Detail Record (IPDR) Exporter process to connect the exporter and the collector, use the ipdr exporter start command in global configuration mode. To terminate the connection between the exporter and collector, use the no form of this command.

ipdr exporter start [ipv6]

no ipdr exporter start

Syntax Description


ipv6	Configure IPDR in IPv6 mode.

Command Default

By default, the IPDR exporter process will not be started.

Command Modes

Global configuration mode

Command History


Release	Modification
12.2(33)SCB	This command was introduced.
IOS-XE 3.15.OS	This command was implemented on the Cisco cBR Series Converged Broadband Routers.
IOS XE Gibraltar 16.12.1	This command was updated to include ipv6 keyword.

Usage Guidelines

This command allows the user to explicitly start the IPDR Exporter and connect to the collector. As a default behavior, the command will initiate all the sessions configured in the Exporter to a "Start" state.

The no form of the command will stop the IPDR Exporter process. The command will also clear the connection with the collector while retaining other configurations.

Examples

The following example starts the IPDR Exporter process on the CMTS.


Router# configure terminal
Router(config)#ipdr exporter start

Related Commands


Command	Description
show ipdr exporter	Displays information about the IPDR Exporter state.
show ipdr collector	Displays the collector information, message statistics and event for all the sessions that are associated with the collector.
ipdr collector	Configures the Internet Protocol Detail Record (IPDR) Collector details.

ipdr session

To start or stop a specific session, use the ipdr session command in the privileged EXEC mode.

ipdr session session_id {start | stop}

Syntax Description


`session_id`	The unique IPDR session ID.
start	The keyword to start the session.
stop	The keyword to stop the session.

Command Default

No sessions are started.

Command Modes

Privileged EXEC mode

Command History


Release	Modification
12.2(33)SCB	This command was introduced.
IOS-XE 3.15.OS	This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command allows the user to start or stop a specific session. This command can be executed only when the IPDR exporter is started.

Note

The user has to stop the session before configuring any tasks if the session is active.

Examples

The following example enables the user to start a session.


Router# configure terminal
Router(config)#ipdr session 1 start

Related Commands


Command	Description
ipdr exporter start	Starts the IPDR Exporter and connects to the collector.
show ipdr exporter	Displays information about the IPDR Exporter state.
ipdr associate	Associates the Collector with a session.

ipdr session (global configuration)

To enable the CMTS application to add a session to the Internet Protocol Detail Record (IPDR) exporter, use the ipdr session command in global configuration mode. To remove the session, use the no form of this command.

ipdr session session_id session_name session_descr

no ipdr session session_id

Syntax Description


`session_id`	The unique IPDR session ID.
`session_name`	The session name. The name should not contain extra spaces.
`session_descr`	The description of the session.

Command Default

No sessions are added to the IPDR exporter. It depends on the status of the IPDR exporter. After configuring one session;if the status of exporter is started, then the session is started automatically.

Command Modes

Global configuration mode

Command History


Release	Modification
12.2(33)SCB	This command was introduced.
IOS-XE 3.15.OS	This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command allows the user to add a session to the IPDR exporter. User should provide session ID, session name and session description for every session.

The no form of the command will remove a specific session. Once a session is removed, the template and other information associated with the session is also lost.

Note

You can not update template details or other details when a session already created.

Examples

The following example adds a session to the Exporter.


Router# configure terminal
Router(config)#ipdr session  1 test no_descr

Related Commands


Command	Description
ipdr exporter start	Starts the IPDR exporter and connects to the collector.
show ipdr exporter	Displays information about the IPDR exporter state.
ipdr associate	Associates the IPDR collector with a session.

ipdr template

To add an Internet Protocol Detail Record (IPDR) template to the IPDR session on the Cisco CMTS, use the ipdr template command in global configuration mode. To remove the template, use the no form of this command.

ipdr template session_id template_name

no ipdr template session_id template_name

Syntax Description


`session_id`	Unique IPDR Session ID.
`template_name`	Template name.

Command Default

The IPDR template is not added to the IPDR session.

Command Modes

Global configuration (config)

Command History


Release	Modification
12.2(33)SCB	This command was introduced.
12.2(33)SCG	A new template SERVICE-FLOW is added to the event-based and ad-hoc session types.
12.2(33)SCH5	A new template is defined for CM-STATUS and the old template is renamed as CM-STATUS-2008.
12.2(33)SCI1	This command is integrated from Cisco IOS Release 12.2(33)SCH5.
IOS-XE 3.15.OS	This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command allows the user to add an IPDR template to the desired session (based on session ID) on the Cisco CMTS.

Note

You can only add the system-supported templates. The list can be viewed by entering “?” at the command prompt.

Examples

The following example displays the show running-config command output of the configured IPDR sessions and types:


Router(config)# do show running-config | i ipdr
ipdr session 1 test test
ipdr session 2 event2 event2
ipdr session 3 ad-hoc3 ad-hoc3
ipdr type 1 time-interval 15
ipdr type 2 event
ipdr type 3 event

The following example shows the templates available in a timer-interval session.


Router# ipdr template 1 ?
  CM-STATUS       DOCSIS-CMTS-CM-REG-STATUS-TYPE template
  CM-US           DOCSIS-CMTS-CM-US-STATS-TYPE template
  DIAGLOG-DETAIL  DOCSIS-DIAG-LOG-DETAIL-TYPE template
  SAMIS-TYPE1     DOCSIS-SAMIS-TYPE-1 template
  SAMIS-TYPE2     DOCSIS-SAMIS-TYPE-2 template
  SPECTRUM        DOCSIS-SPECTRUM-MEASUREMENT-TYPE template
  TEST            Template for test

The following example shows how to add the SAMIS_TYPE1 template in a timer-interval session.


Router(config)# ipdr template 1 SAMIS-TYPE1

The following example shows how to view the templates available in an event-based session.


Router(config)# ipdr template 2 ?
  CM-STATUS       DOCSIS-CMTS-CM-REG-STATUS-TYPE template
  CPE-TYPE        DOCSIS-CPE-TYPE template
  DIAGLOG-DETAIL  DOCSIS-DIAG-LOG-DETAIL-TYPE template
  DIAGLOG-EVENT   DOCSIS-DIAG-LOG-EVENT-TYPE template
  DS-UTIL         DOCSIS-CMTS-DS-UTIL-STATS-TYPE template
  SAMIS           OSSI2.0 SAMIS template
  SERVICE-FLOW    SERVICE-FLOW-TYPE template
  TEST            Template for test
  TOPOLOGY        DOCSIS-CMTS-TOPOLOGY-TYPE template
  US-UTIL         DOCSIS-CMTS-US-UTIL-STATS-TYPE template

The following example shows how to view the templates available in an ad-hoc session.


Router(config)# ipdr template 3 ?
  CM-STATUS       DOCSIS-CMTS-CM-REG-STATUS-TYPE template
  CPE-TYPE        DOCSIS-CPE-TYPE template
  DIAGLOG-DETAIL  DOCSIS-DIAG-LOG-DETAIL-TYPE template
  DIAGLOG-EVENT   DOCSIS-DIAG-LOG-EVENT-TYPE template
  DS-UTIL         DOCSIS-CMTS-DS-UTIL-STATS-TYPE template
  SAMIS           OSSI2.0 SAMIS template
  SERVICE-FLOW    SERVICE-FLOW-TYPE template
  TEST            Template for test
  TOPOLOGY        DOCSIS-CMTS-TOPOLOGY-TYPE template
  US-UTIL         DOCSIS-CMTS-US-UTIL-STATS-TYPE template

The following example shows the templates available in a timer-interval session for Cisco IOS Release 12.2(33)SCH5:

Router(config)# ipdr template 1 ?

  CM-STATUS       DOCSIS-CMTS-CM-REG-STATUS-TYPE template
  CM-STATUS-2008  DOCSIS-CMTS-CM-REG-STATUS-TYPE-2008 template
  CPE-TYPE        DOCSIS-CPE-TYPE template
  DIAGLOG-DETAIL  DOCSIS-DIAG-LOG-DETAIL-TYPE template
  DIAGLOG-EVENT   DOCSIS-DIAG-LOG-EVENT-TYPE template
  DS-UTIL         DOCSIS-CMTS-DS-UTIL-STATS-TYPE template
  SAMIS           OSSI2.0 SAMIS template
  SERVICE-FLOW    SERVICE-FLOW-TYPE template
  TEST            Template for test
  TOPOLOGY        DOCSIS-CMTS-TOPOLOGY-TYPE template
  US-UTIL         DOCSIS-CMTS-US-UTIL-STATS-TYPE template

Related Commands


Command	Description
ipdr exporter start	Starts the IPDR Exporter on the Cisco CMTS and connects to the collector.
show ipdr exporter	Displays information about the IPDR Exporter state on the Cisco CMTS.
ipdr session	Adds a session to the IPDR Exporter on the Cisco CMTS.

ipdr type

To configure the IPDR session type, use the ipdr type command in global configuration mode. The IPDR session types that can be defined using this command are event type, time-interval type, and the ad hoc type.

Use the no form of the command to reset the session type to the default "event" type.

ipdr type session_id [ad-hoc | event | time-interval value]

no ipdr type session_id

Syntax Description


`session` `id`	IPDR session ID. Range is from 1 to 255.
ad-hoc	The ad hoc session type.
event	The event session type.
time-interval `value`	The time-interval session type. Interval range is from 15 to 1440 minutes.

Command Default

The IPDR session type is not defined.

Command Modes

Global configuration (config)

Command History


Release	Modification
12.2(33)SCD2	This command was introduced.
IOS-XE 3.15.OS	This command was implemented on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

This command allows the user to define the specific IPDR session type.

Note

Once the IPDR session type is configured, the templates supported by this IPDR type are automatically associated with it.

Examples

The following example shows how to configure the IPDR “time-interval” session type for a time interval of 15 minutes.


Router> enable
Router# configure terminal
Router(config)# ipdr type 1 time-interval 15

Related Commands


Command	Description
cable ipdr cm-us-status interval	Displays a cable modem’s upstream channel status information.
cable ipdr docs-spectrum interval	Sets the interval between different spectrum measurements’ data for a CMTS.
cable ipdr diaglog interval	Sets the time interval between different diagnostic logs’ data for a CMTS.
cable ipdr cm-status interval	Displays the CMTS and cable modem registration status information.

ipv6 address

To configure IPv6 segment routing (SRv6), use the ipv6 address command in the global configuration mode.

ipv6 address {ipv6_address_prefix | prefix_length} segment-routing

no ipv6 address {ipv6_address_prefix | prefix_length} segment-routing


`ipv6_address_prefix`	IPv6 prefix associated with a particular SAV group, specified in the X:X:X:X::/X format.
`prefix_length`	Length of the IPv6 prefix. The valid range is from 0 to 128

Command Default

None.

Command Modes

Global configuration mode (config)

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

This command is used to configure IPv6 Segment Routing. You can also configure multiple IPv6 addresses for SRv6 under the same interface. An IPv6 address with a prefix SID can also be associated with SRv6. to define a local prefix as an SID, use the following commands:

ipv6-sr prefix-sid

Use the no ipv6-sr prefix-sid command to disable the local prefix SID.

Examples

The following example shows how to configure IPv6 segment routing.

Router#config terminal 
Enter configuration commands, one per line. End with CNTL/Z. 
Router(config)#inter Ether0/0 
Router(config-if)#ipv6 address 2001::0DB8/32 segment-routing
Router(config-if-sr-ipv6)#ipv6-sr prefix-sid
Router(config-if-sr-ipv6)#exit 
Router(config-if)#exit
Router(config)#exit

Examples

The following example shows how to configure multiple IPv6 addresses for SRv6 under the same interface.

Router#config terminal 
Enter configuration commands, one per line. End with CNTL/Z. 
Router(config)#inter Ether 0/0 
Router(config-if)# ipv6 address 110::110/64 segment-routing 
Router(config-if)# ipv6 address 111::111/64 segment-routing 
Router(config-if-sr-ipv6)#ipv6-sr prefix-sid 
Router(config-if-sr-ipv6)#end

Related Commands


Command	Description
ipv6-sr prefix-sid	Defines a local prefix as an SID.

issu linecard abortversion

To roll back the current image version on a single line card or multiple line cards to the previous version, use the issu linecard abortversion command in the privileged EXEC mode.

Note

This command is used to roll back the versions on redundant line cards only.

issu linecard abortversion {all| lc slot/subslot} [ forced]

Syntax Description


all	All redundant line cards.
l`c_slot`	The line card slot number.
`subslot`	The line card sub slot number.
forced	(Optional) The ISSU would ignore potential service outage and line card incompatibility errors and proceed with abortversion instead of stopping and error handling.

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

This command allows the user to roll back to prior image on working or primary line card on a single or multiple line cards to the previous versions.

Note

The issu linecard reloadversion command is used to reload a line card with the original version of images.

The following example rolls back the specific redundant line card’s image version.


Router# configure terminal 
Router(config)#issu linecard abortversion

Related Commands


Command	Description
issu linecard acceptversion	Accepts the new image version on the working line card.
issu linecard loadversion	Loads a specific image version on the primary line card.
issu linecard prepareversion	Determines if the image version on the line card has to be upgraded or downgraded to the route processor’s image version.
issu linecard reloadversion	Reloads the new loaded image on a working or a primary line card.
issu linecard runversion	Runs the new loaded image on a working or a primary line card.
issu linecard changeversion	Starts the upgrade or downgrade activity of the image version for a single line card or multiple line cards.

issu linecard acceptversion

To accept the new image version on the working line card, use the issu linecard acceptversion command in the privileged EXEC mode.

issu linecard acceptversion lc slot [ /subslot]

Syntax Description


`lc_slot`	The line card slot number.
`subslot`	The line card sub slot number.

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

This command allows the user to accept the new image version on the working line card. The command also indicates the completion of changing the image version for the specific line card and allows the ISSU of the next line card in the queue.

Examples

The following example indicates a command accepting the image version on the slot 7 of the line card.


Router# configure terminal
Router(config)#issu linecard acceptversion 7/0

Related Commands


Command	Description
issu linecard abortversion	Rolls back to the prior image on working/primary line card.
issu linecard loadversion	Loads a specific image version on the primary line card.
issu linecard prepareversion	Determines if the image version on the line card has to be upgraded or downgraded to the route processor’s image version.
issu linecard reloadversion	Reloads the new loaded image on a working or a primary line card.
issu linecard runversion	Runs the new loaded image on a working or a primary line card.
issu linecard changeversion	Starts the upgrade or downgrade activity of the image version for a single line card or multiple line cards.

issu linecard changeversion

To start the upgrade or downgrade activity of the image version for a single working line card or multiple working line cards, use the issu linecard changeversion command in the privileged EXEC mode.

Note

Effective with Cisco IOS Release 12.2(33)SCH2, the issu linecard changeversion command is used to check and upgrade the line card images automatically during the RP-only ISSU process.

issu linecard changeversion { all | stop| slot_1 [/subslot_1]} ... [ slot_n [/subslot_n]] [ forced]

Syntax Description


all	All redundant line cards.
`slot_1`	The slot number for the first line card.
`subslot_1`	The sub slot number for the first line card.
`slot_n`	The slot number for the n th line card.
`subslot_n`	The sub slot number for the n th line card.
forced	(Optional) The ISSU would ignore potential service outage and line card incompatibility errors and proceed with changeversion instead of stopping and error handling.

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

This command allows the user to start the upgrade or downgrade activity of the image version for a single line card or multiple line cards. Here the line cards are of the primary or working type only.

Using the all option, you can change the image version of all the redundant line cards instead of specifying explicity each of the line card.

Using the stop option, you can stop the version change process for a line card.

Examples

The following example displays the command and uses the all option.


Router# configure terminal
Router(config)#issu linecard changeversion all

The following example displays the command and uses the slot value of 6.


Router# configure terminal
Router(config)#issu linecard changeversion 6/0

Related Commands


Command	Description
issu linecard abortversion	Rolls back to the prior image on working/primary line card.
issu linecard acceptversion	Accepts the new image version on the working line card.
issu linecard loadversion	Loads a specific image version on the primary line card.
issu linecard prepareversion	Determines if the image version on the line card has to be upgraded or downgraded to the route processor’s image version.
issu linecard reloadversion	Reloads the new loaded image on a working or a primary line card.
issu linecard runversion	Runs the new loaded image on a working or a primary line card.

issu linecard loadversion

To load a specific image version on the primary line card, use the issu linecard loadversion command in the privileged EXEC mode.

issu linecard loadversion slot[ /subslot]

Syntax Description


`slot`	The line card slot number.
`subslot`	The line card sub slot number.

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

This command allows the user to load a specific image version on the working line card.

Examples

The following example shows the command that loads the image version on a line card with the slot number 7.


Router# configure terminal
Router(config)#issu linecard loadversion 7/0

Related Commands


Command	Description
issu linecard abortversion	Rolls back to the prior image on working/primary line card.
issu linecard acceptversion	Accepts the new image version on the working line card.
issu linecard prepareversion	Determines if the image version on the line card has to be upgraded or downgraded to the route processor’s image version.
issu linecard reloadversion	Reloads the new loaded image on a working or a primary line card.
issu linecard runversion	Runs the new loaded image on a working or a primary line card.
issu linecard changeversion	Starts the upgrade or downgrade activity of the image version for a single line card or multiple line cards.

issu linecard prepareversion

To determine if the image version on the line card has to be upgraded or downgraded to the route processor’s image version, use the issu linecard prepareversion command in the privileged EXEC mode.

issu linecard prepareversion lc_slot[/subslot] [ forced]

Syntax Description


`lc_slot`	The line card slot number.
`subslot`	The line card sub slot number.
forced	(Optional) The ISSU would ignore potential service outage and line card incompatibility errors and proceed with prepareversion instead of stopping and error handling.

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

This command allows the user to check if the image version on the line card has to be upgraded or downgraded to the route processor’s image version.

This command also checks if the line card has a valid redundancy configuration. If the line card does not have a valid configuration, then the user has to reload the line card using the issu linecard reloadversion command.

Examples

The following example shows the command executed for a line card with a slot value of 7.


Router# configure terminal
Router(config)#issu linecard prepareversion 7/0

Related Commands


Command	Description
issu linecard abortversion	Rolls back to the prior image on working/primary line card.
issu linecard acceptversion	Accepts the new image version on the working line card.
issu linecard loadversion	Loads a specific image version on the primary line card.
issu linecard reloadversion	Reloads the new loaded image on a working or a primary line card.
issu linecard runversion	Runs the new loaded image on a working or a primary line card.
issu linecard changeversion	Starts the upgrade or downgrade activity of the image version for a single line card or multiple line cards.

issu linecard process stop

Note

Effective with Cisco IOS Release 12,2(33)SCG and later, issu linecard process stop is no longer supported on the Cisco CMTS router.

To stop the automatic line card ISSU process, use the issu linecard process stop command in privileged EXEC mode mode.

issu lineccard process stop

Syntax Description

This command has no arguments or keywords.

Command Default

This command is enabled by default.

Command Modes

Privileged EXEC (#)

Command History


Release	Modification
12.2(33)SCB	This command was introduced.
12.2(33)SCG	This command is obsolete.
IOS-XE 3.15.0S	This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Use the issu linecard process stop command to interrupt the automatic ISSU process continuing to the next line card

Associated Features:

The issu linecard process stop command is associated with following features:

Cisco IOS In Service Software Upgrade Process

Examples

Example

The following example shows how to stop the ISSU process:


Router> enable
Router# issu linecard process stop

Related Commands


Command	Description
issu linecard abortversion	Rolls back to the prior image on working/primary line card.
issu linecard acceptversion	Accepts the new image version on the working line card.
issu linecard loadversion	Loads a specific image version on the primary line card.
issu linecard prepareversion	Determines if the image version on the line card has to be upgraded or downgraded to the route processor’s image version.
issu linecard reloadversion	Reloads the new loaded image on a working or a primary line card.
issu linecard runversion	Runs the new loaded image on a working or a primary line card.
issu linecard changeversion	Starts the upgrade or downgrade activity of the image version for a single line card or multiple line cards.

issu linecard reloadversion

To reload the new loaded image on a working or a primary line card, use the issu linecard reloadversion command in the privileged EXEC mode.

issu linecard prepareversion {original | target} {all| [slot_1 [subslot_1]| ... [slot_n [/subslot_n]]}

Syntax Description


original	The original image version.
all	All redundant line cards.
`slot_1`	The slot number for the first line card.
`subslot_1`	The sub slot number for the first line card.
`slot_n`	The slot number for the n th line card.
`subslot_n`	The sub slot number for the n th line card.

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

This command allows the user to reload the new loaded image on a working or a primary line card.

This command can be used for the following line card conditions.

Line cards that are not configured with redundancy, and do not support Minimal Disruptive Restart (MDR.)
Line cards which are capable of line card redundancy which were rolled back due to an unsuccessful changeversion command.

Examples

The following example shows the command executed with the original keyword.


Router# configure terminal
Router(config)#issu linecard reloadversion original 8/0

The following example shows the command executed with the target keyword.


Router# configure terminal
Router(config)#issu linecard reloadversion target 8/0

Related Commands


Command	Description
issu linecard abortversion	Rolls back to the prior image on working or primary line card.
issu linecard acceptversion	Accepts the new image version on the working line card.
issu linecard loadversion	Loads a specific image version on the primary line card.
issu linecard prepareversion	Determines if the image version on the line card has to be upgraded or downgraded to the route processor’s image version.
issu linecard runversion	Runs the new loaded image on a working or a primary line card.
issu linecard changeversion	Starts the upgrade or downgrade activity of the image version for a single linecard or multiple line cards.

issu linecard runversion

To run the new loaded image on a working or a primary line card, use the issu linecard runversion command in the privileged EXEC mode.

issu linecard runversion lc_slot[/ subslot] [ forced]

Syntax Description


`lc_slot`	The line card slot number.
`subslot`	The line card sub slot number.
forced	(Optional) The ISSU would ignore potential service outage and line card incompatibility errors and proceed with runversion instead of stopping and error handling.

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

This command allows the user to run the new loaded image on a working or a primary line card.

Examples

The following example displays the command executed to run the loaded image in the line card slot 7.


Router# configure terminal
Router(config)#issu linecard runversion 7/0

Related Commands


Command	Description
issu linecard abortversion	Rolls back to the prior image on the working/primary line card.
issu linecard acceptversion	Accepts the new image version on the working line card.
issu linecard loadversion	Loads a specific image version on the primary line card.
issu linecard prepareversion	Determines if the image version on the line card has to be upgraded or downgraded to the route processor’s image version.
issu linecard reloadversion	Reloads the new loaded image on a working or a primary line card.
issu linecard changeversion	Starts the upgrade or downgrade activity of the image version for a single linecard or multiple line cards.

jitter

To set session jitter, use the jitter command in cable video configuration mode. To disable session jitter, use the no form of this command.

jitter {sdv | vod | broadcast | gaming | table-based}value

no jitter {sdv | vod | broadcast | gaming | table-based}value

Command Default

None.

Command Modes

Cable video configuration (config-video)


Release	Modification
IOS-XE 16.4.1	This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Examples

The following example shows how to set session jitter:


Router# configure terminal
Router(config)# cable video
Router(config-video)# jitter gaming 5

Related Commands


Command	Description
show cable video jitter	Displays the session jitter information.

join-group

To join multicast group address, use the join-group command in OOB virtual OM configuration mode. To void the virtual OM configuration, use the no form of this command.

join-group ip source-ip ip out-group ip

no join-group ip source-ip ip out-group ip

Syntax Description


join-group `ip`	Specifies the group IP address.
source-ip `ip`	Specifies the SSM source IP address.
out-group `ip`	Specifies the local OM group IP address.

Command Default

None

Command Modes

OOB Virtual OM configuration (config-oob-vom)

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 join multicast group address.

Examples

The following example shows how to join multicast group address:


Router# configure terminal
Router(config)# cable oob
Router(config-oob)# virtual-om 1
Router(config-oob-vom)# join-group 235.1.1.1 source-ip 2.3.4.5 out-group 239.2.2.2

Related Commands


Command	Description
virtual-om	Defines a virtual OM configuration.
ip	Configures the virtual OM source IP address.

keepalive

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

lacp fast-switchover

To enable Link Aggregation Control Protocol (LACP) 1:1 link redundancy, use the lacp fast-switchover command in interface configuration mode. To disable LACP 1:1 link redundancy, use the no form of this command.

lacp fast-switchover

no lacp fast-switchover

Syntax Description

This command has no arguments or keywords.

Command Default

LACP 1:1 link redundancy is disabled by default.

Command Modes

Interface configuration (config-if)

Command History


Release	Modification
Cisco IOS 12.2(33)SCJ	This command was introduced.

Usage Guidelines

Prior to entering the lacp fast-switchover command, you must ensure the following:

The port channel protocol type is LACP.
The lacp max-bundle 1 command has been entered on the port channel. The lacp fast-switchover command will not affect the lacp max-bundle command.

When you enable LACP 1:1 link redundancy, based on the system priority and port priority, the port with the higher system priority chooses the link as the active link and the other link as the standby link. When the active link fails, the standby link is selected as the new active link without taking down the port channel. When the original active link recovers, it reverts to its active link status. During this change-over, the port channel is also up.

Note

We recommend that you configure two ports only (one active and one hot-standby) in the bundle for optimum performance.

Examples

This example shows how to enable LACP 1:1 link redundancy:


Router(config-if)# lacp fast-switchover

Related Commands


Command	Description
lacp max-bundle	Assigns and configures an EtherChannel interface to an EtherChannel group.
show etherchannel	Displays the EtherChannel information for a channel.

lacp max-bundle

To define the maximum number of active bundled Link Aggregation Control Protocol (LACP) ports allowed in a port channel, use the lacp max-bundle command in interface configuration mode. To return to the default settings, use the no form of this command.

lacp max-bundle max-bundles number

no lacp max-bundle

Syntax Description


`max-bundles`	Maximum threshold of active member links allowed in the LACP bundle. The range from is 1 to 8. The maximum threshold value must be greater than or equal to the minimum threshold value.

Command Default

A maximum number of active bundled ports is not configured.

Command Modes

Interface configuration (config-if)

Command History


Release	Modification
Cisco IOS 12.2(33)SCJ	Support for this command was introduced.

Usage Guidelines

The value specified in the max-bundles argument determines the number of active links that are bundled in the port channel. The remaining links are in hot-standby mode.

Examples

This example shows how to set 3 ports to bundle in port channel 2:


Router(config)# interface port-channel 2
Router(config-if)# lacp max-bundle 3
Router(config-if)#

Related Commands


Command	Description
interface port-channel	Creates a port-channel virtual interface and puts the CLI in interface configuration mode.
ip address	Sets a primary or secondary IP address on an interface.
show etherchannel	Displays the EtherChannel information for a channel.
show interfaces port-channel	Displays traffic that is seen by a specific port channel.

lacp min-bundle

To define the minimum number of active bundled LACP ports allowed in a port channel, use the lacp min-bundle command in interface configuration mode. To return to the default settings, use the no form of this command.

lacp min-bundle min-bundle

no lacp min-bundle

Syntax Description


`min-bundle`	Minimum threshold of active member links allowed in the LACP bundle. The range is from 1 to 8. The default is 1.

Command Default

The port-channel operational state will be “Down” only when there are no active links in the channel. If there are one or more active links, the port-channel state will be “Up.”

Command Modes

Interface configuration (config-if)

Command History


Release	Modification
Cisco IOS 12.2(33)SCJ	This command was introduced.

Usage Guidelines

Use the lacp min-bundle command to configure the minimum number of active links allowed in an LACP bundle. When the number of active links falls below this minimum threshold, the port channel shuts down.

Examples

This example shows how to set the minimum number of active links to five ports:

Device(config-if)# lacp min-bundle 5

Related Commands


Command	Description
interface port-channel	Creates a port-channel virtual interface and enters interface configuration mode.
ip address	Sets a primary or secondary IP address on an interface.
show etherchannel	Displays the EtherChannel information for a channel.
show interfaces port-channel	Displays traffic that is seen by a specific port channel.

lacp port-priority

To set the LACP priority for a physical interface, use the lacp port-priority command in interface configuration mode. To return to the default setting, use the no form of this command.

lacp port-priority priority

no lacp port-priority

Syntax Description


`priority`	Integer that indicates the priority for the physical interface. The range is from 0 to 65535. The default is 32768.

Command Default

The default port priority is set.

Command Modes

Interface configuration (config-if)

Command History


Release	Modification
Cisco IOS 12.2(33)SCJ	This command was introduced.

Usage Guidelines

You may assign a port priority to each port on a device running Link Aggregation Control Protocol (LACP). You can specify the port priority by using the lacp port-priority command at the command-line interface (CLI) or use the default port priority (32768) that is carried as part of the LACP protocol data unit (PDU) exchanged with the partner. Port priority is used to decide which ports should be put in standby mode when a hardware limitation or the lacp max-bundle command configuration prevents all compatible ports from aggregating. Priority is supported only on port channels with LACP-enabled physical interfaces.

Note

A high priority number means a low priority.

Port priority together with port number form a port identifier.

To verify the configured port priority, issue the show lacp command.

Examples

This example shows how to set a priority of 23700 for an interface:


Device> enable
Device#  configure terminal
Device(config)#  interface ethernet 0/0
Device(config-if)# lacp port-priority 23700
Device(config-if)#

Related Commands


Command	Description
channel-group	Assigns and configures an EtherChannel interface to an EtherChannel group.
debug lacp	Enables debugging of LACP activities.
lacp max-bundle	Defines the maximum number of active bundled LACP ports allowed in a port channel.
lacp system-priority	Sets the priority of the system.
show lacp	Displays information about LACP activity on the device.

lacp system-priority

To set the priority for a system, use the lacp system-priority command in global configuration mode. To return to the default setting, use the no form of this command.

lacp system-priority priority

no lacp system-priority

Syntax Description


`priority`	Integer that indicates the LACP priority for the system. The range is from 0 to 65535. The default is 32768.

Command Default

The default system priority is set.

Command Modes

Global configuration (config)

Command History


Release	Modification
Cisco IOS 12.2(33)SCJ	This command was introduced.

Usage Guidelines

You can assign a system priority to each device running Link Aggregation Control Protocol (LACP). You can specify the system priority by using the lacp system-priority command at the command-line interface (CLI) or use the default system priority (32768) that is carried as part of the LACP protocol data unit (PDU) exchanged with the partner. System priority is used with the MAC address of the device to form the system ID and also is used during negotiation with other systems. Priority is supported only on port channels with LACP-enabled physical interfaces.

Note

A high priority number means a low priority.

To verify the configured system priority, issue the show lacp command.

Examples

The following example shows how to set a system priority of 25500 for a device:


Router> enable
Router# configure terminal
Router(config)# lacp system-priority 25500

Related Commands


Command	Description
channel-group	Assigns and configures an EtherChannel interface to an EtherChannel group.
debug lacp	Enables debugging of LACP activities.
lacp port-priority	Sets the priority of a port.
show lacp	Displays information about LACP activity on the device.

lane start-freq

To set the start frequency for a specific lane, use the lane start-freq command from frequency profile configuration mode.

lane lane_idstart-freq start-freq

Syntax Description


`lane_id`	Specifies the ID of the lane that the start frequency to be set.
`start-freq`	Configures the start frequency for the lane.

Command Default

None

Command Modes

Frequency profile configuration (config-freq-prof)

Command History


Release	Modification
IOS-XE 3.15.0S	This command was introduced on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Use this command to set the start frequency for a specific lane.

Examples

The following example shows how to set start frequency for a specific lane:


Router# Configure terminal
Router(config)# cable downstream freq-profile 4
Router(config-freq-prof)# lane 1 start-freq 45000000

Related Commands


Command	Description
cable downstream freq-profile	Set the start frequency for a specific lane.

lc-control-plane-timeout

To set the interval of monitoring cable line card control plane process restart, use the lc-control-plane-timeout time command in the process restart configuration mode.

lc-control-plane-timeout time

Syntax Description


`time`	Cable line card control plane process restart monitoring interval in seconds.

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 interval of monitoring cable line card control plane process restart.

The following example shows how to set the interval of monitoring cable line card control plane process restart.


Router# configure terminal 
Router(config)# process-restart
Router(config-process-restart)# lc-control-plane-timeout 200

Related Commands


Command	Description
lc-us-scheduler-timeout	Sets the interval of monitoring cable line card upstream scheduler process restart.
restart-retry	Sets the retrying times for process restart.

lc-us-scheduler-timeout

To set the interval of monitoring cable line card upstream scheduler process restart, use the lc-us-scheduler-timeout time command in the process restart configuration mode.

lc-us-scheduler-timeout time

Syntax Description


`time`	Cable line card upstream scheduler process restart monitoring interval in seconds.

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 interval of monitoring cable line card upstream scheduler process restart.

The following example shows how to set the interval of monitoring cable line card upstream scheduler process restart.


Router# configure terminal 
Router(config)# process-restart
Router(config-process-restart)# lc-us-scheduler-timeout 200

Related Commands


Command	Description
lc-control-plane-timeout	Sets the interval of monitoring cable line card control plane process restart.
restart-retry	Sets the retrying times for process restart.

lcha-preferred

To select the LCHA when it is possible, use the lc-control-plane-timeout command in the process restart configuration mode. To disable this function, use the no form of this command.

lcha-preferred no lcha-preferred

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 selects the LCHA when it is possible.

The following example shows how to select the LCHA when it is possible.


Router# configure terminal 
Router(config)# process-restart
Router(config-process-restart)# lcha-preferred

Related Commands


Command	Description
disable-auto-restart	Disables the automatic process restart.

license feature evaluation disable

To disable an evaluation license for Cisco uBR-MC3GX60V and Cisco UBR-MC20X20V cable interface line cards on the Cisco uBR10012 router, use the license feature evaluation disable command in global configuration mode.

license feature evaluation disable {DS_license | US_license | all }subslot slot/subslot

Syntax Description


disable	Disables an evaluation license for a cable interface line card.
DS_License	Disables a downstream evaluation license for a cable interface line card.
US_License	Disables an upstream evaluation license for a cable interface line card.
all	Disables both downstream and upstream evaluation licenses for a cable interface line card.
subslot `slot/subslot`	`slot` —Slot where the line card resides. The valid range is from 5 to 8. `subslot` —Secondary slot number of the cable interface line card. The valid value is 0 or 1.

Command Default

A cable interface line card evaluation license is disabled by default.

Command Modes

Global configuration (config)

Command History


Release	Modification
12.2(33)SCE	This command was introduced.
IOS-XE 3.15.0S	This command is not supported on the Cisco cBR Series Converged Broadband Routers.

Usage Guidelines

Evaluation licenses are temporary and used to evaluate a feature set on a new line card. Ensure that an equivalent permanent license is installed on the Cisco CMTS before the evaluation license expires to avoid any service disruptions.

To obtain evaluation licenses from the Cisco licensing portal, go to: https://tools.cisco.com/SWIFT/LicensingUI/demoPage

Examples

The following example shows how to disable both downstream and upstream evaluation licenses for a cable interface line card on the Cisco uBR10012 router:


Router# configure terminal
Router(config)# license feature evaluation disable all subslot 5/0

The following example shows how to disable a downstream evaluation license for a cable interface line card on the Cisco uBR10012 router:


Router# configure terminal
Router(config)# license feature evaluation disable DS_License subslot 6/0

The following example shows how to disable an upstream evaluation license for a cable interface line card on the Cisco uBR10012 router:


Router# configure terminal
Router(config)# license feature evaluation disable US_License subslot 6/1

Related Commands


Command	Description
license feature evaluation enable	Enables an evaluation license for Cisco uBR-MC3GX60V and Cisco UBR-MC20X20V cable interface line cards.

license feature evaluation enable

To enable an evaluation license for Cisco uBR-MC3GX60V and Cisco UBR-MC20X20V cable interface line cards on the Cisco uBR10012 router, use the license feature evaluation enable command in global configuration mode.

license feature evaluation enable {DS_License | US_License | all }subslot slot/subslot

Syntax Description


enable	Enables an evaluation license for a cable interface line card.
DS_License	Enables a downstream evaluation license for a cable interface line card.
US_License	Enables an upstream evaluation license for a cable interface line card.
all	Enables both downstream and upstream evaluation licenses for a cable interface line card.
subslot `slot/subslot`	`slot` —Slot where the cable interface line card resides. The valid range is from 5 to 8. `subslot` —Secondary slot number of the cable interface line card. The valid value is 0 or 1.

Command Default

A cable interface line card evaluation license is not enabled by default.

Command Modes

Global configuration (config)

Command History


Release	Modification
12.2(33)SCE	This command was introduced.

Bias-Free Language

Results

Chapter: Cable Commands: i through p

Cable Commands: i through p

identifier

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Examples

Related Commands

init-tech-list

Syntax Description

Command Default

Command Modes

Command History

Examples

Related Commands

init-tech-ovr

Cisco uBR10012 Router

Cisco uBR7225VXR and Cisco uBR7246VXR Routers

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Examples

Related Commands

interface cable

Cisco IOS Release 12.2(33)SCE and later

Syntax Description

Command Default

Command Modes

Command History

Examples

Related Commands

interface cable-modem

Cisco uBR904, uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Examples

Related Commands

interface integrated-cable

Cisco uBR10012 Universal Broadband Router

Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband Router

Cisco cBR Series Converged Broadband Routers

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Examples

Related Commands

interface modular-cable

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

Cisco IOS Release 12.2(33)SCB

Cisco IOS Release 12.2(33)SCE

Syntax Description

Command Default

Command Modes

Command History

Examples

Related Commands

interface port-channel

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Examples

Related Commands

interface virtualportgroup

Syntax Description

Command Default

Command Modes