To move a
specified cable modem or a group of cable modems to another channel, or to test
Dynamic Channel Change (DCC) for load balancing on the Cisco CMTS, use the
following command in privileged EXEC mode.
test
cable
dcc {source-interface
[cable
slot /subslot /cable-interface-index
|
integrated-cable
slot /subslot /cable-interface-index |
modular-cable
slot /subslot /cable-interface-index ] |
sid |
ip-addr |
mac-addr
|
frequency
frequency }
{destination-interface [cable
slot /subslot /cable-interface-index
|
integrated-cable
slot /subslot /cable-interface-index |
modular-cable
slot /subslot /cable-interface-index ]
upstream-port } {init-tech |
force |
tlv }
Cisco cBR Series Converged Broadband Routers
test
cable
dcc
{
source-interface
[
integrated-cable
slot/subslot/cable-interface-index
|
ip-addr
|
mac-addr } { destination-interface
[
integrated-cable
slot/subslot/cable-interface-index
]
upstream-port}
{ init-tech}
Syntax Description
source-interface
|
Source
interface of the cable modem. Use any one of the following options:
- (Not applicable for Cisco cBR Series
Converged Broadband Routers)
cable —Specifies the name of the source downstream
interface for the DCC transaction.
- (For Cisco cBR Series
Converged Broadband Routers)
integrated-cable —Specifies the name of the
integrated-cable interface to which the cable modem belongs.
- (Not applicable for Cisco cBR Series
Converged Broadband Routers)
modular-cable —Specifies the name of the
modular-cable interface to which the cable modem belongs.
- slot /subslot /cable-interface-index —Slot, subslot, and
downstream controller number assigned to the cable modem.
|
sid
|
(Optional) Specifies the primary Service ID (sid) value of the cable modem for
that interface.
|
ip-addr
|
Specifies the IP address of the cable modem to be moved for DCC test.
|
mac-addr
|
Specifies the MAC address of the cable modem to be moved for DCC test.
|
frequency
frequency
|
Specifies the DCC downstream frequency parameter.
(Not applicable for Cisco cBR Series
Converged Broadband Routers)
frequency— New downstream frequency in Hz. The
valid range is between 55000000 to 1050000000 Hz.
|
destination-interface
|
Destination interface of the cable modem. Use any one of the following options:
- cable —Specifies the name of the target or
destination downstream interface to which the cable modem should be moved.
- integrated-cable —Specifies the name of the
integrated-cable interface to which the cable modem should be moved.
- modular-cable —Specifies the name of the
modular-cable interface to which the cable modem should be moved.
- slot /subslot /cable-interface-index —Slot, subslot, and
downstream controller number assigned to the cable modem.
|
upstream-port
|
Specifies the upstream port of the destination interface.
|
init-tech
|
(Optional) DOCSIS 3.0 GLBG DCC initialization techniques. The valid range is
from 1 to 4.
For
Cisco cBR Series Converged Broadband Routers, the valid range is from 0 to 4.
Note
|
If
init-tech
is not specified, its value is taken as 0.
|
|
force
|
(Optional) (Not for Cisco cBR Series Routers) Target modem or group of modems
that are forced to move to the specified downstream interface or upstream
channel.
Note
|
This option is available only when init-tech is set to 0 and is used to move
cable modems with Internet Group Management Protocol (IGMP) or
Resource-reservation protocol (RSVP) configuration.
|
Note
|
This option cannot be used with the
tlv
option.
|
|
tlv
|
(Optional) (Not for Cisco cBR Series Routers) Specifies the type-length-value
(TLV) in a DCC request message. This is represented as HEX data.
Note
|
force option is not available if the
tlv option is used.
|
|
Command Default
Test functions
are disabled by default.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.3(17a)BC
|
This
command was introduced on the Cisco uBR10012 router and the Cisco uBR7246VXR
router, with supporting broadband processing engines (BPEs) or cable interface
line cards on the respective routers.
|
12.2(33)SCF2
|
The
force
argument was introduced.
|
IOS-XE
3.15.OS
|
This
command was implemented on the Cisco cBR Series Converged Broadband Routers.
|
Examples
The following
examples illustrate DCC verification, using the
test
cable
dcc command.
The following
example shows how to move a target cable modem, specified by MAC address, IP
address, or the primary SID value on the source interface to a target
downstream with the specified frequency using DCC intialization technique 0:
Router# test cable dcc [<mac-addr>|<ip-addr>|<cable-if-src><sid>] frequency <freq-value>
Frequency-value: <55000000-858000000> New Downstream Frequency in HZ.
The following
example shows how to move a target cable modem, specified by MAC address, IP
address, or the primary SID value on the source interface to a upstream channel
on a target downstream with the DCC-REQ TLV given in the specified HEX data.
Router# test cable dcc [<mac-addr>|<ip-addr>|<cable-if-src><sid>] TLV<Hex-data>
The following
example shows how to move all cable modems on a source interface to a target
downstream with the specified frequency using DCC intialization technique 0.
Router# test cable dcc <cable-if-src> frequency<frequency-value>
Frequency-value: <55000000-858000000> New Downstream Frequency in HZ.
The following
example shows how to force a cable modem to move to a modular-cable interface
7/0/0:2 with init-tech set to 0:
Router# test cable dcc 0023.4ed0.db25 modular-Cable 7/0/0:0 0 0 force
Router# show cable modem 0023.4ed0.db25
Load for five secs: 1%/0%; one minute: 1%; five minutes: 1%
Time source is hardware calendar, *10:00:48.167 SGT Wed Nov 16 2011
D
MAC Address IP Address I/F MAC Prim RxPwr Timing Num I
State Sid (dBmv) Offset CPE P
0023.4ed0.db25 30.11.2.118 C7/0/0/U0 offline 19 0.50 1862 0 N
The following example illustrates using
test
cable
dcc command on Cisco cBR Series Converged Broadband
Routers:
Router# test cable dcc 0025.2e2d.77c8 integrated-Cable 3/0/0:0 1 0
Router# show cable modem 0025.2e2d.77c8
DMAC Address IP Address I/F MAC Prim RxPwr Timing Num I
State Sid (dBmv) Offset CPE P
0025.2e2d.77c8 100.1.0.2 C3/0/0/U1 online 1 -1.00 1796 0 N
test dcc integrated-Cable 3/0/0:0 1 integrated-Cable 3/0/0:0 0 1
Router# show cable modem 0025.2e2d.77c8
MAC Address IP Address I/F MAC Prim RxPwr Timing Num I
State Sid (dBmv) Offset CPE P
0025.2e2d.77c8 100.1.0.2 C3/0/0/U0 online 1 -1.00 1796 0 N